Automatizar a geração e a distribuição de um relatório

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 9 min. de leitura

    • Gere e distribua relatórios programados por e-mail.

    Antes de Iniciar

    Função necessária: administrador

    Um usuário com a função report_scheduler também pode criar um relatório programado por meio de um caminho de navegação diferente. Para obter mais informações, consulte Schedule emails of Core UI reports.

    Por Que e Quando Desempenhar Esta Tarefa

    Os relatórios agendados podem ser distribuídos no formato PDF, CSV ou XLS. Os relatórios gráficos podem ser distribuídos no formato PNG ou PDF. Os relatórios dinâmicos multinível só podem ser agendados no formato PDF.

    Nota:
    • Não é possível programar relatórios de Calendário, Mapa ou Pontuação única. Você pode programar relatórios de Tabela dinâmica somente se o plug-in for com.snc.whtpestá habilitado.
    • Os dados podem não aparecer em relatórios criados por um indivíduo cuja conta de usuário está desativada. Para garantir que os dados desejados sejam exibidos, um usuário ativo deve recriar o relatório programado.

    Procedimento

    1. Navegar até Tudo > Definição do Sistema > Trabalhos agendados.
    2. Selecione Novo.
    3. Selecione Automatizar a geração e a distribuição de um relatório .
    4. Preencha estes campos:
      Campo Descrição
      Nome Nome do relatório agendado.
      Relatório Referência ao relatório que você está programando. Você pode usar o ícone Pesquisar Ícone de pesquisapara localizar o relatório.
      Nota:
      O suporte automático por e-mail não está disponível para relatórios de Calendário, Mapa e Pontuação única.
      Usuários Usuários individuais que recebem o relatório na data e hora agendadas. Os usuários devem ter Notificação definido como Habilitado em seus registros de usuário para receber relatórios.
      Grupos Grupos que recebem o relatório na data e hora agendadas.
      Endereços de email Lista separada por vírgulas de endereços de e-mail de destinatários do relatório que não são usuários em sua instância.
      Aplicação Nome da aplicação com escopo que contém o relatório. Global aparece se o relatório estiver no escopo global.
      Ativo Quando ativos, os relatórios agendados são entregues.
      Executar
      Intervalo de tempo a ser usado para executar o trabalho agendado:
      • Diariamente : É executado diariamente, em um horário designado.
      • Dia e mês no ano : É executado anualmente em um dia e mês específicos (por exemplo, 14 de julho), em um horário designado.
      • Dia na semana em mês no ano : É executado anualmente em um dia específico da semana em uma semana específica de um mês específico (por exemplo, a segunda segunda-feira de outubro), em um horário designado.
      • Semana no mês : É executado mensalmente durante uma semana específica do mês (por exemplo, a terceira semana de cada mês), em dias designados e em um horário designado.
      • Semanalmente : Executa semanalmente, em um horário e dia designados da semana.
      • Mensal : É executado mensalmente, em uma hora e dia designados do mês.
      • Periodicamente : É executado em um intervalo de repetição designado.
      • Uma vez : É executado somente para uma única ocorrência.
      • Sob demanda : É executado imediatamente sob demanda.
      • Calendário comercial: Início da entrada : É executado nas datas de entrada inicial do calendário comercial selecionado no Calendário comercial campo. Um trabalho agendado é executado para a data de início de cada uma das entradas de negócios que você definiu para o calendário comercial.

        Por exemplo, se o calendário comercial representar um ano fiscal e a data de início de cada entrada for um mês fiscal, o trabalho agendado será executado no primeiro dia de cada mês.

      • Calendário comercial: Término da entrada : É executado para a data de término do calendário comercial selecionado no Calendário comercial campo. Esta seleção é executada da mesma maneira que Calendário comercial: Início da entrada , mas para as datas de término das entradas de calendário comercial associadas.
        Nota:
        Quando você seleciona Calendário comercial: Início da entrada ou Calendário comercial: Término da entrada , você pode aplicar um fator de deslocamento para programar a execução do trabalho antes ou depois do intervalo de tempo do calendário comercial selecionado. Se você selecionar um calendário comercial e todos os períodos do calendário comercial estiverem no passado, o trabalho nunca será executado, pois essa é uma configuração inválida. Para saber mais, consulte Tipo de deslocamento e. Deslocamento campos.

        Para saber mais sobre como criar e usar calendários comerciais e definir entradas de calendário comercial, consulte Criação de calendários de negóciose. Defina entradas de calendário comercial.
      Fuso horário
      Fuso horário a ser usado com Tempo entrada do campo quando você especifica a hora em que o trabalho agendado deve ser executado. Selecione uma entrada de fuso horário:
      • -Nenhum- : Use o fuso horário padrão para o usuário conectado que está criando o trabalho agendado.

        Por exemplo, o trabalho agendado é executado às 04:45 horas, horário dos EUA/Pacífico, se for o fuso horário atribuído ao usuário, e você inserir 16:45 em Tempo campo.

      • Use o Fuso horário do sistema : Use o fuso horário padrão do sistema especificado para a instância em que ele é executado.

        Por exemplo, o trabalho agendado é executado às 10:15 horas, horário de Londres, se Europa/Londres for o fuso horário padrão do sistema para a instância, e você inserir 22:15 em Tempo campo.

      • Fuso horário real.

        Por exemplo, o trabalho agendado é executado às 1:30 no fuso horário da Leste dos EUA, se você selecionar EUA/Leste e insira 13:30 em Tempo campo.
      Hora Hora do dia em que o trabalho agendado deve ser executado, expressa em horas, minutos e segundos em um relógio de 24 horas. A seleção que você faz no Fuso horário o campo determina o fuso horário desta entrada.
      Dia
      Dia em que o trabalho agendado deve ser executado.
      • Se Executar está definido como Semanalmente , selecione o dia da semana. Por exemplo, selecione Quarta-feira.
      • Se Executar está definido como Mensal , selecione o dia do mês. Por exemplo, selecione 25 para o 25º dia do mês.
      Este campo será exibido somente se você selecionar Mensal ou Semanalmente em Executar campo.
      Intervalo de repetição
      Duração do intervalo de repetição para cada execução de trabalho agendada. Insira a duração no número de dias, horas ou minutos. Por exemplo:
      • Para executar o trabalho agendado a cada quatro dias, insira 04 em Dias campo.
      • Para executá-lo a cada 26 horas, insira 26 em Horas campo.
      • Se ele deve ser repetido em um intervalo de 13:30:25, insira 13 em Horas e insira 30 e. 25 nos dois campos não rotulados após ele.
      Iniciando Permite definir a janela de início de tempo em que você deseja que seu trabalho comece a ser executado. O trabalho será realmente executado no horário especificado em Tempo de execução . Selecione a data e a hora do calendário. . Iniciando o campo será exibido somente se você selecionar uma das opções a seguir Executar tipos no Executar campo:
      • Diariamente
      • Dia e mês do ano
      • Dia na semana no mês no ano
      • Mensalmente
      • Uma vez
      • Periodicamente
      • Semana no mês
      • Semanalmente

      Para o tipo de execução Periodicamente . Iniciando a hora é a data e a hora da primeira geração de trabalho agendado.
      Calendário de negócios

      Entrada de calendário comercial que você está usando para determinar a data de início ou término do calendário comercial do trabalho agendado. Este campo será exibido somente se você selecionar Entrada de negócios: Data de início ou Entrada de negócios: Data de término em Tempo campo.
      Tipo de desvio
      Tipo de deslocamento de tempo, se houver, a ser aplicado ao calendário comercial selecionado para programar este trabalho:
      • Passado : Aplique um fator de deslocamento para programar a execução do trabalho antes do início do intervalo de tempo do calendário comercial selecionado.
      • Futuro : Aplique um fator de deslocamento para programar a execução do trabalho após o término do intervalo de tempo do calendário comercial selecionado.
      • --Nenhum-- : Não aplique um deslocamento de tempo ao programar este trabalho.
      A adição de um fator de deslocamento permite programar o trabalho para execução antes ou depois do período formal definido no calendário comercial para os seguintes casos de uso:
      Deslocamento
      Deslocamento de tempo, expresso em dias, horas, minutos e segundos, para aplicar ao calendário comercial selecionado para programar este trabalho. Por exemplo, se você quiser programar o trabalho para começar três dias, 14 horas, 10 minutos e 45 segundos antes da data de início do calendário comercial, execute as seguintes ações:
      • Selecione Passado em Tipo de deslocamento campo.
      • Entrar 3 em Dias campo.
      • Entrar 14 , 10 , e. 45 em Horas campo.
      . Dias de deslocamento e. Horas os campos serão exibidos somente se você selecionar Calendário comercial: Início da entrada ou Calendário comercial: Término da entrada em Executar campo, e. Passado ou Futuro em Tipo de deslocamento campo.
      Prioridade
      Prioridade numérica para o trabalho agendado:
      • Defina trabalhos essenciais com um valor de prioridade abaixo de 100.
      • Defina trabalhos não essenciais com uma prioridade acima de 100.
      • Se 70% ou mais de todos os trabalhos agendados forem Vencido , todos os trabalhos marcados com um valor acima de 100 não são executados.
      Condicional Quando habilitado, especifique uma condição com script para gerar o relatório.
      Omitir se não houver registros Quando habilitado, os relatórios vazios não são distribuídos.
      Condição Um script condicional que determina se um trabalho agendado deve ser executado. A última expressão do script deve ser avaliada como um valor booliano (verdadeiro/falso). Esta caixa de texto será exibida somente se você selecionar Condições de uso . Para obter mais informações sobre scripts no ServiceNow plataforma, consulte Scripts .
      Aviso:
      Scripts condicionais para e-mails agendados são executados na área restrita. Portanto, definições de função não são permitidas. Algumas chamadas de API e palavras-chave também não são permitidas. Para obter mais informações, consulte Propriedade da sandbox de script .
      Assunto Texto exibido na linha de assunto do e-mail de distribuição.
      Mensagem introdutória (Opcional) Adicione uma mensagem ao relatório.
      Se o tipo de saída do relatório for PNG incorporado,
      • Use o marcador (report:png) no corpo da mensagem para posicionar o relatório na mensagem. Caso contrário, o relatório aparecerá na parte inferior da mensagem.
      • Use o marcador (report:include_with) para posicionar outros relatórios incluídos no e-mail. Caso contrário, esses relatórios serão exibidos na parte inferior da mensagem.
      Tipo Tipo de saída do relatório. Os relatórios gráficos podem ser arquivos PNG ou PDF. Os relatórios de lista podem ser arquivos PDF, Excel ou CSV.

      Ao programar um relatório gráfico, selecione o tipo de saída PDF ou PDF-paisagem para incluir os dados da grade do gráfico. Ao programar um relatório de lista, selecione o tipo de saída Excel ou CSV .

      Selecione PNG incorporado para incorporar a visualização do relatório no corpo do e-mail. As imagens grandes são dimensionadas para se ajustarem ao e-mail.

      Para obter mais informações, consulte a seção Formatos de saída de relatório.

      Nota:
      Só é possível programar relatórios dinâmicos multinível na saída PDF.
      Saída em formato ZIP Quando selecionado, o relatório é enviado como um anexo de arquivo zip para o e-mail.
      Incluir com Um ou mais relatórios adicionais a serem incluídos no e-mail. Não é possível solicitar os relatórios no e-mail. Você pode usar o ícone Pesquisar Ícone de pesquisapara localizar os relatórios adicionais.
      Tamanho da página (somente relatório dinâmico multinível) Escolha entre os tamanhos A3, A4, Carta ou Ofício. Para especificar um tamanho de papel diferente, selecione Personalizado e insira Altura da página e. Largura da página em pixels.
      Altura da página (em pixels) (somente relatório dinâmico multinível) Mostra quando Tamanho da página está definido como Personalizado . Para tamanhos de papel não padrão, multiplique a altura da página em polegadas por 72 e insira o valor neste campo.
      Largura da página (em pixels) (somente relatório dinâmico multinível) Mostra quando Tamanho da página está definido como Personalizado . Para tamanhos de papel não padrão, multiplique a largura da página em polegadas por 72 e insira o valor neste campo.
    5. Selecione Enviar.

    O que Fazer Depois

    Para editar o e-mail programado de um trabalho de relatório, abra o trabalho na lista Trabalhos agendados. Para interromper e-mails agendados de um relatório, exclua a linha do trabalho relevante da lista Trabalhos agendados.