修改范例动态表单字段配置,创建自定义动态表单字段(DFF)配置。

2025年1月推出

定义要创建的视图、组和字段。视图在配置滑出面板中显示为附加选项卡。您可以将字段聚合为,以逻辑方式组织字段。
开始之前,请初始化DFF配置。
  1. 打开DFF配置文件。
    ...
                "views": [
                    {
                        "key": "View_Example",
                        "order": "10",
                        "displayText": "View Example",
                        "helpText": "",
    ...
  2. 要指定自定义选项卡的名称,请修改displayText键。
  3. 指定选项卡的显示顺序。NI建议使用下列顺序值。
    • 将第一个自定义选项卡分配为顺序"10"
    • 其后的选项卡递增10。例如,"20""30"
    以10为增量可便于重新排列选项卡,或在现有选项卡之间插入新选项卡。
  4. 可选: 修改i18n键,以便为要添加的选项卡提供本地化版本。
    ...
                        "i18n": [
                            {
                                "localeId": "de",
                                "displayText": "View Beispiel",
                                "helpText": ""
                            }
    ...
    1. 指定localeId。使用下列支持值之一。
      • 法语为"fr"
      • 德语为"de"
      • 英语为"en"
      • 日语为"ja"
      • 简体中文为"zh"
    2. 使用本地化文本更新displayText
    默认状态下,SystemLink Enterprise会显示用户在视图键中定义的displayText的值。在满足下列条件时,SystemLink Enterprise会显示displayText的本地化值。
    • i18n键中定义displayText
    • 将浏览器语言设置为支持的本地化语言之一。
  5. 可选: 列出要用于在用户界面上组织字段的组的值。在配置文件中进一步定义这些组。
    ...
                        "groups": [
                            "Group_1_Example",
                            "Group_2_Example"
                        ]
    ...
    1. 指定组包含的字段。
  6. 定义要用于在用户界面上组织字段的组。
    ...
    "groups": [
            {
                "workspace": "f58beba8-66de-4ba5-89f4-3388fd814f2e",
                "key": "Group_1_Example",
                "displayText": "Group 1 Example",
                "helpText": "",
    ...
    1. 列出组包含的字段的值。在配置文件中进一步定义这些字段。
      ...
                  "editable": false,
                  "fields": [
                      "Text_Field_Example",
                      "Checkbox_Field_Example",
                      "Number_Field_Example",
                      "Enum_Field_Example"
                  ]
      ...
  7. 定义要添加的字段。范例配置文件包含每种类型的一个字段。
    • "TEXT"
    • "BOOLEAN"
    • "NUMBER"
    • "ENUM"
    ...
        "fields": [
            {
                "workspace": "f58beba8-66de-4ba5-89f4-3388fd814f2e",
                "key": "Text_Field_Example",
                "type": "TEXT",
                "displayText": "Text Field Example",
                "helpText": "Help Text",
    ...
    1. 可选: 删除不需要添加的字段。
    2. 可选: 复制要添加的字段。为复制的字段创建唯一的值。
    3. 更新显示文本。
    4. 可选: 添加i18n键,以便为要添加的每个字段提供本地化版本。
  8. 为字段添加要求和验证参数。
    ...
                    }
                ],
                "editable": true,
                "mandatory": false,
                "defaultValue": null,
                "validation": {
                    "minValue": 0,
                    "maxValue": 10
                }
    ...
  9. 保存更新的配置文件。
  10. 复制配置文件的内容,并使用DFF API更新初始配置。
    post_nidynamicformfields_v1_update-configurations
  11. 打开SystemLink Enterprise。
  12. 转到配置文件中指定的资源,查看动态表单字段。