php - DocuSign API: initialHere and signHere on the same document...or not

Solution:

You can add multiple types of tabs to a single recipient by adding them to the list of signer tabs. So after creating an InitialHere tab you would add it to your list like this:

$signer_tabs = new \DocuSign\eSign\Model\Tabs(['sign_here_tabs' => [$sign_here], 'initial_here_tabs' => [$initial_here]);

For your first question, if you add an Initial Here tab to the document with an anchor string that isn't in the document, then the tab will not appear and the recipient will not need to initial.

Solution:

if the tab isn't on the document, then the role is simply ignored. Is that so?

Yes, the role name will be ignored by your non-template envelope regardless of the tab being present or not.roleName is used for matching your intended user to a given role within the signing process for a template envelope. When creating a template, you will specify a role name for the recipient, a carbon copy viewer, etc. When creating your envelope using that template you just created, you will specify the role name for your given recipients so that the data will be matched to the templated role name. In other words - you will not use the template name to determine whether or not a given tab is used, but rather, to determine which user data is populated on envelope that is generated from using the template envelope.

My second question: do I create a new recipient (same person) for each role, or assign more than one role to the recipient? The downloaded sample code doesn't do anything with initials that I can find.

Not quite, you would need to create more of those sign_here objects and attach them into the signer_tabs array you listed up there, under a new array and entry named 'initial_here_tabs', like this:

$sign_here = new \DocuSign\eSign\Model\SignHere(['anchor_string' => '{sig:1}']);
$initial_here = new \DocuSign\eSign\Model\InitialHere(['anchor_string' => '{ini:1}']);

$signer_tabs = new \DocuSign\eSign\Model\Tabs([
'sign_here_tabs' => [$sign_here],
'initial_here_tabs' => [$initial_here]
]);

$signer_props = [
    'email' => $args['email'], 
    'name' => $args['name'],
    'recipient_id' => count($this->arrSigners) + 1,
    'tabs' => $signer_tabs
];

# Create the signer recipient model
$this->arrSigners[] = new Signer($signer_props);
Copy code