Adobe Workfront模块

您可以使用Adobe Workfront Fusion Adobe Workfront连接器在Workfront中自动执行流程。 您还可以将Workfront连接到其他应用程序和服务。

有关创建方案的说明,请参阅创建方案:文章索引下的文章。 有关模块的信息,请参阅模块:文章索引下的文章。

访问要求

展开以查看本文中各项功能的访问要求。

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

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront包 任何
Adobe Workfront许可证

新增:标准

当前:工作或更高

Adobe Workfront Fusion许可证**

当前:无Workfront Fusion许可证要求。

旧版:任意

产品

新增:

  • 选择或Prime Workfront包:您的组织必须购买Adobe Workfront Fusion。
  • Ultimate Workfront包:其中包含Workfront Fusion。

当前:您的组织必须购买Adobe Workfront Fusion。

有关此表中信息的更多详细信息,请参阅文档🔗中的访问要求。

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

note note
NOTE
  • 如果您的组织使用旧版许可包(基于连接器),则必须具有Workfront Fusion for Work Automation and Integration许可证才能连接到第三方应用程序和服务。 Workfront连接器不会计入您的组织可用的活动应用程序数量。 所有方案,即使它们仅使用Workfront应用程序,也会计入贵组织的方案总数。

将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
    Connection name 输入新连接的名称。
    Environment 选择是连接到生产环境还是非生产环境。
    Connection type 选择您是要连接到服务帐户还是个人帐户。
    Client ID 输入您的Workfront客户端ID。 您可以在Workfront中“设置”区域的“OAuth2应用程序”区域找到此代码。 打开要连接的特定应用程序以查看客户端ID。
    Client Secret 输入您的Workfront客户端ID。 您可以在Workfront中“设置”区域的“OAuth2应用程序”区域找到此代码。 如果您的Workfront中的OAuth2应用程序没有客户端密钥,则可以生成另一个密钥。 有关说明,请参阅Workfront文档。
    Authentication URL

    此值可保留为默认值,也可以输入Workfront实例的URL,后跟/integrations/oauth2

    示例: https://mydomain.my.workfront.com/integrations/oauth2

    Host prefix 在大多数情况下,此值应为origin
  3. 单击​ Continue ​保存连接并返回模块。

    如果您未登录Workfront,则会引导您进入登录屏幕。 登录后,您可以允许连接。

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

Workfront模块及其字段

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

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

映射切换

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

触发器

Watch Events

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

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

  1. 单击​ Webhook ​框右侧的​ Add

  2. 在显示的​ Add a hook ​框中配置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 name 输入webhook的名称
    Connection 有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的将Workfront连接到Workfront Fusion
    Record Type 选择要模块观看的Workfront记录类型。
    State

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

    • New state

      当记录将 更改为 给定值时触发方案。

      例如,如果状态设置为New State并且过滤器设置为Status Equals In Progress,则webhook会在Status更改为In Progress时触发方案,而不管之前处于什么状态。

    • Old state

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

      例如,如果状态设置为Old State并且过滤器设置为Status Equals In Progress,则当当前为In Progress的Status更改为其他状态时,webhook将触发方案。

    Events filters

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

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

    注意:您无法编辑现有Workfront Webhook中的筛选器。 要为Workfront活动订阅设置其他筛选器,请删除当前webhook并创建一个新筛选器。

    有关事件过滤器的详细信息,请参阅本文中的Workfront > Watch Events模块中的事件订阅过滤器

    排除由此连接产生的事件

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

    注意: Assignment记录类型不包括此选项。

    Record Origin

    选择您希望方案观看New Records Only、Updated Records Only、New and Updated Records还是Deleted Records Only。

    注意:如果选择New and Updated Records,webhook创建将创建2个事件订阅(对于同一webhook地址)。

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

有关详细信息,请参阅Workfront文档事件订阅API一文中的事件负载示例部分。

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

Watch Field

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

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

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
Record Type

选择要模块观看的Workfront记录类型。

例如,如果希望每次更新任务中的记录字段时都开始执行方案,请选择Task。

Field 选择您希望模块关注更新的字段。 这些字段反映了Workfront管理员为跟踪而设置的字段。
Outputs 选择要包含在此模块的输出捆绑包中的对象字段。
Limit 输入或映射您希望模块在每个方案执行周期内返回的最大记录数。

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

Watch Record

此触发器模块执行特定类型的对象添加、更新或同时添加和更新的方案。 该模块返回与一个或多个记录关联的所有标准字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

在输出中,模块指示每个记录是新的还是更新的。

自上次运行场景以来添加和更新的记录将作为新记录返回。

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

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
Filter 选择您希望方案观看New Records Only、Updated Records Only还是New and Updated Records。
Record Type

选择要模块观看的Workfront记录类型。

例如,如果要在每次创建新项目时启动方案,请选择 Project

Outputs 选择要包含在此模块的输出捆绑包中的字段。
Reference 选择要包含在此模块的输出捆绑包中的引用字段。
Outputs 选择要包含在此模块的输出捆绑包中的集合字段。
Optional Filter (高级)键入API代码字符串以定义任何其他将细化标准的参数或代码。
Limit 输入或映射您希望模块在每个方案执行周期内返回的最大记录数。

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

操作

Convert object

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

  • 将问题转化为项目
  • 将问题转化为任务
  • 将任务转换为项目
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
Object type 选择要转换的对象类型。 这是转换之前对象的类型。
Convert to 选择要将其转换为的对象。 这是转换后对象的类型。
<Object> ID

输入对象的ID。

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

Template ID

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

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

Custom forms 选择要添加到新转换的对象中的任何自定义表单,然后输入自定义表单字段的值。
Options 在转换对象时启用所需的任意选项。 选项是否可用取决于您要转换到的对象或从哪个对象转换。
Copy native fields 启用此选项可将任何本地字段从原始对象复制到新对象。
Copy custom forms 启用此选项可将任何本地字段从原始对象复制到新对象。
Create a record (attaching custom forms)

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

您指定记录的ID。

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

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

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

例如,如果要创建项目,请从下拉列表中选择Project。

Select fields to map

选择可用于数据输入的字段。 这样,您就无需滚动浏览不需要的字段即可使用这些字段。 然后,您可以在这些字段中输入或映射数据。

对于自定义表单中的字段,请使用 Attach Custom Form 字段。

Attach Custom Form 选择要添加到新对象的任何自定义表单,然后输入或映射这些字段的值。

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

note note
NOTE
  • 输入对象的ID时,可以开始键入对象的名称,然后从列表中选择该对象。 然后,模块在字段中输入相应的ID。
  • 为自定义字段或Note对象(注释或回复)输入文本时,您可以使用Note Text字段中的HTML标签创建富文本,如粗体或斜体文本。
Create Record

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

您指定记录的ID。

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

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

创建对象时,此模块不附加自定义表单。 要在创建对象时附加自定义表单,请使用Create a record (attaching custom forms)模块。

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

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
Connection 有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的将Workfront连接到Workfront Fusion
Record Type

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

例如,如果要创建项目,请从下拉列表中选择Project。

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

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

note note
NOTE
  • 输入对象的ID时,可以开始键入对象的名称,然后从列表中选择该对象。 然后,模块在字段中输入相应的ID。
  • 为自定义字段或Note对象(注释或回复)输入文本时,您可以使用Note Text字段中的HTML标签创建富文本,如粗体或斜体文本。
Custom API Call

通过此操作模块,您可以对Workfront API进行经过身份验证的自定义调用。 这样,您可以创建其他Workfront模块无法实现的数据流自动化。

模块返回以下信息:

  • Status Code (数字):这表示HTTP请求是成功还是失败。 这些是标准代码,您可以在互联网上查找。

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

    响应标头取决于您在配置模块时选择的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 Version 选择您希望模块使用的Workfront API的版本。
Method 选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅Adobe Workfront Fusion中的HTTP请求方法
Headers

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

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

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

Query String

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

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

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

Body

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

注意:

在JSON中使用条件语句(如if)时,请将引号放在条件语句之外。

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

Delete Record

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

您指定记录的ID。

该模块返回记录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
Force delete 启用此选项以确保删除记录,即使Workfront UI会请求确认删除。
Async delete 启用此选项以允许异步删除模块。
ID

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

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

Record Type 选择要让模块删除的Workfront记录类型。

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

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

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

您指定记录的ID。

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

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

table 0-row-2 1-row-2 layout-auto html-authored no-header
Connection 有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的将Workfront连接到Workfront Fusion
Document ID

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

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

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

Misc Action

通过此操作模块,您可以对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
Record Type 选择您希望模块与之交互的Workfront记录类型。
Action

选择要模块执行的操作。

您可能需要填写其他字段,具体取决于您选择的Record Type和Action。 这两个设置的某些组合可能只需要记录ID,而其他设置(如 Record Type 的Project和 Action 的Attach Template)需要其他信息(如对象ID和模板ID)。

有关某些操作可用的选项,请参阅本文中的其他操作选项

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

注意:开发人员文档网站仅包含通过API版本14传递的信息,但仍包含可供API调用使用的有用信息。

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

    • Projects

    • Tasks

    • Issues

    • Users

    • Documents

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

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

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

注意:

通过Workfront Misc Action模块创建验证时,最佳实践是在没有任何高级选项的情况下创建验证,然后使用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对象类型列表。

其他操作选项

任务
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

    清除提醒通知

Read a Record

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

您指定记录的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
Record Type 选择要让模块读取的Workfront对象类型。
Outputs 选择要包含在此模块的输出捆绑包中的信息。
References 选择要包含在输出中的任何引用字段。
Collections 选择要包含在输出中的任何引用字段。
ID

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

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

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

Update Record

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

您指定记录的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。
  • 为自定义字段或Note对象(注释或回复)输入文本时,您可以使用Note Text字段中的HTML标签创建富文本,如粗体或斜体文本。
Upload Document

此操作模块可将文档上传到Workfront对象,如项目、任务或问题。 此模块会以块形式上传文档,从而使Workfront的上传过程更加顺畅。

此模块可以处理比旧版模块更大的文件,是使用Ultimate 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
Related Record ID 输入要将文档上传到的记录的唯一Workfront ID。
Related Record Type 选择您希望模块上传文档的Workfront记录类型。
Folder ID 根据相关记录的类型,您可能需要输入或映射文件夹ID。
Source file 从上一个模块中选择源文件,或映射源文件的名称和数据。

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

Upload Document (Legacy)

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

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

搜索

Read Related Records

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

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

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

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
Record Type

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

请参阅本文中每个Workfront模块可用的Workfront对象类型中,可使用此模块的Workfront对象类型列表。

Parent Record ID

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

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

Collections 选择或映射您希望模块读取的子记录类型。
Outputs 选择要包含在此模块的输出捆绑包中的信息。
Search

此搜索模块在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
Record Type 选择要模块搜索的Workfront记录类型。
Result Set 选择一个选项,以指定您希望模块获得符合您的搜索条件的第一个结果还是所有符合该条件的结果。
Maximal 输入或映射您希望模块在每个方案执行周期内返回的最大记录数。
Search criteria fields 选择要用于搜索条件的字段。 随后,这些字段将显示在搜索条件下拉列表中。
Search criteria

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

注意:请勿在您的搜索条件中使用username 。 若在Workfront的API查询中包含username ,则会将用户记录到Workfront中,搜索将不会成功。

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

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

适用于每个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
Watch Record Watch Field Watch Events
审批流程 ✓ {\f13 }
任务分配 ✓ {\f13 } ✓ {\f13 }
基线 ✓ {\f13 }
账单记录 ✓ {\f13 }
记帐费率 ✓ {\f13 }
公司 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
仪表板 ✓ {\f13 }
文档 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
文档文件夹 ✓ {\f13 } ✓ {\f13 }
文档请求 ✓ {\f13 }
文档版本 ✓ {\f13 } ✓ {\f13 }
费用 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
费用类型
✓ {\f13 } ✓ {\f13 }
小时 ✓ {\f13 } ✓ {\f13 }
小时数类型 ✓ {\f13 }
问题 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
开发周期 ✓ {\f13 } ✓ {\f13 }
工作角色 ✓ {\f13 } ✓ {\f13 }
日志条目 ✓ {\f13 }
里程碑 ✓ {\f13 }
里程碑路径 ✓ {\f13 } ✓ {\f13 }
注释 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
注释标签 ✓ {\f13 }
项目组合 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
项目群 ✓ {\f13 } ✓ {\f13 } ✓ {\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
Download Document模块未包含在此表中,因为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
Create a record Update a record Delete a record Upload Document Read a record Custom API Call Misc Action
审批流程 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
任务分配 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
基线 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
账单记录 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
记帐费率 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
公司 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
文档 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
文档文件夹 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
文档版本 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
汇率 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
费用 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
费用类型 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
外部文档 ✓ {\f13 }
✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
小时 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
小时数类型 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
问题 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
开发周期 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
工作角色 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
日志条目 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
里程碑 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
里程碑路径 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
注释 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
注释标签 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
项目组合 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
项目群 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
项目 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
项目用户 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
保留时间* ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
风险 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
风险类型 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
步骤审批者 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
任务 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
团队 ✓ {\f13 } ✓ {\f13 } ✓ {\f13 } ✓ {\f13 }
模板 ✓ {\f13 } ✓ {\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
Search Read Related Records
审批流程 ✓ {\f13 } ✓ {\f13 }
任务分配 ✓ {\f13 } ✓ {\f13 }
账单记录 ✓ {\f13 }
记帐费率 ✓ {\f13 }
公司 ✓ {\f13 } ✓ {\f13 }
文档 ✓ {\f13 } ✓ {\f13 }
文档文件夹 ✓ {\f13 } ✓ {\f13 }
文档版本 ✓ {\f13 }
费用 ✓ {\f13 }
费用类型 ✓ {\f13 }
✓ {\f13 } ✓ {\f13 }
小时 ✓ {\f13 }
小时数类型 ✓ {\f13 }
问题 ✓ {\f13 } ✓ {\f13 }
开发周期 ✓ {\f13 }
工作角色 ✓ {\f13 }
日志条目 ✓ {\f13 }
里程碑 ✓ {\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 > Watch Events模块中的事件订阅筛选器

NOTE
我们强烈建议在您的Watch Events模块中使用事件订阅过滤器。

Workfront Watch Events模块根据在Workfront API中创建事件订阅的webhook触发方案。 事件订阅是一组数据,用于确定哪些事件发送到webhook。 例如,如果您设置了Watch Events模块来监视问题,则事件订阅仅发送与问题相关的事件。

通过使用事件订阅过滤器,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的问题,您可以在Watch Events模块之后创建筛选器。
如果一天内创建100个问题,但只有两个问题分配给Ana,则该场景将执行100次。 98个执行将在过滤器处停止,但触发器模块仍在使用数据并对所有执行执行执行操作。

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

有关Webhook的详细信息,请参阅Adobe Workfront Fusion中的即时触发器(Webhook)

有关场景中过滤器的详细信息,请参阅将过滤器添加到场景

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3