Ir para o conteúdo

Codificação de caracteres e suporte a multibyte no Jitterbit Harmony

Introdução

A codificação de caracteres padrão para a plataforma Harmony é UTF-8 a partir da versão 12.7 do agente e da versão 11.63 do Design Studio. Em versões anteriores, a codificação padrão é Latin-1 (ISO-8859-1).

Suporte a caracteres multibyte

A partir da versão 12.9 do agente e da versão 11.65 do Design Studio, o Jitterbit suporta oficialmente caracteres multibyte em toda a plataforma Harmony. O português, o alemão e o russo estão certificados como idiomas suportados.

Áreas suportadas

O suporte a caracteres multibyte inclui, entre outras áreas:

  • Nomes em toda a plataforma, incluindo nomes de projetos, nomes de operações, nomes de ambientes, nomes de agentes, nomes de variáveis globais e de projeto, nomes de APIs no Gerenciador de API, nomes de campos de esquema, nomes de conectores no Construtor de Conectores, nomes de Certificados de Cliente, nomes de funções e nomes de organizações.
  • Dados de origem de transformação, nomes de nós de esquema e valores codificados em transformações.
  • Conteúdos de scripts.
  • Comparações de strings usando == em scripts de condição.
  • Nomes de arquivos ao ler ou escrever arquivos com conectores baseados em arquivos, incluindo File Share, FTP, Local Storage, e Temporary Storage.
  • Colunas de string em bancos de dados conectados via ODBC (veja jitterbit.scripting.db.multibyte.enable).
  • Dados trocados com conectores.
  • Assuntos e corpos de notificações por e-mail.
  • Respostas de API.

Esta lista não é exaustiva; caracteres multibyte são suportados em áreas adicionais da plataforma além das listadas acima.

Limitações

Caracteres multibyte não são suportados nas seguintes áreas:

  • Jitterbit Message Queue (JBMQ):

  • Nomes de filas de mensagens suportam caracteres latinos estendidos (como os usados em português e alemão), mas não suportam caracteres cirílicos ou chineses.

  • Ambientes JBMQ com caracteres multibyte em seus nomes não podem ser habilitados no Console de Gerenciamento Filas de Mensagens Configurações.

  • Endereços de e-mail de usuários: Contas de usuário do Harmony não podem ser registradas ou criadas com um endereço de e-mail que contenha caracteres multibyte. Esta é uma limitação do serviço de entrega de e-mail subjacente.

  • Bancos de dados Microsoft Access: Caracteres multibyte armazenados em bancos de dados Microsoft Access não são lidos corretamente.

  • Ordenação do Cloud Datastore: Ordenar registros do Cloud Datastore por um campo que contém caracteres multibyte não produz a ordem alfabética esperada.

  • Delimitadores de campo: Um caractere multibyte usado como delimitador de campo em um formato de arquivo de texto não é processado de forma confiável. Use um delimitador de byte único (ASCII) ou, quando um delimitador multibyte for necessário, use o Studio com um agente Linux para os melhores resultados.

  • Plugins (obsoleto):

    • Nomes de plugins não suportam caracteres multibyte.
    • O plugin File Merger não pode processar arquivos com caracteres multibyte em seus nomes de arquivo.

Substituir a codificação de caracteres padrão

Para usar uma codificação de caracteres diferente da padrão, você pode defini-la explicitamente. Alguns conectores (por exemplo, File Share, FTP, Local Storage e Temporary Storage) incluem uma opção de configuração para definir a codificação de caracteres.

Alternativamente, você pode usar qualquer uma das seguintes variáveis Jitterbit em um script para definir a codificação 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

O valor deve ser o nome ou alias do conversor de página de código, conforme mostrado no seguinte exemplo:

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