1.104
Bearbeitungen
Änderungen
keine Bearbeitungszusammenfassung
|description= Hier finden Sie eine Erklärung zu der Erstellung von CDA-Leitfäden mit Art-Decor.
}}
<br>
Eine Übersicht '''verfügbarer Anleitungen''' sind unter [https://www.art-decor.org/mediawiki/index.php?title=ART_user_manual '''ART user manualmanuals'''] aufgelistet.{{EndYellowBox}}Folgende Vorgehensweisen werden bei der Erstellung von Leitfäden als '''Best Practices''' empfohlen.
==Projekt erstellen(überarbeitet aber komplett übernommen)==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(überarbeitet aber komplett übernommen)==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, soll von bereits vorhanden sollen bestehende Dataset-Elementen Elemente verwendet werden oder von diesen geerbt werden und diese, falls erforderlich, enterbt und den speziellen Anforderungen angepasst 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.
[https://www.art-decor.org/mediawiki/index.php?title=ART_Dataset_Editor ART Dataset Editor].
==Szenarios Szenario erstellen(überarbeitet aber komplett übernommen)==Für '''jede''' Dokument-Ausprägung muss eine '''mussTransaktion''' 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. Dies 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''' aber 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].
==Referenzen auf andere Projektverzeichnisse setzen(überarbeitet aber komplett übernommen)==Um bestehende Templates anderer '''Building Block Repositories''' referenzieren zu können, müssen die entsprechenden Verzeichnisse dem Projekt hinzugefügt werden ({{BeginYellowBox}}''Empfehlung: ATCDABBR'' Dem Projekt Referenzen für ad1bbr-, ad2bbr-, at-cda-bbr-, IHE-PCC- hinzufügen).<br>{{EndYellowBox}}
Eine Anleitung hierfür finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor#Reference_a_building_block_repository Reference a building block repository].
==Templates erstellenund referenzieren (überarbeitet aber komplett übernommen)==
Hinsichtlich OID, Namensgebung, Beschreibung und Inhalte neuer Templates sind die Richtlinien der [[ART-DECOR_Governance#Governance_f.C3.BCr_die_CDA-Leitfadenerstellung_mit_Art-Decor | Governance für die CDA-Leitfadenerstellung mit Art-Decor]] einzuhalten.<br>
Alle Funktionen des Template Editors finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Creating_a_link_to_a_template_that_resides_in_a_BBR '''ART Temple Editor'''].
====Erstellung neuer TemplatesNicht verlinktes Projektverzeichnis (komplett übernommen)====* Wenn neue Die Übernahme vorhandener Templates erstellt werdenaus Projektverzeichnissen, vergibt Art-Decor per Default eine dem Projektverzeichnis untergeordnete die '''OIDNICHT verlinkt'''sind, 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 [[ART_Template_Editor#Metadata | Metadata]]).* Templates anderer Projekte, welche im eigenen Projekt ist nicht referenziert werdenüber die GUI möglich, können da diese Templates nicht als Prototyp angegeben werden können (d.h. von ihnen kann nicht geerbt werden). <br>Soll der Inhalt eines Templates trotzdem verwendet werden, empfiehlt lässt sich folgende Vorgehensweise: Mittels Linkmittels Browser-Direktlink
:<code><nowiki>https://art-decor.org/temple/modules/temple.xquery?id=[OID des Templates]</nowiki></code>
====Änderung bestehender TemplatesVerwendung von Template-Compilations (komplett übernommen)====* Nur Templates die Compilations sind Template-Fragmente, wie z.B. Adressinformationen. Da sich noch im Status [[ART-DECOR_Governance&stable=0&redirect=no#Artefaktstatus|diese mehrfach wiederholen können, sollen sie mit "Entwurfcontains"]] befinden können bearbeitet eingebunden werden(d. Für alle anderen Status finden Sie Informationen unter [[Hilfe:Art-Decor_Leitfadenerstellung#Versionierung|Versionierung]]h.* Der '''Name''' eines Templates (der Inhalt der Compilation wird nicht der Anzeigename!im verlinkenden Template angezeigt) kann später nur mittels [https://www.art-decorDiese sollen aber im Leitfaden als eigene Kapitel vorhanden sein.org/mediawiki/index.php?title=Temple '''Temple'''] geändert werden! Die Änderung hat des Namens hat keinen Einfluss auf die Referenzierung durch andere Templates -> hier gilt die '''OID'''). * Wird die OID geändert, wenn das Template bereits durch andere Templates refereziert wird, werden alle bestehenden Referenzen '''ungültig'''! Daher vor der Änderung der OID die Liste aller referenzierenden Templates abspeichern und diese hinsichtlich der neuen OID anpassen!
===Document Level Template erstellen(überarbeitet aber komplett übernommen)===*Für '''jede Transaktion Dokumentart''' (jede DokumentartTransaktion) muss ein neues Document-Level-Template (DLT) erstellt werden (nach Vorgaben der [[ART-DECOR_Governance#Governance_f.C3.BCr_die_CDA-Leitfadenerstellung_mit_Art-Decor | Governance]]).<br>''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 (überarbeitet und teilweise übernommen)====# Neues DLT anlegen: Angabe Name, Version Label, Display Name laut Governance, dann Template mit der von Art-Decor per default vergebenen OID speichern# Anschließend OID entsprechend Governance korrigieren (Template bearbeiten, "#")(nur über GUI möglich, nicht via Temple).# „Included Templates“ aus DLT-Header mit Kettensymbol zum Projekt hinzufügenTipps (entfällt):* Zur Vereinfachung kann der Inhalt eines bestehenden DLT via Temple als XML kopiert und in das neue Template einfügen werden (effective DATE und OID bleiben erhalten).* Inhaltliche Korrekturen und Anpassungen können auch in einem externen XML-Editor (z.B. Oxygen) durchgeführt und dann in Temple eingefügt werden.
====Referenzierte Header Level Templates (überarbeitet aber komplett übernommen)====
Der Großteil der Header Level Templates werden aus dem at-cda-bbr (Allgemeiner Leitfaden - ALF) referenziert. Für die Referenzierung dieser gibt es folgende Vorgaben:
* Alle verwendeten ALF Header Templates werden im speziellen Leitfaden, in welchem sie verwendet werden, als "new template reference" ins Projekt geladen.
* Die verwendeten ALF Header Templates werden mit include im Document Level Template abgebildet.
* Die verwendeten AILF Header Templates werden nicht nochmals eigens in die Leitfäden (z.B. unter 10.2.2 Header Level Templates) referenziert, da sie im DLT abgebildet sind.
===Alle weiteren Templates Dataset-Mapping erstellen=(überarbeitet aber komplett übernommen)==Bevor ein neues Template erstellt Die Zuordnung von Datensatz-Elementen und erstellten Templates wird, müssen empfohlen. Dadurch sind alle Templates über die Governance Seite aufgelistetmit einem Template assoziierten Konzepte in der Template-Beschreibung zusammengefasst, deren Wiederverwendbarkeit geprüft werden sowie direkt beim assoziierten CDA-Element bzw. welche OID als nächstes vergeben werden mussAttribut des Templates ersichtlich. Wenn möglich, aus vorhandenen Templates ableiten! Dies dient der Kontrolle („+“auch für die Experten-Symbol in der Templateansicht im Projektverzeichnis/Arbeitsgruppe).Ein neues Basistemplate muss im ATCDABBR angelegt werden und soll so allgemein definiert sein, dass es für andere Leitfäden verwendbar ist (ohne Value Sets, ohne projektspezifischen Angaben!)*. Alle Projekte sollen von dort ableiten (genauer spezifizieren, Value Sets angeben usw.). z.B. Section-Template im ATCDABBR: „Durchgemachte Krankheiten“ abgeleitet in Section-Template „Impfrelevante Erkrankungen - kodiert“ im e-Impfpass.TemplateIDs müssen mit IHEalle erforderlichen Dataset-Vorgaben übereinstimmenOptionalitäten und Reihenfolge der Elemente einhalten*bei fehlender Berechtigung können Basistemplates im Projektverzeichnis erstellt werden und später durch berechtigte Personen in das ATCDABBR verschoben werden.<br>Wenn ein Template laut IHE required ist, aber nicht benötigt wird, dann Template mit nullFlavor erstellen: z.B. Freitext-Inhalt „keine Information“ oder Code „entry emty“ => Workarround damit der Standard nicht verletzt wird und das IHE Template trotzdem verwenden werden kann (sonst nicht interoperabel!)Vorgabe von 6.3.1.10.4 Specification: Sektionen eigentlich verpflichtend, aber R kann auch 0 seinden Templates modelliert wurden.
[https://www.art-decor.org/mediawiki/index.php?title===Sektionen entsprechend dem IHE Profil modellieren===(siehe TODO)ART_Template_Associations ART Template Associations]
==Terminologien hinzufügen(überarbeitet aber komplett übernommen)==
Bestehende ValueSets können mit Kettensymbol unter Value-Sets hinzugefügt werden
* [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance&stable=0&redirect=no#Bezeichnungen_f.C3.BCr_Value_Sets Namenskonventionen für die Erstellung neuer Value Sets]
==DatasetTesten und Fehlerbehebung (überarbeitet aber komplett übernommen)==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-Mapping erstellendecor.org/mediawiki/index.php?title=ART_Project_Editor#Preflighting%20publication%20and%20quality%20checks Preflighting publication and quality checks]. ===Workflow Decor Prüfung===Die Zuordnung von Datensatz-Elementen Decor Prüfung testet, ob das Projektschema gültig ist und erstellten Templates wird empfohlenSchematronregeln erstellt werden können. Dadurch sind Menü Projekt – Entwicklung:* "Decor prüfen": Prüfung über gesamtes Modell:* "Optionale Prüfungen konfigurieren": alle mit einem Template assoziierten Konzepte in der TemplateOptionen auswählen:* Schema und Schematron-Prüfung durchführen, eventuelle Fehler werden aufgelistet. ==Schematron erstellen (überarbeitet aber komplett übernommen: https://confluence.elga.gv.at/display/SCC/Schematron-Beschreibung zusammengefasstErstellung+und+Bereitstellung)== Generell gilt:* Mithilfe von ISO Schematron kann geprüft werden, sowie direkt beim assoziierten ob ein gültiges HL7 CDADokument (HL7 v3) vorliegt, während eine XSD-Element bzwSchemaprüfung, nur prüft ob ein gültiges XML Dokument vorliegt. Attribut des * Aus den modellierten Templates ersichtlichkönnen über Art-Decor automatisch Schematronregeln generiert werden. Dies dient der Kontrolle* Wenn zusätzliche Geschäftsregeln geprüft werden sollen, dass alle erforderlichen Datensatz-Elemente die nicht in den Templates modelliert wurdensind, müssen 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 während der Modellierung regelmäßig eine Kompilierung durchzuführen (z.B. nachdem ein DLT mit Header und noch leerem structuredBody erstellt wurde), 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. ===Workflow Schematron erzeugen ===Menü Projekt – Entwicklung:* "Compiliere Entwicklungsversion": :* "Optionale Prüfungen konfigurieren": Optionen "Force recompile", "Explicit includes", "Schematron geschlossen" (falls gewünscht):* Bei jeder Compilierung entsteht eine neuer Listeneintrag, das zip-File kann gespeichert werden um lokal Beispieldokumente zu validieren -> Achtung, nur die jeweils letzten beiden Versionen bleiben zum Download verfügbar! :* Nach Publikation soll nur die letzte, gültige Schematron-Version verfügbar sein (alle restliche können entfernt werden).
==Schematron Beispieldokumente (überarbeitet aber komplett übernommen=====Beispielbokumente erstellen=== (TODO)* Das Gerüst eines Beispieldokuments kann erstellt werden, indem man im entsprechenden DLT den Zauberstab des Template Editors anwendet und rekursiv alle Code-Snippets der darin verlinkten Templates einfügt.
==Asserts erstellen=Beispieldokumente validieren=== (TODO)Nachdem erfolgreich ein [[Hilfe:Art-Decor_Leitfadenerstellung#Schematron_erstellen|Schematron]] erstellt wurde, kann unter im Projekt Editor unter "Menü Projekt"–"Entwicklung"-"Compiliere Entwicklungsversion" im aktuellen Listeneintrag die Funktion "XML-Instanz validieren" ausgewählt werden und ein Beispieldokument hochgeladen werden.
==Beispielbefunde erstellen Publikation (überarbeitet aber komplett übernommen: https://confluence.elga.gv.at/display/SCC/Schematron-Erstellung+und testen+Bereitstellung)=Informationen zur Publikation eines Leitfadens in Art-Decor finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor#Creating_a_new_version_.2F_release_.2F_publication_request Creating a new version / release / publication request]. TODO
=Versionierung=
[https://www.art-decor.org/mediawiki/index.php?title=ART_Value_Set_Editor#Creating_a_new_version_of_a_value_set.2C_based_on_a_previous_version Creating a new version of a value set, based on a previous]