[v8에도 적용됩니다.]{class="badge positive" title="Campaign v8에도 적용됩니다."}

양식 구조 form-structure

양식의 설명은 양식 스키마 xtk:form ​의 문법을 관찰하는 구조화된 XML 문서입니다.

입력 양식의 XML 문서에는 양식 이름과 네임스페이스를 채우려면 이름 및 네임스페이스 특성이 있는 <form> 루트 요소가 있어야 합니다.

<form name="form_name" namespace="name_space">
…
</form>

기본적으로 양식은 이름과 네임스페이스가 동일한 데이터 스키마와 연결됩니다. 양식을 다른 이름과 연결하려면 <form> 요소의 entity-schema 특성을 스키마 키의 이름으로 설정합니다. 입력 양식의 구조를 설명하기 위해 "cus:recipient" 예제 스키마를 사용하는 인터페이스를 설명하겠습니다.

<srcSchema name="recipient" namespace="cus">
  <enumeration name="gender" basetype="byte">
    <value name="unknown" label="Not specified" value="0"/>
    <value name="male" label="Male" value="1"/>
    <value name="female" label="Female" value="2"/>
  </enumeration>

  <element name="recipient">
    <attribute name="email" type="string" length="80" label="Email" desc="Email address of recipient"/>
    <attribute name="birthDate" type="datetime" label="Date"/>
    <attribute name="gender" type="byte" label="Gender" enum="gender"/>
  </element>
</srcSchema>

예제 스키마를 기반으로 하는 입력 양식:

<form name="recipient" namespace="cus">
  <input xpath="@gender"/>
  <input xpath="@birthDate"/>
  <input xpath="@email"/>
</form>

편집 컨트롤에 대한 설명은 <form> 루트 요소에서 시작됩니다. 편집 컨트롤이 해당 스키마에 있는 필드의 경로를 포함하는 xpath 특성이 있는 <input> 요소에 입력되었습니다.

편집 컨트롤은 해당 데이터 유형에 자동으로 적응하고 스키마에 정의된 레이블을 사용합니다.

기본적으로 각 필드는 한 줄에 표시되며 데이터 유형에 따라 사용 가능한 모든 공간을 차지합니다.

양식화 formatting

컨트롤의 레이아웃은 HTML 테이블에 사용된 레이아웃과 비슷하며 컨트롤을 여러 열로 나누거나 요소를 교차시키거나 사용 가능한 공간 위치를 지정할 수 있습니다. 그러나 이 서식을 지정하면 영역을 비례로만 나눌 수 있습니다. 객체에 대해 고정 치수를 지정할 수 없습니다.

위의 예의 컨트롤을 두 열에 표시하려면 다음을 수행합니다.

<form name="recipient" namespace="cus">
  <container colcount="2">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email"/>
  </container>
</form>

colcount 특성이 있는 <container> 요소를 사용하면 자식 컨트롤을 두 열로 강제로 표시할 수 있습니다.

컨트롤의 colspan 특성은 해당 값에 입력한 열 수만큼 컨트롤을 확장합니다.

<form name="recipient" namespace="cus">
  <container colcount="2">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email" colspan="2"/>
  </container>
</form>

컨테이너는 type="frame" 특성을 채우면 label 특성에 포함된 레이블을 사용하여 자식 컨트롤 주위에 프레임을 추가합니다.

<form name="recipient" namespace="cus">
  <container colcount="2" type="frame" label="General">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email" colspan="2"/>
  </container>
</form>

<static> 요소를 사용하여 입력 양식 서식을 지정할 수 있습니다.

<form name="recipient" namespace="cus">
  <static type="separator" colspan="2" label="General"/>
  <input xpath="@gender"/>
  <input xpath="@birthDate"/>
  <input xpath="@email" colspan="2"/>
  <static type="help" label="General information about recipient with date of birth, gender, and email address." colspan="2"/>
</form>

separator 형식의 <static> 태그를 사용하면 label 특성에 포함된 레이블이 있는 구분 기호를 추가할 수 있습니다.

도움말 유형이 있는 <static> 태그를 사용하여 도움말 텍스트가 추가되었습니다. 텍스트 내용이 label 특성에 입력되었습니다.

컨테이너 containers

컨테이너를 사용하여 컨트롤 집합을 그룹화할 수 있습니다. <container> 요소에 의해 표시됩니다. 위에서 여러 열에 대한 컨트롤 서식을 지정하는 데 사용되었습니다.

<container>의 xpath 특성을 사용하면 자식 컨트롤 참조를 단순화할 수 있습니다. 그런 다음 컨트롤 참조는 부모 <container> 요소에 상대적입니다.

"xpath"가 없는 컨테이너의 예:

<container colcount="2">
  <input xpath="location/@zipCode"/>
  <input xpath="location/@city"/>
</container>

"위치"라는 요소에 "xpath"를 추가하는 예:

<container colcount="2" xpath="location">
  <input xpath="@zipCode"/>
  <input xpath="@city"/>
</container>

컨테이너 유형 types-of-container

컨테이너는 페이지 형식의 필드 집합을 사용하여 복잡한 컨트롤을 만드는 데 사용됩니다.

탭 컨테이너 tab-container

탭 컨테이너는 탭에서 액세스할 수 있는 페이지의 데이터 형식을 지정합니다.

<container type="notebook">
  <container colcount="2" label="General">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email" colspan="2"/>
  </container>
  <container colcount="2" label="Location">
    …
  </container>
</container>

기본 컨테이너는 type="notebook" 특성으로 정의됩니다. 자식 컨테이너에서 탭이 선언되고 탭의 레이블은 label 특성에서 채워집니다.

아이콘 목록 icon-list

이 컨테이너에는 표시할 페이지를 선택할 수 있는 세로 아이콘 막대가 표시됩니다.

<container type="iconbox">
  <container colcount="2" label="General" img="xtk:properties.png">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email" colspan="2"/>
  </container>
  <container colcount="2" label="Location" img="nms:msgfolder.png">
    …
  </container>
</container>

기본 컨테이너는 type="iconbox" 특성에 의해 정의됩니다. 아이콘과 연관된 페이지는 하위 컨테이너에 선언됩니다. 아이콘 레이블은 label 특성에서 채워집니다.

페이지의 아이콘은 img="<image>" 특성에서 채워집니다. 여기서 <image>은(는) 이름과 네임스페이스로 구성된 키에 해당하는 이미지 이름입니다(예: "xtk:properties.png").

이미지는 Administration > Configuration > Images 노드에서 사용할 수 있습니다.

가시성 컨테이너 visibility-container

동적 조건을 통해 컨트롤 집합을 마스킹할 수 있습니다.

다음 예에서는 "성별" 필드의 값에 대한 컨트롤의 가시성을 보여 줍니다.

<container type="visibleGroup" visibleIf="@gender=1">
  …
</container>
<container type="visibleGroup" visibleIf="@gender=2">
  …
</container>

가시성 컨테이너는 type="visibleGroup" 특성으로 정의됩니다. visibleIf 특성에 가시성 조건이 있습니다.

조건 구문의 예:

활성화 컨테이너 enabling-container

이 컨테이너를 사용하여 동적 조건에서 데이터 세트를 활성화하거나 비활성화할 수 있습니다. 컨트롤을 비활성화하면 편집할 수 없습니다. 다음 예제에서는 "Gender" 필드의 값에서 컨트롤을 사용하는 방법을 보여 줍니다.

<container type="enabledGroup" enabledIf="@gender=1">
  …
</container>
<container type="enabledGroup" enabledIf="@gender=2">
  …
</container>

활성화 컨테이너는 type="enabledGroup" 특성에 의해 정의됩니다. enabledIf 특성에 활성화 조건이 포함되어 있습니다.

링크 편집 editing-a-link

링크는 다음과 같이 데이터 스키마에서 선언됩니다.

<element label="Company" name="company" target="cus:company" type="link"/>

입력 양식에서 링크의 편집 컨트롤은 다음과 같습니다.

<input xpath="company"/>

타겟 선택은 편집 필드를 통해 액세스할 수 있습니다. 입력 시 자동 완성 기능이 지원되므로 처음 입력한 몇 문자에서 대상 요소를 쉽게 찾을 수 있습니다. 그런 다음 대상 스키마에 정의된 계산 문자열 ​을(를) 기준으로 검색합니다. 컨트롤에서 유효성 검사 후 스키마가 존재하지 않으면 즉시 대상 만들기에 대한 확인 메시지가 표시됩니다. 이 확인란은 대상 테이블에 새 레코드를 만들고 이를 링크와 연결합니다.

드롭다운 목록은 이미 생성된 레코드 목록에서 대상 요소를 선택하는 데 사용됩니다.

Modify the link(폴더) 아이콘은 타겟팅된 요소 목록과 필터 영역이 있는 선택 양식을 시작합니다.

Edit link(돋보기) 아이콘은 연결된 요소의 편집 양식을 시작합니다. 사용된 양식은 타겟팅된 스키마의 키에서 기본적으로 추론됩니다. form 특성을 사용하면 편집 양식 이름(예: "cus:company2")을 강제 적용할 수 있습니다.

입력 양식의 링크 정의에서 <sysfilter> 요소를 추가하여 대상 요소의 선택을 제한할 수 있습니다.

<input xpath="company">
  <sysFilter>
    <condition expr="[location/@city] =  'Newton"/>
  </sysFilter>
</input>

<orderby> 요소를 사용하여 목록을 정렬할 수도 있습니다.

<input xpath="company">
  <orderBy>
    <node expr="[location/@zipCode]"/>
  </orderBy>
</input>

컨트롤 속성 control-properties

링크 목록 list-of-links

데이터 스키마에 컬렉션 요소(바인딩되지 않음="true")로 입력한 링크가 목록을 통과해야 연결된 모든 요소를 볼 수 있습니다.

이 원칙은 데이터 로드가 최적화된 연결된 요소 목록을 표시하는 데 있습니다(데이터 배치로 다운로드, 표시되는 경우에만 목록 실행).

스키마의 컬렉션 링크 예:

<element label="Events" name="rcpEvent" target="cus:event" type="link" unbound="true">
…
</element>

입력 양식의 목록:

 <input xpath="rcpEvent" type="linklist">
  <input xpath="@label"/>
  <input xpath="@date"/>
</input>

목록 컨트롤은 type="linklist" 특성에 의해 정의됩니다. 목록 경로는 컬렉션 링크를 참조해야 합니다.

열은 목록의 <input> 요소를 통해 선언됩니다. xpath 특성은 대상 스키마에 있는 필드의 경로를 참조합니다.

레이블(스키마의 링크에 정의됨)이 있는 도구 모음은 자동으로 목록 위에 배치됩니다.

Filters 단추를 통해 목록을 필터링하고 열을 추가하고 정렬하도록 구성할 수 있습니다.

Add 및 Delete 단추를 사용하여 링크에서 컬렉션 요소를 추가하거나 삭제할 수 있습니다. 기본적으로 요소를 추가하면 대상 스키마의 편집 양식이 실행됩니다.

zoom="true" 특성이 목록의 <input> 태그에서 완료되면 Detail 단추가 자동으로 추가됩니다. 이 단추를 사용하면 선택한 줄의 편집 양식을 시작할 수 있습니다.

필터링 및 정렬은 목록이 로드될 때 적용할 수 있습니다.

 <input xpath="rcpEvent" type="linklist">
  <input xpath="@label"/>
  <input xpath="@date"/>
  <sysFilter>
    <condition expr="@type = 1"/>
  </sysFilter>
  <orderBy>
    <node expr="@date" sortDesc="true"/>
  </orderBy>
</input>

관계 테이블 relationship-table

관계 테이블을 사용하면 두 테이블을 N-N 카디널리티로 연결할 수 있습니다. 관계 테이블에는 두 테이블에 대한 링크만 포함되어 있습니다.

따라서 목록에 요소를 추가하면 관계 테이블의 두 링크 중 하나에서 목록을 완료할 수 있습니다.

스키마의 관계 테이블 예:

<srcSchema name="subscription" namespace="cus">
  <element name="recipient" type="link" target="cus:recipient" label="Recipient"/>
  <element name="service" type="link" target="cus:service" label="Subscription service"/>
</srcSchema>

이 예제에서는 "cus:recipient" 스키마의 입력 양식으로 시작합니다. 목록에는 서비스 구독에 대한 연결이 표시되어야 하며 기존 서비스를 선택하여 구독을 추가할 수 있도록 허용해야 합니다.

<input type="linklist" xpath="subscription" xpathChoiceTarget="service" xpathEditTarget="service" zoom="true">
  <input xpath="recipient"/>
  <input xpath="service"/>
</input>

xpathChoiceTarget 특성을 사용하면 입력한 링크에서 선택 양식을 시작할 수 있습니다. 관계 테이블 레코드를 만들면 현재 수신자와 선택한 서비스에 대한 링크가 자동으로 업데이트됩니다.

목록 속성 list-properties

메모리 목록 컨트롤 memory-list-controls

메모리 목록을 사용하면 목록 데이터 미리 로드를 사용하여 컬렉션 요소를 편집할 수 있습니다. 이 목록은 필터링하거나 구성할 수 없습니다.

이러한 목록은 XML 매핑 컬렉션 요소 또는 낮은 볼륨 링크에 사용됩니다.

열 목록 column-list

이 컨트롤에는 추가 및 삭제 단추가 포함된 도구 모음이 있는 편집 가능한 열 목록이 표시됩니다.

<input xpath="rcpEvent" type="list">
  <input xpath="@label"/>
  <input xpath="@date"/>
</input>

목록 컨트롤은 type="list" 특성으로 채워야 하며 목록의 경로는 컬렉션 요소를 참조해야 합니다.

목록의 자식 <input> 태그에서 열이 선언되었습니다. 열 레이블과 크기는 label 및 colSize 특성으로 강제 적용할 수 있습니다.

도구 모음 단추를 가로로 정렬할 수 있습니다.

<input nolabel="true" toolbarCaption="List of events" type="list" xpath="rcpEvent" zoom="true">
  <input xpath="@label"/>
  <input xpath="@date"/>
</input>

toolbarCaption 특성은 도구 모음의 가로 맞춤을 강제 적용하고 목록 위에 제목을 입력합니다.

목록 확대 zoom-in-a-list

목록의 데이터 삽입 및 편집은 별도의 편집 양식에 입력할 수 있습니다.

<input nolabel="true" toolbarCaption="List of events" type="list" xpath="rcpEvent" zoom="true" zoomOnAdd="true">
  <input xpath="@label"/>
  <input xpath="@date"/>

  <form colcount="2" label="Event">
    <input xpath="@label"/>
    <input xpath="@date"/>
  </form>
</input>

목록 정의 아래의 <form> 요소에서 편집 양식을 완료했습니다. 구조는 입력 양식의 구조와 동일합니다. zoom="true" 특성이 목록의 <input> 태그에서 완료되면 Detail 단추가 자동으로 추가됩니다. 이 속성을 사용하면 선택한 행의 편집 양식을 시작할 수 있습니다.

목록 속성 list-properties-1

편집할 수 없는 필드 non-editable-fields

필드를 표시하고 편집할 수 없도록 하려면 <value> 태그를 사용하거나 <input> 태그에서 readOnly="true" 특성을 완료하십시오.

"성별" 필드의 예:

<value value="@gender"/>
<input xpath="@gender" readOnly="true"/>

라디오 버튼 radio-button

라디오 버튼을 사용하면 여러 옵션 중에서 선택할 수 있습니다. <input> 태그는 가능한 옵션을 나열하는 데 사용되며 checkedValue 특성은 선택 항목과 연결된 값을 지정합니다.

"성별" 필드의 예:

<input type="RadioButton" xpath="@gender" checkedValue="0" label="Choice 1"/>
<input type="RadioButton" xpath="@gender" checkedValue="1" label="Choice 2"/>
<input type="RadioButton" xpath="@gender" checkedValue="2" label="Choice 3"/>

확인란 checkbox

확인란은 부울 상태(선택 여부에 상관없이)를 반영합니다. 기본적으로 이 컨트롤은 "부울"(true/false) 필드에 사용됩니다. 기본값이 0 또는 1인 변수를 이 단추와 연결할 수 있습니다. 이 값은 checkValue 특성을 통해 오버로드될 수 있습니다.

<input xpath="@boolean1"/>
<input xpath="@field1" type="checkbox" checkedValue="Y"/>

열거형 enumeration

탐색 계층 편집 navigation-hierarchy-edit

이 컨트롤은 편집할 필드 집합에 트리를 만듭니다.

편집할 컨트롤은 트리 컨트롤의 <input> 태그 아래에 입력한 <container>(으)로 그룹화됩니다.

<input nolabel="true" type="treeEdit">
  <container label="Text fields">
    <input xpath="@text1"/>
    <input xpath="@text2"/>
  </container>
  <container label="Boolean fields">
    <input xpath="@boolean1"/>
    <input xpath="@boolean2"/>
  </container>
</input>

표현식 필드 expression-field

식 필드는 식에서 필드를 동적으로 업데이트합니다. <input> 태그는 업데이트할 필드의 경로를 입력하는 xpath 특성과 업데이트 식을 포함하는 expo 특성과 함께 사용됩니다.

<!-- Example: updating the boolean1 field from the value contained in the field with path /tmp/@flag -->
<input expr="Iif([/tmp/@flag]=='On', true, false)" type="expr" xpath="@boolean1"/>
<input expr="[/ignored/@action] == 'FCP'" type="expr" xpath="@launchFCP"/>

양식 컨텍스트 context-of-forms

입력 양식을 실행하면 편집 중인 엔티티 데이터가 포함된 XML 문서가 초기화됩니다. 이 문서는 양식의 컨텍스트를 나타내며 작업 공간으로 사용할 수 있습니다.

컨텍스트 업데이트 updating-the-context

양식의 컨텍스트를 수정하려면 <set expr="<value>" xpath="<field>"/> 태그를 사용하십시오. 여기서 <field>은(는) 대상 필드이고 <value>은(는) 업데이트 표현식 또는 값입니다.

<set> 태그의 사용 예:

<enter> 및 <leave> 태그를 통해 양식을 초기화하고 닫을 때 양식의 컨텍스트를 업데이트할 수 있습니다.

<form name="recipient" namespace="cus">
  <enter>
    <set…
  </enter>
  …
  <leave>
    <set…
  </leave>
</form>

표현식 언어 expression-language-

조건부 테스트를 수행하기 위해 폼 정의에 매크로 언어를 사용할 수 있습니다.

식이 확인된 경우 <if expr="<expression>" /> 태그는 태그 아래에 지정된 명령을 실행합니다.

<if expr="([/tmp/@test] == 'Test' or @lastName != 'Doe') and @boolean2 == true">
  <set xpath="@boolean1" expr="true"/>
</if>

<error> 태그와 결합된 <check expr="<condition>" /> 태그는 양식의 유효성 검사를 방지하고 조건이 충족되지 않으면 오류 메시지를 표시합니다.

<leave>
  <check expr="/tmp/@test != ''">
    <error>You must populate the 'Test' field!</error>
  </check>
</leave>

마법사 wizards

도우미는 페이지 형태로 데이터 입력 단계 집합을 안내합니다. 입력한 데이터는 양식의 유효성을 검사할 때 저장됩니다.

어시스턴트는 다음과 같은 구조를 가지고 있습니다.

<form type="wizard" name="example" namespace="cus" img="nms:rcpgroup32.png" label="Assistant example" entity-schema="nms:recipient">
  <container title="Title of page 1" desc="Long description of page 1">
    <input xpath="@lastName"/>
    <input xpath="comment"/>
  </container>
  <container title="Title of page 2" desc="Long description of page 2">
    …
  </container>
  …
</form>

<form> 요소에 type="wizard" 특성이 있으면 양식을 작성할 때 도우미 모드를 정의할 수 있습니다. <form> 요소의 하위 요소인 <container> 요소에서 페이지가 완료됩니다. 페이지의 <container> 요소는 제목의 제목 특성으로 채워지고 페이지 제목 아래에 설명을 표시하도록 설명됩니다. 페이지 간 탐색을 허용하도록 Previous 및 Next 단추가 자동으로 추가됩니다.

Finish 단추를 사용하면 입력한 데이터가 저장되고 양식이 닫힙니다.

SOAP 메서드 soap-methods

SOAP 메서드 실행은 페이지 끝에 있는 채워진 <leave> 태그에서 시작할 수 있습니다.

<soapcall> 태그에는 다음 입력 매개 변수를 사용하는 메서드에 대한 호출이 포함되어 있습니다.

<soapCall name="<name>" service="<schema>">
  <param  type="<type>" exprIn="<xpath>"/>
  …
</soapCall>

서비스 이름 및 해당 구현 스키마는 <soapcall> 태그의 name 및 service 특성을 통해 입력됩니다.

입력 매개 변수는 <soapcall> 태그 아래의 <param> 요소에 설명되어 있습니다.

type 특성을 통해 매개 변수 형식을 지정해야 합니다. 가능한 유형은 다음과 같습니다.

exprIn 특성에 매개 변수로 전달할 데이터의 위치가 있습니다.

예:

<leave>
  <soapCall name="RegisterGroup" service="nms:recipient">
    <param  type="DOMElement"    exprIn="/tmp/entityList"/>
    <param  type="DOMElement"    exprIn="/tmp/choiceList"/>
    <param  type="boolean"       exprIn="true"/>
  </soapCall>
</leave>