11.59 / 12.3 Notas de lançamento do Harmony

Lançamento do Harmony 11.59 / 12.3

O lançamento 11.59 / 12.3 Harmony é 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.59 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. 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 para esses componentes (exceto App Builder) é um ano após a data de lançamento.

Novos recursos

EDI

• Assistente de IA EDI
  O Assistente de IA EDI pode ser usado para gerenciar e configurar o Jitterbit EDI interagindo com um assistente de IA usando linguagem natural. Você pode acessá-lo usando o ícone Jitterbit AI no cabeçalho do portal Harmony em qualquer página do Jitterbit EDI. Para adicioná-lo à sua licença, entre em contato com seu Gerente de Sucesso do Cliente (CSM).

Conectores

• Conector Chroma
  O conector Chroma agora está disponível de forma geral. Pode ser usado com agentes na nuvem ou privados para pesquisar, fazer upsert ou excluir registros em uma coleção de banco de dados Chroma.

• Conector Wikipedia
  O conector Wikipedia agora está disponível de forma geral. Pode ser usado com agentes na nuvem ou privados para recuperar objetos da Wikipedia.

Aprimoramentos

Agente

• Desempenho e segurança aprimorados
  Os agentes privados versão 12.3 incluem aprimoramentos de desempenho e segurança. Esses aprimoramentos não estão incluídos na versão 11.59, que é o lançamento final planejado para agentes privados 11.x. Você pode atualizar diretamente de um agente privado 11.x para 12.3 (ou versões posteriores 12.x) usando nossas instruções de atualização (Windows, Linux ou Docker).

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

  • Atualizações de plug-in para agentes privados 12.x
    Os aprimoramentos de desempenho e segurança para agentes privados 12.x são incompatíveis com os plug-ins Multipart Pipeline e AWS S3 Create. Se você usar esses plug-ins, é necessária uma ação do usuário conforme descrito em Avisos abaixo.

  • Verificação de conectores personalizados para agentes privados 12.x
    Conectores criados por terceiros com o Connector SDK 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 usando esses conectores começarão a falhar no momento da atualização.

• Configurações do agente privado para mascarar cabeçalhos de solicitação personalizados em logs
  Uma nova seção [Masking] no arquivo de configuração do agente privado (jitterbit.conf) permite mascarar cabeçalhos de solicitação personalizados em atividades HTTP do Studio e fontes e destinos HTTP do Design Studio dentro de logs de tempo de execução. Aplica-se aos agentes privados 11.59 e 12.3.

• Suporte a proxy para uso de endpoints
  A página Uso de Endpoints do Console de Gerenciamento agora relata o uso de endpoints para agentes privados que se comunicam por meio de um servidor proxy. Aplica-se aos agentes privados 11.59 e 12.3.

• Tratamento de erros de sincronização de agentes melhorado
  Os agentes agora tratam erros durante operações de sincronização de forma mais confiável, evitando conflitos de banco de dados que poderiam resultar em deadlocks. Aplica-se aos agentes privados 11.59 e 12.3.

Agent, Studio e Design Studio

• Função GetJSONString melhorada com suporte a tratamento de erros
  A nova função GetJSONStringEx, acessível na categoria JSON da aba Funções da paleta de componentes de script do Studio, tem o mesmo comportamento da função GetJSONString com suporte adicional para retornar um valor personalizável quando um caminho não corresponde. Esta função requer versão do agent 11.59 / 12.3 ou posterior e também pode ser usada com Design Studio versão 11.59 ou posterior.

• Suporte do conector Salesforce para OAuth 2.0
  Os conectores Salesforce da Jitterbit agora suportam o uso de OAuth 2.0 de duas pernas:

  • Studio: Uma conexão Salesforce tem um novo menu Tipo de autenticação onde você seleciona Autenticação básica (padrão existente) ou Credenciais do cliente OAuth 2.0 (recém-suportado com versão do agent 11.59 / 12.3 ou posterior). Consulte Pré-requisitos do OAuth 2.0.
  • Design Studio: Uma Organização Salesforce tem uma nova caixa de seleção Selecionar credenciais do cliente OAuth 2.0 que requer Design Studio versão 11.59 ou posterior e versão do agent 11.59 / 12.3 ou posterior. Consulte Pré-requisitos do OAuth 2.0.

Agent e Design Studio

• Suporte à versão 65 da API Salesforce
  O conector Salesforce do Design Studio](/pt/design-studio/design-studio-reference/jitterbit-connect-wizards/salesforce-wizards/) agora suporta a versão 65 da API Salesforce com o uso de Design Studio versão 11.59 ou posterior e versão do agent 11.59 / 12.3 ou posterior. Quando esses requisitos de versão são atendidos, um diálogo de atualização de API é exibido ao abrir projetos existentes usando este conector. Novos projetos usam automaticamente a versão 65 da API Salesforce e devem ser configurados com autenticação OAuth 2.0.

  Autenticação básica não é mais suportada pelo Salesforce

  A partir da versão 65 da API Salesforce, o Salesforce não suporta mais login da API SOAP (autenticação básica). Para garantir a operabilidade contínua com Organizações Salesforce do Design Studio configuradas para usar autenticação básica, não aceite o prompt para atualizar seus projetos existentes do Design Studio para a versão 65 da API Salesforce. Antes de atualizar projetos para a versão 65 da API Salesforce, você deve reconfigurar seus endpoints Salesforce com a nova opção de configuração Selecionar credenciais do cliente OAuth 2.0 ou suas operações falharão.

API Manager, Console de Gerenciamento e Studio

• Interface de Analytics redesenhada e dados de solicitação de API em logs de operação
  Dois novos recursos estão sendo lançados gradualmente ao longo do próximo mês. Se você estiver interessado em acesso antecipado, entre em contato com o suporte Jitterbit.

  Interface de Analytics redesenhada

A página Analytics no API Manager possui uma interface redesenhada. A nova interface inclui:

• Novas visualizações de analytics: Detalhamento de erros por códigos de status (sucesso vs. erro), utilização de limite de taxa no nível da organização (chamadas médias por minuto), rastreamento de violações de política e insights no nível do método. Os gráficos existentes agora também incluem tempo de resposta mín/máx e dados de ambiente.
• Gerenciamento de gráficos: Os gráficos podem ser reordenados e expandidos. As legendas podem ser ativadas ou desativadas individualmente e sempre ficam totalmente visíveis independentemente do número de itens. Passe o mouse sobre os pontos de dados para visualizar métricas detalhadas.
• Filtros atualizados: Um novo filtro Métodos está disponível. Os filtros ativos exibem um crachá de contagem e podem ser limpos individualmente ou todos de uma vez com Limpar filtros.
• 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.
• Correção: Erros de timeout 504 são resolvidos em organizações com grandes números de APIs, particularmente quando filtros são aplicados.

Até que sua organização seja atualizada, a interface anterior permanece disponível como a interface Analytics legado.

Dados de solicitação de API em logs de operação

Quando uma operação é acionada por uma API personalizada do API Manager ou uma API OData, você pode ver qual API acionou a operação diretamente na visualização de log de operação do Studio e na página Runtime do Management Console. Os logs de operação para operações acionadas por API agora incluem:

• Informações de API: Nome da API, tipo, método de solicitação, ID de solicitação de API, IP de origem, gateway de API, URL do serviço de API e aplicativo de origem.
• Informações de chamada: Cabeçalhos de solicitação HTTP enviados com a chamada de API.
• Log de chamada: Informações de rastreamento detalhadas sobre o processamento de solicitação de API.

Quando o log de debug de operação e o log detalhado de API estão ambos ativados, cabeçalhos e corpo de solicitação e resposta também são incluídos. A quantidade de informações registradas varia de acordo com a configuração.

EDI

• Validação de ID EDI do parceiro comercial
  O Jitterbit EDI agora valida que IDs EDI seguem o formato correto para o padrão EDI do parceiro comercial (X12, EDIFACT ou TRADACOMS) e não estão já atribuídos a outro parceiro.

Management Console

• Política organizacional para encurtar tempo limite de sessão e consolidação de configurações de TFA
  A aba Gerenciamento de Usuários da página Organizações Políticas Organizacionais possui os seguintes aprimoramentos:

  • Um novo botão Aplicar tempo limite de sessão ociosa mais curto permite encurtar o tempo após o qual os usuários serão desconectados do portal Harmony, até um mínimo de 5 minutos. O tempo máximo (e o padrão existente quando o botão está desativado) é 4 horas.
  • Dois botões de política de autenticação de dois fatores (TFA) separados foram consolidados em um único botão pai com duas sub-opções: Com expiração de token (selecionado por padrão) e A cada login. A funcionalidade permanece a mesma.

Studio e Design Studio

• Variáveis Jitterbit para preservar espaços em branco em dados de origem XML e JSON
  Duas variáveis Jitterbit existentes, jitterbit.source.xml.trim e jitterbit.source.json.trim, agora estão expostas na aba Variáveis da paleta de componentes de script do Studio e no construtor de scripts da Guia de Elementos de Dados do Design Studio (11.59 ou posterior). Essas variáveis podem ser definidas como false para evitar a remoção de espaços em branco dos dados de origem XML ou JSON, respectivamente.

Studio

• Suporte a variáveis em campos de conector adicionais
  Os seguintes campos de atividade de conector agora exibem um ícone de variável e permitem usar variáveis globais, variáveis de projeto e variáveis Jitterbit. Além disso, os campos de conexão Chave Privada para os conectores Cloud Firestore, DocuSign, Gmail, Google BigQuery, Google Docs, Google Drive, Google Pub/Sub, Google Sheets e Workday agora também suportam variáveis.

  Conector	Atividade	Campo
  Amazon Bedrock	Prompt, Registrar Ferramentas	Prompt
  Amazon Lambda	Invocar Função	Contexto do Cliente
  Azure OpenAI	Prompt, Solicitar Imagem	Texto do prompt
  BMC Helix Business Workflows	Pesquisar Casos, Criar Caso, Atualizar Caso	Parâmetros de pesquisa (em formato JSON), Parâmetros de criação (em formato JSON) e Parâmetros de atualização (em formato JSON)
  BMC Helix Operations Management	Criar Evento, Pesquisar Eventos, Atualizar Evento	Entrada JSON
  Email	Enviar Email	Corpo do Email
  Gmail	Enviar Email	Mensagem
  Google BigQuery	Executar Consulta Personalizada	Consulta SQL
  Google Gemini	Prompt, Registrar Ferramentas	Prompt
  OData	Atualizar	Cabeçalhos da Solicitação
  OpenAI	Criar Imagem, Criar Transcrição, Criar Tradução, Prompt	Texto do prompt
  PGP	Criptografar	Chave pública do destinatário, Conteúdo do arquivo, Chave pública do remetente

• Alternância de seleção automática de dependências para transferência seletiva
  O recurso de transferência seletiva tem uma nova alternância Autoselect dependencies (ativada por padrão) que controla se as dependências necessárias são incluídas automaticamente ao selecionar componentes. Desative-a para selecionar componentes individualmente sem incluir suas dependências.

• Redesign da UX de Publicar como API
  A opção Publicar como API agora abre um painel API details com etapas baseadas em abas na parte inferior do designer de projetos em vez de um modal de configuração separado.

Conectores

• Suporte do conector HTTP v2 para serviços web REST do NetSuite via OAuth de 3 pernas
  Os serviços web REST SuiteTalk do NetSuite agora são suportados usando o tipo de autenticação OAuth 2.0 de uma conexão HTTP v2 com a opção Authorization Code Grant (OAuth de 3 pernas). Para instruções de configuração, consulte Conectar ao NetSuite com HTTP v2 para configurar o registro de integração do NetSuite e o registro de aplicativo do Management Console.

• Melhorias no EDI for Cloud v2 Get Documents e List Transactions
  O conector EDI for Cloud v2 tem as seguintes melhorias:

  • A atividade Get Document tem uma nova caixa de seleção Enable Max Documents para limitar o número de documentos recuperados por execução de operação. Quando ativada, especifica-se o limite no campo Max documents.
  • A estrutura de solicitação da atividade List Transactions tem um novo nó additionalFields onde é possível especificar uma lista de campos adicionais que se deseja incluir na resposta. Consulte a lista de campos adicionais suportados. Observe que as atividades existentes retornarão um aviso de subelemento extra (que pode ser ignorado) até que os esquemas sejam regenerados.

• Suporte do conector MCP Client para OAuth de 3 pernas
  Em uma conexão MCP Client, o menu Authentication mechanism tem uma nova opção Authorization Code Grant (OAuth de 3 pernas). Para instruções de configuração, consulte Pré-requisitos de 3LO do MCP Client para configurar um registro de aplicativo ou integração e o registro de aplicativo do Management Console.

• Suporte do conector OData para OData V2
  Uma conexão OData agora tem um menu OData Version para selecionar V4 (padrão existente) ou V2 (recém-suportado).

• Suporte da versão 45.1 da API do conector Workday
  Uma conexão Workday agora tem a versão v45.1 da API Workday Web Services (WWS) disponível para seleção em seu menu Version. Para novas conexões, v45.1 é selecionada por padrão.

Alterações

Gateway de API

• Alterações gerais
  O gateway de API tem alterações gerais para manutenção e desempenho.

Correções

Agente

• Correções do PostgreSQL do agente privado do Windows
  Duas correções foram feitas para melhorar a estabilidade do serviço PostgreSQL em agentes privados do Windows 11.59 e 12.3:

  • Ao fazer upgrade, inserir uma senha incorreta da conta de serviço PostgreSQL no prompt do instalador agora mostra um erro de validação e permite nova entrada. Anteriormente, isso poderia causar falha no upgrade sem reversão. Se você já encontrou esse problema, consulte as etapas de recuperação.
  • Instalações novas agora definem corretamente uma dependência no serviço PostgreSQL para serviços de agente, impedindo que os serviços de agente iniciem antes que o PostgreSQL esteja pronto.

API Manager

• As permissões de criação de API agora refletem o acesso da função mais alta
  As permissões agora são avaliadas em todas as funções atribuídas a um usuário, com o nível mais alto de acesso aplicado. Anteriormente, usuários atribuídos a múltiplas funções tinham suas permissões do API Manager restritas à função mais restritiva, impedindo a criação de API mesmo quando outra função atribuída concedia o acesso necessário.

Plataforma Harmony

• Agora é possível excluir agendamentos do Console de Gerenciamento
  Os agendamentos listados na guia Agendamentos da página Projetos do Console de Gerenciamento agora podem ser excluídos mesmo se o agendamento foi removido anteriormente do projeto no Studio ou Design Studio. Anteriormente, tentar excluir esses agendamentos retornava um erro de exceção desconhecida.

Studio

• Endpoints globais não falham mais após exclusão de projeto
  Excluir um projeto usando um endpoint global não causa mais falha em operações que usam o mesmo endpoint global em outros projetos até que sejam reimplementadas.

Conectores

• Codificação UTF-8 da atividade Enviar Mensagem do Microsoft Teams corrigida
  A atividade Enviar Mensagem do Microsoft Teams agora codifica corretamente o conteúdo da mensagem usando UTF-8 quando o conteúdo da mensagem é passado por variáveis globais.

Avisos

Agente

• Descontinuação do versionamento do agente privado 11.x
  Esta versão inclui 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: 11.59 é a versão final planejada do agente privado 11.x. A próxima versão após 11.59 será 12.4, e todos os aprimoramentos futuros, novos recursos e atualizações de segurança serão entregues por meio 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, começando com 12.3, 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 12.3 (ou versões posteriores 12.x) usando nossas instruções de atualização documentadas: Windows, Linux ou Docker.

Agente e Design Studio

• Fim da vida útil da versão 11.41
  A partir de 4 de abril de 2026, estas versões de produtos atingiram o fim da vida útil e não são mais suportadas:

  • Versão do agente privado 11.41
  • Versão do Design Studio 11.41

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

Plataforma Harmony

• Ação necessária: Descontinuação de URLs de redirecionamento SSO legadas
  A Jitterbit descontinuou URLs de redirecionamento legadas para logon único (SSO) do Harmony com o lançamento 12.4. Desde nosso anúncio de junho de 2024 (11.28) de que as URLs do 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 de alternância 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 de alternância Enable SSO, altere a seleção para None para remover a configuração de SSO existente usando 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 de alternância 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.

Plugins

• Ação necessária: Atualizações de plugin para agentes privados 12.x
  Melhorias de desempenho e segurança para agentes privados 12.x são incompatíveis com os seguintes plugins. Novas versões compatíveis desses plugins já estão disponíveis:

  Nome do plugin	Versões incompatíveis	Versão necessária
  Jitterbit Multipart Pipeline Plugin (descontinuado)	1.0.9.0 1.0.8.0	1.0.10.0
  Jitterbit AWS S3 Create (descontinuado)	1.0.1.0 1.0.0.0	1.0.2.0

  Impacto do agente privado

  Antes de atualizar para agentes privados 12.x, você deve concluir a ação do usuário necessária, ou as operações começarão a falhar no momento da atualização. As novas versões de plugin são compatíveis com versões anteriores com agentes 11.x, portanto você pode atualizar os plugins a qualquer momento.

  Ação necessária do usuário

  Você deve substituir qualquer uso existente das versões de plugin incompatíveis pelas novas versões necessárias:

  1. (Apenas agentes privados) Associe a nova versão do plugin ao grupo de agentes privados na página Customizations > Plugins do Management Console.
  2. Desatribua o plugin incompatível da atividade em seus projetos do Studio ou Design Studio.
  3. Atribua a nova versão compatível.
  4. Teste e implante a operação.

Conectores

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