IMPORTANTE: Não há suporte para arquivos personalizados, nem ao editor de relatórios. Suporte para personalização pode ser contratado à parte. Cabe ao desenvolvedor fazer por sua conta e risco as personalizações desejadas. Antes de pedir suporte remova qualquer personalização e veja se o erro persiste.

Alterando um JASPER

A API tem dentro do JAR os Jasper dos relatórios, para edições simples (alteração de fonte, alinhamento, etc.) podem ser feitos editando individualmente os arquivos *.jrxml  contidos no JAR na pasta “\br\com\l2software\api\sefaz\impressao” com o Jasper ou outro editor compatível, e os salvando (somente os modificados) numa pasta específica.

DICA: Para abrir o JAR utilize o WinRAR, WinZip ou similar.

Os arquivos modificados podem ser selecionados por parâmetro (a cada impressão) ou por padrão trocando-os numa pasta.

É feito cache do arquivo personalizado. Sendo necessário reiniciar o servidor de aplicação (Tomcat) para atualizar.

Por parâmetro

Ao gerar o relatório através da função “SEFAZ – Gerar DANFE(XML, Logo, cIdToken ,csc, Extras)” informe dentro do mapa com os parâmetros extras (o último da função) o caminho dos arquivos personalizados:

• JASPER_RELATORIO_PRINCIPAL – (Todos) Informar o caminho absoluto do relatório personalizado. EX: C:\L2MAKER-SEFAZ\danfe.jrxml.
• JASPER_SUBRELATORIO_FATURAS – (NF-e)
• JASPER_SUBRELATORIO_FORMA_PAGAMENTO – (NFC-e)
• JASPER_SUBRELATORIO_VOLUMES – (CT-e)
• JASPER_SUBRELATORIO_COMPONENTES – (CT-e)

Observação: O método acima funciona para versões 1.8.6 (26/01/2017) ou mais recentes.

Substituindo os arquivos

Nas versões anteriores, se quiser substituir por padrão os arquivos modificado, basta os colocar dentro da pasta “l2s-sefaz” na pasta Maker.Commons. Por exemplo:

• NFC-e: Maker.Commons\WEB-INF\lib\l2s-sefaz\danfe_nfce.jrxml
• NF-e Retrato: Maker.Commons\WEB-INF\lib\l2s-sefaz\danfe_nfe_retrato.jrxml

No caso do Agente utilize a pasta api\sefaz como equivalente do Maker.Commons, ficando assim:

• NFC-e: …\Agente do Navegador\apis\sefaz\l2s-sefaz\danfe_nfce.jrxml
• DANF-e Retrato: …\Agente do Navegador\apis\sefaz\l2s-sefaz\danfe_nfe_retrato.jrxml

Editando os relatórios

Ao criar uma personalização há certas restrições que devem ser respeitadas. Em especial:

1. Não modifique nome de parâmetros;
2. Não altere o tipo de dados dos parâmetros;
3. A tag raiz não deve ser fixada no path;
4. A versão do JASPER gerado deve ser compatível com a biblioteca do Webrun.

Dicas

• É importante verificar a compatibilidade dos arquivos gerados com a versão do Jasper instalada no Webrun. No iReport 5.6 essa opção pode ser encontrada aqui:
  

  Configuração de compatbilidade do Japer.

• A versão do Jasper normalmente está explicita no nome do arquivo JAR na pasta WEB-INF\lib.