585
Bearbeitungen
Änderungen
→Art-Decor Projekt
{{#customtitle:Governance für die CDA-Leitfadenerstellung(Version 1)}}
{{#css:
.toc{
}
}}
<pre class="ilfbox_code">
Governance für die CDA-Leitfadenerstellung mit Art-Decor und Mediawiki
Version: 1.1.1+20230503
Status: Final
</pre>
<!--
{{Infobox Dokument
|Type = Governance
|Version = 1
|Date = 143.125.20212023
|Copyright = 2021 - 2025
|Status = Final
|Realm = Österreich
|Submitted = 143.125.20212023}}
{{Versionbox Begin}}
{{VersionboxEntry | Version = 0.2 | Date = 07.11.2019| Status = Draft| History=Überarbeitung und Einarbeitung der Erkenntnisse nach Erstellung des CDA-Leitfadens e-Impfpass}}
{{VersionboxEntry | Version = 1 | Date = 14.12.2021| Status = Final| History=Überarbeitung}}
{{VersionboxEntry | Version = 1.1.1 | Date = 3.5.2023| Status = Final| History=Überarbeitung Kapitel Value Sets}}
{{Versionbox End}}
-->
=Governance für die CDA-Leitfadenerstellung=
Die folgenden Vorgaben sind verpflichtend einzuhalten. Empfehlungen werden entsprechend markiert. Die Reihenfolge der Kapitel soll eine übliche Vorgehensweise darstellen, jedoch ist die Reihenfolge selbst nicht verpflichtend einzuhalten.
==Governance Groups==
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.
==Implementierungsleitfaden (inkl. Wiki)==
'''eHealth Implementierungsleitfäden''' können auch in englischer Sprache verfasst werden.
Wichtige Informationen hinsichtlich der '''technischen''' Erstellung eines CDA-Leitfadens mit Mediawiki sind unter [https://wiki.hl7.at/index.php?title=Hilfe:Wiki HilfeLeitfaden erstellen mit Mediawiki] nachzulesen.
Die Einbindung eines neuen Leitfadens folgt einem vorgegebenen Prozess, dieser ist ersichtlich unter Benutzung von [https://wiki.hl7.at/index.php?title=Hilfe:Flagged_Revisions#Benutzung_von_Flagged_Revisions Flagged Revisions].
===Name===Der '''Name ''' eines Leitfadens wird wie folgt angegeben:
* HL7 Austria & ELGA* HL7 CDA® R2 Implementierungsleitfaden* '''[Titel]'''* OID: '''[OID]'''
''Beispiel:''
HL7 Austria & ELGA
HL7 CDA® R2 Implementierungsleitfaden
Labor- und Mikrobiologiebefund
OID: 1.2.40.0.34.7.4.9.3
''Beispiel:''
*1.2.40.0.34.7.'''18''': Dokumentenklassen-OID des Implementierungsleitfadens "Meldung von antimikrobieller Resistenzen"
**OID wird im OID-Portal beantragt (Root-Knoten aller Versionen des entsprechenden Leitfadens)
*1.2.40.0.34.7.'''18.1''': Implementierungsleitfaden Meldung von antimikrobieller Resistenzen, Version 1**OID des PDF-Leitfaden Leitfadens (Titelblatt)
**wird im DLT als templateId[2] als informative Referenz angegeben
**Hauptversionen verlangen eine neue Verordnung durch das BM*G
===Version & Metadaten===
Der Verwendung von Namespaces ist wesentlich für Versionierung der Wiki-Seiten mit Flagged Revisions.
{{BeginYellowBox}}''Wichtiger Hinweis:'' Alle Seiten von CDA-Leitfäden müssen im Namespace ["ILF"] erstellt werden.{{EndYellowBox}}
Das Wiki-Leitfadenprojekt DARF NICHT unabhängig vom ART-DECOR-DLT versioniert werden, siehe [https://confluence.elga.gv.at/display/SCCTERM/Versionierung Versionierung].
Alle '''Hauptversionen und Nebenversionen''' eines Leitfadens sind als '''Wiki''' verfügbar. In der "Lese-Ansicht ist die publizierte Version ersichtlich, aktuelle (noch nicht freigegebene) Überarbeitungen/Änderungen sind der "Revisions-Ansicht" zu entnehmen. Zum Zeitpunkt der Publikation (z.B. Ballotversion / Publikation neue Haupt- oder Nebenversion) wird die Hauptseite des Leitfadens von einer berechtigten Person als "abgenommen" markiert (siehe dazu [https://wiki.hl7.at/index.php?title=Hilfe:Leitfaden_erstellenWiki#Versionierung_von_Wiki-Seiten Hilfe:Leitfaden erstellenVersionierung von Wiki-Seiten]), sodass die "Revisions"-Ansicht in die stabile "Leseansicht" übernommen wird. Die "Leseansicht" bleibt unverändert, bis eine neue Version des Leitfadens abgenommen wird.
Alle veröffentlichten Leitfadenversionen sind zusätzlich zum Wiki als PDF verfügbar (Anleitung siehe [https://wiki.hl7.at/index.php?title=Hilfe:Leitfaden_erstellen#PDF_Generierung PDF-Generierung]). Eine Übersicht der Versionen eines Leitfadens findet sich im jeweiligen Guide (alle vorhandenen Guides sind zu finden unter [https://wiki.hl7.at/index.php?title=Implementierungsleitf%C3%A4den Übersicht der CDA Implementierungsleitfäden].
===Inhalt===
Der Inhalt eines Implementierungsleitfadens besteht üblicherweise aus den Kapiteln: :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.
we would like to ask you to create a new project in Art-Decor:
*Name: <'''displayName des Projekts'''>
*Prefix: <'''Projektkürzel''' - sollte keine Bindestriche enthaltensoll immer mit at- beginnen, z.B. elgatest"at-emed-" oder "at-lab-" (Vorweg: an bestimmten Stellen werden Bindestriche durch das System ausgeblendet)>
*ContainsReusableContent=false
*Experimental/Test=false
==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 nächste ID im 1.2.40.0.34.777 Knoten.
==Version & Metadaten==
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.
|-
|[[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.
|}
{| class="wikitable"|-|[[Datei:TemplateStatuswechsel2021-9-22.png|top]]||'''Beschreibung Statuswechsel eines Templates (Diagramm)'''#'''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'''".#'''2.''' Nach erstmaliger Erstellung eines Templates oder nach Durchführung von Major- oder Minor-Ä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.) '''3.''' Wurde ein Ballotverfahren durchgeführt, erfolgt der Template-Statuswechsel zu "'''Aktiv'''" zum Publikationszeitpunkt des Leitfadens. 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, dass eine neue Version vorbereitet wird. Vom Status "Revision nach Publikation" kann man wieder in den "Aktiv" Status wechseln.) '''4.''' Solange keine Änderungen an dem Template durchgeführt werden müssen, werden verbleibt es im Status "Aktiv". '''5.''' Ist das Template veraltet oder wird es durch ein neues ersetzt, muss der Status auf "'''veraltet'''" gesetzt werden ('''6.'''). Dieser Status ist unveränderbar (Status endgültig). Veraltete Templates, scheinen weiterhin in referenzierenden Templates auf. '''7.''' Sind Änderungen eines aktiven Templates erforderlich, muss unterschieden werden, ob es sich um Minor/Major-Änderungen oder um einen Patch handelt. '''8.''' Handelt es sich um einen Patch oder wurden die Änderungen von den referenzierenden Leitfäden akzeptiert, kann mit "'''neue Version erzeugen'''" eine neue Templateversion von Art-Decor erstellt werden. Diese hat den Status "Entwurf", die '''gleiche Template-OID''', aber ein neues Erstellungsdatum. Die Versionsnummer im Version-Label des Templates muss an der entsprechenden Stelle um 1 erhöht werden (siehe [https://confluence.elga.gv.at/display/SCCTERM/Versionierung Versionierung]). '''9.''' 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. Es erhält eine '''neue Template-OID''', Version 1.0.0, siehe [https://confluence.elga.gv.at/display/SCCTERM/Versionierung Versionierung]). Die neue Bearbeitung kann ein Zwischenschritt sein, um kurzzeitig eine Major-Ä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 erfordern (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 '''nicht auf "annulliert"''' oder '''"zurückgewiesen"''' gesetzt werden, sondern stattdessen soll der Inhalt gelöscht, der Titel auf „dummy“ (o.ä) umbenannt und die Template-Id auf .999 geändert werden. 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 es scheint auch nicht mehr in den Beziehungen der referenzierenden Templates auf.''|} = Datasets =Die Verwendung von Art-Decor-Datasets 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). Für Datasets gibt es '''keine speziellen Vorgaben''' hinsichtlich '''OID und Version & Metadaten'''. Bereits bei der Modellierung der Datasets 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.art-decor.org/mediawiki/index.php?title=DECOR-dataset#Dataset_versioning Dataset versioning]). Dies funktioniert durch die Eingabe eines Names und dem mit etwas Ladezeit folgendem Vorschlag von ähnlichen Konzepten. 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. == Name ==Es gibt keine speziellen Namenskonoventionen, der '''Name''' ist jedoch '''anzugeben'''! == Inhalt ==Es ist eine '''Beschreibung''' und der '''Werttyp/Valuetype''' anzugeben. '''Wenn vorhanden''' muss zusätzlich angegeben werden: * '''Auswahllisten'''* 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.org/mediawiki/index.php?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-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. Für die Verwendung ist folgende Seite [https://www.art-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.'' ==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 '''Referenzierung''' (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.
Um herauszufinden, welche Art-Decor Projekte (Der Status "Revision vor Publikation" kann verwendet werden, um anzuzeigenauch außerhalb der eigenen Governance-Group) bereits ein bestimmtes Template umgesetzt haben, dass eine Publikation bevorsteht. Vom Status "Revision vor Publikation" kann man im Menüpunkt '''„Auge“''' (links oben in der ArtDecor-Projektseite), die Template-ID oder den Stauts "Aktiv" gewechselt Namen eines Templates angeben -> alle Templates mit zugehörigem Projekt werdenaufgelistet.)
|}
{| class="wikitable"! colspan="2" |Für Attribute|-!Vorgaben Allgemeiner Leitfaden!Umsetzung Art-Decor|-|0..0 NP|<attribute name="root" datatype="uid" prohibited="true"/>|-| colspan="1" |1..1 R| colspan="1" |<attribute name="root" datatype="uid"/>|-| colspan="1" |0..1 O| colspan="1" |<attribute name="root" datatype="uid" isOptional="true"/>|-| colspan="1" |1..1 F| colspan="1" |<attribute name="root" datatype="uid" value="1.3.6.1.4.1.19376.1.3.2.1"/>|-| colspan="1" |0..1 F| colspan="1" |<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 == OID ==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/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.{{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, 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.{{EndValueSetBoxEndYellowBox}} = Beispielbefunde =Neben den Beispielsnippets in den Templates sind Beispielbefunde und Falsch-Beispielbefunde zu erstellen. 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 Templates einfügt. Name Der Name von (Falsch-)Beispielbefunden sollte folgendermaßen aufgebaut sein. Die einzelnen Elemente werden mit "_" verbunden. '''"falsch_":''' Angabe, dass es sich um einen Falsch-Beispielbefund handelt. '''[Präfix]:''' Als Präfix dient das Projektkürzel (Name des Repositories), z.B. "eimpf" '''[optional DLT-Name]:''' Name des DLTs, wenn es in dem Projekt mehrere DLTs gibt. '''[Kurztitel des Beispiels]:''' Erklärt ganz kurz, worum es in dem Beispielbefund geht. Beispiele: * at-lab_Laborbefund_Kompletter_Befund.xml* falsch_at-lab_Laborbefund_Constraint_gebrochen.xml Inhalt * '''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,** das Verwenden eines nicht CDA-Elementes (nicht im Schema vorhanden),** das Verwenden eines verbotenen Elementes** das Weglassen eines Pflichtfeldes. = Szenarios / Schematron =Das Erstellen von '''einer Transaktion pro DLT''' in den Szenarien ist für die Generierung von Schematron-Regeln '''zwingend erforderlich''', siehe [https://confluence.elga.gv.at/display/SCC/Schematron-Erstellung+und+Bereitstellung Schematron-Erstellung und Bereitstellung]. Für Szenarios gibt es '''keine speziellen Vorgaben''' hinsichtlich '''OID oder Version & Metdaten'''. Eine Anleitung zur Verwendung des Szenario Editors ist unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Scenario_Editor ART Scenario Editor] zu finden. == Name ==Der Name/Label der Transaktionen soll dem Schema '''[NameDesSzenarios]''' folgen. Alles zusammengeschrieben, kein Prefix. Der im Label der Transaktion angegebene Name wird von Art-Decor später automatisch als Name für das entsprechende Schematron verwendet, z.B. „eimpf-UpdateImmunisierungsstatus“, wobei das Präfix des Projektes mit dem folgenden Bindestrich automatisch ergänzt wird. == Inhalt ==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. = Qualitätssicherung = == Art-Decor ==Offizielle 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]. * Template-Checks:** korrektes Präfix, Name, Displayname** open/closed** korrektes Value Set** Beispielsnippets** Templatebeschreibung** Standardreferenzen** Dataset Mapping (optional)** im Beispieldokument enthalten ** Schematron Asserts ergänzen* DLT bei '''jeder Version MUSS''' in <code>hl7at:formatCode</code> die Versionierungsinfo + Publikationsdatum im Label angepasst werden.** Entsprechende Adaptierung von CodeSystem '''ELGA_FormatCode''' und ValueSet '''ELGA_FormatCode'''* Temlatestatus:** für Ballot: Templates bleiben im Entwurf-Status** nach Ballotabschluss: Versionlabel mit Publikationsdatum ergänzen und Templates aktiv setzen* Zur Prüfung des Projektschemas unter dem Menü "Project" → "Development" → "Check DECOR" ein Dataset auswählen und die Prüfung durchführen. Eventuelle Fehler, Warnungen oder Hinweise werden anschließend in einer Liste dargestellt.* Nach der Erstellung eines Schematrons unter "Project" → "Development" → "Compile a development version" (für Details siehe [https://confluence.elga.gv.at/display/SCC/Schematron-Erstellung+und+Bereitstellung Schematron-Erstellung und Bereitstellung]) ist es möglich, über "Validate XML instance" Beispielbefunde für die verschiedenen Szenarios zu validieren.* AD-Bot starten (lassen) (am Vortag der Publikation) == Wiki ==Im Wiki werden die Metadaten vor dem setzen des Seiten-Status auf Abnahme nochmals überprüft. * Anpassung Titelblatt** Publikationsdatum** Versionsinformationen mit DLT abgleichen* Infobox: „In Arbeit“ entfernen* Prüfen, ob alle Templates eingefügt und Value Sets verlinkt wurden* Linkverzeichnisse, Referenzen prüfen* ggf. Informationen bezüglich <code>hl7at:formatCode</code> auf der Wiki-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" == GitLab ==Eine erweiterte Qualitätssicherung wird auch in GitLab erstellt. Hier werden beim Einstellen von (Falsch-)Beispielbefunden oder Schematron-Regeln in die jeweiligen Projekte automatisch Prüfroutinen (Schematron-Validierung) gestartet. * Beispielbefunde aktualisieren* Falsch-Beispielbefunde aktualisieren* Schematron aktualisieren = 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]* Wiki-Portal von HL7 Austria: [https://wiki.hl7.at/index.php?title=Willkommen_auf_dem_Wiki-Portal_von_HL7_Austria eHealth Wiki] & [https://wiki.hl7.at/index.php?title=Hilfe:Wiki Wiki Hilfe] <span title="Filterspalte" class="tf-inline-filter"></span>