#DocuSignAPI 无法在强制签名中获取标题

#DocuSignAPI unable to fetch Title in captive signing

我有一份文件需要客户签名,客户应该可以更改他们的姓名和职务。我拖放了从自定义签名过程中填充的名称字段,同样我添加了标题字段并希望它能做同样的事情。

但是我尝试了下面的方法,结果总是空白。我无法使用以下内容对其进行预填充:

body = "<envelopeDefinition xmlns=\"http://www.docusign.com/restapi\">"
                    + "<emailSubject>API Call for adding signature request to document and sending</emailSubject>"
                    + "<status>sent</status>"
                    + "<documents>"
                    + "<document>"
                    + "<documentId>"+documentId+"</documentId>"
                    + "<name>" + documentName + "</name>"
                    + "</document>"
                    + "</documents>"
                    + "<recipients>"
                    + "<signers>"
                    + "<signer>"
                    + "<recipientId>1</recipientId>"
                    + "<name>" + recipientName + "</name>"
                    + "<email>" + recipientEmail + "</email>"
                    + "<clientUserId>" + planId + "</clientUserId>"
                    + "<title>CFO</title>" << 3rd Attempt
                    + "<tabs>"
                    + "<fullNameTabs>"
                    + "<fullName>"   // working perfectly                 
                    + "<xPosition>" + nameXPos + "</xPosition>"
                    + "<yPosition>" + nameYPos + "</yPosition>"
                    + "<documentId>"+documentId+"</documentId>"
                    + "<pageNumber>" + namePage + "</pageNumber>"
                    + "</fullName>"
                    + "</fullNameTabs>"     
                    + "<titleTabs>"
                    + "<title>"     // not pre-filling text              
                    + "<xPosition>" + titleXPos + "</xPosition>"
                    + "<yPosition>" + titleYPos + "</yPosition>"
                    + "<documentId>"+documentId+"</documentId>"
                    + "<pageNumber>" + titlePage + "</pageNumber>"
                    + "<name>GM</name><width>200</width>" << Tooltip works 
                    + "<value>General Manager</value>"  << Not working (bug?)
                    + "<tabLabel>General Manager</tabLabel>" << 2nd attempt
                    + "<required>false</required>"
                    + "</title>"
                    + "</titleTabs>"                         
                    + "<signHereTabs>"
                    + "<signHere>"
                    + "<xPosition>" + signatureXPos + "</xPosition>"
                    + "<yPosition>" + signatureYPos + "</yPosition>"
                    + "<documentId>"+documentId+"</documentId>"
                    + "<pageNumber>" + signaturePage + "</pageNumber>"
                    + "</signHere>"
                    + "</signHereTabs>"
                    + "</tabs>"
                    + "</signer>"
                    + "</signers>"
                    + "</recipients>"
                    + "</envelopeDefinition>";

这不是 DocuSign 中的错误。这是俘虏收件人类型的设计。专属收件人在 DocuSign 中不是已知用户,因此标题不存在。

解决方案非常简单,您需要使用文本选项卡,然后预填充它的值。

                + "<textTabs>"
                + "<text>"
                + "<xPosition>" + titleXPos + "</xPosition>"
                + "<yPosition>" + titleYPos + "</yPosition>"
                + "<documentId>"+documentId+"</documentId>"
                + "<pageNumber>" + titlePage + "</pageNumber>"
                + "<name>GM</name><width>200</width>"
                + "<value>General Manager</value>"
                + "<tabLabel>General Manager</tabLabel>"
                + "<required>false</required>"
                + "</text>"
                + "</textTabs>"