Azure DevOps模块

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

有关创建方案的说明,请参阅创建方案:文章索引下的文章。

有关模块的信息,请参阅模块:文章索引下的文章。

访问要求

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

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

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 许可证

先决条件

要使用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. 单击Connection字段旁边的​ Add

  3. 在Connection Type字段中,选择​ Azure DevOps

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

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    Connection name 输入正在创建的连接的名称。
    Organization 输入您创建了Azure DevOps应用程序的组织的名称。
  5. 要输入Azure DevOps应用程序ID或客户端密钥,请单击 显示高级设置,然后在打开的字段中输入它们。

  6. 单击​ Continue ​完成连接设置并继续创建方案。

Azure DevOps模块及其字段

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

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

映射切换

触发器

Watch for work items

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

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

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

Webhook

为模块选择或添加webhook。

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

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

操作

Create a record

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

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

Connection
有关将Azure DevOps帐户连接到Workfront Fusion的说明,请参阅本文中的将Azure DevOps连接到Workfront Fusion
Record type

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

  • Project

    填写以下字段:

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

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

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

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

    • Work item process:选择要用于项目的工作流程。 选项为Basic、Scrum、Capability Maturity Model Integration (CMMI)和Agile。

      有关Azure DevOps进程的详细信息,请参阅Azure DevOps文档中的默认进程和进程模板

  • Work item

    填写以下字段:

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

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

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

Custom API Call

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

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

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

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

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

API Version
选择或映射要为此API调用连接到的Azure DevOps API的版本。 如果未选择版本,Workfront Fusion将连接到Azure DevOps API版本5.1。
Method
选择配置API调用所需的HTTP请求方法。 有关详细信息,请参阅HTTP请求方法
Headers

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

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

Query String

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

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

Body

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

注意:

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

Download an attachment

此操作模块下载附件。

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

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

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

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

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

有关详细信息,请参阅Azure DevOps文档中的链接类型参考指南。

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

Read record

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

您指定记录的ID。

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

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

Connection
有关将Azure DevOps帐户连接到Workfront Fusion的说明,请参阅本文中的将Azure DevOps连接到Workfront Fusion
Record type

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

  • Project:选择要读取的项目。

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

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

Update a work item

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

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

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

Upload an attachment

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

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

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

搜索

List work items

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

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

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

Connection
有关将Azure DevOps帐户连接到Workfront Fusion的说明,请参阅本文中的将Azure DevOps连接到Workfront Fusion
Project
选择要从中检索工作项的项目。
Work item type
选择要检索的工作项类型。
Outputs
选择要显示在模块输出中的属性。 可用字段取决于您要检索的工作项的类型。 您必须至少选择一个属性。
Limit
输入或映射Workfront Fusion在一个执行周期内返回的最大工作项数。
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3