DocuSign：如何用相同的标签预填充多个文本选项卡？答案

【问题标题】：DocuSign: How to prefill multiple text tabs with the same label?DocuSign：如何用相同的标签预填充多个文本选项卡？
【发布时间】：2013-08-12 07:12:58
【问题描述】：

我有多个文本选项卡，它们在模板中都有完全相同的标签。当我发送收件人标签数据以预填充这些时，仅预填充第一个，其余为空。

我找到了this support ticket。但它包含相互矛盾的信息：

Yes I believe you do need to set the value 10 times (one for each text tab),
...
So if you give them all the same label and make them editable (by setting "locked" to false) then when a recipient types a value  into one text box ALL of them will get updated with that value.

如果它们都被识别为一个，为什么 API 需要发送 10 次相同的数据？如果它发送信息 5 次，哪些选项卡被填充？前5个？任意5个？

请注意，我可以获得预先填充了独特标签的文本选项卡。

编辑：

这是请求的 JSON 转储：

{
  "compositeTemplates": null, 
  "status": "sent", 
  "allowReassign": false, 
  "allowRecipientRecursion": false, 
  "templateRoles": [
    {
      "name": "Atamert Olcgen", 
      "tabs": {
        "radioGroupTabs": [], 
        "textTabs": [
          ...
          {
            "name": "Text", 
            "value": "<EMAIL1>", 
            "tabLabel": "Email"
          }, 
          ...
          {
            "name": "Text", 
            "value": "Atamert Olcgen", 
            "tabLabel": "FullName"
          }, 
          ...
        ], 
        "checkboxTabs": []
      }, 
      "recipientId": "1", 
      "accessCode": null, 
      "clientUserId": "******", 
      "roleName": "Client", 
      "emailNotification": null, 
      "email": "<EMAIL1>"
    }, 
    {
      "name": "*****",
      "tabs": {
      ... // Secondary signer, mostly empty
      }, 
      "recipientId": "2", 
      "accessCode": null, 
      "clientUserId": null, 
      "roleName": "!", 
      "emailNotification": null, 
      "email": "<EMAIL2>"
    }, 
    {
      "name": "******", 
      "tabs": {
        "radioGroupTabs": [], 
        "textTabs": [], 
        "checkboxTabs": []
      }, 
      "recipientId": "1", 
      "accessCode": null, 
      "clientUserId": null, 
      "roleName": "EmailOnlyRecipient", 
      "emailNotification": null, 
      "email": "<EMAIL3>"
    }
  ], 
  "enableWetSign": false, 
  "signingLocation": "Online", 
  "eventNotification": null, 
  "enforceSignerVisibility": false, 
  "brandId": "", 
  "allowMarkup": false, 
  "envelopeIdStamping": false, 
  "asynchronous": false, 
  "templateId": "<TEMPLATE_ID>", 
  "emailBlurb": "", 
  "customFields": null, 
  "authoritativeCopy": false, 
  "emailSubject": "<PRODUCT> - Secure Authorization Document", 
  "autoNavigation": false
}

（我删除了一些敏感信息）

这是 JSON 响应：

{
  "envelopeId": "******",
  "uri": "/envelopes/******",
  "statusDateTime": "2013-08-12T10:25:00.7159991Z",
  "status": "sent"
}

正如我上面所说，第一个 FullName 选项卡已预先填充，后续选项卡为空。

【问题讨论】：

标签： docusignapi

【解决方案1】：

您引用的帖子现在已过时 - 实际上，当您有多个标签具有相同标签的标签要预填充相同的值时，您需要做一个技巧。

基本上，如果您有多个具有相同 tabLabel 的选项卡，并且您希望它们都以相同的初始值开始，那么您需要在 tabLabel 前面加上通配符字符串

\\*

例如，假设您有一个社会保障标签，您已在多个名为“SocialSecurityTab”的地方添加到您的文档中。要填充所有包含“SocialSecurityTab”作为其 tabLabel 的 textTab，请使用以下 JSON：

"textTabs": [
      {
        "tabLabel": "\\*SocialSecurityTab",
        "value": "012-34-5678"
      }

重要的是不要忘记两个反斜杠 (\) 字符，并确保您使用的系统（例如 Salesforce）可能会因各种原因去掉一个反斜杠。

文档

有关详细信息，请参阅Automatically Populating Tabs 文档。

【讨论】：

感谢这解决了这个问题。但为什么这不是默认行为？我提到这个问题的所有开发人员都表示不解。如果不希望两个选项卡填充相同的值，为什么还要为两个选项卡指定相同的名称？
我同意 @muhuk 这设计很糟糕，并且在他们的 API 文档中没有很好地记录。
对于那些想在文档本身中看到这一点的人。可以找到here in DocuSign API Docs
我同意 DocuSign 的文档很糟糕

【解决方案2】：

@Ergin - 如果 2 个 tabLabel 以相同的字符串结尾，那么通配符字符串对我来说会中断，那么最后一次提及的 tabLabel 会被错误地映射到模板上的错误字段。

从你的例子来看：

"textTabs": [ { "tabLabel": "\\*SocialSecurityTab", "value": "012-34-5678" }, { "tabLabel": "\\*Tab", "value": "SomeValue" }

因此，请确保您在任何地方都有唯一的 TabLabel 以解决问题。

【讨论】：