Docusign REST API:已发送信封的模板角色

时间:2014-05-02 00:27:21

标签: docusignapi

所以我目前正在使用Docusign API来构建一个涉及让用户签署共享文档的Web应用程序,并且在正常情况下一切正常:将创建一个模板,并具有预定义的角色,如“签名者1”,“签名者2“,”特别1“;签名发生时,将从模板中创建一个信封,其中包含与角色关联的用户,例如带有签名者1的用户1,带有签名者2的用户2,以及用户可以签署与其角色关联的选项卡。

但是,在某些情况下我需要修改签署已发送信封的用户。例如,我可能需要用户2从角色“签名者2”切换到“特殊1”,因此我将首先从收件人中删除用户2,并在收件人中添加角色“特殊1”的用户2。理想情况下,与模板中定义的“特殊1”相关联的选项卡现在应该是用户2的签名义务。但是,当用户2重新添加时,它不会与为角色“特殊1”定义的选项卡链接,但在信封状态中,它显示用户2具有角色“特殊1”。

有谁知道这里发生了什么?我怀疑模板角色仅在首次创建信封时应用,后来添加的收件人(虽然使用rolename设置)不会采用模板中定义的角色。如果我的猜测是正确的,有没有办法解决这个问题?

任何帮助将不胜感激。

1 个答案:

答案 0 :(得分:2)

您的假设是正确的 - 即,仅在信封创建期间分配模板角色(和相应的标签)。如果您随后为信封添加收件人,他们将永远不会自动拥有标签 - 即使您将它们分配给原始模板指定标签的角色。

这是一个潜在的解决方法:

  • 在模板中,指定总共4个角色:1- signer1 ; 2- 占位符; 3- signer2 ; 4- special1 确保指定您希望收件人角色1,3和4拥有的所有选项卡,并为占位符收件人角色。

  • 创建信封时,请指定所有4个角色的收件人信息。对于“占位符”角色,您指定的名称/电子邮件并不重要 - 此收件人角色只是暂时暂停信封,直到您知道第二个接收者应该占据哪个角色。对于“ signer2 ”角色和“ special1 ”角色,请指定收件人#2的名称和电子邮件地址。 ( 注意: 在“创建信封”API调用中,您需要将 allowRecipientRecursion 属性设置为 true 以便允许重复的收件人。)

  • 当第一个收件人完成签名时,信封将前进到工作流程中的下一个收件人(占位符角色)。由于此“占位符”收件人与真人不对应,因此信封将按路线顺序排列,直到此收件人从信封中删除。

  • 一旦您知道第二个收件人需要占用哪个角色(“ signer2 ”或“ special1 ”):1 - 以编程方式删除与 不需要 角色(“ signer2 ”或“ special1 ”),并以编程方式删除收件人对应于“占位符”角色。这将导致信封只剩下2个收件人(“ signer1 ”和“ signer2 ”或“ special1 ”);从信封中删除“占位符”收件人后,信封工作流程将自动前进到最后一个(即第二个)收件人 - 该收件人将获得该模板为该角色定义的所有选项卡。