2.4 Programando relatórios

2.4.1 Programando e executando um relatório

É possível configurar a tarefa, quando executá-la e com que frequência ela será executada.

  1. Na Home page, clique em View Reports (Ver Relatórios), ou em Ver > Repositório.

  2. Clique o botão direito do mouse no nome do relatório e selecione Programar.

  3. Clique em Schedule Job (Programar Tarefa) para exibir o painel Programador.

  4. No campo Nome da Tarefa, especifique um nome para a tarefa. Por exemplo, Relatório Semanal. A descrição é opcional.

  5. Defina os seguintes atributos de programação:

    • Iniciar Tarefa: Escolha uma destas opções:

      • Imediatamente: Iniciar a tarefa assim que você a concluir.

      • Em (uma Data Específica): Iniciar a tarefa em uma data futura. Clique no ícone de calendário e selecione a data e o horário de início futuros. Para definir o horário de execução da tarefa, na parte inferior do calendário, clique nas horas e nos minutos.

    • Fuso Horário: Especifique o fuso horário para a programação. O padrão é o fuso horário do servidor que você informou ao efetuar login. Se você estiver em um fuso horário diferente, defina esse campo de acordo.

    • Repetição: Escolha uma das seguintes configurações:

      • Nenhuma: Executar o relatório uma vez.

      • Simples: Repetir a tarefa por hora, por dia ou por semana.

      • Calendário: Repetir a tarefa em dias da semana ou do mês.

        Se você selecionar Simples ou Calendário, outros campos serão exibidos. Para obter mais informações, consulte a Seção 2.4.4, Opções simples e de calendário.

  6. Clique em Save.

  7. (Condicional) Se o relatório que você estiver programando tiver entradas de controle, será solicitada a entrada.

    Se houver valores Gravados, eles serão exibidos em uma lista suspensa na parte superior do painel Set the Parameter Values (Definir Valores de Parâmetro). Na lista suspensa Use saved values (Usar valores gravados), é possível definir os controles de entrada especificados para o relatório que você está programando. É possível definir os valores de entrada do relatório programado e clicar em Save Current Values (Gravar Valores Atuais) para gravá-los.

  8. Escolha um conjunto de valores gravados ou defina os controles de entrada e clique em Gravar.

  9. Defina opções de saída no painel Configurações de Saída.

    Para obter mais informações, consulte a Seção 2.4.2, Opções de saída.

  10. Clique em Save.

    A tarefa aparece na lista de Tarefas Programadas, conforme mostrado na Etapa 2.

  11. Clique em Executar Agora para executar o relatório em segundo plano.

2.4.2 Opções de saída

No painel Output Details (Detalhes de Saída), você pode mudar as configurações de saída. Você deve primeiro configurar a tarefa e, em seguida, as opções de saída.

Para obter informações, consulte a Seção 2.4.1, Programando e executando um relatório.

No painel Output Details (Detalhes de Saída), é possível mudar estas configurações:

  • Nome do Arquivo de Saída Base: Especifique um nome para o arquivo de Tarefa.

  • Descrição da Saída: (Opcional) Especifique uma descrição para o arquivo de Tarefa.

  • Formato de Saída: Selecione o formato de gravação do arquivo de Tarefa. Quando você seleciona mais de um formato, cada formato é armazenado como um arquivo separado no repositório e anexado como um arquivo separado à notificação por e-mail.

  • Idioma de Saída: Selecione as configurações de idioma para gerar o relatório.

    O relatório deve suportar idiomas. Por exemplo, um relatório com base em um domínio com bundles de idiomas.

  • Para: Especifique os endereços de e-mail para as notificações por e-mail.

  • Assunto: Especifique um assunto para a notificação por e-mail.

  • Mensagem: Especifique a mensagem da notificação por e-mail.

  • Anexar Arquivos: Selecione essa opção para enviar a saída do relatório com a notificação por e-mail.

  • Ignorar Relatórios Vazios: Selecione para impedir que o servidor anexe arquivos de saída de relatórios vazios às notificações por e-mail quando houver falha na execução dos relatórios.

  • Localização da Saída: Navegue até a pasta na qual deseja gravar o relatório. Você deve ter permissão de gravação na pasta.

  • Nomes de Arquivos Sequenciais: Selecione essa opção para anexar marcação de horário aos nomes dos arquivos criados pela tarefa. Isso é útil para a saída de tarefas recorrentes ou para relatórios urgentes que precisam de data específica para a saída. Quando a marcação de horário é usada, a saída do nome de arquivo é <nomebase>-<marcaçãodehorário>.<extensão>.

  • Padrão de Marcação de Horário: Um padrão opcional para a marcação de horário. Os padrões válidos dos arquivos de saída de relatório só podem incluir letras, números, traços, sublinhados e pontos. O padrão é yyyyMMddHHmm. Por exemplo, 201307030601.

  • Sobregravar Arquivos: Selecione essa opção para sobregravar os arquivos de saída antigos pelos novos. Isso é útil quando você não tem nomes de arquivos sequenciais ou quando você especifica um padrão de marcação de horário que possa gerar nomes de arquivos idênticos.

2.4.3 Vendo a lista de tarefas programadas

As tarefas programadas são exibidas no painel Repositório com o ícone . Os usuários podem ver as tarefas que eles definiram; os administradores podem ver as tarefas definidas por todos os usuários.

  1. Na Home page, clique em View Reports (Ver Relatórios).

  2. Clique o botão direito do mouse no relatório e selecione Programar.

    A lista de tarefas programadas é exibida.

O painel Trabalhos agendados mostra o ID da tarefa, o proprietário que a criou e o status dela. Veja a seguir os status da tarefa:

  • Normal: A tarefa foi programada.

  • Executando: O servidor está gerando o relatório.

  • Concluído: O servidor terminou de executar a tarefa e gravou o arquivo de saída no repositório.

  • Erro: O programador encontrou um erro ao programar ou acionar a tarefa. Isso não inclui casos em que a tarefa é acionada com êxito, mas ocorre um erro durante a sua execução.

  • Desconhecido: O programador encontrou um erro com a tarefa acionada.

O painel Trabalhos agendados inclui as seguintes opções:

  • Editar: É possível editar a tarefa programada e gravar as mudanças.

  • Remover: É possível apagar a tarefa programada.

    Quando o servidor recebe uma solicitação para apagar uma tarefa em execução, ele termina de executar a tarefa antes de apagá-la.

É possível executar as seguintes tarefas no painel Trabalhos agendados:

  • Clique em Voltar para retornar à lista de relatórios.

  • Clique em Schedule Job (Programar Tarefa) para definir uma nova tarefa.

  • Clique em Executar Agora para executar o relatório em segundo plano, enquanto você continua trabalhando no servidor.

  • Clique em Atualizar Lista para ver as tarefas mais recentes.

2.4.4 Opções simples e de calendário

Para executar relatórios automaticamente em intervalos regulares, selecione as repetições simples ou de calendário na página Set Up the Job (Configurar Tarefa):

  • Uma repetição Simples executa regularmente a tarefa em um intervalo por hora, por dia ou por semana. Se você usar a Repetição simples, o tempo de execução do relatório mudar se o servidor for reiniciado.

  • A repetição de Calendário envolve mais configurações: horário do dia, dias da semana ou dias do mês e meses do ano. Se você usar a Repetição de calendário, o relatório será executado simultaneamente, mesmo se o servidor for reiniciado.

As opções de repetição simples são:

  • Repetir a cada: Define o intervalo entre as tarefas em minutos, horas, dias ou semanas.

  • Run Indefinitely (Executar Indefinidamente): Executa a tarefa até você a apagar.

  • Run a set number of times (Executar um número de vezes definido): Executa a tarefa quantas vezes forem especificadas.

  • Run until a specified date (Executar até determinada data): Executa a tarefa até atingir a data especificada. Clique em para selecionar a data.

  • Feriados: Um calendário de feriados que especifica uma lista dos dias em que o relatório programado não será executado. É possível selecionar apenas um calendário de feriados por vez.

As opções de repetição de calendário são:

  • Meses: Os meses de execução do relatório.

  • Dias: Os dias de execução do relatório:

    • Todos os Dias

    • Dias da Semana

    • Dias do Mês: Digite as datas ou faixa de datas separadas por vírgulas. Por exemplo: 1, 15.

  • Horários: O horário do dia, em minutos e horas, para execução da tarefa. O formato usado é 24 horas.

    Você também pode inserir vários minutos ou horas, e faixas, separados por vírgulas. Por exemplo, se você especificar 0, 15, 30 e 45 para os minutos, e 9-17 para as horas, o relatório será executado a cada 15 minutos, das 9:00 às 17:45. Insira um asterisco (*) para executar a tarefa a cada minuto ou a cada hora.

  • Recur Until (Repetir Até): A repetição de Calendário é executada até atingir a data especificada. Clique em para selecionar a data.

  • Feriados: Um calendário de feriados que especifica uma lista dos dias em que o relatório programado não será executado. É possível selecionar apenas um calendário de feriados por vez.

2.4.5 Executando uma tarefa em segundo plano

A execução de uma tarefa em segundo plano gera um relatório, possivelmente sem afetar o desempenho do servidor. Após o término da tarefa, você poderá exportar o relatório diretamente em qualquer formato e gravá-lo no repositório. É possível compartilhar um relatório com outras pessoas enviando o relatório gerado por e-mail.

A execução de uma tarefa em segundo plano equivale a programar o relatório para execução imediata.

  1. Na Home page, clique em View Reports (Ver Relatórios).

  2. Clique o botão direito do mouse no relatório e selecione Run in Background (Executar em Segundo Plano).

    Se o relatório que estiver executando tiver controles de entrada ou filtros, você terá de inserir as entradas.

  3. Escolha um conjunto de valores gravados ou defina os campos um de cada vez, depois clique em Avançar.

  4. No painel Setting Output Options (Configurando Opções de Saída), especifique os detalhes e clique em Enviar. Para saber as opções de saída, consulte a Seção 2.4.2, Opções de saída.

  5. Clique em Save.

    O relatório é executado imediatamente.