12.9 Notas de lançamento do Harmony

Lançamento do Harmony 12.9

O lançamento do Harmony 12.9 é 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.65 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.

Você pode 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 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

Marketplace

• Tipo de ativo de aplicativo
  O Marketplace agora oferece aplicativos, um quarto tipo de ativo junto com receitas de integração, modelos de processo e agentes de IA, navegáveis selecionando o tipo App. Um aplicativo é uma aplicação de baixo código criada com o Jitterbit App Builder, distribuída como um pacote de lançamento .LP que você baixa do Marketplace e instala em sua própria instância do App Builder para configurar e estender.

• Aplicativos de Aprendizado
  Seis Aplicativos de Aprendizado estão disponíveis no lançamento, cada um um aplicativo que você pode instalar e explorar para aprender como um aplicativo do App Builder é construído:

  • AcuTrack: Rastreie ativos físicos com varredura de código QR móvel, check-in e check-out, agendamento de manutenção preventiva e painéis de localização.
  • Form Flow: Crie formulários orientados por modelo e colete respostas através de um assistente guiado, com visibilidade condicional de campos e fluxo de trabalho de revisão e aprovação.
  • Jira Tracker: Rastreie o trabalho do ciclo de vida do produto em Gerenciamento de Produto, UX, Engenharia e Documentação, com painéis de análise com abas.
  • Monitoring: Monitore trabalhos agendados, notifique grupos de usuários quando um trabalho falhar, rastreie resoluções e execute manutenção de banco de dados.
  • Northwinds: Um aplicativo de exemplo de atendimento de pedidos construído no banco de dados clássico Northwinds, útil como ponto de partida e para aprender App Builder.
  • Registration Portal: Forneça registro de autoatendimento, login e recuperação de senha, com autenticação de dois fatores e proteção de bloqueio de conta.

Console de Gerenciamento

• Assistente de IA do Console (Beta)
  O novo Assistente de IA do Console permite monitorar, solucionar problemas e gerenciar sua plataforma Harmony interagindo com o Console de Gerenciamento usando linguagem natural, em vez de navegar entre páginas para encontrar informações ou fazer uma alteração. Você pode acessá-lo usando o ícone Jitterbit AI no cabeçalho do portal Harmony em qualquer página do Console de Gerenciamento. Para adicioná-lo à sua licença, entre em contato com seu Gerenciador de Sucesso do Cliente (CSM).

Portal Harmony

• Padrões do Personal Studio que se aplicam em todas as organizações
  Agora você pode definir padrões pessoais no nível do usuário para configurações comuns do Studio em vez de configurá-los separadamente para cada projeto ou organização. Esses padrões são predefinidos para novos projetos que você cria. Configure-os na nova aba Studio da página Configurações de Conta do portal Harmony.

  Você pode definir padrões para o seguinte:

  • Visualização (Visualização em Cartão ou Visualização em Lista) na página Projetos.
  • Numeração automática de operações da tela de design.
  • Configurações de visualização de transformação e estados de painel.
  • Preferências de visualização de ícone na aba Componentes do painel de projeto.
  • Tamanho da aba do editor de script (2 a 8, padrão 2) e preferência de conclusão de linha gerada por IA. Ambas são novas configurações.
  • Se o diálogo de aviso de reconfiguração do iterador é suprimido. Diferentemente das configurações acima, essa nova alternância Sempre suprimir avisos de iterador de transformação entra em vigor imediatamente em todos os seus projetos existentes também, não apenas nos novos.

  A tela Editar configurações do projeto de um projeto também possui novos controles Usar minhas configurações pessoais e Ir para configurações de conta, para que você possa aplicar seus padrões a um projeto existente ou ir direto para suas configurações de conta do Studio.

Conectores

• Conector PDF Utilities (Beta)
  O conector PDF Utilities (Beta) pode ser usado com agentes em nuvem ou versão de agente privado 12.3 ou posterior para gerar documentos PDF. Ele não possui API externa ou chamadas de rede de saída. As atividades Converter Texto para PDF e Converter HTML para PDF do conector convertem conteúdo de texto simples ou HTML em um documento PDF. Para fornecer feedback sobre a beta, entre em contato com a Equipe de Produto Jitterbit.

• Conector ServiceNow v2 (Beta)
  O conector ServiceNow v2 (Beta) agora está disponível para todas as organizações. Pode ser usado com agentes na nuvem ou privados para consultar, criar, atualizar ou excluir registros no ServiceNow. Para fornecer feedback sobre a versão beta, entre em contato com o Jitterbit Product Team.

Melhorias

Agent e Design Studio

• Suporte multibyte em toda a plataforma
  A partir da versão 12.9 do agent e Design Studio 11.65, português, alemão e russo agora são certificados como idiomas suportados para a plataforma Harmony. Consulte Codificação de caracteres e suporte multibyte para obter detalhes, incluindo exceções conhecidas.

• Função criptográfica SHA512
  Uma nova função SHA512 está disponível para uso em scripts e transformações do Studio e Design Studio, complementando a função SHA256 existente. Ela aplica a função hash SHA-512 a uma string de entrada e retorna o hash como uma string de 128 dígitos hexadecimais. A entrada de string é primeiro convertida para sua representação de byte UTF-8, e a entrada que não é string é primeiro convertida para uma string. Esta função requer agent versão 12.9 ou posterior; no Design Studio, também requer versão 11.65 ou posterior.

Agent

• Pool de conexões de banco de dados interno ativado por padrão para agentes privados Linux
  Em agentes privados Linux, UseInternalPooling em jitterbit.conf agora usa true como padrão quando a chave está ausente, habilitando o pool de conexões de banco de dados interno para otimizar o desempenho do agent, correspondendo ao padrão já usado em agentes privados Windows desde 12.5. Anteriormente, uma chave ausente usava false como padrão no Linux.

Gateway de API

• Expiração de chave de API e email de lembrete para perfis de segurança
  Um perfil de segurança de chave de API agora pode ser configurado para expirar, após o qual as solicitações de API usando a chave são rejeitadas. Ative Expiração de chave de API e defina uma Duração de expiração (dias) (180 por padrão) para que a chave expire após esse número de dias desde sua geração ou regeneração usando o ícone de atualização. A coluna Expiração somente leitura mostra a data de expiração calculada, junto com um badge de status mostrando Expirando em breve quando a chave está a 7 dias de expirar. Um email de lembrete é enviado aos administradores da sua organização antes da chave expirar. O gateway de API na nuvem aplica a expiração de chave automaticamente; um gateway de API privado requer versão 12.9 ou posterior.

• Cabeçalhos de credencial e sessão mascarados em logs de API
  Cabeçalhos que carregam credenciais ou dados de sessão, como authorization, password e x_api_key, agora têm seus valores substituídos por [removed] sempre que cabeçalhos de solicitação de API aparecem em logs, incluindo a seção Informações de chamada da página API Logs do API Manager, a página Runtime do Management Console, logs de operação do Studio e os dados brutos de solicitação e resposta adicionados por Log detalhado ou Ativar modo de depuração até. Para a lista completa, consulte Cabeçalhos mascarados. O mascaramento é aplicado pelo gateway de API na nuvem e pelo gateway de API privado versão 12.9 ou posterior; em versões anteriores do gateway de API privado, esses valores de cabeçalho são exibidos na íntegra.

• Níveis de subdomínio máximo configuráveis para FQDNs personalizados do gateway de API privado
  O arquivo de configuração gatewayconfig.yaml do gateway de API privado suporta uma nova chave MaxDomainParts que permite aumentar o número máximo de níveis de subdomínio suportados em um nome de domínio totalmente qualificado (FQDN) personalizado, elevando o padrão de 5 para 10. Adicione esta chave a gatewayconfig.yaml se seu FQDN personalizado exigir mais de 10 níveis, por exemplo, definindo-a como 15. Para gateways baseados em Docker, adicione a chave primeiro e, em seguida, defina a variável de ambiente MAX_DOMAIN_PARTS equivalente para o mesmo valor.

API Manager

• Preservação de customizações e resolução de conflitos para o Portal Manager
  Clicar em Regenerate Docs na página Portal Manager não sobrescreve mais suas customizações do editor OpenAPI. Agora preserva e reaplica automaticamente onde possível, e solicita que você resolva conflitos antes de publicar. Isso não se aplica à regeneração da documentação de uma API individual na aba Documentation da página APIs, que ainda sobrescreve customizações.

• Ask AI na página Analytics
  A página Analytics tem um novo botão Ask AI que abre o APIM AI Assistant, onde você pode usar prompts em linguagem natural para consultar e interpretar métricas de desempenho da API, como tempo de resposta, códigos de status, erros e utilização de limite de taxa.

Connectors

• Suporte do conector Apache Kafka para autenticação SCRAM-SHA-512
  A configuração Auth Protocol de uma conexão Apache Kafka agora inclui uma opção SASL SSL (SCRAM-SHA-512), disponível quando PLAIN é selecionado como Auth Mechanism. Isso permite conectar a um broker Kafka que requer autenticação SCRAM-SHA-512, como um cluster Amazon MSK configurado para permitir apenas SHA-512.

• Opção de ID do Workspace na atividade Smartsheet Import Sheet
  A atividade Smartsheet Import Sheet tem uma nova configuração Choose option para especificar o workspace para importar a planilha, inserindo um Workspace ID diretamente ou selecionando de uma lista de workspaces disponíveis. Um workspace também pode ser fornecido na transformação de solicitação. Fornecê-lo importa a planilha para esse workspace usando o endpoint de importação mais recente do Smartsheet; omiti-lo preserva o comportamento existente, importando para a pasta Sheets inicial do Smartsheet através do endpoint anterior.

EDI

• Melhorias do EDI AI Assistant
  O EDI AI Assistant suporta as seguintes novas funcionalidades:

  • Busca de parceiros: Pesquise parceiros comerciais por descrição de campo personalizado.
  • Campos personalizados: Recupere, adicione, atualize e exclua campos personalizados de um parceiro.
  • Contagens de transações por hora: Calcule volume de transações por hora para uma data ou intervalo de datas de até 7 dias, opcionalmente filtrado por tipo de documento (tipo geral ou código específico) ou nome do parceiro.

• Notificações de expiração de certificado AS2
  As datas de expiração dos certificados usados por uma conexão AS2 agora são verificadas quando um documento é enviado ou recebido. Se um certificado está prestes a expirar nos próximos 30 dias, notificações de expiração de certificado aparecem: uma mensagem de erro é registrada uma vez por dia na página Messaging, e uma notificação em banner é exibida uma vez por dia nas páginas EDI.

Management Console

• Visibilidade do log de auditoria EDI no Management Console
  Mensagens de log da categoria Audit do Jitterbit EDI, cobrindo alterações de configuração, acesso a dados, tentativas de reprocessamento e reenvio, e atividade de login/logout do sistema, agora também estão visíveis na página Audit Logging do Management Console junto com atividades do Management Console, API Manager e Studio.

Correções

Agent

• Testar um script que usa uma função de banco de dados não falha mais com No suitable driver found
  Testar um script que chama uma função de banco de dados como DBLookup não falha mais com um erro No suitable driver found quando Login, Password ou Connection String do endpoint Database é definido a partir de variáveis de projeto ou globais atribuídas dentro do script testado. Isso se aplica ao teste de script tanto no Studio quanto no Design Studio.

• O serviço de métricas agora usa a porta PgBouncer correta em instalações novas de agentes privados do Windows
  Em uma instalação nova de um agente privado do Windows, o serviço de métricas agora usa a porta PgBouncer configurada. Anteriormente, usava 6432, a porta padrão do PgBouncer antes da versão 11.58, em vez de 6434, a porta padrão usada por instalações novas desde a versão 11.58, o que resultava em coleta de métricas incompleta. Agentes atualizados para esta versão mantêm sua porta PgBouncer existente.

• PgBouncer agora é instalado corretamente em instalações de agentes privados do Linux sem privilégios de root
  Anteriormente, instalar um agente privado como usuário sem privilégios de root no Linux não provisionava o PgBouncer, então o pool de conexões nunca era iniciado e seu status aparecia como não íntegro em Métricas do Agente. Novas instalações do Linux sem privilégios de root agora instalam e iniciam o PgBouncer corretamente. Atualizar um agente Linux existente sem privilégios de root não provisiona o PgBouncer retroativamente; o agente deve ser instalado novamente.

• Operações em massa do Salesforce não falham mais com erro de banco de dados interno
  Uma operação em massa do Studio Salesforce, Salesforce Service Cloud ou ServiceMax configurada com opções de operação em massa do Studio Salesforce (Gravar registros bem-sucedidos em, Gravar registros com falha em, Enviar registros bem-sucedidos para ou Enviar registros com falha para), ou uma operação do assistente Salesforce Bulk Process do Design Studio configurada com as opções de operação equivalentes, não falha mais no meio do processo com um erro de banco de dados interno. Anteriormente, registrar o status do arquivo de sucesso ou falha de uma atividade em massa podia gerar uma instrução SQL inválida, causando a falha da operação mesmo após alguns registros já terem sido processados com sucesso.

• O conector File Share agora suporta múltiplos caminhos separados por vírgula
  Múltiplos caminhos separados por vírgula no mesmo servidor agora são suportados no campo Caminho de uma conexão File Share do Studio e no campo Caminho(s) de uma origem File Share ou destino File Share do Design Studio. Uma origem lê e agrega os arquivos encontrados em cada caminho configurado, e um destino escreve em cada caminho configurado. Anteriormente, um valor separado por vírgula era tratado como um único caminho inválido e a conexão falhava.

• Atividades HTTP novamente incluem o corpo da resposta do destino nos logs de erro de operação
  Quando uma atividade POST ou PUT do conector HTTP legado falha no Studio, ou o Destino HTTP equivalente no Design Studio, o log de erro de operação novamente inclui o corpo da resposta retornado pelo endpoint do destino. Anteriormente, o corpo da resposta era removido do log de erro para solicitações com falha.

• O destino Salesforce Wave Analytics Dataset do Design Studio agora suporta autenticação OAuth 2.0 Client Credentials
  O destino Salesforce Wave Analytics Dataset de um projeto do Design Studio agora pode gerar e fazer upload de um dataset usando um endpoint Salesforce Org configurado com Selecionar OAuth 2.0 Client Credentials. Anteriormente, a operação falhava com um erro SF Analytics Dataset Upload Error: username is required, mesmo quando o teste de conexão OAuth 2.0 do endpoint era bem-sucedido, porque a geração e o upload do dataset ainda exigiam um nome de usuário, senha e token de segurança.

• DBLookup e DBExecute não falham mais com erro de decodificação Base64 em conexões de banco de dados JDBC
  Chamadas de DBLookup e DBExecute para um banco de dados PostgreSQL ou SQL Server usando um driver JDBC não falham mais com erro de decodificação Base64 quando o valor retornado se assemelha a dados codificados em Base64, como um JWT ou outro token de acesso.

• Unmap não retorna mais null quando precedido por RunScript na mesma expressão de mapeamento
  A função Unmap agora desmapeia corretamente um campo de destino quando uma chamada de RunScript a precede na mesma expressão de mapeamento. Anteriormente, neste caso, Unmap retornava um valor null em vez de desmapaear o campo.

• ConvertTimeZone agora preserva a precisão de milissegundos
  A função ConvertTimeZone agora preserva a precisão de milissegundos no valor retornado. Anteriormente, os milissegundos eram descartados independentemente do valor de entrada.

API Manager

• Valores de cabeçalho de solicitação de API proxy agora aceitam pontos e outras pontuações
  Na aba Request headers de uma API proxy, o Value de um cabeçalho agora aceita pontos e outras pontuações, e seu comprimento máximo é aumentado para 8192 caracteres. Anteriormente, um valor podia conter apenas letras, números, hífens e sublinhados, o que bloqueava valores como JSON Web Tokens (JWTs) que exigem pontos como parte de seu formato.

Conectores

• Correções do conector OpenAI e Azure OpenAI
  Os conectores OpenAI e Azure OpenAI têm as seguintes correções:

  • Atividades com uma configuração de Temperature ou Top Probability agora salvam um valor decimal inserido em qualquer campo. Anteriormente, um valor decimal como 0.2 ou 1.35 era arredondado para o inteiro mais próximo (0, 1 ou 2) quando a atividade era salva, sobrescrevendo o valor inserido.
  • As atividades Prompt do OpenAI e Azure OpenAI agora formatam corretamente múltiplas chamadas de ferramentas simultâneas, enviando a mensagem do assistente uma vez seguida por cada resposta de ferramenta em ordem. Anteriormente, a mensagem do assistente era repetida antes de cada resposta de ferramenta, com o conteúdo de cada resposta enviado como um array em vez de uma string simples.

• Atividade RabbitMQ Consume agora continua consumindo mensagens quando Auto Acknowledge está ativado
  A atividade RabbitMQ Consume continua consumindo mensagens da fila após a primeira mensagem quando Auto Acknowledge está ativado. Anteriormente, o listener parava de consumir mensagens adicionais após processar com sucesso a primeira, e apenas uma reimplantação completa da operação restaurava temporariamente o consumo.

• Correções da atividade Merge do Snowflake e endpoint global
  O conector Snowflake inclui as seguintes correções:

  • Caracteres especiais da atividade Merge: A atividade Merge do Snowflake agora coloca entre aspas os identificadores de coluna em seu SQL gerado quando Use quote for Snowflake identifiers está ativado na conexão, correspondendo à atividade Insert. Anteriormente, um nome de coluna de destino com um caractere especial como um hífen podia causar um erro de compilação SQL mesmo com essa configuração ativada.
  • Alterações de configuração de endpoint global: Editar um endpoint global existente agora salva corretamente as alterações nos campos Account, Database name, Host name, Schema name e User name. Anteriormente, essas edições eram descartadas, exigindo que você removesse e re-adicionasse o endpoint para aplicar uma alteração.

EDI

• Os detalhes da transação agora abrem de forma confiável para documentos EDI muito grandes
  Abrir a aba Informações do documento para um documento EDI muito grande na página Transações agora exibe This EDI file is too large to view in HTML. Please use one of the RAW views to see its content. no lugar do documento renderizado, para que a aba carregue sem tentar renderizar todo o conteúdo EDIXML como HTML. Você ainda pode acessar o conteúdo completo do documento através de um link Raw no painel Visualizações.

Studio e Management Console

• Operações com status Enviado ou Recebido agora podem ser canceladas
  A ação Cancelar operação agora está habilitada para operações com status Enviado ou Recebido na página Runtime do Management Console, na tabela de log de operações do Studio e ao lado do status de runtime de uma operação na tela de design. Anteriormente, a ação estava desabilitada para esses dois status, então uma operação que estava na fila mas ainda não havia sido processada por um agente exigia suporte da Jitterbit para ser removida.

Studio

• Mapeamentos de transformação importados com nós duplicados não causam mais falha nas operações
  Importar um arquivo de mapeamento de transformação que duplica um nó de destino agora aplica a duplicação à definição de esquema usada quando a operação é executada. Anteriormente, a duplicação era aplicada apenas ao esquema de destino mostrado no designer de transformação, então o mapeamento parecia correto no tempo de design enquanto a operação falhava no runtime com Failed to expand the target tree for the path: <path to node>. The node: <node name> cannot be created. Para corrigir uma transformação cujo mapeamento foi importado antes dessa correção, use Remover todos os mapeamentos abaixo deste nó no nó raiz e importe o arquivo de mapeamento novamente.

• Implantar um projeto não deleta mais arquivos WSDL que ainda estão em uso
  Implantar um projeto não deleta mais arquivos WSDL que ainda estão em uso. Anteriormente, um projeto podia ser implantado com sucesso e depois falhar em uma implantação posterior com um erro similar a No WSDL with locator, na maioria das vezes após o projeto ser migrado para outro ambiente. Isso afetava qualquer componente para o qual um arquivo WSDL existente foi enviado: conexões SOAP e atividades SOAP Request e SOAP Response de API. Para recuperar um projeto que já está afetado, consulte Erro de implantação SOAP: "No WSDL with locator".

• As respostas de atividade do Workday agora mapeiam corretamente quando o esquema de resposta é usado diretamente ou espelhado
  Uma transformação que usa o esquema de resposta de uma atividade Workday diretamente, ou uma cópia espelhada dele, não falha mais com Failed to find structure node name matching the data element: <node name>. Anteriormente, um nó na resposta do Workday não era correspondido ao nó correspondente no esquema, então a transformação falhava mesmo que a mesma resposta mapeasse com sucesso para um esquema de destino simples. Se uma transformação existente continuar falhando, reconfigure a atividade para regenerar seu esquema e depois atualize o esquema na transformação.

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 por meio 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 aproveitar os ú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.

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

  • Atualizações de plugins 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 uma ação do usuário conforme descrito nas instruções de atualização.

  • Verificação de conectores personalizados para agents privados 12.x
    Conectores criados 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, caso contrário, as operações que usam esses conectores começarão a falhar no momento da atualização.

Agent, API gateway e Design Studio

• Fim da vida útil da versão 11.47
  A partir de 7 de agosto de 2026, essas versões de produto atingiram o fim da vida útil e não são mais suportadas:

  • Versão de agent privado 11.47
  • Versão de API gateway privada 11.47
  • Versão do Design Studio 11.47

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

Conectores

• Ação necessária: Remoção futura da atividade Cloud Datastore Query Items descontinuada
  Em um lançamento futuro, a atividade Query Items descontinuada no conector Cloud Datastore será removida permanentemente. Esta atividade foi substituída no lançamento 11.47 pela atividade Query Items reformulada, 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ê estiver 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 reformulada assim que possível. A atividade descontinuada não é mais suportada e será removida em um lançamento futuro.