C_12808_Anlage_V1.0.0


C_12808_Anlage

3.18.3 Bestandsdaten ePA Aktensystem

A_15743-09 - Performance - ePA-Aktensystem - Bestandsdaten
Der Anbieter ePA-Aktensystem MUSS in einem definierten, konfigurierbaren Zeitintervall folgende Performance-Kenngrößen über das ePA-Aktensystem berichten:

  • je Mandant
    • Anzahl von Aktenkonten
    • Kontenstatus
      • Anzahl im Status ACTIVATED
      • Anzahl im Status INITIALIZED
      • Anzahl im Status SUSPENDED
      • Anzahl im Status INACCESSIBLE
    • Relocations
      • je Aktensystem (inkl. dem ePA-Aktensystem der Bestandsdatenlieferung)
        • Anzahl der vom Mandaten im Zeitintervall initiierten Anbieterwechsel insgesamt
        • Anzahl der vom Mandaten initiierten Anbieterwechsel, die am Ende des Zeitintervalls noch in Ausführung sind
        • Anzahl der vom Mandaten im Zeitintervall initiierten Anbieterwechsel, die erfolgreich abgeschlossen wurden
        • Anzahl der vom Mandaten im Zeitintervall initiierten Anbieterwechsel, die fehlgeschlagen sind oder abgebrochen wurden
    • Anzahl der geöffneten Akten (Vortag) - LEI/Vers
    • Anzahl der geöffneten Akten (laufendes Jahr) - LEI/Vers
    • Anzahl der geöffneten Akten (Vortag) - eRP-FD
    • Anzahl der geöffneten Akten (laufendes Jahr) - eRP-FD
    • Anzahl der geöffneten Akten (Vortag) - KTR
    • Anzahl der geöffneten Akten (laufendes Jahr) - KTR
    • Dokumente Plus
      • Anzahl der im Zeitintervall hinzugefügten Dokumente/Datensätze je Kategorie gemäß A_19303-* für Medical Services (XDS Document Service)
      • Anzahl der im Zeitintervall hinzugefügten Dokumente/Datensätze je Kategorie gemäß A_19303-* für Medical Services (FHIR Data Service)
      • Anzahl der im Zeitintervall hinzugefügten Dokumente/Datensätze des Ordners "technical"
    • Dokumente Minus
      • Anzahl der im Zeitintervall entfernten Dokumente/Datensätze je Kategorie gemäß A_19303-* für Medical Services (XDS Document Service)
      • Anzahl der im Zeitintervall entfernten Dokumente/Datensätze je Kategorie gemäß A_19303-* für Medical Services (FHIR Data Service)
      • Anzahl der im Zeitintervall entfernten Dokumente/Datensätze des Ordners "technical"
    • Anzahl von abgelegten Widersprüchen zum Medikationsprozess
    • Anzahl von abgelegten Widersprüchen gegen des Einstellen durch den eRP-FD
    • Anzahl von abgelegten Widersprüchen zur Forschungsfreigabe
    • Push-Notifications
      • Anzahl der registrierten Geräte
      • Anzahl der Abonnements des Channels "xds.put"
      • Anzahl der Abonnements des Channels "xds.update"
      • Anzahl der Abonnements des Channels "entitle.put"
      • Anzahl der Abonnements des Channels "entitle.del"
      • Anzahl der Abonnements des Channels "entitle.ps"
      • Anzahl der Abonnements des Channels "constraint.de"
    • Versionsmigrationen
      • Anzahl erfolgreiche Migrationen
      • Anzahl erfolglose Migrationen
      • Durchschnittliche Dauer erfolgreiche Migrationen
  • je UX-Usecase:
    • je ClientID und Versionsnummer
      • Arithmetisches Mittel der Einzelmessungen
      • Anzahl der in die Konsolidierung eingeflossenen Einzelwerte
      • höchster Einzelwert der konsolidierten Messewerte
      • niedrigster Einzelwert der konsolidierten Messewerte.

Der Anbieter ePA-Aktensystem MUSS die Bestandsdaten an den Endpunkt gemäß [gemSpec_SST_LD_BD] liefern.
Voreingestellt für das Zeitintervall ist: täglich. [<=]
A_20204-14 - Performance - ePA-Aktensystem - Lieferweg und Format für Bestandsdaten 

Das ePA-Aktensystem MUSS die Informationen aus [A_15743-*] jeweils nach dem Wechsel in das nächste Lieferintervall in folgendem JSON Format als HTTP Body an die Betriebsdatenerfassung (BDE) gemäß [gemSpec_SST_LD_BD#A_23110] liefern:

{

"abfragezeitpunkt" : "<Zeitstempel der Abfrage als String gemäß ISO 8601 unter expliziter Angabe einer Zeitzone, im Format  YYYY-MM-DDTHH:mm:ss[.fff]Z>",
"ci" : "<CI ID des abgefragten Aktensystems gemäß TI-ITSM als String>",

"kassendaten" :
[

{

"ikn" : "<ID der Krankenkasse gemäß Festlegung durch gematik als String, siehe "Hinweis zur ID der Krankenkasse">",
"konten" : <Anzahl der zum Ende des Vortages vorhandenen Konten als Integer>,
"kontenstatus":
[

{

"status" : "ACTIVATED",
"anzahl" : <Anzahl der Akten im Status ACTIVATED zum Ende des Vortages als Integer>

},

{

"status" : "INITIALIZED",
"anzahl" : <Anzahl der Akten im Status INITIALIZED zum Ende des Vortages als Integer>

},
{

"status" : "SUSPENDED",
"anzahl" : <Anzahl der Akten im Status SUSPENDED zum Ende des Vortages als Integer>

},
{

"status" : "INACCESSIBLE",
"anzahl" : <Anzahl der Akten im Status INACCESSIBLE zum Ende des Vortages als Integer>

}

]

"anbieterwechsel":

[

{

"source" : <ePA-Anbieter-Zahl aus dem Hostname des Aktensystems, bei dem die Akte angefordert wurde>,
"overall" : <Anzahl der initiierten Anbieterwechsel insgesamt zum Ende des Vortages als Integer>,
"pending" : <Anzahl der initiierten Anbieterwechsel die bei Meldung noch in Ausführung sind als Integer>,
"success" : <Anzahl der initiierten und erfolgreich abgeschlossenen Anbieterwechsel zum Ende des Vortages als Integer>,
"failed" : <Anzahl der initiierten und nicht erfolgreich abgeschlossenen Anbieterwechsel zum Ende des Vortages als Integer>

]

"geoeffneteAktenVortagLEIVers" : <Anzahl der geöffneten Akten des Vortages (durch LEI/Vers) als Integer>,
"geoeffneteAktenJahrLEIVers" : <Anzahl der geöffneten Akten des aktuellen Kalenderjahres (durch LEI/Vers) als Integer>,
"geoeffneteAktenVortagERP" : <Anzahl der geöffneten Akten des Vortages (durch eRP-FD) als Integer>,
"geoeffneteAktenJahrERP" : <Anzahl der geöffneten Akten des aktuellen Kalenderjahres (durch eRP-FD) als Integer>,
"geoeffneteAktenVortagKTR" : <Anzahl der geöffneten Akten des Vortages (durch KTR) als Integer>,
"geoeffneteAktenJahrKTR" : <Anzahl der geöffneten Akten des aktuellen Kalenderjahres (durch KTR) als Integer>,
"dokumentePlus":
[

{

"dokTyp" : "je Kategorie gemäß A_19303-* für Medical Services (XDS Document Service) & Medical Services (FHIR Data Service) & 'technical' ",
"anzahl" : <Anzahl der am Vortag hinzugefügten Dokumente/Datensätze der jeweiligen Kategorie als Integer>

},

],

"dokumenteMinus":

[

{

"dokTyp" : "je Kategorie gemäß A_19303-* für Medical Services (XDS Document Service) & Medical Services (FHIR Data Service) & 'technical' ",
"anzahl" : <Anzahl der am Vortag entfernten Dokumente/Datensätze der jeweiligen Kategorie als Integer>

},

],

"wmed" : <Anzahl der zum Ende des Vortages vorhandenen Widersprüche zum Medikationsprozess als Integer>,
"werp" : <Anzahl der zum Ende des Vortages vorhandenen Widersprüche gegen das Einstellen von Verordnungsdaten durch den eRezept-Fachdienst als Integer>,
"wfor" : <Anzahl der zum Ende des Vortages vorhandenen Widersprüche zur Forschungsfreigabe als Integer>,
"pushReg" : <Anzahl der registrierten "Pusher" (Geräte) zum Ende des Vortages als Integer>,
pushNotifications":

[

{

"channel" : "xds.put",
"anzahl" : <Anzahl der Abonnements des Channels "xds.put" zum Ende des Vortages als Integer>

},

{

"channel" : "xds.update",
"anzahl" : <Anzahl der Abonnements des Channels "xds.update" zum Ende des Vortages als Integer>

},

{

"channel" : "entitle.put",
"anzahl" : <Anzahl der Abonnements des Channels "entitle.put" zum Ende des Vortages als Integer>

},

{

"channel" : "entitle.del",
"anzahl" : <Anzahl der Abonnements des Channels "entitle.del" zum Ende des Vortages als Integer>

},

{

"channel" : "entitle.ps",
"anzahl" : <Anzahl der Abonnements des Channels "entitle.ps" zum Ende des Vortages als Integer>

},

{

"channel" : "constraint.del",
"anzahl" : <Anzahl der Abonnements des Channels "constraint.del" zum Ende des Vortages als Integer>

}

],

"versionMigration": {

"success" : <Anzahl erfolgreicher Migrationen als Integer>,
"vain" : <Anzahl vergeblicher Migrationen als Integer>,
"duration" : <durchschnittliche Dauer der Migrationen in ms als Integer>,

}

}

],
"uxdaten" :
[

{

"usecase" : "<UX-Usecase-Name gem. Tab_UX-Usecases, String>", 
"cid" : "<ClientID deren Messergebnisse konsolidiert wurden, String>"
"cv" : "<ClientVersion der ClientID deren Messergebnisse konsolidiert wurden, String>",
"mittel" : <arithmetisches Mittel der Einzelmessungen für die o.a. ClientID und den dazugehörigen UX-Usecase am Vortag in Millisekunden, Integer (Nachkommastellen sind abzuschneiden)>,
"anz" : <Anzahl der Einzelmessungen für die o.a. ClientID und den dazugehörigen UX-Usecase am Vortag, Integer>,
"max" : <höchste Einzelmessung für die o.a. ClientID und den dazugehörigen UX-Usecase am Vortag, Integer>,
"min" : <niedrigste Einzelmessung für die o.a. ClientID und den dazugehörigen UX-Usecase am Vortag, Integer>

}

]

}

[<=]

3.18.2 Betriebsdatenerfassung v2 Spezifika ePA-Aktensystem

Tabelle 65: Tab_gemSpec_Perf_Usecases_ePA_Definition

Usecase / Anwendungsfall-ID Titel Beschreibung
EPA.UC_1 Login Versicherter Es handelt sich um den Loginvorgang des Versicherten via FdV inkl. Verbindungsaufbau, Autorisierung und Etablierung der UserSession in der VAU-Instanz.
EPA.UC_2 Login PS Es handelt sich um den Loginvorgang einer LEI via Primärsystem inkl. Verbindungsaufbau, Autorisierung und Etablierung der UserSession in der VAU-Instanz. 
EPA.UC_3 Aktualisierung EntitlementDenyList Es handelt sich dabei um den Aktensystem-internen Vorgang, bei dem die aktuelle Version der EntitlementDenyList am EnforcementPoint des Aktensystems durchgesetzt wird. Der Usecase findet mindestens im Rahmen der Aktualisierung der EntitlementDenyList statt.
EPA.UC_4 Widerspruchsabfrage bei Aktenanlage Es handelt sich um die allgemeine Abfrage von Widerspruchsinformationen gegen die ePA während der Initialisierung einer neuen Akte. Der Usecase wird nur eingeschränkt reportet, da er im Monitoring nur im Fall eines Statuscodes "409" (widersprüchliche Informationen) relevant ist.
EPA.UC_5 Relocation Es handelt sich um die Relocation (den Anbieterwechsel) einer Akte zu einem neuen Anbieter. Der Usecase wird nur eingeschränkt reportet, da im Monitoring nur die Abbrüche der Relocation relevant sind.
... ... ...

A_22467-15 - Performance - Betriebsdatenlieferung v2 - Spezifika ePA-Aktensystem - Operation 

Der Produkttyp Aktensystem_ePA MUSS bei Betriebsdatenlieferungen bzgl. der "operation"-Felder die Angabe der Spalte "Usecase / Anwendungsfall-ID" aus Tabelle Tab_gemSpec_Perf_Berichtsformat_ePA berücksichtigen.

Tabelle 66 : Tab_gemSpec_Perf_Berichtsformat_ePA

Usecase / Anwendungsfall-ID Titel Duration Message-Block
EPA.UC_1 Login Versicherter Beginnt mit VAU-Hello und endet mit dem Abschluss des Aufbaus der VAU. Während ggf. notwendigem Request an externen Komponenten pausiert die Messung. { "cid": "$clientID",
"cv" : "$version" } 
EPA.UC_2 Login PS Beginn mit VAU-Hello und endet mit dem Abschluss des Aufbaus der VAU. Während ggf. notwendigem Request an externen Komponenten pausiert die Messung. { "cid": "$clientID",
"cv" : "$version",
"profOID": "$professionOID",
"telidP" : "$pn_telematikID",
"ipP" : "$pn_ipaddress" }
EPA.UC_3 Aktualisierung EntitlementDenyList Als "duration" ist für die Lieferung der Wert 0 (Null - Zero) zulässig. Eine Messung der Aktualisierung ist nicht notwendig { "EDLHash" : "$hash"}
EPA.UC_4 Widerspruchsabfrage bei Aktenanlage (nur im Falle eines Status 409) Beginnt mit dem Erhalt des Requests (getGeneralConsentDecision) und endet mit Abschluss des Absendens der Response. Während ggf. notwendigen Requests an externen Komponenten läuft die Messung weiter und pausiert NICHT. { }
EPA.UC_5 Relocation Beginnt mit der dem Senden des Requests startRelocation an das ePA-Aktensystem "asNr" und endet mit dem Erhalt des Requests  postPackageDeliveryIncident oder dem senden des Requests  postExportPackageIncident beim ePA-Aktensystem, welches das startRelocation gesendet hat.
{ "asNr":$as_id,
"inc":"$incident"}

A_22469-12 - Performance - Betriebsdatenlieferung v2 - Spezifika ePA-Aktensystem - Message

Der Produkttyp Aktensystem_ePA MUSS bei Betriebsdatenlieferungen bzgl. des Feldes "message" folgende spezifischen Festlegungen hinsichtlich des Formates und der Inhalte berücksichtigen.

{ "cid": "$clientID", "cv" : "$version", "size": $size, "profOID": "$professionOID", "cat": "$category", "telidP" : "$pn_telematikID", "ipP" : "$pn_ipaddress", "cissP" : "$pn_certissuer", "csnP" : "$pn_certserialnumber", "mode": "$modus", "proof" :  $auditProof , "cnt" : $count, "EDLHash" : "$hash", "err" : "$serrorCode" , "ocr" : $ocr, "ikn" : "$gemIK","asNr" : $as_id, "inc" : "$incident"}

  • $clientID: ClientID-Parameter aus dem HTTP-Header-Feld gemäß Anforderungslage für Clientsysteme aus [gemSpec_Aktensystem_ePAfuerAlle#A_22470-xx] (erster Teil des Useragent-Parameters), Datentyp String
  • $version: Versionsnummer-Parameter aus dem HTTP-Header-Feld gemäß Anforderungslage für Clientsysteme aus [gemSpec_Aktensystem_ePAfuerAlle#A_22470-xx] (zweiter Teil des Useragent-Parameters), Datentyp String
  • $size: Größe des Requests in Kilobyte, Datentyp Integer
  • $professionOID: professionOID gemäß OID-Datenbank des BfArM als OID, Datentyp String
  • $category: Dokumentenkategorie gemäß der Spalte "technischer Identifier" in [gemSpec_Aktensystem_ePAfuerAlle#A_19303-*] - sofern mehrere Dokumentenkategorien (z.B. aufgrund eines Mehrfachuploades) zu nennen sind, sind diese durch Kommata zu separieren (z.B. "reports,eab,care"), Datentyp String
  • $count: Anzahl der Einzelelemente (Dokumente / Datensätze) innerhalb einer Dokumentenoperation, Datentyp Integer
  • $pn_telematikID: Telematik-ID des angemeldeten Nutzers, verschlüsselt gemäß A_27332-*, Datentyp String
  • $pn_ipaddress: IP-Adresse des angemeldeten Nutzers, verschlüsselt gemäß A_27332-*, Datentyp String
  • $pn_certissuer: issuer-Parameter aus C.HCI.AUT, verschlüsselt gemäß A_27332-*, Datentyp String
  • $pn_certserialnumber: serialNumber-Parameter aus C.HCI.AUT, verschlüsselt gemäß A_27332-*, Datentyp String
  • $modus: je nachdem welche Art der Medikationsliste (render-eML-HTML, render-eML-PDF oder FHIR-eML) abgerufen wurde, ist für den EPA.UC_C6.1g folgender Wert einzutragen [render-eML-HTML = "HTML", render-eML-PDF = "PDF", FHIR-eML = "FHIR"], beim Medikationsplan (EPA.UC_C6.19) sind nur die Werte "FHIR" und "PDF" zu verwenden, Datentyp String
  • $auditProof : je nachdem auf welche Art der Behandlungskontext nachgewiesen wurde, ist für den EPA.UC_B1.2 folgender Wert einzutragen [VSDM-Prüfnachweis = 1, PoPP-Token = 2], Datentyp Integer
  • $hash: als Hash ist der gemäß A_27781-* berechnete Wert zu übermitteln, Datentyp String (Base64-kodierter Hashwert)
  • $errorCode: der ErrorCode aus Tab_gemSpec_Perf_Fehlercodes_ePA-AS_SOAP-Fault, welcher im Soap-Fault bei einer fehlerbehafteten SOAP-Operation übermittelt wird, Datentyp String
  • $ocr: Sofern bei der Indizierung OCR zum Einsatz kam, ist als Wert = 1 zu übermitteln, andernfalls der Wert 0, Datentyp Integer
  • $gemIK: IK-Nummern der Kostenträger, wie sie auch schon in A_20204-* Anwendung finden, Datentyp String
  • $as_id: ePA-Anbieter-Zahl aus dem Hostname des Aktensystems, Datentyp Integer.
  • $incident: Incident gemäß der Operationen postPackageDeliveryIncident und postExportPackageIncident, Datentyp String.

Für die jeweilige Operation sind dabei nur die in der Spalte "Message" aus Tabelle Tab_gemSpec_Perf_Berichtsformat_ePA angegebenen Key-Value Paare zu übermitteln.
Bei der Erstellung des message-Feldes ist darauf zu achten, dass weder Whitespaces noch Newlines zwischen JSON-Elementen enthalten sind (kein Indenting) und Vorgaben nach [RFC7493] eingehalten werden. [<=]

3.18.4 Performance-Kenngrößen ePA Aktensystem

Schnittstellen::Operation bzw. Anwendungsfall

Tabelle 11#: Tab_gemSpec_Perf_ePA_S::O/A

Produkttyp / Anwen-dungstyp S/A-ID
Schnittstellen::Operation / Anwendungsfall
Beschreibung Berichtsformat-Alias (sofern von Schnittstellen::Operation abweichend)
ePA Aktensystem (PDT43)
PDT43 S01 EPA* ePA-Aktensystem
PDT43 A01 EPA.UC_1  Login Versicherte 
PDT43 A02 EPA.UC_B1.1  Dokument hochladen Versicherter 
PDT43 A03 EPA.UC_B4.x  Verbergen von Dokumenten / Kategorien 
PDT43 A04 EPA.UC_A2.2  Befugnis ablegen Versicherter 
PDT43 A05 EPA.UC_A2.5  Befugnis ablegen Vertreter 
PDT43 A06 EPA.UC_2  Login PS 
PDT43  A07 EPA.UC_2x Aktenkontext öffnen PS 
PDT43  A08 EPA.UC_B1.2  Dokument hochladen PS 
PDT43  A09 EPA.UC_A3.9  Abfragen von Widersprüchen PS 
PDT43  A10 EPA.UC_6.1y Medikationsliste abrufen PS 
PDT43  A11 EPA.UC_A2.1  Befugnis ablegen PS 
PDT43 A12 EPA.UC_C6.1 Verordnungen einstellen eRP-FD
PDT43 A13 EPA.UC_C6.1x Dispensierung einstellen eRP-FD
PDT43 A14 EPA.UC_C4.1x Übermittlung an VST
PDT43 A15 EPA.UC_C4.1y Übermittlung an FDZ
PDT43 A16 EPA.UC_C6a Widerspruch LEI-Zugriff Medication Service
PDT43 A17 EPA.UC_C6b Rücknahme Widerspruch LEI-Zugriff Medication Service
PDT43 A18 EPA.UC_B1.4 Dokument herunterladen PS
PDT43 A19 EPA.UC_C6.19 Medikationsplan abrufen PS
PDT43 A20 EPA.UC_C6.1g Medikationsliste abrufen PS 
PDT43 A21 EPA.UC_C6.20 eML-Einträge hinzufügen
PDT43 A22 EPA.UC_C6.21 eMP-Einträge hinzufügen
PDT43 A23 EPA.UC_C6.22 eML-Einträge aktualisieren
PDT43 A24 EPA.UC_C6.23  eMP-Einträge aktualisieren
PDT43 A25 EPA.UC_C6.24 eMP-Verlinkung setzen
PDT43 A26 EPA.UC_3 Aktualisierung EntitlementDenyList
PDT43 A27 EPA.UC_B5 Indizierung für Volltextsuche
PDT43 A28 EPA.UC_4 Widerspruchsabfrage bei Aktenanlage
PDT43 A29  EPA.UC_D1   Umschlüsselung
PDT43 A30 EPA.UC_5 Relocation

Performance-Kenngrößen / SL-Werte

Der Erfassungszeitraum    für die aufgeführten Soll-Werte beträgt ein Kalendermonat.

Die Bildung der Performance-Kenngrößen basiert auf folgenden PG-Schemata: PG-Schema-I.

Tabelle 11#: Tab_gemSpec_Perf_ePA_Performance-Kenngroessen

Performance-
Kenngröße
(PKG-ID)
 Beschreibung berechnet aus (Betriebsdaten, Probing) SL-Wert
(Soll-Wert)
 min / max Normative Referenz
...
... ... ... ... ... ...
ePA Aktensystem - PDT43 - EPA.UC_5
 PDT43-A30-D2-G08 Mittlere Bearbeitungszeit im Betrachtungszeitraum. [msec]  Betriebsdaten  kein SL
PDT43-A30-D2-G30 Maximale Bearbeitungszeit im Betrachtungszeitraum. [msec] Betriebsdaten kein SL
PDT43-A30-D2-G31 Anteil Bearbeitungen innerhalb der Bearbeitungszeitvorgabe im Betrachtungszeitraum. [%*1000] Betriebsdaten kein SL
...