配置规则
规则可以提供字段值的其他验证,也可以改变字段的行为,例如隐藏字段。 某些规则允许您将字段的值与另一个字段进行比较,而其他规则则将其与规则本身中定义的值进行比较。 但是,您无法使用规则来更改或覆盖字段依赖关系。
规则在 "创建" , "任务" 和 "管理" 视图中可用,但在 "网格视图" 中不可用。 在 "任务视图" 中,无法将规则添加到 "任务视图" 标题中的字段。 规则中使用的控制器字段必须在视图中。
要定义规则,请转至 视图设计器中的 设计 选项卡。 选择字段,然后在字段的属性面板中单击 新建规则 。 选择 规则类型 并添加条件。 字段类型确定可用的规则类型。 一个字段可以具有多个规则类型。
要除去规则,请将鼠标悬停在属性面板上的规则上。 单击 "除去" ,然后单击 完成。
还有 必需, 可编辑和 只读 规则类型。 这些规则类型是在您单击 新建规则时定义的。 使用它们可根据视图中另一个字段 (称为 控制器 字段) 的值来定义字段是必需的,可编辑的还是只读的。
- 如果 必需 显示为切换控件,那么可以将其设置为 True。 在此情况下,将禁用 必需 规则类型。 如果将其设置为 False ,那么可以定义用于确定字段是否为必需的 必需 规则类型。
- 如果 只读 显示为切换控件,那么可以将其设置为 True。 在此情况下,将禁用 可编辑 和 只读 规则类型。 如果将其设置为 False ,那么可以定义 可编辑 或 只读 规则类型,以确定该字段是只读还是可编辑。
| 设计 | JSON | 描述 |
|---|---|---|
可编辑 只读 |
editable readOnly |
根据一个或多个其他字段的值使字段可编辑或只读。 |
可见 隐藏 |
visible hidden |
根据一个或多个其他字段的值使字段可视或隐藏。 |
Required |
required |
根据一个或多个其他字段的值,使字段成为必填字段。 在视图中,将禁用 保存 按钮,直到为该字段提供值为止。 |
大于 大于或等于 小于 小于或等于 等于 |
greater greaterEqual less lessEqual equal |
验证某个字段的值是否大于,小于或等于同一类型的另一个字段的值,或者是否等于规则定义中提供的值。 您可以在整数,十进制,日期或货币字段上定义这些规则。 在视图中,将在该字段旁边显示红星,并且将禁用 保存 按钮,直到验证通过为止。 等于 规则还可以验证两个文本字段是否具有相同的值。 不支持超长字符串字段。 |
最小长度 最大长度 |
minLength maxLength |
验证文本字段的值是否具有最小或最大字符数。 在视图中,将禁用 保存 按钮,直到验证通过为止。 您可以在字符串字段上定义这些规则。 |
| 模式 | pattern | 验证文本字段的值是否具有指定的格式,例如 nnn-nn-nnnn。 在视图中,将禁用 保存 按钮,直到验证通过为止。 您可以在字符串字段上定义此规则。 模式规则中不支持大型长字符串字段。 |
定义可编辑和只读规则
关于本任务
您可以在任何字段类型上定义可编辑和只读规则。
打开字段的属性面板时,字段类型和字段定义会决定是否显示必填属性。
控制器字段必须是枚举字段或角色字段。
在 JSON 标签上,当 "type设置为 "editable或 "readOnly时,将定义可编辑和只读规则。 还必须指定 "controllers或 "controllerName属性。 以数组形式指定一个或多个 "controllers。 使用简写格式 controllerName 而不是 controllers ,只指定一个 controller ,其中 ANY 值将满足规则的标准。
在以下步骤中,在规则类型中选择可编辑或只读。
过程
定义可见规则和隐藏规则
开始之前
关于本任务
可见和隐藏规则可定义在任何字段类型上,也可定义在章节的内联引导上。 如果已在字段上定义了可见字段依赖关系,则无法在任务或创建视图中为该字段定义这些 类型的其他规则。
controllers 必须是枚举字段或行为体字段。
在 JSON 标签中,当 "type设置为 "visible或 "hidden时,将定义可见和隐藏规则。 您必须指定 "controllers或 "controllerName属性。 更多信息,请参阅定义可编辑和只读规则。
在以下步骤中,在规则类型中选择可见或隐藏。
过程
定义必要规则
关于本任务
在对字段或其控制器字段之一进行更改时,都会对该字段进行验证,以确保它有一个值。 如果字段为必填字段,但缺少一个值,则字段上会显示一条信息,并禁用 "保存 "按钮。
该规则可定义在任何字段类型上,但对象类型(JSON 中的objectTypeName)设置为 "SOXDocument的关系字段除外。
如果已在字段上定义了必填字段依赖关系,则无法在任务或创建视图中为该字段定义此类型的其他规则。
控制器必须是枚举字段或角色字段。
在 JSON 标签中,当 "type设置为 "required时,会定义一条必填规则。 您必须指定 "controllers或 "controllerName属性。 更多详情,请参阅定义可编辑和只读规则。
在以下步骤中,在规则类型中选择必填。
过程
定义 "大于"、"大于等于"、"小于"、"小于等于 "和 "等于 "规则
关于本任务
每次对字段进行更改时,都要对其进行验证,以确保它满足条件。 如果该值正在与另一个字段进行比较,则该字段的值发生变化时,该值就会被验证。 如果不满足条件,字段上会显示一条信息,并禁用保存按钮。 该信息解释了如何提供有效值。
这些规则类型可在整数、小数、日期和货币字段上设置。 比较两个字段时,两个字段的类型必须相同。 如果其中一个字段没有值,则不对规则进行评估。
文本字段也可以使用 "等于 "规则,但只能与另一个文本字段进行比较。 不支持超长字符串字段。
在 JSON 选项卡上,当 type 设置为 greater, greaterEqual, less, lessEqual 或 equal 时,将定义比较规则。 还必须指定 "compareTo属性。
过程
定义最小长度和最大长度规则
关于本任务
无论何时对字段进行更改,都会对字段进行验证,以确保文本值的长度有效。 如果不满足条件,字段上会显示一条信息,并禁用保存按钮。 信息中说明了允许输入的字符数。
这些规则只能针对文本字段设置。
您可以提供 "最小长度"或 "最大长度"规则类型。 您可以同时使用这两种方法来定义范围。
在 JSON 标签中,当 "type设置为 "minLength或 "maxLength时,将定义最小和最大规则。 将 "compareTo指定为引号内的字符数。
过程
- 在视图设计器中,单击设计选项卡。 这将显示选用板。
- 选择要向其添加规则的字段。
- 在属性面板中,单击 "新建规则"。
- 在 "规则类型"中,选择 "最小长度"或 "最大长度"。
- 输入字符数。
- 应用严重性(可选)。 有关信息,请参阅控制规则的错误严重性。
- 单击完成。
定义模式规则
关于本任务
该字段的值一经更改,就会进行验证,以确保值的格式正确。 如果格式不正确,字段上会显示一条信息,并禁用保存按钮。
此规则只能针对文本字段设置。 模式规则中不支持大型长字符串字段。
在 JSON 标签中,当 "type设置为 "pattern时,将定义一个模式规则。 指定 "compareTo为有效正则表达式。
过程
- 在视图设计器中,单击设计选项卡。 这将显示选用板。
- 选择要向其添加规则的字段。
- 在属性面板中,单击 "新建规则"。
- 在规则类型中,选择模式。
- 在"模式"中,输入有效的正则表达式,例如 "
^[0-9]{3}-[0-9]{2}-[0-9]{4}$。 - 应用严重性(可选)。 有关信息,请参阅控制规则的错误严重性。
- 单击完成。
控制规则的错误严重性
关于本任务
用户在输入不满足字段验证规则的值时,系统会发出错误并且无法保存该对象。 但是,如果应用了严重性属性,那么会发出警告而不是错误。 发出警告时,仍可保存对象。
可以将严重性属性添加到任何验证规则类型(大于、大于或等于、小于、小于或等于和等于)。 可以将其指定为错误、警告或参考信息。 如果规则没有“严重性”属性,那么会发出错误。
例如,如果日期字段不在接下来的 90 天范围内,那么会发出警告。 如果省略 severity 属性,那么会发出错误。
消息中的文本由系统设置,无法定制。
对于一个字段,可以显示多条警告消息。 但是,只会显示一条错误消息。
条件(例如,字段依赖关系和字段属性)始终会发出错误,而不是发出警告。
参考消息的行为类似于警告,但会显示有参考符号。 无论是警告还是参考信息,错误消息文本都相同。
在 JSON 选项卡上,将 severity 指定为 error、warning 或 info。
过程
- 在视图设计器中,单击设计选项卡。 这将显示选用板。
- 选择要向其添加规则的字段。
- 在属性面板中,单击 "新建规则"。
- 在规则类型中,选择规则类型。
- 在 "严重性"中,选择 "错误"、"警告 "或 "信息"。
- 单击完成。