フォームの編集 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>

<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. メニューから 管理/設定/入力フォーム を選択します。
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> 要素を使用する場合、入力した情報が検証されるまで、ユーザーはフォームを保存できません。