DocuSign：我需要文档的第一个收件人，以便在从模板创建信封时知道通过templateRoles分配的签名者的姓名

Question

我有一个已知第一个签名者的模板，然后是一个由templateRoles定义的第二个签名者。第一个签名者需要知道第二个签名者的名字。我没有找到通过DocuSign控制台执行此操作的方法，因为预填充选项卡特定于当前接收者，或者已经签署或审阅文档的人。我需要在创建信封时预填充选项卡。如何为已知收件人分配预填充选项卡，因为templateRoles需要roleName并且我有一个recipientId？

修订：我可以通过API探索现有模板。为了获取收件人的选项卡列表，我在请求信封/ {envelope} / recipients / {recipientId} / tabs中使用了recipientId。然后，我可以将选项卡与recipientId关联。但是在从模板创建信封时预填充选项卡的过程中，recipId被拒绝并且需要roleName，这使得这更加复杂。

Answer 1

[我对你的情况并不十分清楚，但无论如何我都会采取行动。如果我错过了商标，请澄清问题（通过评论）。]

如何通知一位收件人其他收件人的姓名将取决于您是否希望该信息（即收件人姓名）实际出现在文件本身的某处。

如果您不希望后续收件人的姓名出现在文档本身的任何位置，但仍需要一种方法通知第一位签名者后续收件人的姓名，那么您可以通过为第一个收件人指定注释来实现此目的。 “注释”的内容仅出现在收件人收到的电子邮件中，并在收件人首次进入信封时出现在弹出对话框中 - 它不会出现在信封文档中的任何位置。例如，以下是收件人访问信封时的注释：

如果通过DocuSign控制台创建/发送信封，则发件人可以为第一个收件人手动添加注意，以指示后续签名者的姓名，和/或第一个接收者需要知道的其他信息。

如果您是通过API创建/发送信封，则只需填写第一个收件人的注释属性，即可为第一个收件人指定注意 （在创建信封请求中）：

POST https://{{env}}.docusign.net/restapi/{{version}}/accounts/{{acctId}}/envelopes
{
  "emailSubject": "Please sign",
  "emailBlurb": "Please sign...thanks!",
  "status": "sent",
    "compositeTemplates": [
    {
        "serverTemplates": [
        {
            "sequence" : 1,
            "templateId": "9C848429-3C12-4C5E-BDD1-681C4FE25A2A"
        }],
        "inlineTemplates": [
        {
            "sequence" : 2,
            "recipients": {
                "signers" : [{
                    "email": "johnsEmail@outlook.com",
                    "name": "John Doe",
                    "recipientId": "1",
                    "roleName": "Signer 1",
                    "note": "Hi John -- the second signer's name is: Mary Adams.",
                    "routingOrder": "1"
                  },
                  {
                    "email": "marysEmail@outlook.com",
                    "name": "Mary Adams",
                    "recipientId": "2",
                    "roleName": "Signer 2",
                    "routingOrder": "2"
                  }
                ]
            }
        }]
    }]
}

或者 - 如果您希望第一个收件人查看信封文档时第二个收件人的姓名实际出现在文档中，那么您应该能够简单地创建模板（在DocuSign控制台中）第二个收件人分配给/拥有的 FullName 标签，如下所示：

然后，当第一个收件人查看信封时，他应该看到第二个收件人的姓名，其中您在模板中放置了 Fullname 标签：

注意：如果您使用我所描述的“全名”标签方法，您可能还需要确保启用此帐户设置（在首选项＆gt;＆gt;功能中）：

Answer 2

看来我需要在发送信封请求中使用roleName，即使我使用recipientId获取选项卡信息。这很麻烦，因为在将选项卡信息集成到我的应用程序中时，我必须跟踪两个引用相同记录的特定值和唯一值。

但是，使用roleName设置标签的行为似乎非常错误。我可以在一个模板上成功设置选项卡，但它似乎不适用于其他模板。这有一个已知的错误吗？我将不得不放弃这种方法并尝试不同的方法，所以最初的问题仍然存在。