11.59 / 12.3 Notas de versão do Harmony

11.59 / 12.3 Notas de versão do Harmony

A versão 11.59 / 12.3 do Harmony é lançada de forma escalonada 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çamento por categoria de componente, consulte o cronograma de lançamentos.

App Builder 4.59 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. A imagem 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 para esses componentes (exceto o App Builder) é um ano após a data de lançamento.

Novas funcionalidades

Agentes de IA

• Agente de Contato CRM
  O Agente de Contato CRM, acessado a partir do Marketplace categoria Agente de IA, utiliza IA para gerenciar registros de contato para sistemas CRM como Salesforce através de uma interface conversacional, ajudando equipes de vendas a encontrar, criar e atualizar contatos de forma mais eficiente. Para adicioná-lo à sua licença, entre em contato conosco.

• Agente de Inteligência Competitiva
  O Agente de Inteligência Competitiva, acessado a partir do Marketplace categoria Agente de IA, automatiza a coleta de inteligência de mercado usando pesquisa na web impulsionada por IA para identificar, resumir e entregar notícias relevantes da indústria e atualizações de concorrentes para sua equipe. Para adicioná-lo à sua licença, entre em contato conosco.

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 IA 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 SDK do Studio

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

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

Melhorias

Agente

• Desempenho e segurança aprimorados
  A versão 12.3 agentes privados inclui melhorias de desempenho e segurança. Essas melhorias não estão incluídas na versão 11.59, que é o último lançamento planejado para agentes privados 11.x. Você pode atualizar diretamente de um agente privado 11.x para 12.3 (ou versões 12.x posteriores) usando nossas instruções de atualização (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, é necessária ação do usuário conforme descrito em Notificações abaixo.

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

• Configurações de agente privado para mascarar cabeçalhos de solicitação personalizados nos logs
  Uma nova seção [Masking] no arquivo de configuração do agente privado (jitterbit.conf) permite que você masque cabeçalhos de solicitação personalizados em atividades HTTP do Studio e fontes HTTP do Design Studio e alvos dentro dos logs de execução. Aplica-se tanto a agentes privados 11.59 quanto 12.3.

• Suporte a proxy de 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 via um servidor proxy. Aplica-se tanto a agentes privados 11.59 quanto 12.3.

• Melhoria no tratamento de erros de sincronização de agentes
  Os agentes agora lidam com erros durante operações de sincronização de forma mais confiável, prevenindo conflitos de banco de dados que poderiam resultar em deadlocks. Aplica-se tanto a agentes privados 11.59 quanto 12.3.

Agente, Studio e Design Studio

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

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

• Studio: Uma conexão Salesforce possui um novo menu de Tipo de Autenticação onde você seleciona Autenticação Básica (padrão existente) ou Credenciais de Cliente OAuth 2.0 (novamente suportado com a versão do agente 11.59 / 12.3 ou posterior). Veja pré-requisitos do OAuth 2.0.

• Design Studio: Um Org Salesforce possui uma nova caixa de seleção Selecionar Credenciais de Cliente OAuth 2.0 que requer tanto a versão do Design Studio 11.59 ou posterior quanto a versão do agente 11.59 / 12.3 ou posterior. Veja pré-requisitos do OAuth 2.0.

Agente e Design Studio

• Suporte à versão 65 da API Salesforce
  O conector Salesforce do Design Studio agora suporta a versão 65 da API do Salesforce com o uso tanto da versão 11.59 ou posterior do Design Studio quanto da versão do agente 11.59 / 12.3 ou posterior. 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. Novos projetos utilizam automaticamente a versão 65 da API do 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 do Salesforce, o Salesforce não suporta mais o login via SOAP API (autenticação básica). Para garantir a continuidade do funcionamento dos Salesforce Orgs do Design Studio configurados 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 do Salesforce. Antes de atualizar projetos para a versão 65 da API do Salesforce, você deve reconfigurar seus endpoints do Salesforce com a nova opção de configuração Selecionar Credenciais de Cliente OAuth 2.0 ou suas operações falharão.

API Manager, Console de Gerenciamento e Studio

• Interface de Análise redesenhada e dados de solicitações de API nos logs de operação
  Duas novas funcionalidades estão sendo lançadas gradualmente ao longo do próximo mês. Se você estiver interessado em acesso antecipado, entre em contato com o suporte da Jitterbit.

  Interface de Análise redesenhada

  A página de Análise no API Manager possui uma interface redesenhada. A nova interface inclui:

  • Novas visualizações de análise: Detalhamento de erros por códigos de status (sucesso vs. erro), utilização do limite de taxa em nível organizacional (chamadas médias por minuto), rastreamento de violações de políticas e insights em nível de método. Gráficos existentes agora também incluem tempo de resposta mínimo/máximo e dados do ambiente.
  • Gerenciamento de gráficos: Os gráficos podem ser reorganizados e expandidos. As legendas podem ser habilitadas ou desabilitadas individualmente e estão sempre 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. Filtros ativos mostram um distintivo de contagem e podem ser limpos individualmente ou todos de uma vez com Limpar filtros.
  • Selecionador 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 foram 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 de Análise legada.

  Importante

  Quando a nova interface for habilitada para sua organização, o período de retenção para dados de análise e logs de API muda de 90 dias para 30 dias.

  Dados de solicitações de API nos logs de operação

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

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

  Quando o registro de depuração de operações e o registro detalhado da API estão ambos habilitados, os cabeçalhos e o corpo da solicitação e da resposta também são incluídos. A quantidade de informações registradas varia por configuração.

EDI

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

Console de Gerenciamento

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

  • Um novo botão de alternância Aplicar tempo limite de sessão ociosa mais curto permite que você encurte 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 de alternância está desativado) é 4 horas.
  • Dois botões de alternância de política de autenticação de dois fatores (TFA) separados foram consolidados em um único botão de pai com duas subopções: Com expiração de token (selecionado por padrão) e A cada login. A funcionalidade permanece a mesma.

Estúdio e Estúdio de Design

• 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 do componente de script do Estúdio e na aba Elementos de Dados do construtor de scripts do Estúdio de Design (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 adicionais do conector
  Os seguintes campos de atividade do conector agora exibem um ícone de variável e suportam o uso de 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 também agora 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 autoseleção de dependências para transferência seletiva
  O recurso de transferência seletiva agora possui uma 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. Desative-a para selecionar componentes individualmente sem incluir suas dependências.

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

Conectores do SDK do Studio

• Suporte ao conector HTTP v2 para serviços web REST do NetSuite via OAuth de 3 etapas
  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 etapas). 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 do aplicativo do Console de Gerenciamento.

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

  • A atividade Get Document agora tem uma nova caixa de seleção Habilitar Máximo de Documentos para limitar o número de documentos recuperados por execução da operação. Quando ativada, você especifica o limite no campo Máximo de documentos.
  • A estrutura de solicitação da atividade List Transactions agora possui um novo nó additionalFields, onde você pode especificar uma lista de campos adicionais que deseja incluir na resposta. Consulte a lista de campos adicionais suportados. Observe que atividades existentes retornarão um aviso de subelemento extra (que pode ser ignorado) até que os esquemas sejam regenerados.

• Suporte ao conector MCP Client para OAuth de 3 etapas
  Em uma conexão MCP Client, o menu Mecanismo de Autenticação agora possui uma nova opção Authorization Code Grant (OAuth de 3 etapas). Para instruções de configuração, consulte os pré-requisitos do MCP Client 3LO para configurar um aplicativo ou registro de integração e o registro do aplicativo no Console de Gerenciamento.

• Suporte ao conector OData para OData V2
  Uma conexão OData agora possui um menu Versão do OData para selecionar V4 (padrão existente) ou V2 (novo suporte).

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

Mudanças

Gateway da API

• Mudanças gerais
  O gateway da API passou por mudanças gerais para manutenção e desempenho.

Correções

Agente

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

  • Ao atualizar, inserir uma senha de conta de serviço PostgreSQL incorreta no prompt do instalador agora mostra um erro de validação e permite a reentrada. Anteriormente, isso poderia causar a falha da atualização sem reverter. Se você já encontrou esse problema, consulte os passos de recuperação.
  • Instalações novas agora definem corretamente uma dependência no serviço PostgreSQL para os serviços do agente, impedindo que os serviços do agente sejam iniciados antes que o PostgreSQL esteja pronto.

Gerenciador da API

• As permissões de criação de API agora refletem o acesso do maior papel
  As permissões agora são avaliadas em todos os papéis atribuídos a um usuário, com o nível mais alto de acesso aplicado. Anteriormente, usuários atribuídos a múltiplos papéis tinham suas permissões do Gerenciador da API restritas ao papel mais restritivo, impedindo a criação de APIs mesmo quando outro papel atribuído concedia o acesso necessário.

Plataforma

• Agendas agora podem ser excluídas do Console de Gerenciamento
  Agendas listadas na aba Agendas da página Projetos do Console de Gerenciamento podem agora ser excluídas mesmo que a agenda tenha sido removida anteriormente do projeto no Studio ou Design Studio. Anteriormente, tentar excluir tais agendas resultava em um erro de exceção desconhecida.

Studio

• Endpoints globais não falham mais após a exclusão do projeto
  Excluir um projeto usando um endpoint global não causa mais falhas em operações que utilizam o mesmo endpoint global em outros projetos até que sejam reimplantados.

Conectores do SDK do Studio

• 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

• Aposentadoria da versão privada do agente 11.x
  Este lançamento 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 última versão planejada do agente privado 11.x. A próxima versão após 11.59 será 12.4, e todas as melhorias futuras, 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, começando com 12.3, 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 12.3 (ou versões posteriores 12.x) usando nossas instruções de atualização documentadas: Windows, Linux ou Docker.

Agente e Estúdio de Design

• Fim da vida útil da versão 11.41
  A partir de 4 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.41
  • Estúdio de Design versão 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: Desativação iminente de URLs de redirecionamento SSO legados
  A Jitterbit está aposentando URLs de redirecionamento legados para single sign-on (SSO) Harmony na próxima versão 12.4. Desde nosso anúncio de junho de 2024 (11.28) de que os URLs SSO haviam mudado, novas e atualizadas configurações de SSO requerem os novos URLs. No entanto, sua organização pode ainda estar usando URLs legados se você configurou o SSO antes de junho de 2024 e sua configuração ainda não foi atualizada.

  Administradores da organização devem reconfigurar sua configuração de SSO existente para usar os novos 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 uma 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 a sua organização estiver usando URLs de redirecionamento legadas, um administrador da organização deve reconfigurá-las:

  1. Sob o toggle Habilitar SSO, altere 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 últimas URLs de redirecionamento 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.

Plugins

• Ação necessária: 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 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
  Plugin Jitterbit Multipart Pipeline (obsoleto)	1.0.9.0 1.0.8.0	1.0.10.0
  Jitterbit AWS S3 Create (obsoleto)	1.0.1.0 1.0.0.0	1.0.2.0

  Impacto no agente privado

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

  Ação necessária do usuário

  Você deve substituir quaisquer usos existentes das versões de plugins incompatíveis pelas novas versões necessárias:

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

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 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 Console de Gerenciamento Cloud Datastore (Beta) sejam retornados 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 nova atividade de Itens de Consulta o mais rápido possível, pois a atividade obsoleta não é mais suportada e será removida no futuro.