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

Question

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

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

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

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

    {
  "documents": [
    {
      "applyAnchorTabs": "True",
      "documentBase64": "<Base64BytesHere>",
      "documentId": "1",
      "fileExtension": "txt",
      "name": "NDA Agreement",
      "pages": "3"
    }
  ],
  "emailSubject": "Testing Docusign",
  "recipients": {
    "signers": [
      {
        "email": "<a href="https://stackoverflow.com/cdn-cgi/l/email-protection" class="__cf_email__" data-cfemail="a1d6c8cdd2cecf8fd2ccc8d5c9e1c4ccc0c8cd8fc2cecc" rel="noreferrer noopener nofollow">[email protected]</a>",
        "name": "Wilson Smith",
        "recipientId": "1",
        "roleName": "Vice President",
        "routingOrder": "1",
        "tabs": {
          "signHereTabs": [
            {
              "documentId": "1",
              "pageNumber": "3",
              "tabLabel": "CompanySigner"
            }
          ]
        }
      },
      {
        "email": "<a href="https://stackoverflow.com/cdn-cgi/l/email-protection" class="__cf_email__" data-cfemail="3953565157175d565c795e5c54585055175a5654" rel="noreferrer noopener nofollow">[email protected]</a>",
        "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 部分中开发“主体”。打开 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 并在流程中使用多收件人连接器，惊讶地发现我现在能够添加多个收件人，并且每个收件人都可以设置多个 anchor 标记。

综上所述，自定义连接器测试是一个基本的测试环境。展望 future ，我将在 RAW Body View 中使用完整的 JSON 负载并以这种方式进行测试。此外，您还需要配置 JSON 负载以显示多个组件，以使 Power Automate 能够配置具有这些多个元素的连接器的使用。

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