配置自定义表单

EnOS 工作管理工单系统支持对服务请求和工单的表单字段进行自定义配置。本文介绍如何对服务请求(以下简称 SR)和工单(以下简称 WO)的表单字段进行自定义配置与按流程节点配置表单字段权限。


表单字段自定义包括两部分:

  • 配置自定义表单字段:自定义配置该组织下的表单字段。该配置默认对所有流程节点生效。

  • 按流程节点配置表单字段权限:根据流程节点配置表单中字段的权限(是否可见、是否必填、是否只读)。

备注

  • 若自定义表单字段无需要按流程节点对表单上要展示的字段进行区分,配置自定义表单即可。

  • 若希望在不同的流程节点展示不同的字段,建议先确保表单以具有全部所需字段,再根据流程节点配置特定字段在不同节点的权限。

前提条件

  • 配置工作管理的前提是当前环境和当前组织已成功部署工作管理服务。

  • 已根据 配置应用 完成应用配置。

配置自定义表单字段

工作管理通过上传模板文件进行表单配置,请下载以下 Excel 配置模板进行填写。

表单配置模板和说明文档.xlsx

备注

若导入报错,可能为模板版本过低,可联系工作管理产品团队获取最新版本。

工作管理支持以下三种方式配置自定义字段:

  • 修改标准字段:对模板中已有字段进行修改。

  • 新增字段:在模板中新增字段。

  • 启用多模板:对于不同工单类型,配置不同字段。


在该章节中会分别介绍这三种配置方式:

修改标准字段

在 Excel 中增加一条配置, 确保 field 字段跟标准字段一致,即可 覆盖 标准字段的默认配置。 建议从 默认配置字段参考 工作簿中复制,按需修改。

例如, 要修改 WO 的标准字段 title 的字段长度,只需从 默认配置字段参考 工作簿中找到该字段的配置,复制到第一个工作簿中,修改 length 的值即可。

新增字段

在 Excel 中增加一条配置字段。建议从 默认配置字段参考 工作簿中复制,按需修改。

备注

需确保新增字段的 field 值在当前组织的单据类型下是唯一的且字段的 display_order 与已有字段不重复。

启用多模板

SR/WO 均支持多模板。模板,即一套字段的组合。多模板,即不同的工单类型其字段不同。

  1. 明确模板关键字:明确一个枚举类型的字段作为模板关键字:

    • SR:默认采用 requestType 作为关键词

    • WO:默认采用 woType 作为关键词

  2. 指定每个模板的特有字段:配置所有模板共用的字段及每个模板特有的字段。

    备注

    每个模板中的字段 = 标准字段 + 对所有模板生效的字段 + 特定模板特有的字段

示例

场景:工单有多种类型,不同的任务类型,字段不同。

配置:配置 template_key = workType,即将 workType 作为模板关键字。

  • 橙色部分的 template_value 字段为空,表明这些字段配置对所有模板都生效

  • 绿色部分的 template_value = 1, 表明这些字段只对 workType = 1 这个模板生效

  • 灰色部分的 template_value = 2, 表明这些字段只对 workType = 2 这个模板生效


../_images/worktype.png


效果

当 workType 对应字段为 任务专业


../_images/worktype_task.png


选择风机(value = 1) 和 技能培训(value = 4), 界面不同。


../_images/value_1.png


../_images/value_4.png


若一个字段只对部分模板生效,需指定模板号(即 template_value)。一个字段同时适用于多个模板,就应有多行配置(template_value 等于不同的值)。

  • 假设有 3 个模板,字段 customFieldA 只在模板 1 和 2 中生效,则应有两行字段 customFieldA,两行 template_value 的值分别为 1 和 2。如下:

org_id

issue_type

field

template_key

template_value

o16312589165551453

WO

customFieldA

workType

1

o16312589165551453

WO

customFieldA

workType

2


  • 假设有 3 个模板,字段 customFieldA 在 3 个模板中均生效,则 template_value 留空即可。如下:

org_id

issue_type

field

template_key

template_value

o16312589165551453

WO

customFieldA

workType


  • 对于同一个字段,不允许同时将其配置为对所有模板生效和某个模板特有。即一行 template_value 留空,同时该字段存在其他行 template_value 有值。如下:

org_id

issue_type

field

template_key

template_value

o16312589165551453

WO

customFieldA

workType

o16312589165551453

WO

customFieldA

workType

1

备注

若不启用多模板,template_key 和 template_value 全部留空即可。

上传模板文件

  1. 登录 EnOS 应用门户,选择 工作管理

  2. 选择 设置 > 自定义字段 菜单,进入自定义字段配置页面。

  3. 选择 默认表单字段配置,进入配置默认表单页面。

  4. 拖拽或选择上传填写后的模板文件,导入成功后即刻生效。


    ../_images/field_import_teamplate.png

按流程节点配置表单字段权限

工作管理支持按工作流任务节点设置字段权限,目前支持展示、必输和只读属性。

  1. 登录 EnOS 应用门户,选择 工作管理

  2. 选择 设置 > 自定义字段 菜单,进入自定义字段配置页面。

  3. 选择 字段权限配置,进入字段权限配置页面。

  4. 选择 下载配置文件,下载当前配置文件。文件第 1 个工作簿中,显示当前所使用的工作流(包括默认工作流与自定义工作流)、工作流中的任务节点以及对应字段的权限。第 2 个工作簿中,显示当前用户的所有字段。

    备注

    若模板没有配置特定工作流,则默认使用同对象类型的默认工作流。例如,模板 A 的对象类型为 WO 且没有配置特定工作流,则该模板使用的工作流为:WMT-Default-WO。

    • 增加字段权限:从配置文件的第 2 个工作簿中选取需要配置权限的字段,复制到第 1 个工作簿中,修改对应的属性。例如,对于工单,希望修改 WMT-Default-WO 流程的 complete 任务节点中的字段的权限,则从第 2 个工作簿中复制需要权限的字段至第 1 个工作簿的该流程该节点后。如需配置多个字段,则添加多行。


      ../_images/field_permission.png


    • 删除字段权限:若要删除某个任务节点的字段权限,将字段最后 3 列清空。


      ../_images/field_permission_delete.png


  5. 拖拽或选择上传修改后的配置文件,导入成功后即刻生效。


    ../_images/filed_permission_upload.png

备注

  • 对于多模板的字段,若多模板没有指定工作流(即使用默认工作流),则支持配置标准字段与多模板均使用的公共自定义字段(即 template_value 为空的字段)。

  • 在上述情况下,若仍需对模板中的非公共自定义字段进行权限配置,在第 1 个工作簿中添加一行,指定该模板使用的工作流为默认工作流即可。

参考信息

以下为配置表单字段的参考信息。

字段配置说明


配置项

配置项含义

是否必填

适用范围

填写格式

org_id

组织 ID

无需填写,导入时将自动获取登陆用户的组织 ID

issue_type

需要自定义的字段对应的单据类型

通用

  • SR

  • WO

field

字段标识(确保唯一性:OU + 单据类型 + 字段标识)

通用

字符串

section

字段所属分组

通用

支持自定义的 Section 见 参考信息 - Section 说明

label

字段的展示名称

通用

{“i18nValue”: {“en_US”: “English Name”, “es_ES”: “西班牙语描述”, “ja_JP”: “日文描述”, “zh_CN”: “中文名称”},”defaultValue”: “默认显示”}

widget_type

控件类型(支持自定义)

通用

具体控件类型见 参考信息 - Widget Type 说明,选择所需的控件类型填写第一列。

display_type

是否展示

通用

  • -1:隐藏

  • 1:显示

display_order

字段在分组内的展示顺序,数字越小越靠前。例如,
  • 自定义字段在标准字段之后,display_order 取值范围为(480,1000)

  • 自定义字段插入到标准字段 1 和标准字段 2 之间,那么 display_order 取值范围为 (标准字段 1 的 display_order,标准字段 2 的 display_order)

通用

系统是按分组内所有字段的 display order 的相对大小来确定展示顺序。参考 参考信息 - 标准字段顺序 确定数字即可。注意:展示顺序不可重复,否则会有字段无法展示

is_required

是否必填

通用

  • 1:必填

  • 0:非必填

enable

是否启用

通用

  • 1:启用

  • 0:不启用

readonly

是否只读

通用

  • 0:可编辑

  • 1:只读

width

字段的宽度

通用

  • 1:1/2 宽度 (二个字段占一行)

  • 2:整个宽度 (一个字段占一行)

update_user

更新人

通用

无需填写,导入时将自动更新为登陆用户的用户名

dependency

依赖字段

  • 场站设备之间依赖

  • 场站人员之间依赖

  • 类型子类型之间依赖

目前仅支持这三种场景,用户如果需要修改请先与工作管理产品团队确认

checked

该配置项未启用,请勿填写

/

/

default_value

默认值

网页端新建页面,默认展示的字段值

注意:如默认值为数字,则需要转为字符串。在数字前加上单引号,例如 ‘600

length

字段长度限制。

适用于输入框类的 Widget,比如 Single-Line, Multi-Line

请填充字段长度限制

regex

正则表达式, 用于自定义校验规则

适用于输入框类的 Widget,比如 Single-Line, Multi-Line

请填充需要的正则表达式

tag_import

是否支持导入。支持的字段会包含在该类型单据的导入模板中

工单导入字段配置

  • Y:支持导入

  • N:不支持导入

tag_export

是否支持导出。支持的字段会包含在该类型单据的导出文件中

工单导出字段配置

  • Y:支持导入

  • N:不支持导入

remark

字段备注

字段在导入文件模板中的提示文案,展示在导入模板文件(Excel 文件)中

占位符(支持国际化) {“i18nValue”: {“en_US”: “English Name”, “es_ES”: “西班牙语描述”, “ja_JP”: “日文描述”, “zh_CN”: “中文名称”}, “defaultValue”: “默认显示” }

data_type

字段备注

工单,通过文件导入时字段类型校验

基本数据类型:Integer,String 等

placeholder

占位符

网页端输入框中的提示文案

{“i18nValue”: {“en_US”: “English Name”, “es_ES”: “西班牙语描述”, “ja_JP”: “日文描述”, “zh_CN”: “中文名称”}, “defaultValue”: “默认显示”}

customized_definition

占位符

支持配置 enum,treeData 和多行文本默认显示行数

自定义参数:
  • 格式:List<CustomerPara>,CustomerPara: { “key”:{ “i18nValue”: { “en_US”: “English Name”, “es_ES”: “西班牙语描述”, “ja_JP”: “日文描述”,”zh_CN”: “中文名称” },”defaultValue”: “默认显示”},”value”:”” }

  • 样例 1:widgetType 为 Picklist,配置枚举项:{“showSearch”:true,”enum”:[{“value”:1,”key”:{“i18nValue”:{“en_US”:”High”,”es_ES”:””,”ja_JP”:””,”zh_CN”:”高”},”defaultValue”:”High”}},{“value”:2,”key”:{“i18nValue”:{“en_US”:”None”,”es_ES”:””,”ja_JP”:””,”zh_CN”:”未指定”},”defaultValue”:”None”}}]}

  • 样例 2:widgetType 为 TreeSelect 时,配置树型结构数据:{“showSearch”:”true”,”treeData”:[{“value”:”1”,”key”:{“defaultValue”:”风机”,”i18nValue”:{“en_US”:””,”zh_CN”:”风机”,”es_ES”:””,”ja_JP”:””}},”children”:[{“value”:”11”,”key”:{“defaultValue”:”缺陷”,”i18nValue”:{“en_US”:””,”zh_CN”:”缺陷”,”es_ES”:””,”ja_JP”:””}}},{“value”:”12”,”key”:{“defaultValue”:”巡检”,”i18nValue”:{“en_US”:””,”zh_CN”:”巡检”,”es_ES”:””,”ja_JP”:””}}}]}]}

  • 样例 3:widgetType 为 MultiLine 时,控制前端现实默认行数:{“rows”:2}

template_key

字段对应的模板的 Key

只适用于需要启用多模板的场景

填入模板关键字 field
  • 服务请求:requestType

  • 工单:workType

template_value

字段对应的模板的 Value

只适用于需要启用多模板的场景

关键字枚举值的 value,确保 value 为字符串

customized_filter

枚举值自定义字段

枚举关键字为:enum,treedata

如果字段支持筛选,则填充标记数字 1。参考 参考信息 - 筛选项字段配置示例


Section 说明

工作管理提供了多种 Section(即字段所属分组)。大多数 Section 均支持字段自定义,你可以自定义配置字段显示在哪个 Section 中。Section 是否支持自定义,如下表所示:


单据类型

Section

展示名称(中文)

是否支持自定义

WO

BasicInformation

基本信息

支持

WO

Scheduling

计划

支持

WO

DescriptionInformation

描述信息

支持

WO

Files

文件

不支持

WO

RelatedRecords

关联记录

不支持

WO

Completion

工作总结

支持

WO

ChangeLog

执行记录

不支持

WO

CustomFields

自定义字段

支持

SR

BasicInformation

基本信息

支持

SR

DescriptionInformation

描述信息

支持

SR

SourceInformation

来源信息

支持

SR

RelatedRecords

关联记录

不支持

SR

ChangeLog

执行记录

不支持

SR

Files

文件

不支持

SR

CustomFields

自定义字段

支持

备注

若 Section 不支持自定义配置字段,即使模板中配置了自定义字段也会被过滤。


Widget Type 说明

工作管理提供多种控件类型以支持字段的展现形式,例如输入框、单选、多选等等。不同控件类型具有特有的配置项。

支持的 Widget Type

支持的控件类型如下表所示:


Widget Type

说明

样例

SingleLine

单行文本输入框

../_images/single_line.png

MultiLine

多行文本输入框

../_images/multiple_line.png

SiteSelect

场站单选

../_images/site_select.png

DeviceSelect

设备多选,支持

../_images/device_select.png

Picklist

单选列表

../_images/picklist.png

Radio

单选

../_images/radio.png

DateTime

日期/时间

../_images/datetime.png

Numerber

数字输入框

../_images/number.png

MultiSelect

多选列表

../_images/Multiselect.png

Checkbox

多选

../_images/checkbox.png

DateRange

时间范围

../_images/timerange.png

TreeMultiSelect

树多选

../_images/treemultiselect.png

TreeSelect

树单选

../_images/treeselect.png

SingleStaffSelect

用户单选

../_images/singlestaffselect.png

FollowersSelect

用户多选

../_images/followerselect.png

DeviceMultipleTreeSelect

设备树多选,支持选择中间节点

../_images/device_multi_tree_select.png


Widget Type 配置项

Widget Type 的特有配置项以及配置示例如下表所示:


Widget Type

特有配置项

配置项 1

配置项 2

配置项 3

配置项 4

SingleLine

length,最大长度。示例:length = 200

regex,正则表达式。示例:regex = ^[0-9]*(|.[0-9]{1,2})$

/

/

MultiLine

length,最大长度。示例:length = 200

customized_definition,输入框默认展示行数。示例:customized_definition = {“rows”:2}

/

/

DeviceSelect

dependency,依赖项。示例:dependency = siteId

/

/

/

Picklist

customized_definition,Picklist 的枚举项。示例:customized_definition={“showSearch”:true,”enum”:[{“value”:1,”key”:{“i18nValue”:{“en_US”:”High”,”es_ES”:””,”ja_JP”:””,”zh_CN”:”高”},”defaultValue”:”High”}},{“value”:2,”key”:{“i18nValue”:{“en_US”:”None”,”es_ES”:””,”ja_JP”:””,”zh_CN”:”未指定”},”defaultValue”:”None”}}]}

/

/

/

Radio

customized_definition,Radio 的枚举项。示例同 Picklist

/

/

/

DateTime

regex,正则表达式。示例:regex = ^(19|20|21)d{2}-((0[1-9])|(1[0-2]))-((0[1-9])|(1d)|(2d)|3[01])(sd{2}:d{2}(:d{2}|)|)$

/

/

/

Numerber

customized_definition,数字格式配置。示例:customized_definition = {“max”: 10,”min”: 1,”precision”: 3}

/

/

/

MultiSelect

customized_definition,MultiSelect 的枚举项。示例同 Picklist

/

/

/

Checkbox

customized_definition,Checkbox的枚举项。示例:customized_definition = {“enum”:[{“value”:”1”,”key”:{“i18nValue”:{“en_US”:””,”es_ES”:””,”ja_JP”:””,”zh_CN”:””},”defaultValue”:”是”}}]}

/

/

/

TreeMultiSelect

customized_definition,TreeMultiSelect 的枚举项。示例:customized_definition = {“showSearch”:”true”,”treeData”:[{“value”:”1”,”key”:{“defaultValue”:”风机”,”i18nValue”:{“en_US”:””,”zh_CN”:”风机”,”es_ES”:””,”ja_JP”:””}},”children”:[{“value”:”11”,”key”:{“defaultValue”:”缺陷”,”i18nValue”:{“en_US”:””,”zh_CN”:”缺陷”,”es_ES”:””,”ja_JP”:””}}},{“value”:”12”,”key”:{“defaultValue”:”巡检”,”i18nValue”:{“en_US”:””,”zh_CN”:”巡检”,”es_ES”:””,”ja_JP”:””}}}]}]}

/

/

/

TreeSelect

customized_definition,TreeSelect 的枚举项。示例同 TreeMultiSelect

/

/

/

SingleStaffSelect

dependency,SingleStaffSelect 的依赖项。示例:dependency = siteId

/

/

/

FollowersSelect

dependency,FollowersSelect 的依赖项。示例:dependency = siteId

/

/

/

DeviceMultipleTreeSelect

dependency,DeviceMultipleTreeSelect 的依赖项。示例:dependency = siteId

/

/

/


标准字段特殊说明

标准字段的自定义配置说明如下表所示:


字段

说明

Site

场站字段,不可修改

Devices

设备字段,支持修改 Widget Type


标准字段顺序

标准字段顺序如下表所示:


Section

单据类型

字段中文

字段英文

display_order

BasicInformation

SR

标题

Subject

10

BasicInformation

SR

编号

ID

20

BasicInformation

SR

状态

Status

30

BasicInformation

SR

场站

Site

40

BasicInformation

SR

场站

Site

50

BasicInformation

SR

优先级

Priority

60

BasicInformation

SR

处理人

Assignee

70

BasicInformation

SR

处理人

Assignee

80

BasicInformation

SR

设备

Devices

90

BasicInformation

SR

设备

Devices

100

BasicInformation

SR

更新时间

Updated On

110

BasicInformation

SR

更新人

Updated By

120

BasicInformation

SR

截止日期

Due Date

130

BasicInformation

SR

创建时间

Created On

140

BasicInformation

SR

创建人

Created By

150

BasicInformation

SR

来源类型

Source Type

160

BasicInformation

SR

预计工时

Estimate Effort

171

BasicInformation

SR

请求类型

Request Type

172

DescriptionInformation

SR

描述

Description

180

DescriptionInformation

SR

标签

Tag

190

SourceInformation

SR

来源ID

Source ID

200

SourceInformation

SR

故障代码

Fault Code

210

SourceInformation

SR

严重等级

Severity Level

220

SourceInformation

SR

开始时间

Start Time

230

SourceInformation

SR

结束时间

End Time

240

SourceInformation

SR

持续时间

Duration

250

SourceInformation

SR

来源子类型

Source Sub Type

251

SourceInformation

SR

可能原因

Possible Reason

260

SourceInformation

SR

检修建议

Recommended Action

270

Completion

SR

实际原因

Actual Cause

280

Completion

SR

解决方式与备注

Resolution Notes

290

ChangeLog

SR

变更时间

Created On

300

ChangeLog

SR

变更人

Changed By

310

ChangeLog

SR

字段

Field

320

ChangeLog

SR

原始值

Original Value

330

ChangeLog

SR

更新值

New Value

340

ChangeLog

SR

备注

Notes

350

Files

SR

文件名

Name

360

Files

SR

文件类型

Type

370

Files

SR

文件大小

Size

380

Files

SR

上传人

Uploaded By

390

Files

SR

上传时间

Uploaded On

400

RelatedRecords

SR

编号

ID

410

RelatedRecords

SR

类型

Type

420

RelatedRecords

SR

标题

Subject

430

RelatedRecords

SR

状态

Status

450

RelatedRecords

SR

关系

Relationship

440

RelatedRecords

SR

更新人

Updated By

460

RelatedRecords

SR

更新时间

Updated On

470

RelatedRecords

SR

关联记录

Linked Records

480

BasicInformation

SR

处理组

Team

490

BasicInformation

SR

处理组名称

Team Name

500

BasicInformation

WO

编号

ID

10

BasicInformation

WO

标题

Subject

20

BasicInformation

WO

状态

Status

30

BasicInformation

WO

场站

Site

40

BasicInformation

WO

场站

Site

50

BasicInformation

WO

设备

Devices

60

BasicInformation

WO

设备

Devices

70

BasicInformation

WO

设备类型

Device Type

80

BasicInformation

WO

位置

Location

90

BasicInformation

WO

工单类型

Work Order Type

100

BasicInformation

WO

优先级

Priority

110

BasicInformation

WO

来源类型

Source Type

120

BasicInformation

WO

运维计划

Maintenance Plan

130

BasicInformation

WO

父工单

Parent WO

140

BasicInformation

WO

创建人

Created By

150

BasicInformation

WO

创建时间

Created On

160

BasicInformation

WO

更新人

Updated By

170

BasicInformation

WO

更新时间

Updated On

180

BasicInformation

WO

预计工时

Estimate Effort

181

BasicInformation

WO

截止日期

Due Date

182

DescriptionInformation

WO

描述

Description

190

DescriptionInformation

WO

标签

Tag

200

Scheduling

WO

处理人

Assignee

210

Scheduling

WO

处理人

Assignee

220

Scheduling

WO

关注人

Followers

230

Scheduling

WO

计划开始日期

Planned Start

240

Scheduling

WO

计划结束日期

Planned End

250

Completion

WO

实际开始日期

Actual Start

260

Completion

WO

实际结束日期

Actual End

270

Completion

WO

实际原因

Actual Cause

280

Completion

WO

解决方式与备注

Resolution Notes

290

RelatedRecords

WO

编号

ID

300

RelatedRecords

WO

类型

Type

310

RelatedRecords

WO

标题

Subject

320

RelatedRecords

WO

状态

Status

340

RelatedRecords

WO

关系

Relationship

330

RelatedRecords

WO

更新人

Updated By

350

RelatedRecords

WO

更新时间

Updated On

360

RelatedRecords

WO

关联记录

Linked Records

370

ChangeLog

WO

变更时间

Created On

380

ChangeLog

WO

变更人

Changed By

390

ChangeLog

WO

字段

Field

400

ChangeLog

WO

原始值

Original Value

410

ChangeLog

WO

更新值

New Value

420

ChangeLog

WO

备注

Notes

430

Files

WO

文件名

Name

440

Files

WO

文件类型

Type

450

Files

WO

文件大小

Size

460

Files

WO

上传者

Uploaded By

470

Files

WO

上传时间

Uploaded On

480

CustomFields

WO

文件ID列表

fileId list

490

CustomFields

WO

自定义表单字段

customizedParam

500

Scheduling

WO

处理组

Team

500

Scheduling

WO

处理组名称

Team Name

510

SourceInformation

WO

来源ID

Source ID

520

SourceInformation

WO

故障代码

Fault Code

530

SourceInformation

WO

严重等级

Severity Level

540

SourceInformation

WO

开始时间

Start Time

550

SourceInformation

WO

结束时间

End Time

560

SourceInformation

WO

来源子类型

Source Sub Category

570

SourceInformation

WO

可能原因

Possible Reason

580

SourceInformation

WO

检修建议

Recommended Action

590

依赖字段配置示例

利用 dependency 字段,可以让两个字段联动。

例如,希望让工单类型(issue_type = WO,field = workType)和工单子类型(该字段需自定义添加)两个字段联动。

两个字段的值分别为:

  • 工单类型:风机、电气

  • 工单子类型:缺陷、故障、停机、维护

当工单类型选择风机时,工单子类型可选缺陷故障,当风机类型选择电气时,工单子类型可以选择停机维护


可以按如下方式配置:

配置工单类型

第一步,配置 workType 字段。

  1. 拷贝 默认字段配置参考工作簿 中工单类型(issue_type = WO,field = workType)的默认配置到 表单配置模板 中。

  2. 编辑 customized_definition 属性,仅修改 enum 中的枚举值即可:value 字段为整型,key 字段为国际化文案。示例如下:

    {
       "showSearch": true,
       "enum": [{
           "value": 1,
           "key": {"i18nValue": {
                   "en_US": "",
                   "es_ES": "",
                   "ja_JP": "",
                   "zh_CN": "风机"
               },
               "defaultValue": "风机
           }
       }, {
           "value": 2,
           "key": {
               "i18nValue": {
                   "en_US": "",
                   "es_ES": "",
                   "ja_JP": "",
                   "zh_CN": "电气"
               },
               "defaultValue": "电气"
           }
       }]
    }
    

配置工单子类型

第二步,配置工单子类型字段。

  1. 在第一个工作簿中新增工单子类型字段(例如 field =subType),参照 新增字段

  2. subType 字段的 dependency 属性改为 workType

  3. subType 字段的 widget_type 属性改为 TreeSelect

  4. 编辑 subTypecustomized_definition 属性,按以下格式填写工单子类型的枚举值:

    仅修改 treeData 的枚举值即可,treeData 第一层和第一步中的 workType 的工单类型保持一致,children 层配置工单子类型的枚举值。

    格式如下:

    {
       "showSearch": "true",
       "treeData": [{
               "value": "1",  //保证跟工单类型中定义的父级选项的value一致,且格式为字符串。
               "key": {
                   "defaultValue": "风机",
                   "i18nValue": {
                       "en_US": "",
                       "zh_CN": "风机",
                       "es_ES": "",
                       "ja_JP": ""
                   }
               },
               "children": [{
                   "value": "11",
                   "key": {
                       "defaultValue": "缺陷",
                       "i18nValue": {
                           "en_US": "",
                           "zh_CN": "缺陷",
                           "es_ES": "",
                           "ja_JP": ""
                       }
                   }
               }, {
                   "value": "12",
                   "key": {
                       "defaultValue": "故障",
                       "i18nValue": {
                           "en_US": "",
                           "zh_CN": "故障",
                           "es_ES": "",
                           "ja_JP": ""
                       }
                   }
               }]
           }, {
               "value": "2", //保证跟工单类型中定义的父级选项的value一致,且格式为字符串。
               "key": {
                   "defaultValue": "电气",
                   "i18nValue": {
                       "en_US": "",
                       "zh_CN": "电气",
                       "es_ES": "",
                       "ja_JP": ""
                   }
               },
               "children": [{
                   "value": "21",
                   "key": {
                       "defaultValue": "停机",
                       "i18nValue": {
                           "en_US": "",
                           "zh_CN": "停机",
                           "es_ES": "",
                           "ja_JP": ""
                       }
                   }
               }, {
                   "value": "22",
                   "key": {
                       "defaultValue": "维护",
                       "i18nValue": {
                           "en_US": "",
                           "zh_CN": "维护",
                           "es_ES": "",
                           "ja_JP": ""
                       }
                   }
               }]
           }
       }]
    }
    

筛选项字段配置示例

你可以配置 SR 与 WO 列表上的筛选项,可以将自定义字段配置成筛选项或者隐藏无需要的预置筛选项。


../_images/custom_filter.png


  • 添加自定义字段为筛选项:将该字段的 customized_filter 属性设置为 1 即可。

    备注

    需该字段类型是类型为枚举类型,枚举关键字为:enum 或者 treedata。

  • 隐藏无需要的预置筛选项:从 默认配置字段参考 工作簿中找到该字段的配置,复制至第一个工作簿中,把 customized_filter 的值设置为 0 即可,参考 修改标准字段

    备注

    该功能仅在 20220930 及更新版本中支持。