Adobe Workfront 模块
- 在创建或更新场景时使用新版连接器。
- 将现有模块升级为新版连接器。
您可以使用 Adobe Workfront Fusion 的 Adobe Workfront 连接器，在 Workfront 中自动化各类流程。 您也可以将 Workfront 与其他应用程序和服务连接。
有关创建场景的说明，请参阅创建场景：文章索引中的相关文章。 有关模块的详细信息，请参阅模块：文章索引下的相关文章。
访问权限要求
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront 包 |
任意 Adobe Workfront Workflow 包以及任意 Adobe Workfront 自动化和集成包 Workfront Ultimate Workfront Prime 和 Select 包，且需额外购买 Workfront Fusion。 |
| Adobe Workfront 许可证 |
标准 工作版或更高版本 |
| 产品 | 如果您的组织使用的 Workfront Select 或 Prime 包不包含 Workfront 自动化和集成，则必须单独购买 Adobe Workfront Fusion。 |
有关此表中信息的更多详细说明，请参阅文档中的访问权限要求。
将 Workfront 连接到 Workfront Fusion
Workfront 连接器使用 OAuth 2.0 与 Workfront 建立连接。
您可以在 Workfront Fusion 模块内直接创建到您 Workfront 帐户的连接。
使用客户端 ID 和客户端密钥连接到 Workfront
-
在任意 Adobe Workfront 模块中，点击“连接”字段旁的添加。
-
填写以下字段：
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header 连接类型 选择 Adobe Workfront 身份验证连接。 连接名称 输入新连接的名称。 客户端 ID 请输入您的 Workfront 客户端 ID。 您可以在 Workfront 的“设置”区域中 OAuth2 应用程序部分找到此信息。 打开您要连接的特定应用程序即可查看客户端 ID。 客户端密钥 输入您的 Workfront 客户端密钥。 您可以在 Workfront 的“设置”区域中 OAuth2 应用程序部分找到此信息。 如果您的 Workfront OAuth2 应用程序没有客户端密钥，您可以重新生成一个。 有关操作说明，请参阅 Workfront 文档。 身份验证 URL 此项可保持默认值，或输入您 Workfront 实例的 URL，并在后面添加
/integrations/oauth2。示例：
https://mydomain.my.workfront.com/integrations/oauth2主机前缀 在大多数情况下，此值应为 origin。 -
点击 继续 保存连接并返回模块。
如果您尚未登录 Workfront，系统会将您引导至登录界面。 登录后，您即可允许该连接。
- 通过 OAuth 2.0 连接到 Workfront API 不再依赖 API 密钥。
- 要连接到 Workfront 沙盒环境，您必须在该环境中创建 OAuth2 应用程序，然后使用该应用程序生成的客户端 ID 和客户端密钥建立连接。
使用服务器到服务器连接方式连接到 Workfront
-
在任意 Adobe Workfront 模块中，点击“连接”字段旁的添加。
-
填写以下字段：
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header 连接类型 选择 Adobe Workfront 服务器到服务器连接。 连接名称 输入新连接的名称。 实例名称 输入您的实例名称，即您的域。
示例：如果您的 URL 为
https://example.my.workfront.com，请输入example。实例通道 输入此连接要访问的环境类型。
示例：如果您的 URL 为
https://example.my.workfront.com，请输入my。客户端 ID 请输入您的 Workfront 客户端 ID。 您可以在 Workfront 的“设置”区域中 OAuth2 应用程序部分找到此信息。 打开您要连接的特定应用程序即可查看客户端 ID。 客户端密钥 输入您的 Workfront 客户端密钥。 您可以在 Workfront 的“设置”区域中 OAuth2 应用程序部分找到此信息。 如果您的 Workfront OAuth2 应用程序没有客户端密钥，您可以重新生成一个。 有关操作说明，请参阅 Workfront 文档。 范围 输入此连接所需的相关范围。 主机前缀 在大多数情况下，此值应为 origin。 -
点击 继续 保存连接并返回模块。
如果您尚未登录 Workfront，系统会将您引导至登录界面。 登录后，您即可允许该连接。
- 通过 OAuth 2.0 连接到 Workfront API 不再依赖 API 密钥。
- 要连接到 Workfront 沙盒环境，您必须在该环境中创建 OAuth2 应用程序，然后使用该应用程序生成的客户端 ID 和客户端密钥建立连接。
Workfront 模块及其字段
在您配置 Workfront 模块时，Workfront Fusion 会显示以下字段。 除这些字段外，根据您的应用程序或服务访问权限级别，可能会显示更多 Workfront 字段。 模块中的加粗标题表示必填字段。
如果您看到字段或功能上方的映射按钮，可使用它为该字段设置变量和函数。 有关详细信息，请参阅将信息从一个模块映射到另一个模块。
- 如果您在 Workfront 模块中未看到最新字段，可能是由于缓存问题所致。 请等待一小时后再试。
- 来自 Adobe Workfront 的 HTTP 429 状态码不会导致停用，而是会使场景短暂暂停执行。
触发器
监控事件
当在 Workfront 中创建、更新或删除特定类型的对象时，此触发器模块会实时执行一个场景。
该模块会显示与该 Webhook 相关的所有事件订阅。 这包括通过 Fusion 创建的事件订阅，以及直接通过 API 创建的事件订阅。 旧版监控事件模块中不提供此事件订阅视图。
该模块会返回与记录关联的所有标准字段，以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
- Workfront事件订阅会将编辑后的webhook视为新订阅。 对于以前的webhook配置，不会保留事件订阅历史记录，因为它被视为单独的事件订阅。
- 从旧事件订阅切换到新事件订阅可能不会完全同步。 因此，可能会收到两次事件（如果新订阅在旧订阅停止之前开始运行）或错过事件（如果旧订阅在新订阅开始运行之前停止）。
-
单击 Webhook 框右侧的添加。
-
在显示的 添加挂钩 框中配置该 Webhook。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto html-authored no-header Webhook 名称 输入 Webhook 的名称 连接 有关将 Workfront 应用程序连接到 Workfront Fusion 的说明，请参阅本文中的将 Workfront 连接到 Workfront Fusion。 记录类型 选择您希望该模块监控的 Workfront 记录类型。 状态 选择您希望关注旧状态还是新状态。
-
新状态
当记录状态更改 为 指定值时触发场景。
例如，如果状态设置为 New State，并且筛选条件设置为 Status Equals In Progress，则当 Status 更改为 In Progress 时，Webhook 会触发场景，而不论之前的状态是什么。
-
旧状态
当记录状态 从 指定值发生变化时触发场景。
例如，如果状态设置为 Old State，并且筛选条件设置为 Status Equals In Progress，则当当前 In Progress 状态的记录更改为其他状态时，Webhook 会触发场景。
事件筛选条件 您可以设置筛选条件，仅观看符合您所选条件的记录。
对于每个筛选条件，请输入要评估的字段、运算符以及筛选条件应允许的值。 您可以通过添加 AND 规则来使用多个筛选条件。
注意：您无法编辑现有 Workfront Webhook 中的筛选条件。 如需为 Workfront 事件订阅设置不同的筛选条件，请删除当前 Webhook 并创建一个新的。
有关事件筛选条件的详细信息，请参阅本文中的 Workfront 中的时间订阅筛选条件 > 监控事件模块。
排除由此连接创建的事件 启用此选项可排除通过与此触发器模块相同的连接器创建或更新的事件。 这可防止场景因自我触发而不断循环执行。
注意：任务记录类型不包括此选项。
记录来源 选择是否要让场景监控 New Records Only、Updated Records Only、New and Updated Records 或 Deleted Records Only。
注意：如果您选择 New and Updated Records，在创建 Webhook 时会生成两个事件订阅（使用相同的 Webhook 地址）。
启用安全挂钩 选择是否为此webhook启用基于authToken的安全性。
注意： 2026年8月23日之后，Fusion将默认对所有Workfront >关注事件模块（包括现有模块）启用基于authToken的安全性。 如果特定的Webhook中断或出于兼容性原因需要禁用此功能，则可以在2026年8月23日之前关闭“启用安全挂钩”选项。
-
Webhook 创建完成后，您可以查看事件发送到的端点地址。
如需了解更多信息，请参阅 Workfront 文档中事件订阅 API 一文的事件负载示例部分。
有关可与此模块一起使用的 Workfront 对象类型列表，请参阅每个 Workfront 模块可用的 Workfront 对象类型。
监控字段
当更新指定字段时，此触发器模块会执行场景。 该模块会返回所指定字段的旧值和新值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
有关可与此模块一起使用的 Workfront 对象类型列表，请参阅每个 Workfront 模块可用的 Workfront 对象类型。
监控记录
当新增、更新某一类型的对象或同时发生这两种情况时，此触发器模块会执行场景。 该模块会返回与记录关联的所有标准字段，以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
在输出中，模块会指明每条记录是新增的还是更新的。
自上次运行场景以来既被新增又被更新的记录会作为新增记录返回。
在配置此模块时，会显示以下字段。
有关可与此模块一起使用的 Workfront 对象类型列表，请参阅每个 Workfront 模块可用的 Workfront 对象类型。
操作
转化对象
此操作模块可执行以下任一转化：
- 将问题转化为项目
- 将问题转化为任务
- 将任务转化为项目
创建记录
此操作模块会在 Workfront 中创建一个对象（例如项目、任务或问题），并允许您为新对象添加自定义表单。 该模块允许您选择对象的哪些字段可在模块中使用。
您需要指定记录的 ID。
该模块会返回记录的 ID 及其关联字段，以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
请确保您提供了所需的最少输入字段。 例如，如果您要创建问题，则必须在项目 ID 字段中提供有效的父项目 ID，以指明该问题在 Workfront 中归属的位置。 您可以使用映射面板从场景中的其他模块映射此信息，也可以通过输入名称并从列表中选择的方式手动输入。
在配置此模块时，会显示以下字段。
有关可与此模块一起使用的 Workfront 对象类型列表，请参阅每个 Workfront 模块可用的 Workfront 对象类型。
- 输入对象 ID 时，您可以先输入对象名称，然后从列表中选择。 然后，模块会自动将相应的 ID 填入字段。
- 在为自定义字段或注释对象（评论或回复）输入文本时，您可以在注释文本字段中使用 HTML 标记来创建富文本，例如粗体或斜体。
-
解决单个用户
您可以在“用户”列表中解决单个用户。
- 在“用户”列表中选择一个或多个用户。
- 点击列表标题中的三点菜单。
- 选择批准。
- 几分钟后刷新页面。
-
解决批量新增的用户
要解决批量新增用户的问题，您可以直接将这批用户添加到 Adobe Admin Console 中。
有关操作说明，请参阅 Adobe 文档中的管理多个用户 | 批量上传 CSV。
自定义 API 调用
此操作模块允许您向 Workfront API 发起自定义的已经过身份认证的调用。 通过这种方式，您可以构建其他 Workfront 模块无法实现的数据流自动化。
该模块会返回以下信息：
-
状态代码（数字）：指示 HTTP 请求是成功还是失败。 这些是标准状态码，您可以在网上查阅其含义。
-
标头（对象）：提供与输出正文无关的响应/状态码的详细上下文信息。 并非所有出现在响应标头中的字段都是有用的响应标头，因此部分信息可能对您不重要。
响应标头的内容取决于您在配置模块时选择的 HTTP 请求类型。
-
正文（对象）：根据您在配置模块时选择的 HTTP 请求类型，您可能会收到返回的数据。 例如 GET 请求返回的数据，这些内容都会包含在此对象中。
您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
https://<WORKFRONT_DOMAIN>/attask/api/<API_VERSION>/ 的路径。以标准 JSON 对象的形式添加请求标头。 这将决定请求的内容类型。
例如， {"Content-type":"application/json"}
注意：如果出现错误且难以确定来源，请根据 Workfront 文档修改请求标头。 如果您的自定义 API 调用返回 422 HTTP 请求错误，请尝试使用 "Content-Type":"text/plain" 标头。
以标准 JSON 对象的形式添加 API 调用的查询。
例如： {"name":"something-urgent"}
提示：建议通过 JSON 正文传递信息，而不是作为查询参数。
以标准 JSON 对象的形式添加 API 调用的正文内容。
注意：
在 JSON 中使用 if 等条件语句时，需将引号置于条件语句外部。
有关可与此模块一起使用的 Workfront 对象类型列表，请参阅每个 Workfront 模块可用的 Workfront 对象类型。
删除记录
此操作模块会在 Workfront 中删除对象，例如项目、任务或问题。
您需要指定记录的 ID。
该模块会返回记录的 ID 及其关联字段，以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
有关可与此模块一起使用的 Workfront 对象类型列表，请参阅每个 Workfront 模块可用的 Workfront 对象类型。
- 同步删除记录。
- 在“删除记录”模块中添加错误处理规则，以忽略因 40 秒超时导致的错误。
下载文档
此操作模块会从 Workfront 下载文档。
您需要指定记录的 ID。
该模块会返回文档的内容、文件名、文件扩展名以及文件大小。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
有关可与此模块一起使用的 Workfront 对象类型列表，请参阅每个 Workfront 模块可用的 Workfront 对象类型。
获取预签名文件URL
此操作模块获取预签名的文件 URL，以供其他 API 使用。
其他操作
此操作模块允许您对 API 执行操作。
convertToProject 操作新增字段 copyCategories。 当设置为 TRUE 时，所有自定义表单都会包含在该问题转化后的项目中。在配置此模块时，会显示以下字段。
有关可与此模块一起使用的 Workfront 对象类型列表，请参阅每个 Workfront 模块可用的 Workfront 对象类型。
项目
读取记录
此操作模块从单个记录中检索数据。
您需指定记录的 ID。 您还可以指定要让模块读取的关联记录。
例如，如果模块正在读取的记录是项目，您可以指定读取该项目的任务。
模块会根据您选择的输出字段返回一个数据数组。
在配置此模块时，会显示以下字段。
有关可与此模块一起使用的 Workfront 对象类型列表，请参阅每个 Workfront 模块可用的 Workfront 对象类型。
更新事件有效负载版本
Workfront 最近发布了新版事件订阅服务。 该新版并未更改 Workfront API，而是更新了事件订阅功能。 此操作模块用于更新该场景中使用的事件负载版本。
有关新版事件订阅的更多信息，请参阅 Workfront 文档中事件订阅版本控制
如需了解在事件订阅升级期间如何保护 Workfront Fusion 场景（包括网络研讨会录像），请参阅事件订阅 V2 升级期间保护您的 Fusion 场景。
更新记录
此操作模块用于更新对象，例如项目、任务或问题。 该模块允许您选择对象的哪些字段可在模块中使用。
您需要指定记录的 ID。
该模块会返回对象的 ID 及其关联字段，以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
有关可与此模块一起使用的 Workfront 对象类型列表，请参阅每个 Workfront 模块可用的 Workfront 对象类型。
上传文档
此操作模块会将文档上传到某个 Workfront 对象，例如项目、任务或问题。 该模块以分块方式上传文档，从而让 Workfront 更顺畅地处理上传过程。
此模块能够处理比旧版模块更大的文件，并正在逐步向拥有 Ultimate Workfront 套餐的组织转出。
您需要指定文档的存放位置、要上传的文件，以及可选的文件新名称。
该模块会返回文档的 ID 及其关联字段，以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
有关可与此模块一起使用的 Workfront 对象类型列表，请参阅每个 Workfront 模块可用的 Workfront 对象类型。
搜索
读取关联记录
此搜索模块会从指定的父对象中读取与您设定的搜索查询匹配的记录。
您可以指定需要在输出中包含的字段。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
搜索
此搜索模块会在 Workfront 中的对象内查找与您指定的搜索查询匹配的记录。
您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
搜索（旧版）
使用此模块的现有场景仍将按预期运行。 该模块将于 2025 年 5 月从模块选择器中移除。
此搜索模块会在 Workfront 中的对象内查找与您指定的搜索查询匹配的记录。
您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
每个 Workfront 模块可用的 Workfront 对象类型
每个Workfront trigger模块可用的对象类型
每个Workfront操作模块可用的对象类型
每个Workfront搜索模块可用的对象类型
我们建议您再次确认，以确保其行为符合您的预期。
Workfront > 监控事件模块中的事件订阅筛选条件
事件订阅中的过滤器允许您确保仅在满足某些参数时运行方案。
事件订阅过滤器最佳实践
-
我们强烈建议您在监控事件模块中使用事件订阅筛选条件。
-
Workfront 最近发布了新版事件订阅服务。 该新版并未更改 Workfront API，而是更新了事件订阅功能。 此操作模块用于更新该场景中使用的事件负载版本。
有关新版事件订阅的更多信息，请参阅 Workfront 文档中事件订阅版本控制
如需了解在事件订阅升级期间如何保护 Workfront Fusion 场景（包括网络研讨会录像），请参阅事件订阅 V2 升级期间保护您的 Fusion 场景。
Workfront 的监控事件模块会根据一个在 Workfront API 中创建事件订阅的 Webhook 来触发场景。 事件订阅是一组数据，用于确定哪些事件会发送至该 Webhook。 例如，如果您设置一个监控问题的监控事件模块，则该事件订阅只会将与问题相关的事件发送过来。
通过使用事件订阅筛选条件，Fusion 用户可以创建更符合其使用场景的事件订阅。 例如，您可以在 Workfront API 中设置事件订阅，使其仅将某个项目下的问题发送到 Webhook，从而确保监控事件模块只会在该项目的问题上触发。 创建更精确的触发条件有助于减少无关触发，从而优化场景设计。
这与在 Workfront Fusion 场景中设置筛选条件不同。 如果未配置事件订阅筛选条件，Webhook 将接收与所选对象类型相关的所有事件。 其中大多数事件与场景无关，因此必须在场景继续执行前进行过滤。
Workfront > “监控事件”筛选条件支持以下运算符：
-
等于
-
不等于
-
大于
-
小于
-
大于或等于
-
小于或等于
-
包含
-
已存在
- 此运算符不需要指定值，因此不会显示“值”字段。
-
不存在
- 此运算符不需要指定值，因此不会显示“值”字段。
-
已更改
- 此运算符不需要指定值，因此不会显示“值”字段。
- 此运算符会忽略“状态”字段。
- 使用
Changed时，请在 记录来源 字段中选择仅更新事件。
使用事件订阅筛选条件进行事件筛选（推荐）
在场景内部筛选事件（不推荐）
有关 Workfront 事件订阅的更多信息，请参阅 FAQs - 事件订阅。
有关 Webhook 的更多信息，请参阅 Adobe Workfront Fusion 中的即时触发器（Webhook）
有关在场景中添加筛选条件的更多信息，请参阅向场景添加筛选条件。
使用高级过滤器
Workfront >关注事件模块提供两种类型的过滤器。
- 简单：此筛选器提供了一个界面，允许您选择字段、运算符和值以及AND和OR运算符来创建筛选器。
- 高级：此筛选器允许您上传代表您的筛选器的JSON。
简单与高级过滤器
这两种类型的主要区别在于过滤器的状态。
- 简单：设置简单筛选器时，您可以选择是要根据字段的旧状态还是新状态进行筛选。 也就是说，您决定是要在字段从 更改给定值 时激活方案，还是要在字段从 更改为 给定值时激活。 通过使用AND和OR，您可以包含多个字段和值，但它们必须共享相同的状态。 您不能对某些字段使用旧状态，对另一些字段不能使用新状态。
- 高级：您可以在高级过滤器中配置JSON，以便在同一过滤器中同时指定新旧状态的值。 例如，您可以指定当项目从“计划”状态移动到“当前”状态时触发方案。 这将排除从“计划”移至“终止”或从“暂挂”移至“当前”的项目。