v7 v8

양식 편집

마지막 업데이트: 2023-08-31

주제:
Configuration
이 항목에 대한 자세한 내용 보기

작성 대상:
Developer

개요

마케터와 연산자는 입력 양식을 사용하여 레코드를 만들고, 수정하고, 미리 봅니다. Forms은 정보를 시각적으로 표시합니다.

입력 양식을 만들고 수정할 수 있습니다.

기본적으로 제공되는 출고 시 입력 양식을 수정할 수 있습니다. 팩터리 입력 양식은 팩터리 데이터 스키마를 기반으로 합니다.
정의한 데이터 스키마를 기반으로 하여 사용자 정의 입력 양식을 생성할 수 있습니다.

Forms은 의 엔티티입니다. xtk:form 유형. 다음에서 입력 양식 구조를 볼 수 있습니다. xtk:form 스키마. 이 스키마를 보려면 Administration > Configuration > Data schemas 메뉴에서 삭제할 수 있습니다. 자세한 내용 양식 구조.

입력 양식에 액세스하려면 다음을 선택합니다 Administration> Configuration >Input forms 메뉴에서:

양식을 디자인하려면 XML 편집기에서 XML 내용을 편집합니다.

양식을 미리 보려면 Preview 탭:

양식 유형

다양한 유형의 입력 양식을 만들 수 있습니다. 양식 유형은 사용자가 양식을 탐색하는 방법을 결정합니다.

콘솔 화면

기본 양식 유형입니다. 양식은 하나의 페이지로 구성됩니다.
콘텐츠 관리

콘텐츠 관리에 이 양식 유형을 사용합니다. 이 항목 보기 사용 사례.
마법사

이 양식은 특정 시퀀스로 순서가 지정된 여러 부동 화면으로 구성됩니다. 사용자는 한 화면에서 다음 화면으로 이동합니다. 자세히 보기.
아이콘 상자

이 양식은 여러 페이지로 구성됩니다. 양식을 탐색하려면 양식 왼쪽에 있는 아이콘을 선택합니다.
Notebook

이 양식은 여러 페이지로 구성됩니다. 양식을 탐색하려면 양식 맨 위에서 탭을 선택합니다.
세로 창

이 양식은 탐색 트리를 보여 줍니다.
가로 창

이 양식에는 항목 목록이 표시됩니다.

컨테이너

양식에서 다양한 용도로 컨테이너를 사용할 수 있습니다.

양식 내에서 컨텐츠 구성
입력 필드에 대한 액세스 정의
다른 양식 내에 양식 중첩

컨텐츠 구성

컨테이너를 사용하여 양식 내에서 콘텐츠를 구성합니다.

필드를 섹션으로 그룹화할 수 있습니다.
다중 페이지 양식에 페이지를 추가할 수 있습니다.

컨테이너를 삽입하려면 <container> 요소를 생성하지 않습니다. 자세히 보기.

그룹 필드

컨테이너를 사용하여 입력 필드를 구성된 섹션으로 그룹화합니다.

양식에 섹션을 삽입하려면 다음 요소를 사용합니다. <container type="frame">. 선택적으로 섹션 제목을 추가하려면 label 특성.

구문: <container type="frame" label="section_title"> […] </container>

이 예에서 컨테이너는 생성 다음 항목으로 구성되는 구역 Created by 및 Name 입력 필드:

<form _cs="Coupons (nms)" entitySchema="xtk:form" img="xtk:form.png" label="Coupons"
      name="coupon" namespace="nms" type="default" xtkschema="xtk:form">
  <input xpath="@code"/>
  <input xpath="@type"/>
  <container label="Creation" type="frame">
    <input xpath="createdBy"/>
    <input xpath="createdBy/@name"/>
  </container>
</form>

다중 페이지 양식에 페이지 추가

다중 페이지 양식의 경우 컨테이너를 사용하여 양식 페이지를 만듭니다.

이 예는 의 컨테이너를 보여 줍니다. 일반 및 세부 사항 양식 페이지:

<container img="ncm:book.png" label="General">
[…]
</container>
<container img="ncm:detail.png" label="Details">
[…]
</container>

필드에 대한 액세스 정의

컨테이너를 사용하여 표시되는 항목을 정의하고 필드에 대한 액세스를 정의합니다. 필드 그룹을 켜거나 끌 수 있습니다.

양식 중첩

컨테이너를 사용하여 양식을 다른 양식 내에 중첩합니다. 자세히 보기.

이미지에 대한 참조

이미지를 찾으려면 다음을 선택합니다 Administration > Configuration > Images 메뉴에서 삭제할 수 있습니다.

이미지를 양식의 요소(예: 아이콘)와 연결하려면 이미지에 참조를 추가할 수 있습니다. 사용 img 속성(예: ) <container> 요소를 생성하지 않습니다.

구문: img="namespace:filename.extension"

이 예제는 book.png 및 detail.png 의 이미지 ncm 네임스페이스:

<container img="ncm:book.png" label="General">
[…]
</container>
<container img="ncm:detail.png" label="Details">
[…]
</container>

이 이미지는 사용자가 다중 페이지 양식을 탐색하기 위해 클릭하는 아이콘에 사용됩니다.

간단한 양식 만들기

양식을 만들려면 다음 단계를 수행합니다.

메뉴에서 다음을 선택합니다. Administration > Configuration > Input forms.
다음을 클릭합니다. New 목록의 오른쪽 상단에 있는 단추입니다.
양식 속성 지정:
- 양식 이름과 네임스페이스를 지정합니다.
  
  양식 이름 및 네임스페이스는 관련 데이터 스키마와 일치할 수 있습니다. 이 예제는 cus:order 데이터 스키마:
```
<form entitySchema="xtk:form" img="xtk:form.png" label="Order" name="order" namespace="cus" type="iconbox" xtkschema="xtk:form">
  […]
</form>
```
  또는 entity-schema 특성.
```
<form entity-schema="cus:stockLine" entitySchema="xtk:form" img="xtk:form.png" label="Stock order" name="stockOrder" namespace="cus" xtkschema="xtk:form">
  […]
</form>
```
- 양식에 표시할 레이블을 지정합니다.
- 필요한 경우 양식 유형을 지정합니다. 양식 유형을 지정하지 않으면 기본적으로 콘솔 화면 유형이 사용됩니다.
  
  다중 페이지 양식을 디자인하는 경우 <form> 요소를 만들고 컨테이너에 유형을 지정합니다.
Save를 클릭합니다.
양식 요소를 삽입합니다.

예를 들어 입력 필드를 삽입하려면 <input> 요소를 생성하지 않습니다. 설정 xpath 필드 참조에 대한 속성을 XPath 식으로 지정합니다. 자세히 보기.

다음 예에서는 다음을 기반으로 입력 필드를 보여줍니다. nms:recipient 스키마.
```
<input xpath="@firstName"/>
<input xpath="@lastName"/>
```
양식이 특정 스키마 유형을 기반으로 하는 경우 이 스키마에 대한 필드를 조회할 수 있습니다.
1. 클릭 Insert > Document fields.
2. 필드를 선택하고 OK.
선택적으로 필드 편집기를 지정합니다.

기본 필드 편집기는 각 데이터 유형과 연결되어 있습니다.
- 날짜 유형 필드의 경우, 양식에 입력 캘린더가 표시됩니다.
- 열거형 필드의 경우 양식에 선택 목록이 표시됩니다.
다음 필드 편집기 유형을 사용할 수 있습니다.

필드 편집기 양식 속성

라디오 버튼 type="radiobutton"

확인란 type="checkbox"

트리 편집 type="tree"

자세한 내용 메모리 목록 컨트롤.

필드 편집기	양식 속성
라디오 버튼	`type="radiobutton"`
확인란	`type="checkbox"`
트리 편집	`type="tree"`

필드에 대한 액세스를 정의합니다(선택적).

요소	속성	설명
`<input>`	`read-only="true"`	필드에 읽기 전용 액세스 권한 제공
`<container>`	`type="visibleGroup" visibleIf="`edit-expr`"`	조건부로 필드 그룹 표시
`<container>`	`type="enabledGroup" enabledIf="`edit-expr`"`	조건부로 필드 그룹 활성화

예제:

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

선택적으로 컨테이너를 사용하여 필드를 섹션으로 그룹화합니다.

<container type="frame" label="Name">
   <input xpath="@firstName"/>
   <input xpath="@lastName"/>
</container>
<container type="frame" label="Contact details">
   <input xpath="@email"/>
   <input xpath="@phone"/>
</container>

다중 페이지 양식 만들기

다중 페이지 양식을 만들 수 있습니다. 다른 양식 내에 양식을 중첩할 수도 있습니다.

만들기 `iconbox` 양식

사용 iconbox 양식 유형 : 양식 왼쪽에 사용자를 양식의 다른 페이지로 안내하는 아이콘을 표시합니다.

기존 양식의 유형을 다음으로 변경하려면 iconbox, 다음 단계를 수행합니다.

변경 type 속성 <form> 요소 대상 iconbox:
```
<form […] type="iconbox">
```

각 양식 페이지에 대한 컨테이너를 설정합니다.

추가 <container> 요소를 의 하위 항목으로 <form> 요소를 생성하지 않습니다.

아이콘의 레이블과 이미지를 정의하려면 label 및 img 속성.

<form entitySchema="xtk:form" name="Service provider" namespace="nms" type="iconbox" xtkschema="xtk:form">
    <container img="xtk:properties.png" label="General">
        <input xpath="@label"/>
        <input xpath="@name"/>
        […]
    </container>
    <container img="nms:msgfolder.png" label="Details">
        <input xpath="@address"/>
        […]
    </container>
    <container img="nms:supplier.png" label="Services">
        […]
    </container>
</form>

또는 type="frame" 기존 속성 <container> 요소.

전자 필기장 양식 만들기

사용 notebook 양식 유형 : 양식 상단에 탭을 표시하여 사용자를 다른 페이지로 안내합니다.

기존 양식의 유형을 다음으로 변경하려면 notebook, 다음 단계를 수행합니다.

변경 type 속성 <form> 요소 대상 notebook:
```
<form […] type="notebook">
```

각 양식 페이지에 대한 컨테이너 추가:

추가 <container> 요소를 의 하위 항목으로 <form> 요소를 생성하지 않습니다.
아이콘의 레이블과 이미지를 정의하려면 label 및 img 속성.

  <form entitySchema="xtk:form" name="Service provider" namespace="nms" type="notebook" xtkschema="xtk:form">
      <container label="General">
          <input xpath="@label"/>
          <input xpath="@name"/>
          […]
      </container>
      <container label="Details">
          <input xpath="@address"/>
          […]
      </container>
      <container label="Services">
          […]
      </container>
  </form>

또는 type="frame" 기존 속성 <container> 요소.

양식 중첩

다른 양식 내에 양식을 중첩할 수 있습니다. 예를 들어 전자 필기장 양식을 iconbox 양식 내에 중첩할 수 있습니다.

중첩 수준은 탐색을 제어합니다. 사용자는 하위 양식으로 드릴다운할 수 있습니다.

다른 양식 내에 양식을 중첩하려면 <container> 요소 및 설정 type 속성을 양식 유형으로 지정합니다. 최상위 폼의 경우 외부 컨테이너나 <form> 요소를 생성하지 않습니다.

예제

다음 예에서는 복잡한 양식을 보여 줍니다.

최상위 양식은 iconbox 양식입니다. 이 양식에는 레이블이 지정된 두 개의 컨테이너가 있습니다. 일반 및 세부 사항.

그 결과, 외부 양식은 일반 및 세부 사항 최상위 수준의 페이지. 이러한 페이지에 액세스하려면 양식 왼쪽에 있는 아이콘을 클릭합니다.
하위 양식은 내부에 중첩된 전자 필기장 양식입니다 일반 컨테이너. 하위 폼은 레이블이 지정된 두 개의 컨테이너로 구성됩니다 이름 및 연락처.

<form _cs="Profile (nms)" entitySchema="xtk:form" img="xtk:form.png" label="Profile" name="profile" namespace="nms" xtkschema="xtk:form">
  <container type="iconbox">
    <container img="ncm:general.png" label="General">
      <container type="notebook">
        <container label="Name">
          <input xpath="@firstName"/>
          <input xpath="@lastName"/>
        </container>
        <container label="Contact">
          <input xpath="@email"/>
        </container>
      </container>
    </container>
    <container img="ncm:detail.png" label="Details">
      <input xpath="@birthDate"/>
    </container>
  </container>
</form>

그 결과 일반 외부 양식의 페이지에는 다음 항목이 표시됩니다. 이름 및 연락처 탭.

예제

다음 예에서는 복잡한 양식을 보여 줍니다.

최상위 양식은 iconbox 양식입니다. 이 양식에는 레이블이 지정된 두 개의 컨테이너가 있습니다. 일반 및 세부 사항.

그 결과, 외부 양식은 일반 및 세부 사항 최상위 수준의 페이지. 이러한 페이지에 액세스하려면 양식 왼쪽에 있는 아이콘을 클릭합니다.
하위 양식은 내부에 중첩된 전자 필기장 양식입니다 일반 컨테이너. 하위 폼은 레이블이 지정된 두 개의 컨테이너로 구성됩니다 이름 및 연락처.

<form _cs="Profile (nms)" entitySchema="xtk:form" img="xtk:form.png" label="Profile" name="profile" namespace="nms" xtkschema="xtk:form">
  <container type="iconbox">
    <container img="ncm:general.png" label="General">
      <container type="notebook">
        <container label="Name">
          <input xpath="@firstName"/>
          <input xpath="@lastName"/>
        </container>
        <container label="Contact">
          <input xpath="@email"/>
        </container>
      </container>
    </container>
    <container img="ncm:detail.png" label="Details">
      <input xpath="@birthDate"/>
    </container>
  </container>
</form>

그 결과 일반 외부 양식의 페이지에는 다음 항목이 표시됩니다. 이름 및 연락처 탭.

팩터리 입력 양식 수정

공장 양식을 수정하려면 다음 단계를 수행합니다.

팩터리 입력 양식 수정:
1. 메뉴에서 다음을 선택합니다. Administration > Configuration > Input forms.
2. 입력 양식을 선택하고 수정합니다.
팩터리 데이터 스키마를 확장할 수 있지만 팩터리 입력 양식은 확장할 수 없습니다. 출고 시 입력 양식을 다시 작성하지 않고 직접 수정하는 것이 좋습니다. 소프트웨어 업그레이드 중에 출하 시 입력 양식의 수정 사항이 업그레이드와 병합됩니다. 자동 병합에 실패하면 충돌을 해결할 수 있습니다. 자세히 보기.

예를 들어 추가 필드를 사용하여 팩토리 스키마를 확장하는 경우 이 필드를 관련 팩토리 양식에 추가할 수 있습니다.

양식 유효성 검사

양식에 유효성 검사 컨트롤을 포함할 수 있습니다.

필드에 읽기 전용 액세스 권한 부여

필드에 읽기 전용 액세스 권한을 부여하려면 readOnly="true" 특성. 예를 들어, 읽기 전용 액세스 권한이 있는 레코드의 기본 키를 표시할 수 있습니다. 자세히 보기.

이 예제에서는 기본 키(iRecipientId의 ) nms:recipient 스키마가 읽기 전용 액세스로 표시됩니다.

<value xpath="@iRecipientId" readOnly="true"/>

필수 필드 확인

필수 정보를 확인할 수 있습니다.

사용 required="true" 필수 필드에 대한 속성입니다.
사용 <leave> 노드를 사용하여 이러한 필드를 확인하고 오류 메시지를 표시할 수 있습니다.

이 예에서는 이메일 주소가 필수이며, 사용자가 이 정보를 제공하지 않은 경우 오류 메시지가 표시됩니다.

<input xpath="@email" required="true"/>
<leave>
  <check expr="@email!=''">
    <error>The email address is required.</error>
  </check>
</leave>

자세한 내용 표현식 필드 및 양식 컨텍스트.

값 유효성 검사

JavaScript SOAP 호출을 사용하여 콘솔에서 양식 데이터의 유효성을 검사할 수 있습니다. 예를 들어 복잡한 유효성 검사에 이러한 호출을 사용하여 승인된 값 목록에 대해 값을 확인합니다. 자세히 보기.

JS 파일에 유효성 검사 함수를 만듭니다.

예제:
```
function nms_recipient_checkValue(value)
{
  logInfo("checking value " + value)
  if (…)
  {
    logError("Value " + value + " is not valid")
  }
  return 1
}
```
이 예제에서 함수의 이름은 입니다 checkValue. 이 함수는 recipient 의 데이터 유형 nms 네임스페이스입니다. 확인 중인 값이 기록됩니다. 값이 올바르지 않으면 오류 메시지가 기록됩니다. 값이 유효하면 값 1이 반환됩니다.

반환된 값을 사용하여 양식을 수정할 수 있습니다.
양식에서 <soapCall> 요소에 대한 <leave> 요소를 생성하지 않습니다.

이 예제에서는 SOAP 호출을 사용하여 @valueToCheck 문자열:
```
<form name="recipient" (…)>
(…)
  <leave>
    <soapCall name="checkValue" service="nms:recipient">
      <param exprIn="@valueToCheck" type="string"/>
    </soapCall>
  </leave>
</form>
```
이 예에서는 checkValue 메서드 및 nms:recipient 서비스 사용:
- 서비스는 네임스페이스와 데이터 유형입니다.
- 메서드는 함수 이름입니다. 이름은 대/소문자를 구분합니다.
호출이 동기적으로 수행됩니다.

모든 예외가 표시됩니다. 를 사용하는 경우 <leave> 요소를 선택한 경우 사용자는 입력한 정보의 유효성을 검사할 때까지 양식을 저장할 수 없습니다.

다음 예에서는 양식 내에서 서비스를 호출하는 방법을 보여 줍니다.

<enter>
  <soapCall name="client" service="c4:ybClient">
    <param exprIn="@id" type="string"/>
    <param type="boolean" xpathOut="/tmp/@count"/>
  </soapCall>
</enter>

이 예에서 입력은 기본 키인 ID입니다. 사용자가 이 ID의 양식을 채우면 이 ID를 입력 매개 변수로 사용하여 SOAP 호출이 수행됩니다. 출력은 이 필드에 작성되는 부울입니다. /tmp/@count. 양식 내에서 이 부울을 사용할 수 있습니다. 자세한 내용 양식 컨텍스트.

이전 페이지

양식 편집

개요

양식 유형

컨테이너

컨텐츠 구성

그룹 필드

다중 페이지 양식에 페이지 추가

필드에 대한 액세스 정의

양식 중첩

이미지에 대한 참조

간단한 양식 만들기

다중 페이지 양식 만들기

만들기 `iconbox` 양식

전자 필기장 양식 만들기

양식 중첩

예제

예제

팩터리 입력 양식 수정

양식 유효성 검사

필드에 읽기 전용 액세스 권한 부여

필수 필드 확인

값 유효성 검사

이 페이지의

다음 보기:

학습

설명서

커뮤니티

지원

리소스

Adobe 계정

Adobe

양식 편집

개요

양식 유형

컨테이너

컨텐츠 구성

그룹 필드

다중 페이지 양식에 페이지 추가

필드에 대한 액세스 정의

양식 중첩

이미지에 대한 참조

간단한 양식 만들기

다중 페이지 양식 만들기

만들기 iconbox 양식

전자 필기장 양식 만들기

양식 중첩

예제

예제

팩터리 입력 양식 수정

양식 유효성 검사

필드에 읽기 전용 액세스 권한 부여

필수 필드 확인

값 유효성 검사

이 페이지의

다음 보기:

학습

설명서

커뮤니티

지원

리소스

Adobe 계정

Adobe

만들기 `iconbox` 양식