12.4 Notas de versão do Harmony

12.4 Lançamento do Harmony

O lançamento 12.4 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.60 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 Sandbox e agentes privados também estão disponíveis.

É possível 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 do agente privado Docker, do gateway de API privado 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 Inteligência de Conta
  O Agente de Inteligência de Conta, acessado a partir da categoria Agente de IA no Marketplace , ajuda representantes de contas a gerenciar seus pipelines, entregando tarefas priorizadas do Salesforce e relatórios de oportunidades sob demanda, além de processar automaticamente notas de reuniões em tarefas, eventos e notificações de participantes do Salesforce. Para adicioná-lo à sua licença, entre em contato conosco.

• Agente de Notas de Reunião
  O Agente de Notas de Reunião, acessado a partir da categoria Agente de IA no Marketplace , extrai informações-chave e itens de ação de resumos de reuniões do Gemini, cria tarefas e eventos vinculados no Salesforce e envia resumos personalizados para cada participante. Para adicioná-lo à sua licença, entre em contato conosco.

Conectores do SDK do Studio

• Conector WebCrawler
  O conector WebCrawler pode ser usado com agentes em nuvem ou privados para rastrear websites.

Melhorias

Agente

• Atualização do PostgreSQL
  A versão do PostgreSQL incluída com o agente foi atualizada para melhorar a segurança e o desempenho.

• Atualização do driver JDBC do SQLite
  O driver JDBC do SQLite que está incluído com o agente e utilizado pelo conector de Banco de Dados do Studio, ou uma fonte de Banco de Dados do Design Studio ou destino, foi atualizado.

• Suporte a caracteres multibyte no URLEncode
  A função URLEncode no Studio e no Design Studio agora suporta caracteres alfabéticos multibyte, incluindo caracteres latinos estendidos usados em idiomas como português e alemão, bem como caracteres não latinos usados em idiomas como russo e chinês, como entrada.

Agente e Estúdio

• Suporte do conector ServiceMax e Salesforce Service Cloud para OAuth 2.0
  As conexões do ServiceMax e do Salesforce Service Cloud têm um novo menu de Tipo de Autenticação onde você pode selecionar Autenticação Básica (padrão existente) ou Credenciais de Cliente OAuth 2.0 (novo suporte). OAuth 2.0 requer a versão 11.59 para agentes 11.x ou 12.4 para agentes 12.x. Consulte os pré-requisitos do Salesforce OAuth 2.0.

Gerenciador de API

• Documentação OpenAPI para APIs individuais
  O painel de Detalhes da API na página de APIs agora inclui uma aba de Documentação para APIs personalizadas, proxy e OData publicadas, onde você pode visualizar, editar, regenerar e publicar a documentação OpenAPI para uma única API. Anteriormente, você só podia editar e publicar a documentação da API em massa para todas as APIs em um ambiente.

• Página de Logs de API redesenhada
  A página de Logs de API possui uma interface redesenhada, continuando o lançamento gradual anunciado em 11.59 / 12.3. Organizações que já atualizaram para a nova interface da página de Análises recebem essa atualização com a versão 12.4; aquelas que ainda não atualizaram recebem ambas as interfaces juntas quando o lançamento chegar até elas. Se você estiver interessado em acesso antecipado, entre em contato com o suporte do Jitterbit. Até lá, a interface anterior permanece disponível como a interface de Logs de API legados. A nova interface inclui:

• Logs de API unificados e de operações: Logs de operações para operações acionadas por API agora aparecem ao lado dos logs de API, proporcionando visibilidade de ponta a ponta no processamento de chamadas de API.

• Registro de acesso não autorizado: Tentativas de acesso 401 Unauthorized através de um gateway de API privado agora são relatadas com o código de status correspondente.

• Nova pesquisa: Suporte expandido para operadores (=, !=) e correspondência de padrões com caracteres curinga, com múltiplos critérios combináveis usando ponto e vírgula.

• Consultas salvas: Consultas podem ser salvas, reutilizadas, editadas e excluídas.

• Selector de período de tempo redesenhado: Escolha entre intervalos relativos predefinidos ou especifique um intervalo de datas absoluto usando as novas abas Relativo e Absoluto.

• Novas colunas: API Gateway e Tipo de Gateway mostram o nome do domínio e o tipo (Público ou Privado) do gateway que processou a solicitação. As colunas Agente, Ambiente e Projeto também estão agora disponíveis.

• Filtrar colunas: A visibilidade e a ordem das colunas podem ser personalizadas.

• Visualização da árvore de execução: Alternar para exibir entradas de log como uma hierarquia aninhada de operações pai e filho.

• Alternar para mostrar cargas úteis de solicitação e resposta: Um novo alternador na aba Configurações da configuração da API personalizada e da API OData determina se as cargas úteis de solicitação e resposta são exibidas.

• Painel de detalhes do log: Clique em qualquer entrada de log para visualizar informações da API, cabeçalhos de chamada e carga útil de solicitação/resposta (quando o novo alternador está ativado), bem como informações de rastreamento de depuração (quando o registro de depuração está ativado).

• Visualização de cartão atualizada substitui a visualização de bloco legada
  A visualização de bloco legada na página APIs foi substituída por uma visualização de cartão atualizada. Os cartões agora exibem todos os detalhes da API de forma clara, sem exigir uma interação de passar o mouse, e cada cartão inclui uma contagem de Serviços que não era exibida anteriormente na visualização de bloco.

API Manager e Console de Gerenciamento

• Badge de contagem de filtros no ícone de filtro
  O ícone de Filtro na página APIs no API Manager e nas páginas Projetos, Certificados de Cliente e Filas de Mensagens no Console de Gerenciamento agora exibe um badge numérico mostrando a contagem total de filtros ativos quando o painel de filtros está recolhido.

EDI

• Relatórios de análise aprimorados
  O relatório de volume de transações da página Analytics agora possui novas opções de visualização e agrupamento:

  • Um dropdown Visualizar por permite exibir contagens totais de transações ou agrupar dados por parceiro comercial, tipo de documento ou status, com gráficos de barras empilhadas e legendas codificadas por cores para cada agrupamento.

  • Os botões de tipo de gráfico e alternam entre visualizações de barras e linhas.

  • O agrupamento Status inclui um filtro Todos os status e mostra tendências de transações em status de transações definidos pelo sistema e pelo usuário.

• Filtro de Tipos de Mensagens na página de Mensagens
  O painel de Filtros da página Messaging agora inclui uma seção Tipos de Mensagens, permitindo filtrar mensagens por categorias de nível superior, como Comunicação e Transação.

Console de Gerenciamento

• Configuração de subdomínio de API de autoatendimento
  Administradores da organização agora podem configurar o subdomínio de API de uma organização diretamente na página Organizações. O subdomínio de API define a parte do subdomínio da URL base da API usada pelo gateway de API. Uma prévia de URL Base da API somente leitura mostra a URL resultante, e uma caixa de diálogo de confirmação alerta que integrações existentes usando a URL atual podem precisar ser atualizadas após a gravação.

• Rótulos do eixo Y do gráfico da página de Métricas do Agente
  A página Métricas do Agente agora exibe rótulos do eixo Y em todos os gráficos, indicando a unidade de medida para cada gráfico. Gráficos baseados em status exibem Status de Saúde no eixo Y, e gráficos de capacidade e atividade exibem a unidade relevante, como % de Uso do Pool de Threads, Número de Operações ou Número de Logs.

• Melhorias na página de Runtime
  A página Runtime possui as seguintes melhorias:

  • Paginação: As páginas agora contêm aproximadamente 100 operações. Para manter as cadeias de operações vinculadas intactas, todas as operações filhas do último pai em uma página estão incluídas nessa página, mesmo que o total exceda 100.

  • Consultas: Suporte expandido a operadores (=, !=) e correspondência de padrões com caracteres curinga, com múltiplos critérios combináveis usando ponto e vírgula. Para resultados precisos de !=, desative o toggle Visualização da árvore de execução.

Marketplace

• A visualização de cartão atualizada substitui a visualização de bloco legada
  A visualização de bloco legada em Marketplace foi substituída por uma visualização de cartão atualizada. Clicar em um cartão agora abre um painel de Detalhes que inclui uma descrição do ativo juntamente com outras informações do ativo.

Studio e Console de Gerenciamento

• Visibilidade de projeto baseada em função
  Projetos do Studio agora podem ser configurados para controlar quais funções de organização podem ver o projeto. Isso pode ser configurado a partir dos seguintes locais:

  • Console de Gerenciamento: Use a nova aba Funções de usuário na página Projetos do Console de Gerenciamento, acessível após selecionar um projeto.

  • Studio: Use a nova aba Funções de usuário na tela de configuração do projeto, acessível a partir das configurações do projeto ou da ação Funções de usuário na página Projetos do Studio.

  Quando um novo projeto é criado, ele fica visível por padrão para todos os membros das funções às quais o usuário criador pertence, e sempre para todos os membros da função Administrador. Para projetos que existiam antes deste lançamento, todas as funções com acesso ao ambiente estão habilitadas por padrão.

Studio

• Opção de operação para executar em um agente dedicado
  Uma nova opção Executar em agente dedicado na aba Opções das configurações da operação permite direcionar uma operação para ser executada em um agente específico dentro de um grupo de agentes privados cujo Classe de grupo de agentes está definida como Alta Disponibilidade. Esta opção é destinada a cenários de solução de problemas, como reproduzir uma falha em um agente específico ou contornar temporariamente um agente problemático enquanto mantém o restante do grupo operacional.

• Alternar autoseleção de dependências para importação de projeto
  O recurso de importação de projeto agora possui uma nova alternância de Autoseleção de dependências (ativada por padrão) que controla se as dependências necessárias são incluídas automaticamente ao selecionar componentes para importar. Desative-a para selecionar componentes individuais sem incluir automaticamente suas dependências.

• Suporte à versão 65 da API do Salesforce
  Os conectores Salesforce, ServiceMax e Salesforce Service Cloud agora utilizam automaticamente a versão 65 da API do Salesforce quando suas respectivas conexões estão configuradas com Credenciais de Cliente OAuth 2.0 (veja os pré-requisitos do Salesforce OAuth 2.0). Conexões configuradas com Autenticação Básica continuam a usar a versão 64 da API do Salesforce.

• Modo de concorrência da atividade Bulk do Salesforce
  As atividades de Bulk Insert, Bulk Update, Bulk Upsert, Bulk Delete e Bulk Hard Delete agora possuem uma nova configuração de Modo de Concorrência em Configurações Opcionais. Selecione Paralelo (padrão existente) ou Serial (novo suporte) para controlar como o Salesforce processa o trabalho de carga de dados em massa.

• Suporte a caracteres multibyte em senhas de conexão do Salesforce
  As conexões do Salesforce, Salesforce Service Cloud e ServiceMax agora suportam caracteres alfabéticos multibyte, incluindo caracteres latinos estendidos usados em idiomas como português e alemão, bem como caracteres não latinos usados em idiomas como russo e chinês, em senhas.

Conectores do SDK do Studio

• Atividade de Consulta Snowflake v2
  A nova atividade de Consulta Snowflake v2 suporta consultas em várias tabelas em diferentes esquemas usando múltiplos joins. O esquema de resposta é gerado automaticamente com base nos campos selecionados durante a configuração da atividade.

• Suporte à API v3 do conector Workday Prism Analytics
  Uma conexão Workday Prism Analytics agora possui um menu de Versão da API para selecionar a versão da API REST do Workday Prism Analytics v2 (padrão existente) ou v3 (novo suporte).

Alterações

Plataforma Harmony

• Ação necessária: Descontinuação das URLs de redirecionamento SSO legadas
  A Jitterbit está aposentando as URLs de redirecionamento legadas para single sign-on (SSO) Harmony com este lançamento 12.4. Desde nosso anúncio de junho de 2024 (11.28) de que as URLs SSO haviam mudado, novas e atualizadas configurações de SSO requerem as novas URLs. No entanto, sua organização pode ainda estar usando URLs legadas se você configurou o SSO antes de junho de 2024 e sua configuração ainda não foi atualizada.

  Os administradores da organização devem reconfigurar sua configuração de SSO existente para usar as novas URLs, ou os logins de usuários no Harmony começarão a falhar nas seguintes datas:

  	12.4
  APAC	28 de abril de 2026 (0h AEST)
  EMEA	28 de abril de 2026 (21h CEST)
  NA	29 de abril de 2026 (12h PDT)

  Como verificar se você precisa tomar alguma ação

  Faça login no portal Harmony, navegue até Console de Gerenciamento > Organizações e selecione sua organização. Na aba Gerenciamento de Usuários, sob o toggle Habilitar SSO, clique em Configurar SSO.

  Sua organização requer reconfiguração se algum desses campos contiver a string jitterbit-cloud-mgmt-console:

  • OAuth 2.0: Os campos Client ID ou Client Secret.

  • SAML 2.0: Os campos Identity Provider Metadata ou Service Provider Metadata.

  Ação necessária

  Se sua organização estiver usando URLs de redirecionamento legadas, um administrador da organização deve reconfigurá-las:

  1. Sob o toggle Habilitar SSO, mude a seleção para Nenhum para remover a configuração SSO existente usando as URLs de redirecionamento legadas.

  2. Recrie a configuração SSO usando as URLs de redirecionamento mais recentes seguindo a documentação. Isso deve ser feito tanto no Harmony quanto no seu provedor de identidade:

     1. Sob o toggle Habilitar SSO, selecione o tipo de autenticação: OAuth 2.0 ou SAML 2.0. Em seguida, clique em Configurar SSO.

     2. Atualize as URLs de redirecionamento / ACS no seu provedor de identidade.

  3. Teste a autenticação para confirmar o login bem-sucedido.

  Para assistência, entre em contato com o suporte Jitterbit.

Correções

Agente

• credentials.txt obsoleto não bloqueia mais reinicializações de contêiner Docker
  Quando deregisterAgentOnDrainstop=true, reiniciar o contêiner agora desregistra automaticamente o agente existente e registra um novo, sem exigir a exclusão manual de credentials.txt. Para mais detalhes, veja Comportamento do Agente na reinicialização.

• Instalação do agente Linux corrigida para usuários com permissão de Instalação de Agente
  Usuários com apenas a permissão de Instalação de Agente agora podem instalar com sucesso um agente Linux quando têm Acesso de gravação a pelo menos um ambiente. Anteriormente, esses usuários recebiam um erro de autenticação 401 durante a instalação do agente Linux, independentemente do acesso ao ambiente.

Agente e Design Studio

• Atualização da transformação NetSuite não falha mais
  Tentar atualizar uma transformação NetSuite não retorna mais um erro 500. Esse problema estava limitado à versão macOS do Design Studio.

Portal Harmony

• Expiração da sessão SSO não causa mais loop de redirecionamento
  Quando a sessão de um usuário do Harmony SSO expira, o portal Harmony agora completa totalmente o processo de logout, limpando os cookies de sessão, prevenindo um loop de redirecionamento infinito entre as páginas de login e de destino. Os usuários são redirecionados para a página de login e podem fazer login novamente com sucesso.

Console de Gerenciamento

• Erro do Cloud Datastore ao editar registros com campos personalizados em branco resolvido
  Modificar um registro na página do Cloud Datastore não retorna mais um erro Falha ao criar registro de armazenamento quando campos personalizados não obrigatórios são deixados em branco.

Studio

• Ramos de condição da ferramenta de decisão agora renderizam corretamente após a importação do projeto
  Fluxos de trabalho contendo a ferramenta de Decisão agora exibem corretamente as conexões dos ramos de condição na tela de design após a importação de um projeto. Anteriormente, as conexões estavam ausentes, mesmo que a ferramenta de decisão e as operações estivessem presentes.

• Mudanças no esquema não causam mais instabilidade no Studio
  Tentar salvar um esquema alterado com nós duplicados não pode mais fazer o Studio ficar sem resposta.

Conectores do SDK do Studio

• Correção de segurança do conector Microsoft Dynamics 365
  As atividades do conector Microsoft Dynamics 365 não expõem mais credenciais em mensagens de erro quando uma atividade falha.

Avisos

Agente

• Descontinuação 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 chegou ao 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 mais recentes 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.

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

  • Atualizações de plugins para agentes privados 12.x
    Melhorias 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, a ação do usuário é necessária conforme descrito nas instruções de atualização.

  • Verificação de conectores personalizados para agentes privados 12.x
    Os conectores do SDK de Conectores 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 Estúdio de Design

• Fim da vida útil para a versão 11.42
  A partir de 24 de abril de 2026, essas versões de produto atingiram o fim da vida útil e não são mais suportadas:

  • Agente privado versão 11.42
  • Estúdio de Design versão 11.42

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

Conectores do SDK do Estúdio

• Ação necessária: A aposentadoria da autenticação IDCRL do conector do Microsoft SharePoint Server
  A Microsoft está aposentando a autenticação IDCRL em 1º de maio de 2026. Após essa data, operações dependentes de conexões usando o esquema SOAP do SharePoint Online começarão a falhar. A migração requer a criação de uma nova conexão usando o esquema REST, a reatribuição de atividades existentes à nova conexão e a reimplantação de operações dependentes. Para os passos completos de migração, consulte a página de conexão do Microsoft SharePoint Server.

  Importante

  Se você estiver se conectando ao SharePoint Online usando o esquema SOAP, deve migrar para o esquema REST antes de 1º de maio de 2026 para evitar falhas nas operações.

• 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 (Beta) será removida permanentemente. Esta atividade foi substituída na versão 11.47 pela nova atividade de Itens de Consulta, cuja estrutura de resposta achatada faz com que os campos individuais que você define na página do Cloud Datastore (Beta) do Console de Gerenciamento sejam retornados 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, pois a atividade obsoleta não é mais suportada e será removida no futuro.