allowmarkup bug导致texttab被共享

时间:2017-06-14 14:07:26

标签: docusignapi

一切正常,直到第一位签名者在签名过程中点击“其他操作”下的“加注”。当发生这种情况时,第二个签名者的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"
}

1 个答案:

答案 0 :(得分:1)

当" Markup"选择,字段表现不同。 docs说:

  

通常情况下,字段仅对其分配的收件人可见且可操作。对于文本,单选按钮,下拉列表和复选框字段,您可以选择设置协作属性,这使得字段对事务中的所有收件人都可见且可操作。如果使用文档标记,则当收件人激活标记功能时,这些字段类型将自动协作。

所以问题是如何设置collaboration property属性。

我做了一些调查,看起来API中的shared属性是UX中的collaboration property。 (当我们从UX测试中获得结果时,API属性名称通常与UX名称不同。)

我发现您将其设置为false。

要尝试的事情

首先尝试从网络工具复制行为:如果您发送的信封的文字字段包含"协作"关闭,不同的签名者选择" MarkUp"签名者是否有能力改变非协作领域?如果是这样,那么实施就是一个错误。

在您的测试中,所有签名者都不应该是信封的发件人,因为在某些情况下,发件人具有其他权限。

如果没有,则问题出在API级别,我们会在那里进行调查。

我也会尝试不设置shared属性,因为它的默认值为false。