12.7 Notas de versão do Harmony

12.7 Lançamento do Harmony

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

App Builder 4.63 e Wevo iPaaS possuem notas de versão separadas.

Compilações de notas de versão para Grupos de Agentes de Nuvem de Produção, Grupos de Agentes de Nuvem de Sandbox e agentes privados também estão disponíveis.

Você pode se inscrever para notificações de manutenção para componentes baseados na web em Jitterbit Trust. Componentes instalados localmente estão disponíveis na página de Downloads. Imagens de agente privado Docker e App Builder estão disponíveis no Docker Hub da Jitterbit. A data de término de vida útil desses componentes (exceto o App Builder) é um ano após a data de lançamento.

Novos recursos

Agentes de IA

• Agente de Apresentação QBR
  O Agente de Apresentação QBR, acessado a partir da categoria Agente de IA no Marketplace , automatiza a criação de apresentações de revisão de negócios trimestral (QBR) no Google Slides, reunindo dados de clientes do Salesforce, NetSuite e APIs de uso de produtos, utilizando IA para produzir resumos e insights estruturados. Para adicioná-lo à sua licença, entre em contato conosco.

• Agente de RFI de Segurança
  O Agente de RFI de Segurança, acessado a partir da categoria Agente de IA no Marketplace , automatiza o processamento de ponta a ponta de questionários de RFI de Segurança (Request for Information) para elaborar respostas fundamentadas a partir de suas bases de conhecimento internas e entregar documentos Word e Excel prontos para submissão. Para adicioná-lo à sua licença, entre em contato conosco.

Melhorias

Agente e Design Studio

• Codificação de caracteres padrão alterada para UTF-8
  A partir da versão 12.7 do agente e da versão 11.63 do Design Studio, a codificação de caracteres padrão para a plataforma Harmony foi alterada de Latin-1 (ISO-8859-1) para UTF-8. Se sua integração requer uma codificação de caracteres específica, configure-a explicitamente usando as variáveis de codificação de caracteres.

Agente

• Suporte a proxy para métricas de observabilidade nativas
  A funcionalidade de observabilidade nativa de um agente privado, que relata métricas através da página Agentes do Console de Gerenciamento, agora herda automaticamente a configuração de proxy do agente quando o agente se comunica através de um servidor proxy.

• Atualização do Apache Tomcat
  O servidor Apache Tomcat incluído com o agente foi atualizado para melhorar a segurança e o desempenho.

Agente, Estúdio e Design Studio

• Suporte à versão 66 da API do Salesforce
  A versão 66 da API do Salesforce (Spring '26) agora é suportada pelos seguintes conectores:

  • O conector Salesforce do Studio usa automaticamente esta versão da API para atividades não em massa quando sua conexão é configurada com Credenciais de Cliente OAuth 2.0 e utilizada com agentes 12.7 ou posteriores.

  • O conector Salesforce do Design Studio suporta esta versão da API com o uso de agentes 12.7 ou posteriores e da versão 11.63 ou posterior do Design Studio. Quando ambos os requisitos de versão são atendidos, um diálogo de atualização da API é exibido ao abrir projetos existentes que utilizam este conector.

Gerenciador de API, EDI e portal Harmony

• Expandir e redimensionar controles para painéis do assistente de IA
  Os painéis do AskJB AI, Assistente de IA do APIM e Assistente de IA do EDI agora incluem um controle Expandir para tornar o painel mais largo. Os painéis também podem ser redimensionados manualmente arrastando a borda esquerda do painel. Quando um painel está expandido, use o ícone Minimizar para retornar à visualização anterior.

API Manager e Console de Gerenciamento

• Opção de exportação de logs de Runtime e API em CSV para incluir mensagens de log
  A opção Baixar como CSV na página Runtime da Console de Gerenciamento e na página de Logs da API agora abre um diálogo de Baixar logs onde você pode selecionar Incluir mensagens para adicionar o conteúdo completo das mensagens de log à exportação.

EDI

• Filtro de tipo de documento em dois níveis na página de Transações
  Na página Transações, o painel de Filtros agora agrupa o filtro Todos os tipos de documentos em dois níveis: um tipo de documento geral (como Pedido ou Fatura) que você pode expandir para revelar seus subtipos específicos, cada um identificado pelo seu código de tipo de documento (como 850 ou 810). Selecione um tipo de documento geral para filtrar por todos os seus subtipos de uma vez, ou selecione um ou mais subtipos para filtrar apenas por aqueles.

• Suporte do Assistente de IA EDI para consulta de documentos não conformes
  O Assistente de IA EDI agora suporta a busca por documentos que falharam nas verificações de conformidade. Você pode opcionalmente filtrar os resultados por nome do parceiro, tipo de documento, direção, status ou intervalo de datas. Se 20 ou menos documentos correspondentes forem encontrados, o assistente lista os IDs dos documentos; se mais de 20 forem encontrados, o assistente oferece agrupar os resultados por parceiro ou refinar a busca.

Console de Gerenciamento

• Configurações adicionais de política de senha editáveis em organizações com SSO habilitado
  Na página Organizações, duas políticas de Gerenciamento de Usuários, Exigir caractere(s) especial(is) na senha e Exigir autenticação de dois fatores (TFA), agora podem ser editadas após a habilitação do single sign-on (SSO) Harmony para uma organização. Essas configurações se aplicam aos usuários na lista Ignorar SSO da organização.

Studio e Console de Gerenciamento

• Conclusão de linha gerada por IA no editor de scripts Jitterbit
  O editor de scripts Jitterbit do Studio agora pode exibir sugestões de linha geradas por IA em tempo real enquanto você digita, que podem ser aplicadas pressionando Tab. O recurso é controlado por duas novas configurações:

  • Política da organização: Um administrador da organização habilita a conclusão de linha gerada por IA através da política Permitir conclusão de código de linha completa no editor de scripts Jitterbit na aba Studio da página Organizações do Console de Gerenciamento. Esta política está desativada por padrão.

  • Configuração do projeto: Uma vez que a política esteja habilitada, a configuração Habilitar sugestão de conclusão de código de linha completa no editor de scripts Jitterbit na aba Avançado de criação e configuração de projetos controla o recurso por projeto.

Studio e Agente

• Configuração da ordem de processamento de arquivos para conectores baseados em arquivos
  As atividades Read do File Share, FTP, Armazenamento Local e Armazenamento Temporário agora possuem uma nova opção Ordem de processamento de arquivos nas Configurações Opcionais. Selecione Nome do arquivo (padrão) para processar arquivos em ordem alfabética pelo nome do arquivo, ou Mais antigos primeiro para processar arquivos na ordem em que foram modificados, começando pelo mais antigo. Para as atividades Read do FTP, a opção Mais antigos primeiro utiliza precisão de timestamp em nível de minuto devido a limitações do protocolo FTP; arquivos modificados dentro do mesmo minuto são processados na ordem retornada pelo servidor FTP. A ordenação Mais antigos primeiro requer a versão 12.7 ou posterior do agente.

Studio

• Visualização de diferenças para transferência e importação seletiva
  Agora é possível visualizar as alterações em um script ou transformação conflitante antes de transferi-lo ou importá-lo. Clique no botão Ver alterações para abrir uma comparação lado a lado, com linhas removidas em vermelho e linhas adicionadas em verde. O botão aparece para componentes na categoria Substituir durante uma transferência seletiva e para componentes conflitantes durante uma importação seletiva.

• Detalhes de nível de campo no histórico do projeto para configuração de conector
  O histórico do projeto agora registra detalhes de nível de campo para alterações de configuração de endpoint e atividade do conector, incluindo campos de autenticação.

• Redesign da visualização em cartão da página de projetos
  A visualização em cartão na página de Projetos foi redesenhada para consistência com outros aplicativos Harmony, com cartões exibindo ícones de endpoint ao lado das informações padrão do projeto.

Conectores do SDK do Studio

• Suporte ao conector do Google Docs para OAuth de 3 etapas
  Uma conexão do Google Docs possui um novo menu Tipo de autenticação onde você seleciona OAuth (novo suporte) ou Baseado em chave privada (padrão existente). A opção OAuth utiliza OAuth 2.0 de 3 etapas (3LO) e requer um registro de aplicativo configurado no Console de Gerenciamento. Para instruções de configuração, consulte Pré-requisitos do Google Docs 3LO.

• Suporte ao conector do Shopify para OAuth de 3 etapas e versão da API 2026-04
  Uma conexão do Shopify possui um novo menu Mecanismo de autenticação onde você seleciona OAuth (novo suporte) ou Autenticação baseada em credenciais (padrão existente). A opção OAuth utiliza OAuth 2.0 de 3 etapas (3LO) e requer um registro de aplicativo configurado no Console de Gerenciamento. Para instruções de configuração, consulte Pré-requisitos do Shopify 3LO. O menu Versão da API agora também possui a versão da API REST Admin 2026-04 como uma seleção.

• Suporte ao conector ZoomInfo (Beta) para OAuth de 3 etapas
  Uma conexão ZoomInfo possui um novo menu de Autenticação onde você seleciona Fluxo de Código de Autorização (novo suporte) ou Fluxo de Credenciais do Cliente (padrão existente). A opção de Fluxo de Código de Autorização utiliza OAuth 2.0 de 3 etapas (3LO) e requer um registro de aplicativo configurado no Console de Gerenciamento. Para instruções de configuração, consulte Pré-requisitos do ZoomInfo 3LO.

Mudanças

Agente

• Valores padrão de capacidade de CPU atualizados para agentes privados
  Os valores padrão de CpuConsecutiveFailureThreshold e CapabilityRefreshCooldown na seção [AgentCapability] do jitterbit.conf mudaram:

  • CpuConsecutiveFailureThreshold (introduzido em 12.6) agora tem como padrão 3 (anteriormente 1), exigindo três violações consecutivas do limite de CPU antes que o agente transite de Capaz para Incapaz.

  • CapabilityRefreshCooldown agora tem como padrão 1 (anteriormente 2), reduzindo o período de espera em segundos antes que o status de capacidade seja atualizado após o agente se tornar incapaz.

Gateway de API

• Mudanças gerais
  O gateway de API possui mudanças gerais para manutenção e desempenho.

Conectores do SDK do Studio

• Remoção de modelos OpenAI obsoletos
  Seis modelos OpenAI obsoletos foram removidos do dropdown de Modelo nas atividades de OpenAI Prompt e Registrar Ferramentas: gpt-4-turbo-preview, gpt-4-vision-preview, gpt-4-32k, gpt-3.5-turbo-instruct, babbage-002 e davinci-002. Esses modelos não são mais suportados pela OpenAI e retornariam erros se utilizados.

Correções

Agente 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 e backups inacessíveis.

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

  • A função WriteToOperationLog agora grava caracteres multibyte no log de operações corretamente. Anteriormente, esses caracteres estavam corrompidos.

  • A função GetEnvironmentName agora retorna caracteres multibyte corretamente, de modo que as comparações com nomes de ambientes que os contêm sejam bem-sucedidas.

  • A função StringLength agora conta caracteres multibyte corretamente em vez de contar bytes. Uma nova variável jitterbit.script.string.utf8size controla esse comportamento e tem como padrão true; defina como false para usar a contagem de bytes legada.

  • As funções ToLower, ToUpper e ToProper agora convertem corretamente o caso de caracteres multibyte. Anteriormente, podiam deixar o caso de um caractere multibyte inalterado ou alterar incorretamente o caso de um caractere adjacente.

  • Arquivos de texto de largura fixa agora calculam as larguras dos campos pela contagem de caracteres em vez da contagem de bytes, de modo que caracteres multibyte não deslocam mais as posições das colunas. Uma nova variável jitterbit.text.fixed_width_use_byte_length controla esse comportamento e tem como padrão false; defina como true para usar a largura baseada em bytes legada.

• Agendas de operação cujos nomes contêm caracteres multibyte não falham mais ao serem executadas. Anteriormente, certos caracteres em um nome de agenda podiam interromper a conexão do agente com o banco de dados e impedir a execução da operação na agenda.

  Essas correções requerem tanto a versão 12.7 do agente ou posterior quanto a versão 11.63 do Design Studio ou posterior:

  • Operações de consulta do NetSuite que contêm caracteres multibyte não falham mais com um erro de análise XML.

  • O recurso Chamada de serviço web de teste agora exibe caracteres multibyte corretamente no destino.

  • Backups de projeto implantados com caracteres multibyte na tag de implantação agora podem ser baixados da página Projetos do Console de Gerenciamento.

Agente

• Estabilidade do agente aprimorada sob processamento de solicitações API concorrentes
  Os agentes são mais resilientes ao lidar com solicitações acionadas por API concorrentes, resolvendo uma falha que poderia ocorrer durante o processamento.

• A função FromDataLoaderDateTime agora analisa datas no formato europeu
  A função obsoleta FromDataLoaderDateTime no Design Studio agora analisa corretamente datas no formato europeu usando um ponto (DD.MM.YYYY) ou hífen (DD-MM-YYYY) como separador de data. Anteriormente, esses formatos retornavam o erro 1007 Data não analisável.

Gerenciador de API

• Regenerar Docs não produz mais documentação OpenAPI vazia
  O botão Regenerar Docs do Gerenciador de Portal agora gera documentação OpenAPI para todas as APIs personalizadas e proxy em um ambiente. Anteriormente, gerar documentação para um ambiente cujos serviços de API referenciavam certas operações poderia produzir uma especificação sem operações definidas.

• A busca por curinga em mensagens de log da API agora é suportada
  A barra de busca de Consultas na página de Logs da API agora lida corretamente com o caractere curinga % nas buscas do filtro message. Anteriormente, usar % em uma busca de mensagem (por exemplo, message=%final client%) causava um erro e não retornava dados.

• Downloads de CSV de logs da API grandes não geram mais erros
  A opção Baixar como CSV na página de Logs da API agora gera e baixa com sucesso arquivos CSV para grandes conjuntos de dados. Anteriormente, baixar logs da API para grandes intervalos de datas ou volumes altos de registros resultava em erros como O arquivo CSV ainda está sendo gerado. Por favor, tente novamente mais tarde e Ocorreu um erro ao gerar o arquivo CSV.

Console de Gerenciamento

• Excluir um ambiente agora remove recursos associados
  Excluir um ambiente da página Ambientes do Console de Gerenciamento agora exclui automaticamente todos os armazenamentos do Cloud Datastore, filas de mensagens e certificados de cliente associados. Anteriormente, excluir um ambiente poderia deixar recursos órfãos que não podiam mais ser editados ou excluídos, causando erros de logout ao serem acessados.

Estúdio

• Desempenho de carregamento de projetos melhorado
  Abrir um projeto no Estúdio agora é significativamente mais rápido em ambientes com um grande número de projetos e operações.

Conectores SDK do Estúdio

• Erro SSLException do conector BMC Helix ITSM resolvido
  Um erro intermitente SSLException: Connection reset que ocorria durante chamadas HTTPS feitas pelo conector BMC Helix ITSM em certos casos foi resolvido.

• O conector HTTP v2 OAuth 2.0 Client Credentials agora suporta endpoints de token que omitem expires_in
  O tipo OAuth 2.0 Client Credentials Grant do conector HTTP v2 agora gera um token de acesso quando a resposta do endpoint de token OAuth não inclui um campo expires_in. Anteriormente, a geração de token falhava em endpoints que omitiam esse campo.

• A atividade OpenAI Create Image agora gera imagens usando gpt-image-2
  A atividade Create Image da OpenAI anteriormente usava o modelo obsoleto dall-e-2, o que causava a falha da atividade. A atividade agora utiliza o modelo gpt-image-2 e inclui novas configurações opcionais: Formato de Saída (jpeg, png, webp), Número de Imagens, Qualidade, Compressão de Saída, Moderação e Fundo. Os dados da imagem são retornados como uma string JSON codificada em Base64 (b64_json); respostas no formato de URL não são mais suportadas.

Avisos

Agente

• Aposentadoria da versão privada do agente 11.x
  O lançamento 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 aos lançamentos futuros:

  • Versão final 11.x: A versão privada do agente 11.x atingiu o fim de seu desenvolvimento planejado. Todas as futuras melhorias, novos recursos e atualizações de segurança serão entregues através de agentes privados 12.x. Embora os agentes 11.x possam receber correções críticas raras para problemas que impactam a produção, nenhum lançamento contínuo está planejado.

  • Recomendação: Recomendamos fortemente a atualização para agentes privados 12.x o mais rápido possível para se beneficiar das últimas melhorias 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.

Agente e gateway de API

• Fim da vida útil da versão 11.45
  A partir de 26 de junho de 2026, essas versões de produto atingiram o fim da vida útil e não são mais suportadas:

  • Versão 11.45 do agente privado

  • Versão 11.45 do gateway de API privado

  Recomendamos que os usuários dessas versões atualizem para a versão mais recente assim que possível.

Design Studio

• Requisito de versão incorreto em projetos com um endpoint Salesforce
  O Design Studio 11.63 e 11.64 pode marcar um projeto contendo um endpoint Salesforce com um requisito de versão 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. O 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 que já está afetado, consulte Problemas conhecidos do Design Studio.

Conectores do SDK do Estúdio

• Ação necessária: Remoção iminente da atividade de Itens de Consulta do Cloud Datastore obsoleta
  Em uma próxima versão, a atividade de Itens de Consulta obsoleta no conector Cloud Datastore será removida permanentemente. Esta atividade foi substituída na versão 11.47 pela atividade de Itens de Consulta reformulada, cuja estrutura de resposta achatada 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 obsoleta em qualquer operação, deve revisar o design da sua operação e substituí-la pela atividade Query Items redesenhada o mais rápido possível. A atividade obsoleta não é mais suportada e será removida em uma versão futura.