3.869
Bearbeitungen
Änderungen
→XDS-Metadaten-Mapping
|description= Hier finden Sie eine Erklärung zu der Erstellung von CDA-Leitfäden mit Art-Decor.
}}
{{BeginYellowBox}}Eine '''Einleitung in Art-Decor''' finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Introduction '''ART Introduction'''].
<br>
Eine Übersicht '''verfügbarer Anleitungen''' sind unter [https://www.art-decor.org/mediawiki/index.php?title=ART_user_manual '''ART user manualmanuals'''] aufgelistet.<br><br>{{EndYellowBox}}
Folgende Vorgehensweisen werden bei der Erstellung von Leitfäden als '''Best Practices''' empfohlen.
:Hierfür die [https://art-decor.org/art-decor/decor-governance-group?id=1.2.40.0.34.3.1.2 '''Art-Decor Governance Group'''] aufrufen und alle bestehenden Templates auflisten lassen, sodass deren Wiederverwendbarkeit geprüft und ermittelt werden kann, welche OID als nächstes vergeben werden darf.
* Neue, '''allgemeine''' e-Health-/ELGA-Basistemplates sollen generell im [https://art-decor.org/art-decor/decor-project--at-cda-bbr- ATCDABBR ] angelegt und so allgemein definiert werden, dass sie für andere Leitfäden verwendbar sind (ohne Value Sets, ohne projektspezifischen Angaben!)(*). Dies stellt sicher, dass alle Projekte Templates aus dem ATCDABBR ableiten und spezifizieren können (Value Sets ergänzen usw.).
:Beispiel: Section-Template „Durchgemachte Krankheiten“ im ATCDABBR wird abgeleitet in Section-Template „Impfrelevante Erkrankungen - kodiert“ im e-Impfpass.
(*) Bei fehlender Berechtigung können Basistemplates im Projektverzeichnis erstellt werden und später durch berechtigte Personen in das ATCDABBR verschoben werden.
===Übernahme bestehender Templates===
Um herauszufinden, welche Art-Decor Projekte (auch außerhalb der eigenen Governance-Group) bereits ein bestimmtes Template umgesetzt haben, kann man im Menüpunkt '''„Auge“''' (links oben in der ArtDecor-Projektseite), die Template-ID oder den Namen eines Templates angeben -> alle Templates mit zugehörigem Projekt werden aufgelistet.<br>
Je nachdem, ob das Projekt, in dem sich das zu übernehmende Template befindet, im eigenen Projekt verlinkt ist, muss wie folgt vorgegangen werden:
==== Verlinktes Projektverzeichnis ====
Übernahme eines vorhandenen Templates aus einem '''verlinktem Projektverzeichnis''' (siehe [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Creating_a_link_to_a_template_that_resides_in_a_BBR Bestehendes Templates aus einem anderen BBR referenzieren])
* '''ReferenzierenReferenzierung''' (unveränderte Übernahme) des Templates mit Kettensymbol
:* Keine Änderung des Templates möglich!
:* Nur verwenden, wenn es bereits ein passendes ELGA-/e-Health-Template gibt
:<code><nowiki>https://art-decor.org/temple/modules/temple.xquery?id=[OID des Templates]</nowiki></code>
der '''XML-Code jedes Templates''' via [https://www.art-decor.org/mediawiki/index.php?title=Temple '''Temple'''] (im Lesemodus) anzeigen und anschließend kopieren. Der kopierte Inhalt kann dann in ein neu erstelltes, leeres Template (mittels "+" und "Create from scratch") eingefügt werden. Dabei ist zu beachten, dass der '''Zeitpunkt (effectiveDate)''' und die '''OID des neu erstellten Templates nicht verändert''' werden! Alle weiteren Inhalte können entsprechend angepasst werden. <br>
===Änderung bestehender Templates===
====Beispiel-Snippets====
* Code-Snippet-Gerüste können mit dem "Zaubstab" im ART Template Editor erzeugt werden (siehe [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Insert_example '''Insert example''']).
* In '''allen Templates''' (außer DLTs) werden nur '''Code-Snippets''' des betreffenden Templates selbst eingefügt. Beispiel-Snippets werden in der Regel nur zum Template selbst erstellt, nicht aber zu den darin verlinkten Templates - (z.B. included Entries - werden nicht im aufrufenden Template angeführt sondern nur im Entry selbst).
* Code-Snippets sollen immer '''zuletzt''' ergänzt werden, um den Aufwand nach Änderungen im Template gering zu halten.
====XDS-Metadaten-Mapping====
===Document Level Template erstellen===
''Anmerkung: Solange das DLT noch nicht in der Transaktion des Szenarios verlinkt ist, wird dessen Label (im Template-Baum) als oranges Dreieck mit Pfeilen angezeigt, sonst als oranges Viereck/Buch.''<br>
====Workflow Document Level Template erstellen====
# Neues DTL DLT anlegen: Angabe Name, Version Label, Display Name laut Governance, dann Template speichern
# Anschließend OID entsprechend Governance korrigieren (Template bearbeiten, "#")(nur über GUI möglich, nicht via Temple).
# Kopieren „Included Templates“ aus DLT-Header mit Kettensymbol zum Projekt hinzufügenTipps:* Zur Vereinfachung kann der Inhalte Inhalt eines bestehenden DLT (XML via Temple) als XML kopiert und in das neue Template einfügen werden (effective DATE und OID bleiben erhalten).# * Inhaltliche Korrekturen und Anpassungen am Besten können auch in einem externen XML-Editor durchführen (z.B. Oxygen) durchgeführt und dann in Temple einfügeneingefügt werden.# „Included Templates“ aus DTL-Header mit Kettensymbol zum Projekt hinzufügen
==Dataset-Mapping erstellen==
Die Zuordnung von Datensatz-Elementen und erstellten Templates wird empfohlen. Dadurch sind alle mit einem Template assoziierten Konzepte in der Template-Beschreibung zusammengefasst, sowie direkt beim assoziierten CDA-Element bzw. Attribut des Templates ersichtlich. Dies dient der Kontrolle(auch für die Experten-/Arbeitsgruppe), dass alle erforderlichen DatensatzDataset-Elemente in den Templates modelliert wurden.
[https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Associations ART Template Associations]
==Testen und Fehlerbehebung==
Um die Qualität eines Projekts zu überprüfen, können eine Reihe von Prüfungen durchgeführt werden, bevor eine Publikation erstellt wird.
Informationen zu den entsprechenden Funktionalitäten des
ART Project Editors finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor#Preflighting%20publication%20and%20quality%20checks Preflighting publication and quality checks].
===Workflow Decor Prüfung===
Die Decor Prüfung testet, ob das Projektschema gültig ist und Schematronregeln erstellt werden können.
Menü Projekt – Entwicklung:
* "Decor prüfen": Prüfung über gesamtes Modell
==Schematron erstellen==
Generell gilt:
* Ein Art-Decor Mithilfe von ISO Schematron prüftkann geprüft werden, ob ein gültiges HL7 CDA Dokument (HL7 v3) vorliegt, während eine XSD-Schemaprüfung, nur prüft ob ein gültiges XML Dokument vorliegt.* Aus den modellierten Templates können über Art-Decor automatisch Schematronregeln generiert werden.* Wenn zusätzliche Geschäftsregeln geprüft werden sollen, die nicht in den Templates modelliert sind, müssen zusätzlich notwendige die dazu notwendigen Asserts von Hand eingetragen werden (z.B. Logik: Schwangerschaftsstatus, prüfen ob Impfempfehlung in diesem Jahr noch gültig).
* Informationen zu den entsprechenden Art-Decor Tool finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=Live_Runtime_Compile Live Runtime Compile (LRC)].
* Es wird empfohlen, bereits zu Beginn während der Modellierung regelmäßig eine Kompilierung durchzuführen (z.B. nachdem ein DLT mit Header und noch leerem structuredBody erstellt wurde) eine Kompilierung durchzuführen und dann z.B. nach Ergänzung jeder neuen Sektion , um zu testen, ob das Projektschema noch gültig ist.
* Art-Decor bietet die Möglichkeit nach korrekter Schematron-Generierung ein Beispieldokument zu prüfen.
==Asserts erstellen==
(TODO: OKU)
==Beispieldokumente ==
