3.869
Bearbeitungen
Änderungen
→Qualitätssicherung und Review =
Weiters werden die notwendigen Verantwortlichkeiten und Prozesse definert, um klare Strukturen für die Zusammenarbeit zwischen Art-Decor und dem Wiki zu gewährleisten. Dies umfasst die Verantwortung für Art-Decor Repositories, Qualitätssicherung und den Support der Tools.
Dieses Dokument enthält die aktuellsten Fragen und Entscheidungen bezüglich der Arbeit mit Art-Decor und Mediawiki in Österreich und wird laufend angepasst.
{{BeginYellowBox}}
{{EndYellowBox}}
= Governance für die CDA-Leitfadenerstellung mit Art-Decor =
== Sprache ==
'''ELGA Implementierungsleitfäden''' werden in '''deutscher Sprache''' verfasst. Dazu gehören textuelle Beschreibungen im Wiki, Art-Decor-Templates und Datasets.
Beispiel:Die Sektion '''''"Impfungen - kodiert"''''' (1.2.40.0.34.6.0.11.2.1) (mit AG abgestimmter Titel) referenziert durch Angabe der TemplateID (1.3.6.1.4.1.19376.1.5.3.1.3.23) auf den Standard IHE PCC (Immunizations Section) (und hält auch dessen Vorgaben ein). '''''"Impfungen - kodiert"''''' beinhaltet u.a. ein Entry: '''''"Immunization Entry"''''' (1.2.40.0.34.6.0.11.3.1), welches wiederum laut Standarddefintion folgende Template IDs enthalten muss: HL7 CCD Medication activity (1.2.40.0.34.6.0.11.3.1) und IHE Immunizations Entry (2.16.840.1.113883.10.20.1.24). Daher trägt das Entry den Namen, der auch im Standard angegeben wird (mit dem Zusatz "Entry"). == Verwendung von OIDs OID ==Im Zusammenhang mit der Verwendung von OIDs OID sind die österreichischen Richtlinen einzuhalten
([https://www.gesundheit.gv.at/OID_Frontend/OID_Konzept_1-1-0.pdf Object Identifier (OID) Konzept für das österreichische Gesundheitswesen]).
Das österreichische OID Portal ist zu finden unter [https://www.gesundheit.gv.at/OID_Frontend/ OID Portal Österreich].
===OIDs OID für Implementierungsleitfäden===
{{BeginYellowBox}}
''Wichtiger Hinweis:'' Für '''jeden Implementierungsleitfaden''' muss (über das OID-Portal) eine OID '''unterhalb des Knotens 1.2.40.0.34.7''' (eHealth-Austria/documents)
'''registriert''' werden.
{{EndYellowBox}}
Falls Dokumente in aufeinander aufbauenden Versionen vorliegen, kann muss dafür darunter eine '''zusätzliche Ebene ''' angelegt werden.
Beispiel:
* 1.2.40.0.34.7.18.1: Implementierungsleitfaden Meldung von antimikrobieller Resistenzen - Version 1.00
===Art-Decor Root OIDsOID===
Als neuer '''Root-Knoten für Art-Decor''' wird 1.2.40.0.34'''.6.0''' (eHealth-Austria/services) verwendet. Er enthält OID für Value Sets und Templates.
<br>
====Root OIDs OID für Templates ====
Alle Art-Decor '''Templates''' müssen unterhalb des OID-Knotes 1.2.40.0.34.6.0'''.11''' liegen (eHealth-Austria/services/art-decor/templates).
Die OIDs OID der Art-Decor Templates sollen außerdem '''entsprechend ihres CDA-Template-Typs''' aus folgender '''Unterknoten ''' vergeben werden:
: '''.0 . Document-Level Template''': '''.1 . Header-Level Template''': '''.2 . Section-Level Template''': '''.3 . Entry-Level Template''': '''.9 . other CDA Fragment Template'''
Beispiele:
*Header-Level-Template:
: 1.2.40.0.34.6.0.11'''.1.'''2 Author (eHealth-Austria/services/art-decor/templates/header/xxx)
*Entry-Level-Template:
: 1.2.40.0.34.6.0.11'''.3.'''15 Antikörper-Bestimmung Data Processing Entry (eHealth-Austria/services/art-decor/templates/entry/xxx)
{{BeginYellowBox}}
''Wichtiger Hinweis:'' Die Verwaltung der unter diesen Knoten liegenden Templates unterliegt Art-Decor und benötigt daher '''keine Registrierung''' über das '''OID-Portal'''. Die nächste '''freie OID''' für '''Templates''' muss über die [https://art-decor.org/art-decor/decor-governance-group?id=1.2.4016.0840.341.3113883.12.2 16 '''Art-Decor Governance Group'''], unter HL7 Austria - "List of Artefacts under this Governance Group" / Reiter "Value SetsTemplates" ermittelt werden.
{{EndYellowBox}}
====Root OIDs OID für Value Sets====
Alle Art-Decor '''Value Sets''' müssen unterhalb des OID-Knotes 1.2.40.0.34.6.0'''.10''' liegen (eHealth-Austria/services/art-decor/value-sets).
{{BeginYellowBox}}
''Wichtiger Hinweis:'' Die Verwaltung der unter diesen Knoten liegenden Value Sets unterliegt Art-Decor und benötigt daher '''keine Registrierung''' über das '''OID-Portal'''. Die nächste '''freie OID''' für '''Value Sets''' muss über die [https://art-decor.org/art-decor/decor-governance-group?id=1.2.4016.0840.341.3113883.12.2 16 '''Art-Decor Governance Group'''], unter HL7 Austria - "List of Artefacts under this Governance Group" / Reiter "Value Sets" ermittelt werden.
{{EndYellowBox}}
== Namenskonventionen ==
=== Versions-Label ===
Im ''Version-Label'' wird prinzipiell die '''Jahrzahl''' der Verabschiedung Publikation des '''Templates'''(nach abgeschlossenem Ballot-Verfahren), des '''Value Sets''' bzw. des '''Datasets''' eingetragen. Sollte die Angabe des Jahres nicht ausreichend sein, wird sie mit .Monat ergänzt. Gleiches gilt für tagesaktuelle Versionen.
:Beispiele:
:* 2019
=== Item-Label ===
Der im Item-Label des '''Document-Level Templates''' angegebene Name wird von Art-Decor später automatisch als Name für das entsprechende Schematron verwendet, z.B. „elgaimpf‑UpdateImmunisierungsstatus“„eimpf-UpdateImmunisierungsstatus“.
'''Vorgaben für andere Templates?: TODO'''
=== Bezeichnungen für Templates Templatename ===
Die Namen von Templates werden wie folgt angegeben:
'''[Präfix]_[Template-Typ]_[ElementName]'''<br/>Wobei Als Trenner fungieren Unterstriche ("_"), wobei folgendes gilt:;[Präfix]: Als Präfix dient das Projektkürzel (Name des Repositories) in CamelCase-Notation, z.B. "atcdabrr".
;[Template-Typ]: Der Template-Typ muss einen der folgenden Template-Typen enthalten:
:* '''"document"''': für Document-Level-Templates
:* '''"entry"''': für Entries
:* '''"other"''' : alle Templates, die nicht in obige Kategorien fallen ("Template type not specified")
;[ElementName]: Bezeichnung des Templates in Upper-CamelCase-Notation. Als Trenner fungieren Unterstriche "_".
Beispiele:
===Versionierung von Templates ===
====Document-Level Templates====
Für jede neue Version eines Document-Level Templates ist eine neue OID zu verwenden. Der Bezug zur alten OID ist anzugeben(siehe [[ART-DECOR_Governance#Ableitung_von_Templates|Ableitung von Templates]]). Dadurch wird die Anwendung der korrekten Schematron-Regeln gemäß dem getesteten CDA-Dokument sichergestellt.
====Alle anderen Templates====
===Versionierung von Value Sets===
Die '''OIDsOID''' der Value Sets bleiben '''für alle Versionen gleich''', werden aber durch das Gültigkeitsdatum '''"effectiveDate"''' unterschieden ("Gültig ab"). Darüber hinaus kann eine Value Set ein '''offizielles Freigabedatum''' tragen. <br><br>Best Practices für die Erstellung und Pflege von Value Sets müssen angewendet werden, z.B. können Konzeptcodes hinzugefügt, aber nicht gelöscht werden, nur auf den Status "deprecated" gesetzt werden. {{BeginYellowBox}}''Wichtiger Hinweis:'' Wenn sich die Gesamtbedeutung der Codes in einem Value Set ändert, muss die neue Version des Value Sets eine '''neue OID ''' erhalten.{{EndYellowBox}}
Bei der Aktualisierung eines Value Sets muss das effectiveDate auf das aktuelle Datum (Gültig ab-Datum) geändert werden.
=== Art-Decor Building Block Repository ===
In Österreich kann derzeit folgendes bereichsspezifische '''Building Block Repository''' (BBR) verwendet werden:
*[https://art-decor.org/art-decor/decor-project--at-cda-bbr- '''ATCDABBR''']: Dies soll in Zukunft alle für Österreich relevanten Basis-Templates enthalten, die für spezifische Anwendungen (e-Health und ELGA) in die einzelnen Projektverzeichnisse abgeleitet verwendet werden können. <br>:Derzeit sind Templates für den CDA-Header sowie Basis-Templates für den e-Impfpass vorhanden. Dieses Verzeichnis wird laufend erweitert. Nach Fertigstellung von CDA-Leitfäden sollen entsprechende Templates in dieses Verzeichnis übernommen werden.
=== Projektverzeichnisse ===
== Governance Groups ==
Governance-Gruppen sind organisatorische Einheiten, die dazu dienen, die Verantwortung für Artefakte in Art-Decor darzustellen. Unter [https://art-decor.org/art-decor/decor-governance-group?id=1.2.4016.0840.341.3113883.12.2 16 '''Art-Decor Governance-GruppenGroup'''] sind alle Projekte der Gruppe HL7 Austria sichtbar, sowie alle angelegten Artefakte mit OID, Displayname, [[#Artefaktstatus]], BBR und Projekte, die das Template oder Value Set referenzieren.
=== Artefaktstatus ===
Die Zuordnung von Datensatz-Elementen und erstellten Templates wird '''empfohlen''' (Informationen zum [https://wiki.hl7.at/index.php?title=Hilfe:Art-Decor_Leitfadenerstellung#Dataset-Mapping_erstellen Dataset-Mapping])
= Governance für die CDA-Leitfadenerstellung mit Mediawiki =
==Leitfaden erstellen==
Wichtige Informationen hinsichtlich der technischen Erstellung eines CDA-Leitfadens mit Mediawiki sind unter [https://wiki.hl7.at/index.php?title=Hilfe:Leitfaden_erstellen "Leitfaden erstellen"] nachzulesen.
===Typische Gliederung eines Dokuments===
Um eine konsistente Vorgehensweise bei der Erstellung und Darstellung eines Implementierungsleitfadens zu gewährleisten, wird folgende (minimale) Struktur vorgegeben: '''TODO REVIEW'''
== Schematische Template-Darstellung ==
TODO
= Quality Assurance & Qualitätssicherung und Review ==
== Art-Decor Repository ==
TODO