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 Workflow 包以及任意 Adobe Workfront 自动化和集成包 Workfront Ultimate Workfront Prime 和 Select 包，且需额外购买 Workfront Fusion。 |
| Adobe Workfront 许可证 |
标准 工作版或更高版本 |
| Adobe Workfront Fusion 许可证 |
基于操作：适用于拥有基于操作的许可证的组织 基于连接器（旧版）：Workfront Fusion for Work Automation and Integration |
| 产品 | 如果您的组织使用的 Workfront Select 或 Prime 包不包含 Workfront 自动化和集成，则必须单独购买 Adobe Workfront Fusion。 |
有关此表中信息的更多详细说明，请参阅文档中的访问权限要求。
有关 Adobe Workfront Fusion 许可证的详细信息，请参阅 Adobe Workfront Fusion 许可证。
先决条件
要使用Azure DevOps模块，您必须具有Azure DevOps帐户。
Azure DevOps API信息
Azure DevOps连接器使用以下对象：
将 Azure DevOps 连接到 Workfront Fusion connect-azure-devops-to-workfront-fusion
使用EntraApp将Azure DevOps连接到Workfront Fusion
-
将Azure DevOps模块添加到您的方案。
-
单击连接字段旁边的添加。
-
在连接类型字段中，选择要使用的连接类型。
note NOTE Azure DevOps (EntraApp)允许您请求连接的所有作用域。 -
填写以下字段：
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header 连接名称 输入正在创建的连接的名称。 组织 输入您创建了Azure DevOps应用程序的组织的名称。 应用程序ID 输入要连接的DevOps应用程序的ID。 客户端密钥 为要连接的DevOps应用程序输入客户端密码。 请求所有作用域 如果您使用Azure DevOps (EntraApp)连接类型，请启用此选项以请求连接的所有作用域。 -
要输入Azure DevOps应用程序ID或客户端密钥，请单击显示高级设置，然后在打开的字段中输入它们。
-
单击 继续 完成连接设置并继续创建方案。
使用服务主体将Azure DevOps连接到Workfront Fusion
您可以创建使用服务主体（应用程序API连接）而不是个人帐户的连接。 当您希望连接作为应用程序或服务标识而不是作为特定人员运行时，这将很有用。 例如，如果某人离开公司或更改密码，则集成不会中断，这可能会很有用。
此连接类型适用于所有Azure DevOps模块。
使用服务主体将Azure DevOps连接到Workfront Fusion的先决条件
要创建此连接，您需要满足以下条件：
- 在Microsoft Entra ID中 全局管理员 或 应用程序管理员 访问权限，以注册应用程序。 如果您没有此访问权限，请让您的IT或身份团队中的某人为您完成该步骤。
- 在您的Azure DevOps组织中 项目集合管理员 访问权限，以将服务主体添加为成员。 此人通常与管理Microsoft Entra ID的人不同。
- Azure DevOps组织的名称。 您可以在Azure DevOps URL中找到此项：
dev.azure.com/<your organization name>。
在Microsoft Entra ID中创建应用程序注册
- 登录到Microsoft Entra管理中心。
- 转到应用注册 > 新注册。
- 为应用程序提供一个清晰且可识别的名称。 例如：
Workfront Fusion Azure DevOps Integration。 - 将 重定向URI 保留为空。 此连接不涉及通过浏览器登录。
- 选择注册。
- 继续创建客户端密钥。
创建客户端密码
- 在新应用注册中，转到证书和密钥。
- 选择新客户端密钥，添加说明，并选择有效期。
- 选择添加。
- 立即复制密码的值。 它只显示一次。 如果您在复制它之前导航离开，则必须创建一个新路径。
- 继续收集您的连接详细信息。
收集您的连接详细信息
-
在应用程序注册的 概述 页面中，注意以下值。 在模块中创建连接时输入这些参数。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header 租户ID 在概述页面上，标记为目录（租户） ID。 客户端 ID 在概述页面上，标记为应用程序（客户端） ID。 客户端密钥 您在中创建客户端密钥中复制的值。 组织 您的Azure DevOps组织名称。 例如，如果URL是 dev.azure.com/yourorg，请输入yourorg。note NOTE 您可以跳过应用程序注册的 API权限 区域。 如果在此处添加Azure DevOps，则只有 委派权限 可用。 应用程序权限显示为灰色。 这是正常情况，因为Azure DevOps不支持以这种方式授予访问权限。 相反，在下一部分中，访问权限将直接在Azure DevOps中授予。
将服务主体添加到您的Azure DevOps组织
在Microsoft Entra ID中注册应用程序只会创建其标识。 它尚未授予应用程序访问Azure DevOps数据的任何权限。 此过程授予该访问权限。
-
登录到Azure DevOps组织，网址为
dev.azure.com/<your organization name>。 -
选择左下角的组织设置，然后选择用户。
-
选择添加用户。
-
在搜索框中，按应用程序的显示名称（您在注册应用程序时为其提供的名称）进行搜索。 请勿按客户端ID进行搜索。
-
选择访问级别：
- Basic通常足以读写工作项、展示板和存储库。
- 如果您的工作流需要在设置过程中浏览可用进程，例如Agile、Scrum或自定义模板，请改为将服务主体添加到 项目集合管理员 组。 这是更高级别的访问权限，因此仅在您需要此功能时才授予此访问权限。
-
按照贵组织的常规访问惯例，将服务主体分配给所需的一个或多个特定项目。
-
选择添加。
-
继续创建连接。
创建连接
-
在模块的连接设置屏幕中，选择 服务主体 连接类型。
-
输入以下内容：
- 租户ID
- 客户端ID
- 客户端密码
- 组织
-
保存连接。
如果一切设置正确，连接验证成功。
Azure DevOps模块及其字段
在您配置 Azure DevOps 模块时，Workfront Fusion 会显示以下字段。 除这些字段外，根据您的应用程序或服务访问权限级别，可能会显示更多 Azure DevOps 字段。 模块中的加粗标题表示必填字段。
如果您看到字段或功能上方的映射按钮，可使用它为该字段设置变量和函数。 有关详细信息，请参阅将信息从一个模块映射到另一个模块。
触发器
关注工作项
此即时触发器模块在Azure DevOps中添加、更新或删除记录时执行方案。
该模块会返回与记录关联的所有标准字段，以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
操作
创建记录
此操作模块创建新项目或工作项。
模块输出新创建的工作项的对象ID，或新创建项目的URL和状态代码。
自定义 API 调用
此操作模块允许您向 Azure DevOps API 发起自定义的已经过身份认证的调用。 通过这种方式，您可以构建其他 Azure DevOps 模块无法实现的数据流自动化。
在配置此模块时，会显示以下字段。
输入为此API调用要连接的相对URL。
示例： {organization}/_apis[/{area}]/{resource}
以标准 JSON 对象的形式添加请求标头。
例如， {"Content-type":"application/json"}
以标准 JSON 对象的形式添加 API 调用的查询。
例如： {"name":"something-urgent"}
以标准 JSON 对象的形式添加 API 调用的正文内容。
注意：
在 JSON 中使用 if 等条件语句时，需将引号置于条件语句外部。
下载附件
此操作模块下载附件。
模块将返回附件的文件内容。
链接工作项
此操作模块链接两个工作项并定义它们之间的关系。
读取记录
此操作模块从Azure DevOps中的单个记录读取数据。
您需要指定记录的 ID。
该模块会返回记录的 ID 及其关联字段，以及连接可访问的任何自定义字段及其值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。
更新工作项
该操作模块使用其ID更新现有工作项。
模块返回已更新工作项的ID。
上载附件
此操作模块上传文件并将其附加到工作项。
模块会返回附件的附件ID和下载URL。
搜索
列出工作项
此操作模块检索Azure DevOps项目中特定类型的所有工作项。
模块返回主工作项和任何关联字段的ID，以及连接访问的任何自定义字段和值。 您可以在场景后续的模块中映射这些信息。
在配置此模块时，会显示以下字段。