Adobe Workfront模块

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

undefined

您可以使用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 for Work Automation and Integration，Workfront Fusion for Work Automation

产品

当前产品要求：如果您有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 Fusion模块内直接创建与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 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`。

单击继续保存连接并返回模块。

NOTE

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

有关SSO的详细信息，请参阅单点登录概述 Adobe Workfront
到Workfront API的OAuth 2.0连接不再依赖API密钥。

Workfront模块及其字段

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

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

NOTE

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

触发器
操作
搜索

触发器

观看活动

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

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

单击 Webhook 框右侧的添加。

在显示的 添加挂接 框中配置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 Webhook中的筛选器。要为Workfront事件订阅设置不同的筛选器，请删除当前webhook并创建一个新筛选器。有关事件过滤器的详细信息，请参阅本文中Workfront > 监视事件模块中的事件订阅过滤器。
排除由此连接产生的事件	启用此选项可排除使用此触发器模块使用的同一连接器创建或更新的事件。这可以防止场景触发自身，导致其在无休止循环中重复的情况。注意工作分配记录类型不包括此选项。
记录源	选择您希望方案仅观看新记录、仅更新记录、新记录和更新记录还是 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 7-row-2 8-row-2 layout-auto html-authored no-header
Connection	有关将Workfront应用连接到Workfront Fusion的说明，请参阅本文中的将Workfront连接到Workfront Fusion。
对象类型	选择要转换的对象类型。这是转换之前对象的类型。
转换为	选择要将其转换为的对象。这是转换后对象的类型。
<对象> ID	输入对象的ID。注意：输入对象的ID时，可以开始键入对象的名称，然后从列表中选择该对象。然后，模块在字段中输入相应的ID。
模板ID	如果要转换为项目，请选择要用于项目的模板ID。注意：输入对象的ID时，可以开始键入对象的名称，然后从列表中选择该对象。然后，模块在字段中输入相应的ID。
自定义表单	选择要添加到新转换的对象中的任何自定义表单，然后输入自定义表单字段的值。
Options	在转换对象时启用所需的任意选项。选项是否可用取决于您要转换到的对象或从哪个对象转换。
复制本机字段	启用此选项可将任何本地字段从原始对象复制到新对象。
复制自定义表单	启用此选项可将任何本地字段从原始对象复制到新对象。

创建记录（附加自定义表单）

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

您指定记录的ID。

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

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

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

确保提供最小数量的输入字段。例如，如果您要创建问题，则需要在“项目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和任何关联字段，以及连接访问的任何自定义字段和值。您可以在场景的后续模块中映射此信息。

例如，当客户端在Google工作表中添加新行时，您可以使用此模块在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请求。
Body（对象）：根据您在配置模块时选择的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请求方法。有关详细信息，请参阅Adobe Workfront Fusion中的HTTP请求方法。
Headers	以标准JSON对象的形式添加请求的标头。这会确定请求的内容类型。例如， `{"Content-type":"application/json"}` 注意：如果您收到错误并且难以确定其来源，请考虑根据Workfront文档修改标头。如果自定义API调用返回422 HTTP请求错误，请尝试使用`"Content-Type":"text/plain"`标头。
查询字符串	以标准JSON对象的形式添加API调用的查询。例如： `{"name":"something-urgent"}` 提示：我们建议您通过JSON正文而不是查询参数发送信息。
Body	以标准JSON对象的形式添加API调用的正文内容。注意：在JSON中使用条件语句（如`if`）时，请将引号放在条件语句之外。

查看可在每个 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对象，并在“ID=”之后复制URL末尾的文本。例如：https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e
记录类型	选择要模块删除的Workfront记录的类型。

查看可在每个 Workfront 模块🔗可用的Workfront 对象类型中使用此模块的Workfront对象类型列表。

note note
NOTE
我们建议采用以下方案配置，以避免因异步操作而无法删除记录。
同步删除记录。将错误处理添加到删除记录模块以忽略由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对象，并在“ID=”之后复制URL末尾的文本。例如：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调用使用的有用信息。从Workfront开发人员文档页面的左侧导航中选择记录类型。以下类型有自己的页面：项目任务 Issues 用户文档对于所有其他记录类型，请选择 Other objects and endpoints，然后在按字母顺序排序的页面上查找该记录类型。在相应记录类型的页面上，搜索操作（Ctrl-F或Cmd-F）。查看所选操作下可用字段的描述。注意：通过Workfront 杂项操作模块创建验证时，最佳实践是创建不包含任何高级选项的验证，然后使用Workfront Proof SOAP API更新验证。有关使用Workfront API（此模块使用）创建验证的更多信息，请参阅通过Adobe Workfront API创建验证时添加高级验证选项
ID	输入或映射您希望模块与之交互的记录的唯一Workfront ID。要获取ID，请在浏览器中打开Workfront对象，并在“ID=”之后复制URL末尾的文本。例如：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对象，并在“ID=”之后复制URL末尾的文本。例如：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对象，并在“ID=”之后复制URL末尾的文本。例如：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记录类型。
Source file	从上一个模块中选择源文件，或映射源文件的名称和数据。

查看可在每个 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对象，并在“ID=”之后复制URL末尾的文本。例如：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` 。在对Workfront的API查询中包含`username` 会将用户记录到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` 。在对Workfront的API查询中包含`username` 会将用户记录到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 37-row-8 38-row-8 39-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 }	✓ {\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，从而确保Watch Events模块将仅触发该项目中的问题。创建更窄触发器的功能通过减少无关触发器的数量而改进了方案设计。

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

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

等于
不等于
大于
小于
大于或等于
小于或等于
包含
已存在
- 此运算符不需要值，并且值字段不存在。
不存在
- 此运算符不需要值，并且值字段不存在。
已更改
- 此运算符不需要值，并且值字段不存在。
- 此运算符忽略状态字段。
- 使用Changed时，在 记录来源 字段中选择 仅更新事件。

IMPORTANT

无法在现有Workfront Webhook中编辑筛选器。要为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的详细信息，请参阅 Adobe Workfront Fusion🔗中的即时触发器(Webhook)

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

recommendation-more-help

5f00cc6b-2202-40d6-bcd0-3ee0c2316b43