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. Nas 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 suporta oficialmente 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 APIs 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 gravar arquivos com conectores baseados em arquivos, incluindo File Share, FTP, Local Storage e Temporary Storage.
  • Colunas de strings em bancos de dados conectados via ODBC (veja 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 contendo caracteres multibyte. Esta é uma limitação do serviço subjacente de entrega de emails.

  • 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 contendo caracteres multibyte não produz a ordem alfabética esperada.

  • Nomes de ferramentas do servidor MCP: Um nome de ferramenta criado em um servidor MCP não suporta caracteres multibyte. Esta é uma restrição da especificação de nomenclatura de ferramentas do Model Context Protocol, não uma limitação específica do Jitterbit. Nomes de servidores MCP em si não são afetados.

  • 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, defina-a 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, use 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"