フォームの編集 editing-forms

メニューから次を選択します 管理 > 設定 > 入力フォーム.

「」をクリックします 新規 ボタンをクリックします。

フォームのプロパティを指定します。

• フォーム名と名前空間を指定します。

  フォーム名と名前空間は、関連するデータスキーマと一致させることができます。 この例では、のフォームを示します 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> 要素を選択し、コンテナ内のタイプを指定します。

「保存」をクリックします。

フォーム要素を挿入します。

例えば、入力フィールドを挿入するには、 <input> 要素。 を xpath フィールド参照の属性を XPath 式として指定します。 詳細情報。

この例では、に基づく入力フィールドを示しています nms:recipient スキーマ。

<input xpath="@firstName"/>
<input xpath="@lastName"/>

フォームが特定のスキーマタイプに基づいている場合は、このスキーマのフィールドを検索できます。

1. クリック 挿入 > ドキュメントフィールド.

   

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>

変更： type 属性 <form> 要素の移動先 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>

または、を削除します type="frame" 既存のの属性 <container> 要素。

変更： type 属性 <form> 要素の移動先 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>

または、を削除します type="frame" 既存のの属性 <container> 要素。

ファクトリ入力フォームを次のように変更します。

1. メニューから次を選択します 管理 > 設定 > 入力フォーム.
2. 入力フォームを選択して変更します。

ファクトリデータスキーマは拡張できますが、ファクトリ入力フォームは拡張できません。 ファクトリ入力フォームを再作成せずに、直接変更することをお勧めします。 ソフトウェアのアップグレード中に、工場出荷時の入力フォームに加えた変更は、アップグレードと結合されます。 自動結合が失敗した場合は、競合を解決できます。 詳細情報。

例えば、フィールドを追加してファクトリスキーマを拡張する場合、このフィールドを関連するファクトリフォームに追加できます。

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> 入力された情報が検証されるまで、要素でフォームを保存することはできません。