12.4 Notas de lançamento do Harmony

Lançamento do Harmony 12.4

O lançamento do Harmony 12.4 é 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.60 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 Docker agente privado, gateway de API privado e App Builder estão disponíveis no Jitterbit's Docker Hub. A data de fim de vida útil para esses componentes (exceto App Builder) é um ano após a data de lançamento.

Novos recursos

Conectores

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

Melhorias

Agente

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

• Atualização do driver JDBC SQLite
  O driver JDBC SQLite que é incluído no agente e usado pelo conector Studio Database, ou uma fonte Database do Design Studio ou destino, foi atualizado.

• Suporte a caracteres multibyte no URLEncode
  A função URLEncode no Studio e Design Studio agora suporta caracteres alfabéticos multibyte como entrada, 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.

Agent e Studio

• Suporte a OAuth 2.0 para conectores ServiceMax e Salesforce Service Cloud
  As conexões ServiceMax e Salesforce Service Cloud possuem um novo menu Tipo de autenticação onde você seleciona Basic Auth (padrão existente) ou OAuth 2.0 Client Credentials (suporte novo). OAuth 2.0 requer versão do agent 11.59 para agents 11.x ou 12.4 para agents 12.x. Consulte os pré-requisitos do OAuth 2.0 do Salesforce.

API Manager

• Documentação OpenAPI para APIs individuais
  A gaveta Detalhes da API na página APIs agora inclui uma aba Documentação para APIs personalizadas, proxy e OData publicadas, onde você pode visualizar, editar, regenerar e publicar documentação OpenAPI para uma única API. Anteriormente, era possível apenas editar e publicar documentação de API em massa para todas as APIs em um ambiente.

• Página de API Logs redesenhada
  A página API Logs possui uma interface redesenhada, continuando o lançamento gradual anunciado em 11.59 / 12.3. Organizações já atualizadas para a nova interface da página Analytics recebem essa atualização com a versão 12.4; aquelas ainda não atualizadas recebem ambas as interfaces juntas quando o lançamento as alcançar. Se você está interessado em acesso antecipado, entre em contato com o suporte Jitterbit. Até então, a interface anterior permanece disponível como a interface API Logs legada. A nova interface inclui:

  • Logs de API e operação unificados: Logs de operação para operações acionadas por API agora aparecem junto com logs de API, fornecendo 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 reportadas com o código de status correspondente.

  • Nova busca: Suporte expandido de 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.

  • Seletor 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 de domínio e o tipo (Público ou Privado) do gateway que processou a solicitação. As colunas Agent, Ambiente e Projeto também estão disponíveis.

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

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

  • Alternar para mostrar payloads de solicitação e resposta: Um novo botão na aba Configurações da configuração de API personalizada e API OData determina se os payloads de solicitação e resposta são exibidos.

  • Gaveta de detalhes do log: Clique em qualquer entrada de log para visualizar informações da API, cabeçalhos de chamada e payload de solicitação/resposta (quando o novo botão 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 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 imediatamente, sem exigir interação ao passar o mouse, e cada cartão inclui uma contagem de Serviços não mostrada anteriormente na visualização de bloco.

API Manager e Management Console

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

Conectores

• Atividade Snowflake Query v2
  A nova atividade Snowflake Query v2 oferece suporte a consultas em múltiplas tabelas em diferentes esquemas usando múltiplas junções. 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 Versão da API para selecionar a versão da API REST Workday Prism Analytics v2 (padrão existente) ou v3 (recém-suportada).

EDI

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

  • Um menu suspenso 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ção definidos pelo sistema e pelo usuário.

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

Management Console

• Configuração de subdomínio de API por autoatendimento
  Os 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 porção do subdomínio da URL base da API usada pelo gateway de API. Uma Visualização da URL base da API somente leitura mostra a URL resultante, e um diálogo de confirmação avisa que as integrações existentes usando a URL atual podem precisar ser atualizadas após salvar.

• Rótulos do eixo Y do gráfico da página 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. Os gráficos baseados em status exibem Status de Integridade no eixo Y, e os gráficos de capacidade e atividade exibem a unidade relevante, como % de Uso do Pool de Threads, Nº de Operações ou Nº de Logs.

• Aprimoramentos da página Runtime
  A página Runtime possui os seguintes aprimoramentos:

  • 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 são incluídas nessa página, mesmo que o total ultrapasse 100.

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

Marketplace

• Visualização de cartão atualizada substitui visualização de bloco legada
  A visualização de bloco legada no 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 junto com outras informações do ativo.

Studio e Management Console

• Visibilidade de projeto baseada em função
  Projetos do Studio agora podem ser configurados para controlar quais funções organizacionais conseguem visualizar o projeto. Isso pode ser configurado nos seguintes locais:

  • Management Console: Use a nova aba Funções de usuário na página Projetos do Management Console, 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, 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 desta versão, todas as funções com acesso ao ambiente sã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 de operação permite direcionar uma operação para ser executada em um agente específico dentro de um grupo de agentes privados cuja Classe de grupo de agentes está definida como Alta disponibilidade. Essa 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 mantendo o resto do grupo operacional.

• Alternância de seleção automática de dependências para importação de projeto
  O recurso de importação de projeto tem uma nova alternância Selecionar dependências automaticamente (habilitada por padrão) que controla se as dependências necessárias são incluídas automaticamente ao selecionar componentes para importar. Desabilite-a para selecionar componentes individuais sem incluir automaticamente suas dependências.

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

• Modo de concorrência da atividade Salesforce Bulk
  As atividades Salesforce Inserção em massa, Atualização em massa, Upsert em massa, Exclusão em massa e Exclusão permanente em massa têm uma nova configuração Modo de concorrência em Configurações opcionais. Selecione Paralelo (padrão existente) ou Serial (recém-suportado) para controlar como o Salesforce processa o trabalho de carregamento de dados em massa.

• Suporte a senha multibyte na conexão Salesforce
  As conexões 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.

Alterações

Plataforma Harmony

• Ação necessária: Descontinuação de URLs de redirecionamento SSO legadas
  A Jitterbit está descontinuando URLs de redirecionamento legadas para logon único (SSO) do Harmony com esta versão 12.4. Desde nosso anúncio de junho de 2024 (11.28) de que as URLs de SSO foram alteradas, configurações de SSO novas e atualizadas exigem as novas URLs. No entanto, sua organização pode ainda estar usando URLs legadas se você configurou 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 (12h AEST)
  EMEA	28 de abril de 2026 (21h CEST)
  NA	29 de abril de 2026 (12h PDT)

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

  Faça login no portal Harmony, navegue até Management Console > Organizations e selecione sua organização. Na aba User Management sob o botão Enable SSO, clique em Configure 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 está usando URLs de redirecionamento legadas, um administrador da organização deve reconfigurá-las:

  1. Sob o botão Enable SSO, altere a seleção para None para remover a configuração de SSO existente que usa as URLs de redirecionamento legadas.

  2. Recrie a configuração de 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 botão Enable SSO, selecione o tipo de autenticação: OAuth 2.0 ou SAML 2.0. Em seguida, clique em Configure 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 obter assistência, entre em contato com o suporte Jitterbit.

Correções

Agent

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

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

Agent e Design Studio

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

Conectores

• 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.

Portal Harmony

• Expiração de sessão SSO não causa mais loop de redirecionamento
  Quando a sessão de um usuário Harmony SSO expira, o portal Harmony agora conclui totalmente o processo de logout limpando cookies de sessão, evitando um loop de redirecionamento infinito entre as páginas de login e inicial. 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 Cloud Datastore não retorna mais um erro Failed to create storage register quando campos personalizados não obrigatórios são deixados em branco.

Studio

• Ramificações de condição da ferramenta Decision agora são renderizadas corretamente após importação de projeto
  Fluxos de trabalho contendo a ferramenta Decision agora exibem conexões de ramificação de condição corretamente na tela de design após um projeto ser importado. Anteriormente, as conexões estavam ausentes mesmo com a ferramenta de decisão e operações presentes.

• Alterações de schema não causam mais instabilidade do Studio
  Tentar salvar um schema alterado com nós duplicados não pode mais fazer o Studio ficar sem resposta.

Avisos

Agent

• Descontinuação do versionamento de agent privado 11.x
  O lançamento 11.59 / 12.3 incluiu a versão final de agent privado 11.x (11.59) e a primeira versão disponível de agent privado 12.x (12.3). Observe o seguinte em relação aos lançamentos futuros:

  • Versão final 11.x: A versão de agent 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 agents privados 12.x. Embora agents 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 agents privados 12.x assim que possível para se beneficiar dos últimos aprimoramentos de desempenho, segurança e recursos.

  • Caminho de atualização: É possível 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 agents privados 12.x

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

  • Verificação de conectores personalizados para agents privados 12.x
    Conectores construídos por terceiros com o Connector SDK devem passar por alterações de desenvolvimento para serem compatíveis com agents privados 12.x. Antes de atualizar para agents privados 12.x, verifique a compatibilidade com o desenvolvedor do conector, ou operações usando esses conectores começarão a falhar no momento da atualização.

Agent e Design Studio

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

  • Versão de agent privado 11.42
  • Versão do Design Studio 11.42

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

Conectores

• Ação necessária: Desativação da autenticação IDCRL do conector Microsoft SharePoint Server
  A Microsoft está desativando a autenticação IDCRL em 1º de maio de 2026. Após essa data, as operações que dependem de conexões usando o schema SOAP do SharePoint Online começarão a falhar. A migração requer criar uma nova conexão usando o schema REST, reatribuir as atividades existentes à nova conexão e reimplantar as operações dependentes. Para ver as etapas completas de migração, consulte a página Conexão Microsoft SharePoint Server.

  Importante

  Se você está se conectando ao SharePoint Online usando o schema SOAP, é necessário migrar para o schema REST antes de 1º de maio de 2026 para evitar falhas nas operações.

• 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 faz com que os campos individuais definidos na página Cloud Datastore do Console de Gerenciamento sejam retornados diretamente no nível superior da resposta.

  Importante

  Se você está usando a atividade Query Items descontinuada em qualquer operação, é necessário revisar o design da operação e substituí-la pela atividade Query Items reformulada assim que possível, pois a atividade descontinuada não é mais suportada e será removida no futuro.