양식 편집 editing-forms

메뉴에서 Administration > Configuration > Input forms ​을(를) 선택합니다.

목록의 오른쪽 상단에 있는 New 단추를 클릭합니다.

양식 속성 지정:

• 양식 이름과 네임스페이스를 지정합니다.

  양식 이름 및 네임스페이스는 관련 데이터 스키마와 일치할 수 있습니다. 이 예제에서는 cus:order 데이터 스키마에 대한 양식을 보여 줍니다.

  code language-xml
  <form entitySchema="xtk:form" img="xtk:form.png" label="Order" name="order" namespace="cus" type="iconbox" xtkschema="xtk:form"> […] </form>

  또는 entity-schema 특성에 데이터 스키마를 명시적으로 지정할 수 있습니다.

  code language-xml
  <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 ​을(를) 클릭합니다.

   

선택적으로 필드 편집기를 지정합니다.

기본 필드 편집기는 각 데이터 유형과 연결되어 있습니다.

• 날짜 유형 필드의 경우, 양식에 입력 캘린더가 표시됩니다.
• 열거형 필드의 경우 양식에 선택 목록이 표시됩니다.

다음 필드 편집기 유형을 사용할 수 있습니다.

메모리 목록 컨트롤에 대해 자세히 알아보세요.

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

예:

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

<form> 요소의 type 특성을 iconbox(으)로 변경합니다.

<form […] type="iconbox">

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

1. <container> 요소를 <form> 요소의 자식으로 추가합니다.

2. 아이콘의 레이블과 이미지를 정의하려면 label 및 img 특성을 사용합니다.

   code language-xml
   <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>

또는 기존 <container> 요소에서 type="frame" 특성을 제거합니다.

<form> 요소의 type 특성을 notebook(으)로 변경합니다.

<form […] type="notebook">

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

1. <container> 요소를 <form> 요소의 자식으로 추가합니다.
2. 아이콘의 레이블과 이미지를 정의하려면 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>

또는 기존 <container> 요소에서 type="frame" 특성을 제거합니다.

팩터리 입력 양식 수정:

1. 메뉴에서 Administration > Configuration > Input forms ​을(를) 선택합니다.
2. 입력 양식을 선택하고 수정합니다.

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

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

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

예:

function nms_recipient_checkValue(value)
{
  logInfo("checking value " + value)
  if (…)
  {
    logError("Value " + value + " is not valid")
  }
  return 1
}

이 예제에서 함수의 이름은 checkValue입니다. 이 함수는 nms 네임스페이스에서 recipient 데이터 형식을 확인하는 데 사용합니다. 확인 중인 값이 기록됩니다. 값이 올바르지 않으면 오류 메시지가 기록됩니다. 값이 유효하면 값 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> 요소를 사용하는 경우 입력한 정보의 유효성을 검사할 때까지 사용자가 양식을 저장할 수 없습니다.