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 agentes privados Docker e do 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 Marketplace categoria Agente de IA, 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 Marketplace categoria Agente de IA, 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 Estúdio de Design

• 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 nativa
  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 este 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 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 de 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 de Transações, o painel de Filtros agora agrupa o filtro de 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 de 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 de 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 Leitura 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 pelos mais antigos. Para atividades de Leitura FTP, Mais antigo 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 antigo primeiro requer a versão 12.7 do agente ou posterior.

Studio

• Visualização de diferenças para transferência e importação seletiva
  Agora você pode 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.

• Detalhe de nível de campo do histórico do projeto para configuração de conectores
  O histórico do projeto agora registra detalhes de nível de campo para alterações de configuração de endpoint e atividade de conectores, 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 Studio SDK

• Suporte ao conector Google Docs para OAuth de 3 etapas
  Uma conexão Google Docs possui um novo menu de 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 Shopify para OAuth de 3 etapas e versão da API 2026-04
  Uma conexão Shopify possui um novo menu de 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 de 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 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 passou por 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 Modelo nas atividades 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 usados.

Correções

Agente e Studio de Design

• 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, então as comparações com nomes de ambiente que os contêm são 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, por padrão, é definida como 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, elas 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, então 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, por padrão, é definida como false; defina como true para usar a largura baseada em bytes legada.

  • Agendas de operações 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 ou posterior do agente quanto a versão 11.63 ou posterior do Design Studio:

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

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

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

Agente

• Estabilidade do agente aprimorada durante o processamento de solicitações API simultâneas
  Os agentes são mais resilientes ao lidar com solicitações acionadas por API simultâneas, 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 Unparseable date.

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 API referenciavam certas operações poderia produzir uma especificação sem operações definidas.

• Busca por caractere curinga em mensagens de log de API agora é suportada
  A barra de pesquisa Consultas na página Logs de API agora lida corretamente com o caractere curinga % nas pesquisas de filtro message. Anteriormente, usar % em uma pesquisa 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 erro
  A opção Baixar como CSV na página 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 altos volumes 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 na 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 projeto 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: Conexão redefinida que ocorria durante chamadas HTTPS feitas pelo conector BMC Helix ITSM em certos casos foi resolvido.

• 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 do token OAuth não inclui um campo expires_in. Anteriormente, a geração de token falhava contra endpoints que omitiam este campo.

• A atividade OpenAI Create Image agora gera imagens usando gpt-image-2
  A atividade OpenAI Create Image anteriormente utilizava o modelo obsoleto dall-e-2, o que causava falhas na atividade. A atividade agora usa 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.

Notices

Agent

• Descontinuação da versão privada do agente 11.x
  A liberaçã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 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.

• 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, ou as operações que utilizam esses conectores começarão a falhar no momento da atualização.

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.

Conectores do SDK do Studio

• 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 do Cloud Datastore será removida permanentemente. Esta atividade foi substituída na versão 11.47 pela atividade de Itens de Consulta redesenhada, cuja estrutura de resposta achatada retorna os campos individuais que você define na página do Cloud Datastore do Console de Gerenciamento diretamente no nível superior da resposta.

  Importante

  Se você estiver usando a atividade de Itens de Consulta obsoleta em qualquer operação, deve revisar o design da sua operação e substituí-la pela atividade de Itens de Consulta redesenhada o mais rápido possível. A atividade obsoleta não é mais suportada e será removida em uma versão futura.