File d'attente des rapports

La page Report Queue liste les rapports que TrakIT a mis en file d’attente pour envoi, avec ce qu’il est advenu de chacun. Utilisez-la pour vérifier qu’un rapport est bien parti, pour voir pourquoi l’un d’eux a échoué, et pour trouver les rapports qui mettent longtemps à être générés.

Pour l’ouvrir, sélectionnez Reports > Queue.

Fonctionnement de la file d’attente

Chaque envoi de rapport passe par la file d’attente :

• les envois planifiés des abonnements aux rapports de workflow, des abonnements aux rapports avancés et des rapports de requête, que TrakIT ajoute à la file d’attente quand ils sont dus ;
• les rapports que quelqu’un envoie avec Send Now, par exemple sur un rapport de requête ;
• les rapports récupérés par l’API TrakIT, avec QueryReport ou AdvReport, qui sont listés pour mémoire.

Chaque minute, TrakIT prend les rapports en attente, du plus ancien au plus récent, génère chacun d’eux et l’envoie. Si l’envoi échoue, TrakIT réessaie immédiatement, jusqu’à 5 tentatives au total. Certains échecs l’arrêtent tout de suite, et l’élément est marqué comme ignoré : par exemple No recipients to send to, ou un rapport qui n’est plus actif. Pour savoir quand les rapports sont mis dans la file d’attente et pourquoi l’un d’eux n’est pas envoyé, voir Ce qui se passe à l’heure prévue.

Les éléments de la file d’attente de plus de six mois environ sont supprimés.

Trouver des éléments de la file d’attente

1. Sélectionnez Filters pour ouvrir le panneau des filtres, s’il est fermé.
2. Saisissez ou sélectionnez les filtres dont vous avez besoin.
3. Sélectionnez Search.

Le nombre de résultats apparaît au-dessus de la liste, sous la forme Queue Items. Reset efface les filtres. Les filtres sont effacés chaque fois que vous ouvrez la page.

Filtre	Trouve
Report Type	Customer Report, User Report, Advanced Report ou Query Report, ou – Any Type –.
Report Name	Toute partie du nom du rapport.
Entity/Title	Toute partie du client ou de l’entité, ou du titre de l’abonnement.
Delay Exceeding	Les éléments envoyés au moins 5 min, 10 min, 20 min ou 30 min après leur mise en file d’attente.
With Errors Only	Les éléments en erreur.

La liste

La liste affiche 20 éléments par page, les plus récents en premier.

Colonne	Affiche
Queued	Le moment où l’élément a été ajouté à la file d’attente, dans votre fuseau horaire.
Report Type	Customer Report ou User Report pour un abonnement client ou utilisateur d’un rapport de workflow, Advanced Report pour un abonnement à un rapport avancé, ou Query Report.
Report Name	Le rapport.
Entity/Title	Le client d’un abonnement client ; le titre d’un abonnement utilisateur ou d’un abonnement à un rapport avancé, avec l’entité quand il est envoyé par entité. Vide pour les rapports de requête.
Delivery By	Email, FTP ou API Post ; API Call pour un rapport récupéré par l’API.
Attempts	Le nombre de fois où TrakIT a essayé de l’envoyer. Il s’arrête à 5.
Sent	Le moment où il a été envoyé, dans votre fuseau horaire.
Rows	Le nombre de lignes du rapport.
Delay (min)	Les minutes écoulées entre la mise en file d’attente et l’envoi.
Duration (sec)	Les secondes nécessaires pour le générer et l’envoyer, lors de la dernière tentative.
Error	La raison de l’échec de la dernière tentative, par exemple Nothing to export quand un rapport de requête n’a renvoyé aucune ligne.

Les éléments envoyés sont en vert. Les éléments en erreur, ou ignorés, sont en rouge.

La page s’actualise d’elle-même toutes les 10 minutes : Refresh in affiche le compte à rebours, et affiche Paused tant que la fenêtre du navigateur n’est pas au premier plan. Sélectionnez-le pour actualiser tout de suite.

Ignorer ou remettre en file d’attente un élément

Les administrateurs système voient une icône au bout de chaque élément qui n’a pas encore été envoyé et qui a fait l’objet de moins de 5 tentatives :

• Skip Report (l’icône moins) empêche TrakIT de l’envoyer.
• Re-Queue Report (l’icône de flèches), sur un élément ignoré, le remet dans la file d’attente.

Exporter la file d’attente

Sélectionnez Export pour télécharger sous forme de fichier Excel les éléments qui correspondent aux filtres, dans la limite des 1 000 premiers. Le fichier a les mêmes colonnes que la liste, avec Report Source pour le type de rapport et Delivery Mode pour le mode de livraison. S’il n’y a aucun résultat, TrakIT affiche Nothing to export! Please check filters….

Rapports longs à générer

Chaque dimanche, les administrateurs système reçoivent un e-mail Long Running Reports qui liste les rapports de la semaine écoulée dont la génération a pris plus d’une minute, afin que leurs filtres puissent être resserrés ou leurs champs réduits.

Qui peut utiliser cette page

Section	Autorisation	Vous permet de
Report Queue	Read	Ouvrir la page et exporter la file d’attente.

Les administrateurs système voient tous les éléments. Les autres utilisateurs voient les éléments des rapports de workflow de leurs propres workflows, et des rapports avancés et de requête dont ils sont propriétaires ou auxquels ils ont reçu un accès utilisateur ; l’export contient les mêmes éléments.

Seuls les administrateurs système peuvent ignorer des éléments et les remettre en file d’attente. La même autorisation ouvre la page Récapitulatif des abonnements.