Configuration de Python pour être utilisé avec Analytics

Analytics vous fournit différentes options pour intégrer le langage de programmation Python et les scripts Python dans votre automatisation de données et vos flux de travail d’analyse de données.

Domaine fonctionnel Analytics	Nombre de bits de Python requis	Version Python prise en charge	Méthode de configuration de Python
ACLScript Commande AI (AICOMMAND) Commande ACLScript pour Python (PYCOMMAND)	64 bits (méthode recommandée) 32 bits	3.12.4 (testée) Les autres versions de Python fonctionneront probablement, mais elles n’ont pas été testées.	Le client installe et configure Python séparément d’Analytics. Consultez la section Consultez la section Configurer Python pour permettre l’utilisation des commandes AI et Python ACLScript
Fonctions ACLScript pour Python	32 bits	3,7, 3,8, 3,9	Le client installe et configure Python séparément d’Analytics. Consultez la section Configurer Python pour pouvoir utiliser les fonctions ACLScript pour Python
Commandes de machine learning pour ACLScript	32 bits	3.7.9	Le client sélectionne l’installation Python facultative au cours du processus d’installation d’Analytics Consultez la section Installer ACL pour Windows

Consultez la section Configurer Python pour permettre l’utilisation des commandes AI et Python ACLScript

Installez et configurez Python pour pouvoir utilise les commandes AI et Python ACLScript (AICOMMAND et PYCOMMAND). Vous devez également installer le module Pandas. Pour utiliser la commande AI, vous devez en outre installer la bibliothèque API Python OpenAI.

La commande AI vous permet d’intégrer un traitement AI fourni en externe à votre analyse de données dans Analytics. Un script Python est utilisé comme intermédiaire entre Analytics et le service d’IA.

La commande Python vous permet d’intégrer facilement les fonctions de création de scripts Analytics et Python, et de procéder à des allers-retours entre les deux environnements.

Installer Python (64 bits ou 32 bits)

1. À partir de la page des téléchargements Python, téléchargez une version récente de Python sur votre ordinateur ou sur le serveur.

   Les commandes AI et Python pour ACLScript ont été testées avec Python 3.12.4. Les autres versions de Python devraient fonctionner, mais cela n’est pas garanti.

2. Double-cliquez sur le programme d’installation de Python sur votre ordinateur ou sur le serveur.

3. Dans le programme d'installation, sélectionnez Utiliser les privilèges d'Admin lors de l'installation de py.exe.

4. Cliquez sur Installer maintenant et suivez les instructions à l’écran.

Ajouter des chemins de dossier Python à la variable d’environnement PATH

Ajoutez à la variable d’environnement PATH deux chemins de dossier pour l’installation de Python.

1. Dans la barre des tâches Windows, effectuez une recherche sur variables d'environnement.

2. Sélectionnez Modifier les variables d'environnement système.

   La boîte de dialogue Propriétés système s’affiche.

3. Dans l'onglet Avancé, sélectionnez Variables d'environnement.

   La boîte de dialogue Variables d'environnement s'affiche.

4. Dans la liste Variables système, sélectionnez Chemin, puis sélectionnez Modifier.

   La boîte de dialogue Modifier la variable d'environnement s'affiche.

5. Procédez comme suit pour ajouter deux chemins de dossier Python :

   1. Sélectionnez Nouveau et ajoutez ce chemin de dossier (emplacement par défaut de l’installation de Python) :

      C:\Utilisateurs\<USER>\AppData\Local\Programmes\Python\Python<version>\

      Note

      Si vous avez installé Python à un emplacement différent, spécifiez le chemin correct vers le dossier contenant le fichier exécutable (python.exe).

   2. Sélectionnez le chemin récemment ajouté et utilisez l’option Déplacer vers le haut pour déplacer le chemin vers le haut de la liste.

   3. Resélectionnez Nouveau et ajoutez ce chemin de dossier modifié en conséquence :

      C:\Utilisateurs\<USER>\AppData\Local\Programmes\Python\Python<version>\Scripts

   4. Sélectionnez le deuxième chemin ajouté et utilisez l’option Déplacer vers le haut pour déplacer le chemin en dessous du premier chemin que vous avez ajouté.

6. Pour enregistrer vos modifications, sélectionnez OK dans chacune des boîtes de dialogue :

   • Modifier la variable d’environnement

   • Variables d’environnement

   • Propriétés système

7. Redémarrez votre ordinateur ou le serveur afin de vous assurer que les modifications apportées à la variable d’environnement Chemin soient effectives.

   Note

   En fonction de votre système d’exploitation et de votre environnement, un redémarrage peut être nécessaire. Toutefois, si l’ensemble d’actions suivant ne fonctionne pas, redémarrez votre ordinateur ou le serveur avant de procéder à ces étapes.

Créer un environnement virtuel Python

1. Créez un dossier Windows qui contiendra l’environnement virtuel Python.

   Par exemple, C:\Python_ACL_integration.

2. Ouvrez une invite de commande Windows et choisissez Exécuter en tant qu'administrateur.

3. Saisissez python.exe --version et appuyez sur Entrée.

   Cela devrait vous renvoyer la version de Python que vous avez installée. Par exemple :
   Python 3.12.4.

   Si cette commande n’est pas reconnue par l’invite de commandes Windows, il est possible que les modifications que vous apportées à la variable d’environnement Chemin ne soient pas effectives. Redémarrez votre ordinateur ou le serveur, puis réessayez.

4. Basculez vers le dossier que vous avez créé pour l’environnement virtuel Python.

   Par exemple, cd C:\Python_ACL_integration.

5. Pour créer un environnement virtuel Python, entrez cette commande : python -m venv venv.

   La première mention de venv indique que le module venv de Python est utilisé. La seconde mention de venv indique le nom de l'environnement virtuel. Vous pouvez donner un nom différent à l’environnement virtuel si vous le souhaitez, mais veillez à ce que le nom soit clairement représentatif de l’environnement virtuel.

   Vous devriez à présent disposer d'un sous-dossier venv dans le dossier que vous avez créé pour l'environnement virtuel Python. Par exemple, C:\Python_ACL_integration\venv.

   Si la création de l'environnement virtuel Python a échoué, il est possible que les modifications apportées à la variable d'environnement Chemin ne soient pas effectives. Redémarrez votre ordinateur ou le serveur, puis réessayez.

6. Pour activer un environnement virtuel Python, entrez cette commande : .\venv\Scripts\activate.

   Cette invite de commande devrait renvoyer le dossier de l'environnement virtuel avec le préfixe (venv). Par exemple, (venv) c:\Python_ACL_integration>

7. Afin d'installer le module Pandas dans l'environnement virtuel Python, entrez cette commande : pip install pandas.

   En cas de réussite de l’installation de Pandas, la dernière ligne du message de l’invite de commande devrait ressembler à cela :

   Installation réussie de numpy-2.2.2 pandas-2.2.3 python-dateutil-2.9.0.post0 pytz-2024.2 six-1.17.0 tzdata-2025.1

8. Afin d’installer la bibliothèque API Python OpenAI dans l’environnement virtuel Python, entrez cette commande : pip install pandas.

   En cas de réussite de l’installation de la bibliothèque OpenAI, la dernière ligne du message de l’invite de commande devrait ressembler à cela :

   Installation réussie de annotated-types-0.7.0 anyio-4.11.0 certifi-2025.10.5 colorama-0.4.6 distro-1.9.0 h11-0.16.0 httpcore-1.0.9 httpx-0.28.1 idna-3.11 jiter-0.11.1 openai-2.6.0 pydantic-2.12.3 pydantic-core-2.41.4 sniffio-1.3.1 tqdm-4.67.1 typing-extensions-4.15.0 typing-inspection-0.4.2

Ajoutez aux Options Analytics le chemin d’accès à l’environnement virtuel

1. Ouvrez ACL pour Windows.

2. Dans le menu principal Analytics, sélectionnez Outils > Options.

3. Sélectionnez l’onglet Système.

4. Dans le champ Chemin Python, entrez le chemin complet et le nom du fichier exécutable Python dans l’environnement virtuel que vous venez de créer.

   Par exemple, C:\Python_ACL_integration\venv\Scripts\python.exe

5. Cliquez sur OK afin d'enregistrer vos modifications.

Prochaines étapes

En cas de réussite de l’installation et la configuration de Python, de l’environnement virtuel, de Pandas et de la bibliothèque OpenAI, vous pouvez à présent tester l’intégration de Python à Analytics. Pour plus d'informations, consultez :

• Utilisation de l’IA dans l’analyse des données

• Commande AICOMMAND

• Intégrer des scripts Python

• Commande PYCOMMAND

Configurer Python pour pouvoir utiliser les fonctions ACLScript pour Python

Pour configurer Python afin de l'utiliser avec Analytics, vous devez installer une version compatible de Python et ajouter l'exécutable Python à la variable d'environnement PATH de votre ordinateur. Vous devez également définir les variables d'environnement ACLPYTHONDLL et PYTHONPATH de votre système.

Fonctionnement

Pour exécuter des scripts Python, Analytics doit pouvoir appeler l'exécutable Python et trouver les scripts qu'on lui ordonne d'exécuter. Analytics utilise la variable d'environnement PATH pour localiser Python et la variable d'environnement PYTHONPATH pour localiser les scripts.

Installer Python (32 bits)

1. À partir de la page des téléchargements Python, téléchargez l’une des versions suivantes de Python sur votre ordinateur ou sur le serveur :
   • 3.7.x
   • 3.8.x
   • 3.9.x

   Note

   Le fonctionnement des versions indiquées de Python a été testé et vérifié avec Analytics ou l’Agent Robots.

   Toute version de Python à partir de 3.7.x et ultérieure doit fonctionner. Toutefois, le fonctionnement des versions autres que celles énumérées n'est pas garanti.

2. Sur votre ordinateur ou sur le serveur, double-cliquez sur le programme d'installation.
3. Dans le programme d'installation, sélectionnez Ajouter Python numéro_de_version à PATH.
4. Cliquez sur Installer et suivez les instructions à l'écran.
5. Redémarrez l'ordinateur ou le serveur avant d'exécuter des scripts Python appelés par un script Analytics.

Définir les variables d'environnement ACLPYTHONDLL et PYTHONPATH

1. Dans le disque C:\ du système d’exploitation Windows, créez un ou plusieurs dossiers qui hébergeront vos scripts Python.

   ExempleC:\python_scripts

2. Dans le système d'exploitation, ouvrez la boîte de dialogue Propriétés système, puis cliquez sur Variables d'environnement.
3. Dans la section Variables système, cliquez sur Nouveau et saisissez les variables suivantes :

   Nom de variable	Valeur de variable
   PYTHONPATH	Le chemin d’accès complet au(x) dossier(s) que vous avez créés pour héberger les scripts Python. Séparez les différents chemins d'accès au dossier avec un point-virgule. Exemple : C:\python_scripts;C:\dev;C:\tmp
   ACLPYTHONDLL	Le chemin d’accès complet et nom du fichier Python DLL dans le dossier d’installation Python. Exemple : c:\python_install\python35.dll Note Lors de l'installation, Python ajoute la DLL au dossier système (c:\windows\system32\python35.dll) plutôt qu'au dossier d'installation. Vous devez copier le fichier DLL du dossier système vers le dossier d'installation et utiliser l'emplacement du dossier d'installation comme valeur de variable. Analytics ou l'Agent Agent Robots recherche la DLL dans le dossier d'installation de Python. Il est possible que vous ayez besoin de supprimer des paramètres en lecture seule du dossier d'installation.

4. Pour enregistrer la variable, cliquez sur OK, puis, dans la boîte de dialogue Propriétés système, cliquez à nouveau sur OK.

Utiliser Python dans les fonctions Analytics Python

Dans Analytics, utilisez les fonctions Analytics Python pour appeler des fonctions dans les scripts existant dans PYTHONPATH.

Pour de plus amples informations, consultez la section Python.