|
要访问Workfront Planning,您必须具备以下条件:
- 新的Workfront包和许可证。 Workfront Planning不适用于旧版Workfront包或许可证。
- Workfront计划包。
- 您组织的Workfront实例必须载入到Adobe Unified Experience。
Adobe Workfront规划API信息
Adobe Workfront Planning连接器使用以下对象:
| table 0-row-2 1-row-2 layout-auto html-authored no-header |
|
| 基本 URL |
https://{{connection.host}}/maestro/api/{{common.maestroApiVersion}}/ |
| API标记 |
v1.13.7 |
创建与Adobe Workfront Planning的连接 create-a-connection-to-adobe-workfront-planning
您可以在Workfront Fusion模块内直接创建与Workfront Planning帐户的连接。
-
在任意Adobe Workfront Planning模块中,单击“连接”框旁边的添加。
-
填写以下字段:
| 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
(可选)
|
输入您的Adobe 客户端ID。 这可以在Adobe Developer Console的凭据详细信息部分找到。 |
|
客户端密钥
(可选)
|
输入您的Adobe 客户端密钥。 这可以在Adobe Developer Console的凭据详细信息部分找到。 |
| 身份验证URL |
输入您的Workfront实例将用于对此连接进行身份验证的URL。
默认值为 https://oauth.my.workfront.com/integrations/oauth2。
|
| 主机前缀 |
输入您的主机前缀。
默认值为 origin-。
|
-
单击 继续 保存连接并返回模块。
Adobe Workfront Planning模块及其字段
配置Workfront模块时,Workfront Fusion会显示以下列出的字段。 除此以外,还可能会显示其他Workfront字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。
如果看到字段或函数上方的映射按钮,则可以使用该按钮设置该字段的变量和函数。 有关详细信息,请参阅将信息从一个模块映射到另一个模块。
触发器
观看活动
在Workfront Planning中创建、更新或删除记录、记录类型或工作区时,此触发器模块将启动一个方案。
| 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 |
|
| Webhook |
选择要使用的webhook,或单击“添加”以创建一个新挂接。 |
| Connection |
有关创建与Adobe Workfront Planning的连接的说明,请参阅本文中的创建与Adobe Workfront Planning的连接。 |
| 对象类型 |
选择您要监视记录、记录类型还是工作区。 |
| 状态 |
选择您要观察旧状态还是新状态。
-
新状态
当记录将 更改为 给定值时触发方案。
-
旧状态
当记录从 更改 给定值时触发方案。
|
| Workspace |
如果观看记录,请选择您想要观看记录的Workspace。 |
| 记录类型 |
如果观看记录,请选择您要观看的记录类型。 |
| 事件过滤器 |
您可以设置过滤器,以仅监视符合您选择标准的记录。
对于每个筛选器,输入希望筛选器计算的字段、运算符以及希望筛选器允许的值。 通过添加AND规则,您可以使用多个过滤器。
注意:您无法编辑现有Workfront Webhook中的筛选器。 要为Workfront活动订阅设置其他筛选器,请删除当前webhook并创建一个新筛选器。
有关事件过滤器的详细信息,请参阅Workfront模块文章中的Workfront > 观看活动模块中的事件订阅过滤器。
|
| 要监视的对象 |
选择是否要监视新的。 更新、新增和更新或删除的记录。 |
| 排除此连接所做的更新 |
启用此选项可防止在此模块使用的连接进行更改时触发场景。 如果场景执行触发操作,这将阻止触发场景的另一个实例。 |
操作
删除记录类型
此操作模块通过ID删除Workfront Planning中的单个记录类型。
| note warning |
| WARNING |
| 删除Workfront Planning中的记录类型也会删除记录类型表中的所有记录。 |
| table 0-row-2 1-row-2 layout-auto html-authored no-header |
|
| Connection |
有关创建与Adobe Workfront Planning的连接的说明,请参阅本文中的创建与Adobe Workfront Planning的连接。 |
| 记录类型ID |
输入或映射要删除的记录类型的ID。 |
进行自定义API调用
此模块对Adobe Workfront Planning API进行自定义API调用。
| 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 |
有关创建与Adobe Workfront Planning的连接的说明,请参阅本文中的创建与Adobe Workfront Planning的连接。 |
| URL |
输入相对路径 https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/ |
| 方法 |
选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅HTTP请求方法。 |
| Headers |
以标准JSON对象的形式添加请求的标头。
例如, {"Content-type":"application/json"}
Workfront Fusion会自动添加授权标头。
|
| 查询字符串 |
对于要添加到查询字符串的每个键/值对,单击 添加项 并输入键和值。 |
| Body |
以标准JSON对象的形式添加API调用的正文内容。
注释:
在JSON中使用条件语句(如if)时,请将引号放在条件语句之外。
|
搜索
搜索记录
此操作模块根据您指定的条件检索记录列表。
| 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 |
有关创建与Adobe Workfront Planning的连接的说明,请参阅本文中的创建与Adobe Workfront Planning的连接。 |
| Workspace |
输入或映射包含要搜索的记录的Workspace。 |
| 记录类型 |
选择要搜索的记录类型。 |
| 记录字段 |
对于要在搜索中使用的每个字段,请找到该字段,选择运算符,然后输入或映射要搜索的值。 根据所选的记录类型,字段可用。 |
| Condition for filters |
选择过滤器的条件:
-
和
模块返回符合所选字段值的 所有 的记录。
-
或者
该模块返回符合所选字段值的 any 的记录。
|
| 限制 |
输入或映射您希望模块在每个方案执行周期内返回的最大记录数。 |
未分类
创建记录
此操作在Workfront Planning中创建单个记录。
| table 0-row-2 1-row-2 2-row-2 3-row-0 layout-auto html-authored no-header |
|
| Connection |
有关创建与Adobe Workfront Planning的连接的说明,请参阅本文中的创建与Adobe Workfront Planning的连接。 |
| 记录类型ID |
输入或映射要创建的记录类型。 可用的记录类型基于您的Workfront Planning帐户。 |
| 其他字段 |
输入希望新记录具有的值。 这些字段基于您选择的记录类型。 |
|
|
删除记录
此操作模块删除Workfront Planning中的指定记录。
| table 0-row-2 1-row-2 layout-auto html-authored no-header |
|
| Connection |
有关创建与Adobe Workfront Planning的连接的说明,请参阅本文中的创建与Adobe Workfront Planning的连接。 |
| 记录ID |
输入或映射要删除的记录的ID。 |
获取记录
此操作模块从其ID指定的Adobe Workfront Planning中检索单个记录。
| table 0-row-2 1-row-2 layout-auto html-authored no-header |
|
| Connection |
有关创建与Adobe Workfront Planning的连接的说明,请参阅本文中的创建与Adobe Workfront Planning的连接。 |
| 记录ID |
输入或映射要检索的记录的ID。 |
按记录类型获取记录
此操作模块检索指定类型的所有记录。
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header |
|
| Connection |
有关创建与Adobe Workfront Planning的连接的说明,请参阅本文中的创建与Adobe Workfront Planning的连接。 |
| Workspace |
选择或映射包含要检索的记录的工作区。 |
| 记录类型 |
选择要检索的记录类型。 |
获取记录类型
此操作模块检索Adobe Workfront Planning帐户中的记录类型列表。
| table 0-row-2 1-row-2 layout-auto html-authored no-header |
|
| Connection |
有关创建与Adobe Workfront Planning的连接的说明,请参阅本文中的创建与Adobe Workfront Planning的连接。 |
| Workspace |
选择或映射包含要检索的记录类型的工作区。 |
更新记录
此操作更新Workfront Planning中的单个记录。
| table 0-row-2 1-row-2 2-row-2 3-row-0 layout-auto html-authored no-header |
|
| Connection |
有关创建与Adobe Workfront Planning的连接的说明,请参阅本文中的创建与Adobe Workfront Planning的连接。 |
| 记录ID |
输入或映射要更新的记录类型。 可用的记录类型基于您的Workfront Planning帐户。 |
| 其他字段 |
输入希望记录具有的新值。 这些字段基于您选择的记录类型。 |
|
|
将JSONata用于可读的record-types划分
以下JSONata表达式创建了Planning查询的可读输出,该输出为您提供了记录类型划分。 这使记录类型名称、字段名称和字段选项名称(如果适用)可由名称读取,并保持结构的其余部分不变。
| code language-none |
(
$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模块。
|