Kommentierung und Pflege EFA v2.0

Aus Hl7wiki
Implementierungsleitfaden
Wechseln zu: Navigation, Suche
(→‎Verfahren der Kommentierung {Keie.03})
(→‎Verfahren der Kommentierung)
 
(9 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
 
{{Infobox Dokument
 
{{Infobox Dokument
−
|Title    = Kommentierung EFA v2.0 (April/Mai 2013)
+
|Title    = Kommentierung und Pflege EFA v2.0
−
|Short    = Kommentierung EFA v2.0 (April/Mai 2013)
+
|Short    = Kommentierung und Pflege EFA v2.0
 
|Namespace = cdaefa
 
|Namespace = cdaefa
 
|Type      = Implementierungsleitfaden
 
|Type      = Implementierungsleitfaden
Zeile 15: Zeile 15:
 
}}
 
}}
  
 +
= Kommentierungsverfahren zur EFA 2.0 Spezifikation =
  
−
== Gegenstand der Kommentierung {Keie.01} ==
+
== Gegenstand der Kommentierung ==
−
Die Spezifikation der elektronischen Fallakte in der Version 2.0 wird über das HL7-Wiki unter der Seite ''[[cdaefa:EFA_Spezifikation_v2.0|EFA-2.0-Spezifikation]]'' veröffentlicht. Die Spezifikation umfasst die Darstellung der Grundkonzepte der EFA, die plattformunabhängige Spezifikation von Informationsobjekten und Diensten sowie die Abbildung dieser logisch-funktionalen Spezifikationen auf IHE Profile. Nicht Gegenstand der EFAv2.0 Spezifikation sind ein Sicherheits- und Datenschutzkonzept. Hier gelten zunächst die entsprechenden Dokumente der EFA-Version 1.2 fort.  
+
<tt>Bitte markieren Sie [[cdaefa:Kommentierung_EFAv2.0|Kommentare]] zu diesem Abschnitt mit dem Code {Keie.01.01}</tt>
  
−
Die EFAv2.0 Spezifikation wird in drei Sichten angeboten:
+
Die Spezifikation der elektronischen Fallakte in der Version 2.0 wird über das HL7-Wiki unter der Seite ''[[cdaefa:EFA_Spezifikation_v2.0|EFA-2.0-Spezifikation]]'' veröffentlicht. Die Spezifikation umfasst die Darstellung der Grundkonzepte der EFA, die plattformunabhängige Spezifikation von Informationsobjekten und Diensten sowie die Abbildung dieser logisch-funktionalen Spezifikationen auf IHE Profile. Nicht Gegenstand der EFAv2.0 Spezifikation sind ein Sicherheits- und Datenschutzkonzept. Hier gelten zunächst die entsprechenden Dokumente der EFA-Version 1.2 fort.
−
* [[cdaefa:EFA_Spezifikation_v2.0|modularisiert innerhalb der Matrix des HL7 ECCF Frameworks]] zur Online-Kommentierung
 
−
* [[IG:EFA_Spezifikation_v2.0|sequentialisiert als einzelne Web-Seite]] zum Ausdrucken und Offline-Kommentieren
 
−
* sequentialisiert als PDF-Dokument zum Ausdrucken und Offline-Kommentieren
 
−
Alle drei Sichten sind inhaltlich identisch und können gleichwertig zur Kommentierung genutzt werden.
 
  
−
== Rahmendaten der Kommentierung {Keie.02} ==
+
== Verfahren der Kommentierung ==
 +
<tt>Bitte markieren Sie [[cdaefa:Kommentierung_EFAv2.0|Kommentare]] zu diesem Abschnitt mit dem Code {Keie.01.03}</tt>
  
−
Die Kommentierungsfrist beginnt am '''22. April 2013''' und endet am '''31. Mai 2013'''. Die Kommentierung wird über verschiedene Kanäle angekündigt und steht allen Interessierten offen.
+
Im April/Mai 2013 wurde von EFA-Verein und bvitg eine öffentliche Kommentierung der EFAv2.0-Spezifikation durchgeführt. Die Ergebnisse dieser Kommentierung wurden gegenkommentiert und soweit akzeptiert in die Spezifikation übernommen. Der [[EFAv2_Freeze_131118|EFAv2.0-''Freeze'' vom 18.11.2013]] gibt den Stand der Spezifikation mit allen aus dieser Kommentierung resultierenden Änderungen wieder.
  
−
Die Bearbeitung der Kommentare erfolgt in 2 Stufen:
+
Alle laufenden und geplanten Implementierungen der EFAv2.0-Spezifikation basieren auf dem EFAv2.0-''Freeze'' vom 18.11.2013 (Single-Peer). Es ist davon auszugehen, dass im Rahmen der Implementierungen noch unklare Formulierungen, Spezifikationslücken und auch kleinere Fehler entdeckt werden.  
−
# editorischen Anmerkungen und unstrittige Korrekturvorschläge werden vom Editorenteam der Spezifikation (Fraunhofer FOKUS) bis Ende Juni in die Spezifikation eingearbeitet.
 
−
# Kommentare, die einer inhaltlichen Abstimmung zwischen bvitg und EFA-Verein bedürfen, werden parallel hierzu in Workshops der 7er-Gruppe (Städt. Klinikum München, Fraunhofer FOKUS, ICW, Siemens, Marabu, CGM, Agfa, ZTG) diskutiert. Es wird angestrebt, bis Ende Juli zu einem Einvernehmen bezüglich dieser Kommentare zu kommen.
 
  
−
Die fachlich-technisch abgestimmte Spezifikation wird nach Bearbeitung der Kommentare dem EFA-Verein zur Freigabe vorgelegt. Dieser gibt in Abstimmung mit dem bvitg die Spezifikation im Status "for Trial Implementation" zur Implementierung durch die Hersteller frei.
+
Sollte Ihnen im Rahmen einer EFAv2.0-Implementierung in der Spezifikation eine solche Spezifikationslücke oder auch ein Fehler in der Spezifikation auffallen, so melden Sie dieses bitte per eMail an mailto:joerg.caumanns@fokus.fraunhofer.de. Bitte beachten Sie dabei folgende Hinweise:
 +
* Der Textabschnitt, auf den sich ein Kommentar bezieht, muss eindeutig benannt werden. Als Referenz wird ausschließlich das Kürzel verwendet, das in geschweiften Klammern unter der Überschrift des Textabschnitts angegeben ist. Beispielsweise würde ein Kommentar zu diesem Abschnitt die Referenz "{Keie.03}" tragen.
 +
* Bitte verzichten Sie auf die Angabe von Zeilennummern und verwenden Sie ausschließlich die Codes unter den Überschriften, um einzelne Textabschnitte zu referenzieren.
 +
Der Eingang der Kommentare wird innerhalb von 48 Stunden bestätigt.
  
−
== Verfahren der Kommentierung {Keie.03} ==
+
== Laufende Pflege der Spezifikation ==
−
 
+
Mit Ausnahme der Erweiterung um das Peer-to-Peer-Szenario sollen an der Spezifikation ab 18.11.13 keine inhaltlichen Änderungen vorgenommen werden. Lediglich die folgenden Änderungen an den Texten der Spezifikation werden im Rahmen der laufenden Pflege durchgeführt:
−
Die Durchführung der Kommentierung soll für alle Beteiligten möglichst einfach und effizient sein. Daher werden nur rudimentäre Vorgaben an die Form der Kommentierung gemacht und alternative Möglichkeiten zur Abgabe der Kommentare angeboten. Die wenigen, in jedem Fall zu beachtenden Regeln sind:
+
* Umsetzung von Rückmeldungen aus den EFAv2.0-Implementierungen, die für alle Implementierer relevante Spezifikationslücken und Fehler betreffen
−
* Der Textabschnitt, auf den sich ein Kommentar bezieht, muss eindeutig benannt werden. Als Referenz wird ausschließlich das Kürzel verwendet, das in geschweiften Klammern hinter der Überschrift des Textabschnitts angegeben ist. Beispielsweise würde ein Kommentar zu diesem Abschnitt die Referenz "{Keie.03}" tragen.
+
* Berichtigung von Schreib- und Kommafehlern
−
* allgemeine Anmerkungen und editorische Kommentare werden nicht speziell hervorgehoben. Fachliche und technische Kommentare werden als Fettdruck hervorgehoben. Eine weiter gehende Klassifizierung ist nicht gewünscht.
+
* Verbesserung der Qualität von Grafiken (offensichtlich funktioniert die freie Skalierung von in Powerpoint erzeugten PNG nicht so gut)
−
 
+
* Ergänzen von Querverweisen und Korrigieren toter Links
−
Es sind zwei Verfahren zur Einreichung der Kommentare vorgesehen, die gleichwertig genutzt werden können:
+
* im Rahmen der Kommentierung angeregte kleinere Umstrukturierungen, um Lesbarkeit und Zugang zu verbessern (siehe [[cdaefa:EFA_Spezifikation_v2.0#ToDos_aus_der_Kommentierung_.28Fraunhofer.29|ToDos aus der Kommentierung]])
−
# Personen, die über einen Account zum HL7 Wiki verfügen, können Kommentare über die Lasche "Diskussion" direkt an die beanstandete Seite binden. Klicken Sie auf die [[cdaefa_Diskussion:Kommentierung_EFAv2.0|Lasche "Diskussion" zu dieser Seite]] für ein Beispiel, das auch die Umsetzung der oben dargestellten Kommentierungskonventionen verdeutlicht.
 
−
# Für alle anderen Personen wird ein Kommentarformular zur Verfügung gestellt. Dieses kann hier abgerufen werden. Das ausgefüllte Formular muss bis zum 31.5.13 an '''joerg.caumanns@fokus.fraunhofer.de''' geschickt werden. Der Eingang der Kommentare wird innerhalb von 48 Stunden bestätigt.
 
  
 
=== Querverweise und Referenzen ===
 
=== Querverweise und Referenzen ===
  
 
* [[cdaefa:EFA_Spezifikation_v2.0|EFA-2.0-Spezifikation]]
 
* [[cdaefa:EFA_Spezifikation_v2.0|EFA-2.0-Spezifikation]]
 +
* [[cdaefa:EFA_Kommentierung_Referenzkuerzel|Liste der Referenz-Kürzel der EFA-2.0-Spezifikation]]

Aktuelle Version vom 18. November 2013, 08:53 Uhr

Logo-hl720.jpg
Kommentierung und Pflege EFA v2.0
Kommentierung und Pflege EFA v2.0
Implementierungsleitfaden
vorgelegt von:
February 2013
Jörg Caumanns, Raik Kuhlisch
Draft
Version: 0.9
Datum: March 2013
Status: xxx
Verfahren: {{{Verfahren}}}
Realm: Flag de.svg Deutschland
Copyright © 2012-2013: HL7 Deutschland


Kommentierungsverfahren zur EFA 2.0 Spezifikation

Gegenstand der Kommentierung

Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Keie.01.01}

Die Spezifikation der elektronischen Fallakte in der Version 2.0 wird über das HL7-Wiki unter der Seite EFA-2.0-Spezifikation veröffentlicht. Die Spezifikation umfasst die Darstellung der Grundkonzepte der EFA, die plattformunabhängige Spezifikation von Informationsobjekten und Diensten sowie die Abbildung dieser logisch-funktionalen Spezifikationen auf IHE Profile. Nicht Gegenstand der EFAv2.0 Spezifikation sind ein Sicherheits- und Datenschutzkonzept. Hier gelten zunächst die entsprechenden Dokumente der EFA-Version 1.2 fort.

Verfahren der Kommentierung

Bitte markieren Sie Kommentare zu diesem Abschnitt mit dem Code {Keie.01.03}

Im April/Mai 2013 wurde von EFA-Verein und bvitg eine öffentliche Kommentierung der EFAv2.0-Spezifikation durchgeführt. Die Ergebnisse dieser Kommentierung wurden gegenkommentiert und soweit akzeptiert in die Spezifikation übernommen. Der EFAv2.0-Freeze vom 18.11.2013 gibt den Stand der Spezifikation mit allen aus dieser Kommentierung resultierenden Änderungen wieder.

Alle laufenden und geplanten Implementierungen der EFAv2.0-Spezifikation basieren auf dem EFAv2.0-Freeze vom 18.11.2013 (Single-Peer). Es ist davon auszugehen, dass im Rahmen der Implementierungen noch unklare Formulierungen, Spezifikationslücken und auch kleinere Fehler entdeckt werden.

Sollte Ihnen im Rahmen einer EFAv2.0-Implementierung in der Spezifikation eine solche Spezifikationslücke oder auch ein Fehler in der Spezifikation auffallen, so melden Sie dieses bitte per eMail an mailto:joerg.caumanns@fokus.fraunhofer.de. Bitte beachten Sie dabei folgende Hinweise:

  • Der Textabschnitt, auf den sich ein Kommentar bezieht, muss eindeutig benannt werden. Als Referenz wird ausschließlich das Kürzel verwendet, das in geschweiften Klammern unter der Überschrift des Textabschnitts angegeben ist. Beispielsweise würde ein Kommentar zu diesem Abschnitt die Referenz "{Keie.03}" tragen.
  • Bitte verzichten Sie auf die Angabe von Zeilennummern und verwenden Sie ausschließlich die Codes unter den Überschriften, um einzelne Textabschnitte zu referenzieren.

Der Eingang der Kommentare wird innerhalb von 48 Stunden bestätigt.

Laufende Pflege der Spezifikation

Mit Ausnahme der Erweiterung um das Peer-to-Peer-Szenario sollen an der Spezifikation ab 18.11.13 keine inhaltlichen Änderungen vorgenommen werden. Lediglich die folgenden Änderungen an den Texten der Spezifikation werden im Rahmen der laufenden Pflege durchgeführt:

  • Umsetzung von Rückmeldungen aus den EFAv2.0-Implementierungen, die für alle Implementierer relevante Spezifikationslücken und Fehler betreffen
  • Berichtigung von Schreib- und Kommafehlern
  • Verbesserung der Qualität von Grafiken (offensichtlich funktioniert die freie Skalierung von in Powerpoint erzeugten PNG nicht so gut)
  • Ergänzen von Querverweisen und Korrigieren toter Links
  • im Rahmen der Kommentierung angeregte kleinere Umstrukturierungen, um Lesbarkeit und Zugang zu verbessern (siehe ToDos aus der Kommentierung)

Querverweise und Referenzen

Abgerufen von „https://wiki.hl7.de/index.php?title=cdaefa:Kommentierung_EFAv2.0&oldid=16233“