nexacrostudio Interface

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">"
	}
}