DocuSign: How to fill multiple tabs of text with a single label?

Question

I have several text tabs that have the same label in the template. When I send the recipient’s tab data to fill it in, only the first one is filled, the rest of them are empty.

I found this support ticket . But it contains conflicting information:

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. 

If all of them are recognized as one, why does the API need to send the same data 10 times? If it sends information 5 times, which tabs are populated? First 5? Any 5 of them randomly?

Please note that I can receive text tabs with unique captions.

EDIT:

Here is the JSON request dump:

 { "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 } 

(I deleted some confidential information)

And here is the JSON answer:

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

As I said, the first FullName tab FullName filled, the subsequent ones are empty.

Answer 1

The message you are referring to is now out of date - in fact you need to do the trick if you have several tabs with the same label that you want to pre-populate with the same value.

Basically, if you have several tabs with the same tabLabel, and you want them all to start with the same initial value, then you need the tabLabel prefix with a wildcard

 \\* 

For example, let's say you have a social security tab that you have added to your document in several places called "SocialSecurityTab". To populate ALL text tags containing "SocialSecurityTab" as their tabLabel, use the following JSON:

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

It is important not to forget the backslash characters (\), and also make sure that you are not using a system (such as Salesforce) that can change one of the backslashes for various reasons.

Answer 2

@Ergin - the wildcard string breaks for me, if 2 tabLabels end with one character string, then the last mention of tabLabel does not display correctly in templates.

So from your example:

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

So, make sure you have unique TabLabels everywhere to work around.