Zum Inhalt springen

Zeichenkodierung und Multibyte-Unterstützung in Jitterbit Harmony

Einführung

Die Standard-Zeichenkodierung 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-Kodierung 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 auf der gesamten Plattform, einschließlich Projektnamen, Operationsnamen, Umgebungsnamen, Agent-Namen, Namen globaler und projektbezogener Variablen, API-Namen im API Manager, Schema-Feldnamen, Connector Builder-Connector-Namen, Client-Zertifikatnamen, Rollennamen und Organisationsnamen.
  • Transformations-Quelldaten, Schema-Knotennamen und hartcodierte Werte in Transformationen.
  • Skriptinhalte.
  • Zeichenfolgenvergleiche mit == in Bedingungsskripten.
  • Dateinamen beim Lesen oder Schreiben von Dateien mit dateigestützten Connectoren, einschließlich File Share, FTP, Local Storage und Temporary Storage.
  • Zeichenfolgenspalten in ODBC-verbundenen Datenbanken (siehe jitterbit.scripting.db.multibyte.enable).
  • Daten, die mit Connectoren ausgetauscht werden.
  • E-Mail-Benachrichtigungsbetreffzeilen und -texte.
  • API-Antworten.

Diese Liste ist nicht vollständig. Multibyte-Zeichen werden in zusätzlichen Bereichen der Plattform unterstützt, die oben nicht aufgeführt sind.

Einschränkungen

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

  • Jitterbit Message Queue (JBMQ):

    • Message Queue-Namen unterstützen erweiterte lateinische Zeichen (z. B. im Portugiesischen und Deutschen verwendete), aber keine kyrillischen oder chinesischen Zeichen.
    • JBMQ-Umgebungen mit Multibyte-Zeichen in ihren Namen können in den Message Queues Einstellungen der Management Console nicht aktiviert werden.

  • Benutzer-E-Mail-Adressen: 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-Zustellungsdienstes.

  • 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 Tool-Name, das auf einem MCP-Server erstellt wird, unterstützt keine Multibyte-Zeichen. Dies ist eine Einschränkung der Model Context Protocol-Spezifikation für Tool-Namen, keine Jitterbit-spezifische Einschränkung. MCP-Servernamen selbst sind nicht betroffen.

  • Plugins (veraltet):

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

Standard-Zeichenkodierung überschreiben

Um eine andere Zeichenkodierung als die Standard-Kodierung 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 Zeichenkodierung.

Alternativ können alle folgenden Jitterbit-Variablen in einem Skript verwendet werden, 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 der Name oder Alias des Codepage-Konverters sein, wie im folgenden Beispiel gezeigt:

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