Adobe Workfront展示板模块

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

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

您可以使用Adobe Workfront展示板模块读取或更新记录,对Workfront展示板API进行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。

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

先决条件

您必须先在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展示板字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的加粗标题表示必填字段。

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

映射切换

信息卡

添加清单项目

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

连接

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

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

卡ID

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

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

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

添加子任务

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

连接

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

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

父卡片ID

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

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

展示板ID

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

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

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

创建信息卡

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

连接

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

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

展示板ID

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

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

列ID

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

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

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

移动信息卡

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

连接

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

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

卡ID

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

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

展示板ID

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

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

目标列ID

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

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

到索引

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

索引0中列的顶部位置。

读取信息卡

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

连接

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

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

卡ID

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

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

卡ID

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

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

更新信息卡

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

连接

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

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

卡ID

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

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

展示板ID

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

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

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

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

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

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

展示板

创建展示板

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

连接

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

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

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

阅读讨论区

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

连接

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

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

展示板ID

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

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

创建列

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

连接

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

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

展示板ID

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

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

列ID

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

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

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

搜索列

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

连接

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

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

展示板ID

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

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

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

更新列

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

连接

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

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

展示板ID

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

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

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

标记

向信息卡添加标记

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

连接

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

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

卡ID

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

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

展示板ID

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

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

标记ID

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

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

创建标记

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

连接

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

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

展示板ID

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

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

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

评论

创建评论

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

连接

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

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

卡ID

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

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

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

阅读信息卡评论

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

连接

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

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

卡ID

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

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

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

其他

发起自定义 API 调用

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

连接

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

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

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

选择用于配置此 API 调用的 HTTP 请求方法。有关更多信息,请参阅 HTTP 请求方法

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

标头

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

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

查询字符串

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

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

正文

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

示例:

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

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

注意:

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

进行自定义GraphQL API调用

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

连接

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

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

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