Configurer des actualisations de données automatisées

Introduction

Si vous souhaitez effectuer des chargements de données fréquents ou par intervalles pour UiPath Process Mining, vous pouvez configurer des actualisations de données automatisées. Ce guide explique comment configurer des actualisations automatisées des données à l'aide d'un script de commandes.

Lors de l'exécution du script, la structure de dossiers d'un ensemble de données utilisant le nom de l'ensemble de données que vous avez spécifié est générée en premier. Ensuite, toutes les tables du connecteur sont rechargées et mises en cache pour le module spécifié. Ces tables mises en cache sont utilisées pour exporter les tables de sortie du connecteur. L'ensemble de données de sortie est utilisé pour générer un cache pour l'application sur l'environnement spécifié.

Prérequis

Vous devez avoir accès au serveur ou à la machine virtuelle qui contient l'installation UiPath Process Mining .

Vous devez également avoir un connecteur dans un espace de travail.

Remarque : le script empruntera l'identité de votre espace de travail. Vous devez créer un espace de travail pour le connecteur et vous assurer que l'espace de travail est tenu à jour. L'actualisation des données utilisera l'espace de travail spécifié tel quel, en utilisant toutes les modifications non validées, le cas échéant. Par conséquent, il est recommandé de disposer d'un espace de travail dédié uniquement à l'actualisation des données.

Important :

Ce script de commandes nécessite que la version de l'espace de travail et le Superadmin soient identiques. Si vous mettez à jour la version de Superadmin sans la modifier pour l'espace de travail (ou vice versa), le script échouera, ce qui entraînera l'absence de données actualisées.

Par conséquent, il est recommandé de mettre à jour le build partout (Superadmin, connecteur et autres applications) en même temps.

Étape 1 : Préparation

Créez un script de commandes que vous souhaitez utiliser pour les actualisations automatisées des données à partir de l'exemple de code ci-dessous et enregistrez-le dans le dossier racine de votre installation UiPath Process Mining .

Remarque : il est recommandé d'inclure le nom du processus et le nom du système dans le nom du fichier de commandes.

set MAINDIR=%~dp0
set DATASET=FullData
set ENVIRONMENT=production
set WORKSPACE=Peter/Connector
mkdir "%MAINDIR%\datax\_datasets\%DATASET%"
mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org"
echo. > "%MAINDIR%\datax\_datasets\%DATASET%\nomodcodes.marker"
for %%M in (..) do (
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -CCDB app="%%M" o= refreshmvncaches=true
              mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org\MVNCache" 
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -export app="%%M" out="%MAINDIR%\datax\_datasets\%DATASET%\_org\MVNCache" o= refreshmvncaches=false reusecache=true onlymarked=true
)
call "%MAINDIR%\builds\processgold.bat" -dataserver -skipmail -env "%ENVIRONMENT%" -CCDB o=* dataset="%DATASET%" p=*

Étape 2 : définir les paramètres dans le script

Vous trouverez ci-dessous une description des paramètres que vous devez spécifier dans le script.

Paramètre	Description
JeuDonnées	le nom de l'ensemble de données de sortie que vous souhaitez générer à partir du script. Cet ensemble de données apparaîtra dans l’onglet Données de développement Superadmin (Superadmin Development data) .
Environnement (Environment)	l'environnement pour lequel vous souhaitez générer un cache. Remarque : il s'agit généralement de l'environnement dans lequel l' application AppOne de votre processus est active.
Espace de travail	le chemin d'accès à l'espace de travail où se trouve le connecteur. Il s'agit de votre nom de connexion suivi du nom de l'espace de travail. Si le script ne trouve pas l'espace de travail correct, essayez d'utiliser une barre oblique au lieu d'une barre oblique inverse.

Nom de l'espace de travail

Suivez ces étapes pour déterminer le chemin d'accès à l'espace de travail.

Étape	Action
1	Accédez au dossier d'installation d' UiPath Process Mining .
2	Accédez au dossier des espacesde travail.
3	Accédez au dossier [votre nom de connexion] . Le dossier contient un dossier pour chacun de vos espaces de travail.

Important :

Lorsque votre nom de connexion contient des caractères spéciaux, le dossier du nom d'utilisateur est codé au format HTML. Cependant, pour être utilisé dans le script, le % doit être échappé en utilisant trois % supplémentaires.

Par exemple : si votre nom d'utilisateur est [e-mail] , il se transformera en dossier test%2Eexample%40uipath%2Ecom . Dans le script, le nom d'utilisateur doit être spécifié sous la forme test%%%%2Eexample%%%%40uipath%%%%2Ecom . Si le nom d'utilisateur contient un trait de soulignement (« _ »), ce trait de soulignement doit être protégé par %%%%5F .

Étape 3 : ajouter le code du module de connecteur

Certains connecteurs ayant plusieurs modules, vous devez spécifier le code de module du connecteur pour lequel vous souhaitez implémenter des actualisations de données automatisées.

Ajoutez le code de module de votre connecteur dans la boucle for %M in (…) do .

Suivez ces étapes pour trouver le code du module et l'ajouter au script.

Étape	Action
1	Ouvrez le connecteur dans votre environnement de développement.
2	Cliquez sur l'icône du logo et sélectionnez Modules....
3	Copiez le code du module à partir du champ Code d' application (Application Code ).
4	Cliquez sur ANNULER (CANCEL) pour fermer la boîte de dialogue Modules.
5	Fermez le connecteur.
6	Dans le script, remplacez le "..." à l'intérieur de ( ) par le code de module de votre connecteur dans la boucle for %M in (…) do .

Étape 4 : planifier une tâche pour la synchronisation

Vous pouvez utiliser le Planificateur de tâches Windows pour planifier une tâche qui exécute le script de commandes pour l'actualisation automatisée des données.

Remarque: Il est recommandé de sélectionner le compte d'utilisateur SYSTEM local pour exécuter la tâche, et de sélectionner l'option Exécuter avec la priorité la plus élevée dans la fenêtre Créer une tâche lors de la création de la tâche dans le planificateur de tâches Windows.

Le temps nécessaire à cette tâche dépendra fortement des volumes de données transitant par votre connecteur. Si la tâche s'exécute pendant trop longtemps, il est conseillé de prendre en compte les éléments suivants, dans l'ordre :

• Minimiser le volume de données entrant dans le connecteur ;
• Rechercher les conditions de jointure erronées qui entraînent la duplication des données ;

• Supprimez tous les attributs inutilisés dans le connecteur (chaque attribut supplémentaire dans le connecteur augmente le temps d'exécution du script).

  Important : il est fortement conseillé d'annuler la tâche après plus de 3 jours d'exécution.

Format du jeu de données

Les ensembles de données à utiliser avec Process Mining ont un format spécifique, qui dépend d'un marqueur. Ce marqueur est stocké à la racine de l'ensemble de données. Voir l’illustration ci-dessous pour un exemple.

Le marqueur n'est qu'un fichier vide et n'est utilisé que pour son nom. Il existe deux marqueurs différents : nomodcodes.marker et usemodcodes.marker .

Le usemodcodes.marker ne s'applique que lorsque le partitionnement des données est utilisé pour définir l'étendue des données.

Nomodcodes.marker

Le nomodcodes.marker utilise la structure de données affichée ci-dessous.

<DATASET NAME>\<ORGANIZATION CODE>\MVNCache

Vous trouverez ci-dessous une description des éléments de nomodcodes.marker.

Élément	Description
<DATASET NAME>	Le nom qui est affiché dans le Superadmin OngletDonnées de développement .
<ORGANIZATION CODE>	La valeur par défaut est : _org , ce qui sera le cas dans 99 % des cas

Usemodcodes.marker

Le usemodcodes.marker utilise la structure de données affichée ci-dessous.

<DATASET NAME>\<ORGANIZATION CODE>\<MODULE CODE>\MVNCache

Vous trouverez ci-dessous une description des éléments de usemodcodes.marker.

Élément	Description
<DATASET NAME>	Le nom qui est affiché dans le Superadmin OngletDonnées de développement .
<ORGANIZATION CODE>	La valeur par défaut est : _org , ce qui sera le cas dans 99 % des cas
<MODULE CODE>	Le code défini dans l’application. Voir Modules. Cette option vous permet d'utiliser plusieurs codes d'application dans une seule application.

Le script fourni à l'étape 1. s'applique à nomodcodes.marker . Pour usemodcodes.marker , vous devez utiliser le script ci-dessous.

set MAINDIR=%~dp0
set DATASET=FullData
set ENVIRONMENT=production
set WORKSPACE=Peter/Connector
mkdir "%MAINDIR%\datax\_datasets\%DATASET%"
mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org"
echo. > "%MAINDIR%\datax\_datasets\%DATASET%\usemodcodes.marker"
for %%M in (..) do (
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -CCDB app="%%M" o= refreshmvncaches=true
              mkdir "%MAINDIR%\datax\_datasets\%DATASET%\_org\%%M\MVNCache" 
              call "%MAINDIR%\builds\processgold.bat" -dataserver -workspace "%WORKSPACE%" "" -export app="%%M" out="%MAINDIR%\datax\_datasets\%DATASET%\_org\%%M\MVNCache" o= refreshmvncaches=false reusecache=true onlymarked=true
)
call "%MAINDIR%\builds\processgold.bat" -dataserver -skipmail -env "%ENVIRONMENT%" -CCDB o=* dataset="%DATASET%" p=*