DocuSign：更新信封时签名者选项卡丢失答案

【问题标题】：DocuSign: Signer Tabs are lost when updating an envelopeDocuSign：更新信封时签名者选项卡丢失
【发布时间】：2019-07-19 10:52:30
【问题描述】：

当我最初创建和发送 DocuSign 信封时，我定义了收件人需要签名的选项卡以及将放置签名日期的位置。这非常适用于电子签名 REST API。

当对文档进行一些更改（并且信封状态已发送或已投递）时，仍然可以更新信封的文档。使用下面的代码，我可以更新文档和电子邮件主题/正文。重新发送后，我正确地得到了对电子邮件和文档所做的更改。

在“新”DocuSign 电子邮件中，签名者选项卡丢失了，我没有签名的地方。

我尝试的是再次定义signerTabs并将其绑定到收件人。

更新文档和电子邮件主题/正文

envDef.EmailSubject = env.EmailSubject = "Updated documents";
envDef.EmailBlurb = env.EmailBlurb = "Changes were made to the document(s)";
env.Status = EnumHelper.GetDescription(DSStatus.Sent);
envDef.Documents = new List<Document>() { doc };

apiClient.UpdateDocuments(_accountId, envelopeId, envDef);

//resend
apiClient.Update(_accountId, envelopeId, env, new EnvelopesApi.UpdateOptions() { resendEnvelope = true.ToString() });

Signer signer1 = new Signer
{
    RecipientId = "1"
};
SignHere signHere1 = new SignHere
{
    AnchorString = "/sn1/"
};
Tabs signer1Tabs = new Tabs
{
    SignHereTabs = new List<SignHere> { signHere1 },
    DateSignedTabs = new List<DateSigned> { dateSigned1 },
    FullNameTabs = new List<FullName> { fullName1 }
};
signer1.Tabs = signer1Tabs;

Recipients recipients = new Recipients
{
    Signers = new List<Signer> { signer1 },
};
env.Recipients = recipients;

编辑

这是我发送信封时的请求正文。使用 anchorString 添加签名者选项卡，在本例中为 /sn1/。所以看起来更新后的文档不再有这些标签了。

"recipients" : {
    "signers" : [ {
      "routingOrder" : "1",
      "name" : "Recipient Name",
      "email" : "Recipient Email Address",
      "recipientId" : "1",
      "tabs" : {
        "signHereTabs" : [ {
          "anchorString" : "/sn1/",
        } ]

为什么那些签名者的详细信息丢失了，但信封又重新发送给了正确的签名者？

【问题讨论】：

标签： c# .net rest docusignapi

【解决方案1】：

那么您的标签，它们是如何创建的？在标记器中手动拖放？您也可以使用 API 定义它们。您可以为现有信封获取它们，然后在更新后将它们“重新水化”回信封。

【讨论】：

我添加了用于发送信封的请求正文。那么我怎样才能得到标签并重新补水呢？
您的选项卡非常简单，我想您可以在更新文档时重新放置它们。您可以对包括文档、收件人和标签的整个信封进行 PUT 调用，这样您就不必进行 2 次 API 调用（或者您也可以进行 2 次 API 调用，这也可以）
我将收件人也添加到了信封定义中，并再次描述了姓名和电子邮件，但没有任何成功。当我拿到信封的标签时，一切都是空的。
什么都是空的？你在做什么 API 调用？
GET /v2.1/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/tabs 注意标签在收件人而不是文档下

【解决方案2】：

可能在 DocuSign 中，更新文档时收件人的选项卡会丢失是很常见的。为了解决这个问题，我让收件人使用了以下调用中包含的选项卡： apiClient.ListRecipients(_accountId, envelopeId, new EnvelopesApi.ListRecipientsOptions(){ includeTabs = true.ToString() });

这个结果可以放在envDef.Recipients中。

【讨论】：