Versão 90

Novidades

Exportação de relatórios e grades para PDF

Os relatórios e as grades passam a poder ser exportados para PDF, gerando documentos prontos para serem compartilhados, arquivados ou impressos. Assim como nos demais formatos de exportação, o usuário escolhe quais agrupamentos e colunas deseja levar para o documento, e o sistema monta um novo relatório a partir dessa seleção.

Exportação para PDF

O relatório gerado busca ser fiel ao original e preserva o cabeçalho, os agrupamentos, os grupos de colunas, os totais e a formatação numérica das colunas. Como ele é recriado a partir da seleção do usuário, recursos visuais próprios do relatório exibido em tela, como cores, links, imagens e conteúdos formatados, não são reproduzidos, e os agrupamentos são sempre exibidos expandidos.

O documento é gerado no servidor em partes, com baixo consumo de memória e sem depender do navegador do usuário. Dessa forma, mesmo relatórios muito grandes, que não poderiam ser exibidos em tela, podem ser exportados. As páginas do PDF são preenchidas como se o relatório tivesse sido impresso de uma só vez. Entre as opções da exportação estão o ajuste automático do conteúdo à largura da página, a orientação automática, que utiliza o modo paisagem apenas quando as colunas não cabem no modo retrato, a proteção do documento por senha e a geração em escala de cinza.

Os relatórios que dependem de recursos visuais que não podem ser reproduzidos dessa forma devem desativar a exportação para PDF, mantendo disponíveis os demais formatos. Nos relatórios (.il), isso é feito pela propriedade canExportToPdf do processo e, nas consultas automatizadas (.idsv), pela propriedade canExportToPdf . Mais detalhes nos tópicos “Exportação de dados” do manual do usuário e “Exportação dos relatórios” do manual de exportação de dados.

Diálogo de comparação e merge de arquivos

Os processos “Desenvolvimento > Atualização > Atualização da VFS”, “Desenvolvimento > Atualização > Visualizador de diferenças da VFS” e “Desenvolvimento > Revisão de códigos > Revisor de códigos” passam a comparar e mesclar os arquivos em um diálogo exibido no próprio navegador, sem depender do WinMerge ou do Meld. Com isso, esses processos passam a funcionar mesmo quando o Engine não é executado no computador do usuário.

Diálogo de merge

O diálogo exibe os dois arquivos lado a lado, com realce de sintaxe, as diferenças destacadas e os trechos iguais ocultos. Um mapa ao lado do conteúdo mostra onde estão todas as diferenças. No merge, o destino pode ser editado livremente e receber os trechos da origem com um clique. Os atalhos de teclado são os do WinMerge e do VS Code, e o tamanho da fonte e o modo claro ou escuro podem ser alterados no próprio diálogo, sem afetar o restante do sistema. O WinMerge e o Meld continuam disponíveis pela opção “Aplicação externa” do novo campo “Ferramenta”, no grupo “Ferramenta de merge”. Mais detalhes no tópico “Ferramenta de merge” do manual da Atualização da VFS.

O diálogo também pode ser utilizado por outros processos, por meio da classe MergeDialog , cujos métodos compare e merge retornam um promise resolvido quando o usuário fecha o diálogo. Mais detalhes no manual “MergeDialog” .

Rastreabilidade das alterações por sessão, Engine e endereço de origem

Os registros do log transacional passam a identificar a sessão do usuário e o Engine que originaram cada alteração, por meio das colunas iSessionId e iEngineId da tabela iLog. A coluna iSourceAddr passa a indicar o endereço do cliente final da requisição, normalmente o navegador do usuário, considerando o endereço encaminhado pelos servidores proxy e balanceadores de carga. Quando o cliente é executado no mesmo computador do Engine, é registrado o endereço principal desse computador, e não o endereço de loopback 127.0.0.1, que não permitiria identificar a origem da alteração.

Essas informações são sempre do cliente que iniciou a requisição, e não necessariamente do Engine que efetivou a alteração. Nas execuções remotas de scripts por meio do método Database.prototype.runScript , por exemplo, são registrados a sessão e o Engine do cliente que solicitou a execução, e não a sessão temporária criada pelo Engine executor. O mesmo ocorre com as sessões temporárias criadas pela função executeScript e pela classe ScriptRunner .

O relatório “Administração do sistema > Auditoria > Logs de alterações de registros” passa a permitir filtrar, agrupar e exibir as alterações pela sessão, pelo Engine e pelo endereço de origem, e os relatórios de logins passam a exibir links para as alterações realizadas em cada sessão. Mais detalhes no tópico “Rastreabilidade por sessão, Engine e endereço de origem” do manual de auditoria.

Cadastro de proxies confiáveis

Foi criado o cadastro “Administração do sistema > Servidores > Proxies confiáveis”, onde devem ser registrados os endereços IP, ou as redes na notação CIDR, dos balanceadores de carga e proxies reversos da infraestrutura do sistema.

O endereço do cliente final das requisições HTTP, informado pelos elementos intermediários nos cabeçalhos X-Forwarded-For ou Forwarded, passa a ser considerado confiável somente quando a requisição é recebida de um proxy cadastrado. Os endereços que não puderem ser verificados continuam sendo registrados, por serem a melhor informação disponível, mas são gravados no log transacional com o sufixo ? e exibidos nos relatórios com o rótulo “(não confiável)”. Para identificar os proxies que devem ser registrados, o processo oferece a opção “Testar conexão”, que exibe os elementos intermediários da conexão do próprio usuário, indicando os que estão cadastrados e permitindo cadastrar os demais. O Engine também registra em seu log os computadores que enviam esses cabeçalhos sem estarem cadastrados.

É importante que os balanceadores de carga e proxies reversos sejam cadastrados logo após a atualização, permitindo que os endereços dos clientes sejam verificados corretamente.

Mais detalhes no manual “Proxies confiáveis” .

Nova interface do Manage

O Manage , interface web de configuração e monitoramento do Engine, foi reconstruído com um visual moderno e alinhado ao utilizado nas demais interfaces do sistema, tornando mais simples acompanhar e configurar o servidor.

As requisições e as sessões em atendimento passam a poder ser filtradas e ordenadas, facilitando a localização de um usuário ou de uma operação demorada. A visualização de logs foi aprimorada e passa a contar com controles de filtro e pesquisa, tornando mais fácil a localização de registros específicos. A conexão com as bases de dados configuradas também passa a poder ser testada diretamente na aba “Databases”.

As páginas de instruções de instalação, “Sobre”, de carregamento do cache local e de erros do Engine também foram modernizadas e passam a adotar o mesmo padrão visual.

Filtro por condições simples no DataSet

A propriedade DataSet.prototype.filter passa a aceitar filtros por condições simples, que comparam os campos com valores e podem ser combinadas por AND e OR, opcionalmente agrupadas por parênteses:

ds.filter = 'iStatus IN (1, 2) AND iDate >= "2026-01-01"';

Esses filtros são avaliados pelo próprio Engine, sem a execução de JavaScript, e são uma alternativa muito mais eficiente aos filtros js:, que até então eram a única forma de filtrar os registros pelos valores dos campos. São suportados os operadores ==, !=, >, >=, <, <=, IN e NOT IN, com as mesmas regras de comparação da ordenação e das pesquisas do DataSet.

Mais detalhes no tópico “Filtros e range” do manual “DataSet” .

Melhorias

Administração do sistema

  • O relatório “Administração do sistema > Segurança > Grupos, papéis e usuários > Registros de logins de usuários” passa a oferecer o tipo “Acessos incomuns”, que compara os logins do período com o histórico de cada usuário e destaca os sinais de acesso indevido, como um endereço, um dispositivo ou um Engine novos, um navegador desatualizado, um horário fora do habitual e endereços utilizados por vários usuários ou com muitas falhas de acesso. Mais detalhes no manual do relatório .
  • Foi criado o processo “Administração do sistema > Diagnósticos > Testes de desempenho”, que mede operações comuns do sistema, como as da CPU, do banco de dados, do disco e do IDO. Seu principal uso é comparar o comportamento do sistema entre versões e plataformas. Por ser executado no ambiente JavaScript, cuja coleta de memória ocorre em momentos não determinísticos, e por ser afetado pela carga do servidor e do banco de dados, os resultados variam entre execuções, e uma diferença pontual não indica necessariamente uma perda de desempenho. O processo é uma ferramenta de comparação e não substitui as ferramentas especializadas de análise de desempenho. Mais detalhes no manual “Testes de desempenho” .

Desenvolvimento

  • Os processos “Desenvolvimento > Atualização > Atualização da VFS”, “Desenvolvimento > Atualização > Visualizador de diferenças da VFS” e “Desenvolvimento > Revisão de códigos > Revisor de códigos” passam a suportar o Meld como ferramenta de merge, além do WinMerge. A ferramenta instalada é detectada automaticamente: no Windows, é dada preferência ao WinMerge e, no Linux, é utilizado o Meld.

Engine

  • Os registros de login passam a guardar o navegador, os endereços da conexão e o método de autenticação.
  • Na lista de requisições do Manage, a coluna “Client” passa a indicar o cliente final da requisição. Ao clicar no endereço do cliente, é exibido um diálogo com os detalhes da origem da requisição: os elementos intermediários, que antes eram exibidos na coluna “Forwarded By”, a sessão de origem e, nas requisições originadas por outros Engines, o Engine de origem.
  • Na lista de sessões do Manage, o detalhe da sessão passa a exibir o script em execução ou o último script executado, permitindo identificar o código que utiliza a sessão.
  • O log “supervisor.log” passa a registrar as requisições em execução há mais de 5 minutos, indicando o usuário, o endereço do cliente, a sessão e a operação em andamento. Enquanto houver requisições nessa situação, é registrado a cada minuto um resumo com a quantidade de requisições, a mais antiga e as operações mais frequentes.
  • O runtime JavaScript Ije passa a registrar no log o stack trace das execuções abortadas no Manage ou na finalização do Engine, permitindo identificar o código em execução.
  • A classe TextDecoder passa a suportar as opções fatal e ignoreBOM, definidas na especificação Web API TextDecoder . A opção fatal permite verificar se uma sequência de bytes é válida na codificação informada, pois faz com que o método decode gere um erro em vez de substituir as sequências inválidas pelo caractere U+FFFD. No runtime V8, o método decode também passa a retornar corretamente os caracteres que não podem ser representados em windows-1252, que antes eram perdidos na decodificação de textos em UTF-8.
  • A função toSqlString passa a converter um array numa lista dos seus valores separados por vírgula, que pode ser utilizada nos operadores IN e NOT IN, como em toSqlString(['a', 'b']), que resulta em 'a', 'b'. Essa forma é indicada apenas para listas pequenas, de tamanho conhecido, pois alguns bancos de dados limitam a quantidade de valores de uma lista. Para listas maiores ou de tamanho desconhecido, é recomendado o uso do QueryUtilities.
  • Foi criado o objeto global performance com o objetivo de medir intervalos de tempo com resolução inferior a um milissegundo. O método performance.now() utiliza um relógio monotônico, que não é afetado por ajustes no relógio do sistema, sendo mais adequado que Date.now() para medir a duração de operações. A implementação é parcial em relação à especificação High Resolution Time , oferecendo apenas now(), timeOrigin e toJSON() nesta versão inicial.
  • Foi criado o método File.detectTextEncoding para detectar se um arquivo de texto está codificado em UTF-8 ou em windows-1252.
  • O método TransactionLog.prototype.query passa a permitir filtrar os logs transacionais pela sessão, pelo Engine e pelo endereço de origem, por meio das opções sessionId, engineId e sourceAddress, e a retornar as colunas iSessionId, iEngineId e iSourceAddr.
  • Foram criadas as propriedades clientAddress, clientAddressVerified, forwardedFor, forwardedProto e forwardedHost na classe Request . Elas informam o endereço do cliente final da requisição, se ele foi informado por um proxy confiável, a cadeia de endereços de encaminhamento, o protocolo e o host solicitados ao primeiro proxy. Esses valores são obtidos dos cabeçalhos X-Forwarded-For e Forwarded, que são normalizados em um único formato.
  • Foram criados os métodos File.bytesFromFile e File.fileFromBytes , que permitem ler e gravar o conteúdo de um arquivo como Uint8Array, e os métodos File.prototype.readBytes e File.prototype.writeBytes , que fazem o mesmo a partir da posição atual de um arquivo aberto. Esses métodos evitam o uso de “binary strings” na manipulação de conteúdos binários.
  • Foram criadas as propriedades File.prototype.readTimeout e File.prototype.writeTimeout , que limitam o tempo de espera das leituras e das escritas. Elas são voltadas para arquivos que representam dispositivos de comunicação, como portas seriais (COM), inclusive as criadas por dispositivos USB, e pipes. Elas não se aplicam a arquivos comuns.
  • O método Array.from passa a estar disponível no runtime Ije, permitindo converter em array objetos array-like, como arguments, strings e instâncias de Uint8Array. Como o runtime Ije não suporta o protocolo de iteração, não é possível converter objetos que sejam apenas iteráveis.
  • O método Array.prototype.lastIndexOf passa a estar disponível no runtime Ije, conforme a especificação ECMAScript 5.1. Diferentemente do Array.prototype.indexOf do Ije, ele utiliza a comparação estrita (===).
  • As funções parseInt e parseFloat e os métodos Number.parseInt, Number.parseFloat e Number.prototype.toPrecision passam a estar disponíveis no runtime JavaScript Ije, conforme a especificação ECMAScript.
  • Foram criados os métodos deepStrictEqual e deepEqual no módulo @nginstack/engine/lib/testing/assert, compatíveis com os métodos de mesmo nome do Node.js. Eles comparam recursivamente os elementos dos arrays e as propriedades dos objetos.
  • Foi criada a classe PdfCrypto com o objetivo de criptografar e descriptografar documentos PDF.
  • Foi criado o método NetworkUtilities.isIPv6Address , que verifica se um valor é um endereço IPv6 válido, opcionalmente na notação CIDR.
  • Foi criado o método Controller.prototype.tooManyRequests , com o objetivo de criar respostas com o status 429 (Too Many Requests).
  • O sistema passa a suportar todos os tipos de conta do provedor de identidade Microsoft Entra, incluindo contas pessoais e multitenant. Mais detalhes no manual “Provedores de identidade” .
  • Foi criada a propriedade HtmlToPdf.prototype.scaleToFit , que reduz automaticamente o conteúdo mais largo que a área útil da página, de forma semelhante à opção “Ajustar à página” dos navegadores.

Web Framework

  • Foi criada a propriedade Process.prototype.saveInputsAsDefault , que indica se os valores informados pelo usuário nos campos do processo devem ser salvos para serem sugeridos nas próximas execuções. Ela substitui a propriedade obsoleta disableSaveInputAsDefault, que continua disponível por compatibilidade.
  • A escrita das células pela classe SimpleLayout foi otimizada, reduzindo o tempo de geração dos relatórios. Em casos sintéticos, a redução observada chegou a valores em torno de 60%, mas o ganho em cada relatório depende do volume de dados, da quantidade de colunas e dos recursos utilizados, sendo mais perceptível nos relatórios com um volume muito grande de registros.
  • Foram adicionados os ícones “file_pdf”, “database_check” e “database_check_outline” à biblioteca de ícones do sistema.
  • Foram adicionadas as variáveis CSS --wfd-color-code-*, com as cores do destaque de sintaxe de códigos-fonte nos modos claro e escuro. Elas são listadas no processo “Desenvolvimento > Web Framework > Estilos > Cores”.

Defeitos corrigidos

Administração do sistema

  • A replicação de dados poderia gerar na base de destino usuários com o mesmo nome ou e-mail de usuários já existentes nessa base. Quando houver conflito, o usuário replicado passa a ser renomeado com o sufixo “_” seguido da sua chave. Se o conflito for de e-mail, o e-mail do usuário replicado passa a ser removido.
  • No processo “Administração do sistema > Cache local > Tabelas e índices”, a importação das definições de índices criava os índices sem os seus filtros.
  • O relatório “Administração do sistema > Auditoria > Scripts executados por desenvolvedores” falhava com o erro “JSON parse error!” quando encontrava logs com conteúdo truncado, gravados por versões anteriores do Engine em bancos Oracle.

Desenvolvimento

  • O processo “Desenvolvimento > Profiler > Analisador de logs do Profiler” exibia incorretamente os caracteres acentuados dos logs gerados por Engines Linux.
  • No processo “Desenvolvimento > Atualização > Atualização da VFS”, os caracteres acentuados enviados durante o merge poderiam ser gravados com a codificação errada quando o arquivo original não possuía acentos.

Engine

  • As APIs nativas que recebem um Uint8Array consideravam todo o ArrayBuffer associado, ignorando a posição e o tamanho do Uint8Array quando ele representava apenas uma parte do buffer, como ocorre com os criados pelo método subarray.
  • No Windows, as estatísticas do cache local não eram salvas em um Engine recém-instalado, sendo registrado no log o aviso “Error saving DBCache statistics. Unable to create directory”.
  • O método NetworkUtilities.isIPv4Address poderia aceitar valores inválidos, como endereços com octetos vazios (10.0.0.), com espaços ( 10.0.0.1) ou com zeros à esquerda (010.0.0.1).
  • No runtime JavaScript Ije, a propriedade name dos erros nativos, como Error, DetailedError e TypeError, não podia ser alterada. Ela passa a aceitar outros valores, como previsto na especificação ECMAScript.
  • Quando a inicialização do cache local falhava, a página de carregamento continuava indicando que o sistema estava sendo iniciado. Passa a ser exibida uma página de erro, orientando que o Engine seja reiniciado após a correção do problema.
  • Os modos de abertura createNew e openExistingReadWrite da API File não funcionavam da maneira especificada.
  • A propriedade DataSet.prototype.classesFilter podia ser alterada em DataSets protegidos contra navegação pelo método protect . Como essa atribuição remove a visão definida por setView, a proteção podia ser contornada. A propriedade passa a respeitar a proteção, assim como filter, setView e resetView.
  • O método File.prototype.flush apenas entregava os dados ao sistema operacional, que podia mantê-los em seu cache, sem forçar a gravação física no disco, como previsto na documentação.
  • A classe HtmlToPdf poderia não respeitar a propriedade timeout em páginas HTML com grande quantidade de conteúdo.
  • Em bancos de dados Oracle, o conteúdo dos registros do log transacional com 64 KB ou mais poderia ser truncado sem erro ao ser gravado no campo iContent da tabela iLog.
  • Os DataSets criados pelos métodos DataSet.prototype.newSharedDataSet e DataSet.prototype.clone a partir de tabelas do cache local ignoravam a proteção contra inserção de registros em tabelas de movimentação que não são carregadas no cache local.
  • No Linux, o Engine poderia ser finalizado de forma abrupta ao receber o sinal SIGTERM, caso o runtime Java tivesse sido carregado.

Web Framework

  • Nos relatórios com a propriedade SimpleLayout.prototype.groupExpansionLevel definida, os totais do tipo count exibidos nos grupos eram formatados com casas decimais, como “2,00”. Eles passam a ser exibidos como números inteiros.
  • Os grupos em relatórios com a propriedade SimpleLayout.prototype.staticMode definida como true poderiam ser expandidos. Eles passam a não exibir o indicador de mudança de estado e permanecem totalmente expandidos.
  • As propriedades SimpleLayout.prototype.baseFontSize e SimpleLayout.prototype.printFontSize não eram aplicadas às colunas de data e de texto centralizado, à direita ou justificado, que ficavam com um tamanho diferente das demais. Além disso, a altura das linhas de texto não acompanhava o tamanho da fonte definido por essas propriedades.
  • Os totais do tipo min e max das colunas do SimpleLayout consideravam o valor zero no início de cada grupo. Com isso, o mínimo de valores positivos e o máximo de valores negativos eram exibidos como zero.
  • Os totais do tipo sum e avg das colunas do SimpleLayout concatenavam os conteúdos escritos como texto, em vez de somá-los. Eles passam a ser convertidos para número sempre que possível.
  • O SimpleLayout passa a gerar um erro mais claro na escrita de uma coluna adicionada após o primeiro registro. Antes, essa escrita poderia gerar inconsistências nos dados exportados.
  • A primeira execução do evento masterScroll das grades detalhes poderia ocorrer com um DataSet diferente do retornado pelo evento createDataSet.
  • O destaque dos agrupamentos dos relatórios não limitava corretamente a frequência das suas atualizações, o que poderia tornar o uso do sistema lento em relatórios muito grandes.

Extensão VS Code

  • Os comandos Engine DevTools: Update To e Engine DevTools: Update From, usados para atualizar um arquivo da Virtual File System em uma base a partir de outra com o auxílio do Source Control, não impediam a atualização se as chaves dos arquivos fossem diferentes.
  • Os arquivos da Virtual File System poderiam ser abertos com a configuração de indentação diferente da configurada no arquivo “.editorconfig” em razão de um conflito com a extensão “EditorConfig”.

Outras alterações

Engine

  • Os arquivos de log gerados pelo Engine passam a ser gravados com codificação UTF-8 em todas as plataformas.
  • No runtime Ije, ler uma propriedade inexistente de uma função, como MinhaClasse.NOT_FOUND, passa a retornar undefined em vez de gerar o erro “Undefined property”, conforme a especificação ECMAScript.
  • No runtime Ije, o operador instanceof passa a seguir a especificação ECMAScript nos seguintes casos: uma função criada por bind considera as instâncias da função original, e uma função cuja propriedade prototype não seja um objeto gera um TypeError quando o operando da esquerda for um objeto.
  • O caminho “/api/manage” passa a ser reservado para a interface do Manage. As rotas HTTP configuradas nesse caminho passam a ser ignoradas e os eventuais conflitos são registrados nos arquivos de log.
  • Nas requisições HTTP, o método Security.prototype.authenticateUser e o método Security.prototype.findUser passam a gerar um erro com o nome ThrottledError com o objetivo de sinalizar ao cliente que ele deve aguardar antes de uma nova tentativa.
  • O fluxo de redefinição de senha na tela de login deixa de apresentar o e-mail para o qual foi enviado o código de redefinição.
  • Após tentativas de acesso malsucedidas, a tela de login passa a exibir nos botões de login e de redefinição de senha uma contagem regressiva do tempo que o usuário deve aguardar antes de uma nova tentativa.
  • O Manage deixa de ser compatível com o Internet Explorer, sendo requerido o uso do Chrome, Edge ou Firefox em suas versões mais recentes.

Web Framework

  • Os parâmetros recebidos por um processo, como os enviados pelos links dos relatórios, deixam de ser salvos como os últimos valores informados pelo usuário nos campos do processo. Como os links não necessariamente informam todos os demais parâmetros, os valores salvos poderiam ficar inconsistentes e gerar erros nas validações dos campos quando o processo era reaberto pelo usuário.
  • A largura padrão de campos do tipo “integer” passa a ser 16, mesmo valor utilizado para campos do tipo “int64”, permitindo assim que valores maiores sejam exibidos corretamente.
  • Os relatórios gerados pela classe SimpleLayout deixam de manter, por padrão, uma cópia dos dados escritos para exportação, reduzindo o consumo de memória dos relatórios que não são exportados. As propriedades resultSet e dataExporter passam a ser preenchidas apenas quando a nova propriedade SimpleLayout.prototype.exportable estiver ativa. Ela continua sendo ativada automaticamente nos relatórios (.il) e nas consultas automatizadas (.idsv), que mantêm o botão “Exportar”. Processos que geram relatórios e precisam exportar os seus dados, ou que utilizam as propriedades resultSet e dataExporter, devem ativá-la antes de escrever o primeiro registro. Mais detalhes no tópico “Exportação dos relatórios” do manual de exportação de dados.