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 Automation and Integration的Select或Prime Workfront包,则贵组织必须购买Adobe Workfront Fusion。

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

accordion
##先决条件

要访问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帐户的连接。

  1. 在任意Adobe Workfront Planning模块中,单击“连接”框旁边的​添加

  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

    (可选)

    输入您的Adobe 客户端ID。 这可以在Adobe Developer Console的凭据详细信息部分找到。

    客户端密钥

    (可选)

    输入您的Adobe 客户端密钥。 这可以在Adobe Developer Console的凭据详细信息部分找到。
    身份验证URL

    输入您的Workfront实例将用于对此连接进行身份验证的URL。

    默认值为 https://oauth.my.workfront.com/integrations/oauth2

    主机前缀

    输入您的主机前缀。

    默认值为 origin-

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

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模块

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