Zum Hauptinhalt springen

Häufig gestellte Fragen

Welche Auswirkungen bringt der Major Release mit sich?

Der Major Release dient der Steigerung der Wartbarkeit, Stabilität und Zukunftssicherheit von FIT-Connect und führt einen jährlichen Release-Zyklus für bessere Planbarkeit ein. Die wichtigsten Auswirkungen lassen sich in drei Bereiche gliedern:

  1. Versionswechsel und Übergang: Alle zentralen Komponenten, darunter die Submission-API, Destination-API, Routing-API und das Metadatenschema, stehen in der neuen Version oder höher zur Verfügung. Alle älteren API- und Metadatenschema-Versionen werden abgekündigt und sind nur noch für eine Übergangsfrist von einem Jahr parallel gültig und werden unterstützt. Innerhalb dieses Jahres muss die Umstellung auf die neue Version erfolgen.
  2. Verbindliche Regeln und Bereinigungen: Eine der wichtigsten verbindlichen Änderungen ist: Es ist nicht mehr möglich, Einreichungen (Submissions) ohne Fachdaten zu versenden. Entsprechend ist die Angabe von contentStructure.data im neuen Metadatensatz nun verpflichtend. Abgekündigte oder überfällige Komponenten und Bezeichnungen wurden entfernt oder konsolidiert, z. B. die Umbenennung von serviceType und services in publicService bzw. publicServices zur besseren Verständlichkeit im Zusammenhang mit Verwaltungsleistungen.
  3. Neue Features und Optimierungen: Das neue Metadatenschema wurde optimiert und modularisiert. Es führt das neue dataSets-Array ein, welches Flexibilität bei externen Daten (z. B. Authentifizierungs- oder Bezahlinformationen) ermöglicht.Das Self-Service-Portal (SSP) erhält neue Funktionen, wie einen Entwurfsmodus für Zustellpunkte, eine Pagination in großen Listen und ein neues Design.
Was muss von Nutzenden von FIT-Connect gemacht werden und bis wann?

Der Major Release erfordert von allen Nutzenden die vollständige Umstellung der Anbindungen auf die neuen Versionen. Was muss gemacht werden? Die Hauptanforderung besteht in der Migration der verwendeten Schnittstellen und Schemata:

  1. Versionswechsel: Die Anbindungen müssen auf die neuen Komponenten in der neuen Version oder der nächst höheren umgestellt werden. Betroffen sind unter anderem die Submission-API, die Destination-API, die Routing-API und das Metadatenschema.
  2. Unterstützung des neuen Metadatenschemas: Fachverfahren sollten das Metadatenschema in der neuen Version technisch unterstützen und diesen Status im Self-Service-Portal eintragen.
  3. Pflicht der Fachdaten: Technisch ist sicherzustellen, dass Einreichungen (Submissions) nicht mehr ohne Fachdaten versendet werden. Damit ist die Angabe von contentStructure.data im neuen Metadatensatz verpflichtend.
  4. Beseitigung alter Events: Events vom Typ forward-submission werden über die neue Submission API nicht mehr akzeptiert und können auch nicht mehr ausgelöst werden.
  5. SDK-Anpassung: Bei Verwendung der SDKs (Java oder .NET) muss auf die letzte gültige Version oder höher migriert werden.
Sind für den Major Release Implementierungen/Programmierungen notwendig? Durch wen werden diese durchgeführt?

Ja, umfassende Implementierungen und Anpassungen sind notwendig. Da der Major Release sogenannte Breaking Changes enthält, ist eine Migration der angebundenen Systeme auf die neuen Versionen erforderlich. Werden diese Änderungen nicht umgesetzt, ist der ordnungsgemäße Betrieb der **nicht-**migrierten Systeme nicht möglich. Wer muss die Implementierung vornehmen? Die Programmierungen müssen durch den Hersteller oder das Entwicklungsteam der angebundenen Software (Fachverfahren oder Onlinedienst) vorgenommen werden. Dies liegt daran, dass alle zentralen Schnittstellen, über die die Software mit FIT-Connect kommuniziert, von den Änderungen betroffen sind:

  1. Die verwendeten APIs (Submission, Destination, Routing) müssen auf die neue Version oder höher umgestellt werden.
  2. Falls Software Development Kits (SDKs) genutzt werden (Java oder .NET), ist eine Migration auf die neue Version oder höher erforderlich.
  3. Das Metadatenschema muss auf die neue Version umgestellt werden.

Welche Anpassungen sind unter anderem notwendig? Zu den wichtigsten Implementierungsaufgaben gehört die Umsetzung der verbindlichen Änderungen:

  1. Pflicht der Fachdaten: Es ist nicht mehr möglich, Einreichungen (Submissions) ohne Fachdaten zu versenden. Das Feld encryptedData in der Submission API v2 ist nun verpflichtend.
  2. Metadatenschema: Die Angabe von contentStructure.data ist verpflichtend.
  3. Abgekündigte Komponenten: Events vom Typ forward-submission werden über die Submission API v2 nicht mehr akzeptiert und dürfen nicht mehr ausgelöst werden.
  4. Umbenennungen: Felder wie serviceType und services werden zur besseren Verständlichkeit in publicService bzw. publicServices umbenannt. Die alten Versionen sind abgekündigt und funktionieren nur noch für eine Übergangsfrist von einem Jahr parallel zu den neuen Versionen. Die Umstellung muss innerhalb dieses Jahres erfolgen. Bei Fragen zur technischen Umsetzung des Major Releases steht das Team von FIT-Connect unterstützend zur Verfügung.
Ist im Rahmen des Major Releases mit Serviceunterbrechungen oder -ausfällen zu rechnen?

Nein, im Rahmen des Major Releases wird mit keinen besonderen Risiken gerechnet. Eventuelle Serviceunterbrechungen oder -einschränkungen sind auf die üblichen Deployment- und Backup-Zeiten beschränkt, die im Vorfeld angekündigt werden.

Welches übergeordnete Ziel wird mit der Einführung der Major Releases verfolgt?

Ziel der Major Releases ist die Steigerung von Wartbarkeit, Stabilität und Zukunftssicherheit der FIT-Connect-Plattform. Dies wird durch folgende Maßnahmen erreicht:

  1. Planbarkeit: Es wird ein fester, jährlicher Release-Zyklus im Herbst eingeführt. Dies soll für eine bessere Planbarkeit und Struktur bei der Weiterentwicklung zukünftiger Features sorgen.
  2. Bündelung großer Änderungen: Geplante und potenzielle Anpassungen, die sogenannte Breaking Changes (nicht abwärtskompatible Änderungen) enthalten, werden gebündelt, bewertet und priorisiert.
  3. Bereinigung: Überfällige Anpassungen, wie das Entfernen von abgekündigten Komponenten und die Konsolidierung uneinheitlicher Bezeichnungen, werden umgesetzt.
Wo erhalten wir Unterstützung bei organisatorischen oder technischen Fragen zur Umstellung?

Nutzende können bei Fragen und Unterstützungsbedarf folgende Stellen kontaktieren:

  1. Technische Umsetzung und Migration: Bei Fragen zur technischen Umsetzung des Major Releases, zur Integration neuer API-Versionen oder bei Migrationsfragen steht das IT-Support-Team zur Verfügung.
  2. Organisatorische und allgemeine Fragen: Für organisatorische oder allgemeine fachliche Rückfragen rund um das Major Release dient das Anbindungsmanagement von FIT-Connect als zentrale Koordinationsstelle.