編輯表單 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>

變更 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. 從功能表中，選擇 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. 此函式用於檢查 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> 元素，則在驗證輸入的資訊之前，使用者無法儲存表單。