能否用tabLabel填充现有草稿信封标签?若不行需用何种标识?
问题
能否使用tabLabel将数据映射到现有信封的标签中?若不可行,是否只需指定tabId来标识要填充的标签,还是有其他标识可用?
背景
此前我基于模板创建信封时填充标签,文本标签的JSON如下:
{ "textTabs": [ { "tabLabel": "text", "value": "Jabberwocky!" } ] }
我将另一表单构建服务的字段内容映射到DocuSign表单的标签,通过tabLabel指定填充目标,此方式在创建草稿信封时可正常工作。
但我需要用后续独立表单的提交内容填充草稿信封中的更多标签,希望沿用现有「表单字段>tabLabel」的映射关系,但使用Envelopes Update或EnvelopeRecipientTabs接口时,DocuSign会新增标签而非更新现有标签。
据我观察,每次创建新信封都会生成唯一的tabId,因此使用固定的tabLabel会更便捷。
回答
- 可以用
tabLabel更新现有标签,但要注意接口参数:使用EnvelopeRecipientTabs的PUT更新接口时,默认参数anchorIgnoreIfNotPresent为true,这会导致匹配不到对应tabLabel的标签时直接新增。你需要在请求中显式设置anchorIgnoreIfNotPresent: false,同时保证tabLabel与现有标签的名称完全一致,就能实现通过tabLabel定位并更新现有标签,而非新增。 - 除了
tabId,还可以用自定义的externalId:在创建模板或草稿信封时,给标签指定固定的externalId(这个值由你自己定义,不会随信封生成而变化),后续更新标签时通过externalId来定位,比动态生成的tabId更便捷稳定,不用每次生成信封后去获取新的tabId。 - 优先选择正确的接口:Envelopes Update接口主要用于修改信封的整体属性,更新标签建议使用EnvelopeRecipientTabs的
PUT接口,配合上述参数设置,才能达到预期的更新效果。
内容的提问来源于stack exchange,提问作者Alex S
相关产品推荐
相关产品推荐

