字段详细解析

最近更新时间: 2023-02-16 09:51:32

目前系统支持的字段类型为:单行文本、多行文本、下拉菜单、单选、多选、整数、小数、日期时间、时间段、人员、部门、级联、表格、动态表格、富文本、密码、配置项、资源图、附件、数组、链接、执行目标、权限自服务、josn、用户组、脚本、工单列表 。
所有的字段都有字段名称、字段分组、属性编码、跨域使用、字段说明五个公共属性。
字段名称:字段在表单中的名称(可重复)。
字段分组:字段所属的组别。
属性编码:字段的唯一标识。
隐私:控制字段是否仅工单经办人可以查看。
跨域使用:控制字段是否可以分享给其他业务单位。

  • 单行文本
    单行文本可以额外设置默认值、校验规则、文本最小长度、文本最大长度。单行文本在表单中以input的方式展现,当单行文本只读时,单行文本可以识别内容中的链接,将其替换为可以点击的链接。

    默认值:字段在创建工单时默认显示的值。
    校验规则:可以选择无校验、IP地址、手机,正则表达式。用以检验字段中输入的值是否符合规则。
    文本最小、最大长度:单行文本输入字数的限制。
  • 多行文本
    多行文本可以额外设置默认值属性,在表单中以文本字段的形式展现,可以任意数据数据。 默认值:字段在表单中默认显示的值。
  • 下拉菜单
    下拉菜单可以额外设置选择类型、自定义选项、外部数据。在表单中以下拉的形式展示。
    选择类型:控制下拉字段的单选与多选。

1.自定义选项
可以自定义下拉字段的下拉列表,勾选以后为改下拉字段的默认值。

2.外部数据
外部数据源则是通过调用外部接口的形式获取数据使用,选择外部数据源通过填写url,获取url返回的值,通过选项的值(value)和选项的文字(label)与返回值的key对应起来作为下拉菜单的值。(注:key值作为存放在数据库的键值,不会在界面上显示),扩展列可以保存对应外部数据除了选项的值和选项的文字之外的值可以用表格的联动策略。

设置好保存的key和界面显示的value之后,点击同步,可以同步url返回的value值。
3.字典数据
可以选择【设置-字典管理】字典类型为:单层级数据的字段数据

该字段在表单中显示如图。

  • 单选
    单选字段可以额外设置使用类型、值范围。
    使用类型:支持配置默认样式和选项卡样式。
    值范围:设置选项,选项通过点击添加选项进行新增。在选项前的勾选框打钩,能够设置默认勾选项,仅能勾选一个。
    设置选项颜色:勾选【设置选项颜色】,填写选项值后,可以选择颜色。
  • 多选
    多选字段可以额外设置值范围。
    值范围:选项通过点击添加选项进行新增。在选项前的勾选框打钩,能够设置默认勾选项,可勾选多个。
  • 整数
    整数字段可以额外设置默认值、单位、最小值、最大值。整数字段在表单中只能输入整数。 默认值:表单中会默认加载默认数据。
    单位:字段值后显示的信息(文本)。
    最大值最小值:限制输入的值的大小范围。
  • 小数
    小数字段可以额外设置默认值、单位、最小值最大值。小数字段在表单中只能输入数字,可以为整数和小数。
    默认值:表单中会默认加载默认数据。
    单位:字段值后显示的数量单位。
    最大值最小值:限制输入的值的大小范围。
  • 日期时间
    日期时间字段可以额外设置默认值、时间粒度、时间范围。
    默认值:字段在表单中默认显示的值,默认值可以选择无或当前系统时间(用户创建工单时的时间)。
    时间粒度:月表示当月、日期表示当前、日期+时间表示当前+当前时间。
    时间范围:全部表示可以选择任意的时间,未来时间只能选择未来的时间,过去时间只能选择过去的时间。
  • 时间段
    时间段字段可以额外设置时间格式、默认值。
    时间格式:支持选择时/分或天/时/分
    默认值:根据选择的时间格式,可选择默认时间段,时、分下拉选择,天为只能输入数字的输入框。
  • 人员
    人员字段可以额外设置选择类型、默认值、人员范围。
    选择类型:控制该人员字段的单选与多选属性。
    默认值:可以默认当前登录的用户或者指定的用户。
    人员范围:限定该人员字段可以选择的范围。
  • 部门
    部门字段可以额外设置选择类型、默认值。
    选择类型:控制部门字段的单选与多选属性。
    默认值:可以默认当前用户用户所在部分或者指定的部门。
  • 级联
    级联字段可以额外设置选择类型,级联的数据源支持自定义,外部数据,字典数据三种方式。 选择类型:单选则只能选择一个级联数据,多选可以选择多个进行展现。
    自定义选项:通过点击添加选项进行新增,二级选项通过点击一级选项后的加号图标添加,点击删除图标删除该选项以及该选项之下的所有选项。级联选项最大支持六级。
    字典数据:支持选择数据源-变更目录。
    外部数据:通过接口获取的数据来源(同下拉菜单外部数据)。
  • 表格
    导入/导出:开启后,可在工单详情导入、导出excel表格。
    是否分页:开启后,表格列表支持分页。

    表格字段可以额外设置表格属性,点击定义列之后出现弹框,可以定义表格字段的列属性。
    定义列
    列名称:显示表格对应列的名称。
    列编码:表格列的唯一表述。
    列类型:类型包含了普通,单选,多选,下拉,链接,附件,日期时间,小数,整数类型。
    普通:为普通的文本形式。
    单选:选择单选,在默认值/数据源中则出现当前字段管理中的所有的单选字段可供选择;
    多选:选择多选,在默认值/数据源中则出现当前字段管理中的所有的多选字段可供选择。
    下拉:选择下拉,在默认值/数据源中则出现当前字段管理中的所有的下拉字段可供选择。
    链接:选择链接,在默认值/数据源中则出现当前字段管理中的所有的链接字段可供选择。
    附件:选择附件,在默认值/数据源中则出现当前字段管理中的所有的附件字段可供选择。
    日期时间:选择时间日期,在默认值/数据源中则出现当前字段管理中的所有的时间日期字段 可供选择。
    小数:选择小数,在默认值/数据源中则出现当前字段管理中的所有的小数字段可供选择。
    整数:选择整数,在默认值/数据源中则出现当前字段管理中的所有的整数字段可供选择。
    默认值/数据源:列类型为普通时为当前列的默认值,否则为当前列的数据源。
    列说明:当前列的详细介绍。
    使用说明:勾选以后在列名称后显示一个图标,hover上去出现tip展示列说明。
    必填:控制当前列的字段全部都为必填。
    只读:控制当前列的字段全部都为只读。
    删除:可以对已经添加的列进行删除操作,(仅剩一列时不可删除)。
    定义列完成之后会在下方出现对应的表格,这时可以预定义表格的行,同时可以切换表格模式和表单模式。


    定义列完成之后可以对当前的表格添加动态策略,目前支持常量关联,API关联,隐藏关联三种策略。
  1. 常量关联
    外部数据的下拉字段选中以后,可以将当前选中项的扩展值填充到当前行得某一列。
    监听列:含有外部数据源的下拉字段
    关联列:下拉外部数据源里得扩展列 -> 表格中其他列
  2. API关联
    外部数据的下拉字段选中以后,可以将当前选中项的扩展值作为当前行其他外部数据下拉字段得请求参数。
    监听列:含有外部数据源的下拉字段
      关联列:表格中得其他列  
         条件: 请求参数key         请求参数value  
  3. 隐藏关联
    当监听列得扩展值满足条件得时将关联列隐藏。
    监听列:含有外部数据得下拉字段的列
    关联列:表格中其他的列
    条件: 监听列的扩展值 -> 条件 -> 值
  • 动态表格
    动态表格字段可以额外设置脚本属性。
    表格脚本为json格式,输入脚本后支持预览脚本运行结果。
    表格脚本本质为一个JSON数据, 该JOSN由columns,dataSource,cellProps,onChange,selectedRowKeys四部分构成。
    columns array 必填 表格header的基本信息
    dataSource array 必填 表格body数据
    onChange function 必填 表格里的值修改时触发的回调函数
    selectedRowKeys array 必填 表格当前选中的行 不传默认为不需要开启勾选的列
    cellProps array 选填 表格body属性
  • 富文本
    在表单中以富文本的形式展现。

  • 密码
    密码字段可以额外设置文本最小长度,文本最大长度;在表单中输入内容后为加密显示。 文本最大最小长度:现在密码字段得字数。

  • 配置项
    配置项字段可以额外设置资源范围、使用类型、资源类型、使用场景、属性过滤。

  • 附件
    添加字段,输入字段的名称、字段分组、属性编码、附件模板、字段说明。支持添加附件作为附件模板,附件模板可通过apollo:upload.file.white.list配置可支持的附件格式,能够支持每个使用该字段的表单下载对应的附件。单个附件大小不能超过20M。

  • 数组
    数组字段可以额外设置校验规则,默认值。数组字段默认值可以选中多个,以tag模式区分。

  • 链接
    链接字段可以额外设置链接名称,链接地址属性,在表单中展示链接得名称,点击名称可跳转。

  • 执行目标
    对接自动化新增字段执行目标。
    执行方式:节点选择、分组执行、监管代理,执行方式需要和编排或者操作一致

  • 权限自服务
    对接权限新增权限自服务字段。该字段可以额外设置自服务范围。
    自服务范围:个人权限申请、权限管理申请

  • JSON字段
    JSON为一个多行文本框,可以校验写的JSON是否符合JSON格式

  • 用户组
    可以额外设置选择类型、默认值。
    选择类型:控制用户组字段的单选与多选属性。
    默认值:可以默认当前用户用户所在用户组或者指定的用户组。

  • 脚本
    脚本字段属于一种非常规字段,是配合Automation产品做的一个字段类型,这个字段可以选择automation里标记为脚本的操作数据。用于通过工单驱动自动化任务执行的时候,将脚本作为参数动态传递给自动化编排。

  • 工单列表

    该字段可以关联已有工单