Änderungen

{{#customtitle:Governance für die CDA-Leitfadenerstellung mit Art-Decor und Mediawiki(Version 1)}}

|Date = 143.125.20212023

|Submitted = 143.125.20212023}}

{{BeginYellowBox}}''Wichtiger Hinweis:'' Anfragen hinsichtlich der Änderung oder Erweiterung dieses Dokuments stellen Sie bitte an [mailto:office@hl7.at office@hl7.at].{{EndYellowBox}}

Governance-Gruppen sind organisatorische Einheiten, die dazu dienen, die Verantwortung für Artefakte (Templates und Value-Sets) in Art-Decor darzustellen. Unter der [https://art-decor.org/art-decor/decor-governance-group?id=1.2.40.0.34.3.1.2 ELGA Art-Decor Governance Group] sind alle Projekte der ELGA sichtbar, sowie alle angelegten Artefakte mit OID, Displayname, Artefaktstatus, BBR und Repositories), z.B. "at-cda-brr"-Projekte, die das Template oder Value Set referenzieren. Weiters existiert die [https://art-decor.org/art-decor/decor-governance-group?id=2.16.840.1.113883.2.16 HL7 Austria Art Decor Governance Group] , welche alle eHealth Austria Vorgaben umfasst. Dabei wird die hier beschriebene ELGA Governance auch für die HL7 Austria relevant und soll von dieser übernommen werden. 

:1 Zusammenfassung:2 Informationen über dieses Dokument::2.1 Impressum::2.2 Haftungsausschluss::2.3 Sprachliche Gleichbehandlung::2.4 Lizenzinformationen:::2.4.1 Urheber- und Nutzungsrechte von anderen Quellen ("Third Party IP"):::2.4.2 SNOMED CT:::2.4.3 Weitere Terminologien::2.5 Verwendete Grundlagen und Bezug zu anderen Standards::2.6 Verbindlichkeit::2.7 Wichtige unterstützende Materialien::2.8 Bedienungshinweise:::2.8.1 Farbliche Hervorhebungen und Hinweise:::2.8.2 PDF-Navigation:3 Begriffsdefinitionen:4 Einleitung::4.1 Ausgangslage und Motivation::4.2 Zweck des Dokuments::4.3 Zielgruppe:5 Leitfadenerstellungs- und Harmonisierungsprozess::5.1 Revision der Leitfäden::5.2 Autoren und Mitwirkende:::5.2.1 Autoren:::5.2.2 Mitwirkende:6 Technischer Hintergrund:7 Allgemeine Richtlinien für ELGA CDA-Implementierungsleitfäden:8 Funktionale Anforderungen::8.1 Voraussetzungen für den Zugriff auf e-Befunde in ELGA::8.2 Anwendungsfälle des Dokumentenmanagements:::8.2.1 Dokument-Metadaten (XDS-Metadaten):9 Konformitätsprüfung:10 Datentypen:11 Vorgaben zum medizinischen Inhalt:12 Anwendungsfälle / User Stories :13 Dataset:14 Technische Spezifikation::14.1 Übersicht CDA Strukturen (Header & Body)::(evtl. Übersichtstabelle der Header-Elemente für dokumenten-relevante Zeitpunkte/Zeitspannen)::14.2 CDA Templates:::14.2.1 Document Level Templates:::14.2.2 Header Level Templates (Hinweis: hier sollten nur jene Header Level Templates aufgeführt werden, die für spezielle Leitfäden erstellt / adaptiert wurden. Alle anderen werden als Teil der DLTs angezeigt):::14.2.3 Section Level Templates:::14.2.4 Entry Level Templates:::14.2.5 Weitere CDA Fragmente::14.3 Terminologien:15 Anhang::(15.1 evtl. Abkürzungsverzeichnis)::15.2 Abbildungsverzeichnis::15.2 Tabellenverzeichnis::15.3 Einzelnachweise::15.4 Literatur und Weblinks::15.5 Revisionsliste::15.6 Erratum  Bei Kapiteln ohne Inhalt soll kurz darauf eingegangen werden, warum dieser Leitfaden dieses Kapitel nicht füllt.  Aufgrund bisheriger Erfahrungen wird '''nicht empfohlen''', Textabschnitte in Teildokumente (eigene Wiki-Seiten) '''auszulagern und zu [https://de.wikipedia.org/wiki/Transklusion transkludieren]''', da Änderungen an dem Teildokument automatisch in alle transkludierenden Wiki-Leitfäden übernommen werden und einer Abstimmung mit den Leitfadenverantwortlichen bedürfen. Weiters ist beim Bearbeiten eines Seitenabschnittes nur im Seitenlink bzw. unter Menüpunkt "Links auf diese Seite" ersichtlich, ob man sich auf der Hauptseite des eigenen Leitfadens oder auf einer bereits transkludierten Seite befindet, was die Gefahr eines unbeabsichtigten Änderns anderer bestehender Leitfäden erhöht. Ausnahmen gelten bei bilden folgende Seiten, welche transkludiert werden können, aber '''nicht bearbeitet werden dürfen''' (liegen in der Obhut des Allgemeinen Leitfadens): *ILF:LizenzinformationenFür die '''Kapitel Section Level Templates, Entry Level Templates''' und '''Weitere CDA Fragmente''' in speziellen Leitfäden gilt, dass für Templates, die im Allgemeinen Implementierungsleitfaden spezifiziert sind, eine einfache Referenz auf den Allgemeinen Implementierungsleitfaden ausreicht. Dabei MUSS aber angegeben werden, um welche Hauptversion des Allgemeinen Leitfaden es sich handelt. =Art-Decor Projekt=Ein neuer CDA-Leitfaden '''muss''' in einem eigenen Projektverzeichnis angelegt, alle Autoren müssen entsprechend berechtigt werden. Dies muss beim [https://www.art-decor.org/mediawiki/index.php?title=Contact Art-Decor-Support] beantragt werden. Das neue Projekt kann am besten mit folgendem E-Mail-Template beantragt werden:{{BeginValueSetBox}}Dear Art-Decor-Support,we would like to ask you to create a new project in Art-Decor:*Name: <'''displayName des Projekts'''>*Prefix: <'''Projektkürzel''' - soll immer mit at- beginnen, z.B. "at-emed-" oder "at-lab-" (Vorweg: an bestimmten Stellen werden Bindestriche durch das System ausgeblendet)>*ContainsReusableContent=false*Experimental/Test=false*defautLanguage=de*id=1.2.40.0.34.777.<'''nächste freie ID''', siehe Kapitel OID>*Governance-Groups: ELGA, HL7 Austria*Wiki-Bot activated à wiki.hl7.at Thank you in advance.{{EndValueSetBox}}  Eine Liste der Art-Decor Projekte ist unter der HL7-Austria Governance Group verfügbar [https://art-decor.org/art-decor/decor-governance-group?id=1.2.40.0.34.3.1.2 ELGA Art-Decor Governance Group]. Weitere offizielle Informationen sind unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor ART Project Editor] zu finden. ==Name==Der Name des Projekts, auch displayName des Projekts genannt, soll sprechend gewählt werden und ist mit dem ELGA SCC Team abzusprechen. Dies gilt auch für das Prefix, auch Projektkürzel genannt. Dabei soll dieses keine Bindestriche enthalten, z.B. "''elgatest''". ==OID==Alle Art-Decor Projekte bekommen die unter ([https://art-decor.org/art-decor/decor-governance-group?id=1.2.40.0.34.3.1.2 Governance Group (art-decor.org)] -> Projects) einsehbaren OID mit der Benennung nächste ID im 1.2.40.0.34.777 Knoten. ==Version & Metadaten==Projekte selbst werden nicht versioniert. Nur die beinhaltenden DLT werden versioniert.  Projektkürzel unter "prefix" werden im lowercase geschrieben, ohne jegliche Trennzeichen. Bsp.: "elgatgd". Neue Projekte dürfen keine bbr sein! Die Checkbox [[Datei:Image2021-6-24 13-41-12.png|200px]] darf nicht angehackt sein! Es wird empfohlen dem Projekt standardmäßig Referenzen zu den Building Block Repositories ''ad1bbr-, ad2bbr-, at-cda-bbr-, IHE-PCC-'' hinzuzufügen (siehe auch [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor#Reference_a_building_block_repository Reference a building block repository]). ==Inhalt==In Österreich kann derzeit folgendes bereichsspezifische '''Building Block Repository''' (BBR) für die Ableitung oder Referenzierung von Templates verwendet werden:*[https://art-decor.org/art-decor/decor-project--at-cda-bbr- at-cda-bbr]Dies soll in Zukunft alle für Österreich relevanten Basis-Templates enthalten, die für spezifische Anwendungen (eHealth und ELGA) in die einzelnen Projektverzeichnisse abgeleitet werden können. Das at-cda-bbr wird laufend mit neuen Templates erweitert. Nach Fertigstellung eines neuen CDA-Leitfadens sollen weiter zu verwendete Templates in dieses Verzeichnis übernommen werden. Die im at-cda-bbr befindlichen Templates dürfen nur von einem eingeschränkten Benutzerkreis bearbeitet werden.  ===Statuswechsel eines Templates ===In einem Repository werden Artefakte (Templates/Value Sets) zunächst im Status "Entwurf" erstellt. Der Status eines Artefakts im Repository kann gemäß den Regeln der hier beschriebenen Governance geändert werden (siehe [https://art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Changing_the_status_of_a_template "Changing the status of a template"]).  {||-| [[Datei:Kyellow.png|15px|rahmenlos|left]]||Entwurf: Das Template verbleibt bis zur Veröffentlichung im Status „Entwurf“ und ist bearbeitbar.|-|[#Name[Datei:Kgreen.png|15px|rahmenlos|left]]||Aktiv: Gültiges Template, dessen Inhalt nicht mehr verändert werden kann. Zum Bearbeiten (Entwurf)muss das Template eine neue Version bekommen.|-|[[Datei:Kdeprecblue.png|15px|rahmenlos|left]]||Veraltet: Aktive Templates, die nicht mehr verwendet werden sollen, können in den Status „veraltet“ versetzt werden. Dieser Status ist endgültig.|} {| class="wikitable"|-|[[Datei:TemplateStatuswechsel2021-9-22.png|top]]|| '''Beschreibung Statuswechsel eines Templates (Diagramm)'''

eHealth Implementierungsleitfäden können auch in englischer Sprache verfasst '''1.''' Bevor ein Template neu angelegt wird, soll überprüft werden, ob ein verwendbares Dummy-Template(*) vorhanden ist. Ein neues Template erhält immer Version 1.0.0 und hat den Status "'''Entwurf'''".

Wichtige Informationen hinsichtlich der technischen '''2.''' Nach erstmaliger Erstellung eines CDATemplates oder nach Durchführung von Major- oder Minor-Leitfadens mit Mediawiki sind unter Hilfe:Wiki – HL7 Austria MediaWiki nachzulesenÄnderungen, muss vor der Publikation ("Aktiv-Setzung" des Templates) ein Ballotverfahren durchgeführt werden. (Der Status "Revision vor Publikation" kann verwendet werden, um anzuzeigen, dass eine Publikation bevorsteht. Vom Status "Revision vor Publikation" kann in den Stauts "Aktiv" gewechselt werden.)

Die Einbindung eines neuen '''3.''' Wurde ein Ballotverfahren durchgeführt, erfolgt der Template-Statuswechsel zu "'''Aktiv'''" zum Publikationszeitpunkt des Leitfadens folgt einem vorgegebenen Prozess. Wird ein Template "Aktiv" gesetzt, wird die bestehende Versionsnummer im Version-Label mit dem Publikationsdatum ergänzt (z.B. 1.0.0+20210504, siehe [[https://confluence.elga.gv.at/display/SCCTERM/Versionierung Versionierung]). (Der Status "Revision nach Publikation" kann verwendet werden, um anzuzeigen, dieser ist ersichtlich unter Benutzung von Flagged Revisionsdass eine neue Version vorbereitet wird. Vom Status "Revision nach Publikation" kann man wieder in den "Aktiv" Status wechseln.)

------ ALT ----==Sprache=='''ELGA Implementierungsleitfäden9.''' Sind die Änderungen nicht von allen referenzierenden Leitfäden gewünscht oder noch nicht bekannt ob dies des Fall ist, muss eine "'''neue Bearbeitung''' " dieses Templates erstellt werden in . Es erhält eine '''deutscher Spracheneue Template-OID''' verfasst, Version 1. Dazu gehören textuelle Beschreibungen im Wiki0.0, siehe [https://confluence.elga.gv.at/display/SCCTERM/Versionierung Versionierung]). Die neue Bearbeitung kann ein Zwischenschritt sein, Artum kurzzeitig eine Major-DecorÄnderung für eine neue Version eines Templates zu erstellen, welche kurz vor Ballot dann als neue Version des originalen Templates erstellt wird.'''10.'''Major und Minor-Änderungen an Templates und Datasetserfordern (unabhängig davon, ob eine neue Version oder eine neue Bearbeitung erstellt wurde), immer ein Ballotverfahren vor Aktiv-Setzung des Templates. Patch-Änderungen können sofort "Aktiv" gesetzt werden, sollten jedoch idealerweise ebenfalls im Rahmen eines Ballotverfahrens "Aktiv" gesetzt werden.

''(*) Anmerkung: Wird ein Template im Status „Entwurf“ nicht mehr benötigt (und wird auch von keinem anderen Leitfaden referenziert), soll es ''Template-Namen'nicht auf "annulliert"''' sind grundsätzlich in oder '''englischer Sprache"zurückgewiesen"''' zu vergebengesetzt werden, sondern stattdessen soll der Inhalt gelöscht, sodass die Bezeichnungen entsprechend ihrer Definition in anderen der Titel auf „dummy“ (internationaleno.ä) CDAumbenannt und die Template-Leitfäden beibehalten Id auf .999 geändert werden können . Dieses Dummy-Template kann später für neue Templates verwendet werden. Durch das Löschen des Inhalts werden auch evtl. bestehende Referenzen (Beziehungen zu anderen Templates) entfernt, und die Wiederverwendbarkeit bestehender es scheint auch nicht mehr in den Beziehungen der referenzierenden Templates in weiteren Leitfäden erleichtert wirdauf. ''|}

Eine Ausnahme bilden die Namen = Datasets =Die Verwendung von '''SectionArt-Level Templates'''Decor-Datasets wird für neue Projekte empfohlen. Diese werden auf '''deutsch''' vergeben, da 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 bilden die funktionalen Anforderungen an den Namen der Sektion angelehnt sein das Projekt ab und sind Diskussionsgrundlage bei Fachexpertengesprächen (deutscherfordern kein technisches Hintergrundwissen).

Beispiel:Die Sektion Für Datasets gibt es '''keine speziellen Vorgaben''"Impfungen - kodiert"'hinsichtlich '''' (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) (OID und hält auch dessen Vorgaben ein). 'Version & Metadaten''''"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 ==Im Zusammenhang mit Bereits bei der Modellierung der Verwendung von OID sind die österreichischen Richtlinen einzuhaltenDatasets sollen bestehende Standards berücksichtigt werden (z.B. IHE PCC) und bestehende Dataset-Elemente so gut es geht '''aus anderen Projekten wiederverwendet''' werden (siehe auch [https://www.gesundheit.gvart-decor.atorg/OID_Frontendmediawiki/OID_Konzept_1index.php?title=DECOR-1-0.pdf Object Identifier (OID) Konzept für das österreichische Gesundheitswesendataset#Dataset_versioning Dataset versioning]).Das österreichische OID Portal ist zu finden unter [https://wwwDies funktioniert durch die Eingabe eines Names und dem mit etwas Ladezeit folgendem Vorschlag von ähnlichen Konzepten.gesundheit.gv.at/OID_Frontend/ OID Portal Österreich]Dabei sollte der Sinn des Datasets, der aus der Beschreibung hervorkommt, derselbe sein.

Weitere offizielle Informationen sind unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Dataset_Editor ART Dataset Editor] zu finden. ==OID für Implementierungsleitfäden=Name =={{BeginYellowBox}}''Wichtiger Hinweis:'' Für '''jeden Implementierungsleitfaden''' muss (über das OID-Portal) eine OID Es gibt keine speziellen Namenskonoventionen, der '''unterhalb des Knotens 1.2.40.0.34.7Name''' (eHealth-Austria/documents) ist jedoch '''registriertanzugeben''' werden.{{EndYellowBox}}Falls Dokumente in aufeinander aufbauenden Versionen vorliegen, muss dafür darunter eine '''zusätzliche Ebene''' angelegt werden. !

Beispiel: == Inhalt ==* 1Es ist eine '''Beschreibung''' und der '''Werttyp/Valuetype''' anzugeben.2.40.0.34.7.18: Implementierungsleitfaden Meldung von antimikrobieller Resistenzen * 1.2.40.0.34.7.18.1: Implementierungsleitfaden Meldung von antimikrobieller Resistenzen - Version 1.00

===Art-Decor Root OID===Als neuer '''Root-Knoten für Art-DecorWenn vorhanden''' wird 1.2.40.0.34'''.6.0''' (eHealth-Austria/services) verwendet. Er enthält OID für Value Sets und Templates.<br>====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 folgenden '''Unterknoten''' vergeben muss zusätzlich angegeben werden:

: * '''.0. Document-Level TemplateAuswahllisten'''* Link zu '''codierten Konzepten / Value Sets''' (Terminologien)

: Die Zuordnung von Dataset-Elementen und erstellten Templates unter "Template" → "Template-Mapping" wird '''empfohlen, ist aber nicht verpflichtend'''(siehe auch [https://www.art-decor.1org/mediawiki/index. Headerphp?title=ART_Template_Associations ART Template Associations]). 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 (auch für die Experten-/Arbeitsgruppe), dass alle erforderlichen Dataset-Level Template'''Elemente in den Templates modelliert wurden.

: = Templates =Ein Leitfadenprojekt besteht aus '''einem oder mehreren Document Level Templates (DLT)'''(jedes DLT entspricht dabei einem Dokumententyp), welche die Struktur für ein gültiges CDA-Dokument vorgeben. Darüber hinaus werden in einem Leitfadenprojekt zahlreiche nicht-DLT-Templates referenziert, die im at-cda-brr spezifiziert wurden. Ein Leitfadenprojekt kann außerdem nicht-DLT-Templates beinhalten, die ausschließlich für das Projekt spezifiziert wurden.2Für die Verwendung ist folgende Seite [https://www. Sectionart-Level decor.org/mediawiki/index.php?title=ART_Template_Editor ART Template'''Editor] zu lesen.

: '''Info: Solange das DLT noch nicht in der Transaktion des Szenarios verlinkt ist, wird dessen Label (im Template-Baum) als oranges Dreieck mit Pfeilen angezeigt, sonst als oranges Viereck/Buch.3. Entry-Level Template'''

: ==Vorbedingungen für die Erstellung neuer Templates==Bevor neue Templates erstellt werden, sollte geprüft werden, ob bestehende Templates (bestenfalls im at-cda-bbr), die Anforderungen bereits erfüllen. Gibt es passende Templates können diese durch '''.9. other CDA Fragment TemplateReferenzierung'''(unveränderte Übernahme) mittels Kettensymbol in das bestehende Projekt übernommen werden. In diesem Fall sind keine Änderungen an dem Template möglich! Diese Funktion sollte nur verwendet werden, wenn es bereits ein passendes ELGA-/e-Health-Template gibt.

Beispiele:*HeaderUm herauszufinden, welche Art-Level-Template: : 1.2.40.0.34.6.0.11'''.1.'''2 Author Decor Projekte (eHealthauch außerhalb der eigenen Governance-Austria/services/art-decor/templates/header/xxxGroup)*Entry-Level-bereits ein bestimmtes Template: : 1.2.40.0.34.6.0.11umgesetzt haben, kann man im Menüpunkt '''.3.„Auge“'''15 Antikörper-Bestimmung Data Processing Entry (eHealthlinks oben in der ArtDecor-Austria/services/art-decor/templates/entry/xxxProjektseite){{BeginYellowBox}}''Wichtiger Hinweis:'' Die Verwaltung der unter diesen Knoten liegenden Templates unterliegt Art-Decor und benötigt daher '''keine Registrierung''' über das '''OID, die Template-Portal'''. Die nächste '''freie OID''' für '''ID oder den Namen eines Templates''' muss über die [https://art-decor.org/art-decor/decor-governance-group?id=2.16.840.1.113883.2.16 '''Artangeben -Decor Governance Group'''], unter HL7 Austria - "List of Artefacts under this Governance Group" / Reiter '''"> alle Templates"''' ermittelt mit zugehörigem Projekt werdenaufgelistet.{{EndYellowBox}}

====Root OID Vorbedingungen für Value Sets==Änderungen bestehender Templates==Alle Art-Decor '''Value Sets''' müssen unterhalb des OID-Knotes 1.2.40.0.34.6.0'''.10''' liegen Bevor ein bestehendes Template geändert wird (eHealth-Austria/services/art-decor/value-setsErstellung einer neuen Version, welche automatisch von allen dynamisch referenzierenden Templates verwendet wird), ist zu überprüfen, wie sich diese Änderung auf andere Leitfäden auswirkt bzw.Beispiele:*Value Set: : 1.2.40.0.34.6.0'''ob diese gewünscht ist.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''' In allen betroffenen Leitfäden 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 - Änderung auf der Diskussionsseite im Abschnitt "List of Artefacts under this Governance GroupAusblick" / Reiter '''"Value Sets"''' ermittelt festgehalten werden.{{EndYellowBox}}

== Namens''Zu Beachten:''*Wenn eine neue Version eines aus dem ATCDABBR referenzierten Templates (graues Icon im Template- und VersionierungsBaum) benötigt wird, MUSS diese im ATCDABBR erstellt werden.*Soll ein Template, das im ATCDABBR erstellt wurde, in ein Projekt-Konventionen ==Repository verschoben werden, muss dort zuerst eine evtl. bereits existierende Referenz darauf entfernt werden.Es wird zwischen den Namens*Fehlen die Berechtigungen für schreibenden Zugriff auf das ATCDABBR, sollen die erforderlichen Anpassungen zuerst im Projekt- Repository durchgeführt werden und Versionierungs-Konventionen können nach abgeschlossenem Ballot von '''Datasets''', '''Templates''' und '''Value Sets''' unterschiedenBerechtigten ins ATCDABBR übernommen werden.

=== Datasets =Name ==Zu jedem Dataset müssen Name und VersionsTemplate-Label (VersionLabel) angegeben Namen sind grundsätzlich in '''englischer Sprache''' zu vergeben, sodass sie entsprechend ihrer Definition in internationalen Standards beibehalten werdenkönnen und die Wiederverwendbarkeit bestehender Templates erleichtert wird.

Der '''Name''' des Datasets Eine Ausnahme bilden die Namen von Section-Level Templates. Diese werden auf deutsch vergeben, da sie den in den Arbeitsgruppen abgestimmten Titel der Sektion tragen sollen. Bei einer möglichen Unterscheidung zwischen uncodiert und codiert, ist passend dem Inhalt dies mit einem Bindestrich anzugeben. (Alte Schreibweise mit unkodiert und kodiert ist nicht mehr zu wählen.verwenden!)

Das '''Versions-Label Empfehlung für Entries''': Sind im Entry Referenzen auf andere 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 (VersionLabeldeutsch). ''Beispiel'' des DataSets muss wie folgt angegeben werden:Die Sektion '''''[Hauptversions"Impfungen -Jahr]codiert"''''' (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).[optionale Nebenversions'''''"Impfungen -Nummer]codiert"'''''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").

BeispieleWeitere Vorgaben für Name und Display-Name (Bezeichnung) eines Templates:<br/>* Der '''Name'''2019eines Templates wird wie folgt angegeben::''' für die erste Hauptversion<br/>[Präfix]_[Template-Typ]_[ElementName]''':Als Trenner fungieren Unterstriche ("_"), wobei folgendes gilt::* '''2019.1[Präfix]:''' für eine neue Nebenversion der Hauptversion 2019<br/>Als Präfix dient das Projektkürzel (Name des Repositories) ohne Bindestriche, z.B. "atcdabrr" oder "atlab". Diese Präfixe bleiben auch beim Verschieben ins at-cda-bbr bestehen! :* '''2019.2[Template-Typ]:''' Der Template-Typ muss einen der folgenden Template-Typen enthalten:::*"document": für Document-Level-Templates::*"header": für eine weitere Nebenversion der Hauptversion 2019<brHeader-Level-Templates::*"section": für Sektionen::*"entry": für Entries::*"other" : alle Templates/>Fragmente, die nicht in obige Kategorien fallen ("Template type not specified")::* '''2021[ElementName]:''' für eine neue Hauptversion im Jahr 2021<br/>Entspricht dem Display-Name ohne Leerzeichen, Bindestriche und Klammern "( )". Der ElementName wird in Upper-CamelCase-Notation angegeben.* Der '''2021.1Display-Name''' für eine neue Nebenversion enthält nur den ElementName (kein Präfix oder Template-Typ), wobei aber Leerzeichen, Bindestriche und Klammern "( )" verwendet werden dürfen. Dieser wird in der Hauptversion 2021<br/>* uswTemplate-Baum-Struktur angezeigt.

=== Templates ===''Beispiele:''* '''Document-Level-Template''' im ELGA e-Impfpass Repository:::Name: "eimpf_document_KompletterImmunisierungsstatus"::Display-Name: "Kompletter Immunisierungsstatus"Zu jedem * '''Header-Level-Template müssen Bezeichnung (DisplayName), Versions''' im at-cda-bbr:::Name: "atcdabbr_header_Author"::Display-Name: "Author"* '''Uncodierten Sektion''' im Repository at-cda-bbr:::Name: "atcdabrr_section_FruehereErkrankungUncodiert"::Display-Name: "Frühere Erkrankungen - uncodiert"* '''Codierten Sektion''' im ELGA e-Impfpass Repository:::Name: "eimpf_section_ImpfrelevanteErkrankungenCodiert"::Display-Name: "Impfrelevante Erkrankungen - codiert"* '''Entry''' im at-cda-bbr:::Name: "atcdabbr_entry_ImmunizationEntry"::Display-Label (VersionLabel) und Name des : "Immunization Entry"* '''Compilation/Other'''-Template im at-cda-bbr: Compilations/Other sind Template-Fragmente, wie z.B. Adressinformationen. Da sich diese in einem Leitfaden oft wiederholen können, sollen sie mit "contains" in Templates angegeben eingebunden werden(d.h.der Inhalt der Compilation wird nicht im verlinkenden Template angezeigt). Diese sollen aber im Leitfaden als eigene Kapitel vorhanden sein.::Name: "atcdabbr_other_AddressCompilation"::Display-Name: "Address Compilation"

Die == OID ==OIDs werden einmalig gesetzt und nicht mehr geändert. Alle Art-Decor '''Templates''' müssen unterhalb des OID-Knotes 1.2.40.0.34.6.0'''.11'''Bezeichnung liegen (DisplayNameeHealth-Austria/services/art-decor/templates). Die OID der Art-Decor Templates sollen außerdem '''entsprechend ihres CDA-Template-Typs''' aus folgenden '''Unterknoten''' vergeben werden::''' des Templates ist passend zu wählen und bei einer möglichen Unterscheidung zwischen unkodiert und kodiert dies mit einem Bindestrich folgend anzugeben, z.B0.''' Document-Level Template: "Kompletter Immunisierungsstatus" oder "Frühere Erkrankungen '''.1.''' Header- unkodiert"Level Template:'''.2.''' Section-Level TemplateIst das Template unverändert aus einer anderen Spezifikation übernommen, empfielt es sich dieses mit dem originalen Namen des Templates zu bennen, wie z:'''.B3.''' Entry-Level Template: "Author" oder "Immunization Entry"'''.9.''' other CDA Fragment Template

Das ''Beispiele:'Versions'* Header-Label Level-Template: 1.2.40.0.34.6.0.11.1.2 Author (VersionLabeleHealth-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:' des 'Die Verwaltung der unter diesen Knoten liegenden Templates muss gleich dem des DataSets angegeben werden (unterliegt Art-Decor und benötigt daher '''keine Registrierung''' über das '''[HauptversionsOID-Jahr]Portal'''.Die nächste '''freie OID''' für '''Templates''' muss über die [Nebenversionshttps://art-decor.org/decor/services/GovernanceGroupList?gg=1.2.40.0.34.3.1.2&language=en-Nummer]US&format=html#tabs1-templates1 '''ELGA Art-Decor Governance Group Template'', siehe oben'] (Vorsicht!: lange Ladezeit)ermittelt werden.{{EndYellowBox}}

Beispiele:*Für neu angelegte Templates (''Entwurf''Document-Level-TemplateStatus) soll im Version Label die ''' im ELGA e-Impfpass Repository:::Name: "eimpf_document_KompletterImmunisierungsstatus"<br>::DisplayName: "Kompletter Immunisierungsstatus"*Version'''Header-Level-1.0.0 angegeben werden. Wenn das Template''aktiv' im AT-CDA-BBR' gesetzt wird, wird das aktuelle Datum ergänzt. Nur das DLT erhält immer das Datum, an dem der Leitfaden veröffentlicht wird. Die genauen Vorgaben zur Versionierung sind hier zu nachzulesen [https:::Name: atcdabbr_header_Author<br>::DisplayName: Author//confluence.elga.gv.at/display/SCCTERM/Versionierung Versionierung].*Der Zweck des Templates muss aus der '''Unkodierten SektionBeschreibung''' hervorgehen. Im Fall von generischen Templates, die im Repository ATat-CDAcda-BBR:bbr angelegt werden und abgeleitet werden müssen (z.B. weil noch kein Value Set referenziert wurde), soll die Beschreibung möglichst allgemein gehalten werden.::Name: "atcdabrr_section_FruehereErkrankungUnkodiert"<br>::DisplayName: "Frühere Erkrankungen - unkodiert* Modellierung der Templates  "*'''Kodierten Sektionoffen/geschlossen''' 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: ELGA Implementierungsleitfäden werden seit 2020 "Address Compilationgeschlossen"{{BeginYellowBox}}Hinweise zur Änderung bestehender Templates siehe [[https://wikimodelliert.hl7Somit können nur die Elemente verwendet werden, die explizit modelliert werden oder durch den Datentypen implizit erlaubt sind.at/indexSobald bei einem Element mit gesetzten Datentypen ein Unterelement einfügt wird, sind die vom Datentypen möglichen Elemente nicht mehr implizit erlaubt, sondern müssen nun auch explizit modelliert werden.php?title=Hilfe:Art-Decor_Leitfadenerstellung#Attribute sind davon ausgenommen.C3.84nderung_bestehender_Templates|Art-Decor Leitfadenerstellung - Änderung bestehender ** Templates]] {{EndYellowBox}}=== Value Sets ===Die '''Namen''' von Value Sets eHealth Implementierungsleitfäden können auch "offen" modelliert werden wie folgt angegeben:.* Es ist zumindest ein korrektes '''[Präfix]_[ValueSetName]_VSBeispiel'''<br/>Als Trenner fungieren Unterstriche ("_"), wobei folgendes gilt:;[Präfix]: Als Präfix dient das Projektkürzel (Name des Repositories), z.B. "eimpf"anzugeben.;[ValueSetName]: Bezeichnung des Value Sets in Upper-CamelCase-Notation, wobei "Displayname" und "Name" des Value Sets identisch 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}}Beim ''Wichtiger Hinweis:'' Wenn sich die Gesamtbedeutung der Codes in einem Value Set ändert, muss die neue Version des Value Sets eine '''neue OIDAbleiten von Templates''' erhalten.{{EndYellowBox}}Bei ist durch einen der Aktualisierung eines Value Sets muss im folgenden '''Version-LabelBeziehungstypen''' prinzipiell das Datum der Gültigkeit eingetragen werdenanzugeben, wie sie sich zueinander verhalten (siehe auch [https://www. Dies geschieht im Format '''[Jahreszahl]art-[Monat]-[Tag]'''decor. <brorg/>Beispiele:<brmediawiki/>* '''2019index.php?title=ART_Template_Editor#Creating_a_new_version_of_an_existing_template Creating a new version of an existing template]). Die Template-01ID des Basistemplates wird nur zu Zwecken der Nachvollziehbarkeit in den Metadaten angegeben, in der Template-16''' für den 16.1.2019<br/>* '''2020Spezifikation selbst muss sie entfernt werden, weil dies sonst bei der Generierung von "closed" Schematron-Regeln zu Inkonsistenzen und zu falsch-11positiven Schematron-20''' für den 20.11Fehlern bei der Validierung führen kann.2020

== Item-Label ==Der im Item-Label des * '''Spezialisierung''': bestehende Vorgaben werden weiter '''Document-Level Templateseingeschränkt''' angegebene Name wird (z.B. von Art-Decor später automatisch als Name für das entsprechende Schematron verwendet[O] auf [M] oder von 0..* auf 0..1, ebenfalls [O] auf [NP])* '''Adaptierung''': bestehende Vorgaben werden '''erweitert oder geändert''' (z.B. „eimpf-UpdateImmunisierungsstatus“von [M] auf [O] oder von 0..1 auf 0..*) oder neue Elemente, Attribute, ValueSets, Fixe Werte werden hinzugefügt.

== Repositories ===== Art-Decor Building Block Repository ===In Österreich kann derzeit folgendes bereichsspezifische Die Übernahme vorhandener Templates aus Projektverzeichnissen, die '''Building Block RepositoryNICHT referenziert''' sind, ist nicht über die GUI möglich, weil diese Templates nicht als Prototyp angegeben werden können (BBRd.h. von ihnen kann nicht geerbt werden) verwendet werden:*[https://art-decor.org/art-decor/decor-project--at-cda-bbr- '''ATCDABBR'''].

Dies soll in Zukunft alle für Österreich relevanten Basis-Soll der Inhalt eines Templates enthaltentrotzdem verwendet werden, die für spezifische Anwendungen (elässt sich mittels Browser-Health und ELGA) in die einzelnen Projektverzeichnisse abgeleitet werden können.Direktlink

Das ATCDABBR wird laufend mit neuen Templates erweitert<code><nowiki>https://art-decor.org/temple/views/temple. Nach Fertigstellung eines neuen CDA-Leitfadens sollen entsprechende html?id=</nowiki>[OID des Templates in dieses Verzeichnis übernommen werden.]&[effectiveDate]&[prefix]&[language]&mode=readonly</code>

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 '''BeziehungstypenXML-Code jedes Templates''' angegeben werdenvia [https:*//www.art-decor.org/mediawiki/index.php?title=Temple '''Spezialisierung''': bestehende Vorgaben werden weiter '''eingeschränktTemple''' ] (z.B. von [O] auf [M] oder von 0..* auf 0im Lesemodus) anzeigen und anschließend kopieren.Der Inhalt kann dann in ein neu erstelltes Template eingefügt werden.1Dabei ist zu beachten, ebenfalls [O] auf [NP])*dass der '''AdaptierungZeitpunkt (effectiveDate)''': bestehende Vorgaben werden und die '''erweitertOID des neu erstellten Templates nicht verändert''' (zwerden.BAlle weiteren Inhalte können entsprechend angepasst werden. von [M] auf [O] oder von 0..1 auf 0..*) oder neue Elemente, Attribute, ValueSets, Fixe Werte Die OID muss in einem späteren Arbeitsschritt über die GUI korrigiert werden hinzugefügt.

Weitere Informationen sind im "Prozess der CDA-Leitfadenerstellung" unter [[Hilfe''Beispiel'':Art-Decor_Leitfadenerstellung#Relationships|Relationship]] zu finden.

=== Projektverzeichnisse ===Eine Liste der Art-Decor Projekte unter der HL7-Austria Governance Group ist hier verfügbar: [<code><nowiki>https://art-decor.org/art-decortemple/views/decor-governance-grouptemple.html?id=</nowiki>2.16.840756.5.30.1.1138831.10.2.16 HL7 Austria Projects].63&effectiveDate=2020-06-26T00:00:00&prefix=cdachvacd-&language=de-DE&mode=readonly</code>

== Governance Groups Inhalt ==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=2.16.840.1.113883.2.16 '''Art-Decor Governance Group'''] sind alle Projekte der HL7 Austria sichtbar, sowie alle angelegten Artefakte mit OID, Displayname, [[#Artefaktstatus]], BBR und Projekte, die das Template oder Value Set referenzieren.

=== Artefaktstatus ===* [[Datei:Warning.png|15px]] Wenn möglich, sollen bereits vorhandene Templates verwenden werden.In einem Repository * Zugrundeliegende Standards dürfen nur eingeschränkt, aber nicht erweitert werden Artefakte zunächst im Status .** ''Hinweis: Wenn ein Template laut Standard "Entwurfrequired" ist, aber für den konkreten Leitfaden nicht benötigt wird, kann das Template mit einem '''nullFlavor''' erstelltwerden (z. Nach Abschluss, Überprüfung B. Freitext-Inhalt „keine Information“ oder Code „entry empty“). Dadurch wird der Standard nicht verletzt und Bestätigung das Template kann trotzdem verwenden werden.''* Optionalitäten und Reihenfolge der Status Elemente müssen eingehalten werden.* Die '''erste Template-ID''' soll wie folgt bezeichnet werden: "HL7 Austria - [Name des Templates]". Diese Template-ID '''muss''' aus dem OID-Knoten 1.2.40.0.34.6.0'''.11''' stammen.** [[Datei:Warning.png|15px]] Jene Template-ID, die beim Erstellen eines neuen Templates oder Ableiten eines Artefakts im Repository gemäß den Regeln der zuständigen GovernancePrototyps von Art-Gruppe geändert Decor automatisch hinzugefügt wird, '''muss''' entfernt bzw. ersetzt werden (siehe [https'''nur über GUI mögich, nicht via Temple:''' "Template bearbeiten" → "#")* Weitere Template-IDs können angegeben werden, sofern das im zugrundeliegenden Standard gefordert ist (z.B. IHE).* include vs. contains** Im CDA-Header sollen alle Elemente mit <code>include<//artcode> eingebunden werden.*** Ausgenommen davon sind so genannte Compilation-Elemente, die in die Kategorie "Template type not specified" fallen (z.B. Address Compilation, Performer Body -decorLaboratory, etc.org)** Ab dem <code>component/structuredBody</mediawikicode> soll nur mehr mit <code>contains</indexcode> gearbeitet werden.php?title=ART_Template_Editor#Changing_the_status_of_a_template * Elemente und Attribute, die im Template verwendet werden, sind zu dokumentieren. Dabei kann in der Dokumentation auch auf den zugrundeliegenden Standard verwiesen werden.* Elemente die auf XDS-Metadaten gemappt werden müssen, sollen mit "↔ Hinweis zum XDS-Mapping" gekennzeichnet sein.** '''Beispiel:''' '''↔ Hinweis zum XDS-Mapping:''' Das "templateId"-Element mit einer Extension beginnend mit "XDSdocumentEntry.formatCode^" wird ins XDS-Attribut "Changing the status of a templateformatCode"]gemappt (ohne Präfix XDSdocumentEntry.formatCode^)* Es ist beim Neu-Erstellen wie auch beim Bearbeiten eines Templates zu überprüfen, ob die Datentypen nach R-MIM richtig eingehalten werden.* Wen man bei Elementen mit Datentypen Unterelemente vorgibt, muss man dabei alle anderen Unterelemente auch vorgeben. Es werden die möglichen Unterelemente des Datentyps sonst nicht erlaubt.* Bei einigen Datentypen muss man neben der Art-Decor Dokumentation, zusätzlich das ELGA-Schema beachten, damit die ELGA-Anpassungen mitbeachtet werden.* Es sollen in Art-Decor immer nur CD, CE und CV verwendet werden, nicht die IPS oder SDTC Varianten. Das Kapitel [[#Repositories]] enthält ELGA-Schema bietet diese Erweiterungen bereits innerhalb CD, CE und CV an.* Jedes Template sollte ein Beispielsnippet enthalten, in dem die Beschreibung korrekte Anwendung des Templates angegeben wird. In der Regel werden Beispielsnippets nur zum Template selbst erstellt, nicht zu den darin verlinkten Templates (z.B. included Entries).** Idealerweise werden Beispielsnippets als letztes ergänzt, um den Aufwand an Änderungen im Template gering zu halten.* Der '''Name''' eines Templates (nicht der Display-Name!) kann nach dem Erstellen des detaillierten Prozesses Templates nur mittels '''Temple''' geändert werden! Die Änderung des Namens hat keinen Einfluss auf die Referenzierung durch andere Templates -> hier gilt die '''OID'''. Der Display-Name kann jederzeit über GUI oder Temple geändert werden.* Wird die OID geändert, wenn das Template bereits durch andere Templates refereziert wird, werden alle bestehenden Referenzen darauf '''ungültig'''! Daher vor der Änderung der OID die Liste aller referenzierenden Templates abspeichern und diese hinsichtlich der Verantwortlichkeiten.neuen OID anpassen!

Im Allgemeinen Implementierungsleitfaden wird unter der Legende der Konformitätskriterien beschrieben, welche Kardinalitäten und Konformitäten in den ELGA Leitfäden vorkommen können. Die folgende Tabelle stellt dar, wie diese Kriterien in Art-Decor umzusetzen sind (siehe auch [https://art-decor.org/mediawiki/index.php?title=DECOR-rules#Mandatory_.2F_Conformance Mandatory/Conformance]).{{ HL7img | Governance state machineclass="wikitable"! colspan="3" |Für Elemente|-!Vorgaben Allgemeiner Leitfaden! colspan="1" |Verwendung von nullFlavor!Umsetzung Art-Decor am Beispiel eines <code>id-</code>Elements mit dem Datentypen <code>II</code> (in Temple)|-|1..1 M| colspan="1" |nicht erlaubt|<code><element name="hl7:id" datatype="II" minimumMultiplicity="1" maximumMultiplicity="1" conformance="R" isMandatory="true"></code>|-| colspan="1" |1..* M| colspan="1" |nicht erlaubt| colspan="1" |<code><element name="hl7:id" datatype="II" minimumMultiplicity="1" maximumMultiplicity="*" conformance="R" isMandatory="true"></code>|-| colspan="1" |0.png .0 NP| colspan="1" |nicht erlaubt|centercolspan="1" | Zustandsautomat }}<code><element name="hl7:id" datatype="II" conformance="NP"></code> '''Achtung,''' bei templateIds sollte zusätzlich ein Prädikat angegeben werden, damit auch das Schematron richtig erstellt wird:

<ref groupcode><element name="hl7:templateId[@root='1.3.6.1.4.1.19376.1.3.3.2.1']" datatype="AbbildungII" conformance="NP">Default state diagram for Art-Decor artefacts</refcode> ''Default state diagram for Art-Decor artefacts''

'''TODO: Beschreibung, wann von draft in active wechseln<code>  <attribute name="root" value="1.3.6.1.4.1.19376.1. 3.3.2.1" datatype="uid" /><br/code>'''TODO: Example for CH anpassen, nicht verwendete Zustände aus Tabelle entfernen'''

<brcode></element></code>|-| colspan="1" |1..1 R| colspan="1" |erlaubt| colspan="1" |<ref groupcode><element name="Tabellehl7:id" datatype="II" minimumMultiplicity="1" maximumMultiplicity="1" conformance="R"></code>Art|-Decor state machine|1..* R|erlaubt|<code><element name="hl7:id" datatype="II" minimumMultiplicity="1" maximumMultiplicity="*" conformance="R"></refcode> ''Art|-Decor state machine''{| classcolspan="hl7table1"|0..1 R! width| colspan="80px1" | Status !! Action !! Trigger nicht erlaubt| colspan="1" |<code><element name="hl7:id[not(@nullFlavor)]" datatype="II" minimumMultiplicity="0" maximumMultiplicity="1" conformance="R"></ Description !! Example for CDA-CH !! Responsibilitycode>

| [[File:Kyellowcolspan="1" |0..png* R|16px]] draftcolspan="1" |nicht erlaubt| activatecolspan="1" | Artefact is finished and it is considered as final <code><element name="hl7:id[not(no review needed@nullFlavor).| ''n]" datatype="II" minimumMultiplicity="0" maximumMultiplicity="*" conformance="R"></a for CDA-CH as review necessary.''| Developercode>

| colspan="1" |0..1 O| considercolspan="1" | If an artefact is considered to be moved into a repository, this action is applied and the artefact has to be reviewed by the owner/team of the repository.erlaubt| ''final draft for a CDA-CH V2 template ready to review.''colspan="1" | Developer (info to the Reviewer) <code><element name="hl7:id" datatype="II" minimumMultiplicity="0" maximumMultiplicity="1"></code>

| colspan="1" |0..* O| cancelcolspan="1" | If an artefact is not further developed, it is cancelled.erlaubt| ''any developed draft template not to be used anymore.''colspan="1" | Developer<code><element name="hl7:id" datatype="II" minimumMultiplicity="0" maximumMultiplicity="*"></code>

| [[File:Korangecolspan="1" |0..png|16px]] pending1 C| activatecolspan="1" | Upon decision of the review team.Abhängig vom Kontext| ''CDA-CH V2 template has been reviewed within HL7 Switzerland and was considered to be ready for release.''colspan="1" | Review team of the repository. <code><element name="hl7:id" datatype="II" minimumMultiplicity="0" maximumMultiplicity="1" conformace="C"></code>

| colspan="1" |0..* C| colspan="1" |Abhängig vom Kontext| rejectcolspan="1" |<code><element name="hl7:id" datatype="II" minimumMultiplicity="0" maximumMultiplicity="*" conformace="C"></code>| If the artefact is considered as not appropriate for the repository, it's rejected.}{| ''HL7 Switzerland does not consider the template.''class="wikitable"! colspan="2" | Review team of the repository.Für Attribute

| [[File:Kpurple.png|16px]] rejected!Vorgaben Allgemeiner Leitfaden| | Decision necessary for what next status applies, it is recommended to set the status to draft and re!Umsetzung Art-evaluate it for a repository or set is as active only within the project.| ''As appropriate, propose to set it to draft again or move it to another BBR.''| DeveloperDecor

| [[File:Kgreen0.png|16px]] active| review| Maintenance or update of a project/repository.| ''Review CDA-CH template to consider it for CDA-CH v2.''0 NP| Repository <attribute name="root" datatype="uid" prohibited="true"/ Project owner>

| colspan="1" |1..1 R| retirecolspan="1" |<attribute name="root" datatype="uid"/>| In case of a new version, the old version is retired in order to have only one valid version of an artefact.-| ''A CDA-CH template is not used anymore or replaced by another onecolspan="1" |0..''1 O| Repository colspan="1" |<attribute name="root" datatype="uid" isOptional="true"/ Project owner>

| [[File:Korangecolspan="1" |1..png|16px]] pre-publication review 1 F| reactivatecolspan="1" | If updated and considered as final by the responsible person, the artefact is re-activated<attribute name="root" datatype="uid" value="1.3.6.1.4.1.19376.1.3.| ''template is reviewed within HL7 Switzerland and considered to be ready for release2.''| Repository 1"/ Project owner>

| colspan="1" | retire0..1 F| colspan="1" | ''A CDA-CH template is not used anymore or replaced by another one<attribute name="root" datatype="uid" value="1.3.6.1.''| 4.1.19376.1.3.2.1" isOptional="true"/>

=Value Sets = Eine Anleitung zur Verwendung des Value Set Editors ist unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Value_Set_Editor ART Value Set Editor] zu finden.  {{BeginYellowBox}}Seit 2022 steht unter '''https://termgit.elga.gv.at/ ein neuer Terminologieserver''' zur Verfügung. Die Dokumentation findet sich auf https://termgit.elga.gv.at/documentation_and_support_de.html und https://termgit.elga.gv.at/faq_de.html{{EndYellowBox}} ==Name =='''Name''' und '''Display-Name''' (bzw. '''Title''' auf Termgit) eines Value Sets müssen wie folgt angegeben werden:  *'''Name''': '''[Präfix]-[ValueSetName]''' (lowercase-Schreibweise)*'''Display-Name'''/'''Title''': '''[Präfix]_[ValueSetName]''' (UpperCamelCase-Schreibweise) Sonderzeichen sind nicht erlaubt.Als Präfix dient das Projektkürzel (Name des Repositories), z.B. "eimpf". Beispiele:* Name: eimpf-antikoerperbestimmung* Title: eImpf_Antikoerperbestimmung * Name: elga-administrativegender* Title: ELGA_AdministrativeGender = Templates =OID ==Elemente 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 Attribute, benötigt daher '''keine Registrierung''' über das '''OID-Portal'''. Die nächste '''freie OID''' für '''Value Sets''' muss über die im Template verwendet [https://art-decor.org/decor/services/GovernanceGroupList?gg=1.2.40.0.34.3.1.2&language=en-US&format=html#tabs1-valuesets1 '''ELGA Art-Decor Governance Group Value Sets'''] (Vorsicht!: lange Ladezeit) ermittelt werden, sind zu dokumentieren. Die Beziehung zu anderen Templates ist anzugeben, um festzuhalten{{EndYellowBox}} == Version & Metadaten ==Versionierung: Siehe [https://confluence.elga.gv.at/display/SCCTERM/Versionierung Versionierung]. == Inhalt ==Best Practices für die Erstellung und Pflege von Value Sets müssen angewendet werden, wie sie sich zueinander verhalten (z.B. Spezialisierungkönnen Konzeptcodes hinzugefügt, aber nicht gelöscht werden, Anpassung uswnur 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}}<br><br>TODO: <br>= Beispielbefunde =* Open vsNeben den Beispielsnippets in den Templates sind Beispielbefunde und Falsch-Beispielbefunde zu erstellen. Closed Ein Grundgerüst für ein Beispieldokumentekann erstellt werden, indem man im entsprechenden DLT den Zauberstab des Template Editors anwendet und rekursiv alle Code-Snippets der darin verlinkten Templateseinfügt. Name

=== StandardDer Name von (Falsch-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)Beispielbefunden sollte folgendermaßen aufgebaut sein. Dies liegt in der Verantwortung des EntwicklersDie einzelnen Elemente werden mit "_" verbunden.

Die erste Template-ID soll wie folgt bezeichnet werden'''"falsch_": "HL7 Austria ''' Angabe, dass es sich um einen Falsch- [Name des Templates]"Beispielbefund handelt.

== Datasets ==Die Verwendung von Art-Decor-Datensätzen wird für neue Projekte empfohlen. Diese bilden die funktionalen Anforderungen an '''[Präfix]:''' Als Präfix dient das Projekt ab und sind Diskussionsgrundlage bei Fachexpertengesprächen Projektkürzel (erfordern kein technisches HintergrundwissenName des Repositories), z. <br>Folgende Inhalte eines Dataset-Elements sind mindestens anzugeben:* Name* Beschreibung* Datentyp<br>wenn vorhanden:* Auswahllisten* Link zu kodierten Konzepten / Value Sets (Terminologien)B. "eimpf"

== Szenarios ==Das Erstellen von '''Transaktionen''' im Rahmen von Szenarios ist für die Generierung von Schematron[optional DLT-Regeln '''zwingend erforderlich'''.<br>Die Transaktion soll dem Schema Name]:'''[Projektkürzel]_[Name des Szenarios]''' folgen.<br>Die Angabe von Kardinalität (optionalDLTs, wiederholbar) und Konformität (erforderlich, obligatorisch) für die einzelnen Elemente des Datasets '''wird empfohlen'''wenn es in dem Projekt mehrere DLTs gibt.

== Dataset-Mapping ==Die Zuordnung von Datensatz-Elementen und erstellten Templates wird '''empfohlen[Kurztitel des Beispiels]:''' (Informationen zum [https://wikiErklärt ganz kurz, worum es in dem Beispielbefund geht.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 [httpsBeispiele://wiki.hl7.at/index.php?title=Hilfe:Leitfaden_erstellen "Leitfaden erstellen"] nachzulesen.

===Namespace===Der Verwendung von Namespaces ist wesentlich für Versionierung der Wiki* at-Seiten mit Flagged Revisionslab_Laborbefund_Kompletter_Befund. xml{{BeginYellowBox}}''Wichtiger Hinweis:'''''Alle Seiten''' von CDA* falsch_at-Leitfäden im Namespace '''[[https://wiki.hl7.at/index.php?title=Hilfe:Leitfaden_erstellen#Verwendung_von_Namespaces "ILF"]]''' erstellt werdenlab_Laborbefund_Constraint_gebrochen.{{EndYellowBox}}xml

Aufgrund bisherige Erfahrungen * '''Beispielbefunde'''** sind vollständig valide und bilden verschiedene reale Szenarien ab.* Für '''Falsch-Beispielbefunde''' sollte mindestens jeweils ein Befund vorhanden sein für ** das Brechen eines Contraints,** das Verwenden eines falschen Wertes wo ein Value Set Wert erwartet wird empfohlen, nur jene Textabschnitte in Teildokumente auszulagern, die aufgrund deren allgemeinen Inhalten auch zur Transklusion in andere Leitfäden verwendet werden können. Dies hat den Vorteil, ** das mit den Onboard-Mitteln des Wikis verschiedene SeitenVerwenden eines nicht CDA-Versionen Elementes (über den Reiter "Versionsgeschichte"nicht im Schema vorhanden) leichter verglichen werden können,** das Verwenden eines verbotenen Elementes** das Weglassen eines Pflichtfeldes.

===Typische Gliederung eines Dokuments==Szenarios / Schematron =Um eine konsistente Vorgehensweise bei der Erstellung und Darstellung eines Implementierungsleitfadens zu gewährleisten, wird folgende (minimale) Struktur vorgegeben: Das Erstellen von '''einer Transaktion pro DLT''' in den Szenarien ist für die Generierung von Schematron-Regeln '''TODO REVIEWzwingend erforderlich''', siehe [https://confluence.elga.gv.at/display/SCC/Schematron-Erstellung+und+Bereitstellung Schematron-Erstellung und Bereitstellung].

:1 Zusammenfassung:2 Informationen über dieses Dokument::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::2.7 Verwendete Grundlagen und Bezug zu anderen Standards::2.8 Weitere unterstützende Materialien:3 Einleitung::3.1 Ausgangslage und Motivation::3.2 Zweck des Dokuments::3.3 Zielgruppe:4 Harmonisierung::4.1 Autoren und Mitwirkende:5 Begriffsdefinitionen:6 Technischer Hintergrund::6.1 Allgemeine Richtlinien ::6.2 Datentypen:7 Funktionale Anforderungen::7.1 Darstellung::7.2 Verwendung in der ELGA Infrastruktur:::7.2.1 Für Szenarios gibt es '''keine speziellen Vorgaben zu Dokument-Metadaten (XDS-Metadaten)::7.3 Versionierung ''' hinsichtlich '''OID oder Version & Stornierung von Dokumenten::7.4 Mehrsprachigkeit und grenzüberschreitender Austausch:8 User Storys ("Anwendungsfälle"):9 Dataset:10 Technische Spezifikation::10.1 Übersicht CDA Strukturen (Header & Body) ::10.2 CDA Templates:::10.2.1 Document Level Templates:::10.2.2 Header Level Templates:::10.2.3 Section Level Templates:::10.2.4 Entry Level Templates:::10.2.5 Weitere CDA Fragmente::10.3 Terminologien:11 Anhang::11.1 Abbildungsverzeichnis::11.2 Abkürzungsverzeichnis::11Metdaten'''.3 Literaturverzeichnis

== Revision ==TODO:* Versionierung: Eine Anleitung zur Verwendung des Szenario Editors ist unter [https://wikiwww.hl7art-decor.atorg/mediawiki/index.php?title=Hilfe:Leitfaden_erstellen#Versionierung* PDF-Generierung: https://wiki.hl7.at/indexART_Scenario_Editor ART Scenario Editor] zu finden.php?title=Hilfe:Leitfaden_erstellen#PDF_Generierung

= Releases === Art-Decor Name ==TODODer Name/Label der Transaktionen soll dem Schema '''[NameDesSzenarios]''' folgen. Alles zusammengeschrieben, kein Prefix.

== Wiki ====Check before finalizing==Thew folowing checks help to identify possible errors or missing includes from Der im Label der Transaktion angegebene Name wird von Art-Decorspäter automatisch als Name für das entsprechende Schematron verwendet, z. *Perform search for: ** "/dynamic" ** "/static"** "Cannot find"** .B.„eimpf-UpdateImmunisierungsstatus“, wobei das Präfix des Projektes mit dem folgenden Bindestrich automatisch ergänzt wird.

'''Afterwards:''' == Inhalt ==Create a revision according to [[#Revisions | Wiki revisions]]Optional ist es für jede Transaktion möglich das Dataset ("Konzepte") anzugeben und für jedes Element Kardinalität (optional, wiederholbar) und Konformität (erforderlich, obligatorisch) festzulegen. Die Angabe von Kardinalität und Konformität ist für die Erstellung eines Schematrons nicht zwingend erforderlich.

= Verantwortliche Personen Qualitätssicherung === Support for Art-Decor ==TODO

== Governance Groups Art-Decor ==TODOOffizielle Informationen zur Qualitätssicherung eines Projekts in Art-Decor finden sich auf der Seite [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor#Preflighting_publication_and_quality_checks Preflighting publication and quality checks].

= Qualitätssicherung * Anpassung Titelblatt** Publikationsdatum** Versionsinformationen mit DLT abgleichen* Infobox: „In Arbeit“ entfernen* Prüfen, ob alle Templates eingefügt und Review =Value Sets verlinkt wurden== Art* Linkverzeichnisse, Referenzen prüfen* ggf. Informationen bezüglich <code>hl7at:formatCode</code> auf der Wiki-Decor Repository ==Seite aktualisieren* Diskussionsseite aktualisieren** Diskussionsseiten sollen wie folgendes Beispiel aufgebaut sein ([[ILF_Diskussion:Telemonitoring-Episodenbericht_(Version_1)|Diskussionseite Telemonitoring-Episodenbericht]])** prüfen, ob Elemente aus dem "Ausblick" in der aktuellen Version umgesetzt wurden. Falls ja, sind diese in die Tabelle des "Release-Log" zu verschieben.* Revisionsliste des Leitfadens auf Basis der Diskussionsseite aktualisieren* Links prüfen und optimieren: Nur externe Links sollen in neuem Tab geöffnet werden, Sprungmarken sollten immer mit # gekennzeichnet sein.* PDF: Druck checken (leere Seiten, Suche nach: „Error“, „Fehler“, "TODO")* Wiki-Seite Status ändern auf "abgenommen"* falls neue Hauptversion dann OID im OID Portal eintragen lassen* Wiki-Guide aktualisieren (neue Zeile für neue Version, PDF upload)* Seiten-Status ändern auf "abgenommen"

== ELGA Implementierungsleitfäden GitLab ==TODO: Prozess # muss eingehalten Eine erweiterte Qualitätssicherung wird auch in GitLab erstellt. Hier werdenbeim Einstellen von (Falsch-)Beispielbefunden oder Schematron-Regeln in die jeweiligen Projekte automatisch Prüfroutinen (Schematron-Validierung) gestartet.

= Anhang===Links==* [http://art-decor.org/art-decor/home Art-Decor Workspace]* [https://www.art-decor.org/mediawiki/index.php?title=Documentation Art-Decor Dokumentation]Beispielbefunde aktualisieren* [https://wiki.hl7.at/index.php?title=Willkommen_auf_dem_WikiFalsch-Portal_von_HL7_Austria eHealth Wiki]Beispielbefunde aktualisieren* [https://wiki.hl7.at/index.php?title=Hilfe:Wiki Wiki Hilfe]Schematron aktualisieren

=Anhang =Abbildungsverzeichnis==<references group="Abbildung"/>

==TabellenverzeichnisLinks ==<references group="Tabelle"/>

* [http://art-decor.org/art-decor/home Art-Decor Workspace]* [https://www.art-decor.org/mediawiki/index.php?title=Documentation Art-Decor Dokumentation]* Wiki-Portal von HL7 Austria: [https://wiki.hl7.at/index.php?title=Zur Diskussion stehende Änderungsvorschläge=Willkommen_auf_dem_Wiki-Portal_von_HL7_Austria eHealth Wiki] & [https://wiki.hl7.at/index.php?title=TODOHilfe:Wiki Wiki Hilfe]