Adobe Workfront Planning 模块
通过Adobe Workfront Planning模块，您可以在Workfront Planning中发生事件时触发方案。 您还可以创建、读取、更新和删除记录，或者对您的Adobe Workfront Planning帐户执行自定义API调用。
访问权限要求
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront 包 |
任意 Adobe Workfront Workflow 包以及任意 Adobe Workfront 自动化和集成包 Workfront Ultimate Workfront Prime 和 Select 包，且需额外购买 Workfront Fusion。 |
| Adobe Workfront 许可证 |
标准 工作版或更高版本 |
| 产品 | 如果您的组织使用的 Workfront Select 或 Prime 包不包含 Workfront 自动化和集成，则必须单独购买 Adobe Workfront Fusion。 |
有关此表中信息的更多详细说明，请参阅文档中的访问权限要求。
s##先决条件
要访问Workfront Planning，您必须具备以下条件：
- 新的Workfront包和许可证。 Workfront Planning不适用于旧版Workfront包或许可证。
- Workfront计划包。
- 您组织的Workfront实例必须载入到Adobe Unified Experience。
Adobe Workfront规划API信息
Adobe Workfront Planning连接器使用以下对象：
将Workfront Planning连接到Workfront Fusion
Workfront Planning连接器使用OAuth 2.0连接到Workfront Planning。
可直接从Workfront Planning Fusion模块内部创建与Workfront Planning帐户的连接。
使用客户端ID和客户端密钥连接到Workfront Planning
-
在任意Adobe 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 连接类型 选择 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。 -
点击 继续 保存连接并返回模块。
如果您未登录Workfront Planning，则会引导您进入登录屏幕。 登录后，您即可允许该连接。
- 通过 OAuth 2.0 连接到 Workfront API 不再依赖 API 密钥。
- 要连接到 Workfront 沙盒环境，您必须在该环境中创建 OAuth2 应用程序，然后使用该应用程序生成的客户端 ID 和客户端密钥建立连接。
使用服务器到服务器连接连接到Workfront Planning
-
在任意Adobe 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 连接类型 选择 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。 -
点击 继续 保存连接并返回模块。
如果您未登录Workfront Planning，则会引导您进入登录屏幕。 登录后，您即可允许该连接。
- 通过 OAuth 2.0 连接到 Workfront API 不再依赖 API 密钥。
- 要连接到 Workfront 沙盒环境，您必须在该环境中创建 OAuth2 应用程序，然后使用该应用程序生成的客户端 ID 和客户端密钥建立连接。
Adobe Workfront Planning 模块及其字段
在您配置 Workfront 模块时，Workfront Fusion 会显示以下字段。除这些字段外，根据您的应用程序或服务访问权限级别，可能会显示更多 Workfront 字段。模块中的加粗标题表示必填字段。
如果您看到字段或功能上方的映射按钮，可使用它为该字段设置变量和函数。有关详细信息，请参阅将信息从一个模块映射到另一个模块。
触发器
观看活动
在Workfront Planning中创建、更新或删除记录、记录类型或工作区时，此触发器模块将启动一个方案。
操作
删除记录类型
此操作模块通过ID删除Workfront Planning中的单个记录类型。
发起自定义 API 调用
此模块对Adobe Workfront Planning API进行自定义API调用。
https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/以标准 JSON 对象的形式添加请求标头。
例如， {"Content-type":"application/json"}
Workfront Fusion 会自动添加授权标头。
以标准 JSON 对象的形式添加 API 调用的正文内容。
注意：
在 JSON 中使用 if 等条件语句时，需将引号置于条件语句外部。
搜索
搜索记录
此操作模块根据您指定的条件检索记录列表。
未分类
创建记录
此操作在Workfront Planning中创建单个记录。
删除记录
此操作模块删除Workfront Planning中的指定记录。
获取记录
此操作模块从其ID指定的Adobe Workfront Planning中检索单个记录。
按记录类型获取记录
此操作模块检索指定类型的所有记录。
获取记录类型
此操作模块检索Adobe Workfront Planning帐户中的记录类型列表。
更新记录
此操作更新Workfront Planning中的单个记录。
将JSONata用于可读的record-types划分
以下JSONata表达式创建了Planning查询的可读输出，该输出为您提供了记录类型划分。 这使记录类型名称、字段名称和字段选项名称（如果适用）可由名称读取，并保持结构的其余部分不变。
(
$s0 := ({"data":$ ~> | fields | {"options":(options){name:$}} |});
$s1 := ({"data":$s0.data ~> | **.fields | {"options_name":(options.*){displayName:$}} | });
$s2 := $s1 ~> | data | {"fields":(fields){displayName:$}} |;
$s2.data{displayName:$}
)
有关使用JSONata模块的信息，请参阅JSONata模块。