gematik / api-kim

API specification for gematik's KIM - a secure Email standard, which enables the exchange of information and payload in the German healthcare sector.
Other
33 stars 12 forks source link

[Kommentierung 1.5.3] kimData.appTags #27

Open dhufnagel opened 1 year ago

dhufnagel commented 1 year ago

Es existiert keine formale Beschreibung von AppTags. Wie muss das “Format” aussehen? Die Beispiele sind widersprüchlich.

kimData: mz_smcb_za@dom2.kim.telematik-test,1.0,DALE-UV;Einsendung;V1.0|eEB;V1.0

Gemäß Beschreibung wäre also DALE-UV;Einsendung;V1.0 ein einzelnes AppTag. Wie soll das geparst werden? Dort wäre die Version an 3. Stelle getrennt mit Semikolon, bei eEB;V1.0 ist die Version an 2. Stelle. Hier sollte eine einheitliche formale Definition der AppTags erfolgen, da sonst jeder AppTag selbst unterschiedlich geparst werden muss, was ein schlechter Weg wäre.

Ohne formale Definition kann auch keine Validierung geschehen und bei den REST Aufrufen ungültige bzw. destruktive AppTags gesendet werden (z.B. Komma innerhalb des Tags).

gem-cp commented 1 year ago

Die appTags werden von der jeweiligen KIM Anwendung festgelegt. In der Spezifikation der Anwendung wird auch beschrieben, wie die appTags der jeweiligen Anwendung zu interpretieren und zu verwenden sind. Ein Primärsystem, dass die KIM Anwendung implementiert muss sich an die Spezifikation der Anwendung halten. Das KIM Clientmodul muss sicherstellen, dass nur korrekte appTags verwendet werden. Dies kann anhand des FHIR Codesystems geprüft und bereits bei der Eingabe sichergestellt werden.

stophane commented 1 year ago

Hallo zusammen,

Ergänzende Hinweise im Kontext der nachfolgenden Spec: A_23819 - VZD, I_Directory_Application_Maintenance, Behandlung komLeData & kimData REST Tabelle 15: Tab_VZD_Datenbeschreibung

Delimiter in kimData beachten/überdenken

gem-cp commented 1 year ago

"|" (pipe) als Delimiter im VZD ist nicht problematisch, da die Suche-Parameter vom PS in der Regel Name und postalische Adressdaten sind. Wenn nach einem appTag gesucht wird, dann ist das trotz Pipe Delimiter möglich (kimData: ).

dhufnagel commented 1 year ago

Wenn man in kimData nach appTags sucht, muss in der ldapsuche der pipe delimiter Gründer appTags escaped werden, damit er nicht als ldap delimiter erkannt wird. Technisch ist das nicht problematisch, aber verwirrend und kann zu Fehlern bei den PS führen, wenn nicht korrekt das escaping eingesetzt wird.