Utilisation de tâches de rapport
En tant que développeur de rapports, vous pouvez créer des configurations pour la génération centralisée de rapports à l'aide de tâches de rapport. Créez et gérez des tâches de rapport dans l'onglet Tâches de rapport de la section Génération de rapports d'une application.
Une tâche de rapport convertit le modèle de rapport en sortie de rapport. La tâche peut être exécutée manuellement ou en fonction d'une planification.
Une tâche de rapport est le lieu où les blocs de construction d'un rapport – les modèles, les filtres et la liste de distribution – sont rassemblés pour générer la sortie. Lorsque vous créez une tâche de rapport, vous définissez également les noms de fichier du rapport, les utilisateurs et les groupes qui reçoivent la sortie, les détails des e-mails ou du dossier de sortie et la planification de la génération des rapports.
L'onglet Tâches de rapport de la section Génération de rapports d'une application
Grâce aux filtres de rapport, vous pouvez utiliser une seule tâche de rapport pour administrer et employer un scénario de distribution de rapports en rafale. La diffusion en rafale vous permet de générer des rapports contenant des informations variées avec différents sous-jeux de données pour différentes parties destinataires. Pour plus d'informations, consultez Génération de rapports en rafale via les filtres de rapport.
Fonctionnement de la génération de rapports
Vous devez définir une liste de distribution pour l'application avant de pouvoir créer des tâches de rapport.
Dans une tâche de rapport, vous sélectionnez les destinataires et les groupes de votre liste de distribution pour lesquels vous souhaitez générer des rapports. Lors de l'ajout de destinataires en tant que récepteurs de la sortie de tâche, vous ajoutez le destinataire sous forme de paire utilisateur-filtre correspondant à un seul filtre au niveau du destinataire qui lui a été appliqué dans la liste de distribution. Vous ne pouvez pas combiner plusieurs filtres au niveau du destinataire dans le même rapport utilisateur ; en revanche, vous pouvez ajouter chaque paire utilisateur-filtre individuellement dans la configuration de la tâche afin de générer un rapport distinct et de l'envoyer au même utilisateur pour chaque filtre.
Lors de l'exécution d'une tâche de rapport, un rapport unique est généré pour chaque filtre distinct au niveau du destinataire appliqué à tous les utilisateurs ajoutés à la tâche de rapport.
Une tâche de rapport peut générer un maximum de 500 rapports uniques. Cette limite est évaluée pour tous les modèles ajoutés à la tâche, et non par modèle de tâche. Cette limite s'applique également à toutes les tâches de rapport, qu'un ou que plusieurs cycles soient appliqués ou non.
Vous pouvez décider d'envoyer les rapports générés par e-mail et/ou de les stocker dans un dossier Microsoft SharePoint. Lorsque vous distribuez des rapports via un dossier de distribution Microsoft SharePoint, les rapports ne sont pas envoyés directement aux destinataires et un rapport distinct est stocké pour chaque filtre défini sur les destinataires inclus dans la tâche. Pour des informations plus détaillées, voir Génération de rapports avec des dossiers de distribution.
Conditions pour l'envoi par e-mail
Pour envoyer la sortie d'une tâche de rapport par e-mail, activez le commutateur E-mail sous Distribuer dans la boîte de dialogue lors de la création de la tâche de rapport.
Si vous envoyez les rapports par e-mail, il faut qu'un fournisseur de messagerie soit configuré pour le client Qlik Cloud. Pour des instructions sur cette configuration, consultez Configuration de la messagerie pour les rapports et les notifications.
Conditions de stockage des rapports dans des dossiers Microsoft SharePoint
Si vous devez enregistrer automatiquement les rapports générés dans un dossier sur votre réseau Microsoft SharePoint, activez le commutateur Dossier sous Distribuer dans la boîte de dialogue lors de la création de la tâche de rapport.
Pour stocker la sortie du rapport dans un dossier Microsoft SharePoint, vous devez établir une connexion au connecteur Office 365 Sharepoint dans l'espace. Pour plus d'informations, consultez Envoi de rapports à un dossier de distribution.
Création d'une tâche de rapport
Pour créer une configuration de rapport basée sur des tâches, suivez les sections ci-dessous dans l'ordre.
1re partie : Créez la tâche
Procédez comme suit :
-
Ouvrez l'onglet Tâches de rapport de la section Génération de rapports de l'application Qlik Sense.
-
Cliquez sur Créer une tâche de rapport. La boîte de dialogue Tâche de rapport s'ouvre.
-
Saisissez un Titre pour la tâche de rapport.
-
Ajoutez éventuellement une Description.
Partie 2 : Sélectionnez un ou plusieurs modèles
Ensuite, vous devez définir les modèles.
Procédez comme suit :
-
Dans l'onglet de la boîte de dialogue Modèle, cliquez sur Ajouter un modèle existant. Sélectionnez un modèle que vous avez déjà créé.
Sinon, cliquez sur Charger nouveau si vous n'avez pas encore ajouté le modèle à utiliser.
-
Si vous le souhaitez, vous pouvez ajouter des modèles supplémentaires à la tâche en suivant la procédure indiquée à la première étape.
Vous pouvez ajouter jusqu'à cinq instances de modèle de rapport à une tâche de rapport, y compris des copies du même modèle. Par exemple, si vous ajoutez deux fois un modèle Excel à une tâche, l'un avec une sortie .xlsx et l'autre avec une sortie PDF, cela compte comme deux modèles ajoutés à la tâche.
-
Cliquez sur Suivant. La boîte de dialogue passe à l'onglet Sortie.
Partie 3 : Configurez la sortie
Ensuite, configurez la sortie. La sortie est configurée séparément pour chaque instance de modèle que vous ajoutez à la tâche. La sortie comprend :
-
Définissez les propriétés des rapports générés.
-
La définition de la localisation des éléments des rapports (uniquement pour la sortie PDF). Les utilisateurs qui ouvrent un rapport au format Excel verront le formatage régional (dates, nombres et autres informations) conformément à leurs paramètres Excel.
Appliquez un filtre au niveau des tâches.
Application de cycles.
Procédez comme suit :
-
Dans l'onglet de la boîte de dialogue Sortie, développez une instance de modèle que vous avez ajoutée.
-
Saisissez un Nom de fichier pour la sortie du rapport. Cela est utilisé dans le nom de fichier des rapports, ainsi qu'avec le cycle et le Format d'horodatage.
Note InformationsLes caractères spéciaux ne sont pas autorisés dans le Nom de fichier que vous saisissez ici. En outre, les espaces vides avant et après le Nom de fichier que vous avez saisi sont retirés.
-
Si vous avez sélectionné la sortie PDF, définissez les Paramètres de format régional pour le PDF. Ce paramètre contrôle le format régional des dates, nombres et autres informations dans les rapports.
Si vous devez effectuer d'autres configurations pour préparer votre PDF ou votre sortie imprimée, revenez à la création de modèle.
-
Vous pouvez éventuellement sélectionner un Filtre à appliquer aux rapports.
Ce filtre s'applique à tous les rapports générés à partir de l'instance de modèle, contrairement aux filtres que vous ajoutez aux destinataires individuels. Pour plus d'informations sur les interactions mutuelles des filtres au niveau de la tâche et au niveau du destinataire, consultez Utilisation de filtres dans des rapports.
-
Sous Cycle, sélectionnez jusqu'à trois dimensions à utiliser comme cycles. L'ajout de cycles génère une version unique des rapports pour chaque valeur unique de la dimension. Pour plus d'informations, consultez Cycles de rapports.
-
Sélectionnez un format d'horodatage. Cela est utilisé dans les noms de fichier des rapports, ainsi qu'avec le cycle et le Nom de fichier.
-
Répétez la procédure ci-dessus pour toutes les autres instances de modèle que vous avez ajoutées à la tâche.
-
Cliquez sur Nouveau pour passer à l'onglet de la boîte de dialogue Distribuer.
Partie 4 : Configurez la distribution
Vous devriez maintenant vous trouver dans l'onglet Distribuer de la boîte de dialogue.
Procédez comme suit :
-
Ajoutez les destinataires et groupes de la liste de distribution qui recevront la sortie du rapport. Notez qu'un destinataire distinct doit être ajouté pour chaque filtre au niveau du destinataire pour lequel vous souhaitez générer des rapports. Consultez Fonctionnement de la génération de rapports.
-
Indiquez le mode de distribution et d'envoi des rapports. Activez au moins l'une des options suivantes :
-
Pour distribuer vos rapports par e-mail, laissez l'option E-mail activée. Il s'agit de la méthode de distribution par défaut.
Pour les modèles Excel et PixelPerfect de la tâche, les rapports seront inclus sous forme de pièces jointes à l'e-mail. Pour les modèles HTML de la tâche, vous pouvez choisir de joindre les rapports sous forme de fichiers et/ou d'intégrer un rapport dans l'e-mail lui-même. Pour plus d'informations, consultez Intégration d contenu d'un rapport dans un e-mail.
-
Pour distribuer vos rapports dans un dossier Microsoft SharePoint, activez le commutateur Dossier.
Pour des informations spécifiques sur la configuration des options de distribution par e-mail et dans un dossier, voir Conditions pour l'envoi par e-mail et Conditions de stockage des rapports dans des dossiers Microsoft SharePoint.
-
-
Renseignez les champs obligatoires pour une sortie par E-mail et/ou dans un Dossier selon les besoins.
-
Cliquez sur Suivant pour passer à l'onglet de boîte de dialogue Planification.
5e partie : Planifiez la distribution des rapports
Procédez comme suit :
-
Dans l'onglet de la boîte de dialogue Planification, configurez la planification de la distribution des rapports. Les rapports peuvent être envoyés chaque fois que les données sont actualisées ou en fonction d'une planification quotidienne, hebdomadaire, mensuelle ou annuelle.
-
Cliquez sur Enregistrer.
Votre rapport sera envoyé aux destinataires de votre choix au moment planifié. Vous pouvez également envoyer la sortie de la tâche de rapport à tout moment. Consultez Envoi manuel des rapports.
Envoi manuel des rapports
Vous pouvez exécuter une tâche de rapport manuellement lorsque vous avez besoin que les destinataires reçoivent immédiatement les rapports.
Cela s'avère également utile lorsque vous testez la configuration de vos rapports.
Procédez comme suit :
-
Ouvrez l'onglet Tâches de rapport de la section Génération de rapports d'une application.
-
Cliquez sur
à côté de la tâche de rapport à exécuter. -
Cliquez sur
Envoyer maintenant.
Conditions pour l'exécution correcte d'une tâche de rapport
L'auteur du modèle de rapport crée un modèle basé sur son accès au contenu de l'application. En revanche, une tâche de rapport s'exécute en fonction de l'accès à l'application du propriétaire de la tâche de rapport. Par conséquent, si un utilisateur crée un modèle basé sur une feuille d'application qui lui est réservée (privée), la tâche de rapport ne peut pas s'exécuter correctement.
Il existe également des conditions à respecter relatives au propriétaire de la tâche de rapport. Pour plus d'informations, consultez Propriétaires des tâches de rapport.
Édition de tâches de rapport
Vous pouvez modifier la configuration de la tâche de rapport une fois qu'elle a été créée.
Procédez comme suit :
-
Ouvrez l'onglet Tâches de rapport de la section Génération de rapports d'une application.
-
Cliquez sur
à côté de la tâche de rapport. -
Cliquez sur
Modifier.
Suppression d'une tâche de rapport
Procédez comme suit :
-
Ouvrez l'onglet Tâches de rapport de la section Génération de rapports d'une application.
-
Cliquez sur
à côté de la tâche de rapport à supprimer. -
Cliquez sur
Supprimer.
Les administrateurs de clients peuvent supprimer et gérer des tâches de rapport dans la section Abonnements du centre d'activités Administration. Consultez Administration de la génération de rapports et des abonnements.
Activation ou désactivation d'une tâche de rapport
Il est possible d'activer ou de désactiver une tâche. Lorsqu'elle est activée, la tâche de rapport génère une sortie en fonction de la planification configurée et peut être exécutée manuellement, si nécessaire. Lorsqu'elle est désactivée, la tâche de rapport ne peut pas générer de sortie en fonction de la planification, mais elle peut tout de même être exécutée manuellement, si nécessaire.
Vous pouvez souhaiter activer ou désactiver la tâche de rapport manuellement. Dans certaines situations, une tâche de rapport sera également automatiquement désactivée.
Procédez comme suit :
-
Ouvrez l'onglet Tâches de rapport de la section Génération de rapports d'une application.
-
Cliquez sur
à côté de la tâche de rapport à activer ou désactiver. -
Cliquez sur
Activer ou sur 
Désactiver.
Si vous êtes administrateur de clients, vous pouvez activer et désactiver la tâche de rapport dans la section Abonnements du centre d'activités Administration. Pour plus d'informations, consultez Administration de la génération de rapports et des abonnements.
Annulation d'une tâche de rapport en cours d'exécution
Il peut arriver qu'une tâche de rapport soit en cours d'exécution, mais que vous deviez l'annuler. Par exemple, en cas d'erreur de serveur ou lorsqu'une tâche prend trop de temps.
Procédez comme suit :
-
Ouvrez l'onglet Tâches de rapport de la section Génération de rapports d'une application.
-
Cliquez sur
à côté de la tâche de rapport à annuler. -
Cliquez sur
Annuler.
Affichage de l'historique d'exécution d'une tâche de rapport
Vous pouvez consulter l'historique d'exécution de la tâche de rapport. Utilisez la vue Historique pour afficher plus d'informations sur les erreurs qui ont pu se produire lors de l'exécution de la tâche.
Procédez comme suit :
-
Dans une application, ouvrez la section Rapports.
-
Dans l'onglet Tâches de rapport, cliquez sur
à côté d'une tâche de rapport. -
Sélectionnez
Historique.
Pour plus d'informations, consultez Affichage de l'historique d'exécution des tâches de rapport.
Configuration de plusieurs sorties pour le même modèle
Vous pouvez ajouter jusqu'à cinq instances de modèle de rapport à une tâche de rapport, y compris des copies du même modèle. Par exemple, si vous ajoutez deux fois un modèle Excel à une tâche, l'un avec une sortie .xlsx et l'autre avec une sortie PDF, cela compte comme deux modèles ajoutés à la tâche.
Vous trouverez ci-dessous des cas d'utilisation courants d'ajout à plusieurs reprises du même modèle à une même tâche de rapport :
-
Génération de rapports dans deux formats de fichier différents, par exemple, une copie .xlsx et une copie PDF d'un même rapport.
-
Intégration du rapport dans le corps d'un e-mail, mais également inclusion d'une copie HTML du même rapport sous forme de pièce jointe à l'e-mail.
-
Génération de rapports avec deux paramètres de localisation différents.
Pour obtenir cette sortie à partir du même modèle, ajoutez-la deux fois (ou plus) à la tâche de rapport.
Procédez comme suit :
-
Dans l'onglet de la boîte de dialogue Modèle lors de la configuration d'une tâche de rapport, sélectionnez le modèle à utiliser ou cliquez sur Charger nouveau pour le charger.
-
Après avoir ajouté la première instance de modèle, cliquez sur Ajouter un modèle existant.
-
Sélectionnez de nouveau le même modèle.
-
Cliquez sur Suivant.
-
Dans les paramètres de Sortie, définissez un Nom de fichier différent pour chaque instance de modèle. Cela est nécessaire pour faire la distinction entre les rapports générés.
-
Terminez la configuration de la tâche de rapport.
Considérations relatives à Accès de section
Si l'application utilise Accès de section, la génération de rapports fonctionne différemment. Pour plus d'informations, voir Rapports dans l'application et Accès de section.
Propriétaires des tâches de rapport
Lorsque vous créez une tâche de rapport, vous en devenez le propriétaire. Les administrateurs peuvent modifier le propriétaire d'une tâche de rapport. Pour plus d'informations, consultez Administration de la génération de rapports et des abonnements. Dans un espace partagé, pour transférer l'appartenance d'une tâche de rapport à un autre utilisateur, ce dernier doit être titulaire d'autorisations d'Accès en écriture dans l'espace.
Toute personne titulaire d'un Accès en écriture dans l'espace peut exécuter une tâche de rapport, mais, si le propriétaire de la tâche de rapport n'est pas titulaire d'un Accès en écriture dans l'espace, la tâche de rapport ne peut pas s'exécuter correctement. Par conséquent, si un utilisateur propriétaire d'une tâche de rapport perd son Accès en écriture ou s'il est retiré de l'espace ou du client, la tâche de rapport doit changer de propriétaire ou être recréée par une personne titulaire d'autorisations suffisantes.
N'oubliez pas que si vous modifiez le propriétaire d'une tâche de rapport d'une application qui utilise Accès de section, vous devez vous attendre à certains comportements. Pour plus d'informations, consultez Rapports dans l'application et Accès de section.
Propriétaires des filtres de rapport et des tâches de rapport
Les filtres de rapport ont également leurs propres propriétaires. Le créateur d'un filtre de rapport est le premier propriétaire du filtre. Le changement de propriétaire d'une tâche de rapport ne change pas le propriétaire des filtres de rapport utilisés par la tâche de rapport.
Autorisations relatives aux tâches de rapport
La gestion des tâches de rapport d'une application nécessite des rôles spécifiques. Les conditions des autorisations varient suivant le type d'espace dans laquelle se trouve l'application.
Pour pouvoir utiliser des tâches de rapport pour une application, vous devez remplir les conditions suivantes :
-
Autorisations qui vous sont affectées par un administrateur de clients. Pour plus d'informations, un administrateur peut consulter Définition des autorisations pour les fonctions de génération de rapports mesurées.
-
Pour plus d'informations sur les autorisations d'espace pour la génération de rapports, consultez Autorisations Service Reporting Qlik.
Autorisations d'espace
La gestion des tâches de rapport pour une application nécessite des rôles d'espace spécifiques. Les conditions requises dépendent du type d'espace dans lequel se trouve l'application.
Conditions relatives aux applications dans des espaces partagés
Vous devez être titulaire d'un Accès en écriture dans l'espace pour pouvoir effectuer les actions suivantes sur une tâche de rapport depuis l'application :
-
Visualisation
-
Créer
-
Exécuter
-
Supprimer
-
Activer
-
Désactiver
Pour plus d'informations, consultez Gestion des autorisations dans les espaces partagés.
Conditions relatives aux applications dans des espaces gérés
Les utilisateurs titulaires des rôles d'espace Propriétaire (droit Professional, Full User ou Analyzer), Peut gérer (droit Professional, Full User ou Analyzer) ou Peut utiliser (Droit Professional ou Full User uniquement) dans l'espace géré peuvent effectuer les opérations suivantes sur une tâche de rapport depuis l'application :
-
Visualisation
-
Créer
-
Exécuter
-
Supprimer
-
Activer
-
Désactiver
Pour plus d'informations, consultez Gestion des autorisations dans les espaces gérés.
Conditions relatives à un application dans votre espace personnel
Vous devez être titulaire du rôle utilisateur Private Analytics Content Creator dans le client pour pouvoir afficher, créer, modifier et supprimer des tâches de rapport.
Administration de tâches de rapport dans le centre d'activités Administration
En tant qu'administrateur, vous gérez les tâches de rapport dans la section Abonnements du centre d'activités Administration. Consultez Administration de la génération de rapports et des abonnements.