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, globale und projektbezogene Variablennamen, API-Namen im API Manager, Schema-Feldnamen, Connector Builder-Connector-Namen, Client-Zertifikatnamen, Rollennamen und Organisationsnamen.
  • Transformationsquelldaten, Schema-Knotennamen 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 (außer auf Windows-Private-Agents ab Agent-Version 12.10; siehe Einschränkungen).
  • Zeichenspalten 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 über die oben aufgeführten hinausgehen.

Einschränkungen

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

  • Jitterbit Message Queue (JBMQ):

    • Nachrichtenwarteschlangennamen unterstützen erweiterte lateinische Zeichen (wie sie in Portugiesisch und Deutsch verwendet werden), aber keine kyrillischen oder chinesischen Zeichen.
    • JBMQ-Umgebungen mit Multibyte-Zeichen in ihren Namen können in der Management Console Message Queues Einstellungen 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: Multibyte-Zeichen, die in Microsoft Access-Datenbanken gespeichert sind, 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.

  • Dateinamen auf Windows-Private-Agents: Ab Agent-Version 12.10 wird das Lesen oder Schreiben einer Datei, deren Name Multibyte-Zeichen enthält, auf Windows-Private-Agents mit File Share, FTP, Local Storage oder Temporary Storage nicht zuverlässig verarbeitet. Verwenden Sie einen Linux-Agent, wenn ein Multibyte-Dateiname erforderlich ist.

  • Plugins (veraltet):

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

Standardzeichenkodierung überschreiben

Um eine andere Zeichenkodierung als die Standardeinstellung zu verwenden, können Sie diese explizit festlegen. Einige Konnektoren (z. B. File Share, FTP, Local Storage und Temporary Storage) bieten eine Konfigurationsoption zum Festlegen der Zeichenkodierung.

Alternativ können Sie eine 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 der Name oder Alias des Code-Page-Konverters sein, wie im folgenden Beispiel gezeigt:

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