フォームの編集 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>要素を使用する場合、入力された情報が検証されるまで、ユーザーはフォームを保存できません。