> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Relatórios

**Relatórios** permite que as organizações consultem, gerem e gerenciem, de forma centralizada, informações relevantes a partir dos dados coletados pelo FlexxAgent sobre o parque de dispositivos.

![reports-table2](https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/reports-table2.png?fit=max\&auto=format\&n=SlGXA3JTqSPrj5Ic\&q=85\&s=9de30dbf26519b9535cf79e22b0345a2)

Por meio de **Relatórios**, você pode:

* Consultar relatórios existentes e revisar seu histórico de execuções.
* Executar relatórios sob demanda e programar execuções automáticas.
* Compartilhar os resultados dos relatórios por e-mail.
* Criar relatórios personalizados por meio de inteligência artificial utilizando linguagem natural.

## Lista de relatórios

Exibe todos os relatórios disponíveis na organização.

Quando os relatórios são apresentados em formato de blocos:

* Um ícone de calendário na cor verde indica que a programação do relatório está habilitada.

![detail-card](https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/detail-card.png?fit=max\&auto=format\&n=SlGXA3JTqSPrj5Ic\&q=85\&s=345fb9a0b5ae77528bdc8d24f8b96cdb)

* É exibida a informação de visibilidade do relatório: *Privado* ou *Compartilhado*.

![report-visib](https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/report-visib.png?fit=max\&auto=format\&n=SlGXA3JTqSPrj5Ic\&q=85\&s=006d74c8bb4c0cceb62375bd439f7f61)

* Ao clicar no bloco, você acessa a pré-visualização de suas execuções.
* O botão **Ver detalhe** permite acessar as informações completas do relatório e suas opções de gerenciamento.

### Ações disponíveis

Na parte superior da lista, estão incluídas ações como:

![reports-ia-actions](https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/reports-ia-actions.png?fit=max\&auto=format\&n=SlGXA3JTqSPrj5Ic\&q=85\&s=044dae1e4e8f9a89eed8217c0bae345e)

| Ação | Descrição |
| - | - |
| Exportar | Baixa em formato `.csv` a lista de relatórios disponíveis. |
| Recarregar | Atualiza a lista de relatórios. |
| Seletor de visualização | Alterna entre a visualização em blocos ou em tabela. |
| Buscar | Filtra os relatórios inserindo caracteres que coincidam com o nome. |

## Visualização de detalhe de um relatório

A visualização de detalhe é composta pelas seguintes seções:

1. Detalhes do relatório
2. Execuções
3. Dados atuais
4. Inquilinos habilitados

### 1. Detalhes do relatório

Exibe as informações gerais do relatório.

![report-details3](https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/report-details3.png?fit=max\&auto=format\&n=SlGXA3JTqSPrj5Ic\&q=85\&s=f326229492f5a51535d2ccc048d6b8d1)

Inclui os campos:

* **Visibilidade.** Indica se é *Privado* ou *Compartilhado*.
* **Categoria.** Nome da categoria à qual o relatório pertence.
* **Programação habilitada.** Indica se a execução automática está *Habilitada* ou *Desabilitada*.
* **Programação.** Resumo em linguagem natural do padrão de recorrência configurado.
* **Resultados da última execução.** Número de registros obtidos na última execução.
* **Criado por.** Usuário que criou o relatório.

>

* **Nome.** Nome do relatório.
* **Criado por.** Nome do usuário que o criou.
* **Executado em.** Data da primeira execução.
* **Duração da última execução.** Tempo de execução em segundos.
* **Resultados da última execução.** Quantidade de registros do último relatório executado.
* **Criado em.** Data e hora de criação.
* **Programação habilitada.** Indica se a programação está ou não habilitada.
* **Programação.** Se a programação estiver habilitada, hora na qual está programada sua execução.

### 2. Execuções

Exibe o histórico de execuções do relatório em formato de tabela.

![report-execution2](https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/report-execution2.png?fit=max\&auto=format\&n=SlGXA3JTqSPrj5Ic\&q=85\&s=e17590d2d780a12dacd75ce82bdc5660)

Cada registro inclui:

* **Criado em.** Data e hora de geração. Ao clicar, o relatório é baixado em formato `.csv`.
* **Estado.** Estado da execução: *Completo*, *Pendente* ou *Erro*.
* **Autor.** Usuário que executou o relatório. Em execuções programadas, é exibido *Gerado automaticamente*.
* **Linhas.** Número de registros incluídos.
* **Expira em.** Data e hora de expiração do arquivo (60 dias após sua criação).

### 3. Dados atuais

Exibe os resultados mais recentes em formato de tabela.

A estrutura das colunas pode variar de acordo com o tipo de dados do relatório (dispositivos, aplicações instaladas, grupos de workspaces, etc.).

![live-query4](https://mintcdn.com/flexxible/SlGXA3JTqSPrj5Ic/images/features/live-query4.png?fit=max\&auto=format\&n=SlGXA3JTqSPrj5Ic\&q=85\&s=ddd702030536984cf334107d7506bef1)

### 4. Inquilinos habilitados

Em organizações que possuam suborganizações (inquilinos delegados), essa funcionalidade permite compartilhar relatórios com essas suborganizações e gerenciar seu acesso de forma individual.

Para isso, é exibida uma tabela por meio da qual é possível habilitar ou desabilitar o relatório para cada suborganização. Uma vez habilitado, elas poderão consultar e reutilizar o relatório compartilhado.

A tabela contém:

* **Inquilino.** Nome da suborganização.
* **Habilitado.** Estado do relatório para a suborganização (habilitado ou desabilitado).
* **Habilitado em.** Data e hora em que o relatório foi habilitado.
* **Habilitado por.** Usuário que habilitou o relatório.

#### Considerações

* Ao habilitar um relatório para uma suborganização, toda a configuração do relatório original é copiada para que ela possa utilizá-lo, exceto os seguintes dados:

  * Programação
  * E-mails de compartilhamento
  * Histórico de execuções

* Uma suborganização poderá atribuir o nome do relatório, sua categoria e o compartilhamento por e-mail, se desejar.

* Os relatórios habilitados em suborganizações exibirão apenas informações pertencentes a essa suborganização, mesmo que o relatório original inclua dados de várias organizações.

* Ao desabilitar um relatório em uma suborganização, ele será excluído juntamente com todas as suas execuções, programação e configuração de compartilhamento.

## Ações disponíveis

Na visualização de detalhe do relatório, é possível realizar as seguintes ações:

### Editar

Permite modificar o nome do relatório e sua categoria.

As categorias podem ser configuradas a partir da seção Organização.

### Clonar e modificar

Redireciona para a conversa original para permitir refinar o relatório e criar um novo com base no atual.

### Executar relatório agora

* Executa a consulta e cria um novo registro no histórico de execuções.
* Cada execução manual gera um arquivo independente.
* Se o relatório tiver uma programação ativa, as execuções manuais não afetam o calendário programado.

### Compartilhar

Permite enviar o relatório para os destinatários especificados.

**Etapas para compartilhar o relatório:**

1. Acessar **Relatórios** → **Relatórios**.
2. Selecionar **Ver detalhe** no relatório que você deseja compartilhar.
3. No painel de ações, clicar em **Compartilhar**.
4. Inserir os endereços de e-mail e confirmar com a tecla **Enter**.
5. Clicar em **Salvar**.

A partir desse momento, os destinatários receberão os relatórios gerados, tanto manualmente quanto automaticamente.

**Modificar os destinatários:**

1. Acessar **Relatórios** → **Relatórios**.
2. Selecionar **Ver detalhe** no relatório correspondente.
3. Clicar em **Compartilhar**.
4. Remover ou adicionar endereços de e-mail.
5. Clicar em **Salvar**.

### Programação

Permite configurar a execução automática do relatório:

**Etapas para programar um relatório:**

1. Acessar **Relatórios** → **Relatórios**.
2. Selecionar **Ver detalhe** no relatório desejado.
3. No painel de ações, clicar em **Programação** e configurar:

* **Hora de início.** Hora em que o relatório será executado.
* **Padrão de recorrência**

  * **Diário:** Intervalo de dias ou execução de segunda a sexta-feira.
  * **Semanal:** Seleção de dias da semana e frequência em semanas.
  * **Mensal:** Dia específico do mês ou padrão baseado no primeiro/segundo/terceiro/quarto/último dia da semana (segunda a domingo).

  Uma vez configurada a programação, na mesma janela é exibido um resumo em linguagem natural do padrão definido.

### Excluir relatório

* Exclui a consulta de forma permanente.
* Exclui os arquivos gerados.
* Cancela as programações ativas.
* Essa ação não pode ser desfeita.

### Exportar para CSV

Essa ação está disponível na aba **Dados atuais**. Baixa o relatório em formato `.csv`.

## Pré-visualização de um relatório

Na visualização em blocos, ao clicar em um relatório, você acessa uma pré-visualização de suas execuções.

A tabela inclui:

* **Criado em.** Data e hora de geração. Ao clicar, o relatório é baixado em formato `.csv`.
* **Estado.** Estado da execução: *Completo*, *Pendente* ou *Erro*.
* **Autor.** Usuário que gerou o relatório. Em execuções programadas, é exibido *Gerado automaticamente*.
* **Linhas.** Número de registros incluídos.
* **Expira em.** Data e hora de expiração do arquivo (60 dias após sua criação).

Nessa visualização, é possível:

* Atualizar a lista de execuções.
* Acessar a visualização de detalhe.
* Executar relatório agora.
* Excluir o relatório.
