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

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 10 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 reports.

    Por Que e Quando Desempenhar Esta Tarefa

    Os relatórios programados podem ser distribuídos nos formatos 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 programados 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 com.snc.whtp estiver 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 apareçam, um usuário ativo deve recriar o relatório programado.

    Procedimento

    1. Navegar até Todos > Definição do Sistema > Trabalhos programados.
    2. Clique em Nova.
    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 programado.
      Relatório Referência ao relatório que você está programando. Você pode usar o ícone de pesquisa para 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 programadas. Os usuários devem ter a Notificação definida como Habilitada em seus registros de usuário para receber relatórios.
      Grupos Grupos que recebem o relatório na data e hora programadas.
      Endereços de e-mail Endereços de e-mail dos destinatários do relatório que não estão no sistema.
      Aplicação Nome da aplicação com escopo que contém o relatório. Global será exibido se o relatório estiver no escopo global.
      Ativo Quando ativos, os relatórios programados são entregues.
      Executar
      Intervalo de tempo a ser usado para executar o trabalho programado:
      • Diariamente: é executado diariamente, em um horário designado.
      • Semanalmente: é executado semanalmente, em um horário e dia da semana designados.
      • Mensalmente: é 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 iniciais do calendário comercial selecionado no campo Calendário comercial. Um trabalho programado é executado para a data de início de cada uma das entradas de negócios que você definiu para o calendário de negócios.

        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 programado será executado no primeiro dia de cada mês.

      • Calendário comercial: fim da entrada: executado na data de término do calendário comercial selecionado no campo Calendário comercial. Essa seleção é executada da mesma maneira que Calendário comercial: início da entrada, mas para as datas de término das entradas do calendário comercial associadas.
        Nota:
        Ao selecionar Calendário comercial: início da entrada ou Calendário comercial: fim da entrada, você pode aplicar um fator de deslocamento para programar o trabalho para ser executado antes ou depois do período do calendário comercial selecionado. Para saber mais, consulte os campos Tipo de deslocamento e Deslocamento.

        Para saber mais sobre como criar e usar calendários de negócios e definir entradas de calendário de negócios, consulte Criação de calendários de negócios eDefinir entradas do calendário comercial.

      Fuso horário
      Fuso horário a ser usado com a entrada do campo Hora ao especificar a hora em que o trabalho programado 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 programado.

        Por exemplo, o trabalho programado será executado às 16h45, horário dos EUA/Pacífico, se for o fuso horário atribuído ao usuário e você inserir 16:45 no campo Hora.

      • Usar 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 programado será executado às 22h15, horário de Londres, se Europa/Londres for o fuso horário do sistema padrão para a instância e você inserir 22:15 no campo Hora.

      • Fuso horário real.

        Por exemplo, o trabalho programado será executado às 13h30 no fuso horário Leste dos EUA se você selecionar EUA/Lestee inserir 13:30 no campo Hora.

      Hora Hora em que o trabalho programado deve ser executado, expressa em horas, minutos e segundos em um relógio de 24 horas. A seleção feita no campo Fuso horário determina o fuso horário desta entrada.
      Dia
      Dia em que o trabalho programado deve ser executado.
      • Se Executar estiver definido como Semanalmente, selecione o dia da semana. Por exemplo, selecione Quarta-feira.
      • Se Executar estiver definido como Mensalmente, selecione o dia do mês. Por exemplo, selecione 25 para o 25º dia do mês.
      Este campo aparecerá somente se você selecionar Mensalmente ou Semanalmente no campo Executar.
      Intervalo de repetição
      Duração do intervalo de repetição para cada execução de trabalho programada. Insira a duração em número de dias, horas ou minutos. Por exemplo:
      • Para executar o trabalho programado a cada quatro dias, insira 04 no campo Dias.
      • Para executá-lo a cada 26 horas, insira 26 no campo Horas.
      • Se ele se repetir em um intervalo de 13:30:25, insira 13 no campo Horas e insira 30 e 25 nos dois campos sem rótulo após ele.
      Iniciando Data e hora da primeira geração de trabalho programada. Selecione a data e a hora do calendário. Este campo aparecerá somente se você selecionar Periodicamente no campo Executar.
      Calendário comercial

      Entrada de calendário de negócios que você está usando para determinar a data de início ou de término do calendário de negócios do trabalho programado. Este campo será exibido somente se você selecionar Entrada do negócio: data de início ou Entrada do negócio: data de término no campo Hora.

      Tipo de desvio
      Tipo de deslocamento de tempo, se houver, a ser aplicado ao calendário de negócios que você selecionou para programar este trabalho:
      • Passado: aplique um fator de deslocamento para programar o trabalho para ser executado antes do início do período do calendário comercial selecionado.
      • Futuro: aplique um fator de deslocamento para programar o trabalho para ser executado após o fim do período do calendário comercial selecionado.
      • --Nenhum--: não aplique uma compensação de tempo ao programar este trabalho.
      Adicionar um fator de deslocamento permite programar o trabalho para ser executado antes ou após o período formal definido no calendário comercial para os seguintes casos de uso:
      Deslocamento
      Quantidade de deslocamento de tempo, expressa em dias, horas, minutos e segundos, a ser aplicada ao calendário de negócios que você selecionou para programar este trabalho. Por exemplo, se você quiser programar o trabalho para iniciar 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 no campo Tipo de deslocamento.
      • Insira 3 no campo Dias.
      • Insira 14, 10e 45 no campo Horas.
      Os campos Dias e Horas deslocados serão exibidos somente se você selecionar Calendário comercial: início da entrada ou Calendário comercial: fim da entrada no campo Executar e Passado ou Futuro no campo Tipo de deslocamento.
      Prioridade
      Prioridade numérica para o trabalho programado:
      • Defina trabalhos essenciais com um valor de prioridade abaixo de 100.
      • Defina trabalhos não essenciais com uma prioridade acima de 100.
      • Se 70 por cento ou mais de todos os trabalhos programados estiverem Atrasados, todos os trabalhos marcados com um valor acima de 100 não serão executados.
      Condicional Quando ativado, especifica uma condição de script para gerar o relatório.
      Omitir se não houver registros Quando ativado, os relatórios vazios não são distribuídos.
      Condição Script condicional que determina se um trabalho programado deve ser executado. A última expressão do script deve ser avaliada como um valor booliano (verdadeiro/falso). Esta caixa de texto aparecerá somente se você selecionar Usar condições. Para obter mais informações sobre scripts na plataforma ServiceNow, consulte Scripts.
      Aviso:
      Scripts condicionais para e-mails de relatório programados são executados na área restrita. Portanto, as 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 área restrita 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 com o e-mail. Caso contrário, esses relatórios serão exibidos na parte inferior da mensagem.
      Tipo

      Tipo de saída de 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. Imagens grandes são dimensionadas para caber no e-mail.

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

      Nota:
      Só é possível programar relatórios dinâmicos multinível na saída de PDF.
      Saída em formato zip Quando ativado, 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 com o e-mail. Não é possível solicitar os relatórios no e-mail. Você pode usar o ícone Pesquisar para localizar os relatórios adicionais.
      Tamanho da página (somente relatório dinâmico de vários níveis) Selecione um dos tamanhos A3, A4, Carta ou Legal. Para especificar as dimensões de um tamanho de papel diferente, selecione Personalizado e insira a Altura da página e a Largura da página em pixels.
      Altura da página (em pixels) (somente relatório dinâmico de vários níveis) Mostra quando o 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 de vários níveis) Mostra quando o 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. Clique em Enviar.

    O que Fazer Depois

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

    Tipos de saída de relatório

    Você pode exportar relatórios em determinados formatos de saída. Você pode programar esses relatórios para exportação regular.

    Tabela 1. Formatos de saída do relatório
    Formato de relatório Descrição
    PDF Gere um PDF na orientação vertical ou horizontal. Os relatórios em PDF incluem os dados da grade do gráfico. Os relatórios de mapa não podem ser exportados para o formato PDF.
    Nota:
    Para exportar Multilevel pivot tables para PDF, você deve habilitar o plug-in WebKit HTML to PDF (com.snc.whtp).
    Excel A visualização do relatório é exibida como uma planilha do Microsoft Excel (XLS).
    PNG A visualização do relatório é exibida como um arquivo PNG (Portable Network Graphic). Veja também como incorporar relatórios como imagens em um e-mail de relatório programado.
    CSV A visualização do relatório é exibida como um arquivo de texto sem formatação de valores separados por vírgula (CSV).

    E-mails de relatório e usuário "Executar como"

    Se você estiver em uma instância separada por domínio, os relatórios programados serão gerados usando as permissões do usuário "Executar como".

    Por padrão, o usuário que configura o relatório de e-mail programado é o usuário "Executar como". O acesso ao domínio deste usuário e as permissões de ACL report_view se aplicam ao gerar os relatórios programados.

    Se o usuário que configurou o relatório programado não for um usuário "Executar como" apropriado, um administrador ou report_admin poderá especificar um usuário "Executar como" diferente.

    Aviso:
    O usuário "Executar como" requer a permissão de ACL report_view apropriada para programar o relatório. Também pode haver um risco de segurança na definição deste usuário. Considere consultar Suporte e atendimento ao cliente ao definir o usuário "Executar como".