process-mining

2023.4

false

Important :

Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique.

Process Mining

PRODUIT :

Automation Cloud Automation Cloud Public Sector Automation Suite Standalone

Last updated 17 oct. 2024

Loading data using Theobald Xtract Universal

Introduction

Cette page explique comment utiliser Theobald Xtract Universal pour charger des données de votre système source SAP dans une application de processus dans Process Mining (Automation Suite). Reportez-vous au site officiel de Theobald Software pour en savoir plus sur Theobald Xtract Universal.

Theobald Xtract Universal fournit un accès et des extractions de données rapides aux sources de données SAP ECC et SAP HANA. Pour obtenir des instructions générales sur l'utilisation de Theobald Xtract Universal (XU), consultez la documentation officielle du logiciel Theobald Getting Started with Theobald Xtract Universal.

Prérequis

Nous supposons que :

une licence Theobald Xtract Universal valide.
installé Theobald Xtract Universal. Consultez la documentation officielle du logiciel Theobald pour plus d'informations sur l'installation d'une mise à jour de Theobald Xtract Universal et la personnalisation du module de fonction pour l'extraction de table dans SAP.

Remarque :

Loading data using Theobald Xtract Universal requires that the command line tool (xu.exe) can be executed without additional authentication.

Configuration de Theobald Xtract Universal

Theobald Xtract Universal est l'outil d'extraction certifié SAP utilisé pour l'extraction de données à partir de systèmes sources SAP, s'intégrant à SAP via des appels de fonction à distance (RFC). Theobald Xtract Universal contient un module de fonction personnalisé en lecture seule qui doit être installé dans SAP. Utilisez le lien suivant pour télécharger le module personnalisé : Z_THEO_READ_TABLE-transport1.zip.

Remarque :

La licence est fournie via UiPath pour les besoins de Process Mining.

Suivez ces étapes pour configurer Theobald Xtract Universal.

Téléchargez la dernière version d'essai de Theobald Xtract Universal depuis notre site Web. Consultez Télécharger la version d'essai. Installez Theobald Xtract Universal sur un serveur/une machine virtuelle Windows.
Vérifiez si l'accès réseau de votre système SAP est ouvert. Consultez Ports TCP/IP SAP.
Accordez des droits d'utilisateur SAP pour accéder à l'instance SAP. Consultez Objets d'autorité - Droits d'utilisateur SAP pour table.
Les composants suivants de Theobald Xtract Universal nécessitent d'être personnalisés dans SAP : Z_THEO_READ_TABLE.
Configurez Theobald Xtract Universal pour le ou les modèles d'application requis. Voir Modèles d'applications.

Remarque :

Les étapes 2 à 4 nécessiteront la validation de votre équipe SAP.

Setup credentials for the SQL Server database

Le téléchargement de données vers Process Mining (Automation Suite) nécessite l'accès à l'emplacement de la base de données SQL Server dans laquelle les données extraites doivent être téléchargées. Pour configurer une connexion de destination SQL Server, vous avez besoin des paramètres de configuration suivants afin d'authentifier l'accès à l'emplacement de la base de données SQL Server.

Server
Base de donnés
Schéma
Rôle

Voir Récupération des paramètres de la base de données SQL Server.

Chargement de données à l'aide de Theobald Xtract Universal

La configuration du chargement de données à l'aide de Theobald Xtract Universal nécessite plusieurs étapes.

Configurez l'utilisateur SQL pour télécharger les données ;
Importer les extractions de modèles ;
Configurer la source ;
Configurer la destination ;
Configurez le script d'extraction ;
Exécutez le script d'extraction.

Les étapes sont décrites en détail ci-dessous.

Configuration de l'utilisateur SQL pour télécharger les données

Chaque application de processus qui utilise l'option de téléchargement de données via l'extracteur a besoin d'un utilisateur SQL Server dédié disposant d'un accès spécifique au schéma associé à l'application de processus.

Suivez ces étapes.

Étape	Action	Syntaxe
1	Créez un identifiant. Remarque : La connexion doit être créée dans la base de données principale.	`CREATE LOGIN <SQL_login_name> WITH PASSWORD = '<Password>'`
2	Créez un utilisateur de base de données pour l'identifiant. Remarque : Cet utilisateur doit être créé dans la base de données AutomationSuite_ProcessMining_WareHouse.	`CREATE USER <User_name> FOR LOGIN <SQL_login_name>`
3	Affectez à l'utilisateur le rôle de base de données approprié.	`SP_ADDROLEMEMBER <Role>, <User_name>`
4	Définissez le schéma par défaut de l'utilisateur créé. Attention : Cette étape n'est requise que pour le chargement des données à l'aide de Theobald Xtract Universal.	`ALTER USER <User_name> WITH DEFAULT_SCHEMA = <Schema>`

Importation des extractions de modèles

Suivez ces étapes pour importer les extractions de modèles dans Theobald Xtract Universal.

Étape	Action
1	Accédez à la page Modèles d'applications ( App Templates ) et ouvrez la page de documentation de votre modèle d'application.
2	Localisez la section Chargement des données à l'aide de Theobald Xtract Universal et téléchargez le fichier XU_template_extractions_as.zip pour votre modèle d'application. Voir Modèles d'applications. Ce fichier `XU_template_extractions_as.zip` contient les dossiers `destinations`, `extractions`et `sources`.
3	Copiez les dossiers du fichier `XU_template_extractions_as.zip` téléchargé dans le dossier `config` de Xtract Universal. L'emplacement de ce dossier est `[XU_installation_path]` /config.
4	Ouvrez Xtract Universal Designer et cliquez sur le bouton Actualiser (Refresh) pour charger toutes les extractions.

Remarque :

Vous pouvez vous connecter à l'aide de l'utilisateur par défaut.

Une liste de toutes les extractions qui extraient chacune une table du système SAP s'affiche. La source du modèle est nommée SAP et la destination du modèle est nommée SQL Server.

Configuration de la source

Suivez ces étapes pour configurer la source SAP dans Theobald Xtract Universal.

Étape	Action
1	Accédez à Serveur - Gérer les sources et modifiez la source SAP.
2	Renseignez les paramètres dans les onglets Général ( General ) et Authentification (Authentication) pour vous connecter à votre système SAP.
3	Testez la connexion.

Configuration de la destination

Suivez ces étapes pour configurer la destination SQL Server dans Theobald Xtract Universal.

Accédez à Serveur - Gérer les destinations et modifiez la destination SQL Server.
Remplissez les paramètres pour vous connecter à votre destination SQL Server.

Configuration du script d'extraction

Suivez ces étapes pour configurer le script d'extraction.

Étape	Action
1	Accédez à la page Modèles d'applications ( App Templates ) et ouvrez la page de documentation de votre modèle d'application.
2	Localisez la section Chargement des données à l'aide de Theobald Xtract Universal et téléchargez le fichier `extract_theobald_as.zip` pour votre modèle d'application. Ce fichier `extract_theobald_as.zip` contient le script `extract_theobald.ps1` et le fichier `config.json` .
3	Décompressez le contenu du fichier `extract_theobald_as.zip` sur le serveur sur lequel Theobald Xtract Universal est installé.
4	Configurez les variables du script dans le `config.json` comme indiqué ci-dessous.

Variable	Description
`xu_location`	Le dossier d'installation de Xtract Universal. Il s'agit du dossier où vous pouvez trouver le `xu.exe`. Par exemple : C:\\MyFolder.
`xu_server`	Adresse du serveur sur lequel Xtract Universal est installé. La valeur par défaut est `localhost` .
`xu_port`	Port du serveur sur lequel Xtract Universal est installé. Le port par défaut d'une installation est `8065` .
`as_server`	Partie de l'URL qui désigne le serveur sur lequel l'application est créée. Voir Récupération des paramètres de la base de données SQL Server.
`as_organization`	Partie de l'URL qui désigne l'organisation de l'application créée. Voir Récupération des paramètres de la base de données SQL Server.
`as_tenant`	La partie de l'URL qui désigne le locataire de l'application créée. Voir Récupération des paramètres de la base de données SQL Server.
`as_app_ID`	ID d'application de l'application créée.
`extraction_start_date`	Date de début à utiliser pour limiter les extractions. Seules les tables pour lesquelles un filtre de date est appliqué sont filtrées à cette date. Le format est `YYYYMMDD`. La valeur par défaut est Aucune limitation indiquée par la date de début `19700101`. Remarque : `extraction_start_date` doit avoir une valeur.
`extraction_end_date`	Date de fin à utiliser pour limiter les extractions. Seules les tables pour lesquelles un filtre de date est appliqué sont filtrées à cette date. Le format est `YYYYMMDD`. La valeur par défaut est Aucune limitation indiquée par la date de fin `20991231`. Remarque : `extraction_end_date` doit avoir une valeur.
`language`	La langue dans laquelle les données sont extraites du système source. La valeur par défaut est `E`.
`exchange_rate_type`	Le type de taux de change utilisé pour la conversion des devises. La valeur par défaut est `M`.

Exécuter le script d'extraction

Pour charger les données et les télécharger afin de les utiliser dans Process Mining, vous devez exécuter le fichier extract_theobald.ps1.

Le temps nécessaire pour cette tâche dépendra fortement du volume de données chargés.

Démarrage manuel du fichier

Suivez cette étape pour démarrer l'analyse des données.

Étape	Action
1	Exécutez le fichier `extract_theobald.ps1` pour démarrer l'exécution des données.

L'exécution des données crée également un fichier journal qui peut être utile en cas de résultats inattendus ou si le téléchargement des données avec l'outil de téléchargement de données échoue. Le fichier extraction.log contient les journaux de la dernière exécution de données. Pour chaque extraction ayant échoué, un code retour est affiché. Consultez la documentation officielle de Theobald Software Appeler via la ligne de commande (Call via Commandline) pour plus d’informations. Lorsqu’un élément de la configuration est incorrect, cela est mentionné dans le message d’erreur.

Planifier une tâche pour l'analyse des données

Au lieu d'exécuter le fichier manuellement, vous pouvez utiliser le Planificateur de tâches Windows et planifier une tâche exécutant le script batch pour les actualisations de données automatisé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.

Important :

Si vous ajoutez un intervalle pour lequel aucune donnée n'est disponible, les tableaux de bord afficheront un message d'erreur.

Lorsque l'extraction est réussie, l'ingestion des données peut échouer en raison de l'extraction de données défectueuses. Vous pouvez filtrer ces données à l'aide de Theobald Xtract Universal à l'aide de la clause WHERE. Reportez-vous à la documentation officielle de Theobald pour plus d'informations sur la clause WHERE.

Remarque :

Si vous avez une clause WHERE qui utilise des variables (par exemple la date d'extraction), vous ne pouvez pas filtrer via l'IU.

Résolution des problèmes

Problèmes d'extraction avec CDPOS pour les systèmes non-HANA

Dans certains systèmes plus anciens non HANA, CDPOS est une table de cluster et peut entraîner une erreur « Join with pool table » comme ci-dessous.

L'extraction de la table CDPOS inclut par défaut une jointure avec la table CDHDR pour limiter le nombre d'enregistrements à extraire. Suivez ces étapes pour surmonter cette erreur.

Modifiez l'extraction CDPOS dans Xtract Universal Designer pour supprimer le CDHDR des tables.
Remplacez le CDHDR~UDATE between @extraction_start_date and @extraction_end_date par :
CHANGENR between @CHANGENR_min and @CHANGENR_max
Dans extract_theobald.ps1, remplacez &"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDPOS" -o "extraction_start_date=$extraction_start_date" -o "extraction_end_date=$extraction_end_date" par le code affiché ci-dessous.

&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDHDR_CSV" -o "extraction_start_date=$extraction_start_date" -o "extraction_end_date=$extraction_end_date"
CheckExtractionError('CDHDR_CSV')
$CDHDR = Import-Csv -Path "$xu_location\<app_template_specific>output\CDHDR_CSV.csv" -Delimiter "`t"
$CDHDR_sorted = $CDHDR | Sort-Object -Property CHANGENR 
$CHANGENR_min=$CDHDR_sorted.GetValue(0).CHANGENR
$CHANGENR_max=$CDHDR_sorted.GetValue($CDHDR_sorted.Count-1).CHANGENR
&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDPOS" -o "CHANGENR_min=$CHANGENR_min" -o "CHANGENR_max=$CHANGENR_max"&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDHDR_CSV" -o "extraction_start_date=$extraction_start_date" -o "extraction_end_date=$extraction_end_date"
CheckExtractionError('CDHDR_CSV')
$CDHDR = Import-Csv -Path "$xu_location\<app_template_specific>output\CDHDR_CSV.csv" -Delimiter "`t"
$CDHDR_sorted = $CDHDR | Sort-Object -Property CHANGENR 
$CHANGENR_min=$CDHDR_sorted.GetValue(0).CHANGENR
$CHANGENR_max=$CDHDR_sorted.GetValue($CDHDR_sorted.Count-1).CHANGENR
&"$xu_location\xu.exe" -s "$xu_server" -p "$xu_port" -n "CDPOS" -o "CHANGENR_min=$CHANGENR_min" -o "CHANGENR_max=$CHANGENR_max"

Remarque : il s'agit d'un exemple générique, les noms des tables peuvent être différents pour votre modèle d'application.

Remarque : Remplacez le dossier de sortie <app_template_specific> par le dossier de sortie spécifié pour votre modèle d'application dans extract_theobald.ps1.

Autres problèmes d'extraction

Clé en double

Lors du chargement de données à l'aide de Theobald Xtract Universal, le message d'erreur suivant peut s'afficher :

Cause possible

Un champ utilisé pour la clé primaire de la table n'est pas récupéré lors de l'extraction.

Solution

Pour résoudre ce problème, vous devez vérifier si tous les champs utilisés pour la clé primaire de la table sont récupérés dans l'extraction.

Vous trouverez ci-dessous un exemple de la table EKKN . Pour cette table, la clé primaire n'est pas complète, car le champ ZEKKN n'est pas récupéré. Le problème peut être résolu en s'assurant que ce champ est également utilisé dans l'extraction.