Prozess der CDA-Leitfadenerstellung in Art-Decor
[unmarkierte Version] | [unmarkierte Version] |
(→Verwendung von Standards) |
|||
(65 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt) | |||
Zeile 30: | Zeile 30: | ||
|description= Hier finden Sie eine Erklärung zu der Erstellung von CDA-Leitfäden mit Art-Decor. | |description= Hier finden Sie eine Erklärung zu der Erstellung von CDA-Leitfäden mit Art-Decor. | ||
}} | }} | ||
− | + | ||
+ | {{BeginYellowBox}} | ||
+ | '''DIESE SEITE IST NICHT MEHR ZU BEARBEITEN, WURDE VOLLSTÄNDIG in [https://confluence.elga.gv.at/pages/viewpage.action?pageId=23791972 ELGA Governance für die CDA-Leitfadenerstellung mit Art-Decor - Semantic Competence Center - ELGA Confluence] ÜBERNOMMEN. Sobald die [https://wiki.hl7.at/index.php?title=Spezial:Linkliste/Hilfe:Art-Decor_Leitfadenerstellung Links, die auf diese Seite zeigen,] korrigiert wurden, kann die Seite gelöscht werden.''' | ||
+ | {{EndYellowBox}} | ||
+ | |||
+ | |||
+ | {{BeginYellowBox}} | ||
+ | Eine Einleitung in Art-Decor finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Introduction '''ART Introduction''']. | ||
<br> | <br> | ||
− | Eine Übersicht | + | Eine Übersicht verfügbarer Anleitungen sind unter [https://www.art-decor.org/mediawiki/index.php?title=ART_user_manual '''ART user manuals'''] aufgelistet. |
− | + | {{EndYellowBox}} | |
Folgende Vorgehensweisen werden bei der Erstellung von Leitfäden als '''Best Practices''' empfohlen. | Folgende Vorgehensweisen werden bei der Erstellung von Leitfäden als '''Best Practices''' empfohlen. | ||
− | ==Projekt erstellen== | + | ==Projekt erstellen (überarbeitet aber komplett übernommen)== |
Ein neuer CDA-Leitfaden '''muss''' in einem eigenen Projektverzeichnis angelegt, alle Autoren müssen entsprechend berechtigt werden. Dies muss gegebenenfalls beim [https://www.art-decor.org/mediawiki/index.php?title=Contact Art-Decor-Support] beantragt werden. | Ein neuer CDA-Leitfaden '''muss''' in einem eigenen Projektverzeichnis angelegt, alle Autoren müssen entsprechend berechtigt werden. Dies muss gegebenenfalls beim [https://www.art-decor.org/mediawiki/index.php?title=Contact Art-Decor-Support] beantragt werden. | ||
Informationen zu den Funktionen des Projekt-Editors finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor ART Project Editor]. | Informationen zu den Funktionen des Projekt-Editors finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor ART Project Editor]. | ||
− | ==Datasets erstellen== | + | ==Datasets erstellen (überarbeitet aber komplett übernommen)== |
Die Modellierung der Datasets soll in enger Abstimmung mit Experten der Arbeitsgruppe erfolgen. | Die Modellierung der Datasets soll in enger Abstimmung mit Experten der Arbeitsgruppe erfolgen. | ||
Es ist gute Praxis, bestehende Standards bereits bei der Modellierung der Datasets zu berücksichtigen (z.B. IHE PCC). Wenn möglich sollen bestehende Dataset-Elemente verwendet werden oder von diesen geerbt werden ([https://www.art-decor.org/mediawiki/index.php?title=DECOR-dataset#Dataset_versioning Dataset versioning]).<br> | Es ist gute Praxis, bestehende Standards bereits bei der Modellierung der Datasets zu berücksichtigen (z.B. IHE PCC). Wenn möglich sollen bestehende Dataset-Elemente verwendet werden oder von diesen geerbt werden ([https://www.art-decor.org/mediawiki/index.php?title=DECOR-dataset#Dataset_versioning Dataset versioning]).<br> | ||
Zeile 49: | Zeile 56: | ||
[https://www.art-decor.org/mediawiki/index.php?title=ART_Dataset_Editor ART Dataset Editor]. | [https://www.art-decor.org/mediawiki/index.php?title=ART_Dataset_Editor ART Dataset Editor]. | ||
− | ==Szenario erstellen== | + | ==Szenario erstellen (überarbeitet aber komplett übernommen)== |
Für '''jede''' Dokument-Ausprägung muss eine '''Transaktion''' erstellt werden. Diese ist für die Generierung von Schematronregeln erforderlich.<br> | Für '''jede''' Dokument-Ausprägung muss eine '''Transaktion''' erstellt werden. Diese ist für die Generierung von Schematronregeln erforderlich.<br> | ||
Transaktionen enthalten Konzepte eines Datasets und ergänzen diese um Kardinalität, Konformität und mögliche Bedingungen, damit die Anforderungen des Anwendungsfalles angemessen widergespiegelt werden. Die Angabe von Konformanz und Kardinalität der Dataset-Elemente kann nur in der Transaktion erfolgen, ist jedoch für die Erstellung eines Schematrons nicht zwingend erforderlich. <br> | Transaktionen enthalten Konzepte eines Datasets und ergänzen diese um Kardinalität, Konformität und mögliche Bedingungen, damit die Anforderungen des Anwendungsfalles angemessen widergespiegelt werden. Die Angabe von Konformanz und Kardinalität der Dataset-Elemente kann nur in der Transaktion erfolgen, ist jedoch für die Erstellung eines Schematrons nicht zwingend erforderlich. <br> | ||
− | Eine Transaktion '''muss''' das entsprechedende [[ | + | Eine Transaktion '''muss''' das entsprechedende [[#Document_Level_Template_erstellen | #Document-Level-Template]] referenzieren.<br> |
− | Die Benennung der Transaktion soll der [[ART-DECOR_Governance#Governance_f.C3.BCr_die_CDA-Leitfadenerstellung_mit_Art-Decor | Governance für die CDA-Leitfadenerstellung mit Art-Decor]] folgen.<br> | + | Die Benennung der Transaktion soll der [[ART-DECOR_Governance#Governance_f.C3.BCr_die_CDA-Leitfadenerstellung_mit_Art-Decor| Governance für die CDA-Leitfadenerstellung mit Art-Decor]] folgen.<br> |
Eine Beschreibung zur Erstellung von Transaktionen finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Scenario_Editor ART Scenario Editor]. | Eine Beschreibung zur Erstellung von Transaktionen finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Scenario_Editor ART Scenario Editor]. | ||
− | ==Referenzen auf andere Projektverzeichnisse setzen== | + | ==Referenzen auf andere Projektverzeichnisse setzen (überarbeitet aber komplett übernommen)== |
Um bestehende Templates anderer '''Building Block Repositories''' referenzieren zu können, müssen die entsprechenden Verzeichnisse dem Projekt hinzugefügt werden | Um bestehende Templates anderer '''Building Block Repositories''' referenzieren zu können, müssen die entsprechenden Verzeichnisse dem Projekt hinzugefügt werden | ||
{{BeginYellowBox}} | {{BeginYellowBox}} | ||
Zeile 63: | Zeile 70: | ||
Eine Anleitung hierfür finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor#Reference_a_building_block_repository Reference a building block repository]. | Eine Anleitung hierfür finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor#Reference_a_building_block_repository Reference a building block repository]. | ||
− | ==Templates erstellen== | + | ==Templates erstellen und referenzieren (überarbeitet aber komplett übernommen)== |
Hinsichtlich OID, Namensgebung, Beschreibung und Inhalte neuer Templates sind die Richtlinien der [[ART-DECOR_Governance#Governance_f.C3.BCr_die_CDA-Leitfadenerstellung_mit_Art-Decor | Governance für die CDA-Leitfadenerstellung mit Art-Decor]] einzuhalten.<br> | Hinsichtlich OID, Namensgebung, Beschreibung und Inhalte neuer Templates sind die Richtlinien der [[ART-DECOR_Governance#Governance_f.C3.BCr_die_CDA-Leitfadenerstellung_mit_Art-Decor | Governance für die CDA-Leitfadenerstellung mit Art-Decor]] einzuhalten.<br> | ||
Alle Funktionen des Template Editors finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Creating_a_link_to_a_template_that_resides_in_a_BBR '''ART Temple Editor''']. | Alle Funktionen des Template Editors finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Creating_a_link_to_a_template_that_resides_in_a_BBR '''ART Temple Editor''']. | ||
− | ===Verwendung von Standards=== | + | ===Verwendung von Standards (überarbeitet aber komplett übernommen)=== |
Grundsätzlich sollen existierende Standards angewendet werden. | Grundsätzlich sollen existierende Standards angewendet werden. | ||
Generell gilt daher: | Generell gilt daher: | ||
− | * Wenn möglich, sollen bereits vorhandene Templates verwenden werden | + | * Wenn möglich, sollen bereits vorhandene Templates verwenden werden. |
* Der Standard darf dabei nur eingeschränkt, aber nicht erweitert werden. | * Der Standard darf dabei nur eingeschränkt, aber nicht erweitert werden. | ||
* Optionalitäten und Reihenfolge der Elemente müssen eingehalten werden. | * Optionalitäten und Reihenfolge der Elemente müssen eingehalten 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. | :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. | ||
− | ===Neues Templates erzeugen=== | + | ===Neues Templates erzeugen (überarbeitet aber komplett übernommen)=== |
− | Informationen zur Erstellung von Templates finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Creating_a_new_template | + | Informationen zur Erstellung von Templates in Art-Decor finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Creating_a_new_template Creating a new template]. <br> |
Hinweise: | Hinweise: | ||
− | * Wenn ein neues Templates erstellt | + | * Wenn ein neues Templates erstellt wird, vergibt Art-Decor per default eine dem Projektverzeichnis untergeordnete '''OID''', welche nach den Vorgaben der [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance#Art-Decor_Root_OID Governance] geändert werden muss (siehe [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Metadata Metadata]). |
− | :Hierfür die [https://art-decor.org/art-decor/decor-governance-group?id=1.2.40.0.34.3.1.2 '''Art-Decor Governance Group'''] aufrufen und alle bestehenden Templates auflisten lassen, sodass deren Wiederverwendbarkeit geprüft und ermittelt werden kann, welche OID als nächstes vergeben werden darf. | + | :Hierfür die [https://art-decor.org/art-decor/decor-governance-group?id=1.2.40.0.34.3.1.2 '''Art-Decor Governance Group'''] aufrufen und alle unter HL7 Austria bestehenden Templates auflisten lassen, sodass deren Wiederverwendbarkeit geprüft und ermittelt werden kann, welche OID als nächstes vergeben werden darf. |
− | * Neue, '''allgemeine''' e-Health-/ELGA-Basistemplates sollen generell im ATCDABBR angelegt und so allgemein definiert werden, dass sie für andere Leitfäden verwendbar sind (ohne Value Sets, ohne projektspezifischen Angaben!)(*). Dies stellt sicher, dass alle Projekte Templates aus dem ATCDABBR ableiten und spezifizieren können (Value Sets ergänzen usw.). | + | * Neue, '''allgemeine''' e-Health-/ELGA-Basistemplates sollen generell im [https://art-decor.org/art-decor/decor-project--at-cda-bbr- ATCDABBR] angelegt und so allgemein definiert werden, dass sie für andere Leitfäden verwendbar sind (ohne Value Sets, ohne projektspezifischen Angaben!)(*). Dies stellt sicher, dass alle Projekte Templates aus dem ATCDABBR ableiten und spezifizieren können (Value Sets ergänzen usw.). |
:Beispiel: Section-Template „Durchgemachte Krankheiten“ im ATCDABBR wird abgeleitet in Section-Template „Impfrelevante Erkrankungen - kodiert“ im e-Impfpass. | :Beispiel: Section-Template „Durchgemachte Krankheiten“ im ATCDABBR wird abgeleitet in Section-Template „Impfrelevante Erkrankungen - kodiert“ im e-Impfpass. | ||
(*) Bei fehlender Berechtigung können Basistemplates im Projektverzeichnis erstellt werden und später durch berechtigte Personen in das ATCDABBR verschoben werden. | (*) Bei fehlender Berechtigung können Basistemplates im Projektverzeichnis erstellt werden und später durch berechtigte Personen in das ATCDABBR verschoben werden. | ||
− | === | + | ===Referenzieren bestehender Templates (überarbeitet aber komplett übernommen)=== |
− | + | Unter dem Link [https://art-decor.org/art-decor/decor-governance-group?id=2.16.840.1.113883.2.16 '''Art-Decor Governance Group'''] sind die Templates der HL7 Austria aufgelistet.<br> | |
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.<br> | 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.<br> | ||
Je nachdem, ob das Projekt, in dem sich das zu übernehmende Template befindet, im eigenen Projekt verlinkt ist, muss wie folgt vorgegangen werden: | Je nachdem, ob das Projekt, in dem sich das zu übernehmende Template befindet, im eigenen Projekt verlinkt ist, muss wie folgt vorgegangen werden: | ||
− | ==== Verlinktes Projektverzeichnis ==== | + | ==== Verlinktes Projektverzeichnis (überarbeitet aber komplett übernommen)==== |
Übernahme eines vorhandenen Templates aus einem '''verlinktem Projektverzeichnis''' (siehe [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Creating_a_link_to_a_template_that_resides_in_a_BBR Bestehendes Templates aus einem anderen BBR referenzieren]) | Übernahme eines vorhandenen Templates aus einem '''verlinktem Projektverzeichnis''' (siehe [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Creating_a_link_to_a_template_that_resides_in_a_BBR Bestehendes Templates aus einem anderen BBR referenzieren]) | ||
− | * ''' | + | * '''Referenzierung''' (unveränderte Übernahme) des Templates mit Kettensymbol |
:* Keine Änderung des Templates möglich! | :* Keine Änderung des Templates möglich! | ||
:* Nur verwenden, wenn es bereits ein passendes ELGA-/e-Health-Template gibt | :* Nur verwenden, wenn es bereits ein passendes ELGA-/e-Health-Template gibt | ||
− | * ''' | + | * '''Ableitung''' des Templates (Kopieren und Anpassen) (siehe [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Creating_a_new_version_of_an_existing_template Neue Version eines bestehenden Templates erzeugen]) |
:* Ein passendes Template wird via „+“-Symbol als Prototyp angegeben, welches im Anschluss spezifiziert werden muss (neue OID). | :* Ein passendes Template wird via „+“-Symbol als Prototyp angegeben, welches im Anschluss spezifiziert werden muss (neue OID). | ||
− | ==== Nicht verlinktes Projektverzeichnis ==== | + | ==== Nicht verlinktes Projektverzeichnis (komplett übernommen)==== |
Die Übernahme vorhandener Templates aus Projektverzeichnissen, die '''NICHT verlinkt''' sind, ist nicht über die GUI möglich, da diese Templates nicht als Prototyp angegeben werden können (d.h. von ihnen kann nicht geerbt werden).<br> | Die Übernahme vorhandener Templates aus Projektverzeichnissen, die '''NICHT verlinkt''' sind, ist nicht über die GUI möglich, da diese Templates nicht als Prototyp angegeben werden können (d.h. von ihnen kann nicht geerbt werden).<br> | ||
Soll der Inhalt eines Templates trotzdem verwendet werden, lässt sich mittels Browser-Direktlink | Soll der Inhalt eines Templates trotzdem verwendet werden, lässt sich mittels Browser-Direktlink | ||
:<code><nowiki>https://art-decor.org/temple/modules/temple.xquery?id=[OID des Templates]</nowiki></code> | :<code><nowiki>https://art-decor.org/temple/modules/temple.xquery?id=[OID des Templates]</nowiki></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 kopierte Inhalt kann dann in ein neu erstelltes, leeres Template (mittels "+" und "Create from scratch") 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. <br> | 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 kopierte Inhalt kann dann in ein neu erstelltes, leeres Template (mittels "+" und "Create from scratch") 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. <br> | ||
− | + | Die OID muss in einem späteren Arbeitsschritt über die GUI korrigiert werden. | |
− | ===Änderung bestehender Templates=== | + | ===Änderung bestehender Templates (überarbeitet aber komplett übernommen)=== |
− | Solange sich ein Template noch im Status [[ART-DECOR_Governance#Artefaktstatus|'''Entwurf''']] befindet, kann es | + | Solange sich ein Template noch im Status [[ART-DECOR_Governance#Artefaktstatus|'''Entwurf''']] befindet, kann es bearbeitet werden. Dabei ist folgendes zu beachten: |
+ | * Falls bereits andere Leitfäden darauf referenzieren, ist mit den Autoren Rücksprache zu halten. | ||
* Der '''Name''' eines Templates (nicht der Display-Name!) kann nach dem Erstellen des Templates nur mittels [https://www.art-decor.org/mediawiki/index.php?title=Temple '''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. | * Der '''Name''' eines Templates (nicht der Display-Name!) kann nach dem Erstellen des Templates nur mittels [https://www.art-decor.org/mediawiki/index.php?title=Temple '''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 neuen OID anpassen! | * 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 neuen OID anpassen! | ||
+ | * Wird ein Template (im Entwurf-Status!) nicht mehr benötigt, soll der Inhalt gelöscht und ein dummy-Name sowie eine dummy-OID (z.B. OID Ändern auf Zweig 1.2.40.0.34.6.0.11'''.777.'''xxx) vergeben werden. Dies steht somit zur späteren Verwendung frei. 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. | ||
{{BeginYellowBox}} | {{BeginYellowBox}} | ||
''Wichtiger Hinweis:'' Sollte das Template bereits produktiv sein ("active"), finden Sie Informationen unter [[Hilfe:Art-Decor_Leitfadenerstellung#Versionierung|'''Versionierung''']]. | ''Wichtiger Hinweis:'' Sollte das Template bereits produktiv sein ("active"), finden Sie Informationen unter [[Hilfe:Art-Decor_Leitfadenerstellung#Versionierung|'''Versionierung''']]. | ||
{{EndYellowBox}} | {{EndYellowBox}} | ||
− | + | ==Inhalte von Templates== | |
+ | ===Template Metadaten=== | ||
Hinsichtlich folgender Elemente gelten die Vorgaben der Governance. | Hinsichtlich folgender Elemente gelten die Vorgaben der Governance. | ||
− | ====Templatename==== | + | ====Templatename (überarbeitet aber komplett übernommen)==== |
− | Es gelten die Definitionen der Governance hinsichtlich [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance# | + | Es gelten die Definitionen der Governance hinsichtlich [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance#Namens-_und_Versionierungs-Konventionen Namenskonventionen] |
− | ====Versions-Label==== | + | ====Versions-Label (überarbeitet aber komplett übernommen)==== |
− | Es gelten die Definitionen der Governance hinsichtlich [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance# | + | Es gelten die Definitionen der Governance hinsichtlich [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance#Namens-_und_Versionierungs-Konventionen Versionierungskonventionen] |
− | ====Item-Label==== | + | ====Item-Label (entfällt)==== |
Es gelten die Definitionen der Governance hinsichtlich [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance#Item-Label Item-Label] | Es gelten die Definitionen der Governance hinsichtlich [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance#Item-Label Item-Label] | ||
+ | ====Relationships (überarbeitet aber komplett übernommen)==== | ||
+ | Wenn Beziehungen zu anderen Templates bestehen (z.B. Spezialisierung), sollen diese in den Template-Metadaten des neu erstellten Templates ersichtlich sein. | ||
− | ====Beispiel-Snippets==== | + | Die Arten der anzugebenden '''Beziehungstypen''' sind der Governance unter [[ART-DECOR_Governance#Ableitung_von_Templates|Ableitung von Templates]] beschrieben. |
+ | |||
+ | Die Template-ID des Basistemplates wird nur zu Zwecken der Nachvollziehbarkeit in den Metadaten angegeben, in der Templatespezifikation selbst muss sie entfernt werden, da dies sonst bei der Generierung von "closed" Schematron-Regeln zu Inkonsistenzen und zu falsch-positiven Schematron-Fehlern bei der Validierung führen kann. | ||
+ | |||
+ | ====Beispiel-Snippets (überarbeitet aber komplett übernommen)==== | ||
* Code-Snippet-Gerüste können mit dem "Zaubstab" im ART Template Editor erzeugt werden (siehe [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Insert_example '''Insert example''']). | * Code-Snippet-Gerüste können mit dem "Zaubstab" im ART Template Editor erzeugt werden (siehe [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Editor#Insert_example '''Insert example''']). | ||
− | * In '''allen Templates''' (außer DLTs) werden nur '''Code-Snippets''' des betreffenden Templates selbst eingefügt. Snippets zu den darin verlinkten Templates | + | * In '''allen Templates''' (außer DLTs) werden nur '''Code-Snippets''' des betreffenden Templates selbst eingefügt. Beispiel-Snippets werden in der Regel nur zum Template selbst erstellt, nicht aber zu den darin verlinkten Templates (z.B. included Entries). |
* Code-Snippets sollen immer '''zuletzt''' ergänzt werden, um den Aufwand nach Änderungen im Template gering zu halten. | * Code-Snippets sollen immer '''zuletzt''' ergänzt werden, um den Aufwand nach Änderungen im Template gering zu halten. | ||
− | ====XDS-Metadaten-Mapping==== | + | ===Template Body=== |
− | + | ====Template-ID (überarbeitet aber komplett übernommen)==== | |
+ | In einer konkreten CDA XML Instanz darf nur 1 Template-ID aus dem ELGA OID Root 1.2.40.0.34.6.0.11.XXX stammen. D.h. jene Template-ID, die beim Ableiten eines Prototyps von Art-Decor automatisch hinzugefügt wird, muss entfernt werden. | ||
+ | Weitere OID können - sofern im zugrundeliegenden Standard gefordert - angegeben werden. | ||
+ | Alle Richtlinien zur Vergabe einer OID für das neu erzeugte Template sind unter [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance#Root_OID_f.C3.BCr_Templates Governance] zu finden. | ||
+ | |||
+ | ==== Standard-Referenzen (überarbeitet aber komplett übernommen)==== | ||
+ | Daten- und Template-Elemente sollen in ihrem Label zu der entsprechenden Spezifikation verlinken, auf der sie basieren (z.B. IHE PHARM, Kap. 4.4). Dies liegt in der Verantwortung des Entwicklers. | ||
+ | |||
+ | ====XDS-Metadaten-Mapping (komplett übernommen)==== | ||
+ | Elemente die auf XDS-Metadaten gemappt werden müssen, sollen mit "↔ Hinweis zum XDS-Mapping" gekennzeichnet sein.<br> | ||
+ | Beispiel:<br> | ||
+ | '''↔ Hinweis zum XDS-Mapping:''' Das templateId-Element mit einer Extension beginnend mit "XDSdocumentEntry.formatCode^" wird ins XDS-Attribut formatCode gemappt (ohne Präfix XDSdocumentEntry.formatCode^) | ||
− | ===Document Level Template erstellen=== | + | ====Verwendung von Template-Compilations (komplett übernommen)==== |
+ | Compilations sind Template-Fragmente, wie z.B. Adressinformationen. Da sich diese mehrfach wiederholen können, sollen sie mit "contains" eingebunden werden (d.h. der Inhalt der Compilation wird nicht im verlinkenden Template angezeigt). Diese sollen aber im Leitfaden als eigene Kapitel vorhanden sein. | ||
+ | |||
+ | ===Document Level Template erstellen (überarbeitet aber komplett übernommen)=== | ||
Für '''jede Dokumentart''' (jede Transaktion) muss ein neues Document-Level-Template (DLT) erstellt werden (nach Vorgaben der [[ART-DECOR_Governance#Governance_f.C3.BCr_die_CDA-Leitfadenerstellung_mit_Art-Decor | Governance]]).<br> | Für '''jede Dokumentart''' (jede Transaktion) muss ein neues Document-Level-Template (DLT) erstellt werden (nach Vorgaben der [[ART-DECOR_Governance#Governance_f.C3.BCr_die_CDA-Leitfadenerstellung_mit_Art-Decor | Governance]]).<br> | ||
''Anmerkung: 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.''<br> | ''Anmerkung: 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.''<br> | ||
− | ====Workflow Document Level Template erstellen==== | + | ====Workflow Document Level Template erstellen (überarbeitet und teilweise übernommen)==== |
− | # Neues | + | # Neues DLT anlegen: Angabe Name, Version Label, Display Name laut Governance, dann Template mit der von Art-Decor per default vergebenen OID speichern |
# Anschließend OID entsprechend Governance korrigieren (Template bearbeiten, "#")(nur über GUI möglich, nicht via Temple). | # Anschließend OID entsprechend Governance korrigieren (Template bearbeiten, "#")(nur über GUI möglich, nicht via Temple). | ||
− | # | + | # „Included Templates“ aus DLT-Header mit Kettensymbol zum Projekt hinzufügen |
− | + | Tipps (entfällt): | |
− | + | * Zur Vereinfachung kann der Inhalt eines bestehenden DLT via Temple als XML kopiert und in das neue Template einfügen werden (effective DATE und OID bleiben erhalten). | |
+ | * Inhaltliche Korrekturen und Anpassungen können auch in einem externen XML-Editor (z.B. Oxygen) durchgeführt und dann in Temple eingefügt werden. | ||
− | ==Dataset-Mapping erstellen== | + | ====Referenzierte Header Level Templates (überarbeitet aber komplett übernommen)==== |
− | Die Zuordnung von Datensatz-Elementen und erstellten Templates wird empfohlen. 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, dass alle erforderlichen | + | Der Großteil der Header Level Templates werden aus dem at-cda-bbr (Allgemeiner Leitfaden - ALF) referenziert. Für die Referenzierung dieser gibt es folgende Vorgaben: |
+ | * Alle verwendeten ALF Header Templates werden im speziellen Leitfaden, in welchem sie verwendet werden, als "new template reference" ins Projekt geladen. | ||
+ | * Die verwendeten ALF Header Templates werden mit include im Document Level Template abgebildet. | ||
+ | * Die verwendeten AILF Header Templates werden nicht nochmals eigens in die Leitfäden (z.B. unter 10.2.2 Header Level Templates) referenziert, da sie im DLT abgebildet sind. | ||
+ | |||
+ | ==Dataset-Mapping erstellen (überarbeitet aber komplett übernommen)== | ||
+ | Die Zuordnung von Datensatz-Elementen und erstellten Templates wird empfohlen. 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. | ||
[https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Associations ART Template Associations] | [https://www.art-decor.org/mediawiki/index.php?title=ART_Template_Associations ART Template Associations] | ||
− | ==Terminologien hinzufügen== | + | ==Terminologien hinzufügen (überarbeitet aber komplett übernommen)== |
Bestehende ValueSets können mit Kettensymbol unter Value-Sets hinzugefügt werden | Bestehende ValueSets können mit Kettensymbol unter Value-Sets hinzugefügt werden | ||
Zeile 152: | Zeile 189: | ||
* [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance&stable=0&redirect=no#Bezeichnungen_f.C3.BCr_Value_Sets Namenskonventionen für die Erstellung neuer Value Sets] | * [https://wiki.hl7.at/index.php?title=ART-DECOR_Governance&stable=0&redirect=no#Bezeichnungen_f.C3.BCr_Value_Sets Namenskonventionen für die Erstellung neuer Value Sets] | ||
− | ==Testen und Fehlerbehebung== | + | ==Testen und Fehlerbehebung (überarbeitet aber komplett übernommen)== |
+ | Um die Qualität eines Projekts zu überprüfen, können eine Reihe von Prüfungen durchgeführt werden, bevor eine Publikation erstellt wird. | ||
+ | |||
Informationen zu den entsprechenden Funktionalitäten des | Informationen zu den entsprechenden Funktionalitäten des | ||
ART Project Editors finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor#Preflighting%20publication%20and%20quality%20checks Preflighting publication and quality checks]. | ART Project Editors finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor#Preflighting%20publication%20and%20quality%20checks Preflighting publication and quality checks]. | ||
===Workflow Decor Prüfung=== | ===Workflow Decor Prüfung=== | ||
+ | Die Decor Prüfung testet, ob das Projektschema gültig ist und Schematronregeln erstellt werden können. | ||
+ | |||
Menü Projekt – Entwicklung: | Menü Projekt – Entwicklung: | ||
* "Decor prüfen": Prüfung über gesamtes Modell | * "Decor prüfen": Prüfung über gesamtes Modell | ||
Zeile 162: | Zeile 203: | ||
:* Schema und Schematron-Prüfung durchführen, eventuelle Fehler werden aufgelistet. | :* Schema und Schematron-Prüfung durchführen, eventuelle Fehler werden aufgelistet. | ||
− | ==Schematron erstellen== | + | ==Schematron erstellen (überarbeitet aber komplett übernommen: https://confluence.elga.gv.at/display/SCC/Schematron-Erstellung+und+Bereitstellung)== |
Generell gilt: | Generell gilt: | ||
− | * | + | * Mithilfe von ISO Schematron kann geprüft werden, ob ein gültiges HL7 CDA Dokument (HL7 v3) vorliegt, während eine XSD-Schemaprüfung, nur prüft ob ein gültiges XML Dokument vorliegt. |
− | * Wenn Geschäftsregeln geprüft werden sollen, müssen | + | * Aus den modellierten Templates können über Art-Decor automatisch Schematronregeln generiert werden. |
+ | * Wenn zusätzliche Geschäftsregeln geprüft werden sollen, die nicht in den Templates modelliert sind, müssen die dazu notwendigen Asserts von Hand eingetragen werden (z.B. Logik: Schwangerschaftsstatus, prüfen ob Impfempfehlung in diesem Jahr noch gültig). | ||
* Informationen zu den entsprechenden Art-Decor Tool finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=Live_Runtime_Compile Live Runtime Compile (LRC)]. | * Informationen zu den entsprechenden Art-Decor Tool finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=Live_Runtime_Compile Live Runtime Compile (LRC)]. | ||
− | * Es wird empfohlen, bereits | + | * Es wird empfohlen, bereits während der Modellierung regelmäßig eine Kompilierung durchzuführen (z.B. nachdem ein DLT mit Header und noch leerem structuredBody erstellt wurde), um zu testen, ob das Projektschema noch gültig ist. |
* Art-Decor bietet die Möglichkeit nach korrekter Schematron-Generierung ein Beispieldokument zu prüfen. | * Art-Decor bietet die Möglichkeit nach korrekter Schematron-Generierung ein Beispieldokument zu prüfen. | ||
− | ===Workflow Schematron erzeugen=== | + | ===Workflow Schematron erzeugen === |
Menü Projekt – Entwicklung: | Menü Projekt – Entwicklung: | ||
* "Compiliere Entwicklungsversion": | * "Compiliere Entwicklungsversion": | ||
Zeile 177: | Zeile 219: | ||
:* Nach Publikation soll nur die letzte, gültige Schematron-Version verfügbar sein (alle restliche können entfernt werden). | :* Nach Publikation soll nur die letzte, gültige Schematron-Version verfügbar sein (alle restliche können entfernt werden). | ||
− | ==Asserts erstellen== | + | ==Asserts erstellen (entfällt)== |
− | (TODO) | + | (TODO: OKU) |
− | ==Beispieldokumente == | + | ==Beispieldokumente (überarbeitet aber komplett übernommen== |
===Beispielbokumente erstellen=== | ===Beispielbokumente erstellen=== | ||
* Das Gerüst eines Beispieldokuments kann erstellt werden, indem man im entsprechenden DLT den Zauberstab des Template Editors anwendet und rekursiv alle Code-Snippets der darin verlinkten Templates einfügt. | * Das Gerüst eines Beispieldokuments kann erstellt werden, indem man im entsprechenden DLT den Zauberstab des Template Editors anwendet und rekursiv alle Code-Snippets der darin verlinkten Templates einfügt. | ||
Zeile 190: | Zeile 232: | ||
Nachdem erfolgreich ein [[Hilfe:Art-Decor_Leitfadenerstellung#Schematron_erstellen|Schematron]] erstellt wurde, kann unter im Projekt Editor unter "Menü Projekt"–"Entwicklung"-"Compiliere Entwicklungsversion" im aktuellen Listeneintrag die Funktion "XML-Instanz validieren" ausgewählt werden und ein Beispieldokument hochgeladen werden. | Nachdem erfolgreich ein [[Hilfe:Art-Decor_Leitfadenerstellung#Schematron_erstellen|Schematron]] erstellt wurde, kann unter im Projekt Editor unter "Menü Projekt"–"Entwicklung"-"Compiliere Entwicklungsversion" im aktuellen Listeneintrag die Funktion "XML-Instanz validieren" ausgewählt werden und ein Beispieldokument hochgeladen werden. | ||
− | =Publikation= | + | =Publikation (überarbeitet aber komplett übernommen: https://confluence.elga.gv.at/display/SCC/Schematron-Erstellung+und+Bereitstellung)= |
Informationen zur Publikation eines Leitfadens in Art-Decor finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor#Creating_a_new_version_.2F_release_.2F_publication_request Creating a new version / release / publication request]. | Informationen zur Publikation eines Leitfadens in Art-Decor finden Sie unter [https://www.art-decor.org/mediawiki/index.php?title=ART_Project_Editor#Creating_a_new_version_.2F_release_.2F_publication_request Creating a new version / release / publication request]. | ||
Aktuelle Version vom 28. Juli 2021, 11:21 Uhr
DIESE SEITE IST NICHT MEHR ZU BEARBEITEN, WURDE VOLLSTÄNDIG in ELGA Governance für die CDA-Leitfadenerstellung mit Art-Decor - Semantic Competence Center - ELGA Confluence ÜBERNOMMEN. Sobald die Links, die auf diese Seite zeigen, korrigiert wurden, kann die Seite gelöscht werden.
Eine Einleitung in Art-Decor finden Sie unter ART Introduction.
Eine Übersicht verfügbarer Anleitungen sind unter ART user manuals aufgelistet.
Folgende Vorgehensweisen werden bei der Erstellung von Leitfäden als Best Practices empfohlen.
Inhaltsverzeichnis
- 1 Projekt erstellen (überarbeitet aber komplett übernommen)
- 2 Datasets erstellen (überarbeitet aber komplett übernommen)
- 3 Szenario erstellen (überarbeitet aber komplett übernommen)
- 4 Referenzen auf andere Projektverzeichnisse setzen (überarbeitet aber komplett übernommen)
- 5 Templates erstellen und referenzieren (überarbeitet aber komplett übernommen)
- 6 Inhalte von Templates
- 7 Dataset-Mapping erstellen (überarbeitet aber komplett übernommen)
- 8 Terminologien hinzufügen (überarbeitet aber komplett übernommen)
- 9 Testen und Fehlerbehebung (überarbeitet aber komplett übernommen)
- 10 Schematron erstellen (überarbeitet aber komplett übernommen: https://confluence.elga.gv.at/display/SCC/Schematron-Erstellung+und+Bereitstellung)
- 11 Asserts erstellen (entfällt)
- 12 Beispieldokumente (überarbeitet aber komplett übernommen
- 13 Publikation (überarbeitet aber komplett übernommen: https://confluence.elga.gv.at/display/SCC/Schematron-Erstellung+und+Bereitstellung)
- 14 Versionierung
1 Projekt erstellen (überarbeitet aber komplett übernommen)
Ein neuer CDA-Leitfaden muss in einem eigenen Projektverzeichnis angelegt, alle Autoren müssen entsprechend berechtigt werden. Dies muss gegebenenfalls beim Art-Decor-Support beantragt werden.
Informationen zu den Funktionen des Projekt-Editors finden Sie unter ART Project Editor.
2 Datasets erstellen (überarbeitet aber komplett übernommen)
Die Modellierung der Datasets soll in enger Abstimmung mit Experten der Arbeitsgruppe erfolgen.
Es ist gute Praxis, bestehende Standards bereits bei der Modellierung der Datasets zu berücksichtigen (z.B. IHE PCC). Wenn möglich sollen bestehende Dataset-Elemente verwendet werden oder von diesen geerbt werden (Dataset versioning).
Die anzugebenden Inhalte eines Dataset-Elements sind in der Governance festgelegt.
Eine Anleitung zur Modellierung von Datasets finden Sie unter ART Dataset Editor.
3 Szenario erstellen (überarbeitet aber komplett übernommen)
Für jede Dokument-Ausprägung muss eine Transaktion erstellt werden. Diese ist für die Generierung von Schematronregeln erforderlich.
Transaktionen enthalten Konzepte eines Datasets und ergänzen diese um Kardinalität, Konformität und mögliche Bedingungen, damit die Anforderungen des Anwendungsfalles angemessen widergespiegelt werden. Die Angabe von Konformanz und Kardinalität der Dataset-Elemente kann nur in der Transaktion erfolgen, ist jedoch für die Erstellung eines Schematrons nicht zwingend erforderlich.
Eine Transaktion muss das entsprechedende #Document-Level-Template referenzieren.
Die Benennung der Transaktion soll der Governance für die CDA-Leitfadenerstellung mit Art-Decor folgen.
Eine Beschreibung zur Erstellung von Transaktionen finden Sie unter ART Scenario Editor.
4 Referenzen auf andere Projektverzeichnisse setzen (überarbeitet aber komplett übernommen)
Um bestehende Templates anderer Building Block Repositories referenzieren zu können, müssen die entsprechenden Verzeichnisse dem Projekt hinzugefügt werden
Empfehlung: Dem Projekt Referenzen für ad1bbr-, ad2bbr-, at-cda-bbr-, IHE-PCC- hinzufügen.
Eine Anleitung hierfür finden Sie unter Reference a building block repository.
5 Templates erstellen und referenzieren (überarbeitet aber komplett übernommen)
Hinsichtlich OID, Namensgebung, Beschreibung und Inhalte neuer Templates sind die Richtlinien der Governance für die CDA-Leitfadenerstellung mit Art-Decor einzuhalten.
Alle Funktionen des Template Editors finden Sie unter ART Temple Editor.
5.1 Verwendung von Standards (überarbeitet aber komplett übernommen)
Grundsätzlich sollen existierende Standards angewendet werden. Generell gilt daher:
- Wenn möglich, sollen bereits vorhandene Templates verwenden werden.
- Der Standard darf dabei nur eingeschränkt, aber nicht erweitert werden.
- Optionalitäten und Reihenfolge der Elemente müssen eingehalten 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.
5.2 Neues Templates erzeugen (überarbeitet aber komplett übernommen)
Informationen zur Erstellung von Templates in Art-Decor finden Sie unter Creating a new template.
Hinweise:
- Wenn ein neues Templates erstellt wird, vergibt Art-Decor per default eine dem Projektverzeichnis untergeordnete OID, welche nach den Vorgaben der Governance geändert werden muss (siehe Metadata).
- Hierfür die Art-Decor Governance Group aufrufen und alle unter HL7 Austria bestehenden Templates auflisten lassen, sodass deren Wiederverwendbarkeit geprüft und ermittelt werden kann, welche OID als nächstes vergeben werden darf.
- Neue, allgemeine e-Health-/ELGA-Basistemplates sollen generell im ATCDABBR angelegt und so allgemein definiert werden, dass sie für andere Leitfäden verwendbar sind (ohne Value Sets, ohne projektspezifischen Angaben!)(*). Dies stellt sicher, dass alle Projekte Templates aus dem ATCDABBR ableiten und spezifizieren können (Value Sets ergänzen usw.).
- Beispiel: Section-Template „Durchgemachte Krankheiten“ im ATCDABBR wird abgeleitet in Section-Template „Impfrelevante Erkrankungen - kodiert“ im e-Impfpass.
(*) Bei fehlender Berechtigung können Basistemplates im Projektverzeichnis erstellt werden und später durch berechtigte Personen in das ATCDABBR verschoben werden.
5.3 Referenzieren bestehender Templates (überarbeitet aber komplett übernommen)
Unter dem Link Art-Decor Governance Group sind die Templates der HL7 Austria aufgelistet.
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.
Je nachdem, ob das Projekt, in dem sich das zu übernehmende Template befindet, im eigenen Projekt verlinkt ist, muss wie folgt vorgegangen werden:
5.3.1 Verlinktes Projektverzeichnis (überarbeitet aber komplett übernommen)
Übernahme eines vorhandenen Templates aus einem verlinktem Projektverzeichnis (siehe Bestehendes Templates aus einem anderen BBR referenzieren)
- Referenzierung (unveränderte Übernahme) des Templates mit Kettensymbol
- Keine Änderung des Templates möglich!
- Nur verwenden, wenn es bereits ein passendes ELGA-/e-Health-Template gibt
- Ableitung des Templates (Kopieren und Anpassen) (siehe Neue Version eines bestehenden Templates erzeugen)
- Ein passendes Template wird via „+“-Symbol als Prototyp angegeben, welches im Anschluss spezifiziert werden muss (neue OID).
5.3.2 Nicht verlinktes Projektverzeichnis (komplett übernommen)
Die Übernahme vorhandener Templates aus Projektverzeichnissen, die NICHT verlinkt sind, ist nicht über die GUI möglich, da diese Templates nicht als Prototyp angegeben werden können (d.h. von ihnen kann nicht geerbt werden).
Soll der Inhalt eines Templates trotzdem verwendet werden, lässt sich mittels Browser-Direktlink
https://art-decor.org/temple/modules/temple.xquery?id=[OID des Templates]
der XML-Code jedes Templates via Temple (im Lesemodus) anzeigen und anschließend kopieren. Der kopierte Inhalt kann dann in ein neu erstelltes, leeres Template (mittels "+" und "Create from scratch") 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.
5.4 Änderung bestehender Templates (überarbeitet aber komplett übernommen)
Solange sich ein Template noch im Status Entwurf befindet, kann es bearbeitet werden. Dabei ist folgendes zu beachten:
- Falls bereits andere Leitfäden darauf referenzieren, ist mit den Autoren Rücksprache zu halten.
- Der Name eines Templates (nicht der Display-Name!) kann nach dem Erstellen des 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 neuen OID anpassen!
- Wird ein Template (im Entwurf-Status!) nicht mehr benötigt, soll der Inhalt gelöscht und ein dummy-Name sowie eine dummy-OID (z.B. OID Ändern auf Zweig 1.2.40.0.34.6.0.11.777.xxx) vergeben werden. Dies steht somit zur späteren Verwendung frei. 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.
Wichtiger Hinweis: Sollte das Template bereits produktiv sein ("active"), finden Sie Informationen unter Versionierung.
6 Inhalte von Templates
6.1 Template Metadaten
Hinsichtlich folgender Elemente gelten die Vorgaben der Governance.
6.1.1 Templatename (überarbeitet aber komplett übernommen)
Es gelten die Definitionen der Governance hinsichtlich Namenskonventionen
6.1.2 Versions-Label (überarbeitet aber komplett übernommen)
Es gelten die Definitionen der Governance hinsichtlich Versionierungskonventionen
6.1.3 Item-Label (entfällt)
Es gelten die Definitionen der Governance hinsichtlich Item-Label
6.1.4 Relationships (überarbeitet aber komplett übernommen)
Wenn Beziehungen zu anderen Templates bestehen (z.B. Spezialisierung), sollen diese in den Template-Metadaten des neu erstellten Templates ersichtlich sein.
Die Arten der anzugebenden Beziehungstypen sind der Governance unter Ableitung von Templates beschrieben.
Die Template-ID des Basistemplates wird nur zu Zwecken der Nachvollziehbarkeit in den Metadaten angegeben, in der Templatespezifikation selbst muss sie entfernt werden, da dies sonst bei der Generierung von "closed" Schematron-Regeln zu Inkonsistenzen und zu falsch-positiven Schematron-Fehlern bei der Validierung führen kann.
6.1.5 Beispiel-Snippets (überarbeitet aber komplett übernommen)
- Code-Snippet-Gerüste können mit dem "Zaubstab" im ART Template Editor erzeugt werden (siehe Insert example).
- In allen Templates (außer DLTs) werden nur Code-Snippets des betreffenden Templates selbst eingefügt. Beispiel-Snippets werden in der Regel nur zum Template selbst erstellt, nicht aber zu den darin verlinkten Templates (z.B. included Entries).
- Code-Snippets sollen immer zuletzt ergänzt werden, um den Aufwand nach Änderungen im Template gering zu halten.
6.2 Template Body
6.2.1 Template-ID (überarbeitet aber komplett übernommen)
In einer konkreten CDA XML Instanz darf nur 1 Template-ID aus dem ELGA OID Root 1.2.40.0.34.6.0.11.XXX stammen. D.h. jene Template-ID, die beim Ableiten eines Prototyps von Art-Decor automatisch hinzugefügt wird, muss entfernt werden. Weitere OID können - sofern im zugrundeliegenden Standard gefordert - angegeben werden. Alle Richtlinien zur Vergabe einer OID für das neu erzeugte Template sind unter Governance zu finden.
6.2.2 Standard-Referenzen (überarbeitet aber komplett übernommen)
Daten- und Template-Elemente sollen in ihrem Label zu der entsprechenden Spezifikation verlinken, auf der sie basieren (z.B. IHE PHARM, Kap. 4.4). Dies liegt in der Verantwortung des Entwicklers.
6.2.3 XDS-Metadaten-Mapping (komplett übernommen)
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 formatCode gemappt (ohne Präfix XDSdocumentEntry.formatCode^)
6.2.4 Verwendung von Template-Compilations (komplett übernommen)
Compilations sind Template-Fragmente, wie z.B. Adressinformationen. Da sich diese mehrfach wiederholen können, sollen sie mit "contains" eingebunden werden (d.h. der Inhalt der Compilation wird nicht im verlinkenden Template angezeigt). Diese sollen aber im Leitfaden als eigene Kapitel vorhanden sein.
6.3 Document Level Template erstellen (überarbeitet aber komplett übernommen)
Für jede Dokumentart (jede Transaktion) muss ein neues Document-Level-Template (DLT) erstellt werden (nach Vorgaben der Governance).
Anmerkung: 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.
6.3.1 Workflow Document Level Template erstellen (überarbeitet und teilweise übernommen)
- Neues DLT anlegen: Angabe Name, Version Label, Display Name laut Governance, dann Template mit der von Art-Decor per default vergebenen OID speichern
- Anschließend OID entsprechend Governance korrigieren (Template bearbeiten, "#")(nur über GUI möglich, nicht via Temple).
- „Included Templates“ aus DLT-Header mit Kettensymbol zum Projekt hinzufügen
Tipps (entfällt):
- Zur Vereinfachung kann der Inhalt eines bestehenden DLT via Temple als XML kopiert und in das neue Template einfügen werden (effective DATE und OID bleiben erhalten).
- Inhaltliche Korrekturen und Anpassungen können auch in einem externen XML-Editor (z.B. Oxygen) durchgeführt und dann in Temple eingefügt werden.
6.3.2 Referenzierte Header Level Templates (überarbeitet aber komplett übernommen)
Der Großteil der Header Level Templates werden aus dem at-cda-bbr (Allgemeiner Leitfaden - ALF) referenziert. Für die Referenzierung dieser gibt es folgende Vorgaben:
- Alle verwendeten ALF Header Templates werden im speziellen Leitfaden, in welchem sie verwendet werden, als "new template reference" ins Projekt geladen.
- Die verwendeten ALF Header Templates werden mit include im Document Level Template abgebildet.
- Die verwendeten AILF Header Templates werden nicht nochmals eigens in die Leitfäden (z.B. unter 10.2.2 Header Level Templates) referenziert, da sie im DLT abgebildet sind.
7 Dataset-Mapping erstellen (überarbeitet aber komplett übernommen)
Die Zuordnung von Datensatz-Elementen und erstellten Templates wird empfohlen. 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.
8 Terminologien hinzufügen (überarbeitet aber komplett übernommen)
Bestehende ValueSets können mit Kettensymbol unter Value-Sets hinzugefügt werden
https://wiki.hl7.at/index.php?title=ART-
- [DECOR_Governance&stable=0&redirect=no#Root_OIDs_f.C3.BCr_Value_Sets Root OIDs für Value Sets]
- Namenskonventionen für die Erstellung neuer Value Sets
9 Testen und Fehlerbehebung (überarbeitet aber komplett übernommen)
Um die Qualität eines Projekts zu überprüfen, können eine Reihe von Prüfungen durchgeführt werden, bevor eine Publikation erstellt wird.
Informationen zu den entsprechenden Funktionalitäten des ART Project Editors finden Sie unter Preflighting publication and quality checks.
9.1 Workflow Decor Prüfung
Die Decor Prüfung testet, ob das Projektschema gültig ist und Schematronregeln erstellt werden können.
Menü Projekt – Entwicklung:
- "Decor prüfen": Prüfung über gesamtes Modell
- "Optionale Prüfungen konfigurieren": alle Optionen auswählen
- Schema und Schematron-Prüfung durchführen, eventuelle Fehler werden aufgelistet.
10 Schematron erstellen (überarbeitet aber komplett übernommen: https://confluence.elga.gv.at/display/SCC/Schematron-Erstellung+und+Bereitstellung)
Generell gilt:
- Mithilfe von ISO Schematron kann geprüft werden, ob ein gültiges HL7 CDA Dokument (HL7 v3) vorliegt, während eine XSD-Schemaprüfung, nur prüft ob ein gültiges XML Dokument vorliegt.
- Aus den modellierten Templates können über Art-Decor automatisch Schematronregeln generiert werden.
- Wenn zusätzliche Geschäftsregeln geprüft werden sollen, die nicht in den Templates modelliert sind, müssen die dazu notwendigen Asserts von Hand eingetragen werden (z.B. Logik: Schwangerschaftsstatus, prüfen ob Impfempfehlung in diesem Jahr noch gültig).
- Informationen zu den entsprechenden Art-Decor Tool finden Sie unter Live Runtime Compile (LRC).
- Es wird empfohlen, bereits während der Modellierung regelmäßig eine Kompilierung durchzuführen (z.B. nachdem ein DLT mit Header und noch leerem structuredBody erstellt wurde), um zu testen, ob das Projektschema noch gültig ist.
- Art-Decor bietet die Möglichkeit nach korrekter Schematron-Generierung ein Beispieldokument zu prüfen.
10.1 Workflow Schematron erzeugen
Menü Projekt – Entwicklung:
- "Compiliere Entwicklungsversion":
- "Optionale Prüfungen konfigurieren": Optionen "Force recompile", "Explicit includes", "Schematron geschlossen" (falls gewünscht)
- Bei jeder Compilierung entsteht eine neuer Listeneintrag, das zip-File kann gespeichert werden um lokal Beispieldokumente zu validieren -> Achtung, nur die jeweils letzten beiden Versionen bleiben zum Download verfügbar!
- Nach Publikation soll nur die letzte, gültige Schematron-Version verfügbar sein (alle restliche können entfernt werden).
11 Asserts erstellen (entfällt)
(TODO: OKU)
12 Beispieldokumente (überarbeitet aber komplett übernommen
12.1 Beispielbokumente erstellen
- Das Gerüst eines Beispieldokuments kann erstellt werden, indem man im entsprechenden DLT den Zauberstab des Template Editors anwendet und rekursiv alle Code-Snippets der darin verlinkten Templates einfügt.
- In jedem Document-Level-Template soll nur ein Verweis auf ein vollständiges Beispieldokument angeführt werden (z.B. auf HL7.at), damit dies bei Bedarf angepasst werden kann. Änderungen im DLT erfordern sonst eine neue Template-ID!
- Beispieldokument sollen immer zuletzt ergänzt werden, um den Aufwand nach Änderungen in Templates gering zu halten.
12.2 Beispieldokumente validieren
Nachdem erfolgreich ein Schematron erstellt wurde, kann unter im Projekt Editor unter "Menü Projekt"–"Entwicklung"-"Compiliere Entwicklungsversion" im aktuellen Listeneintrag die Funktion "XML-Instanz validieren" ausgewählt werden und ein Beispieldokument hochgeladen werden.
13 Publikation (überarbeitet aber komplett übernommen: https://confluence.elga.gv.at/display/SCC/Schematron-Erstellung+und+Bereitstellung)
Informationen zur Publikation eines Leitfadens in Art-Decor finden Sie unter Creating a new version / release / publication request.
TODO