Docusignapi Docusign：带选项卡的复合模板

创建信封时，如何使用复合模板指定预填充字段

我尝试在inlineTemplate.recipients.signers[0].tabs中包含选项卡信息，但出现了一个错误，

System.String无法转换为API_REST.Models.v2.tabs

如果我将信息作为模板角色包含在

templateRoles

中，它将被忽略。该文档提供了有关如何执行此操作的信息。似乎应该在内联模板中指定预填充数据

我的其他开放性问题包括

recipientId

的作用。

clientUserId

用于什么？我们目前将所有签名者的

clientUserId

设置为相同的值。我知道当签名者要求签名时会用到它。出于某种原因，它对每个签名者都是唯一的吗

它看起来也像是一个单一的复合模板覆盖在服务器和内联模板之上。在一个复合模板中包含多个服务器模板或多个内联模板的用例是什么

是否有计划改进文档，以描述如何将复合模板用于各种目的

签名者/模板角色：

{
  "clientUserId": "clientUserId",
  "email": "first+last@email.com",
  "name": "First Last",
  "roleName": "role1",
  "tabs": {
    "textTabs": [
      {
        "locked": true,
        "tabLabel": "\\*FieldName",
        "value": "prefillValue"
      }
    ]
  }
}

请求示例：

{
  "compositeTemplates": [
    {
      "inlineTemplates": [
        {
          "recipients": {
            "signers": [
              {
                "clientUserId": "clientUserId",
                "email": "first+last@email.com",
                "name": "First Last",
                "recipientId": 1,
                "roleName": "role1",
                "tabs": {
                  "textTabs": [{"tabLabel": "label", "value": "val"}]
                }
              }
            ]
          },
          "sequence": 1
        }
      ],
      "serverTemplates": [
        {
          "sequence": 1,
          "templateId": "templateId1"
        }
      ]
    },
    {
      "inlineTemplates": [
        {
          "recipients": {
            "signers": [
              {
                "clientUserId": "clientUserId",
                "email": "first+last@better.com",
                "name": "First Last",
                "recipientId": 1,
                "roleName": "role1",
                "tabs": {
                  "textTabs": [{"tabLabel": "label", "value": "val"}]
                }
              }
            ]
          },
          "sequence": 2
        }
      ],
      "serverTemplates": [
        {
          "sequence": 2,
          "templateId": "templateId2"
        }
      ]
    }
  ],
  "emailSubject": "Email subject",
  "status": "sent",
  "templateId": null,
  "templateRoles": null
}

---

可以找到有关从服务器模板发送信封的信息

tab元素使用RecipientID来指示哪个收件人要对文档进行签名，而clientuserID指定用户是否是唯一的，建议每个签名者都是唯一的（但不是必需的）

我还建议阅读关于复合模板的内容，希望这个概念会更有意义，但我同意你的观点，缺乏关于复合模板的文档可能会很麻烦

不幸的是，我没有包含选项卡数据的示例，但是在下面示例中的每个收件人下添加选项卡部分应该不会有任何问题

{
  "emailSubject": "DocuSign Comp Test 1",
  "emailBlurb": "Example - Composite Templates",
  "status": "sent",
  "compositeTemplates": [
    {
      "serverTemplates": [
        {
          "sequence": "1",
          "templateId": "templateId1"
        }
      ],
      "inlineTemplates": [
        {
          "sequence": "1",
          "recipients": {
            "signers": [
              {
                "email": "testsigner123@gmail.com",
                "name": "Test Tester",
                "recipientId": "1",
                "roleName": "Signer 1"
              }
            ]
          }
        }
      ]
    },
    {
      "serverTemplates": [
        {
          "sequence": "2",
          "templateId": "templateId2"
        }
      ],
      "inlineTemplates": [
        {
          "sequence": "2",
          "recipients": {
            "signers": [
              {
                "email": "testsigner123@gmail.com",
                "name": "Test Tester",
                "recipientId": "1",
                "roleName": "Signer 1"
              }
            ]
          }
        }
      ]
    },
    {    
      "serverTemplates": [
        {
          "sequence": "3",
          "templateId": "templateId3"
        }
      ],
      "inlineTemplates": [
        {
          "sequence": "2",
          "recipients": {
            "signers": [
              {
                "email": "testsigner123@gmail.com",
                "name": "Test Tester",
                "recipientId": "1",
                "roleName": "Signer 1"
              }
            ]
          }
        }
      ]
    }
  ]
}

---

谢谢你的回复。我以前看过那些文件页。我仍然不清楚在哪里指定选项卡信息。我尝试在根级别

templateRoles

下，在

inlineTemplates[0]

下，在

inlineTemplates[0].recipients

下，以及在

inlineTemplates[0].recipients.singers[0]

下包含它。除最后一个配置外，所有配置均被忽略。最后一个（看起来应该去的地方）返回了一个错误。我可以在签名者下面添加标签。我使用的docusign客户端遇到了编码问题。谢谢你，很高兴你能成功。我刚刚读了我的帖子，意识到我确实说过在“收件人”下添加标签信息，而应该在“签名者”下添加标签信息。我很抱歉！！！这方面的文档不是很好。我试图将选项卡数据添加到模板角色中。将它转移到内联模板的接收者对我来说很有用。谢谢