Question

我是DocuSign的新手，制作了教程并阅读了DocuSign API文档。我正在使用Java进行开发，并且已经成功地将用于签名的文档从模板发送到电子邮件地址。然后打开文档，填写自定义字段。该文档由用户签名。

现在这里有两个问题出现在我面前：

1）我是否正确地假设自定义字段几乎用于任何形式字段，例如“你有哪些宠物？”用户应该填写？创建模板时，我可以添加的几乎所有其他字段都由DocuSign自动填写。

2）我已经添加了名称和姓氏字段以及自定义字段和“在此处签名”字段到我通过API发送文档的模板。一旦收件人填写了信息并签署了文档，我想要求用户输入自定义字段的信息。我怎样才能做到这一点？我发现了获取文档或信封状态的各种请求。但从未发现我如何检索实际的用户输入。

此致约瑟夫

Answer 1

在DocuSign中，如果您的请求中有用于收件人的常用标签，则可以使用Custom Fields创建一次，然后在后续请求中重复使用它们。但是，一般情况下，如果您想拥有可编辑的字段，您可以从收件人那里收集信息，那么您可以使用Text字段并取消选中只读。如果通过API进行设置，它将如下所示：

"textTabs": [
    {
      "tabLabel": "NameOfTheTab",
      "value": "12345"
    }

您可以通过DocuSign Developer Center的功能部分详细了解如何使用这些字段。

关于如何检索收件人填写的数据的第二个问题，请记住选项卡始终特定于收件人（而不是文档本身），因此请查看Get Tab Information for Recipient API调用。

示例：

GET https://{server}/restapi/{apiVersion}/accounts/{accountId}/envelopes/{envelopeId}/recipients/{recipientId}/tabs