Processo Ativação do JasperViewer em Navegadores de Mercado

Neste artigo

• O que é e para que serve
• Antes de começar
• Forma 1 — Ativar para todos os relatórios
• Forma 2 — Ativar por relatório específico
• Pontos de atenção

O que é e para que serve

O Processo Ativação do JasperViewer em Navegadores de Mercado controla como o Sankhya Om exibe relatórios em PDF quando a impressão é feita pelo Chrome, Edge, Firefox ou outro navegador de mercado. Por padrão, o Sankhya Om abre o diálogo de impressão nativo do navegador, que pode descartar cores de fundo e imagens dependendo das opções escolhidas ali. Ao ativar o mecanismo, o Sankhya Om gera o relatório em formato .jrprint e abre o WebConnection para apresentá-lo diretamente no JasperViewer, preservando 100% da formatação original — cores, fontes e imagens — independentemente das configurações do navegador. Este processo não altera o conteúdo, os dados ou a geração do relatório: ele muda apenas a forma como o resultado é exibido a você, e vale para qualquer fluxo que utilize o serviço de visualização de relatórios do Sankhya Om. Esta funcionalidade depende de um aplicativo externo ao Sankhya Om — o WebConnection — e só está disponível para clientes que o têm instalado e devidamente configurado; sem ele, nenhuma das duas formas de ativação deste processo tem efeito.

Antes de começar

Este processo depende de um aplicativo externo ao Sankhya Om, o WebConnection: sem ele instalado e configurado, nenhuma das duas formas de ativação a seguir funciona. Antes de ativar qualquer uma delas, garanta que:

• O aplicativo WebConnection está instalado e em execução na máquina de onde você acessa o Sankhya Om
• O parâmetro global.porta.app.impressao está configurado com a porta correta em Configurações › Avançado › Preferências

↑ Voltar ao início

Forma 1 — Ativar para todos os relatórios (Preferências do Sistema)

Esta forma ativa o mecanismo globalmente para todos os relatórios acessados por navegadores de mercado, em qualquer fluxo que utilize o serviço de visualização de relatórios do Sankhya Om.

1. Acesse Configurações › Avançado › Preferências.
2. Pesquise pela chave MGEJASPERWEB.
3. Defina o valor como Sim para ativar o JasperViewer em todos os relatórios, ou mantenha Não para manter o diálogo de impressão nativo do navegador.

↑ Voltar ao início

Forma 2 — Ativar por relatório específico (property no JRXML)

Esta forma ativa o mecanismo apenas para um relatório específico, sem alterar o comportamento dos demais. Use quando somente determinados relatórios — como etiquetas — precisam de fidelidade total de impressão.

1. Acesse a tela de manutenção do relatório: Configurações › Avançado › Relatórios Formatados ou Modelos de Etiquetas.
2. Localize o registro pelo código. Se necessário, consulte a tabela TSIRFE.
3. Baixe o arquivo .jrxml associado ao registro.

4. Adicione a linha abaixo dentro do elemento <jasperReport>, junto às demais <property> existentes:

   <jasperReport ...>
       <property name="useJasperViewerWeb" value="true"/>
       <!-- demais properties e conteúdo do relatório -->

5. Salve o arquivo e reenvie-o pelo mesmo campo na tela de manutenção.

Depois de reenviar o arquivo, a primeira impressão desse relatório pode ficar mais lenta enquanto o Sankhya Om recompila e armazena o relatório em cache — as impressões seguintes seguem no ritmo normal.

↑ Voltar ao início

Pontos de atenção

Quando as duas formas de ativação estão configuradas ao mesmo tempo, o parâmetro global prevalece sobre a property do relatório. Use a tabela abaixo para identificar qual configuração está ativa em cada cenário.

O mecanismo se aplica apenas a navegadores de mercado (Chrome, Edge, Firefox etc.). Para o Navegador Sankhya (Electron), a ativação equivalente é feita pelo parâmetro UTZJASPERWC, de forma independente das duas formas descritas neste artigo.