Änderungen

Wechseln zu: Navigation, Suche

Hilfe:Art-Decor Leitfadenerstellung

1.341 Bytes hinzugefügt, 14:05, 18. Nov. 2019
Generelle Hinweise für die Erstellung von Templates
* Optionalitäten und Reihenfolge der Elemente müssen eigenhalten werden
:Hinweis: Wenn ein Template laut IHE "required" ist, aber für die Anwendung in Österreich 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 IHE-Template kann trotzdem verwenden zu können (Interoperabilität!).
 
====Übernahme von bestehenden Templates====
Bevor ein neues Template erstellt wird, alle Templates auflisten lassen (alle Projekte: Governance-Seite, sonst BBr), und deren Wiederverwendbarkeit prüfen bzw. welche OID als nächstes vergeben werden kann.
* Herausfinden, welche Projekte bereits das Template umgesetzt haben: im „Auge“ (ganz links im ArtDecor), die TemplateID oder Name angeben -> alle Templates mit zugehörigem Projekt werden aufgelistet:
:* Übernahme vorhandener Templates aus verlinkten Projektverzeichnissen:
::* Referenzieren (keine Änderung des Inhaltes möglich): Nur verwenden, wenn es bereits ein passendes ELGA-Template gibt (Kettensymbol)
::* Kopieren und Ändern eines Templates: Ein passendes Template wird via „+“-Symbol als Prototyp angegeben, das spezifiziert werden muss (neue OID).
:* Übernahme vorhandener Templates aus Projektverzeichnissen, die NICHT verlinkt sind:
::* Zuerst neues Template „from scratch“ anlegen:
:::* Mit „+“ neues Template erstellen, „from scratch“ auswählen (Name, DisplayName, Version, OID angeben -> Konvention!), im Template via Temple öffnen
Dann
:::* die OID der Template-Vorlage via Browser-Direktlink öffnen und von dort kopieren: https://art-decor.org/temple/modules/temple.xquery?id=[ANGABE_OID] und in das neue Template einfügen
 
 
====Änderung bestehender Templates====
* Nur Templates die sich noch im Status [[ART-DECOR_Governance#Artefaktstatus|'''Entwurf''']] befinden können bearbeitet werden. Sollte das Template bereits produktiv sein ("active"), finden Sie Informationen unter [[Hilfe:Art-Decor_Leitfadenerstellung#Versionierung|'''Versionierung''']].
* Der '''Name''' eines Templates (nicht der Anzeigename!) kann später 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 '''ungültig'''! Daher vor der Änderung der OID die Liste aller referenzierenden Templates abspeichern und diese hinsichtlich der neuen OID anpassen!
====Erstellung neuer Templates====
* Wenn neue Templates erstellt werden, 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 Governance Seite aufrufen und alle bestehenden Templates auflisten lassen, sodass deren Wiederverwendbarkeit geprüft werden und Nachschau gehalten werden, welche OID als nächstes vergeben werden darf. Wenn möglich, aus vorhandenen Templates ableiten!
* Templates anderer Projekte, welche im eigenen Projekt nicht referenziert werden, können nicht als Prototyp angegeben werden (d.h. von ihnen kann nicht geerbt werden). Soll der Inhalt eines Templates trotzdem verwendet werden, empfiehlt sich folgende Vorgehensweise: Mittels Link
:<code><nowiki>https://art-decor.org/temple/modules/temple.xquery?id=[OID des Templates]</nowiki></code>
: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.
 
====Ableitung von bestehenden Templates====
Bevor ein neues Template erstellt wird, alle Templates auflisten lassen (alle Projekte: Governance-Seite, sonst BBr), und deren Wiederverwendbarkeit prüfen bzw. welche OID als nächstes vergeben werden kann.
 
====Änderung bestehender Templates====
* Nur Templates die sich noch im Status [[ART-DECOR_Governance#Artefaktstatus|'''Entwurf''']] befinden können bearbeitet werden. Sollte das Template bereits produktiv sein ("active"), finden Sie Informationen unter [[Hilfe:Art-Decor_Leitfadenerstellung#Versionierung|'''Versionierung''']].
* Der '''Name''' eines Templates (nicht der Anzeigename!) kann später 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 '''ungültig'''! Daher vor der Änderung der OID die Liste aller referenzierenden Templates abspeichern und diese hinsichtlich der neuen OID anpassen!
===Inhalte von Templates===
3.869
Bearbeitungen

Navigationsmenü