# Layout de Relatório

## Visão Geral

O processo de **importação e exportação de dados** no sistema é realizado por meio de **rotinas configuradas**, nas quais é necessário definir previamente o **tipo de layout** que será utilizado para estruturar as informações.

O **SURICATO** permite criar e configurar diferentes layouts para um mesmo processo, possibilitando adaptar a estrutura dos dados conforme a necessidade da operação. Neste caso, o layout é utilizado para **geração de relatórios que serão extraídos do sistema**, organizando os campos e a ordem das informações exportadas.

Para facilitar a sua experiência, separamos o conteúdo diferencial das versões 3.0 e 3.1 em abas.

{% hint style="info" %}
**O que você precisa saber:** Embora a interface tenha evoluído, as regras, campos e lógica de preenchimento permanecem idênticos. A única diferença está na forma de acessar a tela no sistema.
{% endhint %}

## Regras de Negócio

* **Pré-requisitos:**
  * Configurar o **Processo Automático** (Processo > Relatório).
  * Garantir que o serviço **GerServ** esteja ativo.
* Na seção **Informações,** os campos **Nome, Tamanho, Orientação, Margem Esquerda, Margem Direita, Margem Superior, Margem Inferior, Instrução SQL SELEC e Registro por Página** são obrigatórios.
* Na seção **Cabeçalho e Corpo,** os campos **Nome da Fonte, Tamanho da Fonte e Cor da Fonte** são obrigatórios.
* Na aba de Colunas, **todos os campos são obrigatórios**.

## Como consultar o Layout de Relatórios

{% tabs %}
{% tab title="Versão 3.0" %}
Acesse o menu **Processo > Layout de Relatórios**, o sistema exibirá a tela de Consulta Modelo de Relatório para Processo Automático, com a lista de registros cadastrados.&#x20;

<figure><img src="/files/JUmtXtqdYwIse1eTRQJl" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Versão 3.1" %}
Siga o caminho abaixo e, acesse o menu **Processo > Layout de Relatórios**, o sistema exibirá a tela de Consulta Modelo de Relatório para Processo Automático, com a lista de registros cadastrados.

Na nova interface, você também pode pesquisar diretamente pelo menu desejado.&#x20;

Como alguns submenus possuem nomes iguais, observe sempre o ícone exibido à esquerda do nome. Ele ajuda a identificar corretamente o menu correspondente, facilitando a localização da opção que você precisa.

{% endtab %}
{% endtabs %}

### Consulta - Modelo de Relatório para Processo Automático

<figure><img src="/files/X4aptaCLABzZwACcvhOZ" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Nessa tela é possível selecionar as colunas disponíveis para serem visualizadas na tabela, podendo ordená-las pelas colunas em Asc/Desc para facilitar a visualização. Essa tabela pode ser exportada em PDF, Word, Excel, XML, JSON, CSV, RTF ou impresso.

Você também pode localizar e consultar um Layout de Relatórios cadastrado por meio da Busca Rápida ou pelo botão de Pesquisa ao lado, utilizando filtros em ambas as opções.
{% endhint %}

{% stepper %}
{% step %}
**+ Novo:** Cadastre um Local de Prestação de Serviço para sua empresa, clicando neste botão.
{% endstep %}

{% step %}
**Pesquisar:** Pesquise usando filtros um Local de Prestação de Serviço já cadastrado.
{% endstep %}

{% step %}
**Ferramentas da Tabela:** Você pode ordenar colunas (A-Z) ou exportar a lista em formatos como PDF, Excel ou CSV.
{% endstep %}

{% step %}
**Busca Rápida:** Localize um Local de Prestação de Serviço pelo nome ou código.
{% endstep %}

{% step %}
**Editar cadastro:** Edite um cadastro de um Local de Prestação de Serviço, clicando no botão de edição.
{% endstep %}
{% endstepper %}

## Como cadastrar um Modelo de Relatório

1. Na tela Consulta Modelo de Relatório para Processo Automático, clique em **+ Novo**.
2. A tela de **Modelo de Relatório para Processo Automático** está dividida em **cinco seções**, Informações, Título, Cabeçalho, Corpo e Logo.
3. Na seção **Informações**:
   1. Os campos **Nome, Tamanho, Orientação, Margem Esquerda, Margem Direita, Margem Superior, Margem Inferior, Instrução SQL SELEC e Registro por Página** são obrigatórios.
   2. Preencha as informações de acordo com o padrão do Relatório.
4. Na seção **Título**, não há campos obrigatórios, preencha com informações de padrão da Empresa referentes ao Título.
5. Na seção **Cabeçalho**:
   1. Os campos **Nome da Fonte, Tamanho da Fonte e Cor da Fonte** são obrigatórios.
   2. Preencha esses campos seguindo o padrão da empresa.
6. Na seção **Corpo**:
   1. Os campos **Nome da Fonte, Tamanho da Fonte e Cor da Fonte** são obrigatórios.
   2. Preencha esses campos seguindo o padrão da empresa.
7. Na seção **Logo**, não há campos obrigatórios, caso precise incluir a logo da empresa, clique no campo para fazer o download da imagem.
8. Depois de preencher todos os campos obrigatórios e necessários, clique em **+ Incluir** para salvar.
9. Lembrando que é necessário configurar o **Processo Automático** e garantir que o serviço **GerServ** esteja ativo.

<figure><img src="/files/fgrwfJ1HEa5wPqjRT900" alt=""><figcaption></figcaption></figure>

## Layout de Relatório - Colunas

Depois de clicar em **+ Incluir**, um novo botão no topo da tela ficará disponível, nomeado de **Colunas**.

inserir imagem

Ao clicar no botão **Colunas** na tela de **Edição**, serão exibidas as colunas definidas no campo **Instrução SQL SELECT**, permitindo visualizar e realizar ajustes nas informações configuradas.

1. **Todos os campos são obrigatórios**.
2. Preencha ou altere os campos conforme necessidade.
3. Depois de realizar as edições, é possível selecionar na checkbox o que será alterado, e clicar em **Salvar** para salvar.

<figure><img src="/files/ShDHla2msG8irG9WwSle" alt=""><figcaption></figcaption></figure>

## Guia Rápido de Uso

**Como editar um Layout de Relatório**

1. Na tela Consulta Modelo de Relatório para Processo Automático, localize o Layout que precisa editar, ou pesquise por ele no **botão de Pesquisar** usando filtros, ou através da **Busca Rápida.**
2. Depois de localizar o Layout, clique no **botão de edição** à esquerda do **Nome** dele.
3. Todos os campos poderão ser editados, exceto o **Nome do Layout**.
4. Depois de realizar as alterações necessárias, clique em **Salvar.**

<figure><img src="/files/YcbvGEw2SWX618N1SHAb" alt=""><figcaption></figcaption></figure>

## FAQ - Perguntas Frequentes

<details>

<summary>O que acontece se eu tentar salvar um layout de relatório sem preencher todos os campos obrigatórios da seção Informações?</summary>

O sistema não permitirá salvar o cadastro. Todos os campos obrigatórios da seção Informações devem estar preenchidos para que o layout possa ser incluído.

</details>

<details>

<summary>É possível alterar o nome de um layout de relatório após ele já ter sido cadastrado?</summary>

Não. O campo **Nome do Layout** não pode ser editado após o cadastro. Caso seja necessário utilizar outro nome, será preciso criar um novo layout.

</details>

<details>

<summary>O que ocorre se a Instrução SQL SELECT não retornar colunas para o relatório?</summary>

Nesse caso, a aba **Colunas** não poderá ser configurada corretamente, pois ela depende das colunas retornadas pela instrução SQL. Sem esse retorno, não será possível ajustar os campos obrigatórios dessa aba.

</details>

<details>

<summary>O sistema permite salvar a configuração das colunas sem preencher todos os campos disponíveis?</summary>

Não. Todos os campos da aba **Colunas** são obrigatórios. Se algum campo permanecer sem preenchimento, o sistema bloqueará o salvamento das alterações.

</details>

<details>

<summary>O layout de relatório pode funcionar mesmo que o Processo Automático não esteja configurado ou que o serviço GerServ esteja inativo?</summary>

Não. O funcionamento correto do layout depende da configuração prévia do Processo Automático e do serviço **GerServ** ativo. Sem esses pré-requisitos, o relatório não poderá ser executado corretamente.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/manual-de-operacao/manual-do-suricato/processos-configuracoes-e-relatorios/processo/layout-de-relatorio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
