从模板创建Envelope时接收方与模板角色不匹配无报错问题咨询

目前DocuSign未提供原生配置项或SDK内置方法直接实现「传入签署方角色与模板预设角色强制匹配校验」的能力，你提出的提前查询模板角色再比对的方案是当前最可行的可输出精准错误信息的实现方式。

具体实现步骤 #

• 调用TemplatesApi对应的查询模板详情方法（不同语言SDK命名略有差异，常见为get_template/ListTemplate），从返回结果的recipients字段中提取所有预设的签署方角色名称，存入模板角色集合
• 调用createEnvelope接口前，提取当前请求携带的所有签署方的角色名称，存入传入角色集合
• 执行两层自定义校验：
  • 校验传入角色集合中的所有元素是否都存在于模板角色集合中，不存在则直接抛出角色[xxx]不存在于当前模板的精准错误
  • 校验模板角色集合中的所有元素是否都已在传入角色集合中赋值，可根据业务需求选择抛出当前缺少模板必填角色[xxx]错误或跳过继续执行

补充说明 #

你之前用到的角色高级设置是目前官方唯一提供的内置校验入口，其报错信息模糊是已知的产品限制，目前暂未开放自定义报错内容或更细粒度的校验规则配置权限。

内容的提问来源于stack exchange，提问作者Diego Romeo Masinsin