Execuções do BI
v2/bi/execucoes
6 min de leitura
O histórico de tudo o que o BI gerou em arquivo: exportações pedidas por usuários e envios de agendamentos. É onde você baixa o Excel ou o CSV e vê o que falhou.
Transcrição do vídeo
Neste vídeo, você vai ver os bastidores dos Relatórios BI: os datasets, os envios por e-mail, os alertas de KPI, o histórico de execuções e as conexões.
A aba Datasets é de quem implanta o BI. O SNDesk já traz datasets prontos para chamados, agendamentos, estouro de SLA, orçamentos e avaliações, cada um com o modo, a conexão e os campos.
O SQL usa códigos de tabela, como tb1 e tb2, e o catálogo de tabelas mostra o que cada código guarda. O quadro do assistente manda esse mapa para a base da IA.
No lápis, o formulário abre acima da lista. A conexão padrão é o banco do próprio SNDesk. DirectQuery consulta a fonte a cada execução; Materializado guarda uma cópia e atualiza na recorrência. O SQL aceita só SELECT.
Validar e pré-visualizar roda a consulta, confere que é só leitura e mostra as primeiras linhas. Depois, classifique cada coluna: dimensão ou medida, o tipo do dado e a agregação.
A segurança em nível de linha restringe o que cada usuário vê, por exemplo, pelos departamentos dele. E os campos calculados criam contas com fórmula.
Em Agendamentos, cada linha envia um relatório por e-mail, em Excel ou CSV, com a recorrência por extenso. Ativo pausa o envio sem perder a configuração, e Executar agora manda na hora.
No novo agendamento, escolha o relatório, o formato e a recorrência: diária, semanal, mensal ou cron. Os destinatários vão separados por vírgula, e podem ser de fora da empresa.
O dia do mês vai até vinte e oito, para nenhum mês ficar sem envio. Salvar agendamento grava, e cada envio aparece na aba Execuções.
Um alerta de KPI vigia o total de uma medida e avisa por e-mail quando passa do limite. Aqui, a nota média dos técnicos caiu abaixo de oito: o estado é Violado, com o último valor e a data do aviso.
No novo alerta, escolha o relatório, a medida, a condição, o limite e a frequência. O e-mail sai só na virada para Violado, não a cada avaliação.
Execuções é o histórico do que o BI gerou em arquivo: exportações e envios agendados. Na linha concluída, o botão baixa o arquivo. Na que falhou, o erro aparece abaixo, e o botão ao lado tenta de novo.
Conexões não tem aba: abre pelo endereço v2, bi, conexões. Serve para um banco MySQL ou MariaDB extra, como uma réplica. A maioria das instalações não precisa de nenhuma.
Em Nova conexão, informe o host, a porta, o banco e um usuário só de leitura. Testar conexão confirma o acesso antes de salvar.
Cada aba tem o seu guia, com exemplos, na documentação do SNDesk. Até o próximo vídeo!
Antes de começar
| O que | Depende de |
|---|---|
| Ver o histórico | parâmetro habilitar_bi = S e permissão Relatórios BI - Execuções, visualizar |
| Baixar um arquivo | ter pedido a exportação, ou ter a permissão de Execuções ou a de exportar relatórios BI |
Onde fica
Gestão > Relatórios BI, aba Execuções. Endereço: v2/bi/execucoes.

O que você vê, de cima para baixo
- O título Relatórios BI, o subtítulo da aba e, à direita, as abas do módulo (a aba Execuções marcada).
- Logo abaixo, a barra com o indicador Tempo real: Reverb ativo (a tela se atualiza sozinha quando uma execução termina) ou aguardando conexão, quando a tela consulta de tempos em tempos, e, quando há algo rodando, quantas execuções estão em andamento.
- A tabela, da mais recente para a mais antiga: #, Relatório, Disparo (Usuário ou Agendamento), Formato, Status, Linhas, Duração, Início e Ações.
- Paginação de 25 em 25.
Os status:
| Status | O que significa |
|---|---|
| Na fila | Pedido registrado, esperando a vez. |
| Executando | O arquivo está sendo gerado. |
| Concluído | Pronto: o botão de baixar aparece em Ações. |
| Falhou | Deu erro. A mensagem aparece numa linha logo abaixo, e o botão de tentar de novo fica disponível. |
Baixar um arquivo
Na linha Concluído, clique em baixar. O arquivo vem no formato pedido (.xlsx ou .csv). Quando a exportação termina, quem pediu também recebe um aviso na tela.
Tentar de novo uma execução que falhou
Leia o erro abaixo da linha (por exemplo, tempo limite estourado), ajuste o relatório se for o caso (um período menor resolve a maioria) e clique em tentar novamente. A mensagem "Execução #N reenfileirada." confirma, e a mesma linha volta para Na fila.
Exemplos práticos
Situação: o gestor exportou um relatório grande e quer saber se já terminou. O que fazer: abra Execuções e espere a linha mudar para Concluído (com o Reverb ativo, muda sozinha). Resultado: o botão de baixar aparece e o arquivo vem completo, com o número de linhas na coluna Linhas.
Situação: a diretoria disse que não recebeu o relatório de segunda. O que fazer: procure a linha do relatório com o disparo Agendamento e confira o status e o início. Resultado: se está Concluído, o e-mail saiu (vale olhar a caixa de spam e os destinatários do agendamento); se Falhou, leia o erro e use tentar novamente.
Perguntas frequentes
Cliquei em baixar e veio "Arquivo não encontrado". O arquivo passou do prazo de guarda e foi apagado. Gere a exportação de novo.
Apareceu o aviso de execuções aguardando há mais de 10 minutos. A fila de processamento do BI parou na instalação. Isso é com o suporte técnico de quem hospeda o sistema, não com o relatório.
Limites e comportamentos que não são defeito
- Os arquivos ficam guardados pelo número de dias do parâmetro
bi_retencao_dias(30 se não definido). A linha continua no histórico; só o arquivo some. - Executar um relatório na tela (sem exportar) não entra no histórico.
- Avaliações de alertas de KPI não aparecem aqui; o resultado delas fica na própria tela de Alertas.