[Java SDKs] Basisprozessunterstützung
Warum
Mit der ersten Ausbaustufe der Prozessunterstützung sind ZSD und SSP funktionsfähig. Für Pilotierung und Demo‑Fachverfahren müssen nun die Java SDKs die erweiterten Fähigkeiten der Submission API v2.0.0‑pu abbilden: konfigurierbare Orchestrierung (Prozessreferenz, Rollen, MessageFlows, Datenschemata), prozessrelevante Metadaten, drei Empfangsvarianten inkl. Schlüsseltausch(Replies in einer separaten Story) sowie zentrale/sender‑/prozessspezifische Routings. So stellen wir eine End‑to‑End‑Nutzbarkeit ohne Workarounds sicher und schaffen eine belastbare Grundlage für die Pilotnutzer:innen. Referenz: Planning‑Issue #3665
Ziel
Als Pilotuser möchte ich ein Java SDK nutzen können, um die wichtigsten Funktionalitäten der Basis‑Prozessunterstützung (Erzeugen/Lesen von Einreichungen, Setzen/Nutzen prozessrelevanter Metainformationen (API & Metadaten), Suche, Empfangsvarianten inkl. Schlüsseltausch) einfach und konsistent einsetzen zu können.
Links, Hinweise, Bemerkungen
Stories
https://miro.com/app/board/uXjVJQJihiM=/
Akzeptanzkriterien
-
Grundkonfiguration um generische prozessrelevante Informationen (z. B. fromDestinationId) erweitert; Entscheidung + Umsetzung zur bisherigen Trennung Sender/Empfänger‑Client (künftig kann ein Client beides) ist dokumentiert. -
Zustellpunkt‑Details können aus dem SDK über GET /v2/destinations/{destinationId} geladen und genutzt werden.https://docs.fitko.de/fit-connect/docs/apis/submission-api/?version=2.0.0-pu#get-/v2/destinations/-destinationId- -
Variante 2 zur Erzeugung einer Einreichung (Basis processDefinitionId & messageFlowId) ist implementiert; Zusatzinformationen (fromDestinationId, …) sind anzugeben/nutzbar. - https://docs.fitko.de/fit-connect/docs/apis/submission-api/?version=2.0.0-pu#post-/v2/submissions -
Prozessrelevante Metadaten werden beim Erzeugen und Auslesen unterstützt; Binding ans neue Metadatenschema (https://schema.fitko.de/fit-connect/metadata/latest-pu/datasets/process-schema.json) ist gegeben. - https://docs.fitko.de/fit-connect/docs/apis/submission-api/?version=2.0.0#put-/v2/submissions/-submissionId-, https://docs.fitko.de/fit-connect/docs/apis/submission-api/?version=2.0.0#get-/v2/submissions/-submissionId- -
Suche von Zustellpunkten umsetzen - https://docs.fitko.de/fit-connect/docs/apis/submission-api/?version=2.0.0-pu#get-/v2/search-destinations/by-process-message, https://docs.fitko.de/fit-connect/docs/apis/submission-api/?version=2.0.0-pu#get-/v2/search-destinations/by-public-service -
Definition of Done wurde überprüft.
Mögliche Folgeaktivitäten
- Anpassungen für die Replies umsetzen
- Anpassungen für die DestinationAPI umsetzen
Offene Fragen
- @ZSD: müsste hier nicht auch die ProcessID & MessageFlowID ausgegeben werden? https://docs.fitko.de/fit-connect/docs/apis/submission-api/?version=2.0.0-pu#get-/v2/destinations/-destinationId-
- bei der Vorgangsverwaltung/Events hat sich nichts geändert - zu klären? -Client‑Konsolidierung: gibt es Anforderungen/Constraints, die gegen einen kombinierten Sender/Empfänger‑Client sprechen (Kompatibilität/Migration)?