Inkompatible Änderungen in Version 3.0.0

  • Dieses Thema ist leer.
  • Beitrag
    • 12. Januar 2023 um 13:22 Uhr
    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.

      HTTP-Ausgangsadapter

      Bei Nutzung der Interaktion SEND werden bei der Erzeugung der Antwortnachricht die Response -Header-Namen als XML-Elementnamen verwendet.
      Bei einer JSON-Response werden die JSON-Namen als XML-Elementnamen im Ergebnis verwendet.

      HTTP-Eingangsadapter

      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.