12.4 Harmony-Release

12.4 Harmony-Release

Das 12.4 Harmony-Release wird gestaffelt nach den unten aufgeführten Daten und Zeiten nach Komponente und Region durchgeführt. Eine detailliertere Erklärung des Release-Rhythmus nach Komponentenkategorie finden Sie im Release-Plan.

App Builder 4.60 und Wevo iPaaS haben separate Versionshinweise.

Zusammenstellungen von Versionshinweisen für Production Cloud Agent Groups, Sandbox Cloud Agent Groups und private Agents sind ebenfalls verfügbar.

Wartungsmitteilungen für webbasierte Komponenten können unter Jitterbit Trust abonniert werden. Lokal installierte Komponenten sind auf der Seite Downloads verfügbar. Docker private Agent-, private API Gateway- und App Builder-Images sind auf Jitterbit's Docker Hub verfügbar. Das Supportende für diese Komponenten (außer App Builder) liegt ein Jahr nach dem Release-Datum.

Neue Funktionen

Connectors

• WebCrawler-Connector
  Der WebCrawler-Connector kann mit Cloud- oder privaten Agents zum Crawlen von Websites verwendet werden.

Verbesserungen

Agent

• PostgreSQL-Upgrade
  Die mit dem Agent gebündelte PostgreSQL-Version wurde aktualisiert, um die Sicherheit und Leistung zu verbessern.

• SQLite JDBC-Treiber-Upgrade
  Der SQLite JDBC-Treiber, der mit dem Agent gebündelt ist und vom Studio Database Connector, einer Design Studio Database-Quelle oder einem Ziel verwendet wird, wurde aktualisiert.

• URLEncode-Unterstützung für Multibyte-Zeichen
  Die Funktion URLEncode in Studio und Design Studio unterstützt nun Multibyte-Alphabetzeichen als Eingabe, einschließlich erweiterter lateinischer Zeichen, die in Sprachen wie Portugiesisch und Deutsch verwendet werden, sowie nicht-lateinischer Zeichen, die in Sprachen wie Russisch und Chinesisch verwendet werden.

Agent und Studio

• ServiceMax- und Salesforce Service Cloud-Connector-Unterstützung für OAuth 2.0
  Die ServiceMax- und Salesforce Service Cloud-Verbindungen verfügen über ein neues Menü Authentifizierungstyp, in dem Sie Basic Auth (Standard, bereits vorhanden) oder OAuth 2.0 Client Credentials (neu unterstützt) auswählen. OAuth 2.0 erfordert Agent-Version 11.59 für 11.x-Agents oder 12.4 für 12.x-Agents. Siehe Salesforce OAuth 2.0-Voraussetzungen.

API Manager

• OpenAPI-Dokumentation für einzelne APIs
  Die Schublade API-Details auf der Seite APIs enthält nun eine Registerkarte Dokumentation für veröffentlichte benutzerdefinierte, Proxy- und OData-APIs, auf der Sie OpenAPI-Dokumentation für eine einzelne API anzeigen, bearbeiten, neu generieren und veröffentlichen können. Zuvor konnte man API-Dokumentation nur in Bulk für alle APIs in einer Umgebung bearbeiten und veröffentlichen.

• Neu gestaltete Seite „API-Protokolle"
  Die Seite API-Protokolle verfügt über eine neu gestaltete Benutzeroberfläche, die die schrittweise Einführung angekündigt in 11.59 / 12.3 fortsetzt. Organisationen, die bereits auf die neue Benutzeroberfläche der Seite Analytics aktualisiert haben, erhalten dieses Update mit 12.4; diejenigen, die noch nicht aktualisiert haben, erhalten beide Benutzeroberflächen zusammen, wenn die Einführung sie erreicht. Bei Interesse an frühem Zugriff wenden Sie sich an den Jitterbit-Support. Bis dahin bleibt die vorherige Benutzeroberfläche als Benutzeroberfläche Legacy-API-Protokolle verfügbar. Die neue Benutzeroberfläche umfasst:

  • Einheitliche API- und Operationsprotokolle: Operationsprotokolle für API-ausgelöste Operationen werden nun zusammen mit API-Protokollen angezeigt und bieten End-to-End-Sichtbarkeit in die API-Aufrufsverarbeitung.

  • Protokollierung nicht autorisierter Zugriffe: 401 Unauthorized-Zugriffsversuche über ein privates API-Gateway werden nun mit dem entsprechenden Statuscode gemeldet.

  • Neue Suche: Erweiterte Operatorunterstützung (=, !=) und Wildcard-Musterabgleich, wobei mehrere Kriterien mit Semikola kombinierbar sind.

  • Gespeicherte Abfragen: Abfragen können gespeichert, wiederverwendet, bearbeitet und gelöscht werden.

  • Neu gestaltete Zeitraumauswahl: Wählen Sie aus vordefinierten relativen Bereichen oder geben Sie einen absoluten Datumsbereich mit den neuen Registerkarten Relativ und Absolut an.

  • Neue Spalten: API-Gateway und Gateway-Typ zeigen den Domänennamen und den Typ (Öffentlich oder Privat) des Gateways an, das die Anfrage verarbeitet hat. Die Spalten Agent, Umgebung und Projekt sind nun ebenfalls verfügbar.

  • Spalten filtern: Spaltensichtbarkeit und -reihenfolge können angepasst werden.

  • Ausführungsbaumansicht: Umschalten, um Protokolleinträge als verschachtelte Hierarchie von übergeordneten und untergeordneten Operationen anzuzeigen.

  • Umschalten zum Anzeigen von Anfrage- und Antwort-Payloads: Ein neuer Umschalter auf der Registerkarte Einstellungen der benutzerdefinierten API- und OData-API-Konfiguration bestimmt, ob Anfrage- und Antwort-Payloads angezeigt werden.

  • Protokolldetails-Schublade: Klicken Sie auf einen beliebigen Protokolleintrag, um API-Informationen, Aufrufsheader und Anfrage-/Antwort-Payload (wenn der neue Umschalter aktiviert ist) sowie Debug-Trace-Informationen (wenn Debug-Protokollierung aktiviert ist) anzuzeigen.

• Aktualisierte Kartenansicht ersetzt veraltete Kachelansicht
  Die veraltete Kachelansicht auf der Seite APIs wurde durch eine aktualisierte Kartenansicht ersetzt. Karten zeigen nun alle API-Details direkt an, ohne dass eine Hover-Interaktion erforderlich ist, und jede Karte enthält eine Services-Anzahl, die in der Kachelansicht zuvor nicht angezeigt wurde.

API Manager und Management Console

• Filterzählabzeichen auf dem Filtersymbol
  Das Filter-Symbol auf der Seite APIs im API Manager und auf den Seiten Projekte, Client-Zertifikate und Message Queues in der Management Console zeigt nun ein numerisches Abzeichen an, das die Gesamtanzahl der aktiven Filter anzeigt, wenn das Filterfenster eingeklappt ist.

Connectors

• Snowflake Query v2-Aktivität
  Die neue Snowflake Query v2-Aktivität unterstützt Abfragen über mehrere Tabellen in verschiedenen Schemas mit mehreren Joins. Das Antwortschema wird automatisch basierend auf den während der Aktivitätskonfiguration ausgewählten Feldern generiert.

• Workday Prism Analytics Connector API v3-Unterstützung
  Eine Workday Prism Analytics-Verbindung verfügt nun über ein Menü API-Version, um die Workday Prism Analytics REST API-Version v2 (Standard, vorhanden) oder v3 (neu unterstützt) auszuwählen.

EDI

• Verbesserte Analyseerstellung
  Der Bericht zum Transaktionsvolumen auf der Seite Analytics bietet neue Visualisierungs- und Gruppierungsoptionen:

  • Ein Dropdown Anzeigen nach ermöglicht es, die Gesamttransaktionszahlen anzuzeigen oder Daten nach Handelspartner, Dokumenttyp oder Status zu gruppieren, mit gestapelten Balkendiagrammen und farbcodierten Legenden für jede Gruppierung.

  • Die Schaltflächen und für den Diagrammtyp wechseln zwischen Balken- und Linienansichten.

  • Die Gruppierung Status enthält einen Filter Alle Status und zeigt Transaktionstrends über System- und benutzerdefinierte Transaktionsstatus hinweg.

• Filter „Nachrichtentypen" auf der Seite „Messaging"
  Der Bereich Filter auf der Seite Messaging enthält nun einen Abschnitt Nachrichtentypen, mit dem Sie Nachrichten nach Kategorien auf oberster Ebene wie Kommunikation und Transaktion filtern können.

Management Console

• Self-Service-Konfiguration der API-Subdomäne
  Organisationsadministratoren können nun die API-Subdomäne einer Organisation direkt auf der Seite Organisationen konfigurieren. Die API-Subdomäne definiert den Subdomänenteil der vom API-Gateway verwendeten Basis-API-URL. Eine schreibgeschützte Vorschau der Basis-API-URL zeigt die resultierende URL an, und ein Bestätigungsdialog warnt davor, dass vorhandene Integrationen, die die aktuelle URL verwenden, nach dem Speichern möglicherweise aktualisiert werden müssen.

• Y-Achsen-Beschriftungen auf der Seite „Agent Metrics"
  Die Seite Agent Metrics zeigt nun Y-Achsen-Beschriftungen auf allen Diagrammen an, die die Maßeinheit für jedes Diagramm angeben. Statusbasierte Diagramme zeigen Health Status auf der Y-Achse an, und Kapazitäts- und Aktivitätsdiagramme zeigen die relevante Einheit an, z. B. % Thread Pool-Auslastung, Anzahl der Operationen oder Anzahl der Protokolle.

• Verbesserungen auf der Runtime-Seite
  Die Seite Runtime weist die folgenden Verbesserungen auf:

  • Paginierung: Seiten enthalten nun ungefähr 100 Operationen. Um verknüpfte Operationsketten intakt zu halten, sind alle untergeordneten Operationen der letzten übergeordneten Operation auf einer Seite enthalten, auch wenn die Gesamtzahl 100 überschreitet.

  • Abfragen: Erweiterte Operatorunterstützung (=, !=) und Wildcard-Musterabgleich, wobei mehrere Kriterien mit Semikola kombiniert werden können. Für genaue !=-Ergebnisse deaktivieren Sie den Umschalter Ausführungsstrukturansicht.

Marketplace

• Aktualisierte Kartenansicht ersetzt veraltete Kachelansicht
  Die veraltete Kachelansicht in Marketplace wurde durch eine aktualisierte Kartenansicht ersetzt. Durch Klicken auf eine Karte wird nun ein Details-Panel geöffnet, das eine Beschreibung des Assets zusammen mit anderen Asset-Informationen enthält.

Studio und Management Console

• Rollenbasierte Projektsichtbarkeit
  Studio-Projekte können nun so konfiguriert werden, dass gesteuert wird, welche Organisationsrollen das Projekt sehen können. Dies kann an den folgenden Stellen konfiguriert werden:

  • Management Console: Verwenden Sie die neue Registerkarte User roles auf der Seite Projects der Management Console, auf die nach Auswahl eines Projekts zugegriffen werden kann.

  • Studio: Verwenden Sie die neue Registerkarte User roles im Projektkonfigurationsbildschirm, auf den über die Projekteinstellungen oder die Aktion User roles auf der Seite Projects von Studio zugegriffen werden kann.

  Wenn ein neues Projekt erstellt wird, ist es standardmäßig für alle Mitglieder der Rollen sichtbar, zu denen der erstellende Benutzer gehört, und immer für alle Mitglieder der Rolle Administrator. Bei Projekten, die vor dieser Version vorhanden waren, sind alle Rollen mit Zugriff auf die Umgebung standardmäßig aktiviert.

Studio

• Operationsoption zur Ausführung auf einem dedizierten Agent
  Eine neue Option Run on dedicated agent in der Registerkarte Options der Operationseinstellungen ermöglicht es, eine Operation auf einem bestimmten Agent innerhalb einer privaten Agent-Gruppe auszuführen, deren Agent group class auf High Availability eingestellt ist. Diese Option ist für Troubleshooting-Szenarien wie das Reproduzieren eines Fehlers auf einem bestimmten Agent oder das vorübergehende Umgehen eines problematischen Agents bei Beibehaltung der Funktionsfähigkeit der restlichen Gruppe vorgesehen.

• Autoselect-Abhängigkeiten-Umschalter für Projektimport
  Die Funktion project import verfügt über einen neuen Umschalter Autoselect dependencies (standardmäßig aktiviert), der steuert, ob erforderliche Abhängigkeiten automatisch einbezogen werden, wenn Komponenten zum Importieren ausgewählt werden. Deaktivieren Sie ihn, um einzelne Komponenten auszuwählen, ohne ihre Abhängigkeiten automatisch einzubeziehen.

• Salesforce API Version 65 Support
  Die Connectoren Salesforce, ServiceMax und Salesforce Service Cloud verwenden nun automatisch Salesforce API Version 65, wenn ihre jeweiligen Verbindungen mit OAuth 2.0 Client Credentials konfiguriert sind (siehe Salesforce OAuth 2.0 Voraussetzungen). Verbindungen, die mit Basic Auth konfiguriert sind, verwenden weiterhin Salesforce API Version 64.

• Salesforce Bulk Activity Concurrency Mode
  Die Salesforce-Aktivitäten Bulk Insert, Bulk Update, Bulk Upsert, Bulk Delete und Bulk Hard Delete verfügen über eine neue Einstellung Concurrency mode unter Optional settings. Wählen Sie Parallel (Standard, wie bisher) oder Serial (neu unterstützt), um zu steuern, wie Salesforce den Bulk-Datenladejob verarbeitet.

• Salesforce-Verbindung mit Unterstützung für mehrbyte-Passwörter
  Die Verbindungen Salesforce, Salesforce Service Cloud und ServiceMax unterstützen nun mehrbyte-Alphabetzeichen in Passwörtern, einschließlich erweiterter lateinischer Zeichen, die in Sprachen wie Portugiesisch und Deutsch verwendet werden, sowie nicht-lateinischer Zeichen, die in Sprachen wie Russisch und Chinesisch verwendet werden.

Änderungen

Harmony-Plattform

• Erforderliche Maßnahme: Einstellung von Legacy-SSO-Umleitungs-URLs
  Jitterbit stellt mit dieser Version 12.4 Legacy-Umleitungs-URLs für Harmony Single Sign-On (SSO) ein. Seit unserer Ankündigung im Juni 2024 (11.28), dass sich SSO-URLs geändert haben, erfordern neue und aktualisierte SSO-Konfigurationen die neuen URLs. Allerdings nutzt Ihre Organisation möglicherweise noch Legacy-URLs, wenn Sie SSO vor Juni 2024 konfiguriert haben und die Konfiguration noch nicht aktualisiert wurde.

  Organisationsadministratoren müssen ihre bestehende SSO-Konfiguration neu konfigurieren, um die neuen URLs zu verwenden, oder Benutzeranmeldungen bei Harmony schlagen ab den folgenden Daten fehl:

  	12.4
  APAC	28. April 2026 (12 Uhr AEST)
  EMEA	28. April 2026 (21 Uhr CEST)
  NA	29. April 2026 (12 Uhr PDT)

  Überprüfung, ob Maßnahmen erforderlich sind

  Melden Sie sich beim Harmony-Portal an, navigieren Sie zu Management Console > Organizations und wählen Sie Ihre Organisation aus. Klicken Sie auf der Registerkarte User Management unter dem Umschalter Enable SSO auf Configure SSO.

  Ihre Organisation erfordert eine Neukonfiguration, wenn eines dieser Felder die Zeichenkette jitterbit-cloud-mgmt-console enthält:

  • OAuth 2.0: Die Felder Client ID oder Client Secret.

  • SAML 2.0: Die Felder Identity Provider Metadata oder Service Provider Metadata.

  Erforderliche Maßnahme

  Wenn Ihre Organisation Legacy-Umleitungs-URLs verwendet, muss ein Organisationsadministrator diese neu konfigurieren:

  1. Ändern Sie unter dem Umschalter Enable SSO die Auswahl zu None, um die bestehende SSO-Konfiguration mit den Legacy-Umleitungs-URLs zu entfernen.

  2. Erstellen Sie die SSO-Konfiguration mit den neuesten Umleitungs-URLs neu, indem Sie der Dokumentation folgen. Dies muss sowohl in Harmony als auch bei Ihrem Identitätsanbieter durchgeführt werden:

     1. Wählen Sie unter dem Umschalter Enable SSO den Authentifizierungstyp aus: OAuth 2.0 oder SAML 2.0. Klicken Sie dann auf Configure SSO.

     2. Aktualisieren Sie die Umleitungs-/ACS-URLs bei Ihrem Identitätsanbieter.

  3. Testen Sie die Authentifizierung, um eine erfolgreiche Anmeldung zu bestätigen.

  Wenden Sie sich für Unterstützung an den Jitterbit-Support.

Behobene Probleme

Agent

• Veraltete credentials.txt blockiert Docker-Container-Neustarts nicht mehr
  Wenn deregisterAgentOnDrainstop=true, wird der Agent beim Neustart des Containers nun automatisch abgemeldet und ein neuer registriert, ohne dass eine manuelle Löschung von credentials.txt erforderlich ist. Weitere Informationen finden Sie unter Agent-Verhalten beim Neustart.

• Linux-Agent-Installation für Benutzer mit Agent-Install-Berechtigung behoben
  Benutzer, die nur die Agent-Install-Berechtigung haben, können nun erfolgreich einen Linux-Agent installieren, wenn sie Schreibzugriff auf mindestens eine Umgebung haben. Zuvor erhielten diese Benutzer während der Linux-Agent-Installation unabhängig von ihrem Umgebungszugriff einen 401-Authentifizierungsfehler.

Agent und Design Studio

• NetSuite-Transformationsaktualisierung schlägt nicht mehr fehl
  Der Versuch, eine NetSuite-Transformation zu aktualisieren, gibt keinen 500-Fehler mehr zurück. Dieses Problem war auf die macOS-Version von Design Studio beschränkt.

Connectors

• Sicherheitsfix für Microsoft Dynamics 365 Connector
  Microsoft Dynamics 365 Connector-Aktivitäten geben Anmeldedaten in Fehlermeldungen nicht mehr preis, wenn eine Aktivität fehlschlägt.

Harmony Portal

• SSO-Sitzungsablauf verursacht keine Umleitungsschleife mehr
  Wenn die Sitzung eines Harmony SSO-Benutzers abläuft, schließt das Harmony Portal den Abmeldeprozess jetzt vollständig ab, indem Sitzungs-Cookies gelöscht werden. Dies verhindert eine Endlosschleife zwischen den Anmelde- und Landingpages. Benutzer werden zur Anmeldeseite weitergeleitet und können sich erneut erfolgreich anmelden.

Management Console

• Cloud Datastore-Fehler beim Bearbeiten von Datensätzen mit leeren benutzerdefinierten Feldern behoben
  Das Ändern eines Datensatzes auf der Cloud Datastore-Seite gibt keinen Failed to create storage register-Fehler mehr zurück, wenn nicht erforderliche benutzerdefinierte Felder leer gelassen werden.

Studio

• Bedingungszweige des Decision-Tools werden nach Projektimport korrekt angezeigt
  Workflows mit dem Decision-Tool zeigen Bedingungszweigverbindungen nach dem Importieren eines Projekts jetzt korrekt auf der Designoberfläche an. Zuvor fehlten die Verbindungen, obwohl das Decision-Tool und die Operationen vorhanden waren.

• Schemaänderungen verursachen keine Studio-Instabilität mehr
  Der Versuch, ein geändertes Schema mit duplizierten Knoten zu speichern, kann Studio nicht mehr zum Hängen bringen.

Hinweise

Agent

• Einstellung der Versionsverwaltung für Private Agents 11.x
  Die 11.59 / 12.3 Release enthielt die letzte Private Agent-Version 11.x (11.59) und die erste verfügbare Private Agent-Version 12.x (12.3). Beachten Sie Folgendes bezüglich zukünftiger Releases:

  • Letzte 11.x-Version: Die Private Agent-Version 11.x hat das Ende ihrer geplanten Entwicklung erreicht. Alle zukünftigen Verbesserungen, neuen Funktionen und Sicherheitsupdates werden über 12.x Private Agents bereitgestellt. Obwohl 11.x Agents möglicherweise seltene kritische Fixes für produktionsbeeinflussende Probleme erhalten, sind keine laufenden Releases geplant.

  • Empfehlung: Wir empfehlen dringend, so bald wie möglich auf 12.x Private Agents zu aktualisieren, um von den neuesten Leistungs-, Sicherheits- und Funktionsverbesserungen zu profitieren.

  • Aktualisierungspfad: Sie können direkt von 11.x auf jede 12.x-Version aktualisieren, indem Sie unsere dokumentierten Aktualisierungsanweisungen verwenden: Windows, Linux oder Docker.

  Erforderliche Maßnahmen: Plugin-Updates und Überprüfung benutzerdefinierter Connectors für 12.x Private Agents

  • Plugin-Updates für 12.x Private Agents
    Leistungs- und Sicherheitsverbesserungen für 12.x Private Agents sind nicht kompatibel mit den Multipart Pipeline- und AWS S3 Create Plugins. Wenn Sie diese Plugins verwenden, ist eine Benutzeraktion erforderlich, wie in den Aktualisierungsanweisungen beschrieben.

  • Überprüfung benutzerdefinierter Connectors für 12.x Private Agents
    Connectors, die von Drittanbietern mit dem Connector SDK erstellt wurden, müssen Entwicklungsänderungen durchlaufen, um mit 12.x Private Agents kompatibel zu sein. Überprüfen Sie vor der Aktualisierung auf 12.x Private Agents die Kompatibilität mit dem Connector-Entwickler, da Operationen mit diesen Connectors zum Zeitpunkt der Aktualisierung fehlschlagen.

Agent und Design Studio

• End of Life für Version 11.42
  Ab dem 24. April 2026 haben diese Produktversionen das Ende ihrer Lebensdauer erreicht und werden nicht mehr unterstützt:

  • Private Agent-Version 11.42
  • Design Studio-Version 11.42

Wir empfehlen Benutzern dieser Versionen, so bald wie möglich auf die neueste Version zu aktualisieren.

Connectors

• Erforderliche Maßnahme: Einstellung der IDCRL-Authentifizierung für Microsoft SharePoint Server Connector
  Microsoft stellt die IDCRL-Authentifizierung am 1. Mai 2026 ein. Nach diesem Datum schlagen Operationen fehl, die von Verbindungen mit dem SharePoint Online SOAP-Schema abhängen. Die Migration erfordert das Erstellen einer neuen Verbindung mit dem REST-Schema, das Neuzuweisen vorhandener Aktivitäten zur neuen Verbindung und die erneute Bereitstellung abhängiger Operationen. Vollständige Migrationsschritte finden Sie auf der Seite Microsoft SharePoint Server-Verbindung.

  Wichtig

  Wenn Sie sich mit SharePoint Online über das SOAP-Schema verbinden, müssen Sie vor dem 1. Mai 2026 zum REST-Schema migrieren, um Operationsfehler zu vermeiden.

• Erforderliche Maßnahme: Bevorstehende Entfernung der veralteten Cloud Datastore Query Items-Aktivität
  In einer kommenden Version wird die veraltete Query Items-Aktivität im Cloud Datastore Connector dauerhaft entfernt. Diese Aktivität wurde in der Version 11.47 durch die neu gestaltete Query Items-Aktivität ersetzt, deren vereinfachte Antwortstruktur bewirkt, dass die einzelnen Felder, die Sie in der Management Console auf der Seite Cloud Datastore definieren, direkt auf der obersten Ebene der Antwort zurückgegeben werden.

  Wichtig

  Wenn Sie die veraltete Query Items-Aktivität in Operationen verwenden, müssen Sie Ihr Operationsdesign überprüfen und sie so bald wie möglich durch die neu gestaltete Query Items-Aktivität ersetzen, da die veraltete Aktivität nicht mehr unterstützt wird und in Zukunft entfernt wird.