如何通过Azure Logic Apps调用Azure DevOps REST API创建及更新工作项？

可行性说明 #

完全可行。Azure Logic Apps是专为系统集成设计的低代码工具，原生支持HTTP请求；Azure DevOps REST API是标准REST接口，两者可以无缝对接，非常适合实现CRM与DevOps之间的工作项同步场景。

具体实现步骤 #

1. 准备Azure DevOps授权凭据 #

• 生成个人访问令牌（PAT）：登录Azure DevOps，进入用户设置 > 个人访问令牌，创建新令牌，勾选Work Items分类下的读、写权限，设置合适的有效期。
• 加密存储PAT：不要在工作流里明文写PAT，建议存在Logic Apps的连接配置中，或者Azure密钥保管库，通过引用方式调用。

2. 搭建Logic Apps工作流 #

• 选择触发器：根据CRM的触发方式选择，比如用HTTP触发器接收CRM的webhook请求，或者如果有现成的CRM连接器，直接用对应的触发事件（比如“当CRM有新记录创建时”）。
• 添加HTTP动作：在工作流中添加HTTP操作，配置如下：
  • 请求方法：创建工作项用POST，更新用PATCH
  • 请求URL：替换占位符为你的实际信息：
    • 创建：https://dev.azure.com/{组织名}/{项目名}/_apis/wit/workitems/${工作项类型}?api-version=7.1-preview.3
    • 更新：https://dev.azure.com/{组织名}/{项目名}/_apis/wit/workitems/{工作项ID}?api-version=7.1-preview.3
  • 请求头：
    • 必须添加Content-Type: application/json-patch+json
    • 授权头：Authorization: Basic {base64编码字符串}（编码规则：把:{你的PAT}转换成base64格式）
  • 请求体：按照JSON Patch格式构造，示例：
    • 创建工作项：

      [
        {
          "op": "add",
          "path": "/fields/System.Title",
          "value": "CRM同步：客户需求"
        },
        {
          "op": "add",
          "path": "/fields/System.Description",
          "value": "CRM记录ID: 12345\n需求详情：xxx"
        }
      ]
      

    • 更新工作项：

      [
        {
          "op": "replace",
          "path": "/fields/System.State",
          "value": "已解决"
        },
        {
          "op": "add",
          "path": "/fields/System.History",
          "value": "从CRM同步：客户确认需求完成"
        }
      ]
      

3. 处理响应与异常 #

• 添加条件判断：检查HTTP请求的响应状态码，比如200/201代表成功，其他状态码进入失败分支。
• 失败分支处理：可以添加发送邮件通知管理员、或者设置重试机制，保证集成的可靠性。
• 可选闭环操作：如果需要，把DevOps返回的工作项ID等信息回写到CRM的对应记录中。

4. 测试与部署 #

• 触发CRM事件（比如创建一条新记录），验证工作流是否正常触发，DevOps中是否生成/更新了对应的工作项。
• 检查工作项的字段是否正确同步了CRM的信息。
• 部署到生产环境后，开启Logic Apps的运行监控，及时排查异常。

内容的提问来源于stack exchange，提问作者vallamreddyvenu