Cobertura: JasperReports, iReport, JRXML e datasets
Você aciona o IReport Expert quando o problema está no ciclo técnico de um Relatório Formatado construído com JasperReports e iReport: consulta, dataset, JRXML, estrutura do relatório e comportamento observado no runtime. Na Plataforma Sankhya, a própria trilha Specialist trata iReport, parâmetros, agrupamentos, gráficos, imagens, sub-relatórios, exportação, Crosstab e funções nativas como competências desse território.
Onde o expert entra
O modelo de análise do expert não começa pelo desenho da página. Ele percorre a cadeia:
- necessidade e origem dos dados
- SQL
- dataset
- JRXML
- JasperReports Engine
- runtime Sankhya
- documento produzido
O iReport é a ferramenta de modelagem visual. O JRXML é o artefato XML que descreve a estrutura. O dataset disponibiliza os dados que serão consumidos por fields, expressions e componentes. O runtime é onde essa combinação realmente executa. Por isso, um JRXML aparentemente correto não prova que o relatório funcionará.
A documentação Sankhya confirma que relatórios personalizados podem utilizar JRXML produzido no iReport e carregado no relatório. Ela também alerta que um layout personalizado não acompanha automaticamente alterações posteriores na estrutura do relatório.
O que você pode levar ao expert
Você pode procurar o expert para analisar problemas envolvendo:
- JRXML e sua estrutura
- datasets e subdatasets
- parameters, fields e variables
- expressions
- bands e groups
- subreports
- componentes visuais
- execução e geração do relatório
- comportamento específico de exportação quando ele depender do JasperReports
Não trate o arquivo como evidência suficiente. Um erro como [CORE_E01212] "Não há nenhum arquivo cadastrado para o relatório" possui causa documentada pela Sankhya relacionada à ausência do JRXML na configuração correspondente. Esse é um bom exemplo de diagnóstico que exige olhar a camada correta, não redesenhar o relatório.
Quando houver dados empresariais no material, anonimize nomes, documentos, valores sensíveis e informações pessoais antes de compartilhar, preservando estrutura, tipos e relações necessários ao diagnóstico.
a cadeia antes do layout
O relatório imprime errado. O reflexo é abrir o iReport e mexer nos elementos.
A análise não começa pelo desenho da página. Ela percorre a cadeia: consulta → dataset → JRXML → renderização → runtime.
Cada elo produz um sintoma visual parecido:
- consulta com grão errado → linhas repetidas
- dataset mal ligado → campos vazios
- band inadequada → conteúdo aparecendo mais de uma vez
- expression com tipo errado → erro em execução
Identificar em qual trecho o sintoma aparece antes de acionar é o que evita passar uma tarde ajustando layout para corrigir uma duplicação que nasceu no JOIN.
O terreno cobre iReport, parâmetros, agrupamentos, gráficos, imagens, sub-relatórios, exportação, Crosstab e funções nativas — mas todos eles operam sobre o que o dataset entregou.
Antes de acionar o expert, identifique em qual trecho da cadeia entre SQL, dataset, JRXML e runtime o sintoma aparece e preserve evidências suficientes para validar essa hipótese.
As demais aulas, as avaliações e o certificado ficam disponíveis após o cadastro. Iniciativa independente, sem vínculo oficial com a fornecedora do Sankhya ERP.