Änderungen

Wechseln zu: Navigation, Suche

ART-DECOR Governance

1.096 Bytes hinzugefügt, 09:37, 3. Mär. 2021
Root OID für Templates
{{#customtitle:Governance für die CDA-Leitfadenerstellung mit Art-Decor und Mediawiki}}
 
{{#css:
.toc{
}
}}
 
<!--
{{Infobox Dokument
====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
=== Item-Label ===Der im Item-Label des Die '''Document-Level TemplatesBezeichnung (DisplayName)''' angegebene Name wird von Artdes Templates ist passend zu wählen und bei einer möglichen Unterscheidung zwischen unkodiert und kodiert dies mit einem Bindestrich folgend anzugeben, z.B.: "Kompletter Immunisierungsstatus" oder "Frühere Erkrankungen -Decor später automatisch als Name für unkodiert".Ist das entsprechende Schematron verwendetTemplate unverändert aus einer anderen Spezifikation übernommen, empfielt es sich dieses mit dem originalen Namen des Templates zu bennen, wie z.B. „eimpf-UpdateImmunisierungsstatus“: "Author" oder "Immunization Entry".
Das '''Vorgaben für andere Versions-Label (VersionLabel)''' des Templates?: TODOmuss gleich dem des DataSets angegeben werden ('''[Hauptversions-Jahr]''.[Nebenversions-Nummer]''''', siehe oben).
=== Templatename ===Die Namen von Der '''Name''' des Templates werden wird wie folgt angegeben:
'''[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
==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 (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====
TODO
 
===Versionierung von Value Sets===
Die '''OID''' 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 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
:Beispiel:== Item-Label ==:*VersionsDer im Item-Label: des '''YYYYMM.Korrekturnummer(Document-beta)''' ''Hinweise:'' <br>Die "Korrekturnummer" ist Level Templates''optional'': bei Änderungen innerhalb eines Monats angegebene Name wird diese angehängt.<br>"Beta" wird nur bei Value Sets von Art-Decor später automatisch als Name für das entsprechende Schematron verwendet, die noch bearbeitet werdenz. Sobald die Version gültig ist, wird das "beta" entferntB. „eimpf-UpdateImmunisierungsstatus“.
== Repositories ==
=== Projektverzeichnisse ===
* eEine Liste der Art-Impfpass (Pilot)* Basisleitfäden (alte Versionen)* TODODecor Projekte unter der HL7-Austria Governance Group ist hier verfügbar: [https://art-decor.org/art-decor/decor-governance-group?id=2.16.840.1.113883.2.16 HL7 Austria Projects].
== 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
 
== Schematische Template-Darstellung ==
TODO: evtl. Grafikvorlage
== 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
 
== Implementation Guides ==
TODO
3.869
Bearbeitungen

Navigationsmenü