工作流操作快速参考（SharePoint 工作流平台）
该参考文档列出了除不可用的工作流操作之外，当前 SharePoint Designer 2013 版本支持的工作流操作。
注意
自 2020 年 8 月 1 日起，SharePoint 2010 工作流已对新租户停用，并于 2020 年 11 月 1 日从现有租户中删除。 如果你使用的是 SharePoint 2010 工作流，我们建议迁移到 Power Automate 或其他支持的解决方案。 有关详细信息，请参阅 SharePoint 2010 工作流停用。
SharePoint Designer 2013 中的工作流操作
以下是 SharePoint 工作流平台上可用的工作流操作参考文档。 除 SharePoint 工作流平台之外，SharePoint Designer 2013 也支持 SharePoint 2010 工作流平台。 若要查看 2010 平台的工作流操作，请参阅 工作流操作快速参考 (SharePoint 2010 工作流平台)
核心操作
核心操作是那些最常执行的操作，它们通常组合在一起以便于访问。
表 1. 核心操作参考
| 操作 | 说明 |
|---|---|
| 添加注释 |
使您能够在工作流设计器中留下相关评论以供参考。 当有其他用户对工作流进行协作时，这将非常有用。 |
| 将时间添加到日期 |
将以分钟、小时、天或月表示的特定时间添加到一个日期（不支持年），并将输出值存储为一个变量。 该日期可以是当前数据、特定日期或查阅。 "当前日期"值返回 UTC 午夜。 |
| 生成词典 |
生成键/值对形式的 Dictionary 变量。 注意：Dictionary 使用 JSON 表示法存储数据。 有关 Dictionary 变量的详细信息，请参阅 了解 SharePoint Designer 2013 中的字典操作 |
| 调用 HTTP Web 服务 |
作为调用 HTTP Web 服务方法的函数返回 JSON 格式的数据。 RequestHeader 支持基本身份验证。 有关 Dictionary 变量的详细信息，请参阅 了解 SharePoint Designer 2013 中的字典操作 |
| 词典中的计数项目 |
在指定的词典中返回项数的统计值。 |
| 进行计算 |
执行算术运算，并将输出值存储在变量中。 注意：对于 SharePoint，此操作仅支持 Double 数字类型。 不支持整数。 不支持对字符串使用“+”运算符（串联）。 |
| 从字典中获取项 |
从词典变量返回一个特定项。 |
| 记录到历史记录列表 |
将预定义的消息项目列表中的消息写入到工作流历史记录列表中。 |
| 暂停持续时间 |
导致工作流暂停执行指定的时间间隔（以天、小时和分钟这种格式表示）。 |
| 暂停到某个日期 |
导致工作流暂停执行，直到指定的日期和时间。 |
| 发送电子邮件 |
当指定的工作流事件发生时，自动向用户或组发送电子邮件，其中包含预先确定的消息。 重要说明：如果网站未添加到“可信网站”列表中，电子邮件会路由到 Outlook 的“垃圾邮件”文件夹中。 |
| 设置日期/时间字段的时间部分 |
创建一个时间戳，并将输出值存储在一个变量中。 您可以以小时和分钟设置时间，并添加当前日期、特定日期或查找。 |
| 设置工作流状态 |
设置工作流的状态。 |
| 设置工作流变量 |
将工作流变量设置为一个值。 当您希望工作流将数据分配给一个变量时，也可以使用此操作。 |
| 转到阶段 |
指定下一个应执行工作流控制的阶段。 |
协调操作
协调操作用于调用基于 SharePoint 2010 工作流平台的工作流。 有关协调操作的详细信息，请参阅 了解 SharePoint Designer 2013 中的协调操作
表 2. 协调操作参考
| 操作 | 说明 |
|---|---|
| 启动列表工作流 |
启动基于 SharePoint 2010 工作流平台的列表工作流。 注意： 启动列表工作流存在以下问题：> 当 2010 工作流包含 TaskProcess 操作时，“工作分配”类型字段不能用作参数。> 对同一 2010 工作流进行多次调用时，结果将是 2013 工作流查找功能中的多个数据源。 这些数据源都是相同的。> 2013 中的变量名称不能包含特殊字符，例如“？”和“#”。 如果 2010 工作流包含特殊字符，它们将在 2013 工作流中转换为十六进制代码。 |
| 启动网站工作流 |
启动基于 SharePoint 2010 工作流平台的网站工作流。 注意： 启动列表工作流存在以下问题：> 当 2010 工作流包含 TaskProcess 操作时，“工作分配”类型字段不能用作参数。> 对同一 2010 工作流进行多次调用时，结果将是 2013 工作流查找功能中的多个数据源。 这些数据源都是相同的。> 2013 中的变量名称不能包含特殊字符，例如“？”和“#”。 如果 2010 工作流包含特殊字符，它们将在 2013 工作流中转换为十六进制代码。 |
列表操作
列表操作组共同操作适用于操作列表和列表项。
表 3. 列表操作参考
| 操作 | 说明 |
|---|---|
| 签入项目 |
签入已签出的项。只能签入文档库中的项。 警告：如果试图签入未签出的项，工作流会发生故障。 |
| 签出项 |
签出一个项目。 工作流验证该项目签入之前是否已从文档中签出。 您只能从自己的网站的库中签出项目。 警告：如果试图签出未签入的项，工作流会发生故障。 |
| 复制文档 |
将文档从当前列表复制到一个不同的文档库列表。 |
| 创建列表项 |
在您指定的列表中创建新的列表项。 您可以提供新项目中的域和值。 每当要用特定的信息创建新项目时，您都可以使用此操作。 |
| 删除项目 |
删除项。 注意：此操作在运行工作流管理器工作流引擎的计算机上终止，并抛出 System.InvalidOperationException 异常。 暂无解决办法。 |
| 放弃签出项 |
如果已签出和更改项，放弃更改并签出项。 警告：如果试图签入未签出的项，工作流会发生故障。 |
| 设置当前项中的字段 |
将当前项中的指定字段设置为指定值。 注意：如果需要工作流仅在字段值变化时暂停，请使用“等待列表项中的事件”操作替代此操作。 |
| 翻译文档 |
将文档翻译为一种特定语言 注意：需要预配置机器翻译服务应用。 |
| 更新列表项 |
更新列表项。 您可以指定域以及这些域中的新值。 |
| 等待列表项中的事件 |
[增强版的 Office 2010 操作]。 暂停工作流的当前实例，以等待指定的列表项事件。 此操作监听两个事件：ItemUpdated 和 ItemAdded。 |
| 等待当前项目中的域更改 |
等待当前项的一个域上等于某个特定值。 |
项目操作
项目操作支持 Microsoft Project 集成。 它们用于构建基于项目的工作流。 SharePoint Designer 2013 中的项目操作都是新的。
表 4. 项目操作参考
| 操作 | 说明 |
|---|---|
| 从当前项创建项目 |
获取当前项目并在 SharePoint 场 PWA 网站中创建一个新项目。 Project Online不支持对此操作使用应用步骤。 |
| 设置项目域 |
设置 Project Server 上特定字段的值。 注意：此操作要求先签入项目。 如果项目未签入，工作流会终止，并且用户无法在 Project Web App 中打开此项目。 |
| 设置项目阶段状态 |
设置项目阶段状态。 注意：签出当前项目时抛出异常。 |
| 设置想法列表中的状态字段 |
更新关联到当前项目的原始列表项的状态。 |
| 等待项目事件 |
等待特定项目事件。 |
任务操作
任务操作能够在 SharePoint 工作流平台的工作流中调用基于 SharePoint 2010 工作流平台的工作流。
表 5. 任务操作参考
| 操作 | 说明 |
|---|---|
| 分配任务 |
将工作流任务分配给用户，并建立完成任务的截止日期。 |
| 启动任务进程 |
创建多用户任务，并使该任务能够通过自定义进程执行。 |
实用程序操作
实用程序操作用于操作字符串或查找日期间的时间间隔。
表 6. 实用程序操作参考
| 操作 | 说明 |
|---|---|
| 从字符串结尾提取子字符串 |
复制指定的数目的字符（从字符串的末尾开始），并将输出存储在变量中。 |
| 从字符串索引提取子字符串 |
将字符串中从指定索引开始算起的子字符串值复制并粘贴到变量中。 注意：请注意，虽然 Microsoft SharePoint Designer 2013 中的索引值是从 0 开始编制，但 SharePoint Designer 2010 中的索引值是从 1 开始编制。 |
| 从字符串开头提取子字符串 |
复制从字符串的开头开始的指定数目的字符，并将输出存储在一个变量中。 |
| 从长度索引提取字符串的子字符串 |
复制从字符串指定索引处开始并包括指定数量字符的子字符串，并将该值放在一个变量中。 注意：请注意，虽然 Microsoft SharePoint Designer 2013 中的索引值是从 0 开始编制，但 SharePoint Designer 2010 中的索引值是从 1 开始编制。 |
| 查找日期间隔 |
以分钟、小时或天计算两个日期之间的时间间隔，并将输出存储在一个变量中。 |
| 剪裁字符串 |
删除从字符串开始到结束的空格。 |
| 在字符串中查找子字符串 |
查找一个字符串内的特定子字符串，并返回子字符串起始位置的索引。 |
| 替换字符串中的子字符串 |
将特定子字符串替换为另一个子字符串。 |
| 剪裁字符串 |
删除从字符串开始到结束的空格。 |
在 SharePoint 中已弃用的工作流操作
有关 SharePoint 2010 中已弃用且不会显示在 SharePoint 中的操作的列表，请参阅 使用工作流互操作桥提供的工作流操作。