Exécution de scripts Python sur AX Serveur

Demandez à un administrateur Analytics Exchange de charger des scripts Python externes dans le répertoire PYTHONPATH d'AX Serveur, puis appelez les scripts à partir de vos outils d'analyse pour exploiter les fonctionnalités orientées objet du langage de programmation Python sur le serveur. Pour préparer l'environnement AX Serveur à exécuter des scripts Python, vous devez d'abord installer Python, puis définir la variable d'environnement PYTHONPATH.

Conditions préalables

Pour exécuter des scripts Python sur AX Serveur, vous devez :

Installer une version prise en charge du langage de script Python sur votre ordinateur AX Serveur.
Définir la variable d'environnement PYTHONPATH sur AX Serveur.
Dans ACL Analytics, créer un projet à utiliser et l'importer dans AX Serveur.

Remarque

Pour vous aider à remplir ces conditions préalables, contactez votre administrateur Analytics Exchange et reportez-vous aux rubriques suivantes :

Créer un script Python

Une fois votre projet ACL créé dans ACL Analytics, créez un script Python que vous pouvez appeler à partir d'un outil d'analyse.

Ensuite, donnez à votre administrateur Analytics Exchange ce fichier de script à charger dans le répertoire PYTHONPATH du système hébergeant AX Serveur avant que vous appeliez le script à partir d'un outil d'analyse. Lorsque l'outil d'analyse s'exécute sur AX Serveur, l'exécutable Python recherche le script dans le répertoire PYTHONPATH, il doit donc être présent.

Exemple de fichier Python

L'exemple de fichier Python qui suit contient un script banal utilisant une expression lambda permettant d'élever un nombre à la puissance de lui-même. Cet exemple est destiné à montrer comment les scripts Python s'exécutent sur AX Serveur, et non à analyser les données avec Python.

Nom du fichier : lambda_example.py

# myFunc au carré de la valeur1 et retourne la valeur
myFunc = lambda valeur1: valeur1**2

Créer un script ACL

Dans votre projet ACL, créez un nouveau script à utiliser comme l'outil d'analyse que vous exécutez sur AX Serveur. Ce script fait ce qui suit :

Il ouvre une table simple nommée py avec un enregistrement.
Vous devez ouvrir une table pour exécuter la commande GROUP dans ACL, ici la table py est utilisée uniquement à cette fin.
S'exécute en boucle 10 fois et à chaque boucle, il exécute le script Python en transmettant le compteur d'incrémentation sous forme d'argument et en extrayant la sortie vers une table de résultats.

Ajouter l'en-tête de l'outil d'analyse

Ajoutez les en-têtes d'outil d'analyse appropriés au début du script pour que le script ACL puisse s'exécuter sur AX Serveur après l'importation de votre App Analyse :

COMMENT
//ANALYTIC Intégration Python Test 
 Vérifier l'intégration Python sur AX Serveur
//DATA py
//DATA résultats
//RESULT TABLE résultats
END

Ajouter la logique du script

SET SAFETY OFF
DEL ALL OK
CLOSE

OPEN py

GROUP
  ASSIGN v_max = 11
  ASSIGN v_counter = 1
  LOOP WHILE v_counter < v_max
    EXTRACT PYNUMERIC("lambda_example,myFunc",0,v_counter) AS "Valeur Résultats" TO "results.fil"
    v_counter = v_counter + 1
  END
END
CLOSE py

Le script complet de l'outil d'analyse

Le script complet de l'outil d'analyse que vous exécutez sur AX Serveur ressemble à celui-ci :

COMMENT
//ANALYTIC Intégration Python Test 
 Vérifier l'intégration Python sur AX Serveur
//DATA py
//DATA résultats
//RESULT TABLE résultats
END

SET SAFETY OFF
DEL ALL OK
CLOSE

OPEN py

GROUP
  ASSIGN v_max = 11
  ASSIGN v_counter = 1
  LOOP WHILE v_counter < v_max
    EXTRACT PYNUMERIC("lambda_example,myFunc",0,v_counter) AS "Valeur Résultats" TO "results.fil"
    v_counter = v_counter + 1
  END
END
CLOSE py

Importer le projet ACL

Une fois que vous avez créé le script de l'outil d'analyse :

Dans AX Client, créez une collection et un dossier pour héberger le projet ACL.
Pour importer le projet :
1. Cliquez avec le bouton droit de la souris sur le dossier et sélectionnez Importer.
2. Accédez à votre projet ACL sur votre ordinateur local, sélectionnez le fichier de projet .acl, puis cliquez sur Ouvrir.
  Remarque
  Assurez-vous d'importer les fichiers de données sources pour importer la table py avec votre projet ACL.

Explorateur de serveur après l'importation

NomCollection
- NomDossier
  - Apps Analyse
    - NomProjetACL
      - NomScriptOutildanalyse
  - Données
    - py
  - Fichiers associés

Exécuter l'outil d'analyse

Dans l'Explorateur de serveur d'AX Client, cliquez avec le bouton droit de la souris sur l'outil d'analyse, puis sélectionnez Exécuter. Le script Python est exécuté dans le cadre de l'outil d'analyse et vous pouvez accéder aux résultats à la table de résultats à partir du Client Web d'AX.

Remarque

Lorsque le script s'exécute, l'exécutable Python recherche le fichier du script dans le répertoire PYTHONPATH du serveur hébergeant AX Serveur. Si votre administrateur Analytics Exchange n'a pas chargé le fichier dans ce répertoire, l'outil d'analyse échoue.

Résultats

Explorateur de serveur après l'exécution de l'outil d'analyse

NomCollection
- NomDossier
  - Apps Analyse
    - NomProjetACL
      - NomScriptOutildanalyse
  - Données
    - py
    - résultats
  - Fichiers associés

Table de résultats

Valeur des résultats
1
4
9
16
25
36
49
64
81
100

[ Retour au début ]