Relatórios em rodízio
Com os ciclos, você pode gerar várias versões de um relatório dividido por dimensão, como ano ou região. Ciclos são adicionados ao configurar uma tarefa de relatório.
Os ciclos funcionam filtrando os dados incluídos em cada versão do relatório. A diferença entre um ciclo e um filtro de relatório é que, ao adicionar um ciclo, uma única execução da tarefa de relatório pode gerar mais de um relatório exclusivo para um único destinatário. Quando você adiciona um ciclo a uma tarefa de relatório, é gerado um relatório exclusivo para cada valor exclusivo na dimensão selecionada como o ciclo. Se você tiver mais de um campo de ciclo, obterá tantos relatórios quanto a combinação de todos os campos de ciclo.
Os ciclos interagem com os outros tipos de filtragem que podem ser aplicados durante a geração de relatórios. A ordem de avaliação é a seguinte:
-
Acesso à seção, se presente
-
Filtro de relatório em nível de tarefa, se houver
-
Filtro de relatório em nível do destinatário, se houver
-
Ciclos, se presentes
Exemplo
Por exemplo, você tem uma tarefa de relatório para enviar relatórios de vendas. A tarefa de relatório é configurada com as seguintes definições:
-
Nome do arquivo: SalesData
-
Ciclo nos campos País e Ano
-
Formato do carimbo de data/hora: aaaa-MM-dd_HH-mm
Seus dados abrangem três países e dois anos, portanto, seis relatórios são gerados e enviados:
-
SalesData_ Country1 _Year1 _2024-11-08_10-30.xlsx
-
SalesData_ Country1 _Year2 _2024-11-08_10-30.xlsx
-
SalesData_ Country2 _Year1 _2024-11-08_10-30.xlsx
-
SalesData_ Country2 _Year2 _11-08_10-30.xlsx
-
SalesData_ Country3 _Year1 _11-08_10-30.xlsx
-
SalesData_ Country3 _Year2 _11-08_10-30.xlsx
Depois de criados, os arquivos de saída são enviados para o destino como normalmente ocorreria. Os filtros de relatório e de acesso à seção ainda são aplicados como normalmente ocorreria.
Adicionando ciclos à tarefa do relatório
Para obter mais informações sobre a criação de uma tarefa de relatório, consulte Criando uma tarefa de relatório.
Faça o seguinte:
-
Crie uma tarefa de relatório e inicie o processo de configuração como você faria normalmente.
-
Depois de concluir a seção Modelo do diálogo, você chega a Saída.
-
Em Ciclo, use o menu suspenso para selecionar até três dimensões do aplicativo.
Nomes de arquivos de saída
Quando você adiciona um ciclo, o nome do valor da dimensão aplicado no ciclo é incluído nos nomes dos arquivos de relatório. Se um valor de dimensão aplicado no ciclo contiver caracteres especiais, eles serão substituídos por um caractere de sublinhado (_) no nome do arquivo.
Caracteres especiais incluem:
-
\ / < > : " ' ? *
-
Caracteres de controle ASCII
Tratando erros
Se ocorrer um erro em um ou mais relatórios de um ciclo, será gerado um arquivo vazio para cada relatório com falha. O nome de cada um desses arquivos tem o prefixo "FAILED_" e reflete a combinação de valores que terminou em erro.
Práticas recomendadas e limitações
Melhores práticas
Você não deve iniciar um ciclo de relatório para sua tarefa de relatório se as dimensões do relatório contiverem muitos valores ou contêineres de valores exclusivos. Por exemplo, se os dados abrangerem 10 anos, 196 países e 50 produtos, o ciclo de relatórios poderá gerar até 98.000 arquivos (consulte a barra abaixo para ver a restrição de tarefa exclusiva atual). Isso pode levar horas ou dias para ser gerado e pode consumir um grande volume de geração de relatórios para sua assinatura do Qlik Cloud.
Limitações
-
Você pode selecionar no máximo três campos para percorrer em uma tarefa de relatório.
-
Quando um ou mais ciclos são aplicados, uma tarefa de relatório pode gerar um máximo de 500 relatórios exclusivos. Quando nenhum ciclo é aplicado, a tarefa de relatório pode gerar um máximo de 100 relatórios exclusivos.
-
O tempo máximo de execução de uma tarefa de relatório com um ciclo aplicado é de quatro horas.
Para outras limitações que se aplicam aos relatórios no aplicativo, consulte Limites e limitações para a configuração de relatórios no aplicativo.