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.
==Projekt erstellen==
Ein neuer CDA-Leitfaden '''muss''' in einem eigenen Projektverzeichnis angelegt , alle Autoren müssen entsprechend berechtigt werden. Dies muss gegebenenfalls beim [https://www.art-decor.org/mediawiki/index.php?title=Contact Art-Decor-Support] beantragt werden.
Informationen zu den Funktionen des Projekt-Editors finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor ART Project Editor].
==Datasets erstellen==
Die Modellierung der Datasets soll in enger Abstimmung mit Experten der Arbeitsgruppe erfolgen.Es ist gute Praxis, bestehende Standards bereits unter Einbeziehung potentiell bei der Modellierung der Datasets zu verwendender Standards berücksichtigen (z.B. IHE ProfilePCC). Wenn möglich sollen bestehende Dataset-Elemente verwendet werden oder von diesen geerbt werden ([https://www.art-decor.org/mediawiki/index.php?title=DECOR-dataset#Dataset_versioning Dataset versioning]).<br>
Die anzugebenden Inhalte eines Dataset-Elements sind in der [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance&stable=0&redirect=no#Datasets Governance] festgelegt.
==Szenario erstellen==
Für '''jede''' Dokument-Ausprägung muss eine '''Transaktion''' erstellt werden. Diese ist für die Generierung von Schematronregeln erforderlich.<br>
Transaktionen stellen einen (Teil-)Satz von Konzepten enthalten Konzepte eines Datasets dar und ergänzen ihn diese um Kardinalität, Konformität und mögliche Bedingungen, damit die Anforderungen des Anwendungsfalles angemessen widergespiegelt werden. Die Angabe der Element-von Konformanz und Kardinalität der Dataset-Kardinalität Elemente kann nur in der Transaktion erfolgen, ist jedoch für die Erstellung eines Schematrons nicht zwingend erforderlich. <br>Eine Transaktion '''muss''' das entsprechedende [[Hilfe:Art-Decor_Leitfadenerstellung#Document_Level_Template_erstellen | Document-Level-Template]] referenzieren (dies ist die technische Darstellung der Transaktion und der zugrunde liegenden Konzepte).<br><br>Die Bezeichnung Benennung der Transaktion soll der [[ART-DECOR_Governance#Governance_f.C3.BCr_die_CDA-Leitfadenerstellung_mit_Art-Decor | Governance für die CDA-Leitfadenerstellung mit Art-Decor]] folgen.<br>
Eine Beschreibung zur Erstellung von Transaktionen finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Scenario_Editor ART Scenario Editor].
===Verwendung von Standards===
Generell gilt daher:
* Wenn möglich, sollen bereits vorhandene Templates verwenden werden (siehe [[Hilfe:Art-Decor_Leitfadenerstellung#.C3.9Cbernahme_bestehender_Templates| Übernahme bestehender Templates]]).
* Wenn ein neues Template erstellt Der Standard darf dabei nur eingeschränkt, aber nicht erweitert werden muss (siehe [[Hilfe:Art-Decor_Leitfadenerstellung#Neues_Templates_erzeugen|Neues Templates erzeugen]]), müssen verwendete Template-IDs mit den IHE-Vorgaben übereinstimmen.* Optionalitäten und Reihenfolge der Elemente müssen eigenhalten eingehalten werden.:Hinweis: Wenn ein Template laut IHE Standard "required" ist, aber für die Anwendung in Österreich den konkreten Leitfaden nicht benötigt wird, kann das Template mit einem '''nullFlavor''' erstellt werden (z.B. Freitext-Inhalt „keine Information“ oder Code „entry empty“). Dadurch wird der Standard nicht verletzt und das IHE-Template kann trotzdem verwenden zu können (Interoperabilität!)werden.
===Neues Templates erzeugen===
Informationen zur Erstellung von Templates finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Creating_a_new_template Neues Template erzeugen]. <br>
Hinweise:
* Wenn ein neues Templates erstellt werdenwird, vergibt Art-Decor per Default default eine dem Projektverzeichnis untergeordnete '''OID''', welche nach den Vorgaben der [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance#Art-Decor_Root_OID Governance] geändert werden muss (siehe [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Metadata Metadata]).
: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====TODO: Hinweis Elemente die auf XDS-Metadatengemappt werden müssen, sollen mit "↔ Hinweis zum XDS-Mapping" gekennzeichnet sein.<br>Beispiel:<br>'''↔ Hinweis zum XDS-Mapping:''' Das templateId-Element mit einer Extension beginnend mit "XDSdocumentEntry.formatCode^" wird ins XDS-Attribut formatCode gemappt (ohne Präfix XDSdocumentEntry.formatCode^)
===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==Dataset-Mapping erstellen==Die Zuordnung von Datensatz-Header Elementen und erstellten Templates wird empfohlen. Dadurch sind alle mit Kettensymbol zum Projekt hinzufügeneinem 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 Dataset-Elemente in den Templates modelliert wurden. [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Associations ART Template Associations]
==Terminologien hinzufügen==
==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 ==
