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.

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.

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
TextDecoderpassa a suportar as opçõesfataleignoreBOM, definidas na especificação Web API TextDecoder . A opçãofatalpermite verificar se uma sequência de bytes é válida na codificação informada, pois faz com que o métododecodegere um erro em vez de substituir as sequências inválidas pelo caractere U+FFFD. No runtime V8, o métododecodetambé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
toSqlStringpassa a converter um array numa lista dos seus valores separados por vírgula, que pode ser utilizada nos operadoresINeNOT IN, como emtoSqlString(['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 doQueryUtilities. - Foi criado o objeto global
performancecom o objetivo de medir intervalos de tempo com resolução inferior a um milissegundo. O métodoperformance.now()utiliza um relógio monotônico, que não é afetado por ajustes no relógio do sistema, sendo mais adequado queDate.now()para medir a duração de operações. A implementação é parcial em relação à especificação High Resolution Time , oferecendo apenasnow(),timeOriginetoJSON()nesta versão inicial. - Foi criado o método
File.detectTextEncodingpara detectar se um arquivo de texto está codificado em UTF-8 ou em windows-1252. - O método
TransactionLog.prototype.querypassa a permitir filtrar os logs transacionais pela sessão, pelo Engine e pelo endereço de origem, por meio das opçõessessionId,engineIdesourceAddress, e a retornar as colunasiSessionId,iEngineIdeiSourceAddr. - Foram criadas as propriedades
clientAddress,clientAddressVerified,forwardedFor,forwardedProtoeforwardedHostna classeRequest. 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çalhosX-Forwarded-ForeForwarded, que são normalizados em um único formato. - Foram criados os métodos
File.bytesFromFileeFile.fileFromBytes, que permitem ler e gravar o conteúdo de um arquivo comoUint8Array, e os métodosFile.prototype.readByteseFile.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.readTimeouteFile.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.frompassa a estar disponível no runtime Ije, permitindo converter em array objetos array-like, comoarguments, strings e instâncias deUint8Array. 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.lastIndexOfpassa a estar disponível no runtime Ije, conforme a especificação ECMAScript 5.1. Diferentemente doArray.prototype.indexOfdo Ije, ele utiliza a comparação estrita (===). - As funções
parseInteparseFloate os métodosNumber.parseInt,Number.parseFloateNumber.prototype.toPrecisionpassam a estar disponíveis no runtime JavaScript Ije, conforme a especificação ECMAScript. - Foram criados os métodos
deepStrictEqualedeepEqualno 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
PdfCryptocom 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 obsoletadisableSaveInputAsDefault, que continua disponível por compatibilidade. - A escrita das células pela classe
SimpleLayoutfoi 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
Uint8Arrayconsideravam todo oArrayBufferassociado, ignorando a posição e o tamanho doUint8Arrayquando ele representava apenas uma parte do buffer, como ocorre com os criados pelo métodosubarray. - 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.isIPv4Addresspoderia 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
namedos erros nativos, comoError,DetailedErroreTypeError, 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
createNeweopenExistingReadWriteda API File não funcionavam da maneira especificada. - A propriedade
DataSet.prototype.classesFilterpodia ser alterada em DataSets protegidos contra navegação pelo métodoprotect. Como essa atribuição remove a visão definida porsetView, a proteção podia ser contornada. A propriedade passa a respeitar a proteção, assim comofilter,setVieweresetView. - O método
File.prototype.flushapenas 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
HtmlToPdfpoderia não respeitar a propriedadetimeoutem 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
iContentda tabela iLog. - Os DataSets criados pelos métodos
DataSet.prototype.newSharedDataSeteDataSet.prototype.clonea 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.groupExpansionLeveldefinida, os totais do tipocountexibidos 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.staticModedefinida comotruepoderiam ser expandidos. Eles passam a não exibir o indicador de mudança de estado e permanecem totalmente expandidos. - As propriedades
SimpleLayout.prototype.baseFontSizeeSimpleLayout.prototype.printFontSizenã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
minemaxdas colunas doSimpleLayoutconsideravam 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
sumeavgdas colunas doSimpleLayoutconcatenavam os conteúdos escritos como texto, em vez de somá-los. Eles passam a ser convertidos para número sempre que possível. - O
SimpleLayoutpassa 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
masterScrolldas grades detalhes poderia ocorrer com um DataSet diferente do retornado pelo eventocreateDataSet. - 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 ToeEngine 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 retornarundefinedem vez de gerar o erro “Undefined property”, conforme a especificação ECMAScript. - No runtime Ije, o operador
instanceofpassa a seguir a especificação ECMAScript nos seguintes casos: uma função criada porbindconsidera as instâncias da função original, e uma função cuja propriedadeprototypenão seja um objeto gera umTypeErrorquando 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.authenticateUsere o métodoSecurity.prototype.findUserpassam a gerar um erro com o nomeThrottledErrorcom 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
SimpleLayoutdeixam 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 propriedadesresultSetedataExporterpassam a ser preenchidas apenas quando a nova propriedadeSimpleLayout.prototype.exportableestiver 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 propriedadesresultSetedataExporter, 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.