개요

Environment 오브젝트에 프로젝트에서 사용될 환경정보를 저장하고 관리합니다.

지원 환경

- 스크립트에서 nexacro.getEnvironment() 메소드를 사용하여 오브젝트에 접근할 수 있습니다.
- WRE 실행 시 스크립트로 Environment 오브젝트의 속성값(usewaitcursor, locale 등)을 변경한 경우 open 메소드 등을 실행해 띄운 팝업창에는 변경한 Environment 오브젝트의 속성값이 반영되지 않습니다.

- 프로젝트에서 사용될 Cookies 와 Variables 를 관리합니다.

- 멀티스크린 환경에서 공통으로 사용될 변수를 관리합니다.

속성

accessibilitybackwardkey

접근성이 활성화 되었을 때 History 에 저장된 순서의 반대로 재탐색하는 단축키를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.accessibilitybackwardkey[= strHotKey]

문법 설정

var objEnv = nexacro.getEnvironment();

objEnv.accessibilitybackwardkey = "G";
objEnv.accessibilitybackwardkey = "CTRL+ALT+A";

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- accessibilitybackwardkey 속성의 단축키로 History 의 첫번째 위치까지 접근성을 실행합니다.
   accessibilityforwardkey 속성의 단축키로 History 의 마지막 위치까지 접근성을 실행합니다.
   accessibilityreplayhotkey 속성의 단축키로 History 의 현재위치 접근성을 실행합니다.

- accessibilityforwardkey 속성에 설정된 단축키로 History 에 저장된 순서대로 접근성을 다시 실행하려면
   accessibilitybackwardkey 속성에 설정된 단축키를 먼저 입력하여 History 를 이전 순서로 이동하여야 합니다.

- accessibilitybackwardkey 속성에 설정된 단축키 입력 시 History 의 첫번째 순서까지 접근성이 실행되면 이후는 실행되지 않습니다.

- accessibilityforwardkey, accessibilitybackwardkey 속성에 설정된 단축키 입력 시 History 의 순서와 내용은 변경되지 않습니다.
   또한 단축키 입력으로 History 의 접근성이 실행될 때 포커스도 이동하지 않습니다.


◆ Desktop WRE 제약

- Firefox 는 accessibilitybackwardkey 에 설정된 단축키 입력 시 해당 컴포넌트의 accessibilityrole 속성값이 출력되지 않습니다.

accessibilitycontentsearchkey

선택상자 이동 시 Accessibility Key Action 지원 여부를 설정합니다.

지원 환경

속성 타입

문법

Environment.accessibilitycontentsearchkey [= bAccessibilitycontentsearchkey]

문법 설정

bAccessibilitycontentsearchkey ::= true | false

참고

-  accessibilitycontentsearchkey 속성값을 설정하지 않으면 false로 적용됩니다.

accessibilitydescreadtype

접근성 기능이 활성화됐을 때 사용할 컴포넌트의 접근성 속성을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.accessibilitydescreadtype[= enumReadType]

문법 설정

enumReadType ::= <readtype> [',' <readtype> [',' <readtype>]]

<readtype> ::= 'label' | 'action' | 'description'

* 각 타입값을 콤마(",")로 구분하여 중복 설정할 수 있습니다.

var objEnv = nexacro.getEnvironment();

objEnv.accessibilitydescreadtype = "label";
objEnv.accessibilitydescreadtype = "label,description";

참고

- accessibilitydescreadtype 속성값을 설정하지 않으면 "label" 로 적용됩니다. 

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다. 

- 속성값에 설정한 순서와 상관없이 설정하지 않는 대상은 제외하고 label -> action -> description 순서로 스크린 리더가 읽어줍니다.

accessibilityfirstovermessage

접근성이 활성화 되었을 때 Form 의 첫번째 컴포넌트에 포커스가 이동되면 접근성으로 실행될 문자열을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.accessibilityfirstovermessage[= strText]

문법 설정

var objEnv = nexacro.getEnvironment();

objEnv.accessibilityfirstovermessage = "First Component";

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- 접근성 실행 시 첫번째 컴포넌트의 Label, Action, Description 값은 accessibilitydescreadtype 속성값에 따라 실행여부와 순서가 결정됩니다.


◆ tabkeycirculation 속성값이 "form,nocycle"일 때 동작

- 넥사크로 앱에서 첫 번째 컴포넌트에 포커스가 있는 상태에서 Shift+Tab 키를 입력하면, 포커스는 이동하지 않고 accessibilityfirstovermessage 속성에 설정된 값이 접근성 메시지로 실행됩니다.
  단, 넥사크로 앱이 HTML IFRAME 태그 내에서 로딩된 경우, HTML 내 이전 순서의 항목으로 포커스가 이동하며 accessibilityfirstovermessage 속성에 설정된 값은 실행되지 않습니다.

accessibilityforwardkey

접근성이 활성화 되었을 때 History 에 저장된 순서대로 재탐색하는 단축키를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.accessibilityforwardkey[= strHotKey]

문법 설정

var objEnv = nexacro.getEnvironment();

objEnv.accessibilityforwardkey = "G";
objEnv.accessibilityforwardkey = "CTRL+ALT+A";

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- accessibilitybackwardkey 속성의 단축키로 History 의 첫번째 위치까지 접근성을 실행합니다.
   accessibilityforwardkey 속성의 단축키로 History 의 마지막 위치까지 접근성을 실행합니다.
   accessibilityreplayhotkey 속성의 단축키로 History 의 현재위치 접근성을 실행합니다.

- accessibilityforwardkey 속성에 설정된 단축키로 History 에 저장된 순서대로 접근성을 다시 실행하려면
   accessibilitybackwardkey 속성에 설정된 단축키를 먼저 입력하여 History 를 이전 순서로 이동하여야 합니다.

- accessibilityforwardkey 속성에 설정된 단축키 입력 시 History 의 마지막 순서까지 접근성이 실행되면 이후는 실행되지 않습니다.

- accessibilityforwardkey, accessibilitybackwardkey 속성에 설정된 단축키 입력 시 History 의 순서와 내용은 변경되지 않습니다.
  또한 단축키 입력으로 History 의 접근성이 실행될 때 포커스도 이동하지 않습니다.


◆ Desktop WRE 제약

- Firefox 는 accessibilityforwardkey 에 설정된 단축키 입력 시 해당 컴포넌트의 accessibilityrole 속성값이 출력되지 않습니다.

accessibilityheadingnexthotkey

접근성이 활성화 되었을 때 role 정보가 "heading"으로 설정된 컴포넌트를 탭오더 순서로 이동하는 단축키를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.accessibilityheadingnexthotkey[= strHotKey]

문법 설정

var objEnv = nexacro.getEnvironment();

objEnv.accessibilityheadingnexthotey = "G";
objEnv.accessibilityheadingnexthotey = "CTRL+ALT+A";

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- 단축키를 입력하면 accessibilityenable 속성값이 true 인 컴포넌트 중 accessibilityrole 속성값을 "heading" 또는 "heading1"부터 "heading6" 사이의 값으로 설정한 컴포넌트에 탭오더 순서로 포커스가 이동합니다.

- tabkeycirculation 속성값의 영향을 받지 않고 마지막 컴포넌트에서 멈춥니다.

- accessibilityheadingnexthotkey 속성의 단축키 입력으로 포커스 이동 시 이동순서가 History 에 저장됩니다.

- accessibilityheadingnexthotkey 속성값이 accessibilityfowradkey, accessibilitybackwordkey, accessibilityreplaykey, accessibilitywholereadhotkey 속성값과 중복이 될 경우 accessibilityheadingnexthotkey 속성값은 무시됩니다.

accessibilityheadingprevhotkey

접근성이 활성화 되었을 때 role 정보가 "heading"으로 설정된 컴포넌트를 탭오더 반대순서로 이동하는 단축키를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.accessibilityheadingprevhotkey[= strHotKey]

문법 설정

var objEnv = nexacro.getEnvironment();

objEnv.accessibilityheadingprevhotey = "G";
objEnv.accessibilityheadingprevhotey = "CTRL+ALT+A";

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- 단축키를 입력하면 accessibilityenable 속성값이 true 인 컴포넌트 중 accessibilityrole 속성값을 "heading" 또는 "heading1"부터 "heading6" 사이의 값으로 설정한 컴포넌트에 탭오더 반대순서로 포커스가 이동합니다.

- tabkeycirculation 속성값의 영향을 받지 않고 첫 번째 컴포넌트에서 멈춥니다.

- accessibilityheadingprevhotkey 속성의 단축키 입력으로 포커스 이동 시 이동순서가 History 에 저장됩니다.

- accessibilityheadingprevhotkey 속성값이 accessibilityfowradkey, accessibilitybackwordkey, accessibilityreplaykey, accessibilitywholereadhotkey 속성값과 중복이 될 경우 accessibilityheadingprevhotkey 속성값은 무시됩니다.

accessibilityhistorycount

접근성이 활성화 되었을 때 컴포넌트를 이동한 순서가 History 에 저장되는 갯수를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.accessibilityhistorycount[= nCount]

문법 설정

var objEnv = nexacro.getEnvironment();

objEnv.accessibilityhistorycount = 10;

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- accessibilityhistorycount 속성값을 설정하지 않으면 5 로 적용됩니다.

- 접근성 기능이 활성화 되어 있을 때 컴포넌트를 이동한 순서가 accessibilityhistorycount 속성값만큼 History 에 저장됩니다.
   accessibilitybackwardkey, accessibilityforwardkey 속성에 설정된 단축키 입력 시 History 에 저장된 순서대로 탐색할 수 있습니다.

- accessibilityreplayhotkey 속성에 설정된 단축키는 accessibilityhistorycount 속성과 관계없이 사용할 수 있습니다.

accessibilitylastovermessage

접근성이 활성화 되었을 때 Form 의 마지막 컴포넌트에 포커스가 이동되면 접근성으로 실행될 문자열을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.accessibilitylastovermessage[= strText]

문법 설정

var objEnv = nexacro.getEnvironment();

objEnv.accessibilitylastovermessage = "Last Component";

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- 접근성 실행 시 마지막 컴포넌트의 Label, Action, Description 값은 accessibilitydescreadtype 속성값에 따라 실행여부와 순서가 결정됩니다.


◆ tabkeycirculation 속성값이 "form,nocycle"일 때 동작

- 넥사크로 앱에서 마지막 컴포넌트에 포커스가 있는 상태에서 Tab 키를 입력하면, 포커스는 이동하지 않고 accessibilitylastovermessage 속성에 설정된 값이 접근성 메시지로 실행됩니다.
  단, 넥사크로 앱이 HTML IFRAME 태그 내에서 로딩된 경우, HTML 내 다음 순서의 항목으로 포커스가 이동하며 accessibilitylastovermessage 속성에 설정된 값은 실행되지 않습니다.

accessibilityreplayhotkey

접근성이 활성화 되었을 때 직전에 실행된 접근성을 재실행하는 단축키를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.accessibilityreplayhotkey[= strHotKey]

문법 설정

var objEnv = nexacro.getEnvironment();

objEnv.accessibilityreplayhotkey = "G";
objEnv.accessibilityreplayhotkey = "CTRL+ALT+A";

참고

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- accessibilityreplayhotkey 속성의 단축키 입력 시 History 의 접근성 실행과 실제 이동에 의한 접근성 실행을 구분하지 않고 마지막에 실행된 접근성이 재실행됩니다.

- accessibilitybackwardkey 속성의 단축키로 History 의 첫번째 위치까지 접근성을 실행합니다.
  accessibilityforwardkey 속성의 단축키로 History 의 마지막 위치까지 접근성을 실행합니다.
  accessibilityreplayhotkey 속성의 단축키로 History 의 현재위치 접근성을 실행합니다.

- accessibilityreplayhotkey 속성에 설정된 단축키 입력 시 History 의 순서와 내용은 변경되지 않습니다.
  또한 단축키 입력으로 History 의 접근성이 실행될 때 포커스도 이동하지 않습니다.


◆ Desktop WRE 제약

- Firefox 는 accessibilityreplayhotkey 에 설정된 단축키 입력 시 해당 컴포넌트의 accessibilityrole 속성값이 출력되지 않습니다.

accessibilitytype

접근성 기능 실행 시 스크린 리더 또는 실행환경에 따라 적절한 기능을 지원하도록 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.accessibilitytype[= enumAccessType]

문법 설정

enumAccessType ::= 'standard' | 'sensereader' | 'jaws'

참고

- accessibilitytype 속성값을 설정하지 않으면 "standard"로 적용됩니다.

- 시각 장애인이 윈도우 운영체제 사용 시에는 특정 스크린 리더 제품을 사용합니다. 센스리더나 JAWS는 윈도우 애플리케이션을 손쉽게 사용할 수 있게 운영체제의 기본 접근성 기능 외에 추가 기능을 지원하거나 기본 동작과 다르게 처리되기도 합니다. 
accessibilitytype 속성값을 "sensereader" 또는 "jaws"로 설정하면 이런 특화된 기능에 맞게 접근성 기능을 실행하도록 지원합니다.

accessibilitywholereadhotkey

접근성이 활성화 되었을 때 포커스가 있는 Form 의 접근성 전체를 실행하는 단축키를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.accessibilitywholereadhotkey[= strHotKey]

문법 설정

var objEnv = nexacro.getEnvironment();

objEnv.accessibilitywholereadhotkey = "G";
objEnv.accessibilitywholereadhotkey = "CTRL+ALT+A";

참고

- enableaccessibility 속성값이 true 이고 accessibilitywholereadtype 속성값이 "none" 이 아닌 경우만 적용되는 속성입니다.

- Form 에 속한 모든 컴포넌트의 접근성이 실행됩니다.

- 접근성 전체를 실행 중 취소하는 방법은 스크린 리더 프로그램의 취소기능을 따릅니다.

- Form 에 속한 컨테이너 컴포넌트에 링크된 Form 의 접근성도 실행됩니다.

accessibilitywholereadtype

접근성이 활성화 되었을 때 Form 이 로드되면 접근성 전체를 실행할 지 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.accessibilitywholereadtype[= enumReadType]

문법 설정

enumReadType ::= 'none' | 'load' | 'change' | 'load,change'

var objEnv = nexacro.getEnvironment();

objEnv.accessibilitywholereadhotkey = "load";
objEnv.accessibilitywholereadhotkey = "load,change";

참고

- accessibilitywholereadtype 속성값을 설정하지 않으면 "none" 으로 적용됩니다.

- enableaccessibility 속성값이 true 인 경우만 적용되는 속성입니다.

- 접근성 전체를 실행 중 취소하는 방법은 스크린 리더 프로그램의 취소기능을 따릅니다.



◆ Mobile 제약

- Mobile 환경은 지원하지 않는 속성입니다.

addcookietovariable

서버와 통신 시 수신된 Cookie 를 자동으로 Cookies 영역에 추가할지 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.addcookietovariable

문법 설정

addcookietovariable ::= 'true' | 'false'

참고

- addcookietovariable 속성값을 설정하지 않으면 true 로 적용됩니다.

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.


◆ WRE 제약

- Secure 속성이 설정된 상태로 서버에서 받은 Cookie 는 Cookies 영역에 추가되거나 변경되지 않습니다.

- Cross Domain 상황이면 Cookies 영역의 Cookie 가 서버로 전송되거나 서버에서 받은 값으로 변경되지 않습니다.

calendarrestoreonblur

Calendar 컴포넌트의 type 속성값이 "monthonly"로 설정된 경우, 사용자가 년 또는 월 값을 변경한 뒤 일자를 확정하지 않은 상태에서 다른 컴포넌트로 포커스를 이동할 때, 변경된 년/월 값을 유지할지 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.calendarrestoreonblur

문법 설정

calendarrestoreonblur ::= true | false

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- calendarrestoreonblur 속성값을 설정하지 않으면 true로 적용됩니다.

checkversion

Cache 를 강제로 갱신하기 위해 프로젝트 제너레이트 시 Query String 에 Version 정보를 포함할지 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.checkversion

문법 설정

bCheck ::= 'true' | 'false'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.
  값을 설정하지 않으면 false로 적용됩니다.

- Screen 별로 checkversion 속성값을 다르게 설정할 수 없습니다.

datasetloadtype

transaction 메서드 또는 Dataset 오브젝트의 load 메서드 실행 결과로 받은 데이터에 ErrorCode 값이 포함된 경우 Dataset 오브젝트에 데이터를 로드하는 방식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.datasetloadtype[= enumLoadType]

문법 설정

enumLoadType ::= 'onsuccess' | 'errorallow'

var objEnv = nexacro.getEnvironment();
objEnv.datasetloadtype = "errorallow";

참고

- datasetloadtype 속성값을 설정하지 않으면 "onsuccess" 로 적용됩니다.

- ErrorCode는 메서드 실행 결과로 받을 데이터에 아래와 같은 형식으로 설정할 수 있습니다.
   ErrorCode 값을 설정하지 않은 경우에는 0으로 처리됩니다.

   <Parameters>
     <Parameter id="ErrorCode" type="int">0</Parameter>
     <Parameter id="ErrorMsg" type="string">SUCC</Parameter>
   </Parameters>

- Transaction 수행 시 Input Dataset 보다 Output Dataset 을 먼저 처리합니다.
   따라서 datasetloadtype 속성값이 "errorallow" 일 때 Input Dataset 과 Output Dataset 을 동일한 Dataset 로 설정하면
   에러코드에 관계없이 Output Dataset 에 데이터가 로드되므로 결과적으로 Input Dataset 의 변경을 막을 수 없습니다.

datasetsaveinfinity

DataSet 에서 타입이 INT, FLOAT, BIGDECIMAL 인 Column 에 저장된 Infinity 값의 처리 방법을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.datasetsaveinfinity[= enumSave]

문법 설정

enumSave ::= 'include' | 'exclude'

var objEnv = nexacro.getEnvironment();

objEnv.datasetsavenan = "exclude";

참고

- datasetsaveinfinity 속성값을 설정하지 않으면 "include" 로 적용됩니다.

- DataSet 의 saveinfinity 속성을 설정하지 않으면 Environment 의 datasetsaveinfinity 속성값이 적용됩니다.

datasetsaveinvaliddate

DataSet 에서 타입이 DATE, TIME, DATETIME 인 Column 에 저장된 잘못된 날자값의 처리 방법을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.datasetsaveinvaliddate[= enumSave]

문법 설정

enumSave ::= 'include' | 'exclude'

var objEnv = nexacro.getEnvironment();

objEnv.datasetsaveinvaliddate = "include";

참고

- datasetsaveinvaliddate 속성값을 설정하지 않으면 "exclude" 로 적용됩니다.

- DataSet 의 saveinvaliddate 속성을 설정하지 않으면 Environment 의 datasetsaveinvaliddate 속성값이 적용됩니다.

datasetsavenan

DataSet 에서 타입이 INT, FLOAT, BIGDECIMAL 인 Column 에 저장된 NaN 값의 처리 방법을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.datasetsavenan[= enumSave]

문법 설정

enumSave ::= 'include' | 'exclude'

var objEnv = nexacro.getEnvironment();

objEnv.datasetsavenan = "include";

참고

- datasetsavenan 속성값을 설정하지 않으면 "exclude" 로 적용됩니다.

- DataSet 의 savenan 속성을 설정하지 않으면 Environment 의 datasetsavenan 속성값이 적용됩니다.

datatyperule

어플리케이션에 적용될 Data 처리 규칙을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.datatyperule

문법 설정

datatyperule ::= '1.0' | '2.0'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- datatyperule 속성값을 설정하지 않으면 기존 프로젝트는 "1.0" 이 설정되고,
   신규 프로젝트 생성 시 넥사크로 스튜디오에서 "2.0" 을 자동 설정합니다.

dnsquery

어플리케이션에서 통신 시 DNS Query 를 사용할지 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.dnsquery

문법 설정

enumDnsQuery ::= 'none' | 'request'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- dnsquery 값을 설정하지 않으면 "none" 으로 적용됩니다.

- BootStrap 로딩단계에서는 dnsquery 속성값과 관계없이 항상 DNS 서버로 DNS Query 를 요청합니다.

enableaccessibility

접근성 기능을 사용할지 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.enableaccessibility

문법 설정

bEnableAccess ::= 'true' | 'false'

참고

- enableaccessibility 속성값을 설정하지 않으면 false로 적용됩니다.
- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행 중에는 수정할 수 없는 속성입니다.

◆ WRE 제약

- enableaccessibility 속성값을 false로 설정하더라도 스크린 리더의 실행을 제한하지는 않습니다.
각 컴포넌트의 접근성 관련 속성값, Accessibility Key Action 기능이 활성화되지 않은 상태에서 의도치 않은 정보를 스크린 리더가 읽을 수 있습니다.

enablecache

서버와 통신 시 Cache 사용 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.enablecache

문법 설정

enablecache ::= 'true' | 'false'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- enablecache 속성값을 설정하지 않으면 true 로 적용됩니다.

enableclipboard

시스템의 클립보드 사용여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.enableclipboard[= bEnableclipboard]

문법 설정

bEnableclipboard ::= 'true' | 'false'

var objEnv = nexacro.getEnvironment();
objEnv.enableclipboard = false;

참고

- enableclipboard 속성값을 설정하지 않으면 true 로 적용됩니다.

enablecookie

서버와 통신 시 Cookie 사용 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.enablecookie

문법 설정

enablecookie ::= 'true' | 'false'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- enablecookie 속성값을 설정하지 않으면 true 로 적용됩니다.

- 넥사크로에서 제공하는 WebBrowser 컴포넌트 내에서는 Environment 의 Cookies 영역에 정의된 변수를 사용할 수 없습니다.

enableinspector

앱 실행 시 원격 디버깅 허용 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.enableinspector

문법 설정

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.
- 값을 설정하지 않으면 "false" 로 적용됩니다.

- Chrome 또는 Edge 브라우저의 개발자도구의 원격 디버깅 기능을 사용할 수 있도록 설정합니다.

enablescreencapture

OS 에서 제공하는 스크린캡쳐 기능 사용 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.enablescreencapture

문법 설정

enablescreencapture ::= 'true' | 'false'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- enablescreencapture 속성값을 설정하지 않으면 true 로 적용됩니다.

- Windows NRE 와 Android NRE 에서만 사용할 수 있는 속성입니다.

enabletouchevent

터치 관련 이벤트의 발생여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.enabletouchevent

문법 설정

enabletouchevent ::= 'true' | 'false'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- enabletouchevent 속성값을 설정하지 않으면 "false" 로 적용됩니다.

- 마우스 관련 이벤트는 onlbuttondown, onlbuttonup, onmouseenter, onmouseleave, onmousemove 이벤트입니다.
  터치 관련 이벤트는 ontouchstart, ontouchmove, ontouchend 이벤트입니다.

- ondrag, onclick 등의 이벤트는 enabletouchevent 속성값에 영향을 받지 않고 발생합니다.

enabletouchsoftkeyboard

터치 동작으로 컴포넌트가 포커스를 가질 때 키패드 표시 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.enabletouchsoftkeyboard [=bEnableTouchSoftkeyboard]

문법 설정

bEnableTouchSoftkeyboard ::= true | false

참고

- enabletouchsoftkeyboard 속성값을 설정하지 않으면 false로 적용됩니다.
  24.0.0.400 이전 버전에서는 enabletouchsoftkeyboard 속성값이 false인 상태와 같은 방식으로 동작했습니다.

- 컴포넌트의 usesoftkeyboard 속성값이 true로 적용되는 경우에만 키패드가 표시됩니다.

filesecurelevel

로컬 파일에 접근할 권한을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.filesecurelevel

문법 설정

filesecurelevel ::= 'private' | 'all'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행 중에는 수정할 수 없는 속성입니다.

- filesecurelevel 속성값을 설정하지 않으면 "private"로 적용됩니다.
  "Personal Path"는 개인 디렉터리를 뜻하는 것으로 MS 윈도우 시스템에서는 "내 문서"를 의미합니다.

- filesecurelevel 속성은 아래의 경우 적용됩니다.
  - VirtualFile 오브젝트 사용
  - LiteDBConnection 오브젝트에서 데이터베이스 파일 사용
  - 스크립트에서 메소드 실행 시 문자열로 파일 경로 설정

highcontrastthemeid

OS 에 고대비 기능이 적용되어 있을 때 어플리케이션에 적용될 테마를 설정하는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

Environment.highcontrastthemeid

문법 설정

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- Windows NRE 는 OS 에 고대비 기능이 적용되면 highcontrastthemeid 속성에 설정된 테마가 동적으로 적용됩니다.

- Desktop WRE 는 OS 에 고대비 기능이 적용되도 동적으로 highcontrastthemeid 속성의 테마가 적용되지 않습니다.

httpretry

HTTP/HTTPS 통신 시 에러가 발생하면 재시도 할 횟수를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.httpretry

문법 설정

참고

- httpretry 속성값을 설정하지 않으면 0 으로 적용됩니다.

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

httptimeout

HTTP/HTTPS 통신 시 서버의 응답을 기다리는 시간을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.httptimeout[= nHttpTimeOut]

문법 설정

var objEnv = nexacro.getEnvironment();
objEnv.httptimeout = 10;

참고

- httptimeout 속성값을 설정하지 않으면 60 으로 적용됩니다.


◆ Windows NRE 제약

- usehttpkeepalive 속성값이 true 인 경우 서버와 연결유지를 위한 통신 대기시간으로 사용됩니다.
   usehttpkeepalive 속성값이 false 인 경우 HTTP/HTTPS 통신 시 대기시간으로 사용됩니다.


◆ Desktop WRE 제약

- usehttpkeepalive 속성값에 관계없이 비동기(Async)로 Transaction 을 실행할 때만 HTTP/HTTPS 통신 시 대기시간으로 사용됩니다.

icon

작업표시줄 또는 Favicon 으로 표시될 아이콘을 리소스 영역의 이미지로 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.icon

문법 설정

strUrl ::= 'URL(" ' <Resource-Image> ' ")'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- 리소스 영역은 TypeDefinition 에 기본으로 정의되는 영역으로 넥사크로 스튜디오의 "Resource Explorer" 로 관리할 수 있습니다.

- Windows NRE 는 icon 속성값을 설정하지 않으면 TitleBarControl 에 설정한 아이콘 이미지가 적용됩니다.

- Screen 에 따라 다른 아이콘을 적용하려면 Screen 영역에서 Environment 의 icon 속성값을 설정하여야 합니다.

- icon 속성에 설정된 아이콘 이미지는 Windows NRE 는 작업표시줄의 아이콘으로 사용되고, Desktop WRE 는 Favicon 으로 사용됩니다.

initvaluefileid

InitValue 를 적용하기 위해 InitValueDefinition 영역에 정의된 파일명을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.initvaluefileid

문법 설정

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

key

어플리케이션 실행 시 설정된 Key 값을 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

Environment.key

문법 설정

var objEnv = nexacro.getEnvironment();
var strkey = objEnv.key;

참고

- Key 값 또는 부트스트랩 정보가 인수로 전달되지 않을 경우에는 어플리케이션이 구동되지 않습니다.

- 어플리케이션 실행 시 "-K" 옵션으로 들어온 입력 인수값이 key 속성에 설정됩니다.
  설정된 key 속성값은 nexacro.xml에 저장됩니다.

- nexacro.xml 파일은 사용자별로 정보를 관리하기 위해 사용하는 XML 형식의 파일입니다.
  Windows 운영체제의 경우 "C:\Users\[UserName]\AppData\LocalLow\TOBESOFT\Nexacro N\24" 위치에 파일이 생성됩니다.

◆ Windows NRE 제약

- 보안상 문제가 될 수 있는 문자열은 실행 시 삭제 처리합니다.
  관련 제약 사항은 [앱 배포 가이드 > 런처 서비스 > 지원 기능 > 속성] 항목을 참고하세요.

loadingimage

데이터 로딩 시 화면에 표시될 이미지를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.loadingimage

문법 설정

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- loadingimage 속성값을 설정하지 않으면 넥사크로에서 제공하는 기본 이미지가 표시됩니다.

locale

국가 및 언어(locale)를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.locale[= strlocale]

문법 설정

var objEnv = nexacro.getEnvironment();
objEnv.locale = "ko_KR";

참고

- ISO 639-1에서 정의하고 있는 2-알파벳 언어 코드와 ISO 3166-1에서 정의하고 있는 2-알파벳 국가 코드를 조합하여 사용합니다.

- 국가 및 언어 코드는 "Appendix > Locale Code List" 항목을 참고하세요.

loglevel

애플리케이션에서 로그 파일에 출력할 정보 수준을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.loglevel[= strloglevel]

문법 설정

loglevel ::= 'fatal' | 'error' | 'warn' | 'info' | 'debug'

var objEnv = nexacro.getEnvironment();
objEnv.loglevel = "warn";

참고

- loglevel 속성값을 설정하지 않으면 "debug"로 적용됩니다.

- 발생되는 에러의 레벨이 설정값과 같거나 높은 경우 로그 파일에 로그를 출력합니다.
  에러 레벨은 "fatal" > "error" > "warn" > "info" > "debug" 순입니다.
  "fatal"부터 "info"까지는 프레임워크 내부에서 처리하는 로그 정보입니다.

- loglevel 속성은 아래 우선순위에 따라 동작합니다.
  (1) nexacro_config.xml 설정 파일 내 loglevel 속성값
  (2) 스크립트에서 설정한 loglevel 속성값
  (3) 넥사크로 스튜디오에서 설정한 loglevel 속성값
  단, nexacro_config.xml 설정 파일 내 loglevel 속성값은 실행 시에만 반영되며 스크립트에서 Environment.loglevel 속성값 확인 시 반환되지 않습니다.

- 로그 파일 생성 위치
  Windows NRE, macOS NRE: "%USERAPP%"

- 로그 파일명
  넥사크로 Config 파일에 정의되지 않았을 경우 "nexacro_"+[Protocol]+[URL]+".log" 형태로 생성

- Alias 실제경로입니다.

multivalueseparator

Multi Value 바인딩된 Dataset 오브젝트에서 구분자로 사용할 값을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.multivalueseparator

문법 설정

참고

- multivalueseparator 속성값을 설정하지 않으면 ","로 적용됩니다.

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행 중에는 수정할 수 없는 속성입니다.

networksecurelevel

TCP 또는 HTTP/HTTPS 로 소켓통신 시 원격서버에 접근을 허용하는 보안 레벨을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.networksecurelevel

문법 설정

networksecurelevel ::= 'private' | 'all'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- 통신 시 비교 대상은 ADL 의 도메인과 대상 도메인이며, 두 주소가 IP와 도메인으로 각각 타입이 다를 경우 설정값이 "private" 이면 접근이 허용되지 않습니다.


◆ Desktop WRE 제약

- 속성값을 "all" 로 설정하면 비동기(Async) 통신에서 XMLHttpRequest 의 withCredentials 속성이 true 로 설정됩니다.

- withCredentials 속성값이 true 이면 Cross Domain 상황에서 브라우저의 자격정보를 전송할 수 있습니다.
   이 때, 서버에서도 "Access-Control-Allow-Credentials" 헤더에 true 를 할당해서 보내야 합니다.

- withCredentials 속성이 true 로 설정되어 있을 때는 "Access-Control-Allow-Origin : *" 을 허용하지 않습니다.
   그러므로 쿠키에 관련된 요청을 사용하려면 반드시 와일드카드가 아니라 URL 을 지정해주어야 합니다.

- withCredentials 속성에 대한 자세한 내용은 "여기"를 참고하세요.

rtl

내부 컨텐츠 또는 컴포넌트의 표시 기준을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.rtl

문법 설정

bRtl ::= undefined | 'true' | 'false'

var objEnv = nexacro.getEnvironment();
var vRtl = objEnv.rtl;

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- rtl 속성값을 설정하지 않거나 삭제했을 경우 undefined 로 설정됩니다.

- 아랍권 같이 화면의 표시기준이 오른쪽인 환경에서 컨텐츠의 표시 기준을 변경하기 위해 설정하는 속성입니다.

- 하위 컨트롤 또는 컴포넌트의 rtl 속성값을 설정하지 않으면 Environment 의 rtl 속성값이 적용됩니다.

scrollbarsize

어플리케이션의 컴포넌트에 표시되는 스크롤바의 크기를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.scrollbarsize

문법 설정

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- 어플리케이션에 속한 컴포넌트의 scrollbarsize 속성을 설정하지 않았을 경우 Environment 의 scrollbarsize 속성이 적용됩니다.

- scrollbarsize 속성값은 수직스크롤바의 너비와 수평스크롤바의 높이에 동일하게 적용됩니다.

- scrollbarsize 속성값을 변경하면 스크롤바 내부버튼의 높이와 너비가 같이 변경됩니다.

scrollbartype

어플리케이션의 컴포넌트에 스크롤바가 표시되는 형식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.scrollbartype

문법 설정

scrollbartype ::= <scrolltype> | <pairtype>

<scrolltype> ::= <desktype> | <mobiletype>
<pairtype> ::= <desktype> ' ' <desktype> | <mobiletype> ' ' <mobiletype>

<desktype> ::= 'default' | 'none' | 'fixed' | 'auto'
<mobiletype> ::= 'default' | 'none' | 'indicator' | 'autoindicator'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- scrollbartype 속성값을 설정하지 않으면 "default" 로 적용됩니다.

- 어플리케이션에 속한 컴포넌트의 scrollbartype 속성을 설정하지 않았을 경우 Environment 의 scrollbartype 속성이 적용됩니다.

- 데스크탑에 적용되는 값과 모바일에 적용되는 값을 함께 설정할 수 있지만 권장하지 않습니다.
   ex) "fixed autoindicator", "auto indicator"

scrollindicatorsize

어플리케이션의 컴포넌트에 표시되는 스크롤 인디케이터바의 크기를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.scrollindicatorsize

문법 설정

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- 어플리케이션에 속한 컴포넌트의 scrollindicatorsize 속성을 설정하지 않았을 경우 Environment 의 scrollindicatorsize 속성이 적용됩니다.

- scrollindicatorsize 속성값은 수직스크롤바의 너비와 수평스크롤바의 높이에 동일하게 적용됩니다.

- 스크롤 인디케이터바가 아닌 스크롤바가 표시될 경우 scrollbarsize 속성으로 크기를 설정하여야 합니다.

services

TypeDefinition 영역의 Services 정보를 갖는 읽기전용 속성입니다.

지원 환경

속성 타입

문법

Environment.services

문법 설정

var objEnv = nexacro.getEnvironment();
var objSrv0 = objEnv.services[0];
var strPrefixid = objSrv0.prefixid;

참고

- services 속성에 접근하기 위해서는 getEnvironment() 메소드로 Environment 오브젝트를 반환받아야 합니다.

- services 속성은 Collection 접근방식을 사용할 수 있습니다.
   objEnv.services[0], objEnv.services["Base"], objEnv.services.length 등의 방법을 사용합니다.

- 개별 service 속성(오브젝트)에서 사용할 수 있는 속성은 아래와 같습니다.
  prefixid, type, url, cachelevel, version, communicationversion
  - prefixid, type 속성은 읽기만 지원하며 스크립트에서 속성값을 변경할 수 없습니다.
  - url, cachelevel, version, communicationversion 속성은 스크립트에서 아래와 같은 형식으로 속성값을 변경할 수 있습니다.
    objEnv.services["Base"].url = "./Base/";

- 넥사크로 스튜디오에서 Service의 PrefixID 설정 시 특수문자와 숫자로 시작하는 문자열을 설정할 수 없습니다.
   또한 아래 표에 명시된 스크립트 예약어도 설정할 수 없습니다.

ssvrecordseparator

SSV 형식으로 통신 할 때 SSV 데이터의 레코드 구분자를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.ssvrecordseparator

문법 설정

"33"
"0x1E"
"33,0x1E,34"
"0x1E,0x1F"
"33,34,35,36,37"

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- ssvrecordseparator 속성값을 설정하지 않으면 EmptyString 이 설정되고 ASCII 문자 0x1E(30)-RS 가 구분자로 사용됩니다.

- ssvunitseparator, ssvrecordseparator 속성값이 같은 경우 정상적으로 데이터를 처리할 수 없습니다.
  데이터 컬럼과 레코드를 구분할 수 있게 다른 값으로 속성값을 설정해주세요.

ssvunitseparator

SSV 형식으로 통신 할 때 SSV 데이터의 컬럼 구분자를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.ssvunitseparator

문법 설정

"33"
"0x1E"
"33,0x1E,34"
"0x1E,0x1F"
"33,34,35,36,37"

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- ssvunitseparator 속성값을 설정하지 않으면 EmptyString 이 설정되고 ASCII 문자 0x1F(31)-US 가 구분자로 사용됩니다.

- ssvunitseparator, ssvrecordseparator 속성값이 같은 경우 정상적으로 데이터를 처리할 수 없습니다.
  데이터 컬럼과 레코드를 구분할 수 있게 다른 값으로 속성값을 설정해주세요.

stringresourceserviceurl

외부에서 StringResource 정보를 가져오기 위한 서비스 URL을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.stringresourceserviceurl

문법 설정

var objEnv = nexacro.getEnvironment();
var strUrl = objEnv.stringresourceserviceurl;

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행 중에는 수정할 수 없는 속성입니다.

- Environment.usestringresource 속성값에 따라 애플리케이션 로딩 시 동작이 달라집니다.
  false: stringresourceserviceurl 속성값으로 설정한 서비스 URL에서 StringResource 정보를 로딩합니다.
  true: 제너레이트 된 StringResource 정보를 로딩합니다.

tabkeycirculation

탭키 또는 Shift+탭키 입력으로 포커스 이동 시 Form 내에서 마지막 컴포넌트 또는 첫번째 컴포넌트 다음동작 방식을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.tabkeycirculation

문법 설정

tabkeycirculation ::= 'form,cycle' | 'form,nocycle' | 'frame,cycle' | 'frame,nocycle'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- tabkeycirculation 속성값을 설정하지 않으면 "form,cycle" 로 적용됩니다.

themeid

어플리케이션에 적용될 테마를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.themeid

문법 설정

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

traceduration

로그 파일을 일별로 생성하는 옵션을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.traceduration

참고

- 값을 설정하지 않거나 0 이하의 값을 설정한 경우 기본값(-1)으로 동작합니다.
  기본값인 경우에는 지정된 파일명으로 파일을 생성합니다.
- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행 중에는 수정할 수 없는 속성입니다.

- 앱 실행 시 traceduration 값이 설정된 넥사크로 Config 파일이 적용되었다면 현재 속성은 적용되지 않습니다. 넥사크로 Config 파일이 적용되지 않았거나 파일내에 traceduration 속성이 정의되지 않은 경우는 현재 속성이 적용됩니다.

- 1 이상의 정수값을 지정한 경우에는 지정한 속성값만큼의 로그파일을 생성하고 유지합니다.
  예를 들어 속성값이 2인 경우 "filepath_시스템날짜(yyyymmdd).log" 형태로 파일을 생성하며 생성일, 생성일-1일 2개의 로그 파일을 유지합니다.
- traceduration 속성값을 0 이하의 값으로 변경한 경우 생성된 로그 파일이 삭제되고 "nexacro(protocol+url).log" 형태로 파일이 생성됩니다.

tracemode

어플리케이션에서 로그파일에 메시지를 출력하는 방법을 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.tracemode

문법 설정

tracemode ::= 'none' | 'new' | 'append'

참고

- tracemode 속성값을 설정하지 않으면 "none" 으로 적용됩니다.

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- 어플리케이션 실행 시 tracemode 값이 설정된 넥사크로 Config 파일이 적용되었다면 현재 속성은 적용되지 않습니다.
   넥사크로 Config 파일이 적용되지 않았거나 파일내에 tracemode 속성이 정의되지 않은 경우는 현재 속성이 적용됩니다.


- 어플리케이션에서 에러가 발생하거나 trace() 메소드 실행 시 로그파일에 메시지가 출력됩니다.

- Windows NRE, macOS NRE 의 경우 "%USERAPP%" 위치에 로그파일이 생성됩니다.
   로그파일명이 넥사크로 Config 파일에 정의되지 않았을 경우 "nexacro_"+[Protocol]+[URL]+".log" 형태로 생성됩니다.

- Alias 실제경로입니다.

usecontextmenu

어플리케이션 영역에서 오른쪽 마우스 클릭 시 기본팝업메뉴의 표시 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.usecontextmenu

문법 설정

usecontextmenu ::= 'all' | 'form' | 'edit' | 'none'

참고

- usecontextmenu 속성값을 설정하지 않으면 "all" 로 적용됩니다. 

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- 입력이 가능한 Calendar, Combo, Edit, Grid, MaskEdit, Sketch, Spin, TextArea 컴포넌트에만 적용되는 속성입니다.
   나머지 컴포넌트는 항상 "none" 으로 적용됩니다.

- Grid 컴포넌트는 Cell 이 편집상태일 때에 한해서 해당 편집영역에 Environment 의 usecontextmenu 속성값이 적용됩니다.
   Grid 컴포넌트에는 usecontextmenu 속성이 없습니다.


◆ web runtime environment 제약

- web runtime environment  에서 기본팝업메뉴(ContextMenu)는 사용하는 브라우저에 따라 다르게 표시됩니다.

usedateautocalibration

Calendar 컴포넌트의 calendaredit 영역에 직접 날짜값을 입력하는 경우 유효하지 않은 값 입력 시 자동 보정 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.usedateautocalibration

문법 설정

usedateautocalibration ::= true | false

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- usedateautocalibration 속성값을 설정하지 않으면 true로 적용됩니다.

usehttpkeepalive

HTTP/HTTPS 통신시 서버와 연결을 유지하기 위한 Keep Alive 기능의 사용여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.usehttpkeepalive

문법 설정

usehttpkeepalive ::= 'true' | 'false'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- usehttpkeepalive 속성값을 설정하지 않으면 "false" 로 적용됩니다.

useproxykeepalive

Proxy 통신시 서버와 연결을 유지하기 위한 Keep Alive 기능의 사용여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.useproxykeepalive

문법 설정

useproxykeepalive ::= 'true' | 'false'

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- useproxykeepalive 속성값을 설정하지 않으면 "false" 로 적용됩니다.

userfontid

어플리케이션에 적용될 UserFont 의 ID 를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.userfontid

문법 설정

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행중에는 수정할 수 없는 속성입니다.

- Screen 별로 다른 UserFont 를 설정할 수 없습니다.

- UserFontDefinition 영역에 한 개 이상의 UserFont 파일을 정의할 수 있고,UserFont 파일에는 여러개의 UserFont 를 정의할 수 있습니다.

- 프로젝트를 Generate 하면 UserFont 정의는 index.html 파일에 "style" 항목으로 추가됩니다.

- UserFont 사용 시 환경별로 지원하는 포맷정보는 "Appendix > Supported UserFont" 항목을 참고하세요.


◆ Nexacro Runtime Environment 제약

- UserFont 가 시스템에 설치되어 있어야 어플리케이션에 적용됩니다.

활용 예제

• 구글 폰트 사용하기

userhotkey

애플리케이션에 적용될 전역 단축키를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.userhotkey[= strId=strUserHotkey]

문법 설정

Environment.userhotkey = "id1=G";
Environment.userhotkey = "id1=CTRL+G";
Environment.userhotkey = "id1=CTRL+Y,id2=CTRL+ALT+SHIFT+E,id3=SHIFT+U";

참고

- 콤마 구분자로 여러 개의 전역 단축키를 설정할 수 있습니다.

- 전역 단축키 입력 시 onuserhotkey 이벤트가 발생한 후 onkeydown 이벤트가 발생합니다.

- 단축키 우선순위는 아래와 같습니다.
  (1) Environment.userhotkey 속성
  (2) 접근성 관련 단축키 속성 (accessibilitybackwardkey, accessibilityforwardkey, accessibilityheadingnexthotkey, accessibilityheadingprevhotkey 등)
  (3) 컴포넌트 hotkey 속성
  Environment.userhotkey와 같은 키 조합으로 단축키가 설정된 경우에는 우선순위에 따라 Environment.userhotkey 속성에 설정한 단축키만 동작합니다.
    
- 여러 개의 전역 단축키 설정 시 strId 또는 strUserHotkey 설정값이 중복된 경우에는 먼저 설정된 값만 등록됩니다.
  예를 들어 obj.userhotkey = "uk0=CTRL+A,uk1=CTRL+B,uk0=CTRL+C,uk3=CTRL+A,uk0=CTRL+A"로 설정한 경우 먼저 설정된 값과 중복된 항목은 제외하고 "uk0=CTRL+A,uk1=CTRL+B" 2개의 값만 적용됩니다.

usesoftkeyboard

usesoftkeyboard 속성을 가지는 컴포넌트가 포커스를 가질 때 키패드 표시 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.usesoftkeyboard [= bUseKeyboard]

문법 설정

bUseKeyboard ::= true | false

참고

- usesoftkeyboard 속성값을 설정하지 않으면 true로 적용됩니다.

- 컴포넌트의 usesoftkeyboard 속성값을 false로 일괄 적용하고자 하는 경우  Environment 오브젝트의 usesoftkeyboard 속성값을 false로 설정합니다.
  컴포넌트의 usesoftkeyboard 속성을 직접 설정하지 않은 경우(기본값이 적용된 상태)에는 Environment 오브젝트의 usesoftkeyboard 속성값인 false가 우선 적용됩니다.

- 컴포넌트의 usesoftkeyboard 속성값을 직접 설정한 경우에는 컴포넌트의 속성값이 우선 적용됩니다.
  예를 들어, Environment 오브젝트의 usesoftkeyboard 속성값을 false로 설정한 경우, 개별 컴포넌트의 usesoftkeyboard 속성값을 true로 적용하려면 해당 속성값을 true로 직접 설정해야 합니다.

usestringresource

애플리케이션 로딩 시 제너레이트 된 StringResource 로딩 여부를 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.usestringresource

문법 설정

usestringresource ::= true | false

참고

- 넥사크로 스튜디오에서만 값을 설정할 수 있고, 실행 중에는 수정할 수 없는 속성입니다.

-  usestringresource 속성값을 설정하지 않으면 false로 적용됩니다.

- StringResource 로딩 시 설정한 locale에 해당하는 StringResource 정보가 없는 경우에는 "en" 기준으로 StringResource를 로딩합니다.
  StringResource 로딩 시 locale 적용 우선순위는 다음과 같습니다.
  (1) Environment locale 속성
  (2) 사용자 운영체제 로케일 정보

- nexacro.loadStringResource 메서드 실행 시 strUrl 파라미터를 설정한 경우에는 usestringresource 속성값과 상관없이 StringResource를 로드합니다.

usewaitcursor

서버와 통신중 대기상태일때 WaitCursor 를 화면에 표시할 지 설정하는 속성입니다.

지원 환경

속성 타입

문법

Environment.usewaitcursor[= bWaitcursor]

문법 설정

bWaitcursor ::= 'true' | 'false'

var objEnv = nexacro.getEnvironment();
objEnv.usewaitcursor = true;

참고

- usewaitcursor 속성값을 설정하지 않으면 true 로 적용됩니다.

version

Environment 의 버전을 설정하는 속성입니다.

지원 환경

속성 타입