12.10 Notas de versão do Harmony

12.10 Lançamento do Harmony

O lançamento do Harmony 12.10 é 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.66 e o Wevo iPaaS possuem notas de lançamento separadas.

Compilações de notas de lançamento 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.

É possível se inscrever em notificações de manutenção para componentes baseados na web em Jitterbit Trust. Componentes instalados localmente estão disponíveis na página Downloads. Imagens de 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

Conectores do Studio SDK

• Conector Anthropic Claude
  O conector Anthropic Claude agora está geralmente disponível. Pode ser usado com agentes na nuvem ou privados para enviar prompts e registrar ferramentas com modelos Claude hospedados pela Anthropic diretamente ou através do Amazon Bedrock.

• Conector PDF Utilities
  O conector PDF Utilities agora está geralmente disponível. Pode ser usado com agentes na nuvem ou agentes privados versão 12.3 ou posterior para gerar documentos PDF, sem necessidade de API externa ou chamadas de rede de saída. As atividades Convert Text to PDF e Convert HTML to PDF do conector convertem conteúdo em texto simples ou HTML em um documento PDF.

Melhorias

Agente

• Atualização do PostgreSQL para agentes privados do Windows
  A versão do PostgreSQL incluída nos agentes privados do Windows foi atualizada para melhorar a segurança e a estabilidade.

• Atualização do driver JDBC do Oracle e PostgreSQL
  Os drivers JDBC do Oracle e PostgreSQL inclusos no agente foram atualizados para melhorar a compatibilidade com conexões de banco de dados no Studio e fontes e destinos de banco de dados no Design Studio.

Agente, Studio e Design Studio

• Suporte à API Salesforce versão 67
  A API Salesforce versão 67 (Summer '26) agora é suportada pelos seguintes conectores:

  • O conector Salesforce do Studio usa automaticamente esta versão de API para atividades não em massa quando sua conexão é configurada com OAuth 2.0 Client Credentials e usada com agentes versão 12.10 ou posterior.
  • O conector Salesforce do Design Studio suporta esta versão de API com o uso de agentes versão 12.10 ou posterior e Design Studio versão 11.66 ou posterior. Quando ambos os requisitos de versão são atendidos, um diálogo de atualização de API é exibido ao abrir projetos existentes que usam este conector.

API Manager

• Busca avançada na página APIs
  O painel Filtro anterior no lado esquerdo da página APIs é substituído por dois modos de busca, alinhando-se com a experiência de busca já usada na página API Logs:

  • Busca simples: A barra de busca existente filtra instantaneamente a tabela de APIs exibida correspondendo o texto inserido em todas as colunas exibidas.
  • Busca avançada: Clique no ícone ao lado da barra de busca para abrir um painel onde você pode combinar filtros integrados, como Tipo de API, Status da API, Ambiente e Última publicação, e salvar a combinação como uma busca reutilizável. Abrir este painel limpa qualquer texto de Busca simples ativo, e redefini-lo retorna à lista padrão de APIs.

• Confirmação antes de limpar o documento OpenAPI em APIs de proxy
  Na aba API existente de uma configuração de API de proxy, clicar em Limpar agora exibe um prompt de confirmação antes de remover um documento OpenAPI fornecido. Limpar o documento também remove quaisquer serviços descobertos automaticamente gerados a partir dele, mas não afeta serviços adicionados manualmente ou outras configurações de API.

EDI

• Suporte a conexão AS2 para Content-Transfer-Encoding binário
  Uma conexão AS2 agora aceita valores binary (além dos valores base64 anteriormente suportados) para o cabeçalho Content-Transfer-Encoding em mensagens recebidas, funcionando com parceiros comerciais independentemente de qual codificação seu endpoint AS2 usa.

• Opções LF e CR para o Separador de Segmento X12 (ISA18)
  O campo Separador de Segmento (ISA18) na aba Separadores das configurações X12 EDI de um parceiro agora aceita um valor LF ou CR além de um único caractere. Os documentos X12 de saída para esse parceiro são então gerados usando uma quebra de linha (hex 0A) ou um retorno de carro (hex 0D) para separar segmentos.

• Limites de caracteres do ID do Parceiro por padrão EDI
  O ID do Parceiro de um parceiro comercial agora aceita os comprimentos de ID que suas especificações de parceiro exigem, com limites específicos para cada padrão EDI:

  • X12: Um qualificador fixo de dois caracteres mais um ID de 1–15 caracteres.
  • EDIFACT: Um qualificador de 1–4 caracteres mais um ID de 1–35 caracteres.
  • TRADACOMS: Exatamente 12 caracteres.

  Seu próprio ID EDI usa um formato para cada padrão: um qualificador opcional de até 4 caracteres mais um ID de 1–35 caracteres. Os campos Qualificador e Código do Qualificador agora também são texto livre, permitindo inserir qualquer código de qualificador válido.

Management Console

• Alerta de log em nuvem e destinatários de alerta externo
  A página Alertas inclui os seguintes aprimoramentos:

  • Status de log em nuvem alterado: Um novo evento Status de log em nuvem alterado notifica os destinatários designados quando o log em nuvem é ativado ou desativado para um grupo de agentes privados.
  • Destinatários externos: O campo Destinatários de um alerta agora aceita destinatários externos junto com usuários Harmony registrados. Destinatários externos são endereços de email não associados a uma conta de usuário Harmony, e recebem apenas o email de alerta, sem acesso à conta Harmony ou à plataforma.

• Histórico de edição e implantação na página Projetos
  A tabela Projetos da página Projetos do Management Console tem quatro novas colunas mostrando quem editou ou implantou um projeto por último e quando: Última Edição, Editado Por, Última Implantação e Implantado Por. Essas informações já estavam disponíveis na visualização de lista de Projetos do Studio. Essas colunas ficam ocultas por padrão; use a gaveta Filtrar Colunas para mostrar, ocultar ou reordenar.

• Suporte do Assistente de IA do Console para filas de mensagens
  O Assistente de IA do Console (Beta) agora pode listar, pesquisar, criar, duplicar, limpar e excluir filas de mensagens, e listar, pesquisar, criar e desativar tokens de autenticação, usando linguagem natural.

Studio

• Visualização de diff expandida no histórico de projetos e transferência seletiva
  A visualização de diff para rastrear alterações de componentes agora abrange mais tipos de componentes:

  • Histórico de projetos: Diffs em nível de campo agora estão disponíveis para ferramentas, notificações por email, operações, variáveis de projeto e endpoints e atividades de conectores, mostrados em uma tabela Nome, Antes e Depois com referências de variáveis vinculadas, campos de credenciais mascarados e detalhes expansíveis para valores longos ou complexos. A visualização de diff, acessada clicando no ícone Visualizar alterações, está disponível apenas para endpoints de conectores criados após a versão 12.10.
  • Transferência seletiva: Componentes de endpoint e atividade de conectores na categoria Sobrescrever agora mostram uma tabela comparando valores de campos de configuração entre os ambientes de origem e destino, com valores sensíveis mascarados.

• Posicionamento da operação na tela de design adicionado pela transferência seletiva
  Uma nova operação criada por uma transferência seletiva agora é adicionada diretamente à tela de design do projeto de destino, na mesma posição relativa às operações vizinhas que no projeto de origem. Qualquer cadeia de operações que a conecta a outras operações é preservada. Anteriormente, a operação aparecia apenas na aba Componentes do painel do projeto e precisava ser arrastada manualmente para a tela.

Conectores do Studio SDK

• Conector Azure OpenAI verificado com modelos GPT-5.6
  O conector Azure OpenAI está verificado para suportar a família de modelos GPT-5.6. Esses modelos ficam disponíveis para seleção após implantá-los no recurso Azure OpenAI.

• Suporte do conector HTTP v2 para valores de tipo de concessão OAuth personalizados
  A configuração OAuth 2.0 Client Credentials Grant de uma conexão HTTP v2 possui um novo menu Parâmetro de solicitação de tipo de concessão, disponível quando o tipo de concessão Client Credentials está selecionado. Selecione Personalizado para inserir seu próprio valor grant_type no novo campo Valor de tipo de concessão personalizado, em vez do valor padrão client_credentials, para serviços OAuth que exigem um valor não padrão.

• Suporte do conector MCP Client para a versão 2026-07-28 do protocolo MCP
  O menu Versão do Protocolo de uma conexão MCP Client tem uma nova opção 2026-07-28. Após alterar uma conexão existente para esta versão, regenere os esquemas de atividade para usar os esquemas de resposta atualizados.

• Suporte do conector OpenAI para modelos GPT-5.6
  As atividades Prompt (Descontinuado), Prompt V2, Registrar Ferramentas (Descontinuado), Registrar Ferramentas V2 e Registrar Ferramentas do Servidor MCP do OpenAI agora suportam a família de modelos GPT-5.6: gpt-5.6-sol, gpt-5.6-terra e gpt-5.6-luna. As configurações Temperatura e Probabilidade Máxima nas atividades Prompt e Prompt V2 não são suportadas com esses modelos.

Alterações

Agente

• Restrições de conexão JDBC para conexões de banco de dados
  Os agentes agora restringem as conexões JDBC usadas pelo conector Database no Studio e pelas fontes e destinos de Database no Design Studio por padrão, por motivos de segurança: conexões com localhost ou 127.0.0.1 são bloqueadas, e parâmetros específicos de string de conexão são bloqueados ou restritos para MySQL, PostgreSQL, Oracle e SQL Server. Para permitir um banco de dados no mesmo host que o agente ou um parâmetro bloqueado específico, atualize a chave correspondente na seção [JdbcSecurity] do arquivo de configuração do agente (jitterbit.conf) e reinicie o agente.

API gateway

• Validação do identificador de usuário para os logs da API
  Por motivos de segurança, o valor registrado para identificar quem fez uma solicitação de API não pode mais conter caracteres não permitidos. Uma solicitação falha com um erro INVALID_TRIGGER_USER se esse valor contiver um destes caracteres. Para resolver esse erro, verifique qual das opções a seguir se aplica:

  • Autenticação básica com a configuração padrão de Registro: Atualize o campo Nome de usuário do perfil de segurança para remover os caracteres não permitidos e, em seguida, atualize as credenciais em qualquer aplicação que realiza a chamada e faça referência ao nome de usuário anterior.
  • Configuração de Registro personalizada: Atualize a aplicação que realiza a chamada para enviar um valor de cabeçalho que não contenha os caracteres não permitidos.

EDI

• Company ID renomeado para EDI ID
  Seu próprio EDI ID agora é nomeado consistentemente na interface do usuário EDI, substituindo os rótulos Company ID e Company ISA ID:

  • Na aba Configurações EDI de um parceiro, o painel Company ID agora é EDI ID, e a seção Preferred IDs agora é Preferred ID (ISA ID's).
  • O diálogo que abre para seu primeiro parceiro em um ambiente agora é Gerando seu EDI ID, e seu campo Company ISA ID agora é EDI ID.

Conectores do Studio SDK

• Descontinuação das atividades OpenAI Prompt e Register Tools
  As atividades OpenAI Prompt e Register Tools agora estão marcadas como (Descontinuadas) no Studio e não são mais suportadas. Ambas foram substituídas na versão 12.8 pelas atividades redesenhadas Prompt V2 e Register Tools V2.

Correções

Agente

• Melhorias de estabilidade do Agente
  Esta versão resolve vários problemas que poderiam causar falhas no processo Apache do agente, inclusive sob carga de processamento pesada.

  • Scripts que chamam uma operação filha usando RunOperation enquanto as operações pai e filha acessam a mesma variável global não causam mais falhas no agente.
  • Transformações configuradas com chunking e múltiplas threads permanecem estáveis quando uma thread termina de executar antes de outra thread que iniciou ao mesmo tempo.
  • Operações com geração de dados de entrada e saída de componentes ativada não causam mais falhas no agente quando múltiplas operações desse tipo são executadas simultaneamente.

• jitterbit.operation.warning agora é preenchida quando uma fonte FTP não encontra arquivos
  Quando uma fonte FTP não encontra arquivos para processar, a variável jitterbit.operation.warning agora é preenchida com uma mensagem de aviso, inclusive quando verificada de uma operação pai que chamou a operação afetada como filha (por exemplo, usando RunOperation). Anteriormente, essa variável não era preenchida para este cenário.

• Correções de atualização do agente privado Windows
  Duas correções melhoram a atualização de um agente privado Windows da versão 11.x para 12.10 ou posterior:

  • Uma atualização de instalação avançada não falha mais com o Erro 1720 quando o serviço PostgreSQL existente usa uma conta diferente de jitterbitpostgres.
  • O serviço PostgreSQL da versão anterior agora é removido após uma atualização bem-sucedida, em vez de permanecer ativado e iniciar automaticamente na próxima reinicialização do sistema, o que poderia impedir que o novo serviço PostgreSQL e o agente iniciassem.

• O serviço de métricas agora usa a porta PgBouncer do agente após uma atualização
  A atualização de um agente privado agora atualiza a conexão que o serviço de métricas usa para relatar a métrica de status do PGBouncer para que corresponda à própria porta PgBouncer do agente. Anteriormente, a atualização podia deixar essa conexão na porta errada, fazendo com que a métrica PGBouncer relatasse incorretamente, mesmo que o PgBouncer em si continuasse funcionando normalmente.

• Correções de caracteres multibyte
  As seguintes correções resolvem problemas com saída não confiável e corrupção de dados.

  • Um caractere multibyte usado como delimitador de campo em um formato de arquivo de texto agora é analisado de forma confiável em uma transformação.
  • Um caractere multibyte que aparece mais adiante em uma resposta grande do conector JSON não é mais corrompido. Anteriormente, a detecção automática de codificação de caracteres amostrava apenas o início da resposta, portanto, se essa porção inicial contivesse apenas caracteres ASCII, a resposta era detectada incorretamente como Latin-1 (ISO-8859-1) em vez de UTF-8, corrompendo qualquer caractere multibyte que aparecesse além da porção amostrada.

API gateway

• Solicitações do API gateway para versões antigas do agente privado agora são processadas corretamente
  Solicitações de API processadas através do API gateway para versões antigas do agente privado não falham mais intermitentemente com um erro 502.

API Manager, Studio e Management Console

• Seletores de data de log agora limitados ao período de retenção de log
  Os seletores de data personalizados na visualização de logs de operação do Studio, na página Runtime do Management Console e nas páginas Analytics e API Logs do API Manager agora permitem selecionar datas apenas nos últimos 30 dias, correspondendo ao período de retenção de logs de operação, logs de API e métricas de API. Anteriormente, era possível selecionar datas nos últimos 90 dias, mas nenhum dado era retornado para datas fora do período de retenção.

Plataforma Harmony

• Operações enviadas se recuperam de forma confiável após uma interrupção do agente
  Uma operação enviada enquanto seu grupo de agentes estava temporariamente indisponível agora tenta novamente e retoma logo após a recuperação do grupo de agentes, em vez de permanecer no status Enviado até ser cancelada automaticamente. Se o grupo de agentes permanecer indisponível por tempo suficiente para que as tentativas se esgotem, a operação agora faz a transição de forma limpa para Erro. Cancelar uma operação que ainda está no status Enviado, sem nenhum agente atribuído, agora também entra em vigor imediatamente em vez de aguardar a mesma limpeza automática.

Studio

• Restaurar um projeto para sua versão atualmente implantada não marca mais operações como não implantadas
  Restaurar um projeto para a versão atualmente implantada agora mostra as operações do projeto como implantadas. Anteriormente, todas as operações exibiam o ícone Não implantado após a restauração, mesmo que o estado restaurado correspondesse ao que foi implantado. Esta correção se aplica apenas a projetos implantados após a versão 12.10; restaurar para uma versão implantada antes da versão 12.10 continua mostrando operações como não implantadas.

• Configurações de escrita e envio de operação em massa do Salesforce agora persistem após migração de projeto
  As opções de operação em massa do Salesforce (Gravar registros de sucesso em, Gravar registros de falha em, Enviar registros de sucesso para e Enviar registros de falha para) agora são preservadas quando o projeto é migrado para outro ambiente. Anteriormente, essas configurações podiam ser limpas durante a migração e precisavam ser reconfiguradas manualmente.

Studio e Management Console

• Nomes de projeto não podem mais ser salvos com espaços à esquerda ou à direita
  Um nome de projeto não pode mais ser salvo com espaço à esquerda ou à direita. Anteriormente, um nome de projeto salvo com espaço à direita não podia ser encontrado usando o termo de consulta project= na página Runtime do Management Console, mesmo quando o valor da consulta também incluía o espaço à direita. Projetos existentes com espaço à esquerda ou à direita no nome não são corrigidos automaticamente; para corrigir um, abra Editar configurações do projeto para esse projeto e clique em Salvar, o que remove os espaços do nome e restaura a capacidade de correspondê-lo com uma consulta project=.

Conectores do Studio SDK

• Filtros de data do modo Básico das atividades Query e List Channels agora suportam variáveis
  A aba Básico das seguintes atividades de conector agora constrói corretamente a Cadeia de Filtro quando o valor de filtro de um campo de data usa uma variável global, variável de projeto ou variável Jitterbit em vez de um valor codificado. Anteriormente, usar uma variável em um filtro da aba Básico de um campo de data causava um erro de data inválida no Studio antes da consulta chegar ao conector.

  • Epicor Prophet 21 Query
  • Microsoft Entra ID Query
  • Microsoft Teams List Channels
  • Microsoft SharePoint 365 Query
  • Microsoft Dynamics 365 Business Central v2 Query
  • OData Query
  • SAP SuccessFactors Query

• O esquema de resposta da atividade BigCommerce Query agora inclui date_last_imported
  Uma atividade BigCommerce Query configurada com o objeto Catalog > subobjeto Get All Products agora inclui o campo date_last_imported no esquema de resposta gerado. Anteriormente, este campo estava ausente do esquema, mesmo que o BigCommerce o retornasse na resposta, portanto a operação era concluída com status Success with info e um aviso informando extra subelement "date_last_imported" under the element "item".

• A atualização de esquema do conector SAP não falha mais com erro de ponteiro nulo
  Atualizar os esquemas de solicitação e resposta para uma função SAP no conector SAP do Studio ou no conector SAP do Design Studio não falha mais com NullPointerException (Failed to download the request and response schemas) em agentes 12.x. O problema não afetava agentes 11.x.

• Suporte à API Shopify 2026-07
  O menu API Version de uma conexão Shopify agora possui a versão 2026-07 da REST Admin API como opção de seleção. Se estiver atualizando uma conexão existente, consulte as etapas para alterar a versão da API.

• Snowflake Merge e Update agora tratam vírgulas, aspas e quebras de linha em valores de campo
  As atividades Snowflake Merge e Update usando a abordagem Direct Mapping ou Use Temporary Stage agora citam e escapam corretamente valores de campo contendo vírgula, aspas duplas ou quebra de linha. Anteriormente, esses caracteres poderiam corromper a linha CSV subjacente quando não escapados, desalinhando colunas e causando erros como falha na análise de data ou timestamp.

Avisos

Agente

• Descontinuação do versionamento do 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 aos lançamentos futuros:

  • 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, nenhum lançamento contínuo está planejado.
  • 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.

• Fim da vida útil da versão 11.48
  A partir de 28 de agosto de 2026, a versão 11.48 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.

Conectores do Studio SDK

• Ação necessária: Descontinuação das atividades OpenAI Prompt e Register Tools
  As atividades OpenAI Prompt e Register Tools agora estão descontinuadas e não são mais suportadas, e serão removidas permanentemente em uma versão futura. Ambas foram substituídas na versão 12.8 pelas atividades redesenhadas Prompt V2 e Register Tools V2, cujo uso da API Responses do OpenAI possibilita persistir o contexto do chat e chamar ferramentas registradas em grupos de agentes em nuvem, não apenas em agentes privados.

  Importante

  Se você está usando a atividade Prompt (Descontinuada) ou Register Tools (Descontinuada) em qualquer operação, você deve revisar o design da sua operação e substituí-la pela atividade Prompt V2 ou Register Tools V2 assim que possível, pois as atividades descontinuadas não são mais suportadas e serão removidas no futuro.

• 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 redesenhada, 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ê está usando a atividade Query Items descontinuada em qualquer operação, você deve revisar o design da sua operação e substituí-la pela atividade Query Items redesenhada assim que possível. A atividade descontinuada não é mais suportada e será removida em uma versão futura.