Änderungen

Wechseln zu: Navigation, Suche

ART-DECOR Governance

3.954 Bytes hinzugefügt, 30 Januar
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
|OID = TODO
|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]'''
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.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
::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
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. Falls dann nur noch der Name des Datasets nicht passt, kann dieser als Doppelt-Name angepasst werden, was dann höchstwahrscheinlich auch dem dazugehörigen Template angepasst werden muss.
Weitere offizielle Informationen sind unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Dataset_Editor ART Dataset Editor] zu finden.
= 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 (auch außerhalb der eigenen Governance-Group) bereits ein bestimmtes Template umgesetzt haben, kann man im Menüpunkt '''„Auge“''' (links oben in der ArtDecor-Projektseite), die Template-ID oder den Namen eines Templates angeben -> alle Templates mit zugehörigem Projekt werden aufgelistet.
 
==Vorbedingungen für Änderungen bestehender Templates==
Bevor ein bestehendes Template geändert wird (Erstellung 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. ob diese gewünscht ist. In allen betroffenen Leitfäden muss die Änderung auf der Diskussionsseite im Abschnitt "Ausblick" festgehalten werden.
 
''Zu Beachten:''
*Wenn eine neue Version eines aus dem ATCDABBR referenzierten Templates (graues Icon im Template-Baum) benötigt wird, MUSS diese im ATCDABBR erstellt werden.
*Soll ein Template, das im ATCDABBR erstellt wurde, in ein Projekt-Repository verschoben werden, muss dort zuerst eine evtl. bereits existierende Referenz darauf entfernt werden.
*Fehlen die Berechtigungen für schreibenden Zugriff auf das ATCDABBR, sollen die erforderlichen Anpassungen zuerst im Projekt-Repository durchgeführt werden und können nach abgeschlossenem Ballot von Berechtigten ins ATCDABBR übernommen werden.
== Name ==
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 dies mit einem Bindestrich anzugeben. (Alte Schreibweise mit unkodiert und kodiert ist nicht mehr zu verwenden!)
'''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 (deutsch). ''Beispiel'': Die Sektion '''''"Impfungen - 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). '''''"Impfungen - 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"). 
Weitere Vorgaben für Name und Display-Name (Bezeichnung) eines Templates:
*Der '''Name''' eines Templates wird wie folgt angegeben:
:'''[Präfix]_[Template-Typ]_[ElementName]'''
:Als Trenner fungieren Unterstriche ("_"), wobei folgendes gilt:
:*'''[Präfix]:''' 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!
:*'''[Template-Typ]:''' Der Template-Typ muss einen der folgenden Template-Typen enthalten:
::*"document": für Document-Level-Templates
::*"header": für Header-Level-Templates
::*"section": für Sektionen
::*"entry": für Entries
::*"other" : alle Templates/Fragmente, die nicht in obige Kategorien fallen ("Template type not specified")
::*'''[ElementName]:''' Entspricht dem Display-Name ohne Leerzeichen, Bindestriche und Klammern "( )". Der ElementName wird in Upper-CamelCase-Notation angegeben.
*Der '''Display-Name''' 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 Template-Baum-Struktur angezeigt.
Der '''Name''' eines Templates wird wie folgt angegeben: '''[Präfix]_[Template-Typ]_[ElementName]''' Als Trenner fungieren Unterstriche ("_"), wobei folgendes giltBeispiele: '''[Präfix]:''' Als Präfix dient das Projektkürzel (Name des Repositories) ohne Bindestriche, z.B. "atcdabrr" oder "atlab". Diese Präfixe belieben auch beim Verschieben ins at-cda-bbr bestehen!  '''[Template-Typ]:''' Der Template-Typ muss einen der folgenden Template-Typen enthalten: "document": für Document-Level-Templates "header": für Header-Level-Templates "section": für Sektionen "entry": für Entries "other" : alle Templates/Fragmente, die nicht in obige Kategorien fallen ("Template type not specified") '''[ElementName]:''' Entspricht dem Display-Name ohne Leerzeichen, Bindestriche und Klammern "( )". Der ElementName wird in Upper-CamelCase-Notation angegeben. Der '''Display-Name''' 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 Template-Baum-Struktur angezeigt. Beispiele: 
* '''Document-Level-Template''' im ELGA e-Impfpass Repository:
 ::Name: "eimpf_document_KompletterImmunisierungsstatus" ::Display-Name: "Kompletter Immunisierungsstatus" 
* '''Header-Level-Template''' 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-Name: "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 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"
== 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''' 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 werden:
:'''.0.''' Document-Level Template
:'''.1.''' Header-Level Template
:'''.2.''' Section-Level Template
:'''.3.''' Entry-Level Template
:'''.9.''' other CDA Fragment Template
.0. Document-Level Template .1. Header-Level Template .2. Section-Level Template .3. Entry-Level Template .9. other CDA Fragment Template ''Beispiele:''
* Header-Level-Template: 1.2.40.0.34.6.0.11.1.2 Author (eHealth-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:''''' 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/decor/services/GovernanceGroupList?gg=1.2.40.0.34.3.1.2&language=en-US&format=html#tabs1-templates1 '''ELGA Art-Decor Governance Group Template''' ] (Vorsicht!: lange Ladezeit) ermittelt werden. {{EndYellowBox}}
== Version & Metadaten ==
* Für neu angelegte Templates (''Entwurf''-Status) soll im Version Label die '''Version''' 1.0.0 angegeben werden. Wenn das Template ''aktiv'' 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://confluence.elga.gv.at/display/SCCTERM/Versionierung - Semantic Competence Center - Extranet - ELGA ConfluenceVersionierung].
* Der Zweck des Templates muss aus der '''Beschreibung''' hervorgehen. Im Fall von generischen Templates, die im at-cda-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.
* Modellierung der Templates  "'''offen/geschlossen'''":
* Es ist zumindest ein korrektes '''Beispiel''' anzugeben.
Beim '''Ableiten von Templates''' ist durch einen der folgenden '''Beziehungstypen''' anzugeben, wie sie sich zueinander verhalten (siehe auch [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Creating_a_new_version_of_an_existing_template Creating a new version of an existing template]). Die Template-ID des Basistemplates wird nur zu Zwecken der Nachvollziehbarkeit in den Metadaten angegeben, in der Template-Spezifikation selbst muss sie entfernt werden, weil dies sonst bei der Generierung von "closed" Schematron-Regeln zu Inkonsistenzen und zu falsch-positiven Schematron-Fehlern bei der Validierung führen kann.
* '''Spezialisierung''': bestehende Vorgaben werden weiter '''eingeschränkt''' (z.B. von [O] auf [M] oder von 0..* auf 0..1, ebenfalls [O] auf [NP])
Soll der Inhalt eines Templates trotzdem verwendet werden, lässt sich mittels Browser-Direktlink
<code><nowiki>https://art-decor.org/temple/modulesviews/temple.xqueryhtml?id=</nowiki>[OID des Templates]&[effectiveDate]&[prefix]&[language]&mode=readonly</code> der '''XML-Code jedes Templates''' via [https://www.art-decor.org/mediawiki/index.php?title=Temple '''Temple'''] (im Lesemodus) anzeigen und anschließend kopieren. Der Inhalt kann dann in ein neu erstelltes Template eingefügt werden. Dabei ist zu beachten, dass der '''Zeitpunkt (effectiveDate)''' und die '''OID des neu erstellten Templates nicht verändert''' werden. Alle weiteren Inhalte können entsprechend angepasst werden. Die OID muss in einem späteren Arbeitsschritt über die GUI korrigiert werden. ''Beispiel'':
der '''XML<code><nowiki>https://art-Code jedes Templates''' via '''Temple''' (im Lesemodus) anzeigen und anschließend kopierendecor. Der kopierte Inhalt kann dann in ein neu erstelltes, leeres Template (mittels "+" und "Create from scratch") eingefügt werdenorg/temple/views/temple. Dabei ist zu beachten, dass der '''Zeitpunkt (effectiveDate)''' und die '''OID des neu erstellten Templates nicht verändert''' werden! Alle weiteren Inhalte können entsprechend angepasst werdenhtml?id=</nowiki>2.16.756.5.30.1.1.10. Die OID muss in einem späteren Arbeitsschritt über die GUI korrigiert werden2.63&effectiveDate=2020-06-26T00:00:00&prefix=cdachvacd-&language=de-DE&mode=readonly</code>
== Inhalt ==
* [[Datei:Warning.png|15px]] Wenn möglich, sollen bereits vorhandene Templates verwenden werden.
* Zugrundeliegende Standards dürfen nur eingeschränkt, aber nicht erweitert werden.
** ''Hinweis: Wenn ein Template laut Standard "required" ist, aber für den konkreten Leitfaden nicht benötigt wird, kann das Template mit einem '''nullFlavor''' erstellt werden (z.B. Freitext-Inhalt „keine Information“ oder Code „entry empty“). Dadurch wird der Standard nicht verletzt und das Template kann trotzdem verwenden werden.''
* Optionalitäten und Reihenfolge der 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 Prototyps von Art-Decor automatisch hinzugefügt wird, '''muss''' entfernt bzw. ersetzt werden ('''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
'''Kardinalität / Konformität'''
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 <nowiki>[https://art-decor.org/mediawiki/index.php?title=DECOR-rules#Mandatory_.2F_Conformance<Mandatory/nowiki>Conformance]).
{| class="wikitable"
! colspan="3" |Für Elemente
= 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 ==
Der '''Name''' und '''Display-Name ''' (Bezeichnung/Wiedergabename)bzw. '''Title''' auf Termgit) eines Value Set werden Sets müssen wie folgt angegebenwerden: '''[Präfix]_[ValueSetName]_VS'''
Als Trenner fungieren Unterstriche *'''Name''': '''[Präfix]-[ValueSetName]''' ("lowercase-Schreibweise)*'''Display-Name'''/'''Title''': '''[Präfix]_"[ValueSetName]''' (UpperCamelCase-Schreibweise), wobei folgendes gilt:
'''[Präfix]:''' Sonderzeichen sind nicht erlaubt.Als Präfix dient das Projektkürzel (Name des Repositories), z.B. "eimpf".
'''[ValueSetName]Beispiele:''' * Name des Value Sets in Upper: eimpf-CamelCase-Notation '''"VS":''' steht immer am Ende jeder Value Set Bezeichnung "Displayname" und "Name" des Value Sets sollen identisch sein!antikoerperbestimmungBeispiel* Title:eImpf_Antikoerperbestimmung
* Name: eimpf_Abrechenbarkeit_VSelga-administrativegender* WiedergabenameTitle: eimpf_Abrechenbarkeit_VSELGA_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:
''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 - Semantic Competence Center - Extranet - ELGA ConfluenceVersionierung].
== 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.{{EndYellowBox}}
= Beispielbefunde =
* 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
= 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 +BereitstellungSchematron-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 ==
== 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:
** im Beispieldokument enthalten
** Schematron Asserts ergänzen
* DLTbei '''jeder Version MUSS''' in <code>hl7at: formatCode, </code> die Versionierungsinfo + Publikationsdatum im Label anpassenangepasst 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 +BereitstellungSchematron-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)
** 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")
* Falsch-Beispielbefunde aktualisieren
* Schematron aktualisieren
 
== Feedback/Wünsche/Anregungen ==
Anfragen hinsichtlich der Änderung oder Erweiterung dieses Dokuments stellen Sie bitte an cda@elga.gv.at.
= 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>
585
Bearbeitungen

Navigationsmenü