2.4 Planification des rapports

Les informations contenues dans les sections suivantes vous aident à planifier des rapports :

2.4.1 Planification et exécution d'un rapport

Vous pouvez configurer le travail, le moment où il s'exécute, ainsi que la fréquence d'exécution.

Sur la page d'accueil, cliquez sur View Reports (Afficher des rapports) ou cliquez sur View > Repository (Afficher > Espace de stockage).
Cliquez sur le nom du rapport avec le bouton droit de la souris, puis sélectionnez Schedule (Planifier).
Cliquez sur Schedule Job (Planifier le travail) pour afficher le panneau Planificateur.
Attribuez un nom au travail dans le champ Nom du travail ; Rapport hebdomadaire, par exemple. La description est facultative.
Définissez les attributs de planification suivants :
- Démarrer le travail : sélectionnez l'une des options suivantes :
  - Immédiatement : le travail démarre dès que vous l'avez terminé.
  - On Specific Date (À une date spécifique) : le travail démarre à une date ultérieure. Cliquez sur l'icône d'agenda , et sélectionnez la date et l'heure d'exécution. Pour régler l'heure d'exécution du travail, cliquez sur les heures et les minutes au bas de l'agenda.
- Fuseau horaire : indiquez le fuseau horaire dans le cadre de la planification. Le fuseau horaire par défaut est celui du serveur, que vous avez indiqué au moment de la connexion. Configurez ce champ en fonction du fuseau horaire dans lequel vous vous trouvez.
- Récurrence : sélectionnez l'un des paramètres suivants :
  - Aucune : exécutez le rapport une seule fois.
  - Simple : répétez l'exécution toutes les heures, tous les jours ou toutes les semaines.
  - Calendaire : répétez l'exécution certains jours de la semaine ou du mois.
    
    Si vous sélectionnez Simple ou Calendaire, d'autres champs sont affichés. Pour plus d'informations, reportez-vous à la section Section 2.4.4, Options Simple et Agenda.
Cliquez sur Enregistrer.
(Conditionnel) Si le rapport en cours de planification comporte des contrôles d'entrée, vous êtes invité à saisir l'entrée.

Si des valeurs enregistrées sont présentes, elles s'affichent une liste déroulante en haut du panneau Set the Parameter Values (Définir les valeurs des paramètres). Dans la liste déroulante Use saved values (Utiliser des valeurs enregistrées), vous pouvez configurer les contrôles d'entrée définis pour le rapport en cours de planification. Vous pouvez définir les valeurs d'entrée pour le rapport planifié, puis cliquer sur Save Current Values (Enregistrer les valeurs en cours) pour les enregistrer.
Choisissez un ensemble de valeurs enregistrées, ou définissez les contrôles d'entrée, puis cliquez sur Save (Enregistrer).
Définissez les options de sortie dans le panneau Output Settings (Paramètres de sortie).

Pour plus d'informations, reportez-vous à la section Section 2.4.2, Options de sortie.
Cliquez sur Enregistrer.

Le travail s'affiche dans la liste des travaux planifiés, comme illustré à l'Étape 2.
Cliquez sur Run Now (Exécuter maintenant) pour exécuter le rapport en arrière-plan.

2.4.2 Options de sortie

Vous pouvez modifier les paramètres de sortie dans le panneau Output Details (Détails de sortie). Vous devez configurer le travail, puis les options de sortie.

Pour plus d'informations, reportez-vous à la section Section 2.4.1, Planification et exécution d'un rapport.

Vous pouvez modifier les paramètres suivants sur le panneau Output Details (Détails de sortie).

Base Output File Name (Nom du fichier de sortie de base) : attribuez un nom au fichier de travail.
Output Description (Description de la sortie) : (facultatif) indiquez une description pour le fichier de travail.
Output Format (Format de sortie) : sélectionnez le format dans lequel vous souhaitez enregistrer le fichier de travail. Si vous sélectionnez plusieurs formats, chacun d'eux est enregistré sous la forme d'un fichier distinct dans l'espace de stockage et annexé à l'e-mail de notification en tant que pièce jointe distincte.
Output Locale (Paramètres régionaux de sortie) : sélectionnez les paramètres régionaux pour la génération du rapport.

Le rapport doit prendre en charge les paramètres régionaux ; un rapport basé sur un domaine avec des ensembles linguistiques, par exemple.
À : indiquez les adresses électroniques de destination des notifications.
Subject (Objet) : indiquez l'objet de la notification par e-mail.
Message : indiquez le message de la notification par e-mail.
Attach Files (Joindre des fichiers) : sélectionnez cette option pour envoyer les résultats du rapport avec la notification électronique.
Skip Empty Reports (Ignorer les rapports vides) : sélectionnez cette option pour empêcher le serveur de joindre des fichiers de sortie de rapport vides à des notifications par e-mail, en cas d'échec d'exécution du rapport.
Output Location (Emplacement de sortie) : accédez au dossier dans lequel vous souhaitez enregistrer le rapport. Vous devez disposer de l'autorisation en écriture sur le dossier.
Sequential File Names (Noms de fichiers séquentiels) : sélectionnez cette option pour ajouter un tampon horaire aux noms des fichiers créés par le travail. Cela se révèle particulièrement utile pour la sortie des travaux récurrents ou pour les rapports dont les résultats doivent être datés. En cas d'utilisation du tampon horaire, la sortie du nom de fichier se présente sous la forme <nom_base>-<tampon_horaire>.<extension>.
Modèle de tampon horaire (Timestamp Pattern) : modèle facultatif pour le tampon horaire. Dans le cas des fichiers de sortie de rapport, les modèles valides ne peuvent contenir que des lettres, des chiffres, des tirets, des traits de soulignement et des points. Le modèle par défaut est aaaaMMjjHHmm. Par exemple, 201307030601.
Overwrite Files (Écraser les fichiers) : sélectionnez cette option pour remplacer les anciens fichiers de sortie par de nouveaux. Cette option est utile en l'absence de noms de fichiers séquentiels ou lorsque vous spécifiez un modèle de tampon horaire susceptible de générer des noms de fichiers identiques.

2.4.3 Consultation de la liste des travaux planifiés

Les travaux planifiés apparaissent dans le panneau Repository (Espace de stockage) avec l'icône . Les utilisateurs peuvent visualiser les travaux qu'ils ont définis, tandis que les administrateurs peuvent voir ceux qui ont été définis par l'ensemble des utilisateurs.

Cliquez sur View Reports (Afficher les rapports) sur la page d'accueil.
Cliquez sur le rapport avec le bouton droit de la souris, puis sélectionnez Schedule (Planifier).

La liste des travaux planifiés s'affiche.

Le panneau Travaux planifiés affiche l'identifiant (ID) du travail, le nom de son créateur et son état. Un travail peut présenter l'un des états suivants :

Normal : le travail est planifié.
Running : le serveur procède actuellement à la génération du rapport.
Terminé : le serveur a terminé l'exécution du travail et a placé le fichier de sortie dans l'espace de stockage.
Erreur : le planificateur a rencontré une erreur lors de la planification ou du déclenchement du travail. Cela ne tient pas compte des cas où le travail a été déclenché, mais où une erreur s'est produite en cours d'exécution.
Inconnu : le planificateur a rencontré une erreur avec le travail déclenché.

Le panneau Travaux planifiés comprend les options suivantes :

Modifier : vous pouvez modifier le travail planifié et enregistrer les modifications.
Supprimer : vous pouvez supprimer le travail planifié.

Lorsque le serveur reçoit une demande de suppression d'un travail en cours d'exécution, il attend la fin de l'exécution avant de le supprimer.

Vous pouvez effectuer les tâches suivantes à partir du panneau Travaux planifiés :

Cliquer sur Back (Précédent) pour revenir à la liste des rapports.
Cliquez sur Schedule Job (Planifier le travail) pour définir un nouveau travail.
Cliquez sur Run Now (Exécuter maintenant) pour exécuter le rapport en arrière-plan, tout en continuant à travailler sur le serveur.
Cliquez sur Rafraîchir la liste pour afficher les travaux les plus récents.

2.4.4 Options Simple et Agenda

Pour exécuter des rapports automatiquement et régulièrement, sélectionnez les options de périodicité Simple ou Calendar (Agenda) sur la page Set Up the Job (Configurer le travail) :

L'option Simple exécute le travail toutes les heures, tous les jours ou toutes les semaines. Si vous utilisez l'option Simple recurrence (Périodicité simple), l'exécution du rapport peut changer si le serveur est redémarré.
L'option Calendar (Agenda) propose davantage de paramètres : heure du jour, jours de la semaine, jours du mois et mois de l'année. Si vous utilisez l'option Calendar recurrence (Périodicité du calendrier), le rapport s'exécute au même moment, même si le serveur est redémarré.

Dans le cas d'une périodicité Simple, les options sont les suivantes :

Repeat every (Répéter tous les) : définit l'intervalle entre les travaux en minutes, heures, jours ou semaines.
Run Indefinitely (Exécuter indéfiniment) : exécute le travail jusqu'à ce que vous le supprimiez.
Run a set number of times (Exécuter un nombre défini de fois) : exécute le travail un nombre spécifié de fois.
Run until a specified date (Exécuter jusqu'à une date spécifiée) : exécute un travail jusqu'à ce que la date spécifiée soit atteinte. Cliquez sur l'icône pour sélectionner la date.
Holidays (Vacances) : un agenda des vacances spécifie une liste de jours lors desquels le rapport programmé ne sera pas exécuté. Un seul agenda des vacances peut être sélectionné à la fois.

Dans le cas d'une périodicité d'agenda, les options sont les suivantes :

Months (Mois) : mois au cours desquels le rapport est exécuté.
Days (Jours) : jours au cours desquels le rapport est exécuté.
- Every Day (Tous les jours)
- Week Days (Jours de la semaine)
- Month Days (Jours du mois) : entrez des dates ou des plages de dates, séparées par des virgules. Par exemple : 1, 15.
Times (Fois) : heure du jour, en heures et en minutes, à laquelle le travail doit s'exécuter. Le format 24 heures est utilisé.

Vous pouvez également saisir plusieurs minutes ou heures, et des plages de valeurs, séparées par des virgules. Par exemple, si vous indiquez 0, 15, 30 et 45 pour les minutes et 9-17 pour les heures, le rapport s'exécutera toutes les 15 minutes entre 9h00 et 17h45. Entrez un astérisque (*) pour exécuter le travail toutes les minutes ou toutes les heures.
Recur Until (Répéter jusqu'au) : la périodicité de l'agenda s'exécute jusqu'à la date spécifiée. Cliquez sur l'icône pour sélectionner la date.
Holidays (Vacances) : un agenda des vacances spécifie une liste de jours lors desquels le rapport programmé ne sera pas exécuté. Un seul agenda des vacances peut être sélectionné à la fois.

2.4.5 Exécution d'un travail en arrière-plan

L'exécution d'un travail en arrière-plan génère un rapport, sans nécessairement affecter les performances du serveur. Une fois le travail terminé, vous pouvez exporter directement le rapport dans le format de votre choix et l'enregistrer dans l'espace de stockage. Vous pouvez partager un rapport avec d'autres personnes en envoyant la copie générée par courrier électronique.

Exécuter un travail en arrière-plan équivaut à planifier son exécution immédiate.

Cliquez sur View Reports (Afficher les rapports) sur la page d'accueil.
Cliquez sur le rapport avec le bouton droit de la souris, puis sélectionnez Run in Background (Exécuter en arrière-plan).

Si le rapport en cours d'exécution comporte des filtres ou des contrôles d'entrée, vous êtes invité à saisir les entrées.
Sélectionnez un ensemble de valeurs enregistrées ou définissez les champs un à un, puis cliquez sur Suivant.
Dans le panneau Setting Output Options (Définition des options de sortie), indiquez les informations requises, puis cliquez sur Soumettre. Pour plus d'informations sur les options de sortie, reportez-vous à la section Section 2.4.2, Options de sortie.
Cliquez sur Enregistrer.

Le rapport s'exécute immédiatement.