文档WorkfrontWorkfront 指南

Adobe Workfront 模块

Last update: Thu Apr 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • User

您可以使用 Adobe Workfront Fusion Adobe Workfront 连接器可在以下位置自动执行您的流程： Workfront. 如果您拥有 Workfront Fusion 用于工作自动化和集成 许可证，您还可以用它连接到第三方应用程序和服务。

此 Workfront 连接器不计入您的组织可用的活动应用程序数量。 所有方案，即使它们只使用 Workfront 应用程序，确实计入贵组织的方案总数。

有关您组织的可用应用程序和方案的更多信息，请参阅 组织 在 Adobe Workfront Fusion 组织和团队.

如果您需要有关创建方案的说明，请参阅 在中创建方案 Adobe Workfront Fusion. 有关模块的信息，请参见 中的模块 Adobe Workfront Fusion.

访问要求

您必须具有以下权限才能使用本文中的功能：

Adobe Workfront 计划*
Pro或更高版本
Adobe Workfront 许可证*
计划，工作
Adobe Workfront Fusion 许可证**

当前许可证要求：否 Workfront Fusion 许可证要求。

或

旧版许可证要求： Workfront Fusion 对于工作自动化和集成，Workfront Fusion 工作自动化

产品

当前产品要求：如果您有Select或Prime Adobe Workfront 计划，您的组织必须购买 Adobe Workfront Fusion 以及 Adobe Workfront 以使用本文中描述的功能。 Workfront Fusion 包含在Ultimate中 Workfront 计划。

或

旧版产品要求：您的组织必须购买 Adobe Workfront Fusion 以及 Adobe Workfront 以使用本文中描述的功能。

要了解您拥有的计划、许可证类型或访问权限，请联系贵机构的 Workfront 管理员。

有关的信息 Adobe Workfront Fusion 许可证，请参阅 Adobe Workfront Fusion 许可证.

连接 Workfront 到 Workfront Fusion

此 Workfront 连接器使用OAuth 2.0连接到 Workfront.

您可以创建与 Workfront 直接从 Workfront Fusion 模块。

  1. 在任意Adobe Workfront模块中，单击 添加 ，位于连接字段旁。

  2. 填写以下字段：

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    连接名称 输入新连接的名称。
    环境 选择是连接到生产环境还是非生产环境。
    连接类型 选择您是要连接到服务帐户还是个人帐户。
    客户端ID 输入您的 Workfront 客户端ID。 您可以在Workfront中“设置”区域的“OAuth2应用程序”区域找到此代码。 打开要连接的特定应用程序以查看客户端ID。
    客户端密钥 输入您的 Workfront 客户端ID。 您可以在Workfront中“设置”区域的“OAuth2应用程序”区域找到此代码。 打开要连接的特定应用程序以查看客户端ID。
    身份验证URL

    这可以保留默认值，也可以输入Workfront实例的URL，然后输入 /integrations/oauth2.

    示例： https://mydomain.my.workfront.com/integrations/oauth2
    主机前缀 在大多数情况下，该值应为 origin.

  3. 单击 继续 以保存连接并返回到模块。

NOTE

  • 如果您没有看到SAML登录按钮，则表明贵组织未启用单点登录(SSO)。 您可以使用用户名和密码登录。

    有关SSO的详细信息，请参阅 单点登录概述 Adobe Workfront

  • 到以下对象的OAuth 2.0连接 Workfront API不再依赖API密钥。

Workfront 模块及其字段

配置时 Workfront 模块， Workfront Fusion 显示下面列出的字段。 除此以外，还有 Workfront 字段可能会显示，具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。

如果看到字段或函数上方的映射按钮，则可以使用该按钮设置该字段的变量和函数。 有关更多信息，请参阅 在中将信息从一个模块映射到另一个模块 Adobe Workfront Fusion.

NOTE
如果您在Workfront模块中未看到最新字段，这可能是因为缓存问题。 等待一小时，然后重试。

触发器

观看活动

在Workfront中添加、更新或删除特定类型的对象时，此触发器模块会实时执行场景

该模块会返回与记录关联的任何标准字段，以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

  1. 单击 添加 右侧 Webhook 盒子。

  2. 在中配置webhook 添加挂钩 框。

    配置此模块时，会显示以下字段。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
    Webhook名称 （可选）为webhook键入新名称
    Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
    记录类型 选择类型 Workfront 录制您希望模块观看的内容。
    状态

    选择您要观察旧状态还是新状态。

    • 新状态

      记录更改时触发方案 到 给定值。

      例如，如果状态设置为New State，而过滤器设置为Status Equals In Progress，则webhook会在Status更改为In Progress时触发场景，而不管状态之前是什么。

    • 旧状态

      记录更改时触发方案 从 给定值。

      例如，如果状态设置为Old State，而过滤器设置为Status Equals In Progress，则当Status当前为In Progress的状态更改为其他状态时，webhook会触发一个场景。
    事件过滤器

    您可以设置过滤器，以仅监视符合您选择标准的记录。

    对于每个筛选器，输入希望筛选器计算的字段、运算符以及希望筛选器允许的值。 通过添加AND规则，您可以使用多个过滤器。

    注意：您无法编辑现有过滤器中的过滤器 Workfront 网络挂钩。 要为设置不同的过滤器 Workfront 事件预订，删除当前webhook并创建新预订。

    有关事件过滤器的更多信息，请参阅 中的事件订阅过滤器 Workfront > Watch Events模块 本文章中。
    排除由此连接产生的事件

    启用此选项可排除使用此触发器模块使用的同一连接器创建或更新的事件。 这可以防止场景触发自身，导致其在无休止循环中重复的情况。

    注意 分配记录类型不包括此选项。
    记录源

    选择是否希望观看场景 仅新记录， 仅更新记录， 新记录和更新记录，或 Deleted Records Only.

    注意：如果选择 新记录和更新记录，webhook创建将创建2个事件订阅（针对相同的webhook地址）。

创建webhook后，您可以查看事件所发往的端点地址。

有关更多信息，请参阅部分 事件有效负载示例 在 Workfront 帮助文章 事件订阅API.

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 Workfront 模块.

观察字段

当您指定的字段更新时，此触发器模块会执行场景。 模块会返回您指定的字段的旧值和新值。 您可以在场景的后续模块中映射此信息。

配置此模块时，会显示以下字段。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
记录类型

选择类型 Workfront 录制您希望模块观看的内容。

例如，如果希望每次更新任务中的记录字段时都开始执行方案，请选择Task。
字段 选择您希望模块关注更新的字段。 这些字段反映了 Workfront 管理员已设置跟踪。
输出 选择要包含在此模块的输出捆绑包中的信息。
限制 输入或映射您希望模块在每个方案执行周期内返回的最大记录数。

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 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
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
筛选器 选择是否希望观看场景 仅新记录， 仅更新记录，或 新记录和更新记录.
记录类型

(在您选择 筛选.) 选择类型 Workfront 录制您希望模块观看的内容。

例如，如果您要在每次创建新项目时启动方案，请选择项目
输出 选择要包含在此模块的输出捆绑包中的信息。
可选过滤器 （高级）键入API代码字符串以定义任何其他将细化标准的参数或代码。
限制 输入或映射您希望模块在每个方案执行周期内返回的最大记录数。

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 Workfront 模块.

操作

转换对象

此操作模块进行以下转换之一：

  • 将问题转化为项目
  • 将问题转化为任务
  • 将任务转换为项目
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
对象类型 选择要转换的对象类型。 这是转换之前对象的类型。
转换为 选择要将其转换为的对象。 这是转换后对象的类型。
<object> ID

输入对象的ID。

注意：输入对象的ID时，可以开始键入对象的名称，然后从列表中选择该对象。 然后，模块在字段中输入相应的ID。
模板ID

如果要转换为项目，请选择要用于项目的模板ID。

注意：输入对象的ID时，可以开始键入对象的名称，然后从列表中选择该对象。 然后，模块在字段中输入相应的ID。
自定义表单 选择要添加到新转换的对象中的任何自定义表单，然后输入自定义表单字段的值。
Options 在转换对象时启用所需的任意选项。 选项是否可用取决于您要转换到的对象或从哪个对象转换。
创建记录（附加自定义表单）

此操作模块在中创建对象，如项目、任务或问题 Workfront，并允许您向新对象添加自定义表单。 利用模块，可选择模块中可用的对象字段。

您指定记录的ID。

该模块返回记录ID和任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

例如，您可以使用此模块在中创建一个任务 Workfront 当客户端在 Google Sheets 需要完成的任务的列表。

配置此模块时，会显示以下字段。

确保提供最小数量的输入字段。 例如，如果您要创建问题，则需要在“项目ID”字段中提供有效的父项目ID，以指示问题应存在于Workfront中的位置。 您可以使用映射面板从场景中的其他模块映射此信息，也可以通过键入名称，然后从列表中选择该名称来手动输入该信息。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
记录类型

选择类型 Workfront 您希望模块创建的记录。

例如，如果要创建项目，请从下拉列表中选择项目，并确保您有权访问将填充该项目的数据（来自场景中以前的模块）。
选择要映射的字段

选择可用于数据输入的字段。 这样，您就无需滚动浏览不需要的字段即可使用这些字段。

对于自定义表单中的字段，请使用 附加自定义表单 字段。
附加自定义表单 选择要添加到新对象的任何自定义表单，然后输入这些字段的值。

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 Workfront 模块.

note note
NOTE

  • 输入对象的ID时，可以开始键入对象的名称，然后从列表中选择该对象。 然后，模块在字段中输入相应的ID。

  • 为自定义字段或输入文本时 注意 对象（注释或回复）时，可以在以下位置使用HTML标签： 注释文本 用于创建富文本（如粗体或斜体文本）的字段。

    有关更新中富文本的详细信息，请参阅 向工作项添加更新 在 更新工作.
创建记录

此操作模块可在Workfront中创建对象，如项目、任务或问题。 利用模块，可选择模块中可用的对象字段。

您指定记录的ID。

该模块返回记录ID和任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

例如，您可以使用此模块在中创建一个任务 Workfront 当客户在Google Sheets中添加新行时，需要执行的任务列表。

配置此模块时，会显示以下字段。

确保提供最小数量的输入字段。 例如，如果您要创建问题，则需要在“项目ID”字段中提供有效的父项目ID，以指示问题应存在于Workfront中的位置。 您可以使用映射面板从场景中的其他模块映射此信息，也可以通过键入名称，然后从列表中选择该名称来手动输入该信息。

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
记录类型

选择类型 Workfront 您希望模块创建的记录。

例如，如果要创建项目，请从下拉列表中选择项目，并确保您有权访问将填充该项目的数据（来自场景中以前的模块）。
选择要映射的字段 选择可用于数据输入的字段。 这样，您就无需滚动浏览不需要的字段即可使用这些字段。

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 Workfront 模块.

note note
NOTE

  • 输入对象的ID时，可以开始键入对象的名称，然后从列表中选择该对象。 然后，模块在字段中输入相应的ID。

  • 为自定义字段或输入文本时 注意 对象（注释或回复）时，可以在以下位置使用HTML标签： 注释文本 用于创建富文本（如粗体或斜体文本）的字段。

    有关更新中富文本的详细信息，请参阅 向工作项添加更新 在 更新工作.
自定义API调用

通过此操作模块，您可以对 Workfront API。 这样，您就可以创建另一个无法实现的数据流自动化 Workfront 模块。

模块返回以下信息：

  • 状态代码 （数字）：这表示HTTP请求是成功还是失败。 这些是标准代码，您可以在互联网上查找。

  • 标题 （对象）：与输出正文无关的响应/状态代码的更详细的上下文。 并非响应标头中显示的所有标头都是响应标头，因此某些标头可能对您没什么用。

    响应标头取决于您在配置模块时选择的HTTP请求。

  • 正文 （对象）：根据在配置模块时选择的HTTP请求，您可能会接收回一些数据。 该数据(例如来自GET请求的数据)包含在此对象中。

您可以在场景的后续模块中映射此信息。

配置此模块时，会显示以下字段。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
URL 输入相对路径 https://<WORKFRONT_DOMAIN>/attask/api/<API_VERSION>/.
API版本 选择版本 Workfront 您希望模块使用的API。
方法 选择配置API调用所需的HTTP请求方法。 有关更多信息，请参阅 中的HTTP请求方法 Adobe Workfront Fusion.
Headers

以标准JSON对象的形式添加请求的标头。 这会确定请求的内容类型。

例如， {"Content-type":"application/json"}

注意：如果您收到错误并且难以确定其来源，请考虑根据 Workfront 文档。 如果自定义API调用返回422 HTTP请求错误，请尝试使用 "Content-Type":"text/plain" 标题。
查询字符串

以标准JSON对象的形式添加API调用的查询。

例如： {"name":"something-urgent"}

提示：我们建议您通过JSON正文而不是查询参数发送信息。
Body

以标准JSON对象的形式添加API调用的正文内容。

注意：

使用条件语句(例如 if 在JSON中，将引号放在条件语句之外。

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 Workfront 模块.

删除记录

此操作模块可删除对象，如Workfront中的项目、任务或问题。

您指定记录的ID。

该模块返回记录ID和任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时，会显示以下字段。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
强制删除 启用此选项以确保删除记录，即使 Workfront UI将请求确认删除。
ID

输入唯一值 Workfront 您希望模块删除的记录的ID。

要获取ID，请打开 Workfront 对象，并复制URL末尾处“ID=”后的文本。 例如： https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e
记录类型 选择类型 Workfront 您希望模块删除的记录。

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 Workfront 模块.

note note
NOTE
我们建议采用以下方案配置，以避免因异步操作而无法删除记录。
  1. 同步删除记录。
  2. 将错误处理添加到删除记录模块以忽略由40秒超时导致的错误。
下载文档

此操作模块可从Workfront下载文档。

您指定记录的ID。

该模块返回文档的内容、文件名、文件扩展名和文件大小。 您可以在场景的后续模块中映射此信息。

配置此模块时，会显示以下字段。

table 0-row-2 1-row-2 layout-auto html-authored no-header
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
文档ID

映射或手动输入唯一 Workfront 您希望模块下载的文档的ID。

要获取ID，请打开 Workfront 对象，并复制URL末尾处“ID=”后的文本。 例如： https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 Workfront 模块.

其他操作

通过此操作模块，您可以对API执行操作。

配置此模块时，会显示以下字段。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
记录类型 选择类型 Workfront 您希望模块与之交互的记录。
操作

选择要模块执行的操作。

根据您选择的记录类型和操作，您可能需要填写其他字段。 这两种设置的某些组合可能只需要记录ID，而其他设置(例如的Project 记录类型 和附加模板 操作)需要其他信息（例如对象ID和模板ID）。

有关各个字段的详细信息，请参见 Workfront开发人员文档.

注意：开发人员文档网站仅包含通过API版本14访问的信息，但仍包含适用于API调用的宝贵信息。

  1. 从左侧导航栏中选择 Workfront 开发人员文档页面。 以下类型有自己的页面：

    • 项目

    • 任务

    • Issues

    • 用户

    • 文档

    对于所有其他记录类型，选择 其他对象和端点，并在按字母顺序排序的页面上找到记录类型。

  2. 在相应记录类型的页面上，搜索操作（Ctrl-F或Cmd-F）。

  3. 查看所选操作下可用字段的描述。

注意：

通过创建验证时 Workfront 杂项操作模块，最佳实践是在没有任何高级选项的情况下创建验证，然后使用更新验证 Workfront Proof SOAP API。

有关使用创建验证的更多信息 Workfront API（此模块使用它），请参见 在通过创建验证时添加高级验证选项 Adobe Workfront API
ID

输入或映射唯一的 Workfront 您希望模块与之交互的记录的ID。

要获取ID，请打开 Workfront 对象，并复制URL末尾处“ID=”后的文本。 例如： https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 Workfront 模块.

读取记录

此操作模块从单个记录中检索数据。

您指定记录的ID。 您还可以指定希望模块读取哪些相关记录。

例如，如果模块正在读取的记录是项目，则可以指定希望读取项目的任务。

模块从指定输出的标准字段中返回一个数据数组。

配置此模块时，会显示以下字段。

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
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
记录类型 选择 Workfront 您希望模块读取的对象类型。
输出 选择要包含在此模块的输出捆绑包中的信息。
引用 选择要包含在输出中的任何引用字段。
收藏集 选择要包含在输出中的任何引用字段。
ID

输入唯一值 Workfront 您希望模块读取的记录的ID。

要获取ID，请打开 Workfront 对象，并复制URL末尾处“ID=”后的文本。 例如： https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 Workfront 模块.

更新记录

此操作模块可更新对象，如项目、任务或问题。 利用模块，可选择模块中可用的对象字段。

您指定记录的ID。

模块会返回对象的ID和任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时，会显示以下字段。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
ID

输入唯一值 Workfront 您希望模块更新的记录ID。

要获取ID，请打开 Workfront 对象，并复制URL末尾处“ID=”后的文本。 例如： https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e
Record Type 选择类型 Workfront 记录您希望模块更新的内容。
Select fields to map 选择可用于数据输入的字段。 这样，您就无需滚动浏览不需要的字段即可使用这些字段。

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 Workfront 模块.

note note
NOTE

  • 输入对象的ID时，可以开始键入对象的名称，然后从列表中选择该对象。 然后，模块在字段中输入相应的ID。

  • 为自定义字段或输入文本时 注意 对象（注释或回复）时，可以在以下位置使用HTML标签： 注释文本 用于创建富文本（如粗体或斜体文本）的字段。

    有关更新中富文本的详细信息，请参阅 向工作项添加更新 在 更新工作.
上传文档

此操作模块会将文档上传到 Workfront 对象，例如项目、任务或问题。

您可以指定文档的位置、要上传的文件以及文件的新名称（可选）。

模块会返回文档的ID和任何关联字段，以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时，会显示以下字段。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
相关记录ID 输入唯一值 Workfront 要上载文档的记录ID。
相关记录类型 选择类型 Workfront 记录您希望模块上传文档的位置。
源文件 从上一个模块中选择源文件，或映射源文件的名称和数据。

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 Workfront 模块.

搜索

读取相关记录

此搜索模块读取与指定的搜索查询相匹配的记录（在特定父对象中）。

您可以指定要包含在输出中的字段。 您可以在场景的后续模块中映射此信息。

配置此模块时，会显示以下字段。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
记录类型

选择要读取其关联记录的父记录(Workfront对象)的类型。

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 Workfront 模块 本文章中。
父记录ID

输入或映射要读取其关联记录的父记录的ID。

要获取ID，请打开 Workfront 对象，并复制URL末尾处“ID=”后的文本。 例如： https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e
收藏集 选择或映射您希望模块读取的子记录类型。
输出 选择要包含在此模块的输出捆绑包中的信息。
搜索

此搜索模块查找对象中的记录 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 8-row-2 layout-auto html-authored no-header
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
记录类型 选择类型 Workfront 您希望模块搜索的记录。
结果集 选择一个选项，以指定您希望模块获得符合您的搜索条件的第一个结果还是所有符合该条件的结果。
最大 输入或映射您希望模块在每个方案执行周期内返回的最大记录数。
搜索条件字段 选择要用于搜索条件的字段。 随后，这些字段将显示在搜索条件下拉列表中。
搜索条件

输入搜索依据的字段、要在查询中使用的运算符以及要在字段中搜索的值。

注意：请勿使用 username 在您的搜索条件中。 包括 username 在API查询中 Workfront 将用户记录到Workfront中，搜索将不会成功。

注意： In 和 NotIn使用数组。 输入的格式应为数组。
输出 选择要包含在此模块输出中的字段。
引用 选择要包含在搜索中的任何引用字段。
收藏集 选择要添加到搜索的任何收藏集。
搜索（旧版）

此搜索模块查找对象中的记录 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
Connection 有关连接 Workfront 应用到 Workfront Fusion，请参见 连接 Workfront 到 Workfront Fusion 本文章中。
记录类型 选择类型 Workfront 您希望模块搜索的记录。
结果集 选择一个选项，以指定您希望模块获得符合您的搜索条件的第一个结果还是所有符合该条件的结果。
最大 输入或映射您希望模块在每个方案执行周期内返回的最大记录数。
搜索条件

输入搜索依据的字段、要在查询中使用的运算符以及要在字段中搜索的值。

注意：请勿使用 username 在您的搜索条件中。 包括 username 在API查询中 Workfront 将用户记录到Workfront中，搜索将不会成功。

注意： In 和 NotIn使用数组。 输入的格式应为数组。
输出 选择要包含在此模块输出中的字段。
引用 选择要包含在搜索中的任何引用字段。
收藏集 选择要添加到搜索的任何收藏集。

查看 Workfront 可在其中使用此模块的对象类型 Workfront 对象类型可用于每个 Workfront 模块.

Workfront 对象类型可用于每个 Workfront 模块

每个对象类型可用的对象类型 Workfront 触发器模块
table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 26-row-4 27-row-4 28-row-4 29-row-4 30-row-4 31-row-4 32-row-4 33-row-4 34-row-4 35-row-4 36-row-4 37-row-4 38-row-4 39-row-4 40-row-4 41-row-4 layout-auto
监视记录 监视字段 监视活动
审批流程 ✓ {\f13 }
任务 ✓ {\f13 } ✓ {\f13 }
基线 ✓ {\f13 }
开票记录 ✓ {\f13 }
记帐费率 ✓ {\f13 }
公司 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
仪表板 ✓ {\f13 }
文档 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
文件文件夹 ✓ {\f13 } ✓ {\f13 }
文档请求 ✓ {\f13 }
文档版本 ✓ {\f13 } ✓ {\f13 }
费用 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
费用类型
组 ✓ {\f13 } ✓ {\f13 }
小时 ✓ {\f13 } ✓ {\f13 }
小时数类型 ✓ {\f13 }
问题 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
迭代 ✓ {\f13 } ✓ {\f13 }
工作角色 ✓ {\f13 } ✓ {\f13 }
日志条目 ✓ {\f13 }
里程碑 ✓ {\f13 }
里程碑路径 ✓ {\f13 } ✓ {\f13 }
注释 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
注释标签 ✓ {\f13 }
项目组合 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
项目群 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
项目 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
项目用户 ✓ {\f13 }
校对审批 ✓ {\f13 }
保留时间* ✓ {\f13 }
报告 ✓ {\f13 }
风险
风险类型
步骤审批者 ✓ {\f13 }
任务 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
团队 ✓ {\f13 }
模板 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
模板任务 ✓ {\f13 } ✓ {\f13 }
时间表 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
用户 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
更新
每个对象类型可用的对象类型 Workfront 操作模块
note note
NOTE
此 下载文档 模块未包含在此表中，因为 Workfront 对象类型不是其配置的一部分。
table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8 6-row-8 7-row-8 8-row-8 9-row-8 10-row-8 11-row-8 12-row-8 13-row-8 14-row-8 15-row-8 16-row-8 17-row-8 18-row-8 19-row-8 20-row-8 21-row-8 22-row-8 23-row-8 24-row-8 25-row-8 26-row-8 27-row-8 28-row-8 29-row-8 30-row-8 31-row-8 32-row-8 33-row-8 34-row-8 35-row-8 36-row-8 layout-auto
创建记录 更新记录 删除记录 上传文档 读取记录 自定义API调用 杂项操作
审批流程 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
任务 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
开票记录 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
记帐费率 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
公司 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
文档 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
文件文件夹 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
文档版本 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
费用 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
费用类型 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
组 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
小时 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
小时数类型 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
问题 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
迭代 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
工作角色 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
日志条目 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
里程碑 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
里程碑路径 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
注释 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
注释标签 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
项目组合 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
项目群 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
项目 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
项目用户 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
保留时间* ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
风险 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
风险类型 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
步骤审批者 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
任务 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
团队 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
模板 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
模板任务 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
时间表 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
用户 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
更新 ✓ {\f13 }
每个对象类型可用的对象类型 Workfront 搜索模块
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 10-row-3 11-row-3 12-row-3 13-row-3 14-row-3 15-row-3 16-row-3 17-row-3 18-row-3 19-row-3 20-row-3 21-row-3 22-row-3 23-row-3 24-row-3 25-row-3 26-row-3 27-row-3 28-row-3 29-row-3 30-row-3 31-row-3 32-row-3 33-row-3 34-row-3 35-row-3 36-row-3 layout-auto
搜索 读取相关记录
审批流程 ✓ {\f13 } ✓ {\f13 }
任务 ✓ {\f13 } ✓ {\f13 }
开票记录 ✓ {\f13 }
记帐费率 ✓ {\f13 }
公司 ✓ {\f13 } ✓ {\f13 }
文档 ✓ {\f13 } ✓ {\f13 }
文件文件夹 ✓ {\f13 } ✓ {\f13 }
文档版本 ✓ {\f13 }
费用 ✓ {\f13 }
费用类型 ✓ {\f13 }
组 ✓ {\f13 } ✓ {\f13 }
小时 ✓ {\f13 }
小时数类型 ✓ {\f13 }
问题 ✓ {\f13 } ✓ {\f13 }
迭代 ✓ {\f13 }
工作角色 ✓ {\f13 }
日志条目 ✓ {\f13 }
里程碑 ✓ {\f13 }
里程碑路径 ✓ {\f13 }
注释 ✓ {\f13 }
注释标签 ✓ {\f13 }
项目组合 ✓ {\f13 } ✓ {\f13 }
项目群 ✓ {\f13 }
项目 ✓ {\f13 } ✓ {\f13 }
项目用户 ✓ {\f13 }
保留时间* ✓ {\f13 }
风险 ✓ {\f13 }
风险类型 ✓ {\f13 }
步骤审批者 ✓ {\f13 }
任务 ✓ {\f13 } ✓ {\f13 }
团队 ✓ {\f13 }
模板 ✓ {\f13 }
模板任务 ✓ {\f13 }
时间表 ✓ {\f13 } ✓ {\f13 }
用户 ✓ {\f13 } ✓ {\f13 }
用户委托 ✓ {\f13 }

我们建议您仔细检查，以确保它按您预期的方式运行。

中的事件订阅过滤器 Workfront > 观看活动 模块

NOTE
我们强烈建议您在以下位置使用事件订阅过滤器： 观看活动 模块。

此 Workfront 观看活动 模块根据webhook触发以下场景：在中创建事件订阅 Workfront API。 事件订阅是一组数据，用于确定哪些事件发送到webhook。 例如，如果您设置 观看活动 模块负责监视问题，然后事件订阅仅发送与问题相关的事件。

通过使用事件订阅过滤器，Fusion用户可以创建更适合其用例的事件订阅。 例如，您可以在 Workfront API只将特定项目中的问题发送到webhook，确保 观看活动 模块将仅触发该项目中的问题。 创建更窄触发器的功能通过减少无关触发器的数量而改进了方案设计。

这不同于在中设置过滤器 Workfront Fusion 方案。 如果没有事件订阅过滤器，您的webhook将接收与您选择的对象类型相关的所有事件。 这些事件中的大多数与方案无关，必须先将其过滤掉，方案才能继续。

在Workfront >关注事件过滤器中可以使用以下运算符：

  • 等于

  • 不等于

  • 大于

  • 小于

  • 大于或等于

  • 小于或等于

  • 包含

  • 已存在

    • 此运算符不需要值，并且值字段不存在。

  • 不存在

    • 此运算符不需要值，并且值字段不存在。

  • 已更改

    • 此运算符不需要值，并且值字段不存在。
    • 此运算符忽略状态字段。
    • 使用时 Changed，选择 仅更新了事件 在 记录来源 字段。
IMPORTANT
您无法编辑现有筛选器中的 Workfront 网络挂钩。 要为设置不同的过滤器 Workfront 事件预订，删除当前webhook并创建新预订。
INFO
示例： 考虑一个处理分配给特定用户Ana的新问题的方案。

使用事件订阅过滤器过滤事件（推荐） %E4%BD%BF%E7%94%A8%E4%BA%8B%E4%BB%B6%E8%AE%A2%E9%98%85%E8%BF%87%E6%BB%A4%E5%99%A8%E8%BF%87%E6%BB%A4%E4%BA%8B%E4%BB%B6%EF%BC%88%E6%8E%A8%E8%8D%90%EF%BC%89

使用事件过滤器，您可以设置webhook以在创建问题时将问题分配给Ana时触发场景。 Ana具有userID b378489d8f7cd3cee0539260720a84b7。
如果一天内创建100个问题，但只有两个问题分配给Ana，则该场景将执行两次。

筛选场景中的事件（不推荐） %E7%AD%9B%E9%80%89%E5%9C%BA%E6%99%AF%E4%B8%AD%E7%9A%84%E4%BA%8B%E4%BB%B6%EF%BC%88%E4%B8%8D%E6%8E%A8%E8%8D%90%EF%BC%89

要筛选事件以便仅处理分配给Ana的问题，您可以在 观看活动 模块。
如果一天内创建100个问题，但只有两个问题分配给Ana，则该场景将执行100次。 98个执行将在过滤器处停止，但触发器模块仍在使用数据并对所有执行执行执行操作。

有关活动订阅的详细信息，请参阅 常见问题解答 — 活动订阅.

有关Webhook的更多信息，请参阅 中的即时触发器(Webhook) Adobe Workfront Fusion

有关场景中过滤器的更多信息，请参阅 将筛选器添加到中的方案 Adobe Workfront Fusion.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43