Inkompatible Änderungen in Version 3.0.0

  • Dieses Thema ist leer.
  • Beitrag
    Markus Franke
    Administrator
    In diesem Dokument finden Sie Hinweise, welche inkompatiblen Änderung in Version 3.0.0 enthalten sind. Sie sind zur besseren Orientierung thematisch sortiert, damit Sie leichter prüfen können, ob Sie von einer Änderung betroffen sind und wie Sie Ihre Anwendungen daran anpassen können.

    Logging

    Das von TRANSCONNECT verwendete Logging-Framework wurde von log4j 1 auf log4j 2 aktualisiert. Damit wurden mehrere Sicherheitslücken geschlossen. TRANSCONNECT verwendet nun ein neues Interface zum loggen, com.sqlag.tc.logging.Logger.

    Sollten Sie in Java geschriebene Klassen in Ihren Projekten einsetzen dann ist ein erneutes Kompilieren Ihrer Quellen gegen das neue TRANSCONNECT SDK notwendig. Dabei muss das import-Statement des Loggers angepasst werden:

    bis Version 2.3.5 ab Version 3.0.0
    import org.apache.log4j.Logger;
    import com.sqlag.tc.logging.Logger;
    import org.apache.logging.log4j.Level;
    import com.sqlag.tc.logging.Level;

    Für detaillierte Informationen zur Verwendung des Interface und der Methoden konsultieren Sie bitte die in Ihrer Installation enthaltene Javadoc.

    Zeitgesteuerte Aufgaben

    Alle loggenden zeitgesteuerten Aufgaben sind von den Veränderungen im Logging betroffen. Beim Update auf Version 3, oder wenn Sie ein altes Repository in einen TRANSCONNECT® der Version 3 einspielen, kann es passieren, dass Sie ein manuelles Update der sampletasks.jar durchführen müssen. Dafür einfach eine aktuelle Version der Datei per Drag&Drop in den Manager ziehen und die alte Version ersetzen (hier zB für Version 3.2.0: sampletasks – entzippen nicht vergessen).

    PDF-Adapter

    Die Bibliothek pdfbox wurde aufgrund verschiedener Sicherheitslücken (CVE-2021-27807, CVE-2021-27906, CVE-2021-31812, CVE-2021-31811) aktualisiert. Der durch die Adapterinteraktion READ zurückgegebene PDF-Inhalt kann sich jetzt vom bisher zurückgegebenen Output unterscheiden. Betroffen davon sind z.B. Textpassagen die auf einer Halbzeile stehen.
    TRANSCONNECT Versionen < 3.0.0 generieren für diese Textpassagen eine neue Zeile im Output.

    <LINE NUMBER="3">MUSTERLIEFERANT GMBH  MUSTER-KUNDE GMBH</LINE>
    <LINE NUMBER="4">Beleg-Nr           : RK21012345</LINE>

    Ab TRANSCONNECT Version 3.0.0 erscheinen diese Textpassagen u.U. in einer Zeile zusammen

    <LINE NUMBER="3">MUSTERLIEFERANT GMBH  MUSTER-KUNDE GMBH  Beleg-Nr           : RK21012345</LINE>

    Bitte prüfen Sie in Ihren Projekten, ob bei der Weiterverarbeitung des Outputs Anpassungen notwendig sind.

    HTTP-Ausgangsadapter

    Verbindungsart OAuth 2.0/OpenID – Passwort

    Wenn die Adaptereigenschaft “Scope” nicht konfiguriert worden ist, wurde bis Version 2.3.5 der Wert “openid” in der Authentifizierungsanforderung gesendet. Ab Version 3.0.0 wird dieses Feld nicht mit übertragen, wenn es nicht konfiguriert worden ist.

    Falls Sie diesen Adapter ohne Scope verwenden, können Sie den Wert “openid” konfigurieren um das bisherige Verhalten abzubilden.

    Nutzung der globalen Java-Property http.nonProxyHosts

    Der Wert dieser globale Java-Property wurde bis Version 2.3.5 als regulärer Ausdruck behandelt. Das widersprach der offiziellen Beschreibung dieser Property.
    Ab Version 3.0.0 wird diese Property jetzt korrekt ausgewertet.

    Wenn Sie diese globale Java-Property in den Startskripten bzw. der Dienstkonfiguration gesetzt haben, prüfen Sie bitte, ob eine Anpassung notwendig ist.
    Erlaubt ist als Wildcard nur das *-Zeichen. Als Trennzeichen kann | verwendet werden.

    Beispiel:

    bis Version 2.3.5 ab Version 3.0.0
    localhost|.*\sql\-ag\.de|www\.google\.???
    localhost|*.sql-ag.de|www.google.*

    Erzeugung von XML-Elementen

    An verschiedenen Stellen werden XML-Elemente erzeugt, die auf Input- oder Antwort-Daten von Drittsystemen basieren. Ist ein Datum zur Bildung eines XML-Elementnamens nicht geeignet, wird es mit _-xx umschrieben, wobei xx für den Hexcode des Zeichens steht. Bei dieser Umschreibung wurden auch Zeichen ersetzt, die in XML erlaubt sind (z.B. das Minuszeichen -). Diese unnötige Konvertierung wurde mit Version 3.0.0 korrigiert.
    Beispiel:
    statt <Content_-2dType> wird jetzt <Content-Type> erzeugt.

    Im folgenden werden alle relevanten Komponenten von TRANSCONNECT aufgeführt, bei denen diese Änderungen auftreten können. Bitte prüfen Sie in Ihren Projekten, ob bei der Weiterverarbeitung der jeweiligen XML-Strukturen die erwähnten Elemente verarbeitet werden und Anpassungen notwendig sind.

    SAP-Ausgangsadapter

    Bei Nutzung der Interaktion CALLRECEIVE werden in der Antwortnachricht die Parameternamen als XML-Elementnamen verwendet.

    Bei einer JSON-Response werden die JSON-Namen als XML-Elementnamen im Ergebnis verwendet.

    Bei der Erstellung der Eingangsnachricht werden die Namen der Parameter und Header als XML-Elementnamen verwendet.
    Bei einer JSON-Anfrage werden die JSON-Namen als XML-Elementnamen im Ergebnis verwendet.

    Prozessaktivität Konverter JSON->XML

    Bei dieser Aktivität werden die JSON-Namen als XML-Elementnamen im Ergebnis verwendet.

    XSLT-Transformationen

    Wenn in der Transformation:

    • die Mappingklassenmethode com.sqlgmbh.tc.sample.mapping.Attachments.getAll oder
    • die Mappingklassenmethode  com.sqlgmbh.tc.sample.mapping.Validation.buildNodeName genutzt wird

    kann sich das Ergebnis dieser Funktionsaufrufe ändern.

    Datenbank-XML/XSD-Assistent im Manager

    Dieser Assistent verwendet Spaltennamen für die Bildung von XML-Elementnamen im Ergebnisdokument.

    0
    0
  • Du musst angemeldet sein, um auf dieses Thema antworten zu können.