Kommentierung und Pflege EFA v2.0

Aus Hl7wiki
Implementierungsleitfaden
Wechseln zu: Navigation, Suche
K (Gegenstand der Kommentierung)
(Verfahren der Kommentierung)
 
(7 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 20: Zeile 20:
 
<tt>Bitte markieren Sie [[cdaefa:Kommentierung_EFAv2.0|Kommentare]] zu diesem Abschnitt mit dem Code {Keie.01.01}</tt>
 
<tt>Bitte markieren Sie [[cdaefa:Kommentierung_EFAv2.0|Kommentare]] zu diesem Abschnitt mit dem Code {Keie.01.01}</tt>
  
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.
  
Die EFAv2.0 Spezifikation wird in drei Sichten angeboten:
+
== Verfahren der Kommentierung ==
* [[cdaefa:EFA_Spezifikation_v2.0|modularisiert innerhalb der Matrix des HL7 ECCF Frameworks]] zur Online-Kommentierung
+
<tt>Bitte markieren Sie [[cdaefa:Kommentierung_EFAv2.0|Kommentare]] zu diesem Abschnitt mit dem Code {Keie.01.03}</tt>
* [[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 können gleichwertig zur Kommentierung genutzt werden.
 
  
{{AlertBox|
+
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.
Das PDF-Dokument wird bereit gestellt, wenn die aktuell in der [[cdaefa:EFA_Spezifikation_v2.0#EFA_2.0_Spezifikation|Übersicht]] noch grau markierten Seiten freigegeben sind. Dies wird in jedem Fall kurzfristig geschehen.}}
 
  
== Rahmendaten 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.02}</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.
+
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:
 
 
Die Bearbeitung der Kommentare erfolgt in 2 Stufen:
 
# 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.
 
 
 
== Verfahren der Kommentierung ==
 
<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:
 
 
* 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 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.
+
* 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 ===
  
 
* [[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


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