findinFileText
텍스트로 편집할 수 있는 파일 내의 지정된 라인에 캐럿을 위치시키는 메서드입니다.
문법
nexacrostudio.findinFileText(prefixurl, line[, findText])
파라미터
Parameters | Description |
|---|---|
prefixurl | TypeDefinition의 Service에 정의된 Prefix를 포함한 파일 경로를 설정합니다. 프로젝트 내 텍스트로 편집할 수 있는 파일을 설정할 수 있습니다. - Base::test.xfdl - theme::blue\\theme.xcss |
line | 캐럿이 위치할 파일 내의 라인 값을 설정합니다. |
findText | line 값에 해당하는 라인 내에서 탐색할 텍스트를 설정합니다. |
참고
- 넥사크로 스튜디오 내에서 Add on 형태로 실행하는 경우에만 사용할 수 있습니다. - prefixurl 값에 해당하는 파일이 열려 있지 않을 경우 편집 상태로 열고 캐럿을 지정한 위치로 이동합니다. - line 값만 설정한 경우 해당 라인 맨 앞에 캐럿이 위치합니다. findText 값을 설정한 경우 해당하는 텍스트를 블럭으로 지정하고 캐럿은 텍스트 마지막 위치에 놓입니다.
getFormImage
Form(.xfdl) 디자인 이미지를 요청하고 반환받아 처리하는 메서드입니다.
문법
nexacrostudio.getFormImage( strFormurl )
파라미터
Parameters | Description |
|---|---|
strFormurl | 이미지를 얻어올 Form의 url을 설정합니다. prefixurl 경로를 사용합니다. |
반환
Return Type | Description |
|---|---|
String | strFormurl 파라미터값으로 요청한 Form 실행화면 이미지를 Base64로 인코딩 된 이미지 데이터 문자열 형태로 반환합니다. |
참고
- 넥사크로 스튜디오 내에서 Add on 형태로 실행하는 경우에만 사용할 수 있습니다. - prefixurl 값은 nexacrostudio.request 메서드의 반환 값 중 "forms" 항목을 통해 확인할 수 있습니다.
paste
활성화된 편집창 캐럿 위치에 텍스트를 붙여넣기하는 메서드입니다.
문법
nexacrostudio.paste(copyText)
파라미터
Parameters | Description |
|---|---|
copyText | 활성화된 편집창에 붙여넣기 할 텍스트를 설정합니다. |
참고
- 넥사크로 스튜디오 내에서 Add on 형태로 실행하는 경우에만 사용할 수 있습니다. - 활성화된 편집창은 ADL 편집기, FDL 편집기, 스크립트 편집기, XCSS 편집기, XML 편집기, 텍스트 편집기가 실행되고 캐럿이 표시된 상태를 의미합니다. Add On 패널로 포커스를 이동한 후 메서드 실행 시 포커스는 직전 활성화된 편집창으로 이동하며 캐럿 위치 또는 블록이 설정된 상태에서 붙여넣기가 동작합니다. 활성화된 편집창이 없는 경우에는 안내 메시지가 출력되며 붙여넣기가 동작하지 않습니다.
request
프로젝트 정보를 요청하고 반환받아 처리하는 메서드입니다.
문법
nexacrostudio.request( requestType[, dataobjuectID] );
파라미터
Parameters | Description |
|---|---|
requestType | 프로젝트에서 가져올 정보 타입을 설정합니다. |
dataobjectID | request 메소드 호출 후 반환되는 정보를 저장할 DataObject id 속성값을 설정합니다. DataObject는 Form이 아닌 Application Variables으로 생성해야 합니다. |
반환
Return Type | Description |
|---|---|
String | requesttype 파라미터값에 따라 요청된 정보를 JSON 형식의 문자열로 반환합니다. |
참고
- 넥사크로 스튜디오 내에서 Add on 형태로 실행하는 경우에만 사용할 수 있습니다.
Request Type
requesttype | Description |
|---|---|
requesttype.all | 아래 requesttype으로 실행 시 반환되는 프로젝트 정보를 순서대로 나열해 반환하도록 요청합니다. - requesttype.general - requesttype.environment - requesttype.typedefinition - requesttype.applicationvariables - requesttype.applications - requesttype.forms - requesttype.xscripts |
requesttype.general | 프로젝트에 사용하는 파일의 일반 정보를 요청합니다. 파일명, 파일타입, 경로, 수정일 정보를 반환합니다. |
requesttype.environment | Environment 기본 정보(속성, 이벤트, 함수)와 아래 requesttype으로 실행 시 반환되는 Environment 정보를 나열해 반환하도록 요청합니다. - requesttype.screeninfo - requesttype.env_variables - requesttype.env_cookies - requesttype.env_httpheader |
requesttype.screeninfo | Environment의 ScreenDefinition 정보를 요청합니다. |
requesttype.env_variables | Environment의 Variables 정보를 요청합니다. |
requesttype.env_cookies | Environment의 Cookies 정보를 요청합니다. |
requesttype.env_httpheader | Environment의 HTTP Header 정보를 요청합니다. |
requesttype.typedefinition | 아래 requesttype으로 실행 시 반환되는 TypeDefinition 정보를 나열해 반환하도록 요청합니다. - requesttype.modules - requesttype.objects - requesttype.services - requesttype.protocoladaptors - requesttype.deviceadaptors |
requesttype.modules | TypeDefinition에 등록된 Modules 정보를 요청합니다. |
requesttype.objects | TypeDefinition에 등록된 Objects 정보를 요청합니다. |
requesttype.services | TypeDefinition에 등록된 Services 정보를 요청합니다. |
requesttype.protocoladaptors | TypeDefinition에 등록된 ProtocolAdators 정보를 요청합니다. |
requesttype.deviceadaptors | TypeDefinition에 등록된 DeviceAdaptors 정보를 요청합니다. |
requesttype.applicationvariables | 아래 requesttype으로 실행 시 반환되는 Application Variables 정보를 나열해 반환하도록 요청합니다. - requesttype.app_datasets - requesttype.app_variables - requesttype.app_dataobjects |
requesttype.app_datasets | Application Variables에 등록된 Datasets 정보를 요청합니다. |
requesttype.app_variables | Application Variables에 등록된 Variables 정보를 요청합니다. |
requesttype.app_dataobjects | Application Variables에 등록된 DataObjects 정보를 요청합니다. |
requesttype.applications | 프로젝트의 Applications 정보를 요청합니다. |
requesttype.forms | 프로젝트에 사용중인 xfdl에 대한 정보를 요청합니다. |
requesttype.xscripts | 프로젝트에 포함된 모든 xjs 파일의 정보를 요청합니다. |
requesttype.openfile | 활성화된 편집창으로 열려 있는 파일의 정보를 요청합니다. 반환되는 값은 Return Data 구조(openfile)을 참고하세요. 파일 형식에 따라 prefixurl, functions, script 값은 공백으로 표시될 수 있습니다. 열려 있는 파일 타입에 따라 반환되는 Return Data 세부 항목은 달라집니다. 아래 requesttype으로 실행 시 반환되는 Return Data 구조를 참고하세요. - environment.xml > requesttype.environment - appvariables.xml > requesttype.applicationvariables - *.xadl > requesttype.applications - *.xfdl > requesttype.forms - *.xjs > requesttype.xscript |
Return Data Structure
{
"general file information": [
{
"filename": "value",
"filetype": "value",
"filepath": "value",
"lastmodified": "value"
} // }, ... { ... }
],
"environment": {
"id": "environment.xml",
"filepath": "value",
"prefixurl": "value",
"properties": [
{
"name": "value",
"value": "value"
} // }, ... { ... }
],
"events": [
{
"name": "value",
"handler": "value"
} // }, ... { ... }
],
"screeninfo": [
{
"id": "value",
"properties": [
{
"name": "value",
"value": "value"
} // }, ... { ... }
]
} // }, ... { ... }
],
"variables": [
{
"id": "value",
"initval": "value"
} // }, ... { ... }
],
"cookies": [
{
"id": "value",
"secure": "value",
"initval": "value"
} // }, ... { ... }
],
"httpheader": [
{
"id": "value",
"initval": "value"
} // }, ... { ... }
],
"functions": [
{
"name": "value",
"owner": "value",
"parameter": "value"
} // }, ... { ... }
],
"script" : "var a = \"test\";\nvar b = \"test2\";",
"contents" : "<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n.."
},
"typedefintion": {
"id": "typedefinition.xml",
"filepath": "value",
"prefixurl": "value",
"modules": [
"value" //, ...
],
"objects": [
{
"type": "value",
"id": "value",
"classname": "value"
} //}, ... { ... }
],
"protocoladaptors": [
{
"id": "value",
"devicetype": "value,",
"windows_modulename": "value",
"windows_targetpath": "value"
} //}, ... { ... }
],
"deviceadaptors": [
{
"id": "value",
"classname": "value",
"configuration": [
{
"name": "value",
"value": "value"
} //}, ... { ... }
]
}
],
"services": [
{
"prefixid": "value",
"type": "value",
"url": "value",
"protocolid": "value"
},
{
"prefixid": "value",
"type": "value",
"url": "value",
"version": "value",
"cachelevel": "value",
"include_subdir": "value"
} //}, ... { ... }
],
"contents" : "<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n.."
},
"appvariables": {
"id": "appvariables.xml",
"filepath": "value",
"prefixurl": "value",
"datasets": [
{
"id": "value",
"properties": [
{
"name": "value",
"value": "value"
} //}, ... { ... }
],
"events": [
{
"name": "value",
"handler": "value"
} // }, ... { ... }
],
"columns": [
{
"id": "value",
"type": "value",
"size": "value",
"datapath": "value"
} // }, ... { ... }
],
"rows": [
[
{
"id": "value",
"value": "value"
} // }, ... { ... }
] // ], ... [ ... ]
]
} // }, ... { ... }
],
"variables": [
{
"id": "value",
"initval": "value"
} // }, ... { ... }
],
"dataobjects": [
{
"id": "value",
"properties": [
{
"name": "value",
"value": "value"
} // }, ... { ... }
],
"events": [
{
"name": "value",
"handler": "value"
} // }, ... { ... }
]
}
],
"contents" : "<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n.."
},
"applications": [
{
"id": "value",
"filepath": "value",
"prefixurl": "value",
"properties": [
{
"name": "value",
"value": "value"
} // }, ... { ... }
],
"events": [
{
"name": "value",
"handler": "value"
} // }, ... { ... }
],
"frames": [
{
"id": "value",
"classname": "value",
"properties": [
{
"name": "value",
"value": "value"
} // }, ... { ... }
],
"events": [
{
"name": "value",
"handler": "value"
} // }, ... { ... }
]
} // }, ... { ... }
],
"trays": [
{
"id": "value",
"properties": [
{
"name": "value",
"value": "value"
} // }, ... { ... }
],
"events": [
{
"name": "value",
"handler": "value"
} // }, ... { ... }
],
"popupmenuitems": [
{
"id": "value",
"properties": [
{
"name": "value",
"value": "value"
} // }, ... { ... }
],
"events": [
{
"name": "value",
"handler": "value"
} // }, ... { ... }
]
}
]
}
],
"functions": [
{
"name": "value",
"owner": "value",
"parameter": "value"
} // }, ... { ... }
],
"script" : "var a = \"test\";\nvar b = \"test2\";",
"contents" : "<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n.."
}
],
"forms": [
{
"id": "value",
"filepath": "value",
"prefixurl": "value",
"properties": [
{
"name": "value",
"value": "value"
} // }, ... { ... }
],
"events": [
{
"name": "value",
"handler": "value"
} // }, ... { ... }
],
"layouts": [
{
"name": "value",
"properties": [
{
"name": "value",
"value": "value"
} // }, ... { ... }
]
}
],
"components": [
{
"id": "value",
"classname": "value",
"properties": [
{
"name": "value",
"value": "value"
} // }, ... { ... }
],
"events": [
{
"name": "value",
"handler": "value"
} // }, ... { ... }
]
} // }, ... { ... }
],
"objects": [
{
"id": "value",
"classname": "value",
"properties": [
{
"name": "value",
"value": "value"
} // }, ... { ... }
],
"events": [
{
"name": "value",
"handler": "value"
} // }, ... { ... }
],
// if dataset
"columns": [
{
"id": "value",
"type": "value",
"size": "value",
"datapath": "value"
} // }, ... { ... }
],
// if dataset
"rows": [
[
{
"id": "value",
"value": "value"
} // }, ... { ... }
] // ], ... [ ... ]
]
} // }, ... { ... }
],
"functions": [
{
"name": "value",
"owner": "value",
"parameter": "value"
} // }, ... { ... }
],
"script" : "var b = \"form scripts\";",
"contents" : "<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<FDL version=\"2.1\">"
} // }, ... { ... }
],
"xscripts": [
{
"id": "value",
"filepath": "value",
"prefixurl": "value",
"functions": [
{
"name": "value",
"owner": "value",
"parameter": "value"
} // }, ... { ... }
],
"script" : "var a = 2;"
"contents" : "<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<Script version=\"1.0\" type=\"xscript5.1\"><![CDATA[var a = 2;\r\n]]></Script>\r\n">"
} // }, ... { ... }
]
}Return Data 구조 (openfile)
{
"openfile": {
"id": "value",
"filepath": "value",
"prefixurl": "value",
"functions": [
{
"name": "value",
"owner": "value",
"parameter": "value"
} // }, ... { ... }
],
"script" : "var a = 2;"
"contents" : "<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<Script version=\"1.0\" type=\"xscript5.1\"><![CDATA[var a = 2;\r\n]]></Script>\r\n">"
}
}