Scorrimento ciclico dei report

Con i cicli, è possibile generare più versioni di un report suddivise per dimensione, come l'anno o l'area geografica. I cicli vengono aggiunti quando si configura un'attività di report.

I cicli funzionano filtrando i dati inclusi in ogni versione del report. La differenza tra un ciclo e un filtro del report è che aggiungendo un ciclo, una singola esecuzione dell'attività di report può generare più di un report univoco per un singolo destinatario. Quando si aggiunge un ciclo a un'attività di report, viene generato un report univoco per ogni valore unico nella dimensione selezionato come ciclo. Se si dispone di più di un campo per il ciclo, si otterrà un numero di report pari alla combinazione di tutti i campi del ciclo.

I cicli interagiscono con gli altri tipi di filtri che possono essere applicati durante la generazione dei report. L'ordine di valutazione è il seguente:

1. Section Access, se presente

2. Filtro del report a livello di attività, se presente

3. Filtro del report a livello di destinatario, se presente

4. Cicli, se presenti

Esempio

Ad esempio, si dispone di un'attività di report per inviare i report sulle vendite. L'attività di report è configurata con le seguenti impostazioni:

• Nome file: SalesData

• Ciclo per i campi Paese e Anno

• Formato timestamp: aaaa-MM-gg_HH-mm

I dati a disposizione riguardano tre Paesi e due anni, quindi vengono generati e inviati sei report:

• 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

Una volta creati, i file di output vengono inviati alla destinazione come avviene normalmente. I filtri dei report e l'applicazione di filtri per l'accesso alle sezioni vengono comunque applicati come di consueto.

Aggiunta di cicli all'attività di report

Per ulteriori informazioni sulla creazione di un'attività di report, vedere Creazione di un'attività di report.

Procedere come indicato di seguito:

1. Creare un'attività di report e iniziare il processo di configurazione come si farebbe di solito.

2. Dopo aver completato la sezione Modello nella finestra di dialogo, si accede a Output.

3. In Ciclo, utilizzare il menu a discesa per selezionare fino a tre dimensioni dall'app.

Nomi dei file di output

Quando si aggiunge un ciclo, il nome del valore di dimensione applicato nel ciclo viene incluso nei nomi dei file di report. Se un valore di dimensione applicato nel ciclo contiene caratteri speciali, questi vengono sostituiti con un carattere di sottolineatura (_) nel nome del file.

I caratteri speciali includono:

• \ / < > : " ' ? *

• Caratteri di controllo ASCII

Gestione degli errori

Se si verifica un errore per uno o più report in un ciclo, viene generato un file vuoto per ogni report non riuscito. Il nome di ciascuno di questi file ha il prefisso "FAILED_" e riflette la combinazione di valori che si è conclusa con un errore.

Procedure consigliate e limitazioni

Procedure consigliate

Non si dovrebbe avviare un ciclo di report per le attività di report se le dimensioni del report contengono molti valori o combinazioni di valori univoci. Ad esempio, se i dati riguardano un periodo di 10 anni, 196 Paesi e 50 prodotti, l'esecuzione dei report in cicli può potenzialmente generare fino a 98.000 file (vedere il limite qui sotto per il vincolo unico dell'attività corrente). L'operazione di generazione può richiedere ore o giorni, e potrebbe consumare un grande volume di report per la sottoscrizione di Qlik Cloud.

Limiti

• È possibile selezionare un massimo di tre campi da eseguire in ciclo per un'attività di report.

• Quando vengono applicati uno o più cicli, un'attività di report può generare un massimo di 500 report univoci. Quando non viene applicato alcun ciclo, l'attività di report può generare un massimo di 100 report univoci.

• Il tempo massimo di esecuzione di un'attività di report con un ciclo applicato è di quattro ore.

Per altre limitazioni che si applicano ai report in-app, consultare Limiti e limitazioni per la configurazione dei report in-app.