Trading Networks 10.3 | Administering and Monitoring B2B Transactions | Trading Networks Built-In Services Reference | Doc Folder | Summary of Elements in this Folder | wm.tn.doc:verify
 
wm.tn.doc:verify
Invokes the document verification service associated with the specified document to verify the digital signature on the document.
Input Parameters
bizdoc
Object The document for which you want to verify the signature. The document must be an instance of com.wm.app.tn.doc.BizDocEnvelope.
flags
Object (optional) Flags that specify the pre-processing actions for the document. If specified, the service uses the verify? flag to determine whether to verify the digital signature. The flags must be an instance of com.wm.app.tn.route.PreProcessingFlags.
Output Parameters
None.
Usage Notes
*Every TN document type is associated with a verification service. The wm.tn.doc:getEvents service looks up the appropriate verification service and executes it against the supplied document. The service attaches all resulting verification errors to the document and logs them to the activity log in the Trading Networks database (if the document is saved to the database). To retrieve the verification errors from the activity log, use wm.tn.doc:getEvents.
*The XML verification service uses the Signature and SignedBody queries to extract those portions of the document. The signature is extracted and base-64 decoded. The signed body is extracted and converted to bytes in the UTF8 encoding. The resulting byte data must have been signed with the extracted signature. Additionally, the digital certificate used to sign the byte data must be the same as the one in the profile for the document's sender. If all of these conditions are met, verification succeeds.
*If flags is non-null, the service uses the verify? flag to determine whether to verify the digital signature of the document. For the format of flags, see wm.tn.rec:PreProcessingFlags.