Changelog IsyFact Dokumentation

1. Änderungen IsyFact 3.2.0

  • Anhebung der Versionen mehrerer Abhängigkeiten der IsyFact und durch den Produktkatalog vorgegebenen Abhängigkeiten.

1.1. Änderungen Bausteine

  • IFS-1629: Standardmechanismus zur Absicherung der Actuator-Endpunkte auf Basis von WebSecurityConfigurerAdapter wurde bereitgestellt. Aktivieren durch das Setzen der Konfigurationsparameter:

    • isy.ueberwachung.security.username=<username>

    • isy.ueberwachung.security.password=<password>

  • IFS-2395: MessageSourceHolder sowie MessageSourceFehlertextProvider als deprecated markiert

2. Änderungen IsyFact 3.1.0

  • Anhebung der Versionen mehrerer Abhängigkeiten der IsyFact und durch den Produktkatalog vorgegebenen Abhängigkeiten.

2.1. Änderungen im Produktkatalog

  • Anhebung von Versionen:

    • Spring Security auf 5.8.13

2.2. Änderungen Bausteine

  • IFS-3612: isy-aufrufkontext wurde als deprecated gekennzeichnet

  • IFS-3665: Dokumentation: Externe Verweise (literaturextern) von isy-documentation nach isyfact-standards verschoben

  • ISY-808: isy-konfiguration wurde als deprecated gekennzeichnet

  • IFS-3821: isy-security: Thematik zur internen und externen URL bei der Authentifizierung beschrieben

  • IFS-3834: isy-security: Kapitel Authentifizierung & Autorisierung um Multi-Tenancy erweitert.

  • IFS-3051: isy-security: Kapitel zu Multi-Realms um konkrete Vorgabe erweitert.

  • IFS-3763: Dokumentation der Änderungen zu IFS-2248 (Tokenerneuerung isy-batchrahmen)

  • ISY-1061: isy-service-rest Ergänzung der Dokumentation zum Zurücksetzen der Korrelations-ID aus dem MdcHelper

2.3. Änderungen Blaupausen

  • IFS-3992: Entfernung der Vorlage "Tailoring" Dokument

    • IFS-3763: Dokumentation der Änderungen zu IFS-2248 (Tokenerneuerung isy-batchrahmen)

3. Änderungen IsyFact 3.0.1

  • Anhebung der Versionen mehrerer Abhängigkeiten der IsyFact und durch den Produktkatalog vorgegebenen Abhängigkeiten.

3.1. Änderungen im Produktkatalog

  • Anhebung von Versionen:

    • Open CSV auf 5.9.x

    • Google Guava auf 33.1.x

  • Überschreiben von Spring Boot verwalteten Versionen

    • Spring Framework BOM auf 5.3.33

      • Spring Http Invoker

      • Spring Web MVC

      • Spring WebClient

    • Spring Security BOM auf 5.7.12

4. Änderungen IsyFact 3.0.0

  • Umstellung auf Antora-Dokumentation.

  • Entfernung der Vorlageanwendungen.

4.1. Änderungen im Produktkatalog

  • Setzen von Produkten auf bestandsgeschützt:

    • Spring HTTP Invoker

    • Spring Webflow

    • Oracle Mojarra JavaServer Faces

    • Apache MyFaces Tomahawk for JSF 2.0

    • jQuery

    • jquery.timepicker

    • Bootstrap

  • Anhebung von Versionen:

    • Spring Boot auf 2.7.1

    • spring-security auf 5.7.x

    • spring-data-jpa auf 2.7.x

    • Hibernate auf 5.6.x

    • Mockito auf 4.x

    • QueryDSL auf 5.0.x

    • H2 auf 2.1.214

    • node auf 18.x (LTS) zusätzlich zu 16.x (LTS)

    • Metro auf 2.4.9

  • Neue Produkte:

    • Selenium 4.x (empfohlen)

    • Liquibase 4.x

    • Jakarta Annotations 1.3.5

    • JDK Temurin 17 mit Java-Language 8, 17 für Apps, 8 für Libraries

    • Linux 64bit mit Kernel >= 4.12

    • Testcontainers 1.x

    • yarn mit 3.x (pilotieren)

    • npm mit 7.x / 9.x verwaltet durch node (empfohlen)

  • Zeilen zu slf4j konsolidiert.

  • Kategorie für Logging-Produkte zu "Logging" geändert.

  • Produkte auf bestandsgeschützt gesetzt:

    • Spring Webflow

    • Oracle Mojarra JavaServer Faces

    • Apache MyFaces Tomahawk for JSF 2.0.

  • Produkte entfernt:

    • Oracle JDBC

    • Oracle UCP

    • Oracle Database

    • Oracle JDK

    • Suse Enterprise Linux (SLES)

  • Produkt aus IsyFact-Erweiterungen umgezogen:

    • Apache Commons IO 2.x

4.2. Änderungen Einstieg

  • IFS-1278: Dokument IsyFact-Einstieg aufgetrennt und an neue Seitenvorlage angepasst.

  • IFS-1468: Neustrukturierung des Whitepapers anhand aktueller Inhalte von der offiziellen Webseite zur IsyFact.

  • IFS-1547: Migration und Download des Produktkatalogs.

4.3. Änderungen Blaupausen

  • IFS-2383: Grafiken der TI-Architektur aller Umgebungen neu erstellt und an aktuelle Gegebenheiten angepasst.

    • IFS-1796: Änderung der Architekturregel zur Weitergabe von Entitäten

  • IFS-821: Detailkonzept Datenzugriff aufgeteilt. Hibernate-spezifische Teile sind in einen eigenen Baustein "JPA/Hibernate" ausgelagert worden.

  • IFS-1796: Entfernung der Vorgabe zur Implementierung der Embeddable Annotation

  • IFS-1609: Standardisierte Übertragung von Metadaten dokumentiert.

4.4. Änderungen Bausteine

  • IFS-1983: Komponenten können bei Bedarf mehrere Nummernkreise für Fehlerschlüssel verwenden.

    • IFS-1797: Vorgaben zu Hibernate Annotationen LazyToOne und LazyCollections entfernt

  • IFS-2509: isy-security: Kapitel Resource-Owner-Password-Credential Flow als deprecated markiert

  • IFS-2302: Rollen/Rechte-Konfiguration hinzugefügt

  • IFS-1850: Einleitung zu den Nutzungsvorgaben Security hinzugefügt

  • IFS-1852: Kapitel zur Authentifizierung eines Clients mit Client Credentials hinzugefügt

  • IFS-2403: Abschnitt zum OpenId Connect Provider Mock aus isy-security-test hinzugefügt

  • IFS-1854: Umsetzung des Berechtigungsmanagers

  • IFS-1884: Umsetzung: Methodensicherheit

  • IFS-1959: Abschnitt zum Auslesen des Behördenkennzeichens aus Security Context hinzugefügt

  • IFS-1960: Kapitel zur Authentifizierung eines Clients mit Resource Owner Password Credentials hinzugefügt

  • IFS-1885: Abschnitt zur Tokenweitergabe hinzugefügt

  • IFS-2274: Deprecation Warnung zu Konzept des Bausteins isy-service-api hinzugefügt

  • IFS-2274: Deprecation Warnung zu Nutzungsvorgaben des Bausteins isy-service-api hinzugefügt

  • IFS-2277: Deprecation Warnung zu Konzept des Bausteins Sicherheit hinzugefügt

  • IFS-2277: Deprecation Warnung zu Nutzungsvorgaben des Bausteins Sicherheit hinzugefügt

  • IFS-2272: SLES entfernt und Link auf Dokumentation für Language und Encoding unter Linux ergänzt

  • ISY-514: Austausch font-awesome Icons durch Primeicons

  • ISY-516: Entfernen von automatischen Ausblenden von Toast-Notifications

  • ISY-501: Umbenennung der Ressourcen von Styleguide zu Bedienkonzept

  • IFS-2276: Deprecation Warnung zu Konzept des Bausteins Styleguide hinzugefügt

  • Initialer Umzug des Styleguides nach isyfact-standards-doc (alter Ablageort: isy-style)

  • Zustand "fokussiert" für standard Buttons definiert

    • Task Scheduling auf Basis von Spring Boot

      • Konzept neu geschrieben

  • Hinzufügen und Diskussion von Liveness, Readiness und Availability

  • Hinzufügen von konzeptueller Beschreibung des Loadbalancing insb. im Zusammenhang mit Readiness

  • Umzug des Kapitels Loadbalancer-Servlets von den Nutzungsvorgaben in das Konzept

4.5. Änderungen Plattform

4.6. Änderungen Methodik

  • IFS-2272: Vorlage Systementwurf: SUSE Linux durch Linux 64bit Kernel >= 4.12 ersetzt

  • IFS-1941: Dokumentationsvorgaben für IF Bestandteile initial festgeschrieben.

  • IFS-2271: Entfernen von Oracle JDK, stattdessen Verweis auf Produktkatalog

  • IFS-1526: Migration der Vorlage zur Produktauswahl in die Online-Dokumentation.

  • IFS-1524: Migration der Vorlage der Schnittstellendokumentation in die Online-Dokumentation.

  • IFS-1521: Migration der Vorlage der Anforderungsliste in die Online-Dokumentation.

  • IFS-1520: Migration der Vorlage der Systemspezifikation in die Online-Dokumentation.

  • IFS-1519: Migration der Vorlage für Datenflussdiagramme in die Online-Dokumentation.

  • IFS-1515: Migration der Vorlage des Tailoring-Dokuments in die Online-Dokumentation.

  • IFS-1119: Regel zur Erzeugung von Zufallszahlen hinzugefügt.

4.7. Änderungen Werkzeuge

  • IFS-2271: Verweis auf Produktkatalog für JDK und Installationsanweisungen zur Vermeidung von Redundanzen

  • IFS-1548: Anleitung zum Formatieren und Einrichten des Checkstyle Plugins angepasst

  • Initiale Beschreibung zur Verwendung von GUI-Tests mit Selenium

5. Änderungen IsyFact 2.4.0

  • IFS-1162: Interne Verschlüsselung als SOLL-Anforderung an eine Systemlandschaft beschrieben

  • IFS-1092: Übertragungswege von Daten in der internen Servicekommunikation beschrieben

  • IFS-938: Neue Architekturregel zur GUI-Validierung wurde hinzugefügt.

  • IFS-992: Der Abschnitt "IsyFact-konforme Anwendungen" wurde bearbeitet

  • IFS-995: Das Attribut "gekuerzt" wurde in einen anderen Abschnitt verschoben

6. Änderungen IsyFact 2.3.0

  • IFS-624: SAGA-Referenzen durch Architekturrichtlinie der IT des Bundes ersetzt

  • IFS-993: Passagen zum Thema vor Logging-Konzept Version 3.0 wurde entfernt

  • IFS-994: Passagen zum Thema ASV wurden entfernt

  • IFS-536: Die Überschriften wurden korrekt mit ASCIIDOC [[]] Klammern ausprogrammiert

  • IFS-398: Dokument "Konzept Umgang mit Sonderzeichen" angepasst: Bereich bzgl. Properties Dateien im Kapitel Maven

  • IFS-546: Vorgaben für Properties zu komplexen Datentypen ergänzt

7. Änderungen IsyFact 2.2.0

  • IFS-364: Neue IT-Systemtypen – Umbenennung von Fachanwendung zu Geschäftsanwendung

  • IFE-223: Umzug der Session-Dokumentation in den Baustein 'isy-session'

  • IFS-472: Dokument IsyFact-Einstieg überarbeitet.

  • IFS-962: Alte Tickets zur Anpassung der Dokumentation auf Aktualität geprüft und Dokumentation entsprechend angepasst.

  • IFS-962: Alte Tickets zur Anpassung der Dokumentation auf Aktualität geprüft und Dokumentation entsprechend angepasst.

  • IFS-962: Alte Tickets zur Anpassung der Dokumentation auf Aktualität geprüft und Dokumentation entsprechend angepasst.

  • IFS-962: Alte Tickets zur Anpassung der Dokumentation auf Aktualität geprüft und Dokumentation entsprechend angepasst

  • IFS-543: Vorgabe für die Verwendung von Dependency-Injection eingefügt

  • IFS-962: Alt-Tickets zur Anpassung von Dokumentation

  • IFS-962: Alte Tickets zur Anpassung der Dokumentation auf Aktualität geprüft und Dokumentation entsprechend angepasst

  • IFS-993: Passagen zum Thema vor Logging-Konzept Version 3.0 wurde entfernt

Die bereits etablierten Vorgaben zur Quellcodeablage wurden dem Dokument hinzugefügt und Neuerungen wie die Ablage von Dokumenten im AsciiDoc-Format ergänzt.

Durch die Erweiterung des Dokuments wurde eine Restrukturierung der Kapitel notwendig. Alte Verweise auf Kapitelnummern sind daher i.d.R. nicht mehr korrekt!

8. Änderungen IsyFact 2.1.0

  • IFS-352: Zentrales Changelog in Komponenten aufgeteilt; automatische Generierung des zentralen Changelogs

  • IFS-366: Upgrade von asciidoctor-maven-plugin und asciidoctorj-pdf

  • IFS-387: Datei docinfo.adoc entfernen

  • IFS-458: Tidy-Plugin eingebunden, sodass immer ein Check ausgeführt wird. Alle Maven POMs mit tidy:pom formatiert und getestet.

  • IFS-409: Namenskonventionen: Batchparameter eingefügt

  • IFS-363: Maven Central in Tutorial integrieren

  • IFS-263: Hinweis zu Zwischenreleases für Änderungen bei Ressourcen in Versionierungskonzept aufgenommen

  • IFS-279: Anleitung VS Code hinzugefügt und Ausführungsdefinitionen in der pom.xml erläutert

  • IFS-419: Dokumentation für Maven-Versionierungs-Plugin erstellt

9. Änderungen IsyFact 2.0.0

  • IFS-228: Einführung von Spring Boot in die Bausteine der IsyFact-Standards

  • IFS-353: Ablösung von Dozer durch Orika beschrieben

10. Änderungen IsyFact 1.7.0

  • IFS-239: Migration weiterer Dokumente: Anleitung zur Arbeit mit Enterprise Architekt (aus der Vorlage zur Systemspezifikation), IsyFact-Whitepaper

  • IFS-240: Verweis auf Änderungshistorie in jedes Dokument aufgenommen.

  • IFS-311: Auf Nutzung isy-dokumentvorlagen umgestellt

  • IFS-360: Ablageorte einzelner Dokumente korrigiert

  • IFE-45: Vorlagen um Kolophon und PDF-Theme für Closed-Source-Dokumente erweitert

  • IFS-299 & IFS-374: Kopfbereiche der HTML- und PDF-Dokumente neu gestaltet, neue Schriftart für PDF-Dokumente: Caladea

  • IFS-175: Transaktionssteuerung auf Ebene des Anwendungskerns statt in der Nutzungsschicht

  • IFS-295: Abschnitt "Erste Schritte" überarbeitet.

  • IFS-294: Ablageorte der Referenzarchitektur sowie der Checkstyle-Konfiguration korrigiert

  • IFS-298: Tutorial auf Maven Central umgestellt

  • IFS-361: Template Anpassung Tutorial (Tabellenformatierung)

  • IFS-270: Hinweis zu Korrelations-IDs (UUID statt Batch-ID) bei Batches hinzugefügt

  • IFS-225: Anpassung der Logging-Nutzungsvorgaben aufgrund Änderungen im Logging-Framework (Begrenzung Log-Länge)

11. Änderungen IsyFact 1.6.0

  • IFS-189: Dokumentation an neues Repository isyfact-standards angepasst

  • IFS-159: Vorhalten von Skripten zum Aktualisieren von DB-Schemas konkretisiert

  • IFS-187: Überführung technischer Anteile aus Styleguide in Detailkonzept Web-GUI

  • IFS-218: Hinweise zu DSGVO-Markern für das Logging hinzugefügt

  • IFS-177: Betriebliche Behandlung von Batch-Logs

  • IFS-196: "Leitfaden Entwicklungsumgebung" aufgelöst, Inhalte in "Einrichtung Entwicklungsumgebung" migriert

  • IFS-269: Einrichtung Entwicklungsumgebung: Gliederungsebenen korrigiert