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 | ||
| ... | |||||