Änderungen

Wechseln zu: Navigation, Suche

ART-DECOR Governance

2.427 Bytes hinzugefügt, 12:38, 27. Mai 2020
Qualitätssicherung und Review =
=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.
Eine Ausnahme bilden '''Template-Namen'''. Diese sind grundsätzlich in '''englischer Sprache''' zu vergeben, sodass die Bezeichnungen entsprechend ihrer Definition in den anderen (internationalen) CDA-Leitfäden beibehalten werden können und die Wiederverwendbarkeit bestehender Templates in weiteren Leitfäden erleichtert wird.
Nur Eine Ausnahme bilden die Namen von '''Section-Template-Namen Level Templates'''. Diese werden auf '''deutsch''' vergeben, da diese sie den in den Arbeitsgruppen abgestimmten Titel der Sektion tragen sollen.'''Empfehlung für Entries''': Sind im Entry Referenzen auf andere (internationale) Standards enthalten, soll der Name des Entries auch den entsprechenden Namen tragen (englisch). Ist dies nicht der Fall (im Entry gibt es z.B. nur eine ELGA Template ID), soll der Name des Entries an den Namen der Sektion angelehnt sein (deutsch). 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 OID ==
====Root 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 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 "Templates" ermittelt werden.
{{EndYellowBox}}
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
=== 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), z.B. "atcdabrr".
;[Template-Typ]: Der Template-Typ muss einen der folgenden Template-Typen enthalten:
:* '''"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.
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====
=== 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.
: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 werden können. Das ATCDABBR wird laufend mit neuen Templates erweitert. Nach Fertigstellung eines neuen CDA-Leitfadens sollen entsprechende Templates in dieses Verzeichnis übernommen werden. Die im ATCDABBR befindlichen Templates dürfen nur von einem eingeschränkten Benutzerkreis bearbeitet werden.:Verantwortlichkeiten und Prozesse sind im Kapitel [[#Revision]] beschrieben.====Ableitung von Templates====Beim Ableiten von Templates soll einer der folgenden '''Beziehungstypen''' angegeben werden:*'''Spezialisierung''': bestehende Vorgaben werden weiter '''eingeschränkt''' (z.B. von [O] auf [M] oder von 0..* auf 0..1, ebenfalls [O] auf [NP])*'''Adaptierung''': bestehende Vorgaben werden '''erweitert''' (z.B. von [M] auf [O] oder von 0..1 auf 0..*) oder neue Elemente, Attribute, ValueSets, Fixe Werte werden hinzugefügt. Weitere Informationen sind im "Prozess der CDA-Leitfadenerstellung" unter [[Hilfe:Art-Decor_Leitfadenerstellung#Relationships|Relationship]] zu finden.
=== 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 ===
===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'''
* :1 Zusammenfassung:2 Informationen über dieses Dokument** Allgemeines::2.1 Impressum::2.2 Haftungsausschluss** ::2.3 Sprachliche Gleichbehandlung** ::2.4 Lizenzinformationen::2.5 Urheber- und Nutzungsrechte von anderen Quellen ("Third Party IP")::2.6 Verbindlichkeit** Zielgruppe::2.7 Verwendete Grundlagen und Bezug zu anderen Standards::2.8 Weitere unterstützende Materialien** Hinweis auf verwendete Grundlagen:3 Einleitung** Danksagung::3.1 Ausgangslage und Motivation** Hinweise zur Nutzung ::3.2 Zweck des LeitfadensDokuments::3.3 Zielgruppe** Revisionsliste:4 Harmonisierung** Weitere unterstützende Materialien::4.1 Autoren und Mitwirkende** Bedienungshinweise:5 Begriffsdefinitionen** Impressum:6 Technischer Hintergrund* Harmonisierung::6.1 Allgemeine Richtlinien * Einleitung::6.2 Datentypen** Ausgangssituation:7 Funktionale Anforderungen** Zweck::7.1 Darstellung** Hierarchie ::7.2 Verwendung in der ImplementierungsleitfädenELGA Infrastruktur:::7.2.1 Vorgaben zu Dokument-Metadaten (XDS-Metadaten)::7.3 Versionierung & Stornierung von Dokumenten::7.4 Mehrsprachigkeit und grenzüberschreitender Austausch* :8 User Storys ("Anwendungsfälle"):9 Dataset:10 Technische Spezifikation* Administrative Daten ::10.1 Übersicht CDA Strukturen (CDA Header& Body)* Fachlicher Inhalt (::10.2 CDA Body)Templates:::10.2.1 Document Level Templates:::10.2.2 Header Level Templates* Technische Konformitätsprüfung:::10.2.3 Section Level Templates** Schema-Prüfung:::10.2.4 Entry Level Templates** Schematron-Prüfung:::10.2.5 Sonstige Templates (Fragmente)** Online-Validation von CDA-Dokumenten::10.3 Terminologien* :11 Anhang** Referenzen::11.1 Abbildungsverzeichnis::11.2 Abkürzungsverzeichnis** Revisionsliste::11.3 Literaturverzeichnis
== Schematische Template-Darstellung ==
TODO
= Qualitätssicherung und Review ==
== Art-Decor Repository ==
TODO
3.869
Bearbeitungen

Navigationsmenü