的DocuSign REST API：用於發送信封模板角色

Question

所以我目前使用的DocuSign API構建涉及使用戶簽訂了共享文件的web應用程序，一切都在正常的情況下正常工作：模板將被創建並有預定義角色，如「簽名者1」，「簽名者2」，「特殊1」;當簽名發生時，將根據模板創建一個信封，讓用戶與角色關聯，如user1與簽名者1，user2與簽名者2，用戶可以簽署與其角色關聯的選項卡。

然而，也有一些情況下，我需要修改的簽約用戶發送信封。例如，我可能需要用戶2從角色「簽名者2」切換到「特殊1」，因此我將首先將用戶2從收件人中刪除，並將用戶2添加角色「特殊1」回收件人。理想情況下，與模板中定義的「特殊1」關聯的選項卡現在應該是用戶2簽署的義務。但是，當用戶2重新加入時，它不與爲角色「特殊1」定義的選項卡鏈接，儘管在信封狀態中它顯示用戶2具有角色「特殊1」。

有沒有人知道這裏發生了什麼？我懷疑模板角色只在首次創建信封時應用，後來添加的收件人（儘管使用角色名設置）不包含模板中定義的角色。如果我的猜測是正確的，有什麼辦法可以解決這個問題嗎？

任何幫助將不勝感激。

Answer 1

您的假設是正確的 - 即模板角色（和相應的選項卡）僅在信封創建期間分配。如果您隨後爲信封添加收件人，他們將永遠不會自動擁有標籤 - 即使您將它們分配給原始模板爲其指定標籤的角色。

這裏有一個潛在的變通爲您提供：

• 在模板中，指定一共有4個角色：1- signer1; 2- 佔位符; 3- 簽名者2; 4- special1確保指定所有選項卡，你要收件人角色1,3和4有，只是指定佔位接受者的角色一個「在這裏簽名」選項卡。

• 當您創建信封，指定所有4個角色的收件人信息。對於「佔位」的角色，它並不真正的問題是什麼名稱/您指定的電子郵件 - 這接受者的角色僅僅是那裏暫停信封是暫時的，直到你知道第二個收件人應占據哪個角色。對於這兩種「signer2」角色和「special1」的角色，指定收件人＃2的姓名和電子郵件地址。 （注：在您的「創建信封」 API調用，你需要設置allowRecipientRecursion屬性真正，這樣重複的收件人允許）

• 當第一個收件人完成簽約，信封將前進到工作流程中的下一個收件人（佔位符角色）。由於此「佔位符」收件人不與真人對應，因此信封將按路由順序位於此處，直到將此收件人從信封中刪除。

• 一旦你知道第二個收件人需要佔用哪個角色（」 signer2‘或’special1‘）：1-編程方式刪除對應聯合國需要角色接受者（’簽名者2「或」特殊1「），以及2以編程方式刪除與」佔位符「角色相對應的收件人。這將導致信封僅剩下2個接收者（「簽名者1」和「簽名者2」或「特殊1」）;只要從信封中刪除「佔位符」收件人，信封工作流程就會自動前進到最後（即第二個）收件人，並且該收件人將獲得模板爲該角色定義的所有標籤。