Docusign：如何确保用户必须输入姓名才能签名？答案

【问题标题】：Docusign : How can I ensure that user has to enter name for signing?Docusign：如何确保用户必须输入姓名才能签名？
【发布时间】：2015-02-04 15:23:00
【问题描述】：

我有嵌入式签名 API。该文档显示良好，并且允许用户签名并完成。一切正常。现在，业务用户有一个要求，他们希望确保用户必须输入他们的姓名。那可能吗？我尝试不发送 xml 中的 '' 属性或发送空白值

'<name>'

但他们都返回错误。我必须为

发送一个值

'<name>'

在请求中，这是在要选择的签名字段中自动显示的名称。是否可以确保用户必须在字段中输入姓名然后接受它作为签名？

谢谢

更新

我正在使用 C#，我有这个 xml：

"<envelopeDefinition xmlns=\"http://www.docusign.com/restapi\">" +
            "<status>sent</status>" +
            "<emailSubject>DocuSign API - Embedded Signing example</emailSubject>" +
            "<templateId>" + templateId + "</templateId>" +
            "<templateRoles>" +
                "<templateRole>" +
                    "<email>" + recipientEmail + "</email>" +
                    "<name>" + recipientName + "</name>" +
                    "<roleName>" + templateRole + "</roleName>" +
                    "<clientUserId>" + clientUserId  + "</clientUserId>" + 
                    "<tabs>" +
                        "<textTabs>" +
                            "<anchorString>Full Name</anchorString>" +
                            "<tabLabel>Full Name</tabLabel>" +
                            "<documentId>1</documentId>" +
                            "<pageNumber>1</pageNumber>" +
                            "<recipientId>1</recipientId>" +
                            "<xPosition>24</xPosition>" +
                            "<yPosition>153</yPosition>" +
                            "<value>" + "Enter Name here" +"<value>" +
                            "<required>true</required>" + 
                        "</textTabs>" +
                    "</tabs>" + 
                "</templateRole>" +
            "</templateRoles>" +
            "</envelopeDefinition>";

我得到这个错误：

<errorCode>INVALID_REQUEST_BODY</errorCode>
  <message>The request body is missing or improperly formatted. The XML request does not match the expected format. </message>

【问题讨论】：

对于嵌入式签名，对签名者有 3 个要求：姓名、电子邮件@、clientUserID。由于您已经在传递签名者姓名，因此您可以使用“全名”DocuSign 选项卡，该选项卡将自动填充他们的姓名。如果您想使用空白文本框，则需要使用“必需”属性标记该选项卡。
我不希望自动填充“全名”DocuSign 选项卡。我希望用户写下或输入他们的名字。如何使用所需属性标记选项卡？
文档中有示例 - 这是 REST 示例：docusign.com/p/RESTAPIGuide/…
那么在请求 url 时将这个 Text Tab xml 作为 json 传递？而“anchorString”应该是“全名”？
我看到上述请求存在几个问题。对于初学者，您缺少定义每个文本选项卡的额外 XML 节点。接下来，您需要删除 anchorString 属性，因为您使用的是绝对定位。您的值 XML 节点中还缺少右斜杠 (/) 字符。发布包含所有修复的响应...

标签： docusignapi

【解决方案1】：

您需要用户输入姓名的业务用例到底是什么？您是否试图通过让他们在文本字段中写下他们的全名来创建某种额外形式的确认或同意？如果是这样，为什么不在你的信封里放一个单选按钮，上面写着“我同意 blah blah blah ...”，让他们选择是或否，然后从那里开始？如果他们选择“是”按钮并让他们填写该字段，您甚至可以弹出一个条件字段，等等。

话虽如此，如果仍想为签名者设置一个必需的、可编辑的数据字段以输入他们的姓名，您可以通过 API 执行此操作，您只需要修复我在上面的评论中列出的问题。以下是您可以使用的示例 XML 和 JSON：

<textTabs>
    <text>
        <tabLabel>Full Name</tabLabel>
        <locked>true</locked>   
        <required>true</required>   
        <documentId>1</documentId>
        <pageNumber>1</pageNumber>
        <recipientId>1</recipientId>
        <xPosition>24</xPosition>
        <yPosition>153</yPosition>
        <value>Enter Name here</value>
    </text> 
</textTabs>

这是 JSON 版本：

"textTabs": [
{
    "tabLabel": "Full Name",
    "locked": "false",
    "required": "true",
    "pageNumber": "1",      
    "documentId": "1",              
    "xPosition": "200",
    "yPosition": "200",
    "value": "Enter Name here"
},

【讨论】：