Export and Import a Healthcare Schema

You can export and import an individual HL7 schema between projects in an instance or from one instance to another (for example, from a development instance to a production instance).

Note:

Export and import of HL7 schemas is only supported in projects.

This capability provides a more granular approach to the export and import of schemas than offered by exporting and importing an entire project. Only the specific schema you selected in exported. With entire projects, all existing schemas are included in the export file.

Export a Schema

  1. In the navigation pane, click Projects.
  2. Click the project from which to export the schema.
  3. Click Healthcare Healthcare icon.
  4. Go to the Schemas section.
  5. For the schema to export, click Actions Actions icon, then select Export.

    A ZIP file of the schema is downloaded to your local drive.

Import a Schema

Do not edit the downloaded schema export file. The schema file to import must satisfy all of following requirements. Otherwise, the import process fails.
  • The file must contain a top-level folder named healthcareartifacts/.
  • The file must contain exactly one schema file matching healthcareartifacts/hcschema_*.xml.
  • The schema XML root element must be <healthcareSchema>.
  • Optional document files, if present, must match healthcareartifacts/hcdocument_*.xml.
  • Optional document files, if present, must use root element <healthcaredocument>.
  • No files are allowed outside healthcareartifacts/.
  1. In the navigation pane, click Projects.
  2. Click the project in which to import the schema.
  3. Click Healthcare Healthcare icon.
  4. In the Schemas section, click the Add icon.
  5. Click Import.
  6. Drag and drop the exported schema ZIP file into the field.
  7. If you want to replace an existing schema in this project, select Overwrite the schema definition, if it exists. You cannot overwrite a schema that is part of an active integration.