Relatórios

Crie modelos de relatórios personalizados

O ENSPACE permite criar modelos de relatórios personalizados para cada categoria do workspace. Cada modelo define quais colunas (campos) serão incluídas na extração e como os dados serão formatados. Após criado, o modelo fica disponível para exportação na tela de itens da categoria e na tela de tarefas agendadas.

Os relatórios podem ser baseados em itens ou em tarefas de fluxo de categoria, alternando entre as abas do painel lateral do construtor.

Para acessar, vá até Configurações > Estrutura > Categorias, selecione a categoria e clique em Relatórios.

O construtor de relatórios

O construtor é a interface visual onde você monta o modelo do relatório. Ele é dividido em duas áreas:

• Área central — a planilha do relatório, onde as colunas selecionadas aparecem com linhas de amostra. Você pode reordenar as colunas arrastando seus cabeçalhos.
• Painel lateral (Campos Disponíveis) — lista todos os campos da categoria organizados em uma árvore. No topo, as abas Itens e Tarefas permitem alternar entre campos de itens e campos de tarefas de fluxo.

Adicionando e removendo campos

• Adicionar — arraste um campo do painel lateral para a área central, ou dê um duplo clique no campo.
• Remover — dê um duplo clique na coluna adicionada, ou use o botão de deletar na barra de ferramentas da coluna.
• Selecionar todos — adiciona todos os campos de uma vez.
• Limpar — remove todos os campos do relatório.

O botão ao lado da barra de busca permite expandir ou recolher toda a árvore de campos do painel.

Configuração de cada coluna

Ao clicar no ícone de configuração de uma coluna, o modal Ações da coluna é aberto com três abas:

Aba Formato

Define como os dados da coluna serão apresentados no relatório exportado.

• Nome da coluna — o rótulo exibido no cabeçalho da coluna.
• Tipo — define a formatação dos valores. As opções são:
  • Data — exibe campos adicionais: Localidade (ex: Português Brasil), Formato da Data (Médio, Curto, Longo) e Formato da Hora.
  • Número — exibe campos adicionais: Localidade, Modo Número (Decimal, Moeda ou Porcentagem).
• Transformar Valor — aplica uma transformação de texto aos valores da coluna antes da exportação:
  • Caixa Baixa
  • Caixa Alta
  • Capitalizar
  • Remover Acentos (latin)
  • Remover Espaços (início e fim)
  • Remover Tags HTML
  • Kebab Case

Aba Estilos

Permite estilizar visualmente a coluna no relatório exportado (Excel). As opções são:

• Habilitar Estilos — ativa a personalização visual.
• Borda — adiciona bordas à coluna.
• Cabeçalho em Negrito — destaca o título da coluna.
• Cor de Fundo do Cabeçalho — define a cor de fundo do cabeçalho (formato hex, ex: #000000FF).
• Cor da Fonte do Cabeçalho — define a cor do texto do cabeçalho.

Aba DBF

Configura como o campo será tratado na exportação em formato DBF.

• Tipo — Character ou Numeric.
• Tamanho — tamanho do campo DBF (1 a 254).
• Casas Decimais — para campos numéricos, número de casas decimais (0 a 15).

Colunas de expressão

Além dos campos da categoria, você pode criar colunas calculadas ou derivadas usando expressões.

Essas colunas permitem, por exemplo:

• calcular valores automaticamente
• combinar campos em um único resultado
• criar indicadores (ex: sim/não, status, SLA)
• trabalhar com datas e prazos
• consolidar informações de listas

Para criar uma coluna desse tipo, clique em Adicionar coluna de expressão no topo do construtor.

Como usar o modal de expressão

Ao abrir o modal, você encontrará dois campos principais:

• Nome da coluna — define o rótulo exibido no relatório
• Expressão — onde você monta a lógica da coluna

O campo de expressão funciona como um editor assistido, que ajuda você a montar a fórmula.

Inserindo campos na expressão

Você pode inserir variáveis de duas formas:

• Digitando {{ diretamente no campo
• Ou clicando no botão + Campo

Ao fazer isso, será exibida uma lista com todos os campos disponíveis:

• com nome amigável (ex: "E-mail do Requisitante")
• e a variável correspondente (ex: {{request_email}})

Você pode:

• buscar campos pelo nome
• clicar em um item da lista
• e o sistema insere automaticamente a variável na expressão

Isso evita erros de digitação e facilita a construção da lógica.

Tipos de uso das expressões

As expressões podem ser usadas para diferentes finalidades dentro do relatório:

Ajuda dentro do modal

O próprio modal exibe um quadro com exemplos rápidos de uso e um botão para Perguntar ao BENI AI.

Você pode usar esse recurso para tirar dúvidas rápidas ou gerar sugestões de expressão diretamente dentro da interface.

Salvar o modelo

No canto superior esquerdo do construtor, nomeie o modelo no campo de texto editável. Clique em Salvar no canto superior direito para gravar o modelo.

Caso você tente sair da tela sem salvar, o sistema exibirá um modal de confirmação com duas opções:

• Salvar e sair — grava as alterações antes de fechar
• Sair sem salvar — descarta todas as alterações realizadas

Isso evita a perda acidental de configurações no relatório.

Como usar o relatório

Após salvar o modelo, ele ficará disponível na tela de itens da categoria como uma opção de extração.

Cada relatório criado é exclusivo da categoria onde foi configurado e aparecerá automaticamente na lista de relatórios disponíveis para exportação.