使用REST API

时间:2016-06-23 22:23:58

标签: docusignapi

无法预先填充公司和标题的默认标签,但textTabs user_name可以正常使用。我也可以更改字段的锁定属性,但不能更改值。

params = {
    "accountId" : ACCOUNT_ID,
    "emailSubject": "Test Sign",
    "emailBlurb": "Auto generated",
    "templateId": POWERFORM_ID,
    "templateRoles": [{
        "clientUserId" : str(user_id),
        "roleName": "Recipient",
        "name": name,
        "email": email,
        'company': 'test',
        'Company': 'test21',
        "tabs": {
            "companyTabs": [{
                "tabLabel": "Company",
                "value": 'this is a test',
            }],
            "textTabs": [{
                "tabLabel": "user_name",
                "value": user_name,
            }],
            "titleTabs": [{
                  "value": title,
                  "required": "true",
                  "tabLabel": "Title",
            }],
        },
  }],
  "status":"sent"
}

2 个答案:

答案 0 :(得分:5)

原始海报的答案是正确的。我正在扩展它:

The list of tabs and their descriptions.

某些选项卡允许签名者输入值。那些标签'可以通过Web浏览器或API预设值。

其他标签类型使用已经"已知"通过DocuSign平台。这些选项卡不能通过API或浏览器在每个选项卡上更新其值。在某些情况下,可以使用不同的技术设置信息。例如,全名标签使用签名者的名称,该名称在请求的其他位置设置。

以下是选项卡列表以及您是否可以在选项卡定义中设置其值:

  • Approve Tab:[无法设置值]将此标签放在您希望收件人在信封中批准文档的文档上,而不在文档上放置签名或缩写。如果收件人在签名过程中单击“批准”选项卡,则会认为收件人已签署该文档。没有信息显示在文件上以供批准,但它在信封历史记录中记录为签名。
  • Checkbox Tab:[可以设置值]将此标签放在文档中收件人可以选择是/否(开/关)类型选项的位置。
  • Company Tab:[无法设置值]将此标签放在要显示收件人公司名称的文档上。
  • Date Signed Tab:[无法设置值]将此标签放在您希望收件人签署文档的日期自动显示的文档上。
  • Date Tab:[可设置值]将此标签放在您希望收件人输入日期的文档上。日期选项卡是单行字段,允许以任何格式输入日期信息。此选项卡的工具提示建议输入日期为MM / DD / YYYY,但不会强制执行此操作。保留签名者输入的格式。如果您需要强制执行特定日期格式,DocuSign建议使用带有验证模式和验证消息的文本选项卡来强制执行格式。
  • Decline Tab:[无法设置值]将此标签放在要为收件人提供拒绝信封选项的文档上。如果收件人在签名过程中单击“拒绝”选项卡,则信封无效。
  • Email Tab:[可以设置值]这是一个接受任何字符的单行字段。
  • Email Address Tab:[无法设置值]将此标签放在您希望收件人信息中输入的收件人电子邮件的文档中。
  • Envelope ID Tab:[无法设置值]将此标签放在要显示信封ID的文档上。收件人无法在此选项卡中输入或更改信息,仅供参考。
  • First Name Tab:[无法设置值]将此标签放在您希望收件人的名字出现的文档上。此选项卡采用收件人信息中输入的收件人姓名,将其拆分为基于空格的部分,并使用第一部分作为名字。
  • Formula Tab:[可设置值(通过公式字段)]此选项卡用于将计算字段添加到文档。信封收件人无法直接在选项卡中输入信息;公式选项卡计算并在对参考选项卡值进行更改时显示新值。参考选项卡信息和计算操作输入"公式"元件。有关公式的详细信息,请参阅“使用计算字段功能快速入门指南”或“DocuSign服务用户指南”。
  • Full Name Tab:[无法设置值]将此标签放在要显示收件人姓名的文档上。
  • Initial Here Tab:[无法设置值]将此标签置于收件人必须初始化文档的位置。此选项卡可以设置为可选。
  • Last Name Tab:[无法设置值]将此标签放在您希望收件人姓氏出现的文档上。此选项卡采用收件人信息中输入的收件人姓名,根据空格将其拆分为多个部分,并使用最后一部分作为姓氏。
  • List Tab:[可以设置值]此选项卡包含收件人可以选择的选项列表。 listItems参数用于设置可以选择的选项。
  • Note Tab:[可设置值]将此标签放在要在文档上为收件人添加备注的文档中。
  • Number Tab:[可设置值]此选项卡是收件人可以输入数字和小数(。)点的字段。
  • Radio Group Tab:[可设置值]此组选项卡用于在文档上放置单选按钮。 radios参数用于添加和放置与该组关联的单选按钮,并且只能在一个组中选择一个单选按钮。
  • Sign Here Tab:[无法设置值]将此标签置于收件人必须在文档中签名的位置。此选项卡可以设置为可选。
  • Signer Attachment Tab:[无法设置值]签名者附件是收件人启动将支持文档添加到信封的过程。
  • SSN Tab:[可以设置值]此选项卡是一个单行字段,收件人可以在其中输入数字。可以使用或不使用短划线键入SSN。
  • Text Tab:[可以设置值]此选项卡是收件人可以输入任何类型字符的字段。
  • Title Tab:[无法设置值]将此标签放在要显示收件人标题的文档上。
  • Zip Tab:[可以设置值]此选项卡是一个单行字段,收件人可以在其中输入数字。

答案 1 :(得分:2)

文档不清楚这一点,但我会假设默认选项卡无法编辑,并预先填写信封或用户的帐户。只有textFields似乎可编辑。