Présentation

Utilisez la page Reports (Rapports) pour ajouter, modifier, exécuter et supprimer les rapports automatisés, et pour accéder à la page Statistics (Statistiques).

Rapports

Les rapports permettent l'accès aux performances et aux données de statut de MOVEit Transfer. Un rapport est un jeu d'instructions pour exécuter une requête de données, formater les résultats et enregistrer le rapport résultant à un emplacement spécifique. Les rapports peuvent être créés sur la base des catégories et types intégrés, ou d'une catégorie personnalisée, qui permet aux administrateurs de saisir leurs propres paramètres de requête ou d'importer des rapports spécialisés. Pour plus d'informations sur la définition des rapports personnalisés, reportez-vous à la page Rapports personnalisés.

Ajouter ou modifier un rapport

Pour ajouter un rapport, sélectionnez la catégorie de rapport que vous souhaitez créer, et cliquez sur le bouton Continue (Continuer). Cela ouvre la page Add Report (Ajouter un rapport) (pour obtenir une liste des catégories de rapport, ainsi que des types de rapport disponibles dans chaque catégorie, reportez-vous à la page Types de rapport). Pour modifier un rapport existant, cliquez sur le nom du rapport dans la liste des rapports, ou cliquez sur le lien Edit (Modifier) associé au rapport.

Nom

Chaque rapport doit avoir un nom, qui sera répertorié dans la page Rapports. Le nom du nouveau rapport doit être choisi pour exprimer la catégorie et le type du rapport considéré. Les noms tels que « Total File Transfer Report » (Rapport de transfert de fichiers total) ou « Memory Usage for the Last Month » (Utilisation de la mémoire lors du mois dernier) sont de bons choix. Les noms tels que « Report 1 » (Rapport 1) ou « My Report » (Mon rapport) sont moins souhaitables. Le nom du rapport peut être modifié après sa création sans en affecter le fonctionnement.

Type de rapport

Le type de rapport à exécuter est sélectionné dans ce menu déroulant. Chaque catégorie de rapport propose plusieurs types de rapport au choix. La plupart des catégories de rapport disposent de Total reports (Rapports totaux), qui fournissent les informations agrégées, ainsi que des rapports By Month (Par mois), By Week (Par semaine) et By Day (Par jour), qui répartissent les informations agrégées selon les périodes sélectionnées. Une liste complète des catégories et types de rapport disponibles se trouve sur la page Types de rapport.

Format

Le format du rapport est sélectionné ici. Il définit la manière dont sont présentées les informations du rapport. Les formats disponibles sont :

• XML - Les informations sont présentées dans un document XML. Ce format se prête idéalement à un chargement dans des applications externes en vue d'un post-traitement. Le rapport respectera la structure suivante :

  <DMZReport>

  <ReportRow>

  <Column_Name>Valeur</Column_Name>

  ...

  </ReportRow>

</DMZReport>

• CSV - Les informations sont présentées dans un document texte aux valeurs séparées par une virgule. Ce format est idéal pour charger les informations dans des programmes de tableur tels que Excel. Lorsque ce format est sélectionné, deux options supplémentaires sont disponibles :
  • Séparateur de valeur - Ce caractère sera utilisé comme caractère délimiteur dans le rapport. Par défaut, il s'agit d'une virgule (,)
  • Identificateur de texte - Ce caractère sera utilisé pour délimiter chaque colonne et valeur. Laissez une chaîne vide pour n'utiliser aucun caractère identificateur. Par défaut, il s'agit de guillemets doubles (")
• HTML seul - Les informations sont présentées sous forme de fichier HTML au formatage très simple.
• HTML stylé - Les informations sont présentées sous forme de fichier HTML stylé respectant les règles de feuille de style de l'organisation. Ce format est idéal pour présenter le contenu du rapport d'une manière professionnelle.
  • Lorsque l'option Styled HTML Only (HTML stylé uniquement) est sélectionnée, cochez ou décochez-la pour afficher la requête SQL brute à la fin du rapport.

Run On Days (Exécuter certains jours)

Les rapports peuvent être planifiés pour être exécutés certains jours spécifiques de la semaine, ou certains jours du mois. Saisissez dans ce champ les jours auxquels exécuter les rapports, ou « All (Tous) » pour exécuter les rapports tous les jours. Les rapports planifiés seront exécutés lors de la tâche planifiée de nuit pour chaque jour configuré. Par défaut, cette tâche s'exécute à 1 h 00. Vous pouvez également laisser ce champ vide si vous ne souhaitez pas que les rapports soient exécutés automatiquement.

Pour mieux comprendre, voici quelques exemples de valeurs pouvant être saisies dans ce champ et comment ces valeurs seront interprétées.

• 1,2,5 - Exécution les premier, deuxième et cinquième jours du mois.
• Tue, Sat - Exécution chaque jeudi et samedi
• 3, 4, Wed - Exécution les troisième et quatrième jours du mois et chaque mercredi.
• 2, 4, Wed, All - Exécution tous les jours

Save In Folder (Enregistrer dans le dossier), Save As File (Enregistrer en tant fichier)

Ces champs déterminent où le rapport résultant sera enregistré. La valeur Save In Folder (Enregistrer dans le dossier) doit être un chemin d'accès de dossier MOVEit Transfer et sera l'emplacement d'enregistrement du rapport sur le système. La valeur n'est pas nécessairement un dossier existant, car MOVEit Transfer crée le dossier s'il n'existe pas. Les macros de date peuvent également être utilisées pour créer des dossiers spécifiques à des dates. Par exemple : « Distribution/Reports_[yyyy][mm] » enregistre les rapports dans un dossier nommé « Distribution/Reports_200510 » pendant le mois d'octobre de l'année 2005.

La valeur Save As File (Enregistrer en tant que fichier) définit le nom du fichier sous lequel le rapport sera enregistré. Comme pour la valeur Save In Folder (Enregistrer dans le dossier), les macros de date peuvent être utilisées pour créer des noms de fichier spécifiques à des dates. Par exemple : « Total_File_Transfers_[yyyy][mm][dd].txt » enregistre un rapport dans un fichier nommé « Total_File_Transfers_20051020.txt » le 20 octobre 2005.

Si l'option Overwrite Existing File (Écraser le fichier existant) est activée, le générateur de rapports tente de supprimer un fichier ayant le même nom que le nouveau rapport, si ce fichier existe. Cette option est particulièrement utile pour les rapports portant un nom statique, puisque des erreurs peuvent se produire si le dossier de destination n'est pas configuré pour permettre l'écrasement du fichier existant.

Paramètres de rapport

Le reste de la configuration d'un rapport consiste à définir les paramètres disponibles pour le type de rapport. Ces paramètres peuvent réduire le spectre du rapport, et peuvent également définir la production d'un rapport. Pour voir les paramètres disponibles pour chaque catégorie de rapport, reportez-vous à la page Types de rapport. Les paramètres disponibles sont :

• Start Date (Date de début) - Définit une date avant laquelle les données sont ignorées lors de la création d'un rapport. Utilisez ce paramètre avec le paramètre End Date (Date de fin) pour réduire la période couverte par un rapport. Ce paramètre peut accepter les macros de date. Les dates DOIVENT être saisies au format AAAA-MM-JJ (par exemple : « 2005-03-04 »).
• End Date (Date de fin) - Définit une date après laquelle les données sont ignorées lors de la création d'un rapport. Utilisez ce paramètre avec le paramètre Start Date (Date de début) pour réduire la période couverte par un rapport. Ce paramètre peut accepter les macros de date. Les dates DOIVENT être saisies au format AAAA-MM-JJ (par exemple : « 2005-03-04 »).
• Size Units (Unités de taille) - Définit les unités de taille d'un rapport (en octets) Les options disponibles sont : Kilooctets, Mégaoctets, Gigaoctets.
• Attempt Threshold (Seuil de tentatives) - Pour les rapports « Noms d'utilisateur suspects - Plusieurs tentatives » et « Adresses IP suspectes - Plusieurs tentatives » dans la catégorie Security (Sécurité), ce paramètre définit le nombre de tentatives infructueuses qu'un nom d'utilisateur ou qu'une adresse IP doit rencontrer pour être consigné dans ces rapports.
• Seuil IP - Pour le rapport « Noms d'utilisateur suspects - Plusieurs IP » dans la catégorie Security (Sécurité), ce paramètre définit le nombre de tentatives infructueuses qu'une adresse IP doit rencontrer pour être consignée dans ce rapport.
• Seuil de nom d'utilisateur - Pour le rapport « Adresses IP suspectes - Plusieurs noms d'utilisateur » dans la catégorie Security (Sécurité), ce paramètre définit le nombre de tentatives infructueuses qu'un nom d'utilisateur doit rencontrer pour être consigné dans ce rapport.

Macros de date et d'heure

Les macros de date et d'heure sont un moyen utile de définir des dates, des heures et des plages de date et d'heure par rapport à la date et à l'heure actuelles. Les six éléments de base des macros de date et d'heure sont :

• [YYYY] - Année (4 chiffres)
• [MM] - Mois (2 chiffres)
• [DD] - Jour (2 chiffres)
• [HH] - Heure (2 chiffres)
• [TT] - Minute (2 chiffres)
• [SS] - Seconde (2 chiffres)

Pour saisir des dates et heures relatives, les modificateurs plus (+) et moins (-) sont utilisés à l'intérieur des crochets des macros. Par exemple, « [DD-2] » signifie deux jours plus tôt. Les modificateurs de macro de date et d'heure affectent l'expression entière de la macro. Les exemples de ce comportement ci-dessous permettent de mieux l'expliquer.

• Nous sommes le 14 septembre 2005 « [YYYY]-[MM]-[DD-3] » sera interprété comme « 2005-09-11 »
• Nous sommes le 15 octobre 2005 « [YYYY]-[MM-1]-01 » sera interprété comme « 2005/09/01 »
• Nous sommes le 16 novembre 2005 « [YYYY+5]-[MM+3]-[DD] » sera interprété comme « 2011/02/16 »
• Nous sommes le 1 janvier 2006 « [YYYY]-[MM]-[DD-1] » sera interprété comme « 2005-12-31 »

ASTUCES de planification et de macro de date :

• Pour obtenir un rapport « fin-de-mois », planifiez un rapport qui va s'exécuter le « 1 » (premier jour du mois), définissez la Date de début sur « [YYYY]-[MM-1]-01 » et définissez la Date de fin sur « [YYYY]-[MM]-[DD-1] »
• Pour obtenir un rapport « fin-de-semaine » (se terminant le samedi), planifiez un rapport qui va s'exécuter le « Dimanche », définissez la Date de début sur « [YYYY]-[MM]-[DD-7] » et définissez la Date de fin sur « [YYYY]-[MM]-[DD-1] »
• Pour obtenir des rapports « quotidiens » qui traitent l'activité d'« hier », planifiez un rapport qui va s'exécuter sur « Tous », définissez la Date de début sur « [YYYY]-[MM]-[DD-1] » et définissez la Date de fin sur « [YYYY]-[MM]-[DD-1] »

Autres paramètres

Le reste de la configuration d'un rapport consiste à définir les paramètres disponibles pour le type de rapport. Ces paramètres peuvent réduire le spectre du rapport, et peuvent également définir la production d'un rapport. Pour voir les paramètres disponibles pour chaque catégorie de rapport, reportez-vous à la page Types de rapport. Les paramètres disponibles sont :

Exécution des rapports

Les rapports planifiés sont exécutés lors de la tâche planifiée de nuit pour chaque jour configuré dans le champ Run On Days (Exécuter certains jours). Cependant, les rapports peuvent également être exécutés manuellement à l'aide d'un des deux boutons de la section Run Report (Exécuter le rapport).

Cliquez sur le bouton « Run Report and Download (Exécuter le rapport et télécharger » provoque la création du rapport et son envoi direct vers le navigateur. À ce stade, le navigateur vous demande si vous souhaitez enregistrer ou ouvrir le fichier. Cliquer sur le bouton « Run Report and Save » (Exécuter le rapport et enregistrer) provoque la création et l'enregistrement comme pour les rapports planifiés, dans le dossier spécifié par la valeur Save in Folder (Enregistrer dans le fichier), avec le nom de fichier spécifié par la valeur Save As File (Enregistrer en tant que fichier).

De plus, un administrateur peut cliquer sur le lien Run (Exécuter) d'un rapport dans la liste de rapports sur la page principale des rapports. Ce lien entraîne la même action que le bouton « Run Report and Download » (Exécuter le rapport et télécharger) ci-avant.

Default Report Settings (Paramètres par défaut du rapport)

L'entrée Default Report Settings (Paramètres par défaut du rapport) existe afin d'éviter aux administrateurs de devoir saisir des informations de configuration similaires dans chaque rapport qu'ils ajoutent. Les informations de configuration saisies dans cette entrée du rapport sont automatiquement répercutées lors de l'ajout de nouveaux rapports. Par conséquent, les paramètres que ces rapports ont en commun (Format, planification, etc.) doivent être configurés ici.

Parce que l'entrée Default Report Settings (Paramètres par défaut du rapport) n'est pas un rapport réel, elle ne peut être ni exécutée ni supprimée. Cependant, la modification de l'entrée fonctionne comme la modification de tout autre rapport. Notez que ces modifications effectuées sur l'entrée Default Report Settings (Paramètres par défaut du rapport) ne s'applique PAS aux rapports existants mais aux nouveaux rapports uniquement.

Modifier le format HTML stylé

La mise en page des rapports au format HTML stylé est contrôlée par un fichier modèle appelé « reporttemplate.htm ». Une copie de ce fichier se trouve dans votre dossier « (webroot)\templates\en » (Par exemple : « d:\moveitdmz\wwwroot\templates\en ». Ne modifiez pas ce fichier, il sera écrasé à chaque mise à niveau. À la place, suivez l'une de ces deux procédures brèves :

Pour modifier le format HTML stylé pour toutes les organisations :

1. Créez un sous-dossier « templates\en » nommé « custom » s'il n'existe pas déjà.
2. Copiez « templates\en\reporttemplate.htm » dans le sous-dossier « templates\en\custom » s'il n'existe pas déjà ici.
3. Effectuez les modifications souhaitées dans « templates\en\custom\reporttemplate.htm ».

Pour modifier le format HTML stylé d'une organisation en particulier :

1. Créez un sous-dossier « templates\en » nommé « custom » s'il n'existe pas déjà.
2. Créez un sous-dossier « templates\en\custom » nommé d'après l'ID de l'organisation considérée si ce dossier n'existe pas déjà. (Par exemple, si l'organisation « Contractor » possède l'ID « 1234 », créez un sous-dossier nommé « 1234 ».)
3. Copiez « templates\en\reporttemplate.htm » dans le sous-dossier « templates\en\custom\[OrgID] » s'il n'existe pas déjà ici.
4. Effectuez les modifications souhaitées dans « templates\en\custom\[OrgID]\reporttemplate.htm ».

Notez que les modifications effectuées sur ce fichier s'appliquent immédiatement aux nouveaux rapports. Cependant, les modifications effectuées sur ce fichier n'affectent pas les rapports déjà créés. Si vous disposez de versions personnalisées de reporttemplate.htm dans le sous-dossier spécifique à une organisation et dans le sous-dossier principal « custom », la version spécifique à une organisation s'applique.

Macros utilisées dans « reporttemplate.htm »

Les macros suivantes peuvent être utilisées dans reporttemplate.htm.

• (Report Date Macros) - Par exemple, "[YYYY]-[MM]-[DD] [HH]:[TT]:[SS]" peut être interprété comme "2005-10-11 12:34:56"
• [InlineCSS] - Ceci sera remplacé par une copie en ligne de la feuille de style CSS de l'organisation (définie comme partie du schéma de l'organisation)
• [OrgName] - Nom de l'organisation.
• [ReportName] - Nom du rapport, tel que calculé à partir des sélections effectuées dans la liste déroulante des catégories de rapport et dans la liste déroulante des types de rapport au moment de la définition du rapport.
• [ReportTitle] - Nom de la définition du rapport, tel que saisi par le créateur.
• [Filter] - Description du filtre actuel (le cas échéant) utilisé avec le rapport.
• [ReportContent] - Sera remplacé par un <TABLE> contenant le contenu du rapport actuel.
• [ReportCreateMS] - Temps en millisecondes demandé par la génération du rapport.
• [OrgLogRetain] - Nombre de jours d'entrées du journal d'audit disponibles dans ce rapport.
• [SysStatRetain] - Nombre de jours de statistiques de performances disponibles dans ce rapport.
• [MachineName] - Nom de la machine sur laquelle a été créé ce rapport.
• [ReportSQL] - Déclaration(s) SQL exacte(s) utilisée(s) pour générer ce rapport.