如何避免在文档中显示不需要的模板角色？

Question

我为具有不同 roles i.e. Role1, Role2, Role3 的文档类型创建了一个 template。我在创建 envelope 和 TemplateRoles(signers) 的同时传递了 TemplateId。但是，当我传递唯一的角色 1、角色 2 时，角色 3 的字段也会显示在文档中。

我想要实现的是，当我添加 TemplateRole Role1 时，不应显示 Role2 和 Role3 的字段。

创建 envelope 或需要对模板本身做一些事情时需要配置什么吗？

Answer 1

如果您从创建调用 (status = "sent") 发送信封，空角色应该会被自动丢弃。

要在草稿中获得相同的行为，请添加 merge_roles_on_draft=true 查询字符串参数。

要使用 SDK 执行此操作，您需要像这样利用 CreateEnvelopesOptions 对象：

        EnvelopesApi.CreateEnvelopeOptions createEnvelopeOptions = new EnvelopesApi.CreateEnvelopeOptions()
        {
            mergeRolesOnDraft = "true"
        };
        envelopesApi.CreateEnvelope(accountId, envelopeDefinition, createEnvelopeOptions);

如何避免在文档中显示不需要的模板角色？

How to avoid non-required template role from being displayed on document?

docusignapi