Intégrer des scripts Python

Vous pouvez facilement intégrer la création de scripts Analytics et Python en utilisant la commande ACLScript pour Python. Cette commande vous permet de faire passer des données d’un environnement à un autre, ce qui signifie qu’un flux de travail unique d’analyse des données dans Analytics peut utiliser l’environnement le plus adapté à une tâche particulière.

Fonctionnement

La commande Python transmet une table Analytics à un script Python externe sous forme de cadre de données, attend pendant que le script Python s’exécute, puis crée une nouvelle table dans le projet Analytics à l’aide de la sortie renvoyée par le script Python externe. Vous pouvez utiliser la commande Python autant de fois que nécessaire au cours d’un script Analytics.

Deux fonctions Python sont incluses dans l’installation d’Analytics ; vous pouvez les utiliser dans le script Python pour les données d’entrée et de sortie :

• Données d'entréeacl_py_util.from_an() importe des données d’Analytics vers Python

• Données de sortieacl_py_util.to_an() exporte des données de Python vers Analytics

Utiliser la commande Python pour différents objectifs

La commande ACLScript pour Python offre de la flexibilité et peut être utilisée à différentes fins.

• Aller-retour de donnéesImportez des données d’Analytics vers Python, procédez à une analyse dans Python, puis réexportez les résultats de l’analyse dans Analytics

• Envoyer des données dans une directionImportez des données d’Analytics vers Python, procédez à une analyse ou à une transformation de fichier dans Python, puis enregistrez les résultats dans un format de destination ou de fichier différent d’Analytics

• Envoyer des données dans une directionImportez des données d’une source externe vers Python, procédez à une analyse ou à une préparation de fichier dans Python, puis exportez les résultats vers Analytics

• Ne pas transférer de donnéesDepuis Analytics, déclenchez un script Python afin qu’il effectue une tâche associée au flux de travail général

Aligner les scripts Analytics et Python

La commande ACLScript pour Python, ainsi que les deux fonctions Python d’entrée et de sortie de données, sont relativement simples à utiliser. Vous devez cependant veiller à ce que la commande ACLScript pour Python et la logique du script Python correspond, soient bien alignées. Un problème d’alignement peut entraîner un échec du processus d’intégration. Le tableau ci-après donne quelques indications.

Commande ACLScript pour Python	Script Python
Exporte les données	La fonction de données d’entrée doit être présente : acl_py_util.from_an()
Spécifie que les données seront exportées avec des noms de champs Analytics	Tous les noms de champs référencés doivent correspondre aux noms de champs Analytics
Spécifie le script Python à exécuter	L’existence d’un script Python avec un nom correspondant et un emplacement de chemin de fichier est requise
Spécifie qu’une table sera renvoyée vers Analytics	La fonction de données de sortie doit être présente : acl_py_util.to_an()
Inclut un mot de passe	Une variable Python doit référencer correctement la variable d’environnement Analytics contenant la valeur du mot de passe : password_from_analytics = os.getenv("ACL_PY_PASSWORD")

Dépannage via les fichiers traces

Analytics crée deux fichiers traces associés à la commande ACLScript pour Python. Les journaux peuvent vous aider à résoudre les problèmes d’intégration entre Analytics et Python, ainsi qu’à déboguer les erreurs des scripts Analytics et Python associés.

Les fichiers traces sont stockés dans le dossier du projet Analytics :

• aclpython.log : enregistre les messages d'erreur d'Analytics lorsque la commande ACLScript pour Python échoue

• acl_py_util.log : enregistre les messages d'information renvoyés par le script Python

  acl_py_util.log est une trace configurable incluse dans l'installation d'Analytics. Pour en savoir plus sur la configuration de la trace, voir Configurer acl_py_util.log.

Exécuter un script Python

Utilisez la commande ACLScript pour Python pour exécuter un script Python depuis Analytics. Le chemin du fichier et le nom du script Python que vous voulez exécuter sont les deux seules informations requises dans la commande.

Cette commande vous permet d’exporter des données d’Analytics vers le script Python, ou de renvoyer des données du script Python vers Analytics. Le transfert de données n’est cependant pas une condition requise.

1. Si vous souhaitez exporter des données d’Analytics vers un script Python, ouvrez la table contenant les données.

2. Dans le menu principal Analytics, sélectionnez Analyser > Python.

3. Dans le champ Script Python, spécifiez le chemin de fichier et le nom du script Python que vous voulez exécuter.

   Par exemple : C:\Python_data_analysis_scripts\testInOutput.py

   Vous pouvez cliquer sur Parcourir et accéder au script Python sur votre ordinateur.

   Vous pouvez spécifier un chemin relatif vers le script Python, ou bien uniquement le nom de fichier du script si celui-ci se situe dans le dossier du projet Analytics.

4. Si vous exportez des données vers Python, procédez comme suit :

   1. Cliquez sur Sélectionner les champs et ajoutez un ou plusieurs champs à inclure dans le cadre de données qu’Analytics met à disposition dans le script Python.

      Astuce

      Vous pouvez aussi inclure des expressions comme des champs dans le cadre de données. Pour créer une expression, cliquez sur Expression et utilisez les fonctions, champs et opérateurs à votre disposition dans la boîte de dialogue. Pour de plus amples informations, consultez la section Présentation du générateur d'expression.

   2. Facultatif. Dans la section Options d'exportation de données, définissez comment vous souhaitez envoyer les données Analytics au script Python.

      Pour de plus amples informations, consultez la section Options d’exportation de données.

   3. Facultatif. Pour filtrer les enregistrements qui sont envoyés au script Python, cliquez sur Si et utilisez la boîte de dialogue Générateur d'expression pour créer une expression conditionnelle à utiliser comme filtre.

      Pour de plus amples informations sur la création des expressions à l'aide du Générateur d'expression, consultez la section Création d'expressions à l'aide du Générateur d'expression.

   4. Facultatif. Sélectionnez Demander le mot de passe si vous devez fournir un mot de passe au script Python.

      Lorsque vous exécutez la commande Python, vous êtes invité à entrer le mot de passe. Le mot de passe est stocké temporairement et en toute sécurité dans la mémoire. Le mot de passe ne figure pas dans la trace.

5. Si vous renvoyez des données depuis Python, procédez comme suit :

   1. Dans la zone de texte Vers, spécifiez le nom de la table qui contiendra les données renvoyées.

      Vous pouvez cliquer sur Vers et utiliser l’explorateur de fichiers pour accéder au dossier à utiliser pour stocker le fichier de données source.

      Note

      La longueur des noms des tables Analytics est limitée à 64 caractères alphanumériques, sans l’extension .FIL. Le nom peut inclure le caractère de soulignement ( _ ), mais aucun autre caractère spécial ni espace. Le nom ne peut pas commencer par un chiffre.

   2. Sélectionnez Utiliser la table de sortie pour que la table s’ouvre automatiquement une fois l’opération terminée.

6. Facultatif. Dans l’onglet Plus de la boîte de dialogue, indiquez des options d’étendue que vous souhaitez utiliser.

   Pour de plus amples informations, consultez Onglet Plus.

7. Cliquez sur OK pour exécuter la commande.

   Si vous recevez un message d’erreur et que vous rencontrez un échec d’exécution de la commande Python ou du script Python, vérifiez que la valeur du champ Chemin Python dans la boîte de dialogue Options a été correctement spécifiée. Pour de plus amples informations, consultez la section Ajoutez aux Options Analytics le chemin d’accès à l’environnement virtuel.

Options de la boîte de dialogue Commande Python

Options d’exportation de données

Option	Description
Exporter avec les noms de champs	Utilisez les noms des champs de la table Analytics source en tant que noms de colonnes pour le cadre de données Python. Cette option définit l'option KEEPTITLE sur la commande et est requise si vous souhaitez récupérer les données à l'aide des noms des colonnes dans le script Python.
Séparateur de colonnes	Caractère à utiliser comme séparateur entre les champs lors de l’envoi des données à Python.
Identificateur de texte	Caractère à utiliser comme identificateur de texte pour identifier les valeurs des champs lors de l’envoi des données à Python.

Onglet Plus

Option	Description
Tous	Traite tous les enregistrements dans la vue (sélection par défaut).
Premiers	Traite à partir du premier enregistrement de la table et inclut uniquement le nombre d'enregistrements indiqué.
suivant	Traite à partir de l'enregistrement actuellement sélectionné dans la table et inclut uniquement le nombre d'enregistrements indiqué. Note Le nombre d'enregistrements indiqué dans les options Premiers ou Suivants fait référence à l'ordre physique ou d'indexation des enregistrements dans une table, quels que soient les filtres ou les tris express appliqués à la vue. Toutefois, les résultats des opérations analytiques tiennent compte de tous les filtres appliqués. Si un tri express est appliqué à une vue, l'option Suivant se comporte comme l'option Premier.
Instruction WHILE	Utilisez une instruction WHILE pour limiter le traitement des enregistrements de la table principale selon des critères. Les enregistrements de la vue sont traités uniquement tant que la condition indiquée est vraie. Dès que la condition est fausse, le traitement s'arrête et aucun autre enregistrement n'est pris en compte. Pour de plus amples informations, consultez la section Création d'expressions à l'aide du Générateur d'expression.