Änderungen

Eine {{BeginYellowBox}}'''Einleitung DIESE SEITE IST NICHT MEHR ZU BEARBEITEN, WURDE VOLLSTÄNDIG in [https://confluence.elga.gv.at/pages/viewpage.action?pageId=23791972 ELGA Governance für die CDA-Leitfadenerstellung mit Art-Decor- Semantic Competence Center - ELGA Confluence] ÜBERNOMMEN. Sobald die [https://wiki.hl7.at/index.php?title=Spezial:Linkliste/Hilfe:Art-Decor_Leitfadenerstellung Links, die auf diese Seite zeigen,] korrigiert wurden, kann die Seite gelöscht werden.''' {{EndYellowBox}}  {{BeginYellowBox}}Eine Einleitung in Art-Decor finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Introduction '''ART Introduction'''].

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 Vorgehensweise wird Vorgehensweisen werden bei der Erstellung von Leitfäden als '''Best PracticePractices''' 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.

==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 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>

==Szenarios Szenario erstellen(überarbeitet aber komplett übernommen)==

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>

==Referenzen auf andere Projektverzeichnisse setzen(überarbeitet aber komplett übernommen)==

==Templates erstellenund referenzieren (überarbeitet aber komplett übernommen)==

===Verwendung von Standards(überarbeitet aber komplett übernommen)===Im zugrundeliegenden '''Basis IHE Leitfaden''' müssen vorgeschriebene Sektionen, Kardinalitäten, Optionalitäten, Terminologien, ServiceEvents usw. ermittelt Grundsätzlich sollen existierende Standards angewendet werden.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#Erstellung_neuer_Templates|Erstellung neuer Templates]]), 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 werden. ===Neues Templates erzeugen (überarbeitet aber komplett übernommen)===Informationen zur Erstellung von Templates in Art-Decor finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Creating_a_new_template Creating a new template]. <br>Hinweise:* Wenn ein neues Templates erstellt wird, vergibt Art-Decor per 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 unter HL7 Austria 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 (Interoperabilität!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 Referenzieren bestehender Templates(überarbeitet aber komplett übernommen)===Alle bestehenden Templates werden unter Unter dem Link [https://art-decor.org/art-decor/decor-governance-group?id=1.2.4016.0840.341.3113883.12.2 16 '''Art-Decor Governance Group'''] sind die Templates der HL7 Austria aufgelistet.<br>

==== Verlinktes Projektverzeichnis (überarbeitet aber komplett übernommen)====Ü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 '''ART Template Editor'''Bestehendes Templates aus einem anderen BBR referenzieren])* '''ReferenzierenReferenzierung''' (unveränderte Übernahme) des Templates mit Kettensymbol

* '''Ableitung''' des Templates (Kopieren und Anpassen''' ) (siehe [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Creating_a_new_version_of_an_existing_template Neue Version eines bestehenden Templateserzeugen])

==== Nicht verlinktes Projektverzeichnis (komplett übernommen)====

:Die OID muss in einem späteren Arbeitsschritt über die GUI korrigiert werden.

===Änderung bestehender Templates(überarbeitet aber komplett übernommen)===Solange sich ein Template noch im Status [[ART-DECOR_Governance#Artefaktstatus|'''Entwurf''']] befindet, kann es jederzeit bearbeitet werden. Dabei ist folgendes zu beachten:* Falls bereits andere Leitfäden darauf referenzieren, ist mit den Autoren Rücksprache zu halten.

==Inhalte von Templates=====Erstellung neuer TemplatesTemplate Metadaten===* Wenn neue Templates erstellt werden, vergibt Art-Decor per Default eine dem Projektverzeichnis untergeordnete '''OID''', welche nach den Hinsichtlich folgender Elemente gelten die Vorgaben der Governance.====Templatename (überarbeitet aber komplett übernommen)====Es gelten die Definitionen der Governance hinsichtlich [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance#ArtNamens-_und_Versionierungs-Decor_Root_OID GovernanceKonventionen Namenskonventionen] geändert werden muss ====Versions-Label (siehe überarbeitet aber komplett übernommen)====Es gelten die Definitionen der Governance hinsichtlich [https://wwwwiki.art-decorhl7.org/mediawikiat/index.php?title=ART_Template_EditorART-DECOR_Governance#Metadata MetadataNamens-_und_Versionierungs-Konventionen Versionierungskonventionen]====Item-Label (entfällt).====:Hierfür Es gelten die Definitionen der Governance Seite aufrufen und alle bestehenden hinsichtlich [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance#Item-Label Item-Label]====Relationships (überarbeitet aber komplett übernommen)====Wenn Beziehungen zu anderen Templates auflisten lassenbestehen (z.B. Spezialisierung), sodass deren Wiederverwendbarkeit geprüft und Nachschau gehalten werden kann, welche OID als nächstes vergeben werden darfsollen diese in den Template-Metadaten des neu erstellten Templates ersichtlich sein.

* Neue, Die Arten der anzugebenden '''allgemeineBeziehungstypen''' e-Health-/ELGAsind der Governance unter [[ART-Basistemplates sollen generell im ATCDABBR angelegt werden und sollen 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 DECOR_Governance#Ableitung_von_Templates|Ableitung von 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]] beschrieben.

===Inhalte von Templates===Hinsichtlich folgender Elemente gelten die Vorgaben Die Template-ID des Basistemplates wird nur zu Zwecken der Governance.====Templatename====Es gelten die Definitionen Nachvollziehbarkeit in den Metadaten angegeben, in der Governance hinsichtlich [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance#Templatename Templatename]====Versions-Label====Es gelten die Definitionen Templatespezifikation selbst muss sie entfernt werden, da dies sonst bei der Governance hinsichtlich [https://wiki.hl7.at/index.php?title=ARTGenerierung von "closed" Schematron-DECOR_Governance#VersionsRegeln zu Inkonsistenzen und zu falsch-Label Versionspositiven Schematron-Label]====Item-Label====Es gelten die Definitionen Fehlern bei der Governance hinsichtlich [https://wikiValidierung führen kann.hl7.at/index.php?title=ART-DECOR_Governance#Item-Label Item-Label]

====Beispiel-Snippets(überarbeitet aber komplett übernommen)====* 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 '''ART Template EditorInsert example''']) erzeugt werden. * 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).

===Template Body=======Template-ID (überarbeitet aber komplett übernommen)====In einer konkreten CDA XML Instanz darf nur 1 Template-ID aus dem ELGA OID Root 1.2.40.0.34.6.0.11.XXX stammen. D.h. jene Template-ID, die beim Ableiten eines Prototyps von Art-Decor automatisch hinzugefügt wird, muss entfernt werden.Weitere OID können - sofern im zugrundeliegenden Standard gefordert - angegeben werden.Alle Richtlinien zur Vergabe einer OID für das neu erzeugte Template sind unter [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance#Root_OID_f.C3.BCr_Templates Governance] zu finden. ==== Standard-Referenzen (überarbeitet aber komplett übernommen)====Daten- und Template-Elemente sollen in ihrem Label zu der entsprechenden Spezifikation verlinken, auf der sie basieren (z.B. IHE PHARM, Kap. 4.4). Dies liegt in der Verantwortung des Entwicklers. ====XDS-Metadaten-Mapping (komplett übernommen)====TODOElemente die auf XDS-Metadaten gemappt werden müssen, sollen mit "↔ Hinweis zum XDS-Mapping" gekennzeichnet sein.<br>Beispiel: <br>'''↔ Hinweis auf Metadatazum XDS-Mapping:''' Das templateId-Element mit einer Extension beginnend mit "XDSdocumentEntry.formatCode^" wird ins XDS-Attribut formatCode gemappt (ohne Präfix XDSdocumentEntry.formatCode^) ====Verwendung von Template-Compilations (komplett übernommen)====Compilations sind Template-Fragmente, wie z.B. Adressinformationen. Da sich diese mehrfach wiederholen können, sollen sie mit "contains" eingebunden werden (d.h. der Inhalt der Compilation wird nicht im verlinkenden Template angezeigt). Diese sollen aber im Leitfaden als eigene Kapitel vorhanden sein.

===Document Level Template erstellen(überarbeitet aber komplett übernommen)===

====Workflow Document Level Template erstellen(überarbeitet und teilweise übernommen)====# Neues DTL DLT anlegen: Angabe Name, Version Label, Display Name laut Governance, dann Template mit der von Art-Decor per default vergebenen OID speichern

# Kopieren „Included Templates“ aus DLT-Header mit Kettensymbol zum Projekt hinzufügenTipps (entfällt):* 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“ ====Referenzierte Header Level Templates (überarbeitet aber komplett übernommen)====Der Großteil der Header Level Templates werden aus DTLdem 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 Kettensymbol zum Projekt hinzufügeninclude 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.

==Dataset-Mapping erstellen (überarbeitet aber komplett übernommen)==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 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(überarbeitet aber komplett übernommen)==

==Dataset-Mapping erstellenTesten und Fehlerbehebung (überarbeitet aber komplett übernommen)==Die Zuordnung Um die Qualität eines Projekts zu überprüfen, können eine Reihe von Datensatz-Elementen und erstellten Templates Prüfungen durchgeführt werden, bevor eine Publikation erstellt 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, dass alle erforderlichen Datensatz-Elemente in den Templates modelliert wurden. [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Associations ART Template Associations]

==Schematron erstellen(überarbeitet aber komplett übernommen: https://confluence.elga.gv.at/display/SCC/Schematron-Erstellung+und+Bereitstellung)==

* 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).

* 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.

===Workflow Schematron erzeugen===

==Asserts erstellen(entfällt)== (TODO: OKU) ==Beispieldokumente (überarbeitet aber komplett übernommen=====Beispielbokumente erstellen===* 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. * In jedem '''Document-Level-Template''' soll nur ein '''Verweis''' auf ein vollständiges Beispieldokument angeführt werden (z.B. auf HL7.at), damit dies bei Bedarf angepasst werden kann. Änderungen im DLT erfordern sonst eine neue Template-ID!* Beispieldokument sollen immer '''zuletzt''' ergänzt werden, um den Aufwand nach Änderungen in Templates gering zu halten.

==Beispielbefunde=====Beispielbefunde erstellenBeispieldokumente validieren===* Beispielbefunde können teilweise mit dem "Zaubstab" in der GUI zur Templatebearbeitung erzeugt werden. * In jedem '''Document-Level-Template''' soll nur Nachdem erfolgreich ein '''Verweis''' auf ein vollständiges CDA[[Hilfe:Art-Beispiel angeführt werden (z.B. auf HL7.at)Decor_Leitfadenerstellung#Schematron_erstellen|Schematron]] erstellt wurde, damit dies bei Bedarf angepasst werden kann. Änderungen unter im Template erfordern sonst eine neue TemplateProjekt Editor unter "Menü Projekt"–"Entwicklung"-"Compiliere Entwicklungsversion" im aktuellen Listeneintrag die Funktion "XML-ID!* Beispielbefunde Instanz validieren" ausgewählt werden und sollen immer '''zuletzt''' ergänzt ein Beispieldokument hochgeladen werden, um den Aufwand nach Änderungen im Template gering zu halten.

=Publikation (überarbeitet aber komplett übernommen: https://confluence.elga.gv.at/display/SCC/Schematron-Erstellung+und+Bereitstellung)=Informationen zur Publikation eines Leitfadens in Art-Decor finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=Beispielbefunde validieren===Nachdem erfolgreich ein Schematron erstellt wurde, kannART_Project_Editor#Creating_a_new_version_.2F_release_.2F_publication_request Creating a new version / release / publication request].