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

Question

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

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

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

为了确保我有一个正确构造的 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'。打开 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 能够配置连接器与这些多个元素的使用。

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

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

Docusign Custom Connector for Power Automate and Power Apps

docusignapi