java - 如果使用 ducusign API 通过模板发送嵌入式签名，则没有签名工具

Question

我正在开发一个应用程序，允许用户使用 DocuSign API 从我的应用程序签署文档。我正在关注这两个链接(嵌入式签名 https://developers.docusign.com/esign-rest-api/guides/features/embedding 和使用模板 https://developers.docusign.com/esign-rest-api/guides/features/templates )，但我遇到了 2 个问题。

第一个是嵌入签名被发送，但仍然向用户发送电子邮件，这不是我想要的。第二个是如果我在嵌入签名中使用模板，则模板上不会显示签名工具。

关于第二个问题，我尝试从沙箱模板选项卡添加签名工具，也尝试使用代码来控制签名，但都不起作用。

有人有类似的问题吗，不胜感激。

private EnvelopeDefinition makeEnvelope(String signerEmail, String signerName) throws IOException {
    EnvelopeDefinition envelopeDefinition = new EnvelopeDefinition();
    envelopeDefinition.setTemplatesUri("/templates/0426d2ca-8c40-4d02-bc42-1f64f21fa29f");
    // my template Id
    envelopeDefinition.setTemplateId("0426d2ca-8c40-4d02-bc42-1f64f21fa29f");

    TemplateRole signer1 = new TemplateRole();
    signer1.setEmail(signerEmail);
    signer1.setName(signerName);
    signer1.setRoleName("signer");

    SignHere signHere1 = new SignHere();
    signHere1.setAnchorString("/sn1/");
    signHere1.setAnchorUnits("pixels");
    signHere1.setAnchorYOffset("20");
    signHere1.setAnchorXOffset("10");

    // Tabs are set per recipient / signer
    Tabs signer1Tabs = new Tabs();
    signer1Tabs.setSignHereTabs(Arrays.asList(signHere1));
    signer1.setTabs(signer1Tabs);


    envelopeDefinition.setTemplateRoles(Arrays.asList(signer1));
    envelopeDefinition.setStatus("sent");

    return envelopeDefinition;
}

Answer 1

关于:

The first one is the embedded signing gets sent but still an email sent to the user which is not what I want.

如果为收件人设置了 clientUserId，则将为收件人签名者启用嵌入式签名。如果已设置，则如果在管理工具中的“签名和发送”>“签名设置”屏幕中选中了禁止向嵌入签名者发送电子邮件选项，则电子邮件将不会发送给签名者。

回复:

The second one is if I use a template in the embedded signing, no signature tool shows up on the template.

DocuSign Web 工具可用于创建模板，但模板中的收件人(角色)不会设置 clientUserId。

我认为你可以在使用模板时设置角色的其他属性(姓名、电子邮件等)时设置clientUserId，但我没有尝试过。如果这不起作用，请提出一个新的具体问题“如何将 clientUserId 属性添加到模板角色。”