了解 SharePoint Designer 2013 中的字典操作
字典变量类型是 SharePoint 工作流平台中可与 SharePoint Designer 2013 一起使用的新变量。
注意
自 2020 年 8 月 1 日起，SharePoint 2010 工作流已对新租户停用，并于 2020 年 11 月 1 日从现有租户中删除。 如果你使用的是 SharePoint 2010 工作流，我们建议迁移到 Power Automate 或其他支持的解决方案。 有关详细信息，请参阅 SharePoint 2010 工作流停用。
了解字典变量类型
工作流时执行所需结果的一些列操作。 生成工作流时，经常需要在变量（存储容器）中保存将在工作流的其他部分使用的值。
创建变量时，您将需要告诉工作流引擎变量中将包含的数据的类型。 例如，您可能想要在变量中保存员工的姓名。 员工的姓名是一串字符，因此将创建 String 类型的变量。 然后，工作流可在变量中存储员工的姓名，如"John Doe"。
图：字符串变量
SharePoint Designer 2013 具有名为 Dictionary 的新变量类型。 Dictionary 变量类型是用于保存其他变量集合的容器。 例如，工作流可能需要存储的不仅仅是员工的姓名。 它可能还需要存储他的地址和出生日期。 如果不使用 Dictionary 变量，则必须创建多个独立变量。 这很快就会变得难以组织，也很难在工作流的逻辑中使用。 字典变量允许将多个数据点存储在单个变量中。
该图演示相关概念。
图：字母变量
使用字典变量类型的工作流操作
工作流由处理工作流时执行的多个操作组成。 SharePoint Designer 2013 包含许多不同的操作。 例如，可以执行一个操作来发送电子邮件、创建列表项以及将邮件记录到工作流历史记录。
以下是专为"字典" 变量类型设计的三种操作。
"生成字典"
"词典中的计数项目"
"从字典中获取项"
对于 字典 变量类型的工作流操作，可在"操作"下拉列表中找到，如图所示。
图：字典操作
使用"生成字典"操作创建变量
使用"生成字典"操作创建"字典"类型的变量。 输入字典的内容，然后，在变量列表中指定字典的名称。
下图显示"生成字典"对话框。 请注意，三个变量已添加到字典：字符串、整数和日期/时间。
图："生成字典"对话框
"字典"可包含 SharePoint 工作流平台中提供的任何类型的变量。 下面的列表定义可用的变量：
"布尔值"：Yes 或 No 值
"日期/时间"日期和时间
"字典"：变量的集合
"Guid"：全局唯一标识符 (GUID)
"整数"：无小数的整数
"数字"：可包含小数的数字
String：一串字符
重要说明：使用“调用 HTTP Web 服务”操作时，Dictionary 变量类型至关重要。
警告：仅在字典中设置值时，才支持将“名称”字段用作查找字段。 生成字典时，不支持将“名称”字段用作查找字段。
注意
“字典”变量可包含“字典”类型的变量。 在“字典”内存储“字典”变量的能力提供多种优势。 For example, you might create a Dictionary to store information about employees. Within the Dictionary you might create another Dictionary entry for each employee. As you build the workflow you can use the Dictionary variable instead of constantly creating new stand-alone variables for each piece of information about each employee. 如此示例所示，“字典”可用于组织工作流内的复杂信息。
使用“对字典中的项计数”操作进行变量计数和变量存储
使用"对字典中的项计数"操作对"字典"中包含的变量计数，然后在整数变量中存储该数目。 然后，可使用该项计数循环访问"字典"。
下图显示"对字典中的项计数"工作流操作。
图：对字典中的项计数
使用"从字典中获取项" 操作检索变量
使用"从字典中获取项" 操作检索"字典"中存储的变量，并将其置于变量中。 这在您需要存储在单独的变量中的字典中的变量时非常有用。 可通过输入变量的名称来检索值。
下图显示"从字典中获取项" 工作流操作。 请注意，"年龄"是"字典"中的变量的名称，并且使新"整数"变量的输出。
图：从字典中获取项"
