Adobe Workfront模块

您可以使用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帐户的连接。

  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

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

  • 要创建与Workfront沙盒环境的连接,您必须在该环境中创建一个OAuth2应用程序,然后在您的连接中使用由该应用程序生成的客户端ID和客户端密钥。

    有关在Workfront中创建OAuth2应用程序的说明,请参阅为Workfront集成创建OAuth2应用程序一文中的使用用户凭据创建OAuth2应用程序(授权代码流)

Workfront模块及其字段

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

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

NOTE
  • 如果您在Workfront模块中未看到最新字段,这可能是因为缓存问题。 等待一小时,然后重试。
  • 来自Adobe Workfront的HTTP 429状态代码不应导致停用,而是会在场景中触发短暂的执行暂停。

触发器

观看活动

在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 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对象类型列表。

操作

转换对象

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

  • 将问题转化为项目
  • 将问题转化为任务
  • 将任务转换为项目
note note
NOTE
自2024年7月起,转化对象时可包含自定义表单。
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中创建一项任务,该列表包含需要完成的任务。

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

确保提供最小数量的输入字段。 例如,如果您要创建问题,则需要在“项目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请求。

  • 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
我们建议采用以下方案配置,以避免因异步操作而无法删除记录。
  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对象,并在“ID=”之后复制URL末尾的文本。 例如:https://my.workfront.com/project/view?ID=5e43010c03286a2a555e1d0a75d6a86e

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

其他操作

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

note note
NOTE
自2024年7月起,convertToProject操作包括字段copyCategories。 当设置为TRUE时,所有自定义表单都将包含在问题所转换到的项目中。

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

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

    • 用户

    • 文档

    对于所有其他记录类型,请选择 Other objects and endpoints,然后在按字母顺序排序的页面上查找该记录类型。

  2. 在相应记录类型的页面上,搜索操作(Ctrl-F或Cmd-F)。

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

注意:

通过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对象类型列表。

其他操作选项

任务
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
操作 选项
复制
  • clearApprovers

  • clearAssignations

  • clearConstraints

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    清除财务数据

  • clearpermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    清除提醒通知

移动
  • clearApprovers

  • clearAssignations

  • clearDocuments

  • clearConstraints

  • clearExpenses

  • clearFinancials

    清除财务数据

  • clearpermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    清除提醒通知

问题
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored
操作 选项
复制
  • clearApprovers
  • clearAssignations
  • clearCustomData
  • clearDocuments
  • clearpermissions
  • clearProgress
转换为任务
  • preserveIssue

    保留原来的问题,并将其解决方案与此任务绑定

  • preservePrimaryContact

    允许问题的主要联系人访问此任务

  • preserveCompletionDate

    保留问题的计划完成日期

转换至项目
  • preserveIssue

    保留原来的问题,并将其解决方案与此任务绑定

  • preservePrimaryContact

    允许问题的主要联系人访问此任务

项目
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
操作 选项
复制
  • clearApprovers

  • clearAssignations

  • clearCustomData

  • clearDocuments

  • clearExpenses

  • clearFinancials

    清除财务数据

  • clearpermissions

  • clearPredecessors

  • clearProgress

  • clearTimedNotifications

    清除提醒通知

附加模板/另存为模板
  • clearApprovers

  • clearAssignations

  • clearBillingRates

  • clearConstraints

  • clearDeliverable

    清除目标

  • clearDocuments

  • clearExpenses

  • clearFinancials

    清除财务数据

  • clearHourTypes

  • Clearisssetup

    清除队列属性和问题设置

  • clearPredecessors

  • clearrisks

  • clearSharingOptions

  • clearTimedNotifications

    清除提醒通知

读取记录

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

您指定记录的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对象,如项目、任务或问题。 此模块会以块形式上传文档,从而使Workfront的上传过程更加顺畅。

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

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

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

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
相关记录ID 输入要上载文档的记录的唯一Workfront ID。
相关记录类型 选择您希望模块上传文档的Workfront记录类型。
文件夹ID 根据相关记录的类型,您可能需要输入或映射文件夹ID。
Source file 从上一个模块中选择源文件,或映射源文件的名称和数据。

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

上载文档(旧版)

此操作模块将文档上传到Workfront对象,如项目、任务或问题。 它一次上载整个文档。

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

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

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

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
相关记录ID 输入要上载文档的记录的唯一Workfront ID。
相关记录类型 选择您希望模块上传文档的Workfront记录类型。
文件夹ID 根据相关记录的类型,您可能需要输入或映射文件夹ID。
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中,搜索将不会成功。

注意: InNotIn使用数组。 输入的格式应为数组。

输出 选择要包含在此模块输出中的字段。
引用 选择要包含在搜索中的任何引用字段。
收藏集 选择要添加到搜索的任何收藏集。
搜索(旧版)

此搜索模块在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中,搜索将不会成功。

注意: InNotIn使用数组。 输入的格式应为数组。

输出 选择要包含在此模块输出中的字段。
引用 选择要包含在搜索中的任何引用字段。
收藏集 选择要添加到搜索的任何收藏集。

查看可在每个 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