Question

关于Docusign API如何工作，我有一个非常基本的问题。我自己试着找到答案，但很快就被支持中心的大量信息所淹没，其中大部分信息都已过时。

这是我正在尝试做的事情：

我已在Docusign帐户中上传并配置了多个模板
我正在编写一个网络应用程序，允许我的用户根据特定条件请求这些模板的子集
模板子集将通过iframe集成在我的应用中使用（我假设）
我还想在我的新模板副本中自动填充几个字段

如何在步骤2中执行API请求？

如何在步骤3中执行API调用？或者是以其他方式将值注入文档中？

完全不同的方法是为每个用户配置一个新的Docusign帐户，但这似乎不对。如果有人能指出我正确的方向，我会非常感激。

Answer 1

实际上这不是问题的基本问题，我会说如果你问如何在文档上发送签名请求，或者从一个基本的模板发送签名请求，但是如何组合和发送多个模板并在其中填充值是更多参与。

话虽如此，要将多个模板组合成签名请求，您只需在信封定义中使用复合模板节点即可。使用复合模板，您可以组合帐户中的多个服务器端模板，或将模板与本地文档或来自其他来源（即云）的文档组合在一起。

关于您的问题：

<强> 1

您可以进行API调用，以编程方式检索帐户中可用的模板，然后在用户界面中显示您想要的任何方面，例如名称，说明，模板ID等。一旦用户（或您的应用） logic）指出他们想要组合成签名请求的模板，你可以像这样组合它们（这结合了2个服务器模板）：

{  
    "emailSubject":"DocuSign Signature Request using Composite Templates",
    "status":"sent",
    "compositeTemplates":[  
        {  
            "serverTemplates":[  
                {  
                    "sequence":"1",
                    "templateId":"55A80182-2E9F-435D-9B16-FD1E1C0F9D74"
                }
            ],
            "inlineTemplates":[  
                {  
                    "sequence":"1",
                    "recipients":{  
                        "signers":[  
                            {  
                                "name":"John Doe",
                                "email":"firstrecipient@gmail.com",
                                "recipientId":"1",
                                "clientUserId":"1001",
                                "roleName":"RoleOne"
                            }
                        ]
                    }
                }
            ]
        },
        {  
            "serverTemplates":[  
                {  
                    "sequence":"2",
                    "templateId":"44D9E888-3D86-4186-8EE9-7071BC87A0DA"
                }
            ],
            "inlineTemplates":[  
                {  
                    "sequence":"2",
                    "recipients":{  
                        "signers":[  
                            {  
                                "name":"Jane Doe",
                                "email":"secondrecipient@gmail.com",
                                "recipientId":"1",
                                "clientUserId":"1002",
                                "roleName":"RoleOne"
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

<强> 2]

是的，如果您想要embed your recipients（这意味着他们通过您的用户界面而非通过DocuSign网站或应用进行签名），那么建议您使用iFrame用于网络应用和{{1适用于移动应用。要嵌入给定的收件人，您必须在上面的示例中为两个收件人设置Webview。这是一个字符串，在客户端定义，您只需要记住您为每个收件人使用哪些值来生成每个收件人的签名URL（您将在iFrame中加载）。

查看clientUserId API配方，了解如何完成此操作的示例代码。该示例不使用模板来创建信封，但它显示了如何生成唯一的签名URL：

Signing from within your app

或者如果您想使用原始API调用（不使用DocuSign SDK）进行测试，您可以使用API Explorer来测试这些调用：

API Explorer

第3]

你基本上有第三个问题，我认为这是如何在模板中填充选项卡（也就是文档字段）。您可以通过"Signing from within your app"标识给定标签，并使用tabLabel属性填充其值。例如，如果您有两个类型为value的选项卡（在UI中称为数据字段），则可以填充其值，如下所示：

textTab

Docusign API集成 - 如何发送多个模板和填充值

1 个答案:

关于您的问题：