Docusignapi 角色名存储在哪里？它的进一步用途是什么？

我正在尝试使用RESTAPI将基于模板的信封发送给多个收件人，其中我需要设置TemplateRoles以将模板发送给其他用户，但我需要为每个模板角色条目设置RoleName。我想知道创建信封后，这个角色名将在哪里使用？还是在设置模板模板时需要突出？我在哪里可以从信封中看到角色名称

抱歉，新文档登录：）

---

多谢各位

DocuSign模板类似于蓝图或可重复使用的设计，可随时重复使用，以创建带有新收件人集的新信封。创建DocuSign模板时，需要为收件人放置一些

占位符

，这些占位符称为

roleNames

。现在，当您基于服务器模板创建新信封时，您将传递收件人的实际值，如角色名称的名称和电子邮件。例如，在您的服务器模板中，您创建了角色名称，如

Buyer

和

Seller

，并且服务器模板中使用的文档是卖方协议。现在，您希望为不同的卖方和买方重复使用模板，因此您将基于

卖方

和

买方

角色名称在信封中输入实际值

有关更多详细信息，请参阅

使用服务器模板的API示例如下所示，其中07a2484d-c144-4ad6-a218-85b96bcea4cb是您的servertemplateId，下面调用中的

roleName

应该与服务器模板中的一个完全匹配，在这种情况下，它是

Seller

和

Buyer

：

{
    "compositeTemplates": [{
        "compositeTemplateId": "1",
        "inlineTemplates": [{
            "recipients": {
                "signers": [{
                    "email": "selleremail@email.com",
                    "name": "Seller Name",
                    "recipientId": "1",
                    "roleName": "Seller",
                },
                {
                    "email": "buyeremail@email.com",
                    "name": "Buyer Name",
                    "recipientId": "1",
                    "roleName": "Buyer",
                }]
            },
            "sequence": "2"
        }],
        "serverTemplates": [{
            "sequence": "1",
            "templateId": "07a2484d-c144-4ad6-a218-85b96bcea4cb"
        }]
    }],
    "emailSubject": "Test flow with Templates",
    "status": "sent"
}

此外，我还将使用上面的设计模式，即CompositeTemplate来创建信封，而不是TemplateRole设计模式，因为CompositeTemplate具有更大的灵活性，并且在将来的任何新用例中都可以轻松更改