Adobe Workfront展示板模块

NOTE
板融合连接器处于Beta状态。 因此,对该连接器的支持有限,并且可能会由于主板未来的发展而发生更改。 此外,GraphQL API可能会有更改,恕不另行通知,这可能会影响您的Fusion连接器过程。

Adobe Workfront展示板是一种灵活的工具,通过提供对包含列和卡片的共享展示板的访问,允许团队协作。

您可以使用Adobe Workfront展示板模块读取或更新记录,对Workfront展示板API进行API调用,或当展示板上发生操作时触发场景。

访问要求

展开以查看本文中各项功能的访问要求。

您必须具有以下权限才能使用本文中的功能:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront包 任何
Adobe Workfront许可证

新增:标准

当前:工作或更高

Adobe Workfront Fusion许可证**

当前:无Workfront Fusion许可证要求

旧版:Workfront Fusion for Work Automation and Integration

产品

新:

  • 选择或Prime Workfront包:您的组织必须购买Adobe Workfront Fusion。
  • Ultimate Workfront包:其中包含Workfront Fusion。

当前:您的组织必须购买Adobe Workfront Fusion。

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

有关Adobe Workfront Fusion许可证的信息,请参阅Adobe Workfront Fusion许可证

先决条件

您必须先在Adobe Workfront中配置讨论区,然后才能连接到该讨论区。

Adobe Workfront展示板API信息

Adobe Workfront主板连接器使用以下内容:

API标记
v1.23.6

创建与Workfront展示板的连接

NOTE
您可以使用Workfront连接连接到Workfront展示板,也可以创建单独的Workfront展示板连接。

要创建Workfront展示板连接,请执行以下操作:

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

  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展示板模块及其字段

配置Workfront展示板模块时,Workfront Fusion显示以下列出的字段。 除了这些以外,还可能会显示其他Workfront展示板字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的粗体标题表示必填字段。

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

映射切换

信息卡

添加清单项目

此操作模块将一个清单项目添加到指定的信息卡。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

卡ID

输入或映射您要将清单项目添加到的卡的ID。

在Workfront中查看信息卡时,您可以在URL中找到该信息卡ID。

清单项目
对于要添加的每个清单项目,单击“添加项目”,输入清单项目的名称,然后选择该项目是否已完成。

添加子任务

此操作模块将一个子任务添加到展示板中的信息卡。 该卡必须是已连接的卡。 该子任务也会添加到卡所代表的Workfront任务中。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

父卡片ID

输入或映射要添加子任务的卡的ID。

在Workfront中查看信息卡时,您可以在URL中找到该信息卡ID。

展示板ID

输入或映射包含要向其添加子任务的卡片的展示板的ID。

在Workfront中查看展示板时,您可以在URL中找到展示板ID。

名称
输入或映射新子任务的名称。

创建信息卡

此操作模块可在Workfront展示板上创建新信息卡。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

展示板ID

输入或映射要将信息卡添加到的展示板的ID。

在Workfront中查看展示板时,您可以在URL中找到展示板ID。

列ID

输入或映射要添加子任务的列的ID。

您可以从读取展示板模块返回的信息中找到列ID。

名称
输入或映射新卡的名称。

移动信息卡

该操作模块会将一张信息卡移动到同一展示板上的另一列。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

卡ID

输入或映射要移动的卡的ID。

在Workfront中查看信息卡时,您可以在URL中找到该信息卡ID。

展示板ID

输入或映射包含要移动的信息卡的主板的ID。

在Workfront中查看展示板时,您可以在URL中找到展示板ID。

目标列ID

输入或映射要将卡片移动到的列的ID。

您可以从读取展示板模块返回的信息中找到列ID。

到索引

输入或映射您希望信息卡在新列中的位置。

索引0中列的顶部位置。

读取信息卡

此操作模块可检索有关特定信息卡的信息。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

卡ID

输入或映射要读取的信息卡的ID。

在Workfront中查看信息卡时,您可以在URL中找到该信息卡ID。

卡ID

输入或映射包含要读取的卡的主板的ID。

在Workfront中查看展示板时,您可以在URL中找到展示板ID。

更新信息卡

此操作模块会更新您指定信息卡的信息。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

卡ID

输入或映射要更新的信息卡的ID。

在Workfront中查看信息卡时,您可以在URL中找到该信息卡ID。

展示板ID

输入或映射包含要更新的卡的主板的ID。

在Workfront中查看展示板时,您可以在URL中找到展示板ID。

名称
输入或映射卡的新名称。
描述
输入或映射卡的新描述。
估计
输入或映射完成此信息卡所需时间的估计值。
到期日期

输入或映射此卡的到期日期。

有关支持的日期和时间格式的列表,请参阅类型强制

状态
为信息卡选择新状态。

展示板

创建展示板

此操作模块可在Workfront中创建展示板。 您可以指定要创建的展示板类型。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

展示板名称
输入或映射新讨论区的名称。
模板
为要创建的展示板类型选择模板。

阅读讨论区

此操作模块返回有关单个展示板的信息,例如展示板的卡片、列、标记和成员。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

展示板ID

输入或映射要检索其信息的展示板的ID。

在Workfront中查看展示板时,您可以在URL中找到展示板ID。

创建列

此操作模块在指定的展示板上创建新列。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

展示板ID

输入或映射要添加列的展示板的ID。

在Workfront中查看展示板时,您可以在URL中找到展示板ID。

列ID

输入或映射要更新的列的ID。

您可以从读取展示板模块返回的信息中找到列ID。

列名称
输入或映射列的新名称。

搜索列

此搜索模块返回有关具有指定名称的列的信息。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

展示板ID

输入或映射包含要检索的列的展示板的ID。

在Workfront中查看展示板时,您可以在URL中找到展示板ID。

列名称
输入或映射要检索的列的名称。

更新列

此操作模块可更新指定列的名称或WIP限制。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

展示板ID

输入或映射包含要检索的列的展示板的ID。

在Workfront中查看展示板时,您可以在URL中找到展示板ID。

列名称
输入或映射要检索的列的名称。
WIP限制
输入或映射列的新WIP限制。

标记

向信息卡添加标记

此操作模块会将标记添加到信息卡。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

卡ID

输入或映射要添加标记的卡的ID。

在Workfront中查看信息卡时,您可以在URL中找到该信息卡ID。

展示板ID

输入或映射包含要将标记添加到的卡的展示板的ID。

在Workfront中查看展示板时,您可以在URL中找到展示板ID。

标记ID

输入或映射要添加标记的ID。

您可以从读取展示板模块返回的信息中找到标记ID。

创建标记

此操作模块将创建一个新标记并为其分配一种颜色。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

展示板ID

输入或映射要为其创建标记的展示板的ID。

在Workfront中查看展示板时,您可以在URL中找到展示板ID。

标记名称
输入或映射新标记的名称。
标记颜色
选择此标记的颜色。

评论

创建评论

此操作模块在指定的信息卡上创建评论。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

卡ID

输入或映射要添加注释的卡的ID。

在Workfront中查看信息卡时,您可以在URL中找到该信息卡ID。

Comment
输入或映射要添加注释的文本。

阅读信息卡评论

此操作模块从指定的信息卡中检索注释。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

卡ID

输入或映射要为其检索注释的卡片ID。

在Workfront中查看信息卡时,您可以在URL中找到该信息卡ID。

限制
输入您希望模块在一个执行周期内返回的最大注释数。

其他

进行自定义API调用

此操作模块对Workfront展示板API进行自定义调用。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

URL
输入相对于 https://<WORKFRONT_DOMAIN>/boards-service/graphql?的路径。
方法

选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅HTTP请求方法

对于大多数展示板调用,该方法为POST。

Headers

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

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

查询字符串

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

对于Workfront展示板,此部分通常留空。

Body

以JSON嵌入Graphql的形式添加API调用的正文内容

示例:

此示例更新列名。 您可以将boardIdcolumnId作为硬编码的GUID或从以前的模块映射的GUID包含在内。

{
 "query": "mutation { updateColumn(boardId: \"\", columnId: \"\", updateColumnInput: { name: \"\" }) { id name }}"
}

注释:

在JSON中使用条件语句(如if)时,请将引号放在条件语句之外。

进行自定义GraphQL API调用

此操作模块向Workfront展示板API发出自定义GraphQL请求。

Connection

您可以使用现有的Workfront连接连接到Workfront展示板,也可以使用特定的Workfront展示板连接。

有关将Workfront应用程序连接到Workfront Fusion的说明,请参阅本文中的创建与Workfront讨论区的连接

方法
选择此调用的方法。
Query
以标准JSON对象的形式添加API调用的查询。
操作名称
输入此操作的名称。 这样可以更轻松地跟踪和调试调用。
Variables数据源
选择变量是来自表单还是集合。
Variables
对于要添加的每个变量,单击 添加项 并输入变量的键和值。
限制
输入或映射您希望模块在每个方案执行周期内返回的最大记录数。
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3