docusignapi - 有没有办法在连接事件中包含模板角色名称

Question

对于 DocuSign，我们有一个集成的帐户，我们使用连接事件将有关信封的信息存储在数据库中，然后存储到我们的报告存储库中。对于我们发送的每个信封，我们都会应用一个匹配的模板。有没有办法让推送给我们的连接事件中包含模板角色名称？

标签： docusignapi

Answer 1

正如 Larry 提到的，我们不会在 Connect 响应中发送 roleName，但是如果您使用 API 发送信封，则有一个不同的解决方法来完成此操作。创建信封时，您可以在信封创建调用中传递收件人级别自定义字段，在此收件人级别自定义字段中，您可以将角色名称作为字符串传递。在连接响应中，您将收到每个收件人的此自定义字段，这可用于解释用于创建信封的角色名称。

如果 API 调用的收件人部分如下所示，Signer1您使用的角色名称在哪里，但将其作为收件人级别自定义字段传递：

"recipients": {
                  "signers": [
                     {
                        "email": "[e-mail]",
                        "name": "John Doe",
                        "recipientId": "1",
                        "roleName": "Signer1",
                        "routingOrder": "1",
                        "customFields":[
                            "Signer1"
                        ]
                     }
                  ]
               }

然后连接响应将如下所示：

<RecipientStatus>
        <Type>Signer</Type>
        <Email>[e-mail]</Email>
        <UserName>John Doe</UserName>
        <RoutingOrder>1</RoutingOrder>
        <Sent>2019-03-07T12:14:48.38</Sent>
        <Status>Sent</Status>
        <CustomFields>
          <CustomField>Signer1</CustomField>
        </CustomFields>
</RecipientStatus>