数据映射

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

1. 创建一个新表单并添加以下组件：
   1. 添加 数据映射 组件。 记住您为其分配的 属性名称 ，因为您将使用它来提取和动态更新组件中的数据。
      在此示例中，使用 dataMap 作为 属性名称。
   2. 添加“按钮”组件以提取组件中的数据。 将按钮的 “操作” 设置为“事件”。
      将按钮命名为 Extract data 。
   3. 添加另一个“按钮”组件以更改组件中的数据。 将按钮的 “操作” 设置为“事件”。
      将按钮命名为 Update value 。
2. 在 Main 工作流中创建一个字典变量并向其中添加键值对。
   在此示例中，使用下图所示的键值对。

   
   

   

   
   
3. 添加启用了“继续执行工作流 ”的 “显示表单” 活动。 这允许在其他触发器工作流同时运行时显示表单。
   1. 在“参数”集合中，将先前创建的字典变量传递给表单中的“数据映射”组件。
4. 添加 “ 运行本地触发器” 活动以启用项目中的所有触发器。
5. 创建触发器工作流，以在运行时更新数据映射中的值。
   将触发器工作流命名为 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. 在工作流的末尾，添加“设置表单值”活动，以使用修改后的值更新表单内的数据映射。
6. 创建触发器工作流，以在运行时从数据映射中提取值。
   将触发器工作流命名为 extractDataTrigger 。
   1. 添加 表单触发器活动 ，并将 事件 设置为用于数据提取的按钮。
      在此示例中，将事件设置为 Extract data clicked 。
   2. 添加 “ 获取表单值” 活动，以在运行时提取数据映射的当前值。 将数据映射保存到字典变量中。
   3. 使用“遍历循环”活动遍历数据映射中的 每个 键值对，并在控制台中输出这些键值对。
      
      

      

      
      

在下面的动画图像中，您可以看到单击 Update value 按钮时数据映射中的值发生了动态更新。

工作流示例

要按照这些步骤自行尝试本教程，请在此处查看示例项目。