Zudem kann er nicht mehr verändert werden, da sonst ggf. vorhandene Referenzen ins Leere laufen würden.

Hintergrund: Wir wollen, in einem der nächsten Updates, die Verwendung der Alias-Namen für Einstellungen, die auf Datenbanken verweisen, erzwingen.

Für bestehende DB-Verbindungen ohne Alias wird im Zuge des SQL-Updates ein Standard-Alias in der Form "DB_{id}" vergeben. Das kann unter äußerst unwahrscheinlichen Umständen zu einem Fehler im cardo-SQL-Update führen, sofern ein solcher Alias bereits bei einer anderen DB-Verbindung hinterlegt ist.

Im SQL-Update 309 kommt dann ein Fehler wie "duplicate key value violates unique constraint" (abhängig von Datenbank, Version, Spracheinstellung, ...). In dem Fall müssen Sie für diese Verbindung einen Alias direkt in der cardo-Metadatenbank eintragen (Tabelle: xref_prop_db_server, Spalte: uniqueid).

Sollten Sie diesen Hinweis noch vor dem Einspielen des Updates lesen, wird empfohlen, allen Datenbanken über das cardo3-Managementcenter noch einen Alias zu vergeben, sofern das nicht bereits geschehen ist.

Die Verwaltung der Datenbanken ist auch in den cardo4 Einstellungen vorhanden. Nachdem der Alias vergeben wurde, sollten Sie alle weiteren Einstellungen dort vornehmen.

Bei allen cardo4 Anwendungen wird zudem ein Auswahlfeld für die Datenbankeinstellung angeboten. Wir empfehlen alle Anwendungen durchzugehen und überall einen Alias zu verwenden. D.h. überall wo ein Connection-String oder eine ID hinterlegt ist, sollten sie die Einstellungen anpassen.

Geplant ist in einer späteren Version den Einsatz von DB-Aliasen zu erzwingen.

Achten Sie bei der Verwendung des Microsoft Edge darauf, das keine Einstellungen hinterlegt sind, die den IE Modus im Edge für die Seite aktivieren.

Der Treiber verhält sich teilweise deutlich anders als Version 2. Dies betrifft zwei wesentliche Aspekte:

• Es ist nur eine aktive Abfrage pro Connection möglich und der Treiber unterstützt kein "MARS".

  Intern wird bei Bedarf von IDU.DB eine zweite Connection geöffnet. Bedingung dabei ist, dass keine Transaktion aktiv sein darf. Falls das doch der Fall ist, wird ein Fehler ausgelöst.

• Die Konvertierungsregeln für die Datentypen sind teilweise deutlich anderes, das betrifft u.a. JSON/JSONB und Datums-/Uhrzeittypen.

• Es sind diverse abhängige Assemblys damit verbunden. Dies ist insofern problematisch, da dies zu Versionskonflikten mit anderen Komponenten führt. Die "AssemblyBindingRedirects" der Anwendungen müssen korrekt gesetzt sein.

  Der cardo Updater passt die web.configs entsprechend an. Prüfen Sie ggf., ob damit Konflikte in ihrer Installation einhergehen, wenn Sie eigene Anwendungen erstellt haben.

Folgende Argumente aus der Verbindungszeichenfolge (diese sind als obsolet markiert) werden automatisch entfernt:

• "Connection Lifetime"
• "Continuous Processing"
• "Backend Timeouts"
• "Preload Reader"
• "Use Extended Types"
• "Use Ssl Stream"

Für Entwickler:

Bei der Verwendung von IDU.DB.PGDataBaseHandler bzw. IduIT.Core.Data.ORM Methoden sollten die Änderungen "weggekapselt" sein.

Hier eine kleine Liste von Hinweisen:

• Beim Abrufen von Geometrien in selber erstellten Abfragen muss die Geometry als Bytea gecastet werden, "the field geom has type 'public.geometry', wich is currently unknown to Npgsql".

  Wir haben einen Typ-Konverter hinterlegt, der Geometrien immer als Hex-String der Bytea- Repräsentation ausgibt. Dies ist vorerst aus Gründen der Kompatibilität zu "altem" Programmcode erforderlich.

• null in Parametern muss als DBNull.Value übergeben werden.

• Es werden nun öfters Connection "geclont" (siehe oben). Wenn Initialisierungs-Statements verwendet werden (bspw. set search_path...), dann achten Sie darauf, dass im Code dazu die Methode ExecuteInitializeStatement verwendet wird. Alle hier abgesetzten Statements werden auch beim clone der Verbindung wieder ausgeführt.

  ExecuteInitializeStatement hat jetzt eine neue Überladung, bei der auch Parameter übergeben werden können.

• Vermeiden Sie das Erstellen neuer Connections durch sorgfältige Verwendung von Datenbankzugriffen in Schleifen, die auf einem IEnumerable / einem Reader basieren!

Bsp.:

foreach(var rec in Orm.GetMany<meinType>())
{
    Orm.GetScalar<int>("Select ... ");
}

führt dann dazu, dass mindestens eine weitere Datenbankverbindung geöffnet wird. Bzw. der Code wird eine Exception auslösen, wenn für die Datenbank eine Transaktion erstellt wurde.

• Die Angabe des Encoding im Connectionstring wird als Client-Encoding gesetzt, das Encoding ist immer UTF8 (die IDUDB-Klassen setzen dies intern so, weitere Anpassungen sind nicht erforderlich).

Kompilieren Sie den Code neu. Beachten Sie auch die Abhängigkeiten zu DLLs, die leider recht umfangreich ausgefallen sind, vor allem mit Blick auf die Kompatibilität zu anderen Komponenten.

Verwendet werden jetzt:

• System.Buffers
• System.Numerics.Vectors
• System.Runtime.CompilerServices.Unsafe
• System.Threading.Tasks.Extensions
• Microsoft.Bcl.AsyncInterfaces
• System.Text.Encodings.Web
• System.Text.Json

Für Betreuer / Datenbankadministratoren

Sollten Sie PostgreSQL Version 9.4 für die Steuerdatenbank verwenden, müssen Sie auf eine aktuellere PostgreSQL Version aktualisieren.

BreakingChange: Die Schriftnamen wurden angepasst. Wir haben die Versionsnummer aus dem Schriftartnamen entfernt.

D.h => Alt: "Font Awesome 5 Pro", Neu :"Font Awesome Pro", dies betrifft auch alle Varianten (Solid, Regular etc.).

Neu ist die Variante "thin", die SCSS Mixins und die TS Funktionen wurden entsprechend erweitert. Das verwendete Suffix ist dabei "fat" (Font Awesome thin).

Für Entwickler:

Bei der Verwendung der SCSS Mixins spielt dies keine Rolle. Sie sollten die SCSS Dateien nach dem Update neu kompilieren.

Suchen Sie sonst nach allen Vorkommen von "Font Awesome 5" und passen Sie die Stellen an. Denken Sie dabei auch an *.html Dateien usw.!

Für Betreuer:

Die Anwendungsregistrierung für den Druckvorlagen-Designer muss im "alten" ManagementCenter neu eingelesen werden (nur wg. dem Icon)