Zum Inhalt springen

Zeichencodierung und Multibyte-Unterstützung in Jitterbit Harmony

Einführung

Die Standard-Zeichencodierung für die Harmony-Plattform ist UTF-8 ab Agent-Version 12.7 und Design Studio Version 11.63. In früheren Versionen ist die Standard-Codierung Latin-1 (ISO-8859-1).

Multibyte-Zeichenunterstützung

Ab Agent-Version 12.9 und Design Studio Version 11.65 unterstützt Jitterbit offiziell Multibyte-Zeichen auf der gesamten Harmony-Plattform. Portugiesisch, Deutsch und Russisch sind als unterstützte Sprachen zertifiziert.

Unterstützte Bereiche

Die Multibyte-Zeichenunterstützung umfasst unter anderem:

  • Namen in der gesamten Plattform, einschließlich Projektnamen, Operationsnamen, Umgebungsnamen, Agent-Namen, globaler und projektbezogener Variablennamen, API-Namen im API Manager, Schemanamen, Connector Builder-Connector-Namen, Namen für Client-Zertifikate, Rollennamen und Organisationsnamen.
  • API-Subdomänen.
  • Transformationsquelldaten, Schemanodennamen und hartcodierte Werte in Transformationen.
  • Skriptinhalte.
  • Zeichenvergleiche mit == in Bedingungsskripten.
  • Dateinamen beim Lesen oder Schreiben von Dateien mit dateigestützten Connectoren, einschließlich File Share, FTP, Local Storage und Temporary Storage.
  • Zeichenspalten in ODBC-verbundenen Datenbanken (siehe jitterbit.scripting.db.multibyte.enable).
  • Mit Connectoren ausgetauschte Daten.
  • Betreffzeilen und Text von E-Mail-Benachrichtigungen.
  • API-Antworten.

Diese Liste ist nicht vollständig; Multibyte-Zeichen werden in zusätzlichen Bereichen der Plattform über die oben aufgeführten hinaus unterstützt.

Einschränkungen

Multibyte-Zeichen werden in den folgenden Bereichen nicht unterstützt:

  • Jitterbit Message Queue (JBMQ):

    • Nachrichtenwarteschlangennamen unterstützen erweiterte lateinische Zeichen (wie sie im Portugiesischen und Deutschen verwendet werden), aber keine kyrillischen oder chinesischen Zeichen.
    • JBMQ-Umgebungen mit Multibyte-Zeichen in ihren Namen können in der Management Console Message Queues unter Einstellungen nicht aktiviert werden.
  • E-Mail-Adressen von Benutzern: Harmony-Benutzerkonten können nicht mit einer E-Mail-Adresse registriert oder erstellt werden, die Multibyte-Zeichen enthält. Dies ist eine Einschränkung des zugrunde liegenden E-Mail-Versanddienstes.

  • Microsoft Access-Datenbanken: In Microsoft Access-Datenbanken gespeicherte Multibyte-Zeichen werden nicht korrekt gelesen.

  • Cloud Datastore-Sortierung: Das Sortieren von Cloud Datastore-Datensätzen nach einem Feld, das Multibyte-Zeichen enthält, führt nicht zur erwarteten alphabetischen Reihenfolge.

  • MCP-Server-Tool-Namen: Ein in einem MCP-Server erstellter Tool-Name unterstützt keine Multibyte-Zeichen. Dies ist eine Einschränkung der Model Context Protocol-Spezifikation für Tool-Benennung, nicht eine Jitterbit-spezifische Einschränkung. MCP-Servernamen selbst sind nicht betroffen.

  • Proxy API-Request-Header: Header-Schlüssel und -Werte auf der Registerkarte Request headers einer Proxy-API und Header-Parameternamen auf der Registerkarte Services unterstützen keine Multibyte-Zeichen. Dies ist eine Einschränkung der HTTP-Spezifikation, nicht eine Jitterbit-spezifische Einschränkung.

  • Plugins (veraltet):

    • Plugin-Namen unterstützen keine Multibyte-Zeichen.
    • Das File Merger-Plugin kann keine Dateien mit Multibyte-Zeichen in ihren Dateinamen verarbeiten.

Standard-Zeichencodierung außer Kraft setzen

Um eine andere Zeichencodierung als die Standard-Codierung zu verwenden, kann man diese explizit festlegen. Einige Connectoren (z. B. File Share, FTP, Local Storage und Temporary Storage) enthalten eine Konfigurationsoption zum Festlegen der Zeichencodierung.

Alternativ kannst du eines der folgenden Jitterbit-Variablen in einem Skript verwenden, um die Zeichenkodierung festzulegen:

  • jitterbit.source.db.character_encoding

  • jitterbit.target.db.character_encoding

  • jitterbit.source.text.character_encoding

  • jitterbit.target.text.character_encoding

  • jitterbit.scripting.db.character_encoding

Der Wert sollte dem Namen oder Alias des Code-Page-Konverters entsprechen, wie im folgenden Beispiel gezeigt:

$jitterbit.scripting.db.character_encoding="ebcdic-xml-us"