Adobe Workfront 模块

任意 Adobe Workfront Workflow 包以及任意 Adobe Workfront 自动化和集成包

Workfront Ultimate

Workfront Prime 和 Select 包，且需额外购买 Workfront Fusion。

标准

工作版或更高版本

Workfront 连接器使用 OAuth 2.0 与 Workfront 建立连接。

您可以在 Workfront Fusion 模块内直接创建到您 Workfront 帐户的连接。

• 使用客户端 ID 和客户端密钥连接到 Workfront
• 使用服务器到服务器连接方式连接到 Workfront

使用客户端 ID 和客户端密钥连接到 Workfront

1. 在任意 Adobe Workfront 模块中，点击“连接”字段旁的​添加。

2. 填写以下字段：

   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。

3. 点击​ 继续 ​保存连接并返回模块。

   如果您尚未登录 Workfront，系统会将您引导至登录界面。登录后，您即可允许该连接。

使用服务器到服务器连接方式连接到 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 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。

3. 点击​ 继续 ​保存连接并返回模块。

   如果您尚未登录 Workfront，系统会将您引导至登录界面。登录后，您即可允许该连接。

Workfront 模块及其字段

在您配置 Workfront 模块时，Workfront Fusion 会显示以下字段。除这些字段外，根据您的应用程序或服务访问权限级别，可能会显示更多 Workfront 字段。模块中的加粗标题表示必填字段。

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

• 触发器
• 操作
• 搜索

触发器

选择您希望该模块监控的 Workfront 记录类型。

例如，如果您希望每次在任务的记录字段更新时开始执行场景，请选择 Task。

选择您希望该模块监控的 Workfront 记录类型。

例如，如果您希望在每次创建新项目时启动该场景，请选择 Project。

输入对象的 ID。

注意：输入对象 ID 时，您可以先输入对象名称，然后从列表中选择。然后，模块会自动将相应的 ID 填入字段。

如果您正在转化为项目，请选择要用于该项目的模板 ID。

注意：输入对象 ID 时，您可以先输入对象名称，然后从列表中选择。然后，模块会自动将相应的 ID 填入字段。

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

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

选择您希望用于数据输入的字段。这样您无需浏览不需要的字段，就能直接使用这些字段。随后您可以向这些字段输入或映射数据。

对于自定义表单中的字段，请使用 附上自定义表单 字段。

• 输入对象 ID 时，您可以先输入对象名称，然后从列表中选择。然后，模块会自动将相应的 ID 填入字段。
• 在为自定义字段或注释对象（评论或回复）输入文本时，您可以在注释文本字段中使用 HTML 标记来创建富文本，例如粗体或斜体。

• 解决单个用户

  code language-none
  您可以在“用户”列表中解决单个用户。

• 解决批量新增的用户

  要解决批量新增用户的问题，您可以直接将这批用户添加到 Adobe Admin Console 中。

  有关操作说明，请参阅 Adobe 文档中的管理多个用户 | 批量上传 CSV。

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

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

注意：如果出现错误且难以确定来源，请根据 Workfront 文档修改请求标头。如果您的自定义 API 调用返回 422 HTTP 请求错误，请尝试使用 "Content-Type":"text/plain" 标头。

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

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

提示：建议通过 JSON 正文传递信息，而不是作为查询参数。

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

注意：

在 JSON 中使用 if 等条件语句时，需将引号置于条件语句外部。

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

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

1. 同步删除记录。
2. 在“删除记录”模块中添加错误处理规则，以忽略因 40 秒超时导致的错误。

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

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

选择您希望该模块执行的操作。

根据您选择的记录类型和操作，可能需要填写其他字段。某些设置组合可能仅需提供记录 ID，而其他组合（例如将 记录类型 设为“项目”，将 操作 设为附加模板）则需要额外信息（例如对象 ID 和模板 ID）。

若要查看某些操作可用的选项，请参阅本文中的其他操作选项。

有关各字段的详细说明，请参阅 Workfront 开发人员文档。

注意：开发人员文档网站仅涵盖至 API 版本 14，但其中内容仍对 API 调用具有参考价值。

1. 在 Workfront 开发人员文档页面中，从左侧导航中选择记录类型。以下类型各自拥有独立的页面：

   • 项目

   • 任务

   • 问题

   • 用户

   • 文档

   对于其他记录类型，选择其他对象和端点，并在按字母顺序排列的页面中查找相应的记录类型。

2. 在相应记录类型的页面中，使用搜索功能（Ctrl-F 或 Cmd-F）查找所需的操作。

3. 查看所选操作下可用字段的说明。

注意：

通过 Workfront 其他操作模块创建校样时，最佳做法是先创建一个不带任何高级选项的校样，然后再使用 Workfront Proof SOAP API 更新校样。

如需了解使用 Workfront API（此模块所使用的 API）创建校样的更多信息，请参阅通过 Adobe Workfront API 创建校样时添加高级校对选项。

输入或映射该模块要交互的记录的唯一 Workfront ID。

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

• clearApprovers

• clearAssignments

• clearConstraints

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  清除财务数据

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  清除提醒通知

• clearApprovers

• clearAssignments

• clearDocuments

• clearConstraints

• clearExpenses

• clearFinancials

  清除财务数据

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  清除提醒通知

• clearApprovers
• clearAssignments
• clearCustomData
• clearDocuments
• clearPermissions
• clearProgress

• preserveIssue

  保持原有问题，并将其解决方案关联到此任务

• preservePrimaryContact

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

• preserveCompletionDate

  保留问题的规划完成日期

• preserveIssue

  保持原有问题，并将其解决方案关联到此任务

• preservePrimaryContact

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

• clearApprovers

• clearAssignments

• clearCustomData

• clearDocuments

• clearExpenses

• clearFinancials

  清除财务数据

• clearPermissions

• clearPredecessors

• clearProgress

• clearTimedNotifications

  清除提醒通知

• clearApprovers

• clearAssignments

• clearBillingRates

• clearConstraints

• clearDeliverables

  清除目标

• clearDocuments

• clearExpenses

• clearFinancials

  清除财务数据

• clearHourTypes

• clearIssueSetup

  清除队列属性和问题设置

• clearPredecessors

• clearRisks

• clearSharingOptions

• clearTimedNotifications

  清除提醒通知

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

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

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

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

选择要为新记录提供字段值的自定义表单。选择表单后，为该表单中的字段输入数据。

若要为此模块中附加的表单提供字段值，请在要映射的字段区域中包含自定义表单 ID。

选择您要读取其关联记录的父记录类型（Workfront 对象）。

有关可与此模块一起使用的 Workfront 对象类型列表，请参阅本文中的每个 Workfront 模块可用的 Workfront 对象类型。

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

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

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

注意：请勿在搜索条件中使用 username 。 在对 Workfront 的 API 查询中包含 username 会导致用户登录到 Workfront，从而无法成功搜索。

注意：In 和 NotIn 适用于数组。输入必须使用数组格式。

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

注意：请勿在搜索条件中使用 username 。 在对 Workfront 的 API 查询中包含 username 会导致用户登录到 Workfront，从而无法成功搜索。

注意：In 和 NotIn 适用于数组。输入必须使用数组格式。