我正在研究使用DocuSign API发送和接收信封和签名的文档。
DocuSign是否提供“事件ID”或信封状态更新中唯一的内容?我想知道我们是否已经处理了此事件。
我的问题是,有什么方法可以轻松识别从DocuSign收到的状态更新中发生了什么变化?
还是将WebAPI调用转换为SDK对象和方法的适当方法?
答案 0 :(得分:0)
状态更新将包括唯一的EnvelopeID(这是一个GUID)以及信封状态,该信封状态是固定数量的值之一,例如“已发送”,“无效”,“完整”等。
答案 1 :(得分:0)
有一个技巧可以用来了解信封中发生了什么变化而无需解析完整的XML。如果您的Rest Listener为https://www.acme.com/connect
,则可以向连接URL添加另一个查询参数,并且URL应该类似于
https://www.acme.com/connect?event=envelopeDecline
https://www.acme.com/connect?event=envelopeComplete
等。然后通过将正确的触发事件映射到正确的Rest侦听器URL,创建多个Connect配置作为您的DS帐户。
像https://www.acme.com/connect?event=envelopeComplete
那样的配置仅应具有信封签名/完成的信封级触发事件。
与此类似,https://www.acme.com/connect?event=envelopeDecline
应该仅配置“信封被拒绝”信封=级别触发事件。
通过这种方式,您的侦听器必须首先读取查询参数,这将告诉您XML是哪种类型的XML或XML中发送信封的状态,然后将您的代码定向到正确的处理方法以进一步解析XML。通过执行此技巧,将告诉您的侦听器信封中发生了什么更改,并且可以根据查询参数值来尽快调用正确的业务方法。