Agendamentos do BI
v2/bi/agendamentos
6 min de leitura
Um agendamento envia um relatório do BI por e-mail, em Excel ou CSV, todo dia, toda semana ou todo mês, sem ninguém precisar lembrar de exportar.
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, criar e editar agendamentos | parâmetro habilitar_bi = S e permissão Relatórios BI - Agendamentos, gerenciar |
| O e-mail sair de fato | a fila de processamento do BI ativa na instalação e o e-mail de envio configurado |
Onde fica
Gestão > Relatórios BI, aba Agendamentos. Endereço: v2/bi/agendamentos.

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 Agendamentos marcada).
- Logo abaixo, à direita, o botão Novo agendamento.
- A tabela: Relatório, Quando (a recorrência por extenso, como "Toda segunda, 07:00" ou "Dia 1 de cada mês, 08:00"), Formato, Destinatários, Última execução, Ativo (botão que liga e desliga) e Ações (executar agora, editar, excluir).
Criar um agendamento
Novo agendamento. O formulário abre acima da lista.

- Relatório: escolha na lista (todos os relatórios do catálogo).
- Formato: Excel (.xlsx) ou CSV (.csv).
- Recorrência:
- Diário, com o Horário;
- Semanal, com o Dia da semana e o horário;
- Mensal, com o Dia do mês (1 a 28) e o horário;
- Cron avançado, para quem conhece a notação (ex.:
0 7 * * 1-5, dias úteis às 7h).
- Destinatários: e-mails separados por vírgula. Podem ser de fora da empresa (o cliente, por exemplo).
- Assunto do e-mail (opcional). Em branco, o assunto é "Relatório: " seguido do nome do relatório.
- Ativo ligado e Salvar agendamento. A mensagem "Agendamento salvo." confirma.
Mensagens de validação: "Escolha o relatório.", "Informe ao menos um e-mail (separados por vírgula).", "Nenhum e-mail válido informado.", "Use dia 1 a 28 (meses curtos não pulam envio)." e "Expressão cron inválida.".
Executar agora, pausar e excluir
- ▶ Executar agora envia o relatório na hora para os mesmos destinatários: "Execução enfileirada — os destinatários receberão o e-mail ao concluir.". Bom para testar o agendamento recém-criado.
- O botão Ativo / Inativo pausa e retoma o envio sem perder a configuração.
- 🗑 Excluir pede confirmação.
Cada envio aparece na aba Execuções com o disparo Agendamento.
O que chega no e-mail
Um resumo do relatório no corpo da mensagem (com o pivot resumido, quando o relatório usa pivot) e o arquivo completo em anexo, com o total de linhas.
Exemplos práticos
Situação: a diretoria quer, toda segunda cedo, o resumo de chamados encerrados por cliente. O que fazer: Novo agendamento > Relatório "Chamados encerrados por cliente" > Excel (.xlsx) > Semanal, Segunda, 07:00 > destinatários da diretoria > Salvar agendamento > ▶ Executar agora para conferir. Resultado: a diretoria recebe o e-mail de teste agora e, a partir daí, toda segunda às 7h.
Situação: um cliente de contrato quer o relatório mensal de atendimentos. O que fazer: crie um relatório filtrado pelo cliente e com o período "Mês anterior" > Novo agendamento > Mensal, dia 1, 08:00 > e-mail do cliente. Resultado: todo dia 1º o cliente recebe os chamados do mês que fechou.
Perguntas frequentes
Por que o dia do mês vai só até 28? Para nenhum mês ficar sem envio (fevereiro não tem dia 30).
O agendamento usa os parâmetros perguntados na execução? Usa os valores salvos no relatório. Para um período que anda sozinho, salve o filtro de data com um Período (macro), como "Mês anterior".
O agendamento respeita a restrição por usuário (RLS) do dataset? Não. O envio roda sem usuário, então traz todas as linhas. Cuidado ao mandar para fora relatórios de datasets restritos.
Limites e comportamentos que não são defeito
- Não há mais PDF nos agendamentos. Agendamentos antigos em PDF passam a sair em Excel quando editados.
- Se o serviço de agendamento estiver fora do ar, o sistema confere a cada 5 minutos e dispara o que ficou pendente.
- Os arquivos gerados ficam guardados pelo número de dias do parâmetro
bi_retencao_dias(30 se não definido).