正确处理* NOT *选择选择选项

时间:2013-07-09 16:17:19

标签: docusignapi

我们正在我们公司开发一个项目,显示公司名单,并允许简单的DocuSign文书工作生成,已经填写了许多标签,以便我们可以减少不准确性并提高易用性。

使用REST API,我可以使用内部模板生成信封,甚至可以使用我们数据库中的信息填写收件人的一些选项卡(我们有信息的选项卡)。

我遇到的问题在于模板上的列表标签(select下拉框)。当从DocuSign网站本身生成信封时,选择框中选择了“ - 选择 - ”,我也在模板编辑器上看到了这一点,这是正确的,因为我们需要员工或经理选择那些东西(他们是必需的)。但是,使用API​​并且在为收件人标签执行listTabs时甚至没有触及PUT,即使在下拉列表中也没有“ - 选择 - ”向下,列表选项卡上的第一个选项已预先选定。

我们仍在使用DocuSign网站(通过电子邮件中的“查看文档”或只是打开网站上的用户收件箱)来填写文件;这一代是我们目前唯一使用API​​的方式。这个列表标签是一个问题;如果有人跳过选择那些列表选项卡,那么已经有一个预选值可能是错误的。即使选项卡被标记为需要,模板也会看到选择了一个值并通过了验证。有谁知道我在这里做模板或API调用是否有问题,或者这是一个错误吗?

我会提供代码,但它分散在很多Java类中,很难编译成stackoverflow问题上容易理解的东西。不仅如此,但正如我所说,在收件人选项卡上执行PUT时,我甚至都没有触及listTabs。

感谢您的时间。

1 个答案:

答案 0 :(得分:1)

好的所以我相信这是设计的,如果你想要“默认选择项目”,你只需要添加它。我会想象有些人不想要“null”选项所以api给出他们完全控制列表项,而当你通过控制台发送它似乎总是有“--select--”作为第一个选项。

当您通过控制台发送时,“ - select”选项旁边有一个复选标记,这意味着它只是另一个列表选项。我能够通过以下请求体来模仿这个:

{
"emailBlurb": "This goes in the email body",
"emailSubject": "API Signature Request",
"documents": [
    {
        "documentId": "1",
        "name": "document.pdf"
    }
],
"recipients": {
    "signers": [
        {
            "email": "<email_address_goes_here>",
            "name": "John Doe",
            "recipientId": "1",
            "tabs": {
                "signHereTabs": [
                    {
                        "xPosition": "250",
                        "yPosition": "75",
                        "documentId": "1",
                        "pageNumber": "1"
                    }
                ],
                "listTabs": [
                    {
                        "xPosition": "100",
                        "yPosition": "90",
                        "documentId": "1",
                        "pageNumber": "1",
                        "recipientId": "1",
                        "tabLabel": "DropDownList",
                        "listItems": [
                            {
                                "selected": "false",
                                "text": "--select--",
                                "value": "--select--"
                            },
                            {
                                "selected": "false",
                                "text": "One",
                                "value": "One"
                            },
                            {
                                "selected": "false",
                                "text": "Two",
                                "value": "Two"
                            },
                            {
                                "selected": "false",
                                "text": "Three",
                                "value": "Three"
                            }
                        ],
                        "width": "56"
                    }
                ]
            }
        }
    ]
},
"status": "sent"

}