Azure DevOps模块

在Adobe Workfront Fusion方案中,您可以自动使用Azure DevOps的工作流,并将其连接到多个第三方应用程序和服务。

如果需要有关创建方案的说明,请参阅在 Adobe Workfront Fusion中创建方案。

有关模块的信息,请参阅 Adobe Workfront Fusion🔗中的模块。

访问要求

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

Adobe Workfront 计划*
Pro或更高版本
Adobe Workfront 许可证*
计划,工作
Adobe Workfront Fusion 许可证**

当前许可证要求:无Workfront Fusion许可证要求。

旧版许可证要求:Workfront Fusion for Work Automation and Integration

产品

当前产品要求:如果您有Select或Prime Adobe Workfront计划,则贵组织必须购买Adobe Workfront Fusion和Adobe Workfront才能使用本文中描述的功能。 Workfront Fusion包含在Ultimate Workfront计划中。

旧版产品要求:您的组织必须购买Adobe Workfront Fusion和Adobe Workfront,才能使用本文中介绍的功能。

要了解您拥有什么计划、许可证类型或访问权限,请与Workfront管理员联系。

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

先决条件

要使用Azure DevOps模块,您必须具有Azure DevOps帐户。

Azure DevOps API信息

Azure DevOps连接器使用以下对象:

API版本
v5.1
API标记
v1.29.33

将Azure DevOps连接到Workfront Fusion connect-azure-devops-to-workfront-fusion

  1. 将Azure DevOps模块添加到您的方案。

  2. 单击连接字段旁边的​ 添加

  3. 在连接类型字段中,选择​ Azure DevOps

    note important
    IMPORTANT
    Azure DevOps (请求所有范围)连接类型不久将被弃用。 因此,我们不建议使用它。
  4. 填写以下字段:

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    连接名称 输入正在创建的连接的名称。
    组织 输入您创建了Azure DevOps应用程序的组织的名称。
  5. 单击​ 继续 ​完成连接设置并继续创建方案。

Azure DevOps模块及其字段

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

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

触发器

关注工作项

此即时触发器模块在Azure DevOps中添加、更新或删除记录时执行方案。

该模块会返回与记录关联的任何标准字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Webhook

为模块选择或添加webhook。

有关触发器模块中Webhook的详细信息,请参阅Adobe Workfront Fusion中的即时触发器(Webhook)。

有关如何创建Webhook的信息,请参阅Webhook

操作

自定义API调用

此操作模块允许您对Azure DevOps API进行经过身份验证的自定义调用。 这样,您可以创建其他Azure DevOps模块无法实现的数据流自动化。

配置此模块时,会显示以下字段。

Connection
有关将Azure DevOps帐户连接到Workfront Fusion的说明,请参阅本文中的将Azure DevOps连接到Workfront Fusion
基本URL
选择或映射用于连接到Azure DevOps帐户的基本URL
相对URL

输入为此API调用要连接的相对URL。

示例: {organization}/_apis[/{area}]/{resource}

API版本
选择或映射要为此API调用连接到的Azure DevOps API的版本。 如果未选择版本,Workfront Fusion将连接到Azure DevOps API版本5.1。
方法

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

Headers

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

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

查询字符串

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

例如: {"name":"something-urgent"}

Body

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

注意:

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

创建记录

此操作模块创建新项目或工作项。

模块输出新创建的工作项的对象ID,或新创建项目的URL和状态代码。

Connection
有关将Azure DevOps帐户连接到Workfront Fusion的说明,请参阅本文中的将Azure DevOps连接到Workfront Fusion
记录类型

选择您要创建工作项还是项目。

  • 项目

    填写以下字段:

    • 名称:输入或映射新项目的名称。

    • 描述:输入或映射新项目的描述。

    • 可见性:选择您希望项目是公共项目还是专用项目。 用户必须已登录您的组织,并且必须已被授予项目访问权限,才能与专用项目交互。 公共项目对未登录到您的组织的用户可见。

    • 版本控制:选择您希望项目使用Git还是Team Foundation版本控制(TFCV)进行版本控制。

    • 工作项进程:选择要用于项目的工作进程。 选项有Basic、Scrum、功能成熟度模型集成(CMMI)和Agile。

      有关Azure DevOps进程的详细信息,请参阅Azure DevOps文档中的选择进程

  • 工作项

    填写以下字段:

    • 项目:选择要创建工作项的项目。

    • 工作项类型:选择要创建的工作项类型。

    • 其他字段:在这些字段中,输入您希望工作项具有的给定属性值。 可用字段取决于工作项类型。

下载附件

此操作模块下载附件。

模块将返回附件的文件内容。

Connection
有关将Azure DevOps帐户连接到Workfront Fusion的说明,请参阅本文中的将Azure DevOps连接到Workfront Fusion
附件URL
输入或映射要下载的附件的URL。

链接工作项

此操作模块链接两个工作项并定义它们之间的关系。

模块返回主工作项和任何关联字段的ID,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Azure DevOps帐户连接到Workfront Fusion的说明,请参阅本文中的将Azure DevOps连接到Workfront Fusion
工作项ID
输入或映射要链接其他工作项的主工作项的ID。
链接的工作项ID
输入或映射要链接到主工作项的工作项的ID。
链接类型

定义要链接的工作项之间的关系。

有关详细信息,请参阅Azure DevOps文档中的链接类型引用

Comment
输入或映射注释的文本。 这对于解释链接的推理或意图很有用。

读取记录

此操作模块从Azure DevOps中的单个记录读取数据。

您指定记录的ID。

该模块返回记录ID和任何关联字段,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Azure DevOps帐户连接到Workfront Fusion的说明,请参阅本文中的将Azure DevOps连接到Workfront Fusion
记录类型

选择您要读取项目还是工作项

  • 项目:选择要读取的项目……

  • 工作项:选择包含要读取的工作项的项目,然后选择该工作项类型。

输出
选择要包含在此模块的输出捆绑包中的信息。 可用字段取决于工作项类型。
ID
输入或映射要读取的记录的ID。

更新工作项

该操作模块使用其ID更新现有工作项。

模块返回已更新工作项的ID。

Connection
有关将Azure DevOps帐户连接到Workfront Fusion的说明,请参阅本文中的将Azure DevOps连接到Workfront Fusion
项目
选择包含要更新的工作项的项目。
工作项类型
选择要更新的工作项的类型。
其他字段
在每个字段中,输入您希望工作项具有的给定属性值。 可用字段取决于工作项类型。
工作项ID
输入或映射要更新的工作项的ID。

上载附件

此操作模块上传文件并将其附加到工作项。

模块会返回附件的附件ID和下载URL。

Connection
有关将Azure DevOps帐户连接到Workfront Fusion的说明,请参阅本文中的将Azure DevOps连接到Workfront Fusion
项目
选择要上载附件的项目。
工作项ID
输入或映射要上载附件的工作项的ID。
Comment
输入要添加到上载附件的注释文本。
Source file
从以前的模块中选择源文件,或者输入或映射源文件的名称和内容。

搜索

列出工作项

此操作模块检索Azure DevOps项目中特定类型的所有工作项。

模块返回主工作项和任何关联字段的ID,以及连接访问的任何自定义字段和值。 您可以在场景的后续模块中映射此信息。

配置此模块时,会显示以下字段。

Connection
有关将Azure DevOps帐户连接到Workfront Fusion的说明,请参阅本文中的将Azure DevOps连接到Workfront Fusion
项目
选择要从中检索工作项的项目。
工作项类型
选择要检索的工作项类型。
输出
选择要显示在模块输出中的属性。 可用字段取决于您要检索的工作项的类型。 您必须至少选择一个属性。
限制
输入或映射Workfront Fusion在一个执行周期内返回的最大工作项数。
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43