DocuSign API: initialHere 和 signHere 在同一份文件上......或不

Question

我在文档上使用锚定标签，签名部分效果很好。我在另一个 post 上看到添加一个初始选项卡就像将“signhere”换成“initialhere”一样简单。酷

我的第一个问题：对我来说最简单的解决方案是为每个收件人同时添加 signhere 和 initialhere。据我了解，这样做不会破坏任何东西：如果选项卡不在文档中，那么该角色将被忽略。是这样吗？

我的第二个问题：我是为每个角色创建一个新的收件人（同一个人），还是为收件人分配多个角色？下载的示例代码对我能找到的首字母没有任何作用。

现在的代码，使用 PHP SDK：

$sign_here = new \DocuSign\eSign\Model\SignHere(['anchor_string' => '{sig:1}']);
$signer_tabs = new \DocuSign\eSign\Model\Tabs(['sign_here_tabs' => [$sign_here]]);

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

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

Answer 1

您可以将多种类型的选项卡添加到单个收件人，方法是将它们添加到签名者选项卡列表中。因此，在创建 InitialHere 选项卡后，您可以像这样将其添加到您的列表中：

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

对于您的第一个问题，如果您使用不在文档中的锚字符串向文档中添加“此处为首字母缩写”选项卡，则该选项卡将不会出现，收件人也不需要首字母缩写。

Answer 2

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

是的，无论选项卡是否存在，您的非模板信封都将忽略角色名称。 roleName 用于将您的目标用户与模板信封签名过程中的给定角色相匹配。创建模板时，您将指定收件人的角色名称、抄送查看者等。使用刚创建的模板创建信封时，您将为给定的收件人指定角色名称，以便数据与模板化的角色名称相匹配。换句话说 - 您不会使用模板名称来确定是否使用了给定的选项卡，而是确定哪些用户数据填充在使用模板信封生成的信封上。

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.

不完全是，您需要创建更多这些 sign_here 对象并将它们附加到您在此处列出的 signer_tabs 数组中，在名为 'initial_here_tabs' 的新数组和条目下，像这样：

$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);

DocuSign API: initialHere 和 signHere 在同一份文件上......或不

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

php

rest

docusignapi