585
Bearbeitungen
Änderungen
→Art-Decor Projekt
{{#customtitle:Governance für die CDA-Leitfadenerstellung(Version 1)}}
{{#css:
.toc{
}
}}
<pre class="ilfbox_code">
Governance für die CDA-Leitfadenerstellung mit Art-Decor und Mediawiki
Version: 1.1.1+20230503
Status: Final
</pre>
<!--
{{Infobox Dokument
|Type = Governance
|Version = 1
|Date = 143.125.20212023
|Copyright = 2021 - 2025
|Status = Final
|Realm = Österreich
|Submitted = 143.125.20212023}}
{{Versionbox Begin}}
{{VersionboxEntry | Version = 0.2 | Date = 07.11.2019| Status = Draft| History=Überarbeitung und Einarbeitung der Erkenntnisse nach Erstellung des CDA-Leitfadens e-Impfpass}}
{{VersionboxEntry | Version = 1 | Date = 14.12.2021| Status = Final| History=Überarbeitung}}
{{VersionboxEntry | Version = 1.1.1 | Date = 3.5.2023| Status = Final| History=Überarbeitung Kapitel Value Sets}}
{{Versionbox End}}
-->
=Governance für die CDA-Leitfadenerstellung=
Die folgenden Vorgaben sind verpflichtend einzuhalten. Empfehlungen werden entsprechend markiert. Die Reihenfolge der Kapitel soll eine übliche Vorgehensweise darstellen, jedoch ist die Reihenfolge selbst nicht verpflichtend einzuhalten.
==Governance Groups==
Governance-Gruppen sind organisatorische Einheiten, die dazu dienen, die Verantwortung für Artefakte (Templates und Value-Sets) in Art-Decor darzustellen. Unter der [https://art-decor.org/art-decor/decor-governance-group?id=1.2.40.0.34.3.1.2 ELGA Art-Decor Governance Group] sind alle Projekte der ELGA sichtbar, sowie alle angelegten Artefakte mit OID, Displayname, Artefaktstatus, BBR und Repositories), z.B. "at-cda-brr"-Projekte, die das Template oder Value Set referenzieren. Weiters existiert die [https://art-decor.org/art-decor/decor-governance-group?id=2.16.840.1.113883.2.16 HL7 Austria Art Decor Governance Group] , welche alle eHealth Austria Vorgaben umfasst. Dabei wird die hier beschriebene ELGA Governance auch für die HL7 Austria relevant und soll von dieser übernommen werden.
==Implementierungsleitfaden (inkl. Wiki)==
'''eHealth Implementierungsleitfäden''' können auch in englischer Sprache verfasst werden.
Wichtige Informationen hinsichtlich der '''technischen''' Erstellung eines CDA-Leitfadens mit Mediawiki sind unter [https://wiki.hl7.at/index.php?title=Hilfe:Wiki HilfeLeitfaden erstellen mit Mediawiki] nachzulesen.
Die Einbindung eines neuen Leitfadens folgt einem vorgegebenen Prozess, dieser ist ersichtlich unter Benutzung von [https://wiki.hl7.at/index.php?title=Hilfe:Flagged_Revisions#Benutzung_von_Flagged_Revisions Flagged Revisions].
===Name===Der '''Name ''' eines Leitfadens wird wie folgt angegeben:
* HL7 Austria & ELGA* HL7 CDA® R2 Implementierungsleitfaden* '''[Titel]'''* OID: '''[OID]'''
''Beispiel:''
HL7 Austria & ELGA
HL7 CDA® R2 Implementierungsleitfaden
Labor- und Mikrobiologiebefund
OID: 1.2.40.0.34.7.4.9.3
''Beispiel:''
*1.2.40.0.34.7.'''18''': Dokumentenklassen-OID des Implementierungsleitfadens "Meldung von antimikrobieller Resistenzen"
**OID wird im OID-Portal beantragt (Root-Knoten aller Versionen des entsprechenden Leitfadens)
*1.2.40.0.34.7.'''18.1''': Implementierungsleitfaden Meldung von antimikrobieller Resistenzen, Version 1**OID des PDF-Leitfaden Leitfadens (Titelblatt)
**wird im DLT als templateId[2] als informative Referenz angegeben
**Hauptversionen verlangen eine neue Verordnung durch das BM*G
Das Wiki-Leitfadenprojekt DARF NICHT unabhängig vom ART-DECOR-DLT versioniert werden, siehe [https://confluence.elga.gv.at/display/SCCTERM/Versionierung Versionierung].
Alle '''Hauptversionen und Nebenversionen''' eines Leitfadens sind als '''Wiki''' verfügbar. In der "Lese-Ansicht ist die publizierte Version ersichtlich, aktuelle (noch nicht freigegebene) Überarbeitungen/Änderungen sind der "Revisions-Ansicht" zu entnehmen. Zum Zeitpunkt der Publikation (z.B. Ballotversion / Publikation neue Haupt- oder Nebenversion) wird die Hauptseite des Leitfadens von einer berechtigten Person als "abgenommen" markiert (siehe dazu [https://wiki.hl7.at/index.php?title=Hilfe:Leitfaden_erstellenWiki#Versionierung_von_Wiki-Seiten Hilfe:Leitfaden erstellenVersionierung von Wiki-Seiten]), sodass die "Revisions"-Ansicht in die stabile "Leseansicht" übernommen wird. Die "Leseansicht" bleibt unverändert, bis eine neue Version des Leitfadens abgenommen wird.
Alle veröffentlichten Leitfadenversionen sind zusätzlich zum Wiki als PDF verfügbar (Anleitung siehe [https://wiki.hl7.at/index.php?title=Hilfe:Leitfaden_erstellen#PDF_Generierung PDF-Generierung]). Eine Übersicht der Versionen eines Leitfadens findet sich im jeweiligen Guide (alle vorhandenen Guides sind zu finden unter [https://wiki.hl7.at/index.php?title=Implementierungsleitf%C3%A4den Übersicht der CDA Implementierungsleitfäden].
===Inhalt===
Der Inhalt eines Implementierungsleitfadens besteht üblicherweise aus den Kapiteln:
:1 Zusammenfassung
:::2.4.1 Urheber- und Nutzungsrechte von anderen Quellen ("Third Party IP")
:::2.4.2 SNOMED CT
:::2.4.3 Weitere Terminologien
::2.5 Verwendete Grundlagen und Bezug zu anderen Standards
::2.6 Verbindlichkeit
::15.5 Revisionsliste
::15.6 Erratum
Bei Kapiteln ohne Inhalt soll kurz darauf eingegangen werden, warum dieser Leitfaden dieses Kapitel nicht füllt.
we would like to ask you to create a new project in Art-Decor:
*Name: <'''displayName des Projekts'''>
*Prefix: <'''Projektkürzel''' - sollte keine Bindestriche enthaltensoll immer mit at- beginnen, z.B. elgatest"at-emed-" oder "at-lab-" (Vorweg: an bestimmten Stellen werden Bindestriche durch das System ausgeblendet)>
*ContainsReusableContent=false
*Experimental/Test=false
Für Datasets gibt es '''keine speziellen Vorgaben''' hinsichtlich '''OID und Version & Metadaten'''.
Bereits bei der Modellierung der Datasets sollen bestehende Standards berücksichtigt werden (z.B. IHE PCC) und bestehende Dataset-Elemente so gut es geht '''aus anderen Projekten wiederverwendet''' werden (siehe auch [https://www.art-decor.org/mediawiki/index.php?title=DECOR-dataset#Dataset_versioning Dataset versioning]). Dies funktioniert durch die Eingabe eines Names und dem mit etwas Ladezeit folgendem Vorschlag von ähnlichen Konzepten. Dabei sollte der Sinn des Datasets, der aus der Beschreibung hervorkommt, derselbe sein. Falls dann nur noch der Name des Datasets nicht passt, kann dieser als Doppelt-Name angepasst werden, was dann höchstwahrscheinlich auch dem dazugehörigen Template angepasst werden muss.
Weitere offizielle Informationen sind unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Dataset_Editor ART Dataset Editor] zu finden.
''Info: 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.''
==Vorbedingungen für die Erstellung neuer Templates==
Bevor neue Templates erstellt werden, sollte geprüft werden, ob bestehende Templates (bestenfalls im at-cda-bbr), die Anforderungen bereits erfüllen. Gibt es passende Templates können diese durch '''Referenzierung''' (unveränderte Übernahme) mittels Kettensymbol in das bestehende Projekt übernommen werden. In diesem Fall sind keine Änderungen an dem Template möglich! Diese Funktion sollte nur verwendet werden, wenn es bereits ein passendes ELGA-/e-Health-Template gibt.
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.
==Vorbedingungen für Änderungen bestehender Templates==
Bevor ein bestehendes Template geändert wird (Erstellung einer neuen Version, welche automatisch von allen dynamisch referenzierenden Templates verwendet wird), ist zu überprüfen, wie sich diese Änderung auf andere Leitfäden auswirkt bzw. ob diese gewünscht ist. In allen betroffenen Leitfäden muss die Änderung auf der Diskussionsseite im Abschnitt "Ausblick" festgehalten werden.
''Zu Beachten:''
*Wenn eine neue Version eines aus dem ATCDABBR referenzierten Templates (graues Icon im Template-Baum) benötigt wird, MUSS diese im ATCDABBR erstellt werden.
*Soll ein Template, das im ATCDABBR erstellt wurde, in ein Projekt-Repository verschoben werden, muss dort zuerst eine evtl. bereits existierende Referenz darauf entfernt werden.
*Fehlen die Berechtigungen für schreibenden Zugriff auf das ATCDABBR, sollen die erforderlichen Anpassungen zuerst im Projekt-Repository durchgeführt werden und können nach abgeschlossenem Ballot von Berechtigten ins ATCDABBR übernommen werden.
== Name ==
Soll der Inhalt eines Templates trotzdem verwendet werden, lässt sich mittels Browser-Direktlink
<code><nowiki>https://art-decor.org/temple/modulesviews/temple.xqueryhtml?id=</nowiki>[OID des Templates]&[effectiveDate]&[prefix]&[language]&mode=readonly</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. Die OID muss in einem späteren Arbeitsschritt über die GUI korrigiert werden. ''Beispiel'': <code><nowiki>https://art-decor.org/temple/views/temple.html?id=</nowiki>2.16.756.5.30.1.1.10.2.63&effectiveDate=2020-06-26T00:00:00&prefix=cdachvacd-&language=de-DE&mode=readonly</code>
== Inhalt ==
* [[Datei:WarningGelbWarning.svgpng|15px]] Wenn möglich, sollen bereits vorhandene Templates verwenden werden.
* Zugrundeliegende Standards dürfen nur eingeschränkt, aber nicht erweitert werden.
** ''Hinweis: Wenn ein Template laut Standard "required" ist, aber für 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 Template kann trotzdem verwenden werden.''
* Optionalitäten und Reihenfolge der Elemente müssen eingehalten werden.
* Die '''erste Template-ID''' soll wie folgt bezeichnet werden: "HL7 Austria - [Name des Templates]". Diese Template-ID '''muss''' aus dem OID-Knoten 1.2.40.0.34.6.0'''.11''' stammen.
** [[Datei:WarningGelbWarning.svgpng|15px]] Jene Template-ID, die beim Erstellen eines neuen Templates oder Ableiten eines Prototyps von Art-Decor automatisch hinzugefügt wird, '''muss''' entfernt bzw. ersetzt werden ('''nur über GUI mögich, nicht via Temple:''' "Template bearbeiten" → "#")
* Weitere Template-IDs können angegeben werden, sofern das im zugrundeliegenden Standard gefordert ist (z.B. IHE).
* include vs. contains
'''Kardinalität / Konformität'''
Im Allgemeinen Implementierungsleitfaden wird unter der Legende der Konformitätskriterien beschrieben, welche Kardinalitäten und Konformitäten in den ELGA Leitfäden vorkommen können. Die folgende Tabelle stellt dar, wie diese Kriterien in Art-Decor umzusetzen sind (siehe auch <nowiki>[https://art-decor.org/mediawiki/index.php?title=DECOR-rules#Mandatory_.2F_Conformance<Mandatory/nowiki>Conformance]).
{| class="wikitable"
! colspan="3" |Für Elemente
= Value Sets =
Eine Anleitung zur Verwendung des Value Set Editors ist unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Value_Set_Editor Value Set Editors] ist unter ART Value Set Editor ] zu finden. {{BeginYellowBox}}Seit 2022 steht unter '''https://termgit.elga.gv.at/ ein neuer Terminologieserver''' zur Verfügung. Die Dokumentation findet sich auf https://termgit.elga.gv.at/documentation_and_support_de.html und https://termgit.elga.gv.at/faq_de.html{{EndYellowBox}}
== Name ==
*'''Name''': '''[Präfix]-[ValueSetName]''' (lowercase-Schreibweise)*'''Display-Name'''/'''Title''':''' Als [Präfix dient das Projektkürzel ]_[ValueSetName]''' (Name des RepositoriesUpperCamelCase-Schreibweise), z.B. "eimpf"
== OID ==
* Für '''Falsch-Beispielbefunde''' sollte mindestens jeweils ein Befund vorhanden sein für
** das Brechen eines Contraints,
** das Verwenden eines falschen Wertes wo ein Value-Set Wert erwartet wird,
** das Verwenden eines nicht CDA-Elementes (nicht im Schema vorhanden),
** das Verwenden eines verbotenen Elementes
= Szenarios / Schematron =
Das Erstellen von '''einer Transaktion pro DLT''' in den Szenarien ist für die Generierung von Schematron-Regeln '''zwingend erforderlich''', siehe ][https://confluence.elga.gv.at/display/SCC/Schematron-Erstellung+und+Bereitstellung Schematron-Erstellung und Bereitstellung].
Für Szenarios gibt es '''keine speziellen Vorgaben''' hinsichtlich '''OID oder Version & Metdaten'''.
** im Beispieldokument enthalten
** Schematron Asserts ergänzen
* DLTbei '''jeder Version MUSS''' in <code>hl7at: formatCode, </code> die Versionierungsinfo + Publikationsdatum im Label anpassenangepasst werden.** Entsprechende Adaptierung von CodeSystem '''ELGA_FormatCode''' und ValueSet '''ELGA_FormatCode'''
* Temlatestatus:
** für Ballot: Templates bleiben im Entwurf-Status
** Versionsinformationen mit DLT abgleichen
* Infobox: „In Arbeit“ entfernen
* Prüfen, ob alle Templates eingefügt und Value-Sets verlinkt wurden
* Linkverzeichnisse, Referenzen prüfen
* ggf. Informationen bezüglich <code>hl7at:formatCode</code> auf der Wiki-Seite aktualisieren* Diskussionsseite aktualisieren** Diskussionsseiten sollen wie folgendes Beispiel aufgebaut sein ([[ILF_Diskussion:Telemonitoring-Episodenbericht_(Version_1)|Diskussionseite Telemonitoring-Episodenbericht]])** prüfen, ob Elemente aus dem "Ausblick" in der aktuellen Version umgesetzt wurden. Falls ja, sind diese in die Tabelle des "Release-Log" zu verschieben.* Revisionsliste des Leitfadens auf Basis der Diskussionsseite aktualisieren
* Links prüfen und optimieren: Nur externe Links sollen in neuem Tab geöffnet werden, Sprungmarken sollten immer mit # gekennzeichnet sein.
* PDF: Druck checken (leere Seiten, Suche nach: „Error“, „Fehler“, "TODO")
* Falsch-Beispielbefunde aktualisieren
* Schematron aktualisieren
= Anhang =
== Links ==
* [http://art-decor.org/art-decor/home Art-Decor Workspace]* [https://www.art-decor.org/mediawiki/index.php?title=Documentation Art-Decor Dokumentation]* Wiki-Portal von HL7 Austria: [https://wiki.hl7.at/index.php?title=Willkommen_auf_dem_Wiki-Portal_von_HL7_Austria eHealth Wiki ] & [https://wiki.hl7.at/index.php?title=Hilfe:Wiki Wiki Hilfe]
<span title="Filterspalte" class="tf-inline-filter"></span>
