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连接器使用以下对象:

基本 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中创建、更新或删除记录、记录类型或工作区时,此触发器模块将启动一个方案。

Webhook
选择要使用的webhook,或单击“添加”以创建一个新挂接。
连接
有关创建与 Adobe Workfront Planning 的连接的说明,请参阅本文中的创建与 Adobe Workfront Planning 的连接。
对象类型
选择您要监视记录、记录类型还是工作区。
状态

选择您希望关注旧状态还是新状态。

  • 新状态

    当记录状态更改 指定值时触发场景。

  • 旧状态

    当记录状态 指定值发生变化时触发场景。

Workspace
如果观看记录,请选择您想要观看记录的Workspace。
记录类型
如果观看记录,请选择您要观看的记录类型。
事件筛选条件

您可以设置筛选条件,仅观看符合您所选条件的记录。

对于每个筛选条件,请输入要评估的字段、运算符以及筛选条件应允许的值。您可以通过添加 AND 规则来使用多个筛选条件。

注意:您无法编辑现有Workfront Webhook中的筛选器。 如需为 Workfront 事件订阅设置不同的筛选条件,请删除当前 Webhook 并创建一个新的。

有关事件过滤器的详细信息,请参阅Workfront模块文章中的Workfront > 观看活动模块中的事件订阅过滤器

要监视的对象
选择是否要监视新的。 更新、新增和更新或删除的记录。
排除此连接所做的更新
启用此选项可防止在此模块使用的连接进行更改时触发场景。 如果场景执行触发操作,这将阻止触发场景的另一个实例。

操作

删除记录类型

此操作模块通过ID删除Workfront Planning中的单个记录类型。

WARNING
删除Workfront Planning中的记录类型也会删除记录类型表中的所有记录。
连接
有关创建与 Adobe Workfront Planning 的连接的说明,请参阅本文中的创建与 Adobe Workfront Planning 的连接。
记录类型ID
输入或映射要删除的记录类型的ID。

发起自定义 API 调用

此模块对Adobe Workfront Planning API进行自定义API调用。

连接
有关创建与 Adobe Workfront Planning 的连接的说明,请参阅本文中的创建与 Adobe Workfront Planning 的连接。
URL
输入相对路径 https://(YOUR_WORKFRONT_DOMAIN)/maestro/api/
方法
选择用于配置此 API 调用的 HTTP 请求方法。有关更多信息,请参阅 HTTP 请求方法
标头

以标准 JSON 对象的形式添加请求标头。

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

Workfront Fusion 会自动添加授权标头。

查询字符串
对于要添加到查询字符串的每个键/值对,单击 添加项 并输入键和值。
正文

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

注意:

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

搜索

搜索记录

此操作模块根据您指定的条件检索记录列表。

连接
有关创建与 Adobe Workfront Planning 的连接的说明,请参阅本文中的创建与 Adobe Workfront Planning 的连接。
Workspace
输入或映射包含要搜索的记录的Workspace。
记录类型
选择要搜索的记录类型。
记录字段
对于要在搜索中使用的每个字段,请找到该字段,选择运算符,然后输入或映射要搜索的值。 根据所选的记录类型,字段可用。
Condition for filters

选择过滤器的条件:

  • 模块返回符合所选字段值的 所有 的记录。

  • 或者

    该模块返回符合所选字段值的 any 的记录。

限制
输入或映射每次场景执行周期中该模块允许返回的最大记录数量。

未分类

创建记录

此操作在Workfront Planning中创建单个记录。

连接
有关创建与 Adobe Workfront Planning 的连接的说明,请参阅本文中的创建与 Adobe Workfront Planning 的连接。
记录类型ID
输入或映射要创建的记录类型。 可用的记录类型基于您的Workfront Planning帐户。
其他字段
输入希望新记录具有的值。 这些字段基于您选择的记录类型。

删除记录

此操作模块删除Workfront Planning中的指定记录。

连接
有关创建与 Adobe Workfront Planning 的连接的说明,请参阅本文中的创建与 Adobe Workfront Planning 的连接。
记录ID
输入或映射要删除的记录的ID。

获取记录

此操作模块从其ID指定的Adobe Workfront Planning中检索单个记录。

连接
有关创建与 Adobe Workfront Planning 的连接的说明,请参阅本文中的创建与 Adobe Workfront Planning 的连接。
记录ID
输入或映射要检索的记录的ID。

按记录类型获取记录

此操作模块检索指定类型的所有记录。

连接
有关创建与 Adobe Workfront Planning 的连接的说明,请参阅本文中的创建与 Adobe Workfront Planning 的连接。
Workspace
选择或映射包含要检索的记录的工作区。
记录类型
选择要检索的记录类型。

获取记录类型

此操作模块检索Adobe Workfront Planning帐户中的记录类型列表。

连接
有关创建与 Adobe Workfront Planning 的连接的说明,请参阅本文中的创建与 Adobe Workfront Planning 的连接。
Workspace
选择或映射包含要检索的记录类型的工作区。

更新记录

此操作更新Workfront Planning中的单个记录。

连接
有关创建与 Adobe Workfront Planning 的连接的说明,请参阅本文中的创建与 Adobe Workfront Planning 的连接。
记录ID
输入或映射要更新的记录类型。 可用的记录类型基于您的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模块

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