DocuSign:如何在收件人选项卡中发送无线电组选择?

时间:2013-08-12 05:22:44

标签: docusignapi

我在模板中设置了广播组,我想使用REST API预先填充这些标记。

请不要询问代码和/或请求/响应转储。我没有任何代码要显示,我要求这个,因为它没有记录。我想知道我需要生成什么样的JSON,所以这真的不是我的代码或编程语言。


(此行以下的任何内容都是半咆哮,一半描述了我找不到此功能文档的失败尝试。如果其他人对我有完全相同的问题,它可能仍然有用。)

Here是我尝试使用的API的文档。 textTabs有一个示例,但此处未提及radioGroupTabs。它被提到here但我无法从"null"中获得很多,显然我应该发送除null之外的其他内容。

继续,我可以在广播组中找到的唯一有用的信息是关于如何在模板中创建它们,它是here。此页面也未提及有关预填充收件人值的任何信息。但无论如何,它都来自here(请参阅tabs)。这里有一些信息:

value: if an X, this is the selected radio button. Only one radio button in a group can be selected.

然后就在此之前说:

selected: Sets if this is radio button is selected. Use true/false to show the value is selected or not. Only one radio button can be true.

因此我们了解到,只有两种方法可以指定所选的无线电小部件。当然,这适用于您创建窗口小部件。

尽管如此,我试图提出请求,假设这也适用于预填充我得到了这个有用的错误消息:

{
  "errorCode": "UNSPECIFIED_ERROR",
  "message": "Object reference not set to an instance of an object."
}

当我搜索支持论坛时,我发现this,它与我的问题不完全相同,我很高兴能够设置错误的无线电小部件(而不是获取{ {1}})但这篇文章是关于XML API的。

我开始疯狂地搜索新主题按钮,它的位置非常好,通常可以在不到10分钟内找到它。我记得我曾经去过我的个人资料,然后点击那里的东西......然后我做了每个理性开发人员首先要做的事情,然后回到帖子URL并阅读面包屑; UNSPECIFIED_ERROR部分已重命名为Dev Zone。我在这里。

有人可以告诉记录这个功能的位置,或者可以提供一个样本JSON吗?

1 个答案:

答案 0 :(得分:1)

您找到了how to create radio buttons的正确页面,不确定为何您在使用该资源时遇到问题。您已经提到过创建单选按钮选项卡而不是发送它们的代码。这是不正确的 - 发送请求的请求正文只是请求的状态属性从创建更改为已发送

我刚刚测试了发送两个单选按钮,默认情况下选择了第一个按钮,它对我来说很好。这是我用于文档签名请求的完整请求主体,这对您也适用:

{
"emailBlurb": "Testing DocuSign radio buttons",
"emailSubject": "Custom PHP script",
"status": "sent",
"documents": [
    {
        "documentId": "1",
        "name": "test.pdf"
    }
],
"recipients": {
    "signers": [
        {
            "email": "john.doe@docusign.com",
            "name": "John Doe",
            "recipientId": "1",
            "tabs": {
                "signHereTabs": [
                    {
                        "xPosition": "100",
                        "yPosition": "200",
                        "documentId": "1",
                        "pageNumber": "1"
                    }
                ],
                "radioGroupTabs": [
                    {
                        "documentId": "1",
                        "groupName": "RadioGroup1",
                        "radios": [
                            {
                                "pageNumber": "1",
                                "selected": "true",
                                "value": "X",
                                "xPosition": "300",
                                "yPosition": "75"
                            },
                            {
                                "pageNumber": "1",
                                "selected": "false",
                                "xPosition": "350",
                                "yPosition": "75"
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

}

除此之外,上面的示例使用绝对定位来定位文档上的单选按钮。在DocuSign中指定选项卡位置的另一种方法是使用所谓的“锚点标记”。使用锚标记而不是基于坐标系定位,您可以根据文档内容定位标签。请参阅以下两个链接以了解如何使用锚标记,切换到此方法非常容易:

Anchor Tagging Introduction - Look at the "Tab Positioning" section

Related Stack Overflow Link