ART-DECOR Governance: Unterschied zwischen den Versionen
[unmarkierte Version] | [unmarkierte Version] |
(→OIDs) |
(→Art-Decor) |
||
Zeile 130: | Zeile 130: | ||
In a repository, artefacts shall be initially created in the status 'draft'. When finished, reviewed and endorsed, an artefact’s status can be changed in the repository according the rules of the responsible governance group (see [https://art-decor.org/mediawiki/index.php?title=ART_Template_Editor Art-Decor.org/Template Editor] for the Art-Decor default state/event diagram). Chapter [[#Repositories]] contains the description of the detailed process and responsibilities. | In a repository, artefacts shall be initially created in the status 'draft'. When finished, reviewed and endorsed, an artefact’s status can be changed in the repository according the rules of the responsible governance group (see [https://art-decor.org/mediawiki/index.php?title=ART_Template_Editor Art-Decor.org/Template Editor] for the Art-Decor default state/event diagram). Chapter [[#Repositories]] contains the description of the detailed process and responsibilities. | ||
− | === | + | === Namenskonventionen === |
− | === | + | === Versions-Label === |
Im Version-Label wird prinzipiell die Jahrzahl der Verabschiedung des Templates resp. Value-Sets resp. Datasets etc. eingetragen. Sollte die Angabe des Jahres nicht ausreichend sein, wird sie mit .Monat ergänzt. Dito für Tagesaktuelle Versionen. | Im Version-Label wird prinzipiell die Jahrzahl der Verabschiedung des Templates resp. Value-Sets resp. Datasets etc. eingetragen. Sollte die Angabe des Jahres nicht ausreichend sein, wird sie mit .Monat ergänzt. Dito für Tagesaktuelle Versionen. | ||
Beispiele: | Beispiele: | ||
Zeile 140: | Zeile 140: | ||
==== Templates ==== | ==== Templates ==== | ||
− | |||
+ | Die Namen von Templates werden wie folgt angegeben: | ||
+ | |||
+ | [Präfix]_[Template-Typ]_[ElementName] | ||
+ | |||
+ | [Präfix]: Als Präfix dient das Projektkürzel (Name des Repositories) | ||
+ | [Template-Typ]: Der Template-Typ kann | ||
* document | * document | ||
* header | * header | ||
Zeile 147: | Zeile 152: | ||
* entry | * entry | ||
* other | * other | ||
+ | enthalten. | ||
+ | [ElementName]: wird in CamelCase-Notation angegeben. | ||
+ | Als Trenner fungieren Unterstriche "_". | ||
− | + | Beispiele: | |
+ | - Template im BBR: | ||
+ | Name: elga_section_ImpfempfehlungenKodiert | ||
+ | DisplayName: Impfempfehlungen - kodiert | ||
− | + | - Template aus dem Projekt eImpfpass: | |
Name: eimpf_document_KompletterImpfstatus | Name: eimpf_document_KompletterImpfstatus | ||
DisplayName: Kompletter Impfstatus | DisplayName: Kompletter Impfstatus |
Version vom 29. Januar 2019, 16:33 Uhr
Inhaltsverzeichnis
- 1 Summary
- 2 Introduction
- 3 Richtlinien
- 4 Governance
- 5 Annex
1 Summary
TODO
1.1 Guidelines
TODO
1.2 Governance
TODO
2 Introduction
2.1 Purpose
TODO
2.2 Scope
TODO
2.3 Process of developing
TODO
2.4 Evolving document
TODO
3 Richtlinien
3.1 Sprache
Die gesamte Dokumentation eines ELGA Implementierungsleitfadens wird grundsätzlich in deutscher Sprache verfasst. Dazu gehören textuelle Beschreibungen im Wiki, Art-Decor-Templates und Datasets.
3.2 OIDs
Im Zusammenhang mit der Verwendung von OIDs sind die österreichischen Richtlinen einzuhalten (Object Identifier (OID) Konzept für das österreichische Gesundheitswesen). Das österreichische OID Portal ist zu finden unter (OID Portal Österreich).
3.2.1 Implementierungsleitfäden
Für jeden Implementierungsleitfaden muss eine OID unterhalb des Knotens 1.2.40.0.34.7 registriert werden. Falls Dokumente in aufeinander aufbauenden Versionen vorliegen, kann dafür darunter eine zusätzliche Ebene angelegt werden.
Beispiel:
- 1.2.40.0.34.7.18: Implementierungsleitfaden Meldung von antimikrobieller Resistenzen
- 1.2.40.0.34.7.18.1: Implementierungsleitfaden Meldung von antimikrobieller Resistenzen - Version 1.00
3.2.2 Art-Decor Root OIDs
Als neuer Root-Knoten für Art-Decor wird 1.2.40.0.34.6.0 (eHealth-Austria/services) verwendet.
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).
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).
3.2.3 Root OIDs for templates
OIDs for Art-Decor templates shall be drawn according to their CDA template types from the corresponding following child nodes:
- .0 Document Level Template
- .1 Header Level Template
- .2 Section Level Template
- .3 Entry Level Template
- .9 other CDA Fragment Template
3.2.4 Versioning of document-level templates
TODO
3.2.5 Versioning of value sets
TODO
3.2.6 OIDs to be registered
TODO
3.3 Art-Decor
3.3.1 Repositories
3.3.1.1 Art-Decor BBR
TODO
3.3.2 Governance Groups
TODO
3.3.2.1 Artefact status in repositories
In a repository, artefacts shall be initially created in the status 'draft'. When finished, reviewed and endorsed, an artefact’s status can be changed in the repository according the rules of the responsible governance group (see Art-Decor.org/Template Editor for the Art-Decor default state/event diagram). Chapter #Repositories contains the description of the detailed process and responsibilities.
3.3.3 Namenskonventionen
3.3.4 Versions-Label
Im Version-Label wird prinzipiell die Jahrzahl der Verabschiedung des Templates resp. Value-Sets resp. Datasets etc. eingetragen. Sollte die Angabe des Jahres nicht ausreichend sein, wird sie mit .Monat ergänzt. Dito für Tagesaktuelle Versionen. Beispiele: 2019 2019.01 2019.01.16
3.3.4.1 Templates
Die Namen von Templates werden wie folgt angegeben:
[Präfix]_[Template-Typ]_[ElementName]
[Präfix]: Als Präfix dient das Projektkürzel (Name des Repositories) [Template-Typ]: Der Template-Typ kann
- document
- header
- section
- entry
- other
enthalten. [ElementName]: wird in CamelCase-Notation angegeben. Als Trenner fungieren Unterstriche "_".
Beispiele: - Template im BBR: Name: elga_section_ImpfempfehlungenKodiert DisplayName: Impfempfehlungen - kodiert
- Template aus dem Projekt eImpfpass: Name: eimpf_document_KompletterImpfstatus DisplayName: Kompletter Impfstatus
3.3.4.2 Value Sets
3.3.4.3 Data Sets
3.3.5 Documentation
3.3.5.1 Templates
TODO
3.3.5.2 Standard references
TODO
3.3.6 Datasets
3.3.6.1 Language
See chapter #Languages for language guidelines.
3.3.6.2 Optionality
TODO
3.3.6.3 Official ELGA implementation guides
3.3.6.4 Minimum Description
TODO
3.3.7 Naming conventions for templates
Bsp:
Name: elga_entry_Impfung
Wiedergabename: Impfung Entry
Versionslabel:2019
3.3.8 Naming conventions for value sets
Bsp:
Name: eimpf_Abrechenbarkeit_VS
Wiedergabename: Abrechenbarkeit VS
Versionslabel:2019
3.4 Mediawiki
3.4.1 Structure of an Implementation Guide
To ensure a consistent approach and display of the implementation guide, the following (minimum, German) structure is recommended:
TODO
3.4.2 Schematic View of Templates
TODO
3.4.3 Revisions
TODO
3.5 Releases
3.5.1 Art-Decor
TODO
3.5.2 Wiki
3.5.2.1 Check before finalizing
Thew folowing checks help to identify possible errors or missing includes from Art-Decor. Templates from other repositories than under the governance from eHealth Suisse need to be imported separatly. Please send the necessary OID and related project information to the Art-Decor Support.
- Perform search for:
- "/dynamic"
- "/static"
- "Cannot find"
- ...
Afterwards: Create a revision according to Wiki revisions.
4 Governance
4.1 Responsibilities
4.1.1 Support for Art-Decor
TODO
4.1.2 Governance Groups
TODO
4.1.3 Repositories
TODO
4.1.4 Wiki
TODO
4.2 Art-Decor artifact states
The following state/event diagram shows the default states and possbile transitions for an artifact within Art-Decor:
[Abbildung 1] Default state diagram for Art-Decor artefacts
Each Governance Group may decide to avoid some of these states. It is not recommended to add new states by a Governance Group.
[Tabelle 1] Art-Decor state machine
4.3 Quality Assurance & Review
4.3.1 Art-Decor Repository
TODO
4.3.2 Implementation Guides
TODO
4.3.3 Official ELGA implementation guides
TODO
5 Annex
5.1 Links
5.2 List of Figures
- ↑ Default state diagram for Art-Decor artefacts
5.3 List of Tables
- ↑ Art-Decor state machine
5.4 List of future definitions
TODO