Pour utiliser les informations d'exécution, les rapports de jobs et les transferts de fichiers dans un système de gestion des documents, il faut structurer ces données. Les administrateurs peuvent utiliser Automation Engine pour extraire les entrées consignées pour chaque exécution soit via l'utilitaire AE DB Archive, soit directement dans la table de base de données XRO qui prend en charge vos programmes auto-développés.
Cette rubrique contient les sujets suivants :
Important !
- Pour accéder à la table de la base de données XRO, vous devez activer le paramètre XRO_REPORTS dans la variable UC_CLIENT_SETTINGS - Divers paramètres du client.
- Supprimez les entrées XRO régulièrement des tables afin de réduire la quantité de données croissante de la base de données.
Lister les rapports
Pour lister toutes les exécutions pas encore archivées, lancez l'utilitaire AE DB Archive à partir de la ligne de commande, en utilisant la syntaxe ci-dessous. Le résultat apparaît dans un fichier CSV :
UCYBDBAR -B -Xlist -Sclient/-Dclient [-Ochemin et nom de fichier] [-Ystatut]
- Si vous ne spécifiez pas de chemin, le fichier est uc_XROlist.csv est créé dans le même dossier que l'utilitaire. Le contenu du fichier est le même que celui de la table de base de données XRO. L'utilitaire interrompt la procédure si un fichier du même nom existe déjà.
- Pour n'afficher que les entrées de table d'un certain statut, utilisez le paramètre de démarrage -Y. Dans ce cas, seulles les lignes ayant le statut spécifié sont exportées (colonne XRO_CusStatus). Vous pouvez définir cette valeur (nombre) et l'appliquer lors du déchargement du rapport.
Décharger les rapports
Pour exporter des rapports vers des fichiers texte, lancez l'utilitaire AE DB Archive à partir de la ligne de commande, en utilisant la syntaxe suivante :
UCYBDBAR -B -Xunload -Sclient/-Dclient -RrunID de la tâche [-TYtype de rapport] [-Ochemin et nom de fichier] [-Ystatut]
- Pour décharger un rapport spécifique, définissez le RunID de la tâche et le type de rapport.
- Pour décharger tous les rapports d'une exécution spécifique, ne définissez que le RunID.
- Pour décharger les rapports à partir d'un client spécifique, l'utilisateur du compte Windows doit avoir exactement le même nom dans Automation Engine.
- Si vous ne spécifiez pas de chemin, le fichier uc_XROlist.csv est créé dans le même dossier que l'utilitaire. Ce fichier texte contient le contenu du rapport. L'utilitaire interrompt la procédure si un fichier du même nom existe déjà.
- Pour définir un statut de rapport, utilisez le paramètre de démarrage -Y. Définissez un nombre de votre choix et saisissez-le dans la colonne XRO_CusStatus. Vous pouvez votre liste de rapports avec cette valeur.
Remarques :
- Le déchargement d'un rapport ne supprime pas les entrées du rapport dans la table XRO.
- La ligne de commande ne permet pas de décharger les rapports d'utilisateurs spécifiques.
Supprimer les entrées de table
Lancez l'utilitaire AE DB Archive à partir de la ligne de commande, en utilisant la syntaxe suivante, afin de signaler les rapports comme archivés. Ce faisant, leurs entrées sont supprimées de la table de base de données XRO :
UCYBDBAR -B Xmark -Sclient/-Dclient -RRunID de la tâche [-TYtype de rapport]
(Optionnel) Utilisez l'utilitaire AE DB Reorg. Si les rapports sont réorganisés, la table XRO est automatiquement incluse dans le processus.
Structure de la table de base de données XRO
Le fichier CSV exporté contient le contenu et la structure de la table de base de données XRO. Le fichier CSV et la table de base de données contiennent tous les deux les mêmes colonnes :
- XRO_Client
Client - XRO_AH_Idnr
Numéro d'exécution (RunID) de la tâche - XRO_RType
Type de rapport - XRO_System
Nom du système AE - XRO_OType
Type d'objet (JobS, JobF) - XRO_Object
Nom de l'objet. - XRO_HostDst
Nom de l'agent dans l'hôte cible - XRO_LoginDst
Nom d'utilisateur sous lequel l'objet est exécuté - XRO_HostScr
Nom de l'agent sur l'hôte source (pour les transferts de fichiers seulement) - XRO_LoginSrc
- Nom d'utilisateur pour l'hôte source (pour les transferts de fichiers seulement)
- XRO_TimeStamp1
Heure de début de l'exécution - XRO_TimeStamp4
Heure de fin de l'exécution - XRO_RetCode
Code retour de la tâche - XRO_Status
Statut de la tâche - XRO_RRetCode
Code retour du transfert du rapport- 0 : le rapport a été transféré avec succès
- 4 : le rapport est incomplet
- 8 : le transfert du rapport a échoué
- XRO_ReportSize
Taille du rapport en octets. Les transferts de fichiers affichent toujours "0" ici. - XRO_UserTime
Temps utilisateur consommé - XRO_KernelTime
Temps système consommé - XRO_CpuTime
Temps CPU consommé - XRO_Archive1
Première clé d'archivage de l'objet - XRO_Archive2
Deuxième clé d'archivage de l'objet - XRO_CusStatus
Nombre défini par l'utilisateur pour l'utilisation des filtres
Voir aussi :