A_25215-01 - Performance - Verzeichnisdienst FHIR - SearchAPI - Last- und Bearbeitungszeiten

Der Produkttyp Verzeichnisdienst FHIR MUSS die Bearbeitungszeitvorgaben unter Last aus Tabelle "Tab_gemSpec_Perf_VZD_FHIR: SearchAPI Last- und Bearbeitungszeitvorgaben" unter der für alle Funktionen parallel anliegenden Spitzenlast erfüllen.

Tabelle 4: Tab_gemSpec_Perf_VZD_FHIR: SearchAPI Last- und Bearbeitungszeitvorgaben

UseCase-Bezug	Fachdienstoperation	Spitzenlast [1/s]	Mittlere Bearbeitungszeit [ms]	Maximale Bearbeitungszeit [ms]	Erfüllungs-quote
VZDF.UC_1_1	GET [baseUrl]/search	500	1000 800	1250 2.500	99,00%
VZDF.UC_2_1	GET [baseUrl]/fdv/search	500	1000 800	1250 2.500	99,00%

[<=]

A_28630 - Performance - Verzeichnisdienst FHIR - SearchAPI - Optimierte Suchanfragen erkennen

Der Produkttyp Verzeichnisdienst FHIR MUSS bei Aufrufen der Schnittstellen FHIRDirectorySearchAPI und FHIRDirectoryFdvSearchAPI erkennen, ob es sich um optimierte Suchanfragen gemäß "Tab_gemSpec_Perf_VZD_FHIR: Optimierte Suchanfragen" handelt und dies gemäß [A_25216-*] in den Betriebsdaten protokollieren.

Tabelle 5 Tab_gemSpec_Perf_VZD_FHIR: Optimierte Suchanfragen

Search-ID	Beschreibung der Suchanfrage
SID100	Suche im Profil "HealthcareService" mit Volltextsuche (ohne Synonyme)
SID101	Suche das Profil "HealthcareService" mit organisation.active
SID102	Suche im Profil "HealthcareService" nach organisation.name
SID103	Suche im Profil "HealthcareService" nach organisation.specialty
SID104	Suche im Profil "HealthcareService" nach organisation.type
SID105	Suche im Profil "HealthcareService" nach organisation.specialty, organisation.name oder organisation.type sowie location.address
SID200	Suche im Profil "PractitionerRole" mit Volltextsuche (ohne Synonyme)
SID201	Suche das Profil "PractitionerRole" mit practitioner.active
SID202	Suche im Profil "PractitionerRole" nach practitioner.name
SID203	Suche im Profil "PractitionerRole" nach practitioner.qualification
SID301	Suche im Profil "Endpoint" nach address
SID302	Suche im Profil "Endpoint" nach name

[<=]

A_28631 - Performance - Verzeichnisdienst FHIR - OwnerAPI - Spitzenlastvorgaben

Der Produkttyp Verzeichnisdienst FHIR MUSS die Spitzenlastvorgaben aus Tabelle "Tab_gemSpec_Perf_VZD_FHIR: OwnerAPI Spitzenlastvorgaben" erfüllen.

Tabelle 6: Tab_gemSpec_Perf_VZD_FHIR: OwnerAPI Spitzenlastvorgaben

UseCase-Bezug	Fachdienstoperation	Spitzenlast [1/s]
VZDF.UC_3_1	GET [baseUrl]/owner	20
VZDF.UC_3_2	POST [baseUrl]/owner	20
VZDF.UC_3_3	PUT [baseUrl]/owner	20
VZDF.UC_3_4	DELETE [baseUrl]/owner	20

[<=]

A_28632 - Performance - Verzeichnisdienst FHIR - TIMProviderAPI - Spitzenlastvorgaben

Der Produkttyp Verzeichnisdienst FHIR MUSS die Spitzenlastvorgaben aus Tabelle "Tab_gemSpec_Perf_VZD_FHIR: TIMProviderAPI Spitzenlastvorgaben" erfüllen.

Tabelle 7: Tab_gemSpec_Perf_VZD_FHIR: TIMProviderAPI Spitzenlastvorgaben

UseCase-Bezug	Fachdienstoperation	Spitzenlast [1/s]
VZDF.UC_4_1	GET [baseUrl]/tim-provider-services/	1
VZDF.UC_4_2	GET [baseUrl]/tim-provider-services/FederationList/federationList.jws	1
VZDF.UC_4_3	GET [baseUrl]/tim-provider-services/localization	50
VZDF.UC_4_4	GET [baseUrl]/tim-provider-services/federationCheck	1
VZDF.UC_4_5	GET [baseUrl]/tim-provider-services/federation	1
VZDF.UC_4_6	POST [baseUrl]/tim-provider-services/federation	1
VZDF.UC_4_7	PUT /tim-provider-services/federation	1
VZDF.UC_4_8	DELETE [baseUrl]/tim-provider-services/federation	1

[<=]

A_28633 - Performance - Verzeichnisdienst FHIR - PersonInstitutionAPI - Spitzenlastvorgaben

Der Produkttyp Verzeichnisdienst FHIR MUSS die Spitzenlastvorgaben aus Tabelle "Tab_gemSpec_Perf_VZD_FHIR: PersonInstitutionAPI Spitzenlastvorgaben" erfüllen.

Tabelle 8: Tab_gemSpec_Perf_VZD_FHIR: PersonInstitution Spitzenlastvorgaben

UseCase-Bezug	Fachdienstoperation	Spitzenlast [1/s]
VZDF.UC_5_1	GET [baseUrl]/PersonInstitutionLink/	1
VZDF.UC_5_2	GET [baseUrl]/PersonInstitutionLink/Link	1
VZDF.UC_5_3	POST [baseUrl]/PersonInstitutionLink/Link	1
VZDF.UC_5_4	PUT [baseUrl]/PersonInstitutionLink/Link	1
VZDF.UC_5_5	DELETE [baseUrl]/PersonInstitutionLink/Link	1

[<=]

A_28634 - Performance - Verzeichnisdienst FHIR - AuthorizationService - Last- und Bearbeitungszeiten

Der Produkttyp Verzeichnisdienst FHIR MUSS die Bearbeitungszeitvorgaben unter Last aus Tabelle "Tab_gemSpec_Perf_VZD_FHIR: AuthorizationService Last- und Bearbeitungszeitvorgaben" unter der für alle Funktionen parallel anliegenden Spitzenlast erfüllen. 

Tabelle 9: Tab_gemSpec_Perf_VZD_FHIR: AuthorizationService Last- und Bearbeitungszeitvorgaben

UseCase-Bezug	Fachdienstoperation	Spitzenlast [1/s]	Mittlere Bearbeitungs-zeit [ms]	Maximale Bearbeitungs-zeit [ms]	Erfüllungs-quote
VZDF.UC_6_1	GET [baseUrl]/tim-authenticate	50	1.000 800	1.250	99,00%
VZDF.UC_6_2	GET [baseUrl]/service-authenticate	20	1.000 800	1.250	99,00%
VZDF.UC_6_3	GET [baseUrl]/owner-authenticate	20	1.000 800	1.250	99,00%
VZDF.UC_6_4	POST [baseUrl]/owner-authenticate-decoupled	20	1.000 800	1.250	99,00%
VZDF.UC_6_5	POST [baseUrl]/owner-authenticate-poll	20	1.000 800	1.250	99,00%
VZDF.UC_6_6	GET [baseUrl]/ti-provider-authenticate	20	1.000 800	1.250	99,00%
VZDF.UC_6_7	GET [baseUrl]/holder-authenticate	20	800	1.250	99,00%
VZDF.UC_7_1	POST [baseUrl]/ti-provider/token	20	1.000 800	1.250	99,00%
VZDF.UC_7_2	POST [baseurl]/auth/realms/Service-Authenticate/protocol/openid-connect/token	20	800	1.250	99,00%
VZDF.UC_7_3	POST [baseurl]/auth/realms/RSDirectoryAdministration/protocol/openid-connect/token	20	800	1.250	99,00%

[<=]

A_28635 - Performance - Verzeichnisdienst FHIR - CertificatesAPI - Last- und Bearbeitungszeiten

Der Produkttyp Verzeichnisdienst FHIR MUSS die Bearbeitungszeitvorgaben unter Last aus Tabelle "Tab_gemSpec_Perf_VZD_FHIR: CertificatesAPI Last- und Bearbeitungszeitvorgaben" unter der für alle Funktionen parallel anliegenden Spitzenlast erfüllen.

Tabelle 10: Tab_gemSpec_Perf_VZD_FHIR: CertificatesAPI Last- und Bearbeitungszeitvorgaben

UseCase-Bezug	Fachdienstoperation	Spitzenlast [1/s]	Mittlere Bearbeitungs-zeit [ms]	Maximale Bearbeitungs-zeit [ms]	Erfüllungs-quote
VZDF.UC_8_1	GET [baseUrl]/certificates/Certificates	50	800	2.500	99,00%

[<=]

A_28636 - Performance - Verzeichnisdienst FHIR - CertificatesAPI - Optimierte Suchanfragen erkennen

Der Produkttyp Verzeichnisdienst FHIR MUSS bei Aufrufen der Schnittstellen FHIRDirectoryCertificatesAPI erkennen, ob es sich um optimierte Suchanfragen gemäß "Tab_gemSpec_Perf_VZD_FHIR: Optimierte Suchanfragen Zertifikate" handelt und dies gemäß [A_25216-*] in den Betriebsdaten protokollieren.

Tabelle 11 Tab_gemSpec_Perf_VZD_FHIR: Optimierte Suchanfragen Zertifikate

Search-ID	Beschreibung der Suchanfrage
SID101	Suche nach Zertifikaten zu einer Telematik-ID
SID102	Suche nach Zertifikaten zu einer LDAP-UID

[<=]

A_28637 - Performance - Verzeichnisdienst FHIR - ReadLogAPI - Spitzenlastvorgaben

Der Produkttyp Verzeichnisdienst FHIR MUSS die Spitzenlastvorgaben aus Tabelle "Tab_gemSpec_Perf_VZD_FHIR: ReadLogAPI Spitzenlastvorgaben" erfüllen.

Tabelle 12: Tab_gemSpec_Perf_VZD_FHIR: ReadLogAPI Spitzenlastvorgaben

UseCase-Bezug	Fachdienstoperation	Spitzenlast [1/s]
VZDF.UC_9_1	GET [baseUrl]/fachliches-log/log	20

[<=]

A_25216-01 - Performance - Betriebsdatenlieferung v2 - Spezifika Verzeichnisdienst FHIR - Operation

Der Produkttyp Verzeichnisdienst FHIR MUSS bei Betriebsdatenlieferungen bzgl. des "operation"-Feldes die Angabe der Spalte "Operation / Usecase" aus Tabelle Tab_gemSpec_Perf_Berichtsformat_VZD_FHIR berücksichtigen.

Tabelle 13: Tab_gemSpec_Perf_Berichtsformat_VZD_FHIR

Operation / Usecase	Fachdienstoperation	Message
VZDF.UC_1_1	GET [baseUrl]/search	{ "rt": "$resourceType", "serc": $searchedResourceCount, "sepc": $searchedParameterCount, "size": $responseSize "sId": "$searchId"}
VZDF.UC_1_1_NOS	GET [baseUrl]/search (nicht optimierte Suchanfrage)	{ "rt": "$resourceType" }
VZDF.UC_2_1	GET [baseUrl]/fdv/search	{ "rt": "$resourceType", "serc": $searchedResourceCount, "sepc": $searchedParameterCount, "size": $responseSize "sId": "$searchId"}
VZDF.UC_2_1_NOS	GET [baseUrl]/fdv/search (nicht optimierte Suchanfrage)	{ "rt": "$resourceType" }
VZDF.UC_3_1	GET [baseUrl]/owner	{ "rt": "$resourceType", "serc": $searchedResourceCount, "sepc": $searchedParameterCount, "size": $responseSize "sId": "$searchId"}
VZDF.UC_3_2	POST [baseUrl]/owner	{ "rt": "$resourceType" }
VZDF.UC_3_3	PUT [baseUrl]/owner	{ "rt": "$resourceType" }
VZDF.UC_3_4	DELETE [baseUrl]/owner	{ "rt": "$resourceType" }
VZDF.UC_4_1	GET [baseUrl]/tim-provider-services/	-
VZDF.UC_4_2	GET [baseUrl]/tim-provider-services/FederationList/federationList.jws	-
VZDF.UC_4_3	GET [baseUrl]/tim-provider-services/localization	-
VZDF.UC_4_4	GET [baseUrl]/tim-provider-services/federationCheck	-
VZDF.UC_4_5	GET [baseUrl]/tim-provider-services/federation	-
VZDF.UC_4_6	POST [baseUrl]/tim-provider-services/federation	-
VZDF.UC_4_7	PUT /tim-provider-services/federation	-
VZDF.UC_4_8	DELETE [baseUrl]/tim-provider-services/federation	-
VZDF.UC_5_1	GET [baseUrl]/PersonInstitutionLink/	-
VZDF.UC_5_2	GET [baseUrl]/PersonInstitutionLink/Link	{ "size": $responseSize , "sest": $searchedStatus}
VZDF.UC_5_3	POST [baseUrl]/PersonInstitutionLink/Link	-
VZDF.UC_5_4	PUT [baseUrl]/PersonInstitutionLink/Link	-
VZDF.UC_5_5	DELETE [baseUrl]/PersonInstitutionLink/Link	-
VZDF.UC_6_1	GET [baseUrl]/tim-authenticate	{ "bkdur": $backendDuration }
VZDF.UC_6_2	GET [baseUrl]/service-authenticate	-
VZDF.UC_6_3	GET [baseUrl]/owner-authenticate	{ "bkdur": $backendDuration }
VZDF.UC_6_4	POST [baseUrl]/owner-authenticate-decoupled	{ "bkdur": $backendDuration }
VZDF.UC_6_5	POST [baseUrl]/owner-authenticate-poll	-
VZDF.UC_6_6	GET [baseUrl]/ti-provider-authenticate	-
VZDF.UC_6_7	GET [baseUrl]/holder-authenticate	-
VZDF.UC_7_1	POST [baseUrl]/ti-provider/token	-
VZDF.UC_7_2	POST [baseurl]/auth/realms/Service-Authenticate/protocol/openid-connect/token	-
VZDF.UC_7_3	POST [baseurl]/auth/realms/RSDirectoryAdministration/protocol/openid-connect/token	-
VZDF.UC_8_1	GET [baseUrl]/certificates/Certificates	{"sId": "$searchId"}
VZDF.UC_8_1_NOS	GET [baseUrl]/certificates/Certificates (nicht optimierte Suchanfrage)	-
VZDF.UC_9_1	GET [baseUrl]/fachliches-log/log	-

[<=]

A_25218 - Performance - Betriebsdatenlieferung v2 - Spezifika Verzeichnisdienst FHIR - Message

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

{ "rt": "$resourceType", "serc": $searchedResourceCount, "sepc": $searchedParameterCount, "size": $responseSize, "sest": $searchedStatus, "bkdur": $backendDuration }

• $resourceType = Aufgerufener FHIR-Ressource-Typ gem. [gemSpec_VZD_FHIR_Directory#Kap. 4.1.1 Datenmodell#VZD-FHIR-Directory, FHIR-Ressourcen], Datentyp String
• $searchedResourceCount = Anzahl der in der Suche genutzten FHIR-Ressourcen-Typen, die in Verbindung mit den Suchparametern verwendet werden, Datentyp Integer
• $searchedParameterCount = Anzahl der in der Suche genutzten FHIR-Ressourcen-Parameter, Datentyp Integer
• $responseSize = Größe der Antwortnachricht der Suchanfrage in Kbyte, Datentyp Integer
• $searchedStatus = Gesuchter Status gem. Parameter "status" der Operation GET [baseURL]/PersonInstitutionLink/Link, Datentyp String
• $backendDuration = Zeit in ms, welche die Kommuniktion mit dem Matrix-Homeserver oder dem Identity Provider beinhaltet und nicht Bestandteil der Bearbeitungszeit ist, Datentyp Integer

Für die jeweilige Operation sind dabei nur die in der Spalte "Message" aus Tabelle Tab_gemSpec_Perf_Berichtsformat_VZD_FHIR angegebenen Daten 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 die Spezifikation [RFC7493] eingehalten wird. [<=]

A_25218-01 - Performance - Betriebsdatenlieferung v2 - Spezifika Verzeichnisdienst FHIR - Message

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

{ "rt": "$resourceType","bkdur": $backendDuration, "sId": "$searchId" }

• $resourceType = Aufgerufener FHIR-Ressource-Typ gem. [gemSpec_VZD_FHIR_Directory#Kap. 4.1.1 Datenmodell#VZD-FHIR-Directory, FHIR-Ressourcen], Datentyp String
• $backendDuration = Zeit in ms, welche die Kommuniktion mit dem Matrix-Homeserver oder dem Identity Provider beinhaltet und nicht Bestandteil der Bearbeitungszeit ist, Datentyp Integer
• $searchId = Search-ID der optimierten Suchanfrage gem. [A_28630*] oder [A_28636*], Datentyp String

Für die jeweilige Operation sind dabei nur die in der Spalte "Message" aus Tabelle Tab_gemSpec_Perf_Berichtsformat_VZD_FHIR angegebenen Daten 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 die Spezifikation [RFC7493] eingehalten wird.
[<=]

A_28638 - Performance - Bestandsdaten - Verzeichnisdienst FHIR - SearchAPI

Der Anbieter des Produkttypen Verzeichnisdienst FHIR MUSS in einem definierten, konfigurierbaren Zeitintervall folgende Informationen berichten: 

• Angabe des aufgerufenen FHIR-Ressource-Typ
• Angabe des vollständigen Suchstrings
• Anzahl der in diesem Suchstring verwendeten FHIR-Ressourcen-Parametern
• Angabe der minimalen, durchschnittlichen und maximalen Bearbeitungszeit der Suchen mit diesem Suchstring
• Anzahl, wie oft mit dem jeweiligen Suchstring im Zeitintervall gesucht wurde

Für die Bestandsdaten sind ausschließlich nicht optimierte Suchanfragen der Operationen VZDF.UC_x_x_NOS gemäß [A_25216-01] zu berücksichtigen. Suchstrings sollen nur dann übermittelt werden, wenn sie innerhalb des definierten Zeitintervalls mindestens die festgelegte konfigurierbare Mindesthäufigkeit erreichen.

(Das Default Zeitintervall ist täglich, beginnend mit 00:00:00. Die Default Mindesthäufigkeit ist 5.)
[<=]

A_28639 - Performance - Bestandsdaten - Verzeichnisdienst FHIR - SearchAPI - Lieferweg und Format

Der Anbieter des Produkttypen Verzeichnisdienst FHIR MUSS jeweils zum Wechsel in den nächsten Berichtsintervall, folgende Informationen im JSON Format als HTTP Body an die Betriebsdatenerfassung gemäß [A_23110-*] liefern.
{ 
"ci": "<CI-ID der abgefragten Produktinstanz gemäß [A_17764] als String>",
"starttime": "<Zeitstempel des Starts der Abfrage als String gemäß ISO 8601 unter expliziter Angabe einer Zeitzone im Format YYYY-MM-DDTHH:mm:ss[.fff]Z>",
"interval": "<Angabe der Intervall-Länge (Default: 1d), in denen die Bestandsdaten erfasst wurden als String>",
"searchList": [
  {
    "resourceType": "<Aufgerufener FHIR-Ressource-Typ als String>",
    "searchString": "<Vollständiger Suchstring als String>",   
    "paramCount": <Anzahl der im Suchstring genutzten FHIR-Ressourcen-Parameter als Integer>,
    "minDur": <Angabe der minimalen / kleinsten Bearbeitungszeit von allen Suchanfragen mit diesem Suchstring in ms als Integer>,
    "avgDur": <Angabe der mittleren Bearbeitungszeit über alle Suchanfragen mit diesem Suchstring in ms als Integer>,
    "maxDur": <Angabe der maximalen Bearbeitungszeit von allen Suchanfragen mit diesem Suchstring in ms als Integer>,
    "searchCount": <Anzahl der Suchanfragen mit diesem eindeutigen Suchstring als Integer>
  }
]
}
Hinweise:

• Für jeden eindeutigen Suchstring je FHIR-Ressource-Type ist dabei ein eigenständiges JSON Objekt mit den JSON-Keys resourceType, searchString, paramCount, minDur, avgDur, maxDur und searchCount innerhalb des JSON-Arry searchList zu erstellen.
• FHIR-Ressource-Parameter (inkl. der Volltextsuche), welche datenschutzrelevante Inhalte enthalten (Addressen, Namen) sollen anonymisiert werden
• Der Suchstring, welcher im JSON-Key searchString übermittelt wird, MUSS [RFC8259]-konform als JSON-String kodiert sein. Dabei MÜSSEN alle Sonderzeichen gemäß [RFC8259] korrekt escaped werden.

[<=]