Saltar al contenido

Codificación de caracteres y soporte multibyte en Jitterbit Harmony

Introducción

La codificación de caracteres predeterminada para la plataforma Harmony es UTF-8 a partir de la versión 12.7 del agente y la versión 11.63 de Design Studio. En versiones anteriores, la codificación predeterminada es Latin-1 (ISO-8859-1).

Soporte de caracteres multibyte

A partir de la versión 12.9 del agente y la versión 11.65 de Design Studio, Jitterbit admite oficialmente caracteres multibyte en toda la plataforma Harmony. El portugués, el alemán y el ruso están certificados como idiomas compatibles.

Áreas soportadas

El soporte de caracteres multibyte incluye, entre otras áreas:

  • Nombres en toda la plataforma, incluidos nombres de proyectos, nombres de operaciones, nombres de entornos, nombres de agentes, nombres de variables globales y de proyecto, nombres de API en API Manager, nombres de campos de esquema, nombres de conectores en Connector Builder, nombres de certificados de cliente, nombres de roles y nombres de organizaciones.
  • Datos de origen de transformación, nombres de nodos de esquema y valores codificados en transformaciones.
  • Contenidos de scripts.
  • Comparaciones de cadenas usando == en scripts de condición.
  • Nombres de archivos al leer o escribir archivos con conectores basados en archivos, incluidos File Share, FTP, Local Storage, y Temporary Storage.
  • Columnas de cadenas en bases de datos conectadas por ODBC (ver jitterbit.scripting.db.multibyte.enable).
  • Datos intercambiados con conectores.
  • Asuntos y cuerpos de notificaciones por correo electrónico.
  • Respuestas de API.

Esta lista no es exhaustiva; los caracteres multibyte son compatibles en áreas adicionales de la plataforma más allá de las mencionadas anteriormente.

Limitaciones

Los caracteres multibyte no son compatibles en las siguientes áreas:

  • Jitterbit Message Queue (JBMQ):

  • Los nombres de las colas de mensajes admiten caracteres latinos extendidos (como los utilizados en portugués y alemán), pero no caracteres cirílicos o chinos.

  • Los entornos JBMQ con caracteres multibyte en sus nombres no pueden habilitarse en la Consola de Administración Colas de Mensajes Configuraciones.

  • Direcciones de correo electrónico de usuario: Las cuentas de usuario de Harmony no pueden registrarse o crearse con una dirección de correo electrónico que contenga caracteres multibyte. Esta es una limitación del servicio de entrega de correo electrónico subyacente.

  • Bases de datos de Microsoft Access: Los caracteres multibyte almacenados en bases de datos de Microsoft Access no se leen correctamente.

  • Ordenación de Cloud Datastore: Ordenar registros de Cloud Datastore por un campo que contenga caracteres multibyte no produce el orden alfabético esperado.

  • Delimitadores de campo: Un carácter multibyte utilizado como delimitador de campo en un formato de archivo de texto no se procesa de manera confiable. Utilice un delimitador de un solo byte (ASCII) o, cuando se requiera un delimitador multibyte, utilice Studio con un agente de Linux para obtener los mejores resultados.

  • Plugins (obsoleto):

    • Los nombres de los plugins no admiten caracteres multibyte.
    • El plugin File Merger no puede procesar archivos con caracteres multibyte en sus nombres de archivo.

Sobrescribir la codificación de caracteres predeterminada

Para utilizar una codificación de caracteres diferente a la predeterminada, puede configurarla explícitamente. Algunos conectores (por ejemplo, File Share, FTP, Almacenamiento Local y Almacenamiento Temporal) incluyen una opción de configuración para establecer la codificación de caracteres.

Alternativamente, puede utilizar cualquiera de las siguientes variables de Jitterbit en un script para establecer la codificación de caracteres:

  • 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

El valor debe ser el nombre o alias del convertidor de página de código, como se muestra en el siguiente ejemplo:

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