Cycles de rapports

Avec les cycles, vous pouvez générer plusieurs versions d'un rapport ventilées par dimension, comme l'année ou la région. Les cycles sont ajoutés lors de la configuration d'une tâche de rapport.

Les cycles fonctionnent en filtrant les données incluses dans chaque version du rapport. La différence entre un cycle et un filtre de rapport réside dans le fait qu'en ajoutant un cycle, une seule exécution de la tâche de rapport peut générer plus d'un rapport unique pour un seul destinataire. Lorsque vous ajoutez un cycle à une tâche de rapport, un rapport unique est généré pour chaque valeur unique de la dimension que vous sélectionnez comme cycle. Si vous avez plus d'un champ de cycle, vous obtiendrez autant de rapports que la combinaison de tous les champs de cycle.

Les cycles interagissent avec les autres types de filtrage qui peuvent être appliqués lors de la génération de rapports. L'ordre d'évaluation est le suivant :

1. Accès de section, le cas échéant

2. Filtre de rapport au niveau de la tâche, le cas échéant

3. Filtre de rapport au niveau du destinataire, le cas échéant

4. Cycles, le cas échéant

Exemple

Par exemple, vous avez une tâche de rapport permettant d'envoyer des rapports de vente. La tâche de rapport est configurée avec les paramètres suivants :

• Nom de fichier : SalesData

• Cycle sur les champs Country et Year

• Format d'horodatage : yyyy-MM-dd_HH-mm

Vos données couvrent trois pays et deux années, si bien que six rapports sont générés et envoyés :

• 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

Une fois créés, les fichiers de sortie sont envoyés à leur destination comme ils le seraient normalement. Les filtres de rapport et le filtrage Accès de section sont toujours appliqués comme ils le sont habituellement.

Ajout de cycles à votre tâche de rapport

Pour plus d'informations sur la création d'une tâche de rapport, consultez Création d'une tâche de rapport.

Procédez comme suit :

1. Créez une tâche de rapport et commencez le processus de configuration comme vous le feriez habituellement.

2. Après avoir complété la section Modèle de la boîte de dialogue, vous accédez à Sortie.

3. Sous Cycle, utilisez le menu déroulant pour sélectionner jusqu'à trois dimensions de l'application.

Noms de fichier de sortie

Lorsque vous ajoutez un cycle, le nom de la valeur de dimension appliquée dans le cycle est inclus dans les noms de fichier de rapport. Si une valeur de dimension appliquée dans le cycle contient des caractères spéciaux, ils sont remplacés par un trait de soulignement (_) dans le nom de fichier.

Les caractères spéciaux incluent les caractères suivants :

• \ / < > : " ' ? *

• Caractères de commande ASCII

Gestion des erreurs

Si une erreur se produit pour une ou plusieurs rapports dans un cycle, un fichier vide est généré pour chaque rapport en échec. Le nom de chacun de ces fichiers est précédé du préfixe FAILED_ et reflète la combinaison de valeurs qui s'est soldée par une erreur.

Bonnes pratiques et limitations

Bonnes pratiques

Vous ne devez pas lancer un cycle de rapport vers votre tâche de rapport si les dimensions de votre rapport contiennent de nombreuses valeurs ou des combinaisons de valeurs uniques. Par exemple, si vos données couvrent 10 ans, 196 pays et 50 produits, le cyclage des rapports pourrait potentiellement générer jusqu'à 98 000 fichiers (consultez le garde-fou ci-dessous pour la contrainte actuelle en matière de tâches uniques). La génération de ces rapports pourrait prendre des heures, voire des jours, et consommer un volume important de génération de rapports dans votre abonnement Qlik Cloud.

Limitations

• Vous pouvez sélectionner un maximum de trois champs à parcourir pour une tâche de rapport.

• Lorsque un ou plusieurs cycles sont appliqués, une tâche de rapport peut générer un maximum de 500 rapports uniques. Lorsqu'aucun cycle n'est appliqué, la tâche de rapport peut générer un maximum de 100 rapports uniques.

• La durée d'exécution maximale d'une tâche de rapport avec un cycle appliqué est de quatre heures.

Pour connaître les autres limitations qui s'appliquent à la génération de rapports dans l'application, consultez Limites et limitations de la configuration de rapports dans l'application.