12.8 Harmony release notes

12.8 Harmony release

O lançamento do Harmony 12.8 é escalonado com base nas datas e horários listados abaixo por componente e região. Para uma explicação mais detalhada do cronograma de lançamento por categoria de componente, consulte o cronograma de lançamento.

O App Builder 4.64 e o Wevo iPaaS possuem notas de lançamento separadas.

Compilações de notas de lançamento para Production Cloud Agent Groups, Sandbox Cloud Agent Groups e agentes privados também estão disponíveis.

É possível se inscrever em notificações de manutenção para componentes baseados na web em Jitterbit Trust. Os componentes instalados localmente estão disponíveis na página Downloads. As imagens do agente privado Docker, gateway de API privado e App Builder estão disponíveis no Docker Hub da Jitterbit. A data de fim de vida útil desses componentes (exceto App Builder) é um ano após a data de lançamento.

Novos recursos

Agentes de IA

• Document Compliance Agent (Azure)
  O Document Compliance Agent (Azure), acessado pela categoria AI Agent do Marketplace, extrai automaticamente texto de PDFs usando o reconhecimento óptico de caracteres (OCR) do Azure Document Intelligence e aplica análise do Azure AI Foundry para detectar e remover informações de identificação pessoal (PII), ajudando as organizações a atender aos requisitos de privacidade de dados sem revisão manual de documentos. Para adicioná-lo à sua licença, entre em contato conosco.

• Document Compliance Agent (Google)
  O Document Compliance Agent (Google), acessado pela categoria AI Agent do Marketplace, extrai automaticamente texto de PDFs usando OCR do Google Document AI e aplica análise do Google Vertex AI para detectar e remover PII, ajudando organizações a atender requisitos de privacidade de dados sem revisão manual de documentos. Para adicioná-lo à sua licença, entre em contato conosco.

Conectores do Studio SDK

• Conector ServiceNow v2 (Beta)
  O conector ServiceNow v2 (Beta) pode ser usado com agentes na nuvem ou privados para consultar, criar, atualizar ou excluir registros no ServiceNow. Para acesso beta e fornecer feedback, entre em contato com o Jitterbit Product Team.

Melhorias

Agent

• Melhorias na validação do instalador de agente privado
  A instalação de uma versão de agente privado 12.8 ou posterior agora inclui validação adicional e orientação durante o processo de instalação:

  • Prompt de requisitos do sistema: Os instaladores do Windows e Linux agora exibem um prompt com os requisitos do sistema do agente durante a instalação.
  • Validação de senha do PostgreSQL: No Windows, o instalador agora valida a senha da conta de serviço do PostgreSQL (jitterbitpostgres) em relação às restrições de caracteres no momento da entrada e solicita que você a corrija antes que a instalação prossiga. Anteriormente, uma senha inválida não era detectada até depois que o PostgreSQL havia sido instalado, causando falha na instalação com Erro 1722.

API Manager

• Suporte a múltiplas credenciais de cliente para perfis de segurança OAuth 2.0 de 2 pernas
  Um perfil de segurança OAuth 2.0 usando 2-legged OAuth Flow (Microsoft Entra ID ou Okta) agora pode armazenar múltiplas entradas de credenciais de cliente em Credenciais do cliente, cada uma com seu próprio Nome do consumidor, ID do cliente, Segredo do cliente e Status (Ativo ou Inativo). Isso permite que múltiplos consumidores distintos se autentiquem na mesma API usando suas próprias credenciais, sem exigir um perfil de segurança ou API separado por consumidor.

EDI

• Suporte do EDI AI Assistant para códigos de tipo de documento
  O EDI AI Assistant agora suporta filtragem de transações por um código de tipo de documento específico, como 810 ou INVOIC, além de um tipo de documento geral como Invoice ou Order. Você pode fazer referência a um subtipo apenas por seu código (por exemplo, 810) ou qualificado com seu tipo geral (por exemplo, Invoice.810).

• Menus para criar com IA ou abrir configuração da interface
  Um novo menu Novo na página Trading Partners, na aba Gerenciar fluxos de trabalho de um parceiro e na aba Configurações de comunicação de um parceiro mostram opções para Criar com IA ou abrir a configuração da interface. Além disso, a página Transações tem um novo menu Pesquisa com uma opção Pesquisar com IA. A opção Criar com IA abre o EDI AI Assistant para criar um parceiro comercial, fluxo de trabalho ou conexão usando prompts em linguagem natural, e a opção Pesquisar com IA o abre para pesquisar transações.

• Redesenho da página Mensagens
  A página Mensagens tem uma interface redesenhada com as seguintes novas capacidades: filtragem e uma coluna para nível de severidade da mensagem (Alto, Médio, Baixo ou Informação); filtragem por categoria e subcategoria de mensagem; uma gaveta Colunas para mostrar, ocultar e reordenar colunas; e uma gaveta detalhes da mensagem para revisar entradas de log de uma mensagem sem perder seu lugar na lista.

Portal Harmony

• Redesenho da página de configurações de conta e redefinição de pergunta de segurança
  A página Configurações de conta (anteriormente Minha Conta) possui uma interface redesenhada com navegação por barra lateral e formulários separados para seu perfil e informações de contato. Agora você também pode redefinir sua pergunta de segurança e resposta, que fornecem uma forma adicional de verificar sua identidade.

Console de Gerenciamento

• Novo tipo de alerta: Status de SSO Alterado
  A página Alertas possui um novo tipo de alerta que envia emails para usuários com permissão de função Admin quando logon único (SSO) é ativado ou desativado para a organização. Este alerta é ativado por padrão para organizações novas e existentes, portanto usuários Admin recebem notificações automaticamente sem necessidade de configuração, a menos que o alerta seja reconfigurado ou excluído. Ativar ou desativar SSO também é registrado como uma entrada Update no registro de auditoria.

Studio

• Indicador de validação compacto para scripts de campo de transformação
  O status de validação de script para um script de campo de destino dentro de uma transformação agora é exibido como um indicador recolhido de uma única linha em vez de expandir automaticamente, correspondendo ao comportamento do editor de script completo e do componente de script. Mensagens de validação longas são truncadas com reticências, e você pode clicar no indicador para visualizar a mensagem completa em uma sobreposição flutuante que não desloca o script ou campos adjacentes. Clique fora da sobreposição ou use seu controle de fechamento para recolhê-la de volta ao indicador.

Conectores do Studio SDK

• Memória de curto prazo do conector Amazon Bedrock e recuperação de base de conhecimento
  O conector Amazon Bedrock possui os seguintes aprimoramentos:

  • Contexto de chat entre operações: Uma conexão Amazon Bedrock possui uma nova configuração Armazenar contexto de chat entre operações que ativa memória de curto prazo para grupos de agentes em nuvem, retendo contexto de chat além de uma única operação usando um chatId compartilhado. Quando ativado, use as novas configurações TTL de contexto de chat, Máximo de mensagens salvas no contexto e Quando contexto de chat não é encontrado para configurar retenção e comportamento de fallback. Agentes privados já retêm contexto de chat na memória para operações na mesma cadeia e não são afetados por esta configuração.
  • Fontes adicionais de recuperação de base de conhecimento: A atividade Prompt do Amazon Bedrock agora suporta bases de conhecimento que usam Amazon S3 Vectors (um armazenamento vetorial) ou Amazon Redshift (um armazenamento de dados estruturados) como fontes de recuperação, ativadas com a nova caixa de seleção Usar Base de Conhecimento.

• Conector Anthropic Claude (Beta)
  O conector Anthropic Claude (Beta) agora está disponível para todas as organizações. Pode ser usado com agentes em nuvem ou privados para enviar prompts e registrar ferramentas com modelos Claude hospedados pela Anthropic diretamente ou através do Amazon Bedrock. Para fornecer feedback sobre a versão beta, entre em contato com o Jitterbit Product Team.

• Substituição de conexão da atividade Enviar Documento do EDI for Cloud v2
  A atividade Enviar Documento do EDI for Cloud v2 possui uma nova configuração opcional, Usar Método de Comunicação Alternativo. Quando ativado, você pode selecionar uma conexão EDI específica da lista de conexões disponíveis para usar nessa operação, substituindo a conexão do parceiro comercial atribuída nas configurações de Comunicação do EDI.

• Suporte do conector OpenAI para a API Responses e ferramentas do servidor MCP
  O conector OpenAI possui três novas atividades baseadas na API Responses do OpenAI:

  • A atividade Prompt V2 cria uma resposta para um prompt e pode chamar ferramentas registradas por uma atividade anterior que usa o mesmo chatId.
  • A atividade Register Tools V2 adiciona ferramentas a um assistente chatbot.
  • A atividade Register MCP Server Tools registra um servidor MCP remoto como provedor de ferramentas, tornando suas ferramentas disponíveis para uma atividade Prompt V2 encadeada, permitindo que modelos descubram e invoquem dinamicamente ferramentas de endpoints MCP gerenciados pelo cliente em tempo de execução.

  Essas três atividades também suportam persistência de contexto de chat entre operações usando um chatId compartilhado: uma conexão OpenAI possui uma nova configuração Armazenar contexto de chat entre operações (apenas atividades V2) para grupos de agentes na nuvem, com configurações dependentes de TTL do contexto de chat, Máximo de mensagens salvas no contexto e Quando o contexto de chat não é encontrado. Agentes privados já retêm o contexto de chat na memória e não são afetados por essa configuração. As atividades Prompt e Register Tools existentes não são afetadas.

Alterações

Agente

• Driver JDBC do Microsoft SQL Server atualizado
  O driver JDBC do Microsoft SQL Server incluído no agente foi atualizado. A partir da versão 10.2 do driver, a Microsoft alterou as propriedades de conexão padrão para que o driver solicite uma conexão criptografada (encrypt=true) e valide o certificado do servidor, uma alteração que a Microsoft documenta como quebra sob a propriedade de conexão encrypt.

  Uma conexão com um SQL Server cujo certificado não pode ser rastreado até uma autoridade de certificação que o agente já confia, como Amazon RDS para SQL Server, agora falha com um erro PKIX path building failed. Para resolver isso, insira encrypt=false; no campo Parâmetros adicionais da string de conexão, conforme descrito em Criptografia de conexão e certificados do servidor. A mesma orientação se aplica a uma fonte ou destino de banco de dados Microsoft SQL do Design Studio.

• Criptografia de senha PostgreSQL usa MD5 por padrão em agentes privados Linux
  Agentes privados Linux agora usam criptografia de senha MD5 para a instância PostgreSQL incluída por padrão, revertendo o padrão SCRAM-SHA-256 que foi introduzido para instalações novas do Linux em 12.6. Ao atualizar um agente Linux cujo PostgreSQL usa SCRAM-SHA-256, o instalador solicita que você redefina a criptografia para MD5 (recomendado) ou mantenha SCRAM-SHA-256; a atualização continua de qualquer forma, e o usuário do banco de dados jitterbit e sua senha permanecem inalterados. Agentes que já usam MD5 e atualizações executadas com silent_install definido não são solicitados e mantêm sua criptografia existente. Para usar SCRAM-SHA-256 em um agente Linux, consulte SCRAM no PostgreSQL.

Gateway de API

• Alterações gerais
  O gateway de API possui alterações gerais para manutenção e desempenho.

API Manager

• Exibição do nome da API no filtro APIs da página Analytics
  O filtro APIs na página Analytics do API Manager agora exibe cada API apenas pelo seu nome, e a filtragem por uma API corresponde ao nome da API. Anteriormente, o menu suspenso exibia o nome da API concatenado com seu número de versão. Como a filtragem corresponde ao nome, selecionar uma API pode retornar resultados para várias APIs que compartilham o mesmo nome; use os filtros separados Versão e Ambiente para restringir os resultados.

Console de Gerenciamento

• Escopo de acesso de função de ambiente para as abas Acesso a Projetos e Acesso a API
  As abas Acesso a Projetos e Acesso a API na gaveta Atribuições de Função do Gerenciamento de Usuários agora listam um projeto ou API apenas quando tanto a função selecionada quanto sua própria conta de usuário têm pelo menos acesso de função de ambiente de Leitura ao seu ambiente. Anteriormente, você podia ver projetos e APIs listados aqui aos quais não tinha acesso de função de ambiente.

Conectores do Studio SDK

• Configuração de corpus RAG do conector Google Gemini movida; requer ação do usuário
  A opção Usar Corpus RAG (Vertex AI) da atividade Prompt do Google Gemini agora exibe os campos de seleção de corpus RAG na mesma etapa das configurações de modelo e prompt, em vez de em uma etapa separada.

  Ação necessária: Atividades Prompt existentes que usam Corpus RAG (Vertex AI) devem ser reconfiguradas

  Operações existentes que usam atividades Prompt configuradas com Usar Corpus RAG (Vertex AI) habilitado antes dessa alteração falharão até que você abra a atividade e reconfigure a seleção de corpus RAG. Atividades Prompt sem essa opção habilitada não são afetadas.

Correções

Agent

• Nova variável Jitterbit para preservar prefixos de namespace XML de origem
  A nova variável Jitterbit jitterbit.target.xml.preserve.namespace.prefix pode ser definida como true antes de uma transformação com saída XML para preservar os prefixos de namespace definidos no XML de origem. Por padrão (false), as transformações continuam aplicando prefixos de namespace genéricos (ns, ns2 e assim por diante), portanto o comportamento existente não muda a menos que você defina essa variável. Isso é útil quando um endpoint de destino requer que os prefixos de namespace originais sejam retidos.

• Funções de data e hora agora preservam valores de meia-noite
  As funções ConvertTimeZone, Date e GeneralDate agora tratam meia-noite (00:00:00) como um valor de hora válido e o preservam no valor retornado, seja a entrada uma string de data e hora bruta ou produzida por Date ou GeneralDate. Anteriormente, um valor convertido ou analisado de exatamente meia-noite podia ser truncado para uma string somente de data, enquanto qualquer outra hora era preservada corretamente. A função CVTDate não foi afetada.

• Estabilidade melhorada do agent durante o processamento de operações
  Os agents são mais estáveis ao executar transformações e processar operações sob carga. Isso resolve travamentos que poderiam ocorrer durante transformações e conversões de formato de dados, quando operações de longa duração atingem seu tempo limite e ao processar altos volumes de operações simultaneamente.

Agent e Design Studio

• Correções de caracteres multibyte
  As seguintes correções resolvem problemas com falhas de operação, saída incorreta, caracteres exibidos incorretamente e arquivos inacessíveis.

  Essas correções se aplicam ao usar a versão 12.8 ou posterior do agent:

  • As operações não falham mais com um erro UTF-8 Invalid byte quando os dados de origem ou o nome de um arquivo de origem contém caracteres multibyte. Por exemplo, um arquivo de origem JSON com conteúdo multibyte agora é carregado corretamente em uma transformação, e uma operação Salesforce com um caractere multibyte no nome do arquivo de origem não retorna mais uma falha SOAP.
  • As operações do NetSuite não substituem mais caracteres multibyte em nomes de campos retornados por ?, o que anteriormente causava falhas em transformações.
  • Os conectores Compartilhamento de Arquivo e FTP agora podem ler arquivos cujos nomes contêm caracteres multibyte. Anteriormente, as operações podiam falhar quando um nome de arquivo continha caracteres multibyte.

Essas correções exigem versão do agente 12.8 ou posterior e Design Studio 11.64 ou posterior:

• Nomes de objetos do Oracle EBS que contêm caracteres multibyte agora são exibidos corretamente no assistente de seleção de objetos.
• Caracteres multibyte não são mais corrompidos quando um projeto do Design Studio é baixado ou restaurado da nuvem Harmony, incluindo em assuntos e corpos de mensagens de email.

Management Console

• A pesquisa de Runtime agora suporta códigos de status HTTP para entradas de log de API
  A chave de pesquisa status da página Runtime agora aceita um código de status HTTP (100–599) para pesquisar entradas de log de Custom API, Proxy API e OData API, além de um nome de status de operação para entradas de log de Operation. Anteriormente, pesquisar com um código de status HTTP retornava um erro e nenhuma entrada de log de API.

Studio

• A transformação agora salva múltiplos scripts de mapeamento abertos sem erro de conflito
  O editor de transformação não mostra mais um falso conflito de salvamento quando você tem múltiplos scripts de mapeamento abertos e editados simultaneamente. Anteriormente, editar conteúdo de script ou valores de campo em vários scripts abertos podia disparar intermitentemente uma mensagem de conflito de salvamento; resolvê-la descartava suas alterações não salvas e fechava qualquer script de mapeamento aberto.

Studio SDK connectors

• Atualizar o schema de uma atividade existente não falha mais com DTDPARSER_ERR_UNKNOWN_FILE_EXTENSION
  Atualizar o schema de uma atividade previamente configurada, como para os conectores JWT ou Stripe, não falha mais com um erro DTDPARSER_ERR_UNKNOWN_FILE_EXTENSION e um schema de resposta em branco. Anteriormente, isso podia ocorrer em uma atividade criada antes de uma mudança em como esses conectores relatam seu tipo de schema.

Avisos

Agent

• Descontinuação do versionamento de agente privado 11.x
  A versão 11.59 / 12.3 incluiu a versão final do agente privado 11.x (11.59) e a primeira versão disponível do agente privado 12.x (12.3). Observe o seguinte em relação a versões futuras:

  • Versão final 11.x: A versão do agente privado 11.x atingiu o fim do seu desenvolvimento planejado. Todos os aprimoramentos futuros, novos recursos e atualizações de segurança serão entregues através de agentes privados 12.x. Embora agentes 11.x possam receber correções críticas raras para problemas que impactam a produção, nenhuma versão contínua está planejada.

  • Recomendação: Recomendamos fortemente atualizar para agentes privados 12.x assim que possível para se beneficiar dos últimos aprimoramentos de desempenho, segurança e recursos.

  • Caminho de atualização: Você pode atualizar diretamente de 11.x para qualquer versão 12.x usando nossas instruções de atualização documentadas: Windows, Linux ou Docker.

  Ações necessárias: Atualizações de plugin e verificação de conectores personalizados para agentes privados 12.x

  • Atualizações de plugin para agentes privados 12.x
    Aprimoramentos de desempenho e segurança para agentes privados 12.x são incompatíveis com os Plugins Multipart Pipeline e AWS S3 Create. Se você usar esses plugins, é necessária uma ação do usuário conforme descrito nas instruções de atualização.

• Verificação de conectores personalizados para agentes privados 12.x
  Conectores do Connector SDK fornecidos por terceiros devem passar por alterações de desenvolvimento para serem compatíveis com agentes privados 12.x. Antes de atualizar para agentes privados 12.x, verifique a compatibilidade com o desenvolvedor do conector, caso contrário, as operações que usam esses conectores começarão a falhar no momento da atualização.

• Fim da vida útil da versão 11.46
  A partir de 17 de julho de 2026, a versão 11.46 do agente privado atingiu o fim da vida útil e não é mais suportada. Recomendamos que os usuários dessa versão façam a atualização para a versão mais recente assim que possível.

Design Studio

• Requisito de versão incorreto em projetos com um endpoint Salesforce
  Design Studio 11.63 e 11.64 podem marcar um projeto contendo um endpoint Salesforce com uma versão obrigatória de 12.7.0.0, uma versão do Design Studio que não existe. Abrir ou importar um projeto afetado falha com um erro informando que o Jitterpak requer a versão 12.7.0.0 ou superior. Design Studio 11.64.1, disponível na página Downloads do portal Harmony, exporta o requisito de versão correto. Para corrigir um projeto já afetado, consulte Problemas conhecidos do Design Studio.

Conectores Studio SDK

• Ação necessária: Remoção futura da atividade Cloud Datastore Query Items descontinuada
  Em uma versão futura, a atividade Query Items descontinuada no conector Cloud Datastore será removida permanentemente. Essa atividade foi substituída na versão 11.47 pela atividade Query Items reformulada, cuja estrutura de resposta simplificada retorna os campos individuais que você define na página Cloud Datastore do Console de Gerenciamento diretamente no nível superior da resposta.

  Importante

  Se você estiver usando a atividade Query Items descontinuada em qualquer operação, deve revisar o design da operação e substituí-la pela atividade Query Items reformulada assim que possível. A atividade descontinuada não é mais suportada e será removida em uma versão futura.