一切正常,直到第一位签名者在签名过程中点击“其他操作”下的“加注”。当发生这种情况时,第二个签名者的TextTab(未设置为共享)可供第一个签名者输入。我不能为我的生活弄清楚如何配置API以避免这种情况。
这是Json发送的(用Fiddler捕获,敏感数据被更改),对不起大小。
{
"allowMarkup":"True",
"documents":
[
{
"documentBase64":"abc123...",
"documentId":"1",
"name":"Contract"
}
],
"emailBlurb":"This is a test email blurb",
"emailSubject":"This is my email subject.",
"enableWetSign":"False",
"eventNotification":
{
"envelopeEvents":
[
{"envelopeEventStatusCode":"sent"},
{"envelopeEventStatusCode":"completed"},
{"envelopeEventStatusCode":"declined"},
{"envelopeEventStatusCode":"voided"}
],
"includeCertificateOfCompletion":"True",
"includeCertificateWithSoap":"False",
"includeDocumentFields":"True",
"includeDocuments":"True",
"includeEnvelopeVoidReason":"True",
"includeSenderAccountAsCustomField":"True",
"includeTimeZone":"True",
"signMessageWithX509Cert":"False",
"url":"http://MyWebApi.com/DocumentCompleted",
"useSoapInterface":"False"
},
"recipients":
{
"signers":
[
{
"email":"me@me.com",
"name":"first signer",
"recipientId":"1",
"routingOrder":"1",
"tabs":
{
"dateSignedTabs":
[
{
"anchorCaseSensitive":"False",
"anchorIgnoreIfNotPresent":"False",
"anchorMatchWholeWord":"True",
"anchorString":"First Signer Signature",
"anchorUnits":"Inches",
"anchorXOffset":"2.2",
"anchorYOffset":"-0.2",
"name":"First Signer Signature",
"recipientId":"1",
"tabId":"First Signer Signature"
}
],
"signHereTabs":
[
{
"anchorCaseSensitive":"False",
"anchorIgnoreIfNotPresent":"False",
"anchorMatchWholeWord":"True",
"anchorString":"First Signer Signature",
"anchorUnits":"Inches",
"anchorXOffset":"0.04",
"anchorYOffset":"-0.27",
"name":"First Signer Signature",
"recipientId":"1",
"tabId":"First Signer Signature"
}
],
"textTabs":
[
{
"anchorCaseSensitive":"False",
"anchorIgnoreIfNotPresent":"False",
"anchorMatchWholeWord":"True",
"anchorString":"First Signer Name and Title",
"anchorUnits":"Inches",
"anchorXOffset":"-0.07",
"anchorYOffset":"-0.2",
"maxLength":45,
"name":"First Signer Name and Title",
"recipientId":"1",
"required":"True",
"shared":"False",
"tabId":"First Signer Name and Title",
"tabLabel":"First Signer Name and Title"
},
{
"anchorCaseSensitive":"False",
"anchorIgnoreIfNotPresent":"False",
"anchorMatchWholeWord":"True",
"anchorString":"CONTACT Print Name",
"anchorUnits":"Inches",
"anchorXOffset":"-0.07",
"anchorYOffset":"-0.2",
"maxLength":45,
"name":"CONTACT Print Name",
"recipientId":"1",
"required":"True",
"shared":"False",
"tabId":"CONTACT Print Name",
"tabLabel":"CONTACT Print Name"
},
{
"anchorCaseSensitive":"False",
"anchorIgnoreIfNotPresent":"False",
"anchorMatchWholeWord":"True",
"anchorString":"CONTACT Email Address",
"anchorUnits":"Inches",
"anchorXOffset":"0.07",
"anchorYOffset":"-0.2",
"maxLength":45,
"name":"CONTACT Email Address",
"recipientId":"1",
"required":"True",
"shared":"False",
"tabId":"CONTACT Email Address",
"tabLabel":"CONTACT Email Address"
}
]
}
},
{
"email":"me2@me.com",
"name":"Second Signer",
"recipientId":"2",
"routingOrder":"2",
"tabs":
{
"dateSignedTabs":
[
{
"anchorCaseSensitive":"False",
"anchorIgnoreIfNotPresent":"False",
"anchorMatchWholeWord":"True",
"anchorString":"Second Signer Signature",
"anchorUnits":"Inches",
"anchorXOffset":"2.2",
"anchorYOffset":"-0.2",
"name":"Second Signer Signature",
"recipientId":"2",
"tabId":"Second Signer Signature"
}
],
"signHereTabs":
[
{
"anchorCaseSensitive":"False",
"anchorIgnoreIfNotPresent":"False",
"anchorMatchWholeWord":"True",
"anchorString":"Second Signer Signature",
"anchorUnits":"Inches",
"anchorXOffset":"0.04",
"anchorYOffset":"-0.27",
"name":"Second Signer Signature",
"recipientId":"2",
"tabId":"Second Signer Signature"
}
],
"textTabs":
[
{
"anchorCaseSensitive":"False",
"anchorIgnoreIfNotPresent":"False",
"anchorMatchWholeWord":"True",
"anchorString":"Second Signer Name and Title",
"anchorUnits":"Inches",
"anchorXOffset":"-0.07",
"anchorYOffset":"-0.2",
"maxLength":45,
"name":"Second Signer Name and Title",
"recipientId":"2"
,"required":"True",
"shared":"False",
"tabId":"Second Signer Name and Title",
"tabLabel":"Second Signer Name and Title"
}
]
}
}
]
},
"status":"sent"
}
答案 0 :(得分:1)
当" Markup"选择,字段表现不同。 docs说:
通常情况下,字段仅对其分配的收件人可见且可操作。对于文本,单选按钮,下拉列表和复选框字段,您可以选择设置协作属性,这使得字段对事务中的所有收件人都可见且可操作。如果使用文档标记,则当收件人激活标记功能时,这些字段类型将自动协作。
所以问题是如何设置collaboration property
属性。
我做了一些调查,看起来API中的shared
属性是UX中的collaboration property
。 (当我们从UX测试中获得结果时,API属性名称通常与UX名称不同。)
我发现您将其设置为false。
要尝试的事情
首先尝试从网络工具复制行为:如果您发送的信封的文字字段包含"协作"关闭,不同的签名者选择" MarkUp"签名者是否有能力改变非协作领域?如果是这样,那么实施就是一个错误。
在您的测试中,所有签名者都不应该是信封的发件人,因为在某些情况下,发件人具有其他权限。
如果没有,则问题出在API级别,我们会在那里进行调查。
我也会尝试不设置shared
属性,因为它的默认值为false。