用于 Power Automate 和 Power Apps 的 Docusign 自定义连接器

Question

我正在我们的 Office365 环境（Word 模板、SharePoint 等）中开发一个自动化的文档准备流程，并且正在使用 Power Apps 和 Power Automate 准备和发送文档以通过 Docusign 进行身份验证签名。我不想使用“开箱即用”的 Docusign Power Automate 连接器，因为我需要在我的 Power Apps 解决方案中调用一些更高级的 Docusign 功能。

我已经成功地在 Power Apps 和 Power Automate 中使用 REST API 功能和 Docusign 开发了我自己的自定义连接器，并成功完成了 Oauth2 用户身份验证，并能够创建信封并将文档发送给单个收件人以供签名。

我的问题是我想使用 V2.1 文档 REST API 标准将文档发送给多个收件人，但是，我似乎遇到了 Power Apps 中的自定义连接器的问题/Power 自动化。

为了确保我有一个正确构建的 JSON 列表，我使用内置的 Docusign API 开发环境将文档连同文档锚标签一起发送给多个收件人。它运行正常并生成以下 JSON 代码：

    {
  "documents": [
    {
      "applyAnchorTabs": "True",
      "documentBase64": "<Base64BytesHere>",
      "documentId": "1",
      "fileExtension": "txt",
      "name": "NDA Agreement",
      "pages": "3"
    }
  ],
  "emailSubject": "Testing Docusign",
  "recipients": {
    "signers": [
      {
        "email": "wilson.smith@email.com",
        "name": "Wilson Smith",
        "recipientId": "1",
        "roleName": "Vice President",
        "routingOrder": "1",
        "tabs": {
          "signHereTabs": [
            {
              "documentId": "1",
              "pageNumber": "3",
              "tabLabel": "CompanySigner"
            }
          ]
        }
      },
      {
        "email": "john.doe@gemail.com",
        "name": "John Doe",
        "recipientId": "2",
        "roleName": "President",
        "routingOrder": "2",
        "tabs": {
          "signHereTabs": [
            {
              "documentId": "1",
              "pageNumber": "3",
              "tabLabel": "RecipientSignature"
            }
          ]
        }
      }
    ]
  },
  "status": "Sent"
}
    
        

我将其用作示例负载，以导入自定义连接器定义页面的请求部分：

Request section of Definition Page in Power Automate Custom Connector

这导致在请求部分中开发了一个“正文”。打开 REQUEST 的 BODY 部分会显示以下元素：

Body of Request after importing JSON payload

可以看出，JSON 有效负载中仅列出了单个收件人的元素。

进一步确认，当你去测试Custom Connector时，测试页面如下：

Custom Connector Test Page

测试页面成功执行，但它只发送给一个收件人。它没有确定需要发送给多个收件人。

我推测 Microsoft 自定义连接器不支持 REST V2.1，这是一个限制。如果对此有解决方法，我将不胜感激。

谢谢。

Answer 1

好的，所以在制作了上面的问题和问题之后，我开始考虑可能将 JSON 有效负载直接导入测试页面（使用 RAW Body 显示），然后测试连接器。我很惊讶 JSON 代码与多个收件人一起运行，但当我从 RAW Body 模式中选择回来时，测试页面只显示一个收件人。这是非常具有误导性的。

然后我想也许连接器配置正确，这只是连接器测试过程中的一个限制。

我回到 Power Automate 并在我的流程中使用了多收件人连接器，我惊讶地发现我现在能够添加多个收件人并且可以为每个收件人设置多个锚标记。

总之，自定义连接器测试是一个基本的测试环境。展望未来，我将在 RAW Body 视图中使用我的完整 JSON 有效负载并以这种方式进行测试。此外，您需要配置 JSON 有效负载以显示多个组件，以使 Power Automate 能够配置对这些多个元素的连接器的使用。

我认为这个问题值得做一个视频教程，因为我相信很多其他人都会遇到同样的问题。