编辑表单 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. 选择输入表单并修改它。

您可以扩展工厂数据架构，但不能扩展工厂输入表单。 我们建议您直接修改出厂输入表单，而无需重新创建它们。 在软件升级期间，工厂输入表单中的修改将与升级合并。 如果自动合并失败，您可以解决冲突。 了解更多信息。

例如，如果使用附加字段扩展工厂模式，则可以将此字段添加到相关的工厂表单。

在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>元素，则在验证输入的信息之前，用户无法保存表单。