3.869
Bearbeitungen
Änderungen
→Szenarios
{{#customtitle:Governance für die CDA-Leitfadenerstellung mit Art-Decor und Mediawiki}}
{{#css:
.toc{
width: 20%;
float: right !important;
margin: 10px 0px 10px 30px !important;
border: 1px solid #AAA;
background-color: #F9F9F9;
display: table;
padding: 7px !important;
}
}}
<!--
Das österreichische OID Portal ist zu finden unter [https://www.gesundheit.gv.at/OID_Frontend/ OID Portal Österreich].
===OIDs 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)
* 1.2.40.0.34.7.18.1: Implementierungsleitfaden Meldung von antimikrobieller Resistenzen - Version 1.00
===Art-Decor Root OIDs===
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.
{{BeginYellowBox}}
{{EndYellowBox}}
<br>
====Root OIDs 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 der Art-Decor Templates sollen außerdem '''entsprechend ihres CDA-Template-Typs''' aus folgender Unterknoten vergeben werden:
: 1.2.40.0.34.6.0.11.3.15 Antikörper-Bestimmung Data Processing Entry (eHealth-Austria/services/art-decor/templates/entry/xxx)
====Root OIDs 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).
== Namenskonventionen ==
=== Versions-Label ===
Im ''Version-Label'' wird prinzipiell die '''Jahrzahl''' der Verabschiedung des '''Templates''', 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
:* 2019.01
:* 2019.01.16
=== 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“.
'''Vorgaben für andere Templates?: TODO'''
=== Bezeichnungen für Templates ===
Die Namen von Templates werden wie folgt angegeben:
'''[Präfix]_[Template-Typ]_[ElementName]'''<br/>
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
:* '''"header"''': für Header-Level-Templates
:* '''"section"''': für Sektionen
:* '''"entry"''': für Entries
:* '''"other"''' : alle Templates, die nicht in obige Kategorien fallen ("Template type not specified")
;[ElementName]: Bezeichnung des Templates in CamelCase-Notation. Als Trenner fungieren Unterstriche "_".
Beispiele:
*'''Document-Level-Template''' im ELGA e-Impfpass Repository:
::Name: "eimpf_document_KompletterImmunisierungsstatus"<br>
::DisplayName: "Kompletter Immunisierungsstatus"
*'''Header-Level-Template''' im AT-CDA-BBR:
::Name: atcdabbr_header_Author<br>
::DisplayName: Author
*'''Unkodierten Sektion''' im Repository AT-CDA-BBR:
::Name: "atcdabrr_section_FruehereErkrankungUnkodiert"<br>
::DisplayName: "Frühere Erkrankungen - unkodiert"
*'''Kodierten Sektion''' im ELGA e-Impfpass Repository:
::Name: "eimpf_section_ImpfrelevanteErkrankungenKodiert"<br>
::DisplayName: "Impfrelevante Erkrankungen - kodiert"
*'''Entry''' im AT-CDA-BBR:
::Name: "atcdabbr_entry_Immunization"<br>
::DisplayName: "Immunization Entry"
*'''Other'''-Template im AT-CDA-BBR:
::Name: atcdabbr_other_AddressCompilation<br>
::DisplayName: Address Compilation
=== Bezeichnungen für Value-Sets ===
Die Namen von Value-Sets werden wie folgt angegeben:
'''[Präfix]_[ValueSetsName]_VS'''<br/>
"Displayname" und "Name" des Value-Sets sind identisch. <br>
:Beispiel:
:*Name: eimpf_Abrechenbarkeit_VS
:*Wiedergabename: eimpf_Abrechenbarkeit_VS
==Versionierung==
===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. Dadurch wird die Anwendung der korrekten Schematron-Regeln gemäß dem getesteten CDA-Dokument sichergestellt.
====Alle anderen Templates====
TODO
===Versionierung von Value-Sets===
Die '''OIDs''' 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. Wenn sich die Gesamtbedeutung der Codes in einem Value-Set ändert, muss die neue Version des Value-Sets eine neue OID erhalten.
== Datasets ==
Die Verwendung von Art-Decor-Datensätzen wird für neue Projekte empfohlen. Diese bilden die funktionalen Anforderungen an das Projekt ab und sind Diskussionsgrundlage bei Fachexpertengesprächen (erfordern kein technisches Hintergrundwissen).
<br>
Folgende Inhalte eines Dataset-Elements sind mindestens anzugeben:
== Szenarios ==
Das Erstellen von '''Transaktionen''' im Rahmen von Szenarios ist für die Generierung von Schematron-Regeln '''zwingend erforderlich'''.<br>
Die Transaktion soll dem Schema '''[Projektkürzel]_[Name des Szenarios]''' folgen.
<br>
Die Angabe von Kardinalität (optional, wiederholbar) und Konformität (erforderlich, obligatorisch) für die einzelnen Elemente des Datasets '''wird empfohlen'''.
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, dass alle erforderlichen Datensatz-Elemente in den Templates modelliert wurden.
= Mediawiki =
