This is documentation for ART-DECOR Release 2 and tends to be out-dated. Please visit our new documentation site at docs.art-decor.org

ART-DECOR in four bullet points:

  • ...is an open-source open source collaboration platform and a methodology for various multidisciplinary stakeholders of healthcare information exchange
  • ...supports comprehensive collaboration of team members within and between governance groups
  • ...allows separation of concerns and different views on a single documentation for different domain experts
  • ...supports creation and maintenance of profiles/templates, value sets, data elements and data sets and more

What is ART-DECOR?

ART-DECOR is an open source collaboration platform for experts from medical, terminological and technical domains aiming on creation and maintenance of dataset with data element descriptions, use case scenarios, value sets and Health Level 7 (HL7) templates and profiles.


DECOR (Data Elements, Codes, OIDs and Rules) is a methodology to capture the data needs of caregivers in terms of datasets and scenarios and use it to generate various artefacts: documentation, value sets, XML instance validation, generation and processing support, and test tools etc.

DECOR allows to iteratively improve recorded data definitions and link together input from various experts with different background knowledge: caregivers, terminologist, modellers, analysts and interface/communication specialists.

Book-open-variant.svg Movie.svg

For caregivers, the tools mainly registers data elements and their collections as data sets with concepts, data types, allowable value ranges, identifications, codes, examples and business rules etc. In addition, use case specific Scenario's can be documented.


From the base requirements, the caregivers documented, terminologist can add the appropriate codes, associate caregiver concepts with coded concepts and create and maintain the value sets to be used. Typically also namespaces, identifiers, URIs and OIDs are assigned.


Modelers, analysts and interface / communication specialists add the technical representations as e.g. HL7 CDA templates, HL7 FHIR or IHE profiles. During that design phase and also in the following implementation and production phases the tool allows comprehensive validation and testing.

Project leads

During development and production phases stakeholders and team members of the governance group are supported by an artefact-aware issue and reporting management that enables effective change management of the artefacts.

The underlying DECOR data format is XML. The generation of HTML-, PDF- and Wiki-based documentation and XML-materials like validation and test environments is possible through a release and archive management function and transformations with stylesheets. The technical artefacts like templates and value sets can be used as input for test suites like IHE Gazelle ObjetcsChecker. Easy consistency checks across all artefacts can be achieved, CDA-based template definition can be verified to be standard conformant with the underlying CDA standard.


ART (Advanced Requirement Tooling) is the DECOR user interface to create and adapt DECOR files, and to generate artefacts from DECOR files.

ART is the backend, based on the eXist-db XML database. ART is also the frontend, until ART-DECOR 2.x, XQuery and Orbeon XForms is used. ART-DECOR 3.0 is completely replacing the former UI platform and uses Vue and Vuetify.
 Existdb-logo.gif  Orbeon-logo.png Vue.png

ART-DECOR Expert Group and our volunteers


The kernel activities around the tool, its concepts and methodology, development and practice is done by the ART-DECOR Expert Group, a group of acknowledged experts in health IT. We have to thank the many volunteers who contributed to the ART-DECOR tooling with testing, testing, testing, features requests and the right questions. Learn more about the individuals behind ART-DECOR.

ART-DECOR® Open Tools


ART-DECOR® Open Tools has been established in 2016 as an Entrepreneurial Company with limited liability (German: Unternehmensgesellschaft mit beschränkter Haftung). It handles the commercial aspects of the ART-DECOR® tool suite development and offers/handles support plans for organizations who want ART-DECOR server support for development or production environments. ADOT provides sustainability and thus complements the ART-DECOR® Expert Group that drives the development. For more information visit the website of ART-DECOR® Open Tools.

Who benefits from ART-DECOR?

With ART-DECOR, experts with different backgrounds, such as healthcare professionals, terminologists, architects, designers and programmers together enter the necessary data, iteratively improve and connect those, all using the same underlying data store. ART-DECOR registers datasets, data types, value sets, identifications, codes, business rules, (HL7v3) templates and contains version management

Use it for what?

ART-DECOR can be used by:

  • Regional and national networks for data exchange in healthcare.
  • Larger healthcare institutions or collaborations to improve the internal data exchanges.
  • Software vendors in healthcare looking for simpler ways to implement complex specifications.
  • IT service providers in healthcare such as ASPs.
  • All parties who facilitate complex data exchanges or data stores in healthcare.

Use it for free!

ART DECOR is 100% free and:

  • Is the basis for capturing data definitions in healthcare.
  • Contains tools for governance and version management.
  • Supports various forms of publication.
  • Contains issue management to iteratively improve data definitions.
  • Enables and simplifies the creation and validation of examples and test scenarios.
  • Generates a web page on the fly to enter examples for each dataset.
  • Contains tools for conformance testing of participating parties.
  • Can be used by others as a basis for the construction of code generators, automatic questionnaires, user interfaces, conversions of data formats, database diagrams and much more.

Used in practice!

ART DECOR is the base for specification, documentation and testing in more than 40 projects and used right now in Germany, Austria, Italy, Poland, Norway, Lithuania and the Netherlands, among other countries. National Infrastructure Programmes such as by Nictiz (the National Healthcare Standards Institute), RIVM (the Dutch National Public Health Authority), ELGA – Electronic Health Record Austria and eHealth Suisse in Switzerland, ART-DECOR® plays an important role. For more information about some of the projects see also our projects list page.

Take a look at

A public ART-DECOR instance online is also available, which features a sandbox and demo environment. If you want to "play" with this project go to Sandbox: EKG Report CDA Document.

Information.svg You need to log in before working in the sandbox. Use username demo and password demodemo. Please note that all changes to this project will be overwritten every day at 0300 Coordinated Universal Time UTC. We apologize to users who are in a time zone where this is in the middle of the day.

Project hosting

We offer free project hosting on ART-DECOR. Feel free to Contact us if you are interested. If you are interested in running and hosting your own ART-DECOR® servers with support, contact ART-DECOR® Open Tools.