Hilfe:Leitfaden erstellen

FlaggedTest Testtest Mit dem Wiki Portal von HL7 Austria wird das Ziel verfolgt, alle Implementierungsleitfäden und dazugehörige Dokumente, Terminologien, Templates und sonstiges im Wiki verfügbar zu machen. Um einen Leitfaden zu veröffentlichen, sind eine Reihe von Voraussetzungen zu erfüllen und die Leifäden bzw. die zugehörigen Teildokumente müssen nach bestimmten Kriterien erstellt werden, um als Leitfäden oder Teilen davon erkannt zu werden und um die Extraktionsmöglichkeit als PDF-Dokument zu ermöglichen.

1 Wiki-Hilfe

Das Wiki bietet selbst eine Einführung, wie grundsätzlich mit einem Wiki gearbeitet wird und welche Markups zur Verfügung stehen: How-to-Wiki

1.1 Neue Seite anlegen

Von einer bestehenden Seite aus kann mit folgender Syntax eine neue Seite angelegt werden:

[[NeueSeite]]

Sollen sich der Text des Links und der Seitenname unterscheiden muss folgender Code benutzt werden:

[[NeueSeite | Sichtbarer Text]]

1.2 Konfiguration

Alle Seiten des Wiki unterliegen dem Flagged Revisions Verfahren, das es ermöglicht, Seitenversionen zu markieren sowie eine stabile Seitenversion festzulegen (https://www.mediawiki.org/wiki/Extension:FlaggedRevs). Die Seiten werden abschließend von so genannten Sichtern freigegeben.

Leitfäden sind meist lange Dokumente. Es ist deshalb sinnvoll, diese in Teildokumente zu unterteilen, die dann zu einem einzigen Leitfaden zusammengefügt werden.

1.2.1 Hauptdokument

Das Hauptdokument enthält folgende verpflichtend anzugebenden Teile:

• eine Infobox
• die Bekanntgabe, das sich der Leitfaden in Bearbeitung befindet
• Formatierung von Strukturbeispielen und dem Inhaltsverzeichnis
• die trankludierten separat angelegten Abschnitte und Namespaces

Optional stehen folgende Funktion bereit:

• Vergabe eines benutzerdefinierten Titels
• Suchmaschinenoptimierung

Beispiel:

{{#seo:
|title=Entlassungsbrief (Ärztlich)
|titlemode=append
|keywords= Entlassungsbrief,Entlassungsbrief Ärztlich,Ärztlicher Entlassungsbrief,CDA, Leitfaden, Leitfäden, Spezielle Leitfäden, Arzt, Krankenhaus, Informationsausstausch, Gesundheitsdienstleitster, GDA, Medizin, Patienten
|description=Ein Entlassungsdokument enthält die medizinisch relevanten Teile der Geschichte eines Patienten und ist für den Informationsaustausch zwischen Gesundheitsdienstleistern bestimmt. 
}}
{{#customtitle:Entlassungsbrief (Ärztlich)}}

{{Underconstruction}}
 <!--

         Implementierungsleitfaden "Entlassungsbrief (Ärztlich)"
 >

{{#css:
@media screen{
.orange{
   border: thin black solid;
   background-color:#F4C789;
   padding: 5px 5px 5px 5px;
   margin-left:6px;
   width:70%;
}
.violet{
   border: thin black solid;
   background-color:#E5D0EE;
   padding: 5px 5px 5px 5px;
   margin-left:6px;
   width:70%;
}
.toc{
    width: 20%;
    float: right !important;
    margin: 10px 0px 10px 30px !important;
    border: 1px solid #AAA;
    background-color: #F9F9F9;
    display: table;
    padding: 7px !important;
}
}
}}

{{Infobox Dokument
|Group     = ELGA CDA<br/>Implementierungsleitfäden
|Title     = HL7 Implementation Guide for CDA<sup>®</sup> R2:<br/>Entlassungsbrief (Ärztlich)
|Subtitle  = Zur Anwendung im österreichischen<br/>Gesundheitswesen [1.2.40.0.34.7.1.6.2]
|Short     = Entlassungsbrief (Ärztlich) 
|Namespace = elga-cdaea-2.06.2
|Type      = Implementierungsleitfaden
|Version   = 2.06.2
|Submitted = HL7 Austria
|Date      = 20. März 2017
|Copyright = 2017-2021
|Status    = Entwurf
|Period    = n.a.
|OID       = n.n.
|Realm     = Österreich
}}

 <!--
{{Infobox Contributors Begin}}
{{Contributor | Logo = Logo.jpg | Name = Abc | Location = Hürth }}
{{Infobox Contributors End}}
 >

=Informationen über dieses Dokument=
{{ILF:Allgemeines}}
{{ILF:Verbindlichkeit}}
{{ILF:Zielgruppe}}
{{ILF:Hinweis auf verwendete Grundlagen}}
{{ILF:Danksagung}}
{{ILF:Hinweise zur Nutzung des Leitfadens}}
.
.
.

1.2.2 Teildokumente

Jedes Teildokument enthält den eigentlichen Text. Zu beachten ist, dass Teildokumente in einem eigenen Namespace pro Leitfaden (Teildokumenten-Namespace) unterzubringen sind.
Beispiel: Inhalt des Dokuments elga-cdaalf-2.06.2:Harmonisierung

=Harmonisierung=
'''Erarbeitung des Implementierungsleitfadens''' <br/>
Dieser Implementierungsleitfaden entstand durch die Harmonisierungsarbeit der „Arbeitsgruppe“ in den Jahren 2008-2012, bestehend aus nachfolgend genannten Personen:

1.2.3 Typische Gliederung eines Dokuments

Ein typischer Leitfaden hat die folgenden Abschnitte bzw. Kapitel:

• Informationen über dieses Dokument
  • Allgemeines
  • Sprachliche Gleichbehandlung
  • Verbindlichkeit
  • Zielgruppe
  • Hinweis auf verwendete Grundlagen
  • Danksagung
  • Hinweise zur Nutzung des Leitfadens
  • Revisionsliste
  • Weitere unterstützende Materialien
  • Bedienungshinweise
  • Impressum
• Harmonisierung
• Einleitung
  • Ausgangssituation
  • Zweck
  • Hierarchie der Implementierungsleitfäden
• Anwendungsfälle
• Administrative Daten (CDA Header)
• Fachlicher Inhalt (CDA Body)
• Technische Konformitätsprüfung
  • Schema-Prüfung
  • Schematron-Prüfung
  • Online-Validation von CDA-Dokumenten
• Anhang
  • Referenzen
  • Revisionsliste

1.2.4 Benutzerdefinierter Titel

Ermöglicht das Ändern des Seitentitels mittels:

{{#customtitle:Neuer Titel}}

1.2.5 SEO

SEO ist eine Maßnahme, um das Ranking in Suchmaschinen zu optimieren.
Code:

{{#seo:
|title=LOINC
|titlemode=append
|keywords= Leitfaden, Leitfäden, LOINC, ELGA, Arzt, Krankenhaus, Informationsausstausch, Gesundheitsdienstleitster, GDA, Medizin, Patienten
|description=Dieser Leitfaden erklärt das Vorgehen beim „Mapping“, der korrekten Zuordnung von lokalen Laborcodes zu den standardisierten Codes für ELGA
}}

1.2.6 Under Construction

Um eine Seite visuell als "In Bearbeitung" zu Kennzeichnen wird folgender Code verwendet:

{{Underconstruction}}

1.2.7 Formatierungen

Damit das Inhaltsverzeichnis rechts aufscheint und die Strukturbeispiele richtig formatiert sind, muss folgender Code eingefügt werden:

{{#css:
@media screen{
.orange{
   border: thin black solid;
   background-color:#F4C789;
   padding: 5px 5px 5px 5px;
   margin-left:6px;
   width:70%;
}
.violet{
   border: thin black solid;
   background-color:#E5D0EE;
   padding: 5px 5px 5px 5px;
   margin-left:6px;
   width:70%;
}
.toc{
    width: 20%;
    float: right !important;
    margin: 10px 0px 10px 30px !important;
    border: 1px solid #AAA;
    background-color: #F9F9F9;
    display: table;
    padding: 7px !important;
}
}
}}

1.2.8 Infobox

Jeder Leitfaden beginnt mit einer Infobox, die alle zur Erstellung der Druckversion im PDF Format notwendigen Informationen enthält. Sie ist in der Online-Version nicht sichtbar.

{{Infobox Dokument
|Group     = ELGA GmbH<br/>Leitfaden zur Verwendung von LOINC<sup>®</sup>
|Title     = im ELGA CDA<sup>®</sup> R2 Laborbefund
|Subtitle  = Zur Anwendung im österreichischen<br/>Gesundheitswesen [1.2.40.0.34.10.1]
|Short     = Leitfaden zur Verwendung von LOINC 
|Namespace = elga-loinc-1.03
|Type      = Implementierungsleitfaden
|Version   = 1.03
|Submitted = HL7 Austria
|Date      = 07. Februar 2017
|Copyright = 2017-2021
|Status    = Gültig
|Period    = n.a.
|OID       = n.n.
|Realm     = Österreich
}}

Für die Erstellung des PDF-Dokuments werden die Werte für Group, Title, Subtitle, Date, Version und Status übernommen. Die anderen Felder werden zurzeit nicht genutzt.

1.2.9 Kapitelstruktur

Der Leitfaden wird in einzelne Abschnitte unterteilt, für die jeweils ein eigenes Namespace im Wiki angelegt wird. Diese Namespaces werden in das Hauptdokument transkludiert. Auf der Hauptseite des Leitfadens werden alle Namespaces inkludiert.

Folgende Kategorien sind derzeit in Gebrauch:

• Allgemeiner Leitfaden: Elga-cdaalf-2.06.2
• XDS Metadaten: Elga-cdaxds-2.06.2
• Entlassungsbrief (Ärztlich): Elga-cdaea-2.06.2
• Entlassungsbrief (Pflege): Elga-cdaep-2.06.2
• Pflegesituationsbericht: Elga-cdapsb-2.06.2
• E-Medikation: Elga-cdaem-2.06.2
• Laborbefund: Elga-cdalab-2.06.2
• Laborbefund Version 2.06.03: Elga-cdalab-2.06.3
• Befund Bildgebende Diagnostik: Elga-cdabgd-2.06.2
• Patient Summary: Elga-cdaps-2.06.2

2 Anwendungsfälle

Dieses Kapitel beschreibt die Anwendungsfälle, welche für die Ermittlung der Anforderungen hinsichtlich der Struktur der in den folgenden Kapiteln dieses Implementierungsleitfadens beschriebenen Entlassungsbriefe herangezogen wurden.

2.1 Anwendungsfall ENTL01: „Entlassung aus dem stationären Bereich“

2.1.1 Allgemeines

Dieser Anwendungsfall beschreibt die Entlassung eines Patienten nach dem stationären Aufenthalt² in einer Krankenanstalt.

Die Entlassung des Patienten kann entweder „nach Hause“ oder in eine weiterbehandelnde stationäre Einrichtung (z.B. Rehabilitations-Zentrum) erfolgen.

Die Dokumentation des Aufenthalts in den Entlassungspapieren beinhaltet Informationen für den Patienten selbst, sowie eventuell weiterbehandelnde Gesundheitsdienstleister oder Pflegedienste. Somit setzt sich die Dokumentation aus einer „ärztlichen“ und einer „pflege-relevanten“ Komponente zusammen.

2.1.2 Ergebnisse bei Erfolg

Die ärztlichen und pflege-relevanten Entlassungsbriefe liegen in Form von CDA Dokumenten vor. Die CDA Dokumente sind sowohl zum Implementierungsleitfaden „CDA Dokumente im österreichischen Gesundheitswesen“ als auch zu diesem Implementierungsleitfaden konform.

Die Dokumente sind bereit in ein ELGA Dokumentenregister eingebracht zu werden.

2.1.3 Vorbedingungen und Voraussetzungen

• Krankenhausinformationssystem ist bereit CDA Dokumente konform zu den Implementierungsleitfäden herzustellen

2.1.4 Akteure

• Für die ärztliche Entlassungsdokumentation
  • Verfasser (Inhaltlicher Ersteller, „Autor“) Vidierender Arzt (Rechtlich Verantwortlicher)
• Für die Pflege-Entlassungsdokumentation
  • Vidierende Person (Gehobener Dienst für Gesundheits- und Krankenpflege), (Rechtlich Verantwortlicher)
• Medizinisches Dokumentationssystem (z.B. Krankenhausinformationssystem)

2.1.5 Auslöser/Trigger

• Patient wird nach einem stationären Aufenthalt entlassen

2.1.6 Relevanz zum vorliegenden Dokument

Das vorliegende Dokument behandelt nur den ärztlichen Teil der Entlassungsbriefe.

Für die Pflege-Entlassungsbriefe sehen Sie bitte den entsprechenden Leitfaden „HL7 Implementation Guide for CDA® R2: Entlassungsbrief (Pflege)“.

² Auch tagesklinische Aufenthalte werden zu den stationären Aufenthalten gezählt. Bei zeitlich begrenzten Serien von tagesklinischen Aufenthalten (z.B. Chemotherapiezyklus) kann ein Entlassungsbrief am Ende der Serie erstellt werden. Bei zeitlich unbegrenzten Serien von Tageskliniken-Aufenthalten (zB psychiatrische Versorgung, HIV-Therapie) empfiehlt es sich, nach jeweils drei Monaten einen Entlassungsbrief zu erstellen.