3.869
Bearbeitungen
Änderungen
→Root OID für Templates
{{#customtitle:Governance für die CDA-Leitfadenerstellung mit Art-Decor und Mediawiki}}
{{#css:
.toc{
}
}}
<!--
{{Infobox Dokument
= Weiterentwicklung des Dokuments =
Dieses Dokument enthält die aktuellsten Fragen und Entscheidungen Festlegungen bezüglich der Arbeit mit Art-Decor und Mediawiki in Österreich und wird laufend angepasst.
{{BeginYellowBox}}
''Wichtiger Hinweis:'' Anfragen hinsichtlich der Änderung oder Erweiterung dieses Dokuments stellen Sie bitte an [[cda@elga.gv.at]].
====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 folgenden '''Unterknoten''' vergeben werden:
: '''.0. Document-Level Template'''
: '''.1. Header-Level Template'''
: '''.2. Section-Level Template'''
: '''.3. Entry-Level Template'''
: '''.9. other CDA Fragment 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=2.16.840.1.113883.2.16 '''Art-Decor Governance Group'''], unter HL7 Austria - "List of Artefacts under this Governance Group" / Reiter '''"Templates" ''' ermittelt werden.
{{EndYellowBox}}
====Root 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).
Beispiele:
*Value Set:
: 1.2.40.0.34.6.0'''.10.'''8 ELGA_EntityNamePartQualifier_VS(eHealth-Austria/services/art-decor/value-sets/xxx)
{{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=2.16.840.1.113883.2.16 '''Art-Decor Governance Group'''], unter HL7 Austria - "List of Artefacts under this Governance Group" / Reiter '''"Value Sets" ''' ermittelt werden.
{{EndYellowBox}}
== Namenskonventionen Namens- und Versionierungs-Konventionen ==Es wird zwischen den Namens- und Versionierungs-Konventionen von '''Datasets''', '''Templates''' und '''Value Sets''' unterschieden. === Datasets === Zu jedem Dataset müssen Name und Versions-Label ===(VersionLabel) angegeben werden. Der '''Name''' des Datasets ist passend dem Inhalt zu wählen. Im Das ''Version'Versions-Label(VersionLabel)'' wird prinzipiell die 'des DataSets muss wie folgt angegeben werden:''Jahrzahl'[Hauptversions-Jahr]'' der Publikation des .[optionale Nebenversions-Nummer]'''Templates''' Als Trenner fungiert ein Punkt (nach abgeschlossenem Ballot-Verfahren"."), des wobei folgendes gilt:<br/>;'''Value Sets[Hauptversions-Jahr]''' bzw: Das Jahr in welcher die Hauptversion publiziert wurde. des Es wird zur Zeit als sehr unwahrscheinlich genommen das eine Hauptversion mehr als ein Mal im Jahr publiziert wird.<br/>;'''''[optionale Nebenversions-Nummer]''Datasets''' eingetragen. Sollte die Angabe des Jahres nicht ausreichend sein, : Eine darauffolgende Nummer welche für jede neue Nebenversion um eins hochgezählt wird sie mit .Monat ergänzt. Gleiches gilt für tagesaktuelle Versionen.:Beispiele:<br/>:* '''2019''' für die erste Hauptversion<br/>:* '''2019.011''' für eine neue Nebenversion der Hauptversion 2019<br/>:* '''2019.012''' für eine weitere Nebenversion der Hauptversion 2019<br/>* '''2021''' für eine neue Hauptversion im Jahr 2021<br/>* '''2021.1''' für eine neue Nebenversion der Hauptversion 2021<br/>* usw. === Templates ===Zu jedem Template müssen Bezeichnung (DisplayName), Versions-Label (VersionLabel) und Name des Templates angegeben werden.16
Das '''Vorgaben für andere Versions-Label (VersionLabel)''' des Templates?: TODOmuss gleich dem des DataSets angegeben werden ('''[Hauptversions-Jahr]''.[Nebenversions-Nummer]''''', siehe oben).
'''[Präfix]_[Template-Typ]_[ElementName]'''<br>
Als Trenner fungieren Unterstriche ("_"), wobei folgendes gilt:
*'''Other'''-Template im AT-CDA-BBR:
::Name: atcdabbr_other_AddressCompilation<br>
::DisplayName: "Address Compilation"{{BeginYellowBox}}Hinweise zur Änderung bestehender Templates siehe [[https://wiki.hl7.at/index.php?title=Hilfe:Art-Decor_Leitfadenerstellung#.C3.84nderung_bestehender_Templates|Art-Decor Leitfadenerstellung - Änderung bestehender Templates]] {{EndYellowBox}}=== Bezeichnungen für Value Sets ===Die '''Namen ''' von Value Sets werden wie folgt angegeben:'''[Präfix]_[ValueSetsNameValueSetName]_VS'''<br/>Als Trenner fungieren Unterstriche ("_"), wobei folgendes gilt:;[Präfix]: Als Präfix dient das Projektkürzel (Name des Repositories), z.B. "eimpf".;[ValueSetName]: Bezeichnung des Value Sets in Upper-CamelCase-Notation, wobei "Displayname" und "Name" des Value Sets sind identisch. <br> sein sollen;VS:steht immer am Ende jeder Value Set Bezeichnung Beispiel:
:*Name: eimpf_Abrechenbarkeit_VS
:*Wiedergabename: eimpf_Abrechenbarkeit_VS
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 im '''Version-Label''' prinzipiell das effectiveDate auf das aktuelle Datum (Gültig abder Gültigkeit eingetragen werden. Dies geschieht im Format '''[Jahreszahl]-[Monat]-[Tag]'''. <br/>Beispiele:<br/>* '''2019-Datum) geändert werden01-16''' für den 16.1.2019<br/>* '''2020-11-20''' für den 20.11.2020
== Repositories ==
=== Projektverzeichnisse ===
== Governance Groups ==
Elemente und Attribute, die im Template verwendet werden, sind zu dokumentieren. Die Beziehung zu anderen Templates ist anzugeben, um festzuhalten, wie sie sich zueinander verhalten (z.B. Spezialisierung, Anpassung usw.).
<br><br>
TODO: prüfen <br>Other elements that were in addition available according the HL7 CDA standard shall not be mentioned in the Art-Decor template.
* Open vs. Closed Templates
=== Standard-Referenzen ===
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.
Die erste Template-ID soll wie folgt bezeichnet werden: "HL7 Austria - [Name des Templates]".
== Datasets ==
:::10.2.3 Section Level Templates
:::10.2.4 Entry Level Templates
:::10.2.5 Sonstige Templates (Weitere CDA Fragmente)
::10.3 Terminologien
:11 Anhang
::11.2 Abkürzungsverzeichnis
::11.3 Literaturverzeichnis
== Revision ==
== Wiki ==
==Check before finalizing==
Thew folowing checks help to identify possible errors or missing includes from Art-Decor. Templates from other repositories than under the governance from eHealth Suisse need to be imported separatly. Please send the necessary OID and related project information to the [mailto://support@art-decor.org Art-Decor Support].
*Perform search for:
** "/dynamic"
= Qualitätssicherung und Review =
== Art-Decor Repository ==
TODO