Génération de cache

Introduction

Remarque : dans ce guide, il est supposé qu'il n'existe qu'un seul environnement.

Avant qu'un utilisateur final puisse accéder à un environnement et à la version qui y est active, des données doivent être acquises (par ex. requêtes sur une base de données externe) et les calculs doivent être mis en cache. Le résultat d'une seule génération de cache est appelé « instance ».

Les caches peuvent être générés manuellement ou automatisés. Le résultat de ces générations de cache est visible dans l'onglet Données publiées par le Superadmin (Superadmin Released data).

Génération manuelle de caches

Pour créer des instances de données, vous devez générer des caches nécessaires pour permettre aux utilisateurs finaux d'accéder à l'application.

Suivez ces étapes pour créer un cache pour votre version.

Étape	Action
1	Accédez à l'onglet Données publiées par le Superadmin (Superadmin Released data).
2	Cliquez sur Générer le cache maintenant (Generate cache now).
3	Cliquez sur GÉNÉRER LE CACHE (GENERATE CACHE).
4	Lorsque la boîte de dialogue affiche Terminé (Finished), cliquez sur FERMER (CLOSE).

Une nouvelle ligne a été ajoutée avec le nom de votre module et une colonne pour le datarun nommée d'après la date actuelle. 1/1 est affiché dans cette colonne indiquant que l'instance a été générée avec succès.

Si vous cliquez sur la flèche pour développer la ligne, le nom de votre organisation et quelques icônes s'affichent, indiquant que la génération de données a réussi et que cette instance de données est maintenant active. Voir illustration ci-dessous.

Génération automatique de caches

La génération de cache peut également être effectuée périodiquement (par exemple, quotidiennement) plutôt que manuellement. Ceci est utile lorsque les données sont interrogées à partir d'une base de données externe, car les données mises à jour seront ainsi automatiquement disponibles pour les utilisateurs finaux.

Pour configurer cela, un accès administrateur au serveur est nécessaire.

Il est possible de générer des caches pour des modules spécifiques dans la version active. Utilisez app=MODULECODE au lieu de app=* dans le fichier batch (voir ci-dessous). Si app=* est utilisé, des caches sont générés pour tous les modules de la version active.

Il est également possible de générer des caches pour des organisations spécifiques. Utilisez o=[org] pour générer un cache pour l'organisation spécifiée. Si o=* est utilisé, les caches sont générés pour toutes les organisations dans l'ordre séquentiel.

Remarque : cela s'applique uniquement aux applications qui n'utilisent pas de connecteur pour générer des données d'entrée.

Suivez ces étapes pour planifier une tâche de génération de caches.

Étape	Action
1	Ouvrez le répertoire PLATFORMDIR.
2	Créez un fichier batch vide, par exemple : generatecaches.bat.
3	Modifiez ce fichier batch et utilisez la ligne suivante en tant que contenu : call builds/processgold.bat -DataServer -ccdb app=* o=org refreshmvncaches=both Ce fichier batch générera des caches pour toutes les applications.
4	Planifiez une tâche dans Windows pour appeler ce fichier batch.

Une tâche planifiée s'exécutera périodiquement pour générer des caches pour tous les projets de cette installation d'UiPath Process Mining.

Important :

Il est recommandé d'exécuter cette tâche en dehors des heures de bureau pour avoir le moins d'impact

possible sur vos utilisateurs.

Interprétation des résultats

La vue des données publiées contient les instances de données générées pour chaque module.

Vous trouverez ci-dessous une description des icônes indiquant l'état d'une instance.

Icon	Description
A	L'instance de données actuellement active.
B	Une instance de données valide.
C	Une instance de données valide, mais comportant quelques avertissements.
D	Une instance de données ayant échoué.
E	Une instance de données valide, mais bloquée.
F	Une instance de données ayant échoué mais marquée comme résolue.

Lorsqu'une nouvelle instance de données est créée, elle est automatiquement définie en tant qu'active si elle est valide. Cependant, en cas d'échec, la dernière instance valide restera active à la place.

Affichage du journal détaillé de la génération d'instances de données

Parfois, il est nécessaire de consulter un journal plus détaillé de la génération de l'instance de données, par exemple lorsqu'une erreur ou un avertissement s'est produit(e) et que vous souhaitez afficher plus de détails.

Suivez ces étapes pour afficher le journal d'une génération d'instance de données.

Étape	Action
1	Accédez à l'onglet Données publiées par le Superadmin (Superadmin Released data).
2	Cliquez avec le bouton droit sur l'instance de données dont vous souhaitez afficher le journal et sélectionnez Afficher le journal (Show log). (facultatif : sélectionnez les modules à utiliser, voir « La boîte de dialogue Sélectionner les instances (Select Instances) »)
3	Cliquez sur OK.

Le journal de la génération de l'instance de données s'affiche.

Ouverture d'une instance

Suivez ces étapes pour afficher une instance de données spécifique.

Étape	Action
1	Accédez à l'onglet Données publiées par le Superadmin (Superadmin Released data).
2	Cliquez avec le bouton droit sur l'instance de données que vous souhaitez ouvrir et sélectionnez Ouvrir... (Open...).
3	Cliquez sur OUVRIR (OPEN).

Le projet est ouvert avec l'instance de données que vous avez sélectionnée.

Remplacement du statut de l'instance

Blocage d'une instance de données

Parfois, une instance considérée comme valide peut tout de même présenter un problème. Dans ce cas, il est possible de la bloquer pour s'assurer qu'elle sera désactivée et que les utilisateurs finaux ne pourront plus y accéder.

Suivez ces étapes pour restaurer un cache actif.

Étape	Action
1	Accédez à l'onglet Données publiées par le Superadmin (Superadmin Released data).
2	Cliquez avec le bouton droit sur l'instance de données pour laquelle le problème a été détecté et sélectionnez Marquer. bloquée. (facultatif : sélectionnez les modules à utiliser, voir « La boîte de dialogue Sélectionner les instances (Select Instances) »)
3	• Cliquez sur OK (x2).

L'instance de données active a été marquée comme bloquée. L'instance de données actuellement active est la dernière instance de données valide.

Marquage d'une instance de données comme résolue

Lorsqu'un problème avec une instance de données bloquée ou défaillante n'en est pas réellement un, il est possible de la marquer comme résolue et de la réactiver.

Suivez ces étapes pour marquer une instance de données comme résolue.

Étape	Action
1	Accédez à l'onglet Données publiées par le Superadmin (Superadmin Released data).
2	Cliquez avec le bouton droit sur l'instance de données qui a été résolue et sélectionnez Marquer comme résolue (Mark fixed). (facultatif : sélectionnez les modules à utiliser, voir « La boîte de dialogue Sélectionner les instances (Select Instances) »)
3	• Cliquez sur OK (x2).

L'instance de données active a été marquée comme valide et l'instance de données actuellement active est définie sur la dernière instance de données valide.

La boîte de dialogue Sélectionner des instances (Select Instances)

Dans le menu contextuel (clic droit sur une instance) de l'onglet Données publiées (Released data), chacune des options ouvre une boîte de dialogue nommée Sélectionner les instances (Select Instances). Voir illustration ci-dessous.

Dans cette boîte de dialogue, vous avez la possibilité de sélectionner les modules sur lesquels l'opération sélectionnée est appliquée. Certaines actions, comme Ouvrir (Open), nécessitent la sélection d'une seule instance tandis que d'autres permettent d'en sélectionner plusieurs, comme Afficher les journaux (Show Logs). Selon l'endroit où vous faites un clic droit dans la grille, différents modules seront initialement sélectionnés dans la boîte de dialogue Sélectionner les instances (Select Instances).

Suivez ces étapes pour sélectionner des modules spécifiques à l'action que vous exécutez actuellement.

Étape	Action
1	Accédez à l'onglet Données publiées par le Superadmin (Superadmin Released data).
2	Cliquez avec le bouton droit sur l'instance de données et sélectionnez l'une des options.
3	Cliquez sur SÉLECTIONNER LES MODULES (SELECT MODULES).
4	Sélectionnez les modules que vous souhaitez utiliser.
5	Cliquez sur OK.

Les modules que vous avez sélectionnés sont indiqués dans la boîte de dialogue Sélectionner les instances (Select Instances).

Paramètres de restauration

Les anciennes instances seront automatiquement supprimées lorsque de nouvelles seront créées. Par défaut, seule la dernière instance de données présentant une erreur et les deux dernières instances de données valides resteront disponibles.

Il est possible d'augmenter ces nombres selon votre convenance. De plus, lorsqu'une instance valide est créée, toutes les instances non valides datant de plus d'une semaine sont supprimées.

Suivez ces étapes pour adapter les paramètres de restauration.

Étape	Action
1	Accédez à l'onglet Paramètres du Superadmin (Superadmin Settings).
2	Dans le champ de texte Paramètres du serveur (Server Settings), définissez KeepInstancesError sur le nombre d'instances d'erreur que vous souhaitez conserver (par exemple “KeepInstancesError”: 2).
3	Dans le champ de texte Paramètres du serveur (Server Settings), définissez KeepInstancesOk sur le nombre d'instances valides que vous souhaitez conserver (par ex. “KeepInstancesOk”: 6).
4	Cliquez sur ENREGISTRER (SAVE).

Le nombre d'instances de données valides et d'instances d'erreur conservées est mis à jour selon les paramètres choisis. La prochaine fois qu'une instance est générée, ces nouveaux paramètres seront utilisés pour supprimer les anciennes instances.

E-mails d'échec automatisés

Il est possible de recevoir des e-mails lorsque votre génération de cache échoue.

Suivez ces étapes pour configurer des e-mails d'échec automatisés.

Étape	Action
1	Accédez à l'onglet Paramètres du Superadmin (Superadmin Settings).
2	Dans le champ de texte Paramètres du serveur (Server Settings), définissez SendMailReportTo sur l'adresse e-mail à laquelle vous souhaitez recevoir des e-mails en cas d'échec. (par exemple, "SendMailReportTo": "[email]"). (Facultatif) Dans le champ de texte des paramètres du serveur, définissez SendMailReportId sur une chaîne qui identifie votre serveur. Elle sera ajoutée à la ligne d'objet de l'e-mail. (par exemple, "SendMailReportId": "[id]").
3	Cliquez sur ENREGISTRER (SAVE).

En cas d'échec, un e-mail sera envoyé à l'adresse e-mail définie dans SendMailReportTo, avec SendMailReportId en guise d'objet.

 

Exportation de jeux de données pour les développeurs

Vous pouvez exporter les données contenues dans une instance en tant que jeu de données de développement. Les développeurs peuvent utiliser ces jeux de données pour ne pas avoir besoin d'acquérir de données (par exemple en exécutant des requêtes) eux-mêmes.

Suivez ces étapes pour exporter un jeu de données pour le développement.

Étape	Action
1	Accédez à l'onglet Données publiées par le Superadmin (Superadmin Released data).
2	Cliquez avec le bouton droit sur l'instance de données que vous souhaitez exporter et sélectionnez Exporter les données pour développement…. (facultatif : sélectionnez les modules à utiliser, voir « La boîte de dialogue Sélectionner les instances (Select Instances) »)
3	Cliquez sur OK.
4	Saisissez un nom pour le jeu de données exporté et cliquez sur OK.

Le jeu de données exporté est ajouté aux jeux de données dans l'onglet Données de développement (Development data).

Informations associées

Pour plus d'explications sur les situations avec plusieurs environnements, consultez : Environnements (Environments).