工作流活动

上次更新日期 2025年9月15日

数据映射

本教程演示如何创建和使用数据映射组件。您将学习如何向其传递数据，如何在表单显示时动态更新数据，以及如何提取数据。在此示例中，我们将重点介绍货币汇率，使用字典，其中的键值对表示不同的货币及其以美元为单位的等值值。通过与按钮交互，您可以在表单保持可见的情况下实时提取和修改货币汇率。

创建一个新表单并添加以下组件：
1. 添加 数据映射 组件。记住您为其分配的 属性名称 ，因为您将使用它来提取和动态更新组件中的数据。
  在此示例中，使用 dataMap 作为 属性名称。
2. 添加“按钮”组件以提取组件中的数据。将按钮的 “操作” 设置为“事件”。
  将按钮命名为 Extract data 。
3. 添加另一个“按钮”组件以更改组件中的数据。将按钮的 “操作” 设置为“事件”。
  将按钮命名为 Update value 。
在 Main 工作流中创建一个字典变量并向其中添加键值对。
在此示例中，使用下图所示的键值对。
添加启用了“继续执行工作流 ”的 “显示表单” 活动。 这允许在其他触发器工作流同时运行时显示表单。
1. 在“参数”集合中，将先前创建的字典变量传递给表单中的“数据映射”组件。
添加 “ 运行本地触发器” 活动以启用项目中的所有触发器。
创建触发器工作流，以在运行时更新数据映射中的值。
将触发器工作流命名为 fieldChangedTrigger 。
1. 添加 表单触发器活动，并将事件设置为用于更新数据映射值的按钮。
  在此示例中，将事件设置为 Update value clicked 。
2. 添加 “ 获取表单值” 活动，以将数据映射的当前值提取到字典变量中。
  在此示例中，将当前值保存到名为 dataMap2的变量中。
3. 使用“遍历循环”活动遍历每个键值对，并使用特定值进行更新。
4. 在“遍历循环”活动中，添加一个“分配”活动，以初始化要用于更新数据映射的新键值对。
  - 使用“保存到” 字段将该对保存到名为 newItem 的变量中。
  - 使用“要保存的值” 字段指定新的键值对： New KeyValuePair(Of String, String)(currentKeyValuePairOfTextAndText.Key, currentKeyValuePairOfTextAndText.Value) 。
5. 在“遍历循环”活动中，添加一个“ If 条件”活动，以有条件地修改 EUR 对。使用用于遍历数据映射的对象配置条件。
  在此示例中，配置以下条件： currentKeyValuePairOfTextAndText.Key = "EUR"
6. 在 If 活动的 Then 主体中，添加分配 newItem 活动，以使用所需的新值更新值。
  - 使用“保存位置” 字段分配 newItem 变量。
  - 使用“要保存的值” 字段提供该对的新值： CType(New KeyValuePair(Of String, String)("EUR", "1.19 USD"), KeyValuePair(Of String, String)) 。
7. 添加另一个“分配”活动，以将新值重新映射到字典中。
  - 使用“保存位置” 字段更新 dataMap2 变量中的相应键值对。
  - 使用“要保存的值” 字段将 newItem.Value 分配给 dataMap2(newItem.Key) 。
8. 在工作流的末尾，添加“设置表单值”活动，以使用修改后的值更新表单内的数据映射。
创建触发器工作流，以在运行时从数据映射中提取值。
将触发器工作流命名为 extractDataTrigger 。
1. 添加 表单触发器活动 ，并将事件设置为用于数据提取的按钮。
  在此示例中，将事件设置为 Extract data clicked 。
2. 添加 “ 获取表单值” 活动，以在运行时提取数据映射的当前值。将数据映射保存到字典变量中。
3. 使用“遍历循环”活动遍历数据映射中的每个键值对，并在控制台中输出这些键值对。