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 agent e 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 agent e versão 11.65 do Design Studio, o Jitterbit oferece suporte oficial a caracteres multibyte em toda a plataforma Harmony. Português, alemão e russo sã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 agents, nomes de variáveis globais e de projeto, nomes de API no API Manager, nomes de campos de schema, nomes de conectores do Connector Builder, 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 schema e valores codificados em transformações.
  • Conteúdo 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 (exceto em agents privados do Windows a partir da versão 12.10 do agent; consulte Limitações).
  • Colunas de string em bancos de dados conectados via ODBC (consulte jitterbit.scripting.db.multibyte.enable).
  • Dados trocados com conectores.
  • Assuntos e corpos de notificações por email.
  • 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 caracteres cirílicos ou chineses.
    • Ambientes JBMQ com caracteres multibyte em seus nomes não podem ser habilitados nas Configurações de Message Queues do Management Console.

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

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

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

  • Nomes de arquivos em agents privados do Windows: A partir da versão 12.10 do agent, ler ou escrever um arquivo cujo nome contém caracteres multibyte não é processado de forma confiável em agents privados do Windows, usando File Share, FTP, Local Storage ou Temporary Storage. Use um agent Linux quando um nome de arquivo multibyte for necessário.

  • Plugins (descontinuado):

    • 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 exemplo a seguir:

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