用於 Power Automate 和 Power Apps 的 Docusign 自定義連接器

Question

我正在我們的 Office365 環境（Word 模板、SharePoint 等）中開發一個自動化文檔准備流程，並且正在使用 Power Apps 和 Power Automate 通過 Docusign 准備和發送經過身份驗證的簽名的文檔。 我不想使用“開箱即用”的 Docusign Power Automate 連接器，因為我需要在我的 Power Apps 解決方案中調用一些更高級的 Docusign 功能。

我已經使用 REST API 功能在 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"
}
    
        

我將其用作示例有效負載以導入自定義連接器的定義頁面的請求部分：

Power Automate 自定義連接器中定義頁面的請求部分

這導致在請求部分中開發了一個“主體”。 打開 REQUEST 的 BODY 部分會顯示以下元素：

導入 JSON 有效載荷后的請求正文

可以看出，JSON 有效載荷中僅列出了單個收件人的元素。

進一步確認當您go測試Custom Connector時，測試頁面出現如下：

自定義連接器測試頁

然而，測試頁面成功執行，它只發送給一個收件人。 它沒有確定需要發送給多個收件人。

我推測 Microsoft 自定義連接器不支持 REST V2.1 並且是一個限制。 如果對此有解決方法，我將不勝感激。

謝謝你。

Answer 1

好的，所以在制作了上面的問題和問題之后，我開始考慮是否可以將 JSON 有效負載直接導入測試頁面（使用 RAW Body 顯示），然后測試連接器。 我很驚訝 JSON 代碼與多個收件人一起運行，但當我從 RAW Body 模式選擇回來時），測試頁面只顯示一個收件人。 這是非常具有誤導性的。

然后我想也許連接器配置正確，這只是連接器測試過程中的一個限制。

我回到 Power Automate 並在我的流程中使用了多收件人連接器，我驚訝地發現我現在能夠添加多個收件人，並且每個收件人都可以設置多個錨標記。

綜上所述，自定義連接器測試是一個基本的測試環境。 展望未來，我將在 RAW Body 視圖中使用完整的 JSON 有效負載並以這種方式進行測試。 此外，您需要配置 JSON 有效負載以顯示多個組件，以使 Power Automate 能夠配置使用這些多個元素的連接器。

我認為這個問題值得做一個視頻教程，因為我相信很多其他人會遇到同樣的問題。