CDA Validator

The CDA Validator component is used as an example component for validating CCDA documents (via the https://interfaceware.atlassian.net/wiki/x/AQAyyw ). This is useful for ensuring documents you’ve created are compliant with HL7 CCDA specifications, whether in the development process or as part of your integration workflow. It demonstrates how to validate a CCDA document and parse the validation results.

Running the Component

The CDAVALIDATOR library uses third party utilities (xsltproc and xmllint) to validate the CCDA document. These are included in the library for Windows but may require manual installation if running Iguana on MacOS or Linux.

STEP 1: Import the CDA Validator component

Using +COMPONENT, import the CDA Validator

STEP 2: Optionally, create a CDA document to validate using the CDA Creator component

If you don’t have an existing CCDA document that needs validating, you can create a sample document using the https://interfaceware.atlassian.net/wiki/x/JICqrw.

STEP 3: Specify the CCDA file to validate and the version it should be validated against

Set a target CCDA via the CCDAFilepath custom field to specify where the CCDA that will be validated is stored. Specify the CCDAversion that the component should use for validation.

STEP 4: Start the component and view the generated CDA

On starting, if successful, the component will display a validation success message:

If unsuccessful, the component will error out and log the details of the failed validation:

By default, the component outputs all Schema and Shall errors. You can also edit the script to adjust the mode to include Should errors by going to the parseValidationResults function and changing the mode to 2 as shown below: