編輯表單 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. 選取輸入表單並加以修改。

您可以擴充工廠資料結構，但無法擴充工廠輸入表單。 建議您直接修改工廠輸入表單，而不重新建立它們。 在軟體升級期間，您在工廠輸入表單中的修改會與升級合併。 如果自動合併失敗，您可以解決衝突。 閱讀全文。

例如，如果您使用其他欄位擴充工廠綱要，則可將此欄位新增到相關的Factory表單。

在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>元素，則使用者無法儲存表單，直到輸入的資訊通過驗證為止。