如果您已创建 DocuSign 模板并且只是使用 API 基于模板创建/发送信封,那么您可以简单地修改模板中的数据字段属性以指示它必须包含一个数值。为此,只需编辑字段的属性,将 Mask 设置为“Number”。
当通过 API 与具有 Mask = Number 的数据字段进行交互时,它将是 numberTab 类型 - 即在 API 请求/响应中不再是 textTab 类型。例如,下面是对“Get Recipients”请求的响应,其中包含上述屏幕截图所表示的“Quantity”字段:
{
"signers": [
{
"tabs": {
"numberTabs": [
{
"validationPattern": "",
"validationMessage": "",
"shared": "false",
"requireInitialOnSharedChange": "false",
"name": "Quantity",
"value": "",
"width": 42,
"required": "true",
"locked": "false",
"concealValueOnDocument": "false",
"disableAutoSize": "false",
"tabLabel": "Quantity",
"bold": "false",
"italic": "false",
"underline": "false",
"documentId": "1",
"recipientId": "f1b5d256-d85c-42d3-b081-913fb93e13a7",
"pageNumber": "1",
"xPosition": "71",
"yPosition": "37",
"tabId": "cf6367eb-de3d-4978-965e-2c29946989f2"
}
]
},
"signInEachLocation": "false",
"name": "",
"email": "",
"recipientId": "f1b5d256-d85c-42d3-b081-913fb93e13a7",
"recipientIdGuid": "f1b5d256-d85c-42d3-b081-913fb93e13a7",
"requireIdLookup": "false",
"routingOrder": "1",
"roleName": "Signer1",
"status": "created",
"templateLocked": "false",
"templateRequired": "false"
}
],
"agents": [],
"editors": [],
"intermediaries": [],
"carbonCopies": [],
"certifiedDeliveries": [],
"inPersonSigners": [],
"recipientCount": "1"
}