Kommentierung EFA v2.0 (April/Mai 2013)

Aus Hl7wiki
Implementierungsleitfaden
Wechseln zu: Navigation, Suche
(Rahmendaten der Kommentierung)
(Kommentierungsverfahren zur EFA 2.0 Spezifikation)
Zeile 22: Zeile 22:
 
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.
 
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.
  
== Rahmendaten der Kommentierung ==
+
== Verfahren der Kommentierung ==
<tt>Bitte markieren Sie [[cdaefa:Kommentierung_EFAv2.0|Kommentare]] zu diesem Abschnitt mit dem Code {Keie.01.02}</tt>
+
<tt>Bitte markieren Sie [[cdaefa:Kommentierung_EFAv2.0|Kommentare]] zu diesem Abschnitt mit dem Code {Keie.01.03}</tt>
 
 
Die Kommentierungsfrist ist zum 31. Mai 2013 abgelaufen. Bis zur vollständigen Bearbeitung der Kommentare (voraussichtlich Ende September) nehmen die Autoren aber gerne noch per Mail Anregungen entgegen, behalten sich aber vor, diese bis zum nächsten Minor Release zurückzustellen.
 
  
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.
+
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.
  
== Verfahren der Kommentierung ==
+
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.  
<tt>Bitte markieren Sie [[cdaefa:Kommentierung_EFAv2.0|Kommentare]] zu diesem Abschnitt mit dem Code {Keie.01.03}</tt>
 
  
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:
+
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.
+
* 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.
* 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.
 
 
* Bitte verzichten Sie auf die Angabe von Zeilennummern und verwenden Sie ausschließlich die Codes unter den Überschriften, um einzelne Textabschnitte zu referenzieren.
 
* 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.
  
Es sind zwei Verfahren zur Einreichung der Kommentare vorgesehen, die gleichwertig genutzt werden können:
+
== Laufende Pflege der Spezifikation ==
# 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.
+
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:
# Für alle anderen Personen wird ein Kommentarformular zur Verfügung gestellt. Dieses kann per Mail bei mailto:joerg.caumanns@fokus.fraunhofer.de 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.
+
* Umsetzung von Rückmeldungen aus den EFAv2.0-Implementierungen, die für alle Implementierer relevante Spezifikationslücken und Fehler betreffen
 
 
== Umgang mit der Spezifikation während der laufenden Kommentierung ==
 
Während des laufenden Kommentierungsverfahrens werden an der Spezifikation keine inhaltlichen Änderungen vorgenommen. Lediglich die folgenden Änderungen an den Texten der Spezifikation werden ggf. auch während des Kommentierungszeitraums vorgenommen:
 
 
* Berichtigung von Schreib- und Kommafehlern
 
* Berichtigung von Schreib- und Kommafehlern
 
* Verbesserung der Qualität von Grafiken (offensichtlich funktioniert die freie Skalierung von in Powerpoint erzeugten PNG nicht so gut)
 
* Verbesserung der Qualität von Grafiken (offensichtlich funktioniert die freie Skalierung von in Powerpoint erzeugten PNG nicht so gut)
* Abarbeiten editorischer Kommentare
 
 
* Ergänzen von Querverweisen und Korrigieren toter Links
 
* Ergänzen von Querverweisen und Korrigieren toter Links
 +
* 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]])
  
 
=== Querverweise und Referenzen ===
 
=== Querverweise und Referenzen ===

Version vom 18. November 2013, 08:44 Uhr


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