12.13 Harmony-Versionshinweise

12.13 Harmony-Version

Die 12.13 Harmony-Version wird gestaffelt nach den unten aufgeführten Daten und Zeiten nach Komponente und Region bereitgestellt. Eine detailliertere Erklärung des Veröffentlichungsrhythmus nach Komponentenkategorie finden Sie im Veröffentlichungsplan.

App Builder 4.69 und Wevo iPaaS verfügen über 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 Veröffentlichungsdatum.

Neue Funktionen

Connectors

• Jitterbit App Builder-Connector
  Der Studio Jitterbit App Builder-Connector kann mit Cloud- oder Private Agents verwendet werden, um Daten in einer App Builder-Anwendung zu lesen, zu erstellen, zu aktualisieren oder zu löschen, indem das OpenAPI-Dokument konsumiert wird, das diese Anwendung veröffentlicht.

• Microsoft Excel v3 (Beta)-Connector
  Der Studio Microsoft Excel v3 (Beta)-Connector kann mit Private Agents der Version 12.3 oder höher verwendet werden, um Zeilen in Microsoft Excel-Arbeitsmappen-Dateien (.xlsx und .xls) an einem lokalen oder Netzwerkpfad, auf den der Agent zugreifen kann, zu lesen, einzufügen, zu aktualisieren oder zu löschen. Um Beta-Feedback zu geben, kontaktieren Sie das Jitterbit-Produktteam.

• Ollama-Connector
  Der Studio Ollama-Connector kann mit Cloud- oder Private Agents verwendet werden, um Prompts an Modelle zu senden, die von Ollama gehostet werden, entweder über Ollama Cloud oder einen selbst gehosteten Ollama-Server, und Tools bei ihnen zu registrieren. Die Registrierung von Tools erfordert Private Agents.

EDI

• EDI AI Monitor (Beta)
  Der neue EDI AI Monitor (Beta) überwacht die Jitterbit EDI-Aktivität Ihrer Organisation über FTP, AS2 und Transaktionen und sendet Ihnen eine E-Mail, wenn die Aktivität im Vergleich zu ihrem letzten Verlauf ungewöhnlich ist, z. B. ein Anstieg von Fehlern oder ein ungewöhnlicher Rückgang des Volumens. Aktivieren Sie den EDI AI Monitor auf der Management Console-Seite Alerts. Um Feedback zu dieser Beta-Funktion zu geben, kontaktieren Sie das Jitterbit-Produktteam.

Management Console

• Neue Alerts auf der Management Console-Seite Alerts
  Die Management Console-Seite Alerts verfügt über vier neue Ereignisse:

  • API request ended with status code (Beta): Sendet einen Alert, wenn eine Anfrage an eine ausgewählte benutzerdefinierte API, Proxy-API oder OData-Service mit einem der von Ihnen angegebenen HTTP-Statuscodes endet.
  • EDI AI monitor (Beta): Sendet einen Alert, wenn eine Transaktions-, FTP- oder AS2-Anomalie erkannt wird. Siehe EDI AI Monitor (Beta).
  • Operation ended in terminal status (Beta): Sendet einen Alert, wenn eine ausgewählte Operation in einem der ausgewählten Endstatus endet (Canceled, Success, Success with Info, Success with Warning, Success with Child Error, Error oder SOAP Fault).
  • Operation status duration threshold exceeded (Beta): Sendet einen Alert, wenn eine ausgewählte Operation länger als ein von Ihnen festgelegter Dauer-Schwellenwert in einem der ausgewählten Nicht-Endstatus bleibt (Submitted, Received, Pending, Running oder Cancel Requested).

Verbesserungen

Agent

• Apache Tomcat-Upgrade
  Der im Agent enthaltene Apache Tomcat-Server wurde aktualisiert, um Sicherheit und Leistung zu verbessern.

API-Gateway

• Mehrbyte-Zeichen jetzt für private API-Gateway-Domainnamen unterstützt
  Der Befehl jitterbit-api-gateway-config akzeptiert jetzt einen benutzerdefinierten privaten API-Gateway-Domainnamen, der Mehrbyte-Zeichen enthält. Der Befehl konvertiert den Domainnamen für die DNS-Validierung und den Selbstdiagnose-API-Aufruf in Punycode. Registrieren Sie die Punycode-Form des Domainnamens in Ihrer DNS- oder Hosts-Datei, und fordern Sie Ihr SSL-Zertifikat für die Punycode-Form an.

API Manager

• Export und Import benutzerdefinierter APIs mit verknüpften Studio-Projekten
  Wenn Sie benutzerdefinierte APIs exportieren, können Sie jetzt Include linked Studio projects auswählen, um die Studio-Projekte, die ihre Operationen enthalten, zur Exportdatei hinzuzufügen. Wenn Sie die Datei importieren, erstellt API Manager jedes Projekt in der Zielumgebung, stellt die von Ihnen ausgewählten Operationen bereit und verbindet jeden API-Service mit seiner Operation.

• Pfad-, Abfrage- und Header-Parameter für Proxy-APIs
  Proxy-API-Services erkennen und zeigen jetzt Pfad-, Abfrage- und Header-Parameter auf der Registerkarte Services an, womit die bereits für benutzerdefinierte APIs verfügbare Parameterunterstützung erreicht wird. Pfadparameter werden automatisch für jedes {parameterName}-Token im Service-Path aufgeführt (zum Beispiel /orders/{orderId}), einschließlich manuell eingegebener Pfade. Abfrage- und Header-Parameter werden aus einem OpenAPI-Dokument erkannt oder manuell hinzugefügt.

• Security Profile-Filter für API-Logs
  Die Seite API Logs enthält jetzt ein Feld Security profile im Suchbereich und ein Suchkriterium securityProfile, mit dem Sie Protokolleinträge nach Sicherheitsprofilname filtern können.

Connectors

• Coupa-Connector-Unterstützung für R46
  Der Studio Coupa-Connector verwendet jetzt Version R46 der Coupa Core Platform API. Mit diesem Upgrade werden die Objekte External Orders, Services Procurement, Coupa Pay Travel & Expense Payments und Requisitions jetzt unterstützt. Um die neuen Objekte mit vorhandenen Aktivitäten zu verwenden, generieren Sie ihre Schemas neu. Der Endpoint /receivable_purchase_order_lines, der in der Core Platform API nicht mehr enthalten ist, wird aus dem Connector entfernt.

• Jira-Connector-Unterstützung für Webhooks, Labels, Benutzerdetails und Anhänge
  Der Studio Jira-Connector verfügt über neue Objekte für Verbindungen, die den Instanztyp Jira Cloud verwenden:

  • Webhook: Erstellen, suchen und löschen Sie Jira-Webhooks mit den Aktivitäten Create, Search und Delete.
  • Issue_labels, Add_label und Remove_label: Ersetzen, fügen Sie hinzu oder entfernen Sie die Labels eines Issues, ohne andere Issue-Felder zu aktualisieren, mit der Aktivität Update.
  • Myself: Rufen Sie die Profildetails des authentifizierten Jira-Benutzers mit der Aktivität Search ab.
  • List_attachments und Get_attachment: Listen Sie die Anhänge eines Issues auf, oder rufen Sie die Metadaten eines Anhangs anhand der ID mit der Aktivität Search ab.
  • Get_attachment_base64_content: Rufen Sie die Metadaten eines Anhangs und dessen Dateidaten als base64-codierte Zeichenfolge mit der Aktivität Search ab. Dieses Objekt ist nur auf Private Agents verfügbar.

EDI

• Dedizierte Communications-Seite für EDI-Verbindungen
  Sie verwalten AS2-, FTP- und VAN-Verbindungen jetzt auf einer dedizierten Seite Communications, die Sie über das Menü EDI im Harmony-Portal öffnen, statt auf der Registerkarte Communication settings eines Trading Partners. Die Auswahl einer Verbindung öffnet eine Schublade mit einer Registerkarte Settings für die Felder der Verbindung und einer Registerkarte Trading partners, auf der Sie Trading Partners zuweisen zur Verbindung.

• Echtzeit-Updates auf allen EDI-Seiten
  Änderungen an Trading Partners, Workflows, Labels, bevorzugten IDs und Communication-Einstellungen auf der Seite Trading Partners erscheinen jetzt sofort für alle Benutzer, ohne dass eine manuelle Seitenaktualisierung erforderlich ist. Wenn ein Trading Partner hinzugefügt, gelöscht oder importiert wird, werden die Trading-Partner-Filter auf den Seiten Transactions, Messaging, Archive und Analytics automatisch aktualisiert. Wenn ein Workflow hinzugefügt oder gelöscht wird, werden die Dokumenttyp-Filter auf den Seiten Transactions, Archive und Analytics auf die gleiche Weise aktualisiert. Wenn eine Löschung etwas betrifft, das Sie derzeit anzeigen, bearbeiten oder als Filter oder Auswahl verwenden, erklärt eine Benachrichtigung, was sich geändert hat.

• TRADACOMS Partner-ID-Länge erhöht
  Die Partner ID eines TRADACOMS-Trading-Partners akzeptiert jetzt 1–14 alphanumerische Zeichen, erhöht von genau 12.

Harmony-Plattform

• Mehrbyte-Zeichen jetzt für Organisations-API-Subdomains unterstützt
  Die API-Subdomain einer Organisation kann jetzt zusätzlich zu Kleinbuchstaben, Zahlen und Bindestrichen Mehrbyte-Zeichen enthalten.

Management Console

• Export von Projektdetails als CSV auf der Seite Projects
  Sie können jetzt Projektdetails exportieren von der Management Console-Seite Projects als CSV-Dateien, als Referenz für Audits, Migrationsplanung oder Dokumentation. Wählen Sie einzelne Projekte oder alle Projekte aus, die den aktuellen Filtern entsprechen, und klicken Sie auf Download ZIP file, um auszuwählen, welche Dateien enthalten sein sollen: Projektdetails, Operationen, Zeitpläne, Backups, Projektvariablen, Bereitstellungsverlauf, Listener und Endpoints. Es werden nur Daten eingeschlossen, für die Sie eine Anzeigeberechtigung haben.

• Externe Benutzer über Organisationen hinweg
  Auf der Management Console-Seite User Management können Sie jetzt einen Benutzer, der einer anderen Organisation gehört, als externen Benutzer hinzufügen. Ein Benutzer kann in einer Organisation ein Harmony-Benutzer oder ein externer Benutzer und in einer anderen Organisation ein externer Benutzer sein, unter Verwendung derselben E-Mail-Adresse.

• Möglichkeit, Alerts zu pausieren und fortzusetzen
  Sie können jetzt einen Alert auf der Management Console-Seite Alerts pausieren, ohne ihn zu löschen, z. B. während einer geplanten Wartung. Ein pausierter Alert behält seine Konfiguration, sendet jedoch keine Benachrichtigungen. Pausieren Sie einen Alert ab jetzt oder zu einem zukünftigen Datum, und beenden Sie ihn zu einem von Ihnen gewählten Datum oder unbegrenzt, und setzen Sie ihn jederzeit fort. Eine neue Spalte Status zeigt an, ob jeder Alert aktiv oder pausiert ist.

• Chatverlauf für die APIM und Management AI Assistants
  Der APIM AI Assistant und der Management AI Assistant (Beta) enthalten die Steuerelemente Home und History auf der Management Console-Seite AI Assistant, um zum aktuellen Chat zurückzukehren und Ihre vorherigen Chats zu durchsuchen.

• Management AI Assistant-Unterstützung für App Registrations
  Der Management AI Assistant (Beta) kann jetzt App Registrations auflisten, suchen, erstellen, bearbeiten und löschen.

MCP

• Jitterbit MCP (Beta)-Nutzbarkeitsverbesserungen
  Die Seite Servers in Jitterbit MCP (Beta) umfasst folgende Verbesserungen:

  • Eine neue Aktion Go to Operation bei Operationstools öffnet die verknüpfte Operation in Studio.
  • Die Aktion Go to API bei Jitterbit API-Tools und -Ressourcen öffnet jetzt die verknüpfte API in API Manager mit ausgewählter Registerkarte Services.
  • Die Tabelle auf der Registerkarte Tools enthält jetzt eine Spalte Context, die die wichtigste Konfiguration jedes Tools anzeigt, z. B. den API-Endpoint und -Pfad oder das Projekt und die Operation.
  • Die Felder Request und Response auf der Registerkarte Testing enthalten jetzt eine Suche, Response und Structured content sind in einem Feld zusammengefasst, und eine Vollbildansicht ist verfügbar.
  • Die Registerkarte Testing zeigt jetzt außerdem ein Type- oder Content Source-Badge an jedem Tool und jeder Ressource an, klappt Logs ein, bis Sie auf Execute klicken, und maskiert das Feld Auth token während der Eingabe.

Studio

• Umgebungsspezifische OAuth-Anwendungen bei der selektiven Übertragung
  Das Feature selektive Übertragung verfügt über einen neuen Schritt Configure OAuth endpoints. Eine Übertragung behält jetzt die OAuth-Anwendung, die jeder Endpoint in der Zielumgebung verwendet. Um sie durch die OAuth-Anwendung der Quellumgebung zu ersetzen, wählen Sie Transfer application.

Änderungen

Connectors

• Einstellung des ServiceNow-Connectors
  Der ServiceNow-Connector ist jetzt in Studio als (Deprecated) markiert und wird nicht mehr unterstützt. Verwenden Sie stattdessen den ServiceNow v2-Connector.

Fehlerbehebungen

Agent

• Database Query-Aktivität liest jetzt SQL Server-Zeichenfolgendaten korrekt
  Die Studio-Aktivität Database Query liest jetzt Zeichenfolgendaten korrekt. Dies betrifft SQL Server-Datenbanken, auf die über ODBC auf Private Agents zugegriffen wird. Zuvor, seit der 12.7-Version, konnten Zeichenfolgenwerte als beschädigte Zeichen zurückgegeben werden.

• Design Studio E-Mail-Nachrichten senden jetzt mit OAuth 2.0 ohne Konto und Passwort
  Design Studio E-Mail-Nachrichten, die OAuth 2.0-Parameter im Feld SMTP Mail Servers verwenden, werden jetzt erfolgreich gesendet, wenn Use authentication deaktiviert ist, unter Verwendung des Grant-Typs client_credentials. Zuvor schlug die E-Mail-Nachricht mit einem Fehler AADSTS900144 fehl, sofern nicht auch ein Konto und Passwort eingegeben wurden. Use authentication wird beim Grant-Typ client_credentials nicht benötigt. Siehe Grant-Typen.

• Microsoft Entra-Authentifizierung funktioniert jetzt mit dem SQL Server Microsoft JDBC-Treiber
  Der Agent enthält jetzt die Microsoft Authentication Library for Java (MSAL4J)-Bibliotheken, die für die Microsoft Entra-Authentifizierung mit dem Treiber SQL Server MS JDBC (authentication=ActiveDirectoryPassword) erforderlich sind. Zuvor, seit der 12.8-Version, schlugen diese Verbindungen mit dem Fehler Failed to load MSAL4J Java library fehl.

• Windows Private Agents beenden den Operation-Engine-Prozess nicht mehr unerwartet
  Unter bestimmten Umständen wird der Operation-Engine-Prozess (JitterbitOperationEngineProc.exe) auf Windows Private Agents nicht mehr unerwartet mit dem Exit-Code -1073741819 (0xc0000005) beendet, wodurch Operationen im Status Pending verbleiben konnten.

Connectors

• MCP Client List Tools-Aktivitätsantwortschema enthält jetzt _meta
  Das Antwortschema für die MCP Client-Aktivität List Tools enthält jetzt das Feld _meta, das für jedes Tool vom MCP-Server zurückgegeben wird. Da der Inhalt dieses Felds unstrukturiert ist, wird es als einzelne Zeichenfolge zurückgegeben. Zuvor führte dieses fehlende Feld dazu, dass erfolgreiche Operationen den Status Success with Warning anstatt Success with Info meldeten. Um diese Korrektur auf eine vorhandene Aktivität anzuwenden, generieren Sie ihre Schemas neu.

• OpenAI Create Image-Aktivitätsantwortschema enthält jetzt safety_identifier
  Das Antwortschema für die OpenAI-Aktivität Create Image enthält jetzt das von der OpenAI-API zurückgegebene Feld safety_identifier. Zuvor führte dieses fehlende Feld dazu, dass erfolgreiche Operationen den Status Success with Warning anstatt Success with Info meldeten. Um diese Korrektur auf eine vorhandene Aktivität anzuwenden, generieren Sie ihre Schemas neu.

• Snowflake Update-Aktivität lädt jetzt Anfrage- und Antwortschemas
  Die Snowflake-Aktivität Update lädt jetzt ihre Anfrage- und Antwortschemas korrekt, wenn Sie sie konfigurieren. Zuvor zeigte der letzte Konfigurationsschritt einen Fehler an, der darauf hinwies, dass die Schemas nicht geladen werden konnten.

EDI

• Testen einer FTP- oder AS2-Verbindung funktioniert jetzt
  Die Schaltfläche Test connection auf der Seite Communications eines Trading Partners testet jetzt korrekt FTP- und AS2-Verbindungen. Zuvor gab das Klicken auf die Schaltfläche einen Fehler zurück, der anzeigte, dass die Verbindung fehlgeschlagen sei, selbst wenn die Verbindung korrekt konfiguriert war.

Harmony-Portal

• SSO-Benutzer, die zu einem inaktiven Harmony-Portal-Tab zurückkehren, werden jetzt zur Anmeldeseite weitergeleitet
  Wenn ein Harmony SSO-Benutzer zu einem Harmony-Portal-Tab zurückkehrt, der über das Limit für inaktive Sitzungen hinaus geöffnet blieb, wird der Benutzer jetzt abgemeldet und zur Anmeldeseite weitergeleitet und kann sich erfolgreich erneut anmelden. Zuvor konnte der Tab wiederholt zur Anmeldung weiterleiten, bis der Benutzer die Browser-Cookies löschte.

Management Console

• Log Type-Suche auf der Runtime-Seite unterstützt jetzt Platzhalter
  Der Suchschlüssel logType der Management Console-Seite Runtime akzeptiert jetzt die Platzhalterzeichen % und * in der Mitte oder am Ende des Werts (zum Beispiel logType=Oper%;).

Studio

• WSDL- und ZIP-Datei-Validierungsfehler bei SOAP-Verbindungsuploads
  Die SOAP-Verbindung validiert jetzt eine hochgeladene WSDL- oder ZIP-Datei sofort und zeigt einen Fehler an, der das Problem identifiziert, wenn die Datei nicht gültig ist. Gültige WSDL- und ZIP-Dateien, einschließlich ZIP-Dateien, die XSD-Dateien enthalten, werden erfolgreich hochgeladen. Zuvor konnte das Hochladen einiger ZIP-Dateien hängen bleiben, bis die Anfrage mit einem HTTP 504-Fehler ein Timeout erreichte, was Sie daran hinderte, die Verbindung zu konfigurieren und das Projekt bereitzustellen.

Hinweise

Agent

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

  • Letzte 11.x-Version: Die 11.x Private-Agent-Version 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 Versionen 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 Konnektoren 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 Plugins „Multipart Pipeline" und „AWS S3 Create". Wenn Sie diese Plugins verwenden, ist eine Benutzeraktion erforderlich, wie in den Aktualisierungsanweisungen beschrieben.
  • Überprüfung benutzerdefinierter Konnektoren für 12.x Private Agents
    Konnektoren, 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 Konnektor-Entwickler, da Operationen mit diesen Konnektoren zum Zeitpunkt der Aktualisierung fehlschlagen.

Agent und API-Gateway

• Lebenszyklusende für Version 11.51
  Ab dem 30. Oktober 2026 haben diese Produktversionen das Lebenszyklusende erreicht und werden nicht mehr unterstützt:

  • Private-Agent-Version 11.51
  • Privates-API-Gateway-Version 11.51

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

Connectors

• Erforderliche Maßnahme: Bevorstehende Entfernung veralteter Connectors und Aktivitäten
  Die folgenden Connectors und Aktivitäten sind veraltet und werden nicht mehr unterstützt. Sie werden in einer zukünftigen Version dauerhaft entfernt:

  • Die veraltete Query Items-Aktivität im Cloud Datastore-Connector. Diese Aktivität wurde in der Version 11.47 durch die neu gestaltete Query Items-Aktivität ersetzt, deren vereinfachte Antwortstruktur die einzelnen Felder, die Sie auf der Management Console-Seite Cloud Datastore definieren, direkt auf der obersten Ebene der Antwort zurückgibt.
  • Die OpenAI-Aktivitäten Prompt und Register Tools. Beide wurden in der Version 12.8 durch die neu gestalteten Aktivitäten Prompt V2 und Register Tools V2 ersetzt. Durch die Verwendung von OpenAIs Responses API ermöglichen diese Aktivitäten das Speichern des Chat-Kontexts und das Aufrufen registrierter Tools in Cloud-Agent-Gruppen, nicht nur in Private Agents.
  • Der ServiceNow-Connector. Verwenden Sie stattdessen den ServiceNow v2-Connector.

  Wichtig

  Falls Sie einen dieser veralteten Connectors oder Aktivitäten in Ihren Operationen verwenden, müssen Sie Ihr Operationsdesign überprüfen und sie so bald wie möglich durch die aufgeführten Ersatzaktivitäten ersetzen, da sie nicht mehr unterstützt werden und in einer zukünftigen Version entfernt werden.