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 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 agentes, 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.
- Subdomínios de API.
- Dados de origem de transformação, nomes de nós de schema e valores codificados em transformações.
- Conteúdos de script.
- Comparações de strings usando
==em scripts de condição. - Nomes de arquivo ao ler ou escrever arquivos com conectores baseados em arquivo, incluindo File Share, FTP, Local Storage e Temporary Storage.
- 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 do Message Queues do Console de Gerenciamento.
-
Endereços de email do usuário: Contas de usuário do Harmony não podem ser registradas ou criadas com um endereço de email que contenha caracteres multibyte. Essa é uma limitação do serviço subjacente de entrega de email.
-
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.
-
Nomes de ferramentas do servidor MCP: Um nome de ferramenta criado em um servidor MCP não suporta caracteres multibyte. Essa é uma restrição da especificação de nomenclatura de ferramentas do Model Context Protocol, não uma limitação específica do Jitterbit. Os próprios nomes de servidor MCP não são afetados.
-
Headers de solicitação da Proxy API: Chaves e valores de header na aba Request headers de uma proxy API e nomes de parâmetros de header na aba Services não suportam caracteres multibyte. Essa é uma restrição da especificação HTTP, não uma limitação específica do Jitterbit.
-
Plugins (descontinuado):
- Nomes de plugins não suportam caracteres multibyte.
- O plugin File Merger não consegue 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, é possível 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"