添加用户活动

用户活动包括一个或多个基于聊天的互动,以收集输入并在代理工作流程中显示结果。 它支持中流交互,允许用户直接在聊天界面查看和回复信息。 例如,批准请求、从列表中选择、回答后续问题或报告问题。

在代理工作流程中添加用户活动:

  1. 在工作流构建器中,点击“添加流程项 新增”。

  2. “流程”节点中,点击并拖动 “用户活动 ”到连接线上。

有关如何添加用户活动的示例视频,请参阅 “视频 ”部分中的《在 watsonx Orchestrate 中使用用户活动构建主动工作流》。

添加互动

您可以通过交互功能在聊天中或表单内向用户收集信息或向用户展示信息。 交互可以出现在多轮用户活动中或表单内部。 您选择的交互类型决定了向用户显示的UI控件。

可用的交互类型

下表汇总了所有交互类型、它们支持的操作体验以及向用户显示的用户界面控件。

交互类型

描述

可用于

UI控件

布尔选择

收集 "是 "或 "否 "的回答

多圈与形状

多选:药丸(按钮);形式:复选框或单选按钮

单选

从列表中选择一个选项

多圈与形状

下拉列表或表格

多项选择

收集多个选项

表单

下拉列表或表格

文本

收集文本输入

多圈与形状

文本字段

编号

收集数字输入

多圈与形状

数字字段

日期

收集日期输入

多圈与形状

日期选取器

日期范围

收集开始日期和结束日期

表单

日期范围选择器

文件上载

收集一个或多个文件

多圈与形状

文件上传控件

列表(输入)

收集多个用户输入的值

表单

列表(输出)

显示值列表

多圈与形状

项目符号列表或表格

消息

显示一条文本消息

多圈与形状

纯文本、Markdown 或 HTML

文件下载

显示可下载文件

多圈与形状

下载链接

字段

在表单中显示单个值

表单

字段

本摘要为多轮交互和表单中的交互类型提供了统一视图,并帮助您理解每种类型所显示的UI控件。

提示:

上传到表单中的文件不会被删除,目前也没有机制能在特定时间后自动删除它们。 您无法通过任何形式访问先前上传的文件,无论是通过API还是通过用户界面。 访问该文件本身也有签名有效期,这会限制 URL 链接的长期可用性。

添加多轮交互

要在用户活动中添加多轮交互:

  1. 点击用户活动中的连接线。

  2. 选择从用户处收集信息。 您可以从以下交互类型中进行选择:

    布尔选择日期文件上传数字单选文本

  3. 选择向用户显示信息。 您可以从以下交互类型中进行选择:

    文件下载列表消息

在消息交互中,若需将花括号显示为纯文本,请使用双花括号进行转义。 例如, {{customer_id}} 在输出消息中显示为 {customer_id} ,而双大括号内的文本会被视为纯文本,而非变量。

添加基于表单的交互

表单支持与多轮交互相同的交互类型。 它们还包含仅在表单中可用的交互类型,例如多选和列表输入。 在设置表单字段时,您可以通过选择" 从用户收集""向用户展示" 来添加这些交互功能。

有关如何配置每种字段类型的详细步骤,请参阅表单文档中 "从用户收集 "和 "向用户呈现" 部分的相关章节。

除了字段层面的交互外,表单还支持动态规则 ,这些规则可根据用户输入来控制字段的行为。 动态规则允许您在用户填写表单时,动态显示或隐藏字段、更改字段标签,或自动填充字段值。 有关动态规则和动态表单行为的信息,请参阅 “动态表单 ”。

编辑交互

编辑用户活动中的交互:

  1. 点击互动。

  2. 将鼠标悬停在名称上,然后点击“编辑 编辑”。

  3. 输入新名称并按回车键。

删除互动

删除用户活动中的交互:

  1. 点击互动。

  2. 选择“删除” 删除

提示:

该节点的标题会在聊天中显示给用户。

配置交互变量

配置用户交互收集的变量:

  • 配置单选交互节点以收集用户的单选输入。

    单击该变量 变量 ,然后选择要用于收集用户单选输入的变量。 要创建自定义选项,您可以单击该表达式表达式 ,并输入一个 Python 表达式,该表达式将返回供用户选择的选项。

配置显示给用户交互的变量:

  • 配置一个文本交互节点,在聊天中显示文本。

    1. 输入要在输出信息中显示的文本。 若要在消息中插入变量的值,请点击“变量 变量”,然后从列表中选择该变量。

  • 配置一个列表交互节点,在聊天中显示列表。

    1. 单击选择来源字段。

    2. 点击该变量 变量 ,然后选择提供要在聊天中显示的值列表的变量。 要创建自定义列表,您可以单击表达式表达式 ,然后输入一个能生成列表的 Python 表达式。

  • 配置文件下载交互节点,在聊天中显示可下载文件。

    1. 单击选择来源字段。

    2. 点击该变量 变量

    3. 选择一个变量,该变量提供待下载的文件。

用户活动中的表格

您可以在用户活动中使用表单,在单次对话回合内收集并呈现多项信息。 例如,在预订航班的代理工作流程中,表单可以收集旅行日期、目的地、舱位偏好和其他详细信息。 然后,聊天会根据用户的输入显示可用航班列表。

添加表单

为代理工作流程中的用户活动添加表单:

  1. 点击用户活动中的连接线。

  2. 选择添加表单。 显示添加表格的对话框。

    点击 编辑 并输入表单名称。 在表单的常规设置中,默认情况下用于添加聊天中显示给用户的说明的“说明”切换开关处于关闭状态。 若需向用户提供任何说明,请将开关置于开启状态。

  3. “主要操作 ”部分,您可以配置表单的 “主要操作”按钮

    • 主要操作按钮代表用户完成表单填写的核心操作。 默认情况下,主要操作为 “提交 ”,您可根据需要重命名该操作。

  4. “附加操作 ”部分,您可以为表单添加更多操作按钮。

    • 若需添加多个完成操作,请在 “附加操作 ”字段中选择“添加附加操作”按钮。 此时会显示一个输入框,您可以在其中为该附加操作输入名称。

    • 每个额外的操作按钮都会在工作流中创建一个独立的分支,这些分支以操作名称为标签显示在表单下方,形成与现有主操作分支并列的独立路径。

    • 您可以在每个附加操作分支中添加流程项,以定义该操作的工作流逻辑。

    • 您最多可向表单添加三个额外的操作按钮。 当定义了多个附加操作时,这些按钮将在表单上组合为一个" 操作 "下拉菜单。

  5. “取消 ”部分,您可以配置表单的 “取消”按钮

    • 您可以输入文本以重命名 “取消”按钮

    • 要从表单中移除 “取消”按钮 ,请将切换开关设置为关闭状态。

  6. 将鼠标悬停在 “添加”字段或“添加”图标上 添加图标,然后选择 “从用户处收集 ”或 “向用户展示 ”,即可向表单添加字段(用户交互类型)。

您可以添加字段以收集用户信息,在聊天中向用户展示信息,并定义动态规则,根据用户输入来控制字段的行为。 如需了解更多信息,请参阅 “从用户处收集”“向用户展示 ”和 “动态表单 ”。

从用户处获取

要在表单中收集用户信息,可以添加以下任何字段:

BOOLEAN

布尔选项允许用户在聊天中指定一个布尔选项。 您可以在表单中添加布尔字段,将用户指定的数据传递给下游节点,然后由代理工作流程使用。 在表单中添加布尔字段:

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择从用户处收集

  3. 选择布尔值

  4. 常规 > 标签中,输入在聊天中显示给用户的字段文本。

  5. 在 " 外观 ">" 显示为 "中,选择如何在聊天中将布尔字段显示为单个复选框或单选按钮。

  6. 在单选按钮的 " 真标签 "和 " 假标签 "选项中,可以修改在聊天中显示给用户的布尔选项文本。

  7. 行为中,可以使用变量、表达式或自动映射选项为布尔字段指定初始值。 初始值在聊天中用作默认值,有助于用户快速完成表单。 用户可以接受或修改该值。

如果要指定 true 或 false 的初始值,请关闭自动映射并指定一个值。

现在,一个布尔字段已添加到您的表单中。 下面的示例显示了聊天中的显示方式。

布尔切换

日期/时间

您可以在表单中添加日期和时间字段,以收集日期、时间或两者兼有。 该字段支持诸如选择开始日期、结束日期、截止日期或提醒时间等工作流场景。 用户在聊天中选择的值会被捕获,并由代理工作流使用。

要在表单中添加日期和时间字段:

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择从用户处收集

  3. 选择日期/时间

  4. 在“常规” > “标签 ”下,输入要在聊天中显示给用户的文本。

    将 “多选日期 ”开关设为“开”,以便用户选择多个日期。 否则,请关闭开关。 “多个日期 ”选项仅在输入类型为 “日期 ”时可用。

    将 " 必填 "开关设为 "开",聊天时就必须选择此字段。 否则,将开关设置为关闭。

  5. “输入类型 ”中,选择您要收集的输入类型。 您可以根据用户需要填写的值,选择 “日期”“时间 ”或 “日期和时间 ”。

  6. “行为” 选项卡中,将 “初始值 ”开关设为“开”,以定义日期或时间字段的默认值。 对于所有输入类型,您都可以使用变量或表达式来设置初始值。 如果输入类型是 Date ,您也可以使用自动映射。 用户可以在聊天中接受或修改初始值。

  7. “行为 ”选项卡中,将 “输入范围 ”开关设为“开”,以定义日期、时间或日期和时间字段的有效范围。 “开始”和“结束”字段会根据所选的输入类型而变化。 对于所有输入类型,您都可以使用变量或表达式来定义起始值和结束值。 如果输入类型是 Date ,您也可以使用自动映射。

日期

日期/时间范围

您可以在表单中添加一个日期和时间范围字段,以便用户在聊天中指定起始值和结束值。 范围类型可以是日期或时间。 代理工作流可将这些用户提供的值应用于休假申请、排班等场景,或任何需要指定范围的工作流。

要在表单中添加日期和时间范围字段:

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择从用户处收集

  3. 选择日期/时间范围

  4. 在“常规” > “标签 ”下,输入要在聊天中显示给用户的文本。

    将 " 必填 "开关设为 "开",聊天时就必须选择此字段。 否则,将开关设置为关闭。

  5. “范围类型 ”中,选择用户必须提供的范围。 您可以根据用户需要输入的值,选择 “日期 ”或 “时间 ”。

  6. “外观 ”中,为聊天界面中向用户显示的起始字段和结束字段输入标签。 可用的标签字段取决于所选的范围类型。

  7. “行为” 选项卡中,将 “初始值 ”开关设为“开”,即可为日期或时间定义默认的起始值和结束值。 field.You 支持通过变量或表达式为所有范围类型设置起始值和结束值。 如果范围类型为 “日期 ”,您也可以使用自动映射。 用户可以在聊天中接受或修改初始值。

  8. “日期范围限制 ”或 “时间范围限制 ”开关设为“开”,以定义日期或时间字段的有效范围。 “开始”和“结束”字段会根据所选的范围类型而变化。 对于这两种范围类型,您都可以使用变量或表达式来定义起始值和结束值。 如果范围类型为 “日期 ”,您也可以使用自动映射。

表单中现已添加了一个日期和时间范围字段。 以下示例展示了日期范围字段在聊天中的显示方式。

日期范围

文件上载

您可以在表单中添加文件上传字段。 该字段适用于用户可以在聊天中上传文件的代理工作流,如文档处理、协作、生成摘要等。

要在表单中添加文件上传字段:

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择从用户处收集

  3. 选择文件上传

  4. 常规 > 标签中,输入在聊天中显示给用户的字段文本。

    要允许上传多个文件,请将允许上传多个文件开关设置为开启。 要在聊天中强制选择此字段,请将 " 必填 "开关设置为 "开"。

  5. 在 " 外观 " >"说明 " 中,可以输入说明帮助用户上传文件,也可以单击 " 生成说明 ",根据 " 行为 "中选择的文件大小和文件类型自动生成说明。

    按钮标签选项中,您可以为文件上传字段指定一个标签。

  6. 行为中,您可以指定用户可以上传的支持文件类型和最大文件大小限制。

    如果 “允许多个文件 ”开关处于开启状态,您可以设置文件上传的限制。 要设置文件上传限制,请将 “文件上传限制 ”开关设为“开”,并输入文件的最小和最大数量。

现在,您的表单中已添加了文件上传字段。 下面的示例显示了聊天中的显示方式。

文件上载

列表

当需要从用户处收集一组信息时,您可以在表单中添加列表字段。 列表项可以是原始数据类型(如字符串或日期),也可以是对象数据类型(如航班详情)。

要在表单中添加列表字段:

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择从用户处收集

  3. 选择列表

  4. 常规 > 标签中,输入在聊天中显示给用户的字段文本。

  5. 变量中,您可以通过使用变量或表达式为列表指定一个源。

    若指定的源变量是一个对象列表,则可选择以表格形式显示数据。 在 “外观 ”部分,点击 “编辑元素 ”以配置列表元素向用户显示的方式。 点击 “编辑元素 ”后,将打开一个专门的对话框,您可以在其中管理这些元素。

    “编辑元素 ”中,您可以:

    • 重新排列元素 :拖动 重新排序控件 以更改显示顺序。

    • 控制可见性 :点击 “可见性 ”图标可隐藏单个元素。

    • 编辑标签 :修改 “元素标签 ”列中的文本,以自定义每个元素在用户面前的显示方式。

    • 整理标签 :单击 “整理标签 ”可自动格式化所有标签。

    • 重置标签 :单击 “重置标签 ”可将所有标签恢复为源变量中的原始值。

  6. “行为 ”部分,您可以配置用户与列表的交互方式。

    若需允许用户向列表添加项目,请将" 允许添加 "开关设置为开启状态。 若需允许用户从列表中删除项目,请将 “允许删除 ”开关设置为开启状态。

多项选择

您可以在表单中添加多选字段,以便从聊天列表中收集多个选项。 用户指定的选项随后会被代理工作流程使用。 此字段适用于代理工作流,用户可以在聊天中选择多个选项,如报告的多个部门、任务的多个类别等。

要在表单中添加多选字段:

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择从用户处收集

  3. 选择多重选择

  4. 常规 > 标签中,输入在聊天中显示给用户的字段文本。

    将 " 必填 "开关设为 "开",聊天时就必须选择此字段。 否则,将开关设置为关闭。

  5. 在“源变量 ”中,您可以通过使用变量或表达式来指定列表的来源。

    如果您指定的源变量是一个包含对象的列表(该列表定义了数据),则可以选择以下列出的方式显示数据:下拉列表或表格。 要选择显示类型,请在 “外观” > “显示为 ”中选择 “下拉菜单 ”或 “表格 ”。

    如果选择 “下拉列表 ”选项, 使用变量或表达式为列表中的每个列表项设置显示名称。

    如果选择了 “表格 ”选项,请点击 “编辑列 ”来配置列的显示方式。 点击 “编辑列 ”后,将打开一个专用对话框,您可以在其中管理各项内容。

    “编辑元素 ”中,您可以:

    • 重新排列元素 :拖动 重新排序控件 以更改显示顺序。

    • 控制可见性 :点击 “可见性 ”图标可隐藏单个元素。

    • 编辑标签 :修改 “元素标签 ”列中的文本,以自定义每个元素在用户面前的显示方式。

    • 整理标签 :单击 “整理标签 ”可自动格式化所有标签。

    • 重置标签 :单击 “重置标签 ”可将所有标签恢复为源变量中的原始值。

      占位符文本选项中,还可以指定下拉列表为空时显示给用户的文本。

  6. 行为中,可以使用变量、表达式或自动映射选项为列表指定初始值。 初始值在聊天中用作默认值,有助于用户快速完成表单。 用户可以接受或修改该值。 您还可以指定

    如果要指定一个特定值作为初始值,请关闭自动绘图并输入该值。

    若要限制用户在列表中可选择的项目数量,请使用 “选择限制 ”选项指定最小和最大选择数量。 例如,指定选择限制,规定用户必须至少选择 2 项,且最多选择 5 项。

现在,您的表单中添加了一个多选择字段。 下面的示例显示了聊天中的显示方式。

多项选择

成员

您可以在表单中添加数字字段,以便在聊天中收集用户的数字输入。 然后,代理工作流程将使用数字输入。 例如,用户可以在聊天中指定票据 ID、物品数量、天数等。

要在表单中添加数字字段:

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择从用户处收集

  3. 选择编号

  4. 常规 > 标签中,输入在聊天中显示给用户的字段文本。

    将 " 必填 "开关设为 "开",聊天时就必须选择此字段。 否则,将开关设置为关闭。

  5. 输入类型中,为数字指定整数或十进制类型。

  6. 在 " 外观 "中,您可以为数字字段添加辅助文本。 将 " 辅助文本 "开关设置为 "开启",以添加辅助文本。 否则,将开关设置为关闭。

  7. 行为中,可以使用变量、表达式或自动映射选项来指定数字的初始值。 将初始值开关设置为开启,以添加初始值。 否则,将开关设置为关闭。 初始值在聊天中用作默认值,有助于用户快速完成表单。 用户可以接受或修改该值。

    如果要指定一个特定值作为初始值,请关闭自动绘图并输入该值。

    您还可以为数字字段指定一个范围,例如,用户可以在 10 到 20 之间选择一个数字。 要添加范围,请将输入范围开关设置为开。 否则,将开关设置为关闭。 您可以使用变量、表达式或自动映射选项为范围指定最小值和最大值。 要指定一个特定值作为最小值或最大值,请关闭自动绘图并输入该值。

现在,您的表单中已添加了一个数字字段。 下面的示例显示了聊天中的显示方式。

编号

单选

您可以在表单中添加单选字段,以便从聊天列表中收集选项。 然后,代理工作流程就会使用用户指定的选项。 该字段适用于代理工作流,用户可以在聊天中选择部门、组织等单个选项。

要在表单中添加单选字段:

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择从用户处收集

  3. 选择单选

  4. 常规 > 标签中,输入在聊天中显示给用户的字段文本。

    将 " 必填 "开关设为 "开",聊天时就必须选择此字段。 否则,将开关设置为关闭。

  5. 在“源变量 ”中,您可以通过使用变量或表达式来指定列表的来源。

    如果您指定的源变量是一个包含对象的列表(该列表定义了数据),则可以选择以下列出的方式显示数据:下拉列表或表格。 要选择显示类型,请在 “外观” > “显示为 ”中选择 “下拉菜单 ”或 “表格 ”。

    如果选择了 “下拉列表”选项,请在“使用变量或表达式设置每个列表项的显示名称”中为每个列表项指定名称。

    如果选择了 “表格 ”选项,请点击 “编辑列 ”来配置列的显示方式。 点击 “编辑列 ”后,将打开一个专用对话框,您可以在其中管理各项内容。

    “编辑元素 ”中,您可以:

    • 重新排列元素 :拖动 重新排序控件 以更改显示顺序。

    • 控制可见性 :点击 “可见性 ”图标可隐藏单个元素。

    • 编辑标签 :修改 “元素标签 ”列中的文本,以自定义每个元素在用户面前的显示方式。

    • 整理标签 :单击 “整理标签 ”可自动格式化所有标签。

    • 重置标签 :单击 “重置标签 ”可将所有标签恢复为源变量中的原始值。

    占位符文本选项中,还可以指定下拉列表为空时显示给用户的文本。

  6. "外观 "中,您可以添加占位符文本,当列表为空时,该文本将在聊天中显示给用户。

  7. 行为中,可以使用变量、表达式或自动映射选项为列表指定初始值。 初始值在聊天中用作默认值,有助于用户快速完成表单。 用户可以接受或修改该值。

    如果要指定一个特定值作为初始值,请关闭自动绘图并输入该值。

现在您的表单中添加了一个单选字段。 下面的示例显示了聊天中的显示方式。

单选

text

您可以在表单中添加文本字段,以收集聊天用户的文本数据。 然后,代理工作流程就会使用用户指定的文本。 例如,用户可以在聊天中输入对评论或反馈的回复、对问题或任务的描述以及其他内容。

要在表单中添加文本字段:

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择从用户处收集

  3. 选择文本

  4. 常规 > 标签中,输入在聊天中显示给用户的字段文本。

    将 " 必填 "开关设为 "开",聊天时就必须选择此字段。 否则,将开关设置为关闭。

    输入类型中,您可以为文本指定单行多行类型。

  5. "外观 "中,您可以为文本字段添加占位符文本和辅助文本。 将占位符文本开关设置为 "开启 "可添加占位符文本 ,将辅助文本开关设置为 "开启 "可添加辅助文本。 否则,将开关设置为关闭。

  6. 行为中,可以使用变量、表达式或自动映射选项为文本字段指定初始值。 初始值在聊天中用作默认值,有助于用户快速完成表单。 用户可以接受或修改该值。

    如果要指定一个特定的初始值,请关闭自动绘图并输入该值。

    您可以指定正则表达式(regex)来定义允许的格式。 要指定正则表达式,请将 “正则表达式”验证开关设为“开”,并输入正则表达式。 表单中的该字段仅接受符合您定义的模式的文本。 在 “正则表达式错误消息 ”中,您可以指定验证时的错误消息。

    有关在代理工作流中映射数据的更多信息,请参阅映射数据

现在表单中已添加了一个文本字段。 下面的示例显示了聊天中的显示方式。

文本

向用户展示

要在表单中向用户显示信息,可以使用以下任何一种数据类型:

字段

您可以在表单中添加一个字段,以便在聊天中向用户显示数据。

为表格添加字段

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择向用户展示

  3. 选择字段

  4. 常规 > 标签中,输入在聊天中显示给用户的字段文本。

  5. 常规 > 源中 ,可以使用变量或表达式指定数据源。

列表

您可以在表单中添加列表,以便在代理工作流程中显示多种信息。 例如,您可以在聊天中以有条理的方式向用户显示优先级、状态和其他信息。

将列表添加到表单中:

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择向用户展示

  3. 选择列表

  4. 常规 > 为选择列表选择来源中,使用变量或表达式指定列表来源。

如果将源变量指定为定义数据的数组对象,则可以选择以表格形式显示数据。 您可以自定义列表中要显示的列。

要编辑选定的列标签,请单击编辑列标签并指定每个项目的标签。 您还可以单击 " 整理标签 "来自动格式化标签。

消息

您可以在表单中添加信息,以便在代理工作流程中显示信息。 例如,您可以在聊天中显示代理工作流程的结果,帮助用户了解结果。

若需在显示的消息中使花括号以纯文本形式呈现,请使用双花括号进行转义。 例如, {{customer_id}} 在输出消息中显示为 {customer_id} ,而双大括号内的文本会被视为纯文本,而非变量。

要在表单中添加信息:

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择向用户展示

  3. 选择消息

  4. 常规 > 输出信息中,输入信息。 您也可以在信息中使用变量。

文件

您可以在表单中添加文件字段,让用户下载代理工作流程中生成的文件。 例如,用户可以在聊天中下载报告或任何其他文件。

要在表单中添加文件下载字段:

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择向用户展示

  3. 选择文件下载

  4. 常规 > 标签中,输入在聊天中显示给用户的字段文本。

  5. 常规 > 源文件中,可以使用变量或表达式指定源文件。

代理工作流定义了一系列相关联的活动和控制,旨在实现特定的业务目的或目标。 了解有关代理工作流的更多信息。

动态表单

动态表单使单个表单能够支持多种使用场景,而无需重复添加字段或创建独立的表单。 当用户与表单交互时,字段会动态响应,并根据用户输入调整行为。 表单不会一次性显示所有字段,而是随着用户进行选择而动态更新,从而仅显示相关的字段、标签和数值。

动态行为是通过动态规则来定义的。 动态规则可在工作流构建器中通过可视化方式进行配置,无需编写脚本或自定义逻辑。 规则在表单内部生效,并决定一个字段如何影响其他字段的行为。 动态表单会根据用户输入(例如位置、类别、角色或之前的回答)来调整数据收集方式。

一个表单可以包含多个动态规则。 一个字段可以由多条规则控制,且每条规则都会独立进行评估。 动态规则仅适用于下游字段。 受控字段必须位于触发字段之后。 这种排序方式有助于确保行为可预测,并避免了循环依赖。

动态规则可插入到表单定义中的字段之间,并可配置为控制不同类型的规则,包括动态标签、可见性及渐进式下拉菜单。 规则的行为是通过规则属性进行配置的。

动态表单支持以下规则类型:

动态标签

动态标签规则用于控制条件字段显示的标签文本。 这些规则允许同一个字段根据用户输入显示不同的标签文本,从而在单个表单中支持针对具体上下文的术语。

动态标签规则支持为同一字段设置多条规则,且每条规则可包含多个条件。 当满足条件时,将应用规则中定义的标签。 对于不符合条件的情况,也可以定义一个备用标签。

可视性

可见性规则根据触发字段的值,控制条件字段是显示还是隐藏。 这些规则用于通过仅在相关字段时显示它们,从而降低表单的复杂度。

可见性规则会评估一个或多个条件,并确定条件字段的可见状态。 可以在单条规则中组合条件,从而为多种输入场景定义可见性行为。 可见性规则仅影响字段是否显示,不会更改字段标签或值。

渐进式选择

渐进式选择规则控制条件字段的下拉列表值如何填充。 这些规则会在触发字段值发生变化时运行一个工具,从而动态获取值。

渐进式选择规则不依赖条件,而是基于所选工具的输出结果。 该工具在工作流构建器中进行配置,并提供用于填充下拉字段的值。 当触发字段发生变化时,工具将重新运行,并更新可用选项。

向表单添加动态规则

要在表单中添加动态规则:

  1. 在表单对话框中,单击 “添加字段 ”或单击“添加”图标 添加图标

  2. 选择 “动态规则”

  3. 选择规则类型:

    • 动态标签

    • 可视性

    • 渐进式选择

  4. 在规则属性中:

    • 请输入姓名

    • 选择一个事件触发器字段。

    • 选择一个或多个条件字段

表单中添加了一条动态规则。 该规则已创建,但尚未定义具体行为。

每条动态规则由以下属性组成:

事件触发器

事件触发器指定了其值发生变化时会触发规则评估的字段。 当所选事件触发字段的值发生变化时,该规则将执行,并将其行为应用于所选的条件字段。

添加并配置规则后,该关系将反映在触发字段上。 “触发器字段属性”中包含一个“事件触发器”部分,其中列出了由该字段触发的所有规则。

“事件触发器 ”下列出的每个条目下,您可以查看受影响的条件字段,并选择 “编辑规则 ”直接打开规则配置。

此功能允许您直接在触发器字段中查看和修改规则的行为,而无需在表单中打开动态规则。

条件字段

条件字段是指其行为由动态规则控制的下游字段。 这些字段是从表单中事件触发器后显示的字段列表中选出的。 在“条件字段”下选择一个字段,即可确定哪些字段可以由该规则进行控制。 选择一个条件字段本身并不会定义其行为;它仅确定该字段是否参与该规则。

选定的条件字段

“已选条件字段”列表显示了当前与该规则关联的字段。 此列表中的每个字段都代表一个规则可以作用的条件字段。 对于每个选中的条件字段,都提供 “添加规则 ”选项。 选择“添加规则”将打开该规则的专用配置窗口,在此处可定义该字段的行为,例如标签更改、可见性行为或值源配置。

配置动态标签和可见性规则

动态标签和可见性规则的配置过程相同。 这两种规则类型都使用条件来确定,当触发字段的值发生变化时,条件字段应如何响应。

要为表单配置动态标签或可见性规则:

  1. “动态标签 ”或 “可见性规则 ”选择动态规则。

  2. 在规则属性中,在“已选条件字段”下,选择 “添加规则 ”。

  3. 在“条件”字段设置中:

    • “If ”部分配置默认条件。

    • 要添加更多条件,请选择 “添加条件 ”。

  4. 配置规则结果:

    • 对于动态标签规则,请在 “Then ”部分指定标签文本。

    • 对于可见性规则,请在 “Then ”部分指定该字段是显示还是隐藏。

  5. “Else ”部分指定替代行为。

  6. 单击保存

    • 对于动态标签规则,请再次选择 “添加规则 ”以针对同一字段定义另一条规则。

    • 对于可见性规则,请选择 “添加条件 ”以在同一规则中继续添加条件。

配置渐进式选择规则

要为表单配置渐进式选择规则:

  1. 为渐进式选择规则选择动态规则。

  2. 在“渐进式选择”规则中,于“已选条件字段”下,选择 “添加规则 ”。

  3. 在“条件”字段设置中,单击 “选择工具 ”,然后从可用列表中选择一个工具。

  4. 如有必要,请配置工具输入。

  5. 单击保存