Python-Skripts mit AX Server ausführen

Bitten Sie einen Administrator von ACL GRC Analytics Exchange, externe Python-Skripts in den PYTHONPATH-Ordner von AX Server hochzuladen. Rufen Sie die Skripts dann von Ihren Analysen auf, um die objektorientierten Funktionen der Python-Programmiersprache auf dem Server zu nutzen. Um die AX-Server-Umgebung auf die Ausführung von Python-Skripts vorzubereiten, müssen Sie zuerst Python installieren und dann die Umgebungsvariable PYTHONPATH erstellen.

Voraussetzungen

So führen Sie Python-Skripts mit AX Server aus:

Installieren Sie eine unterstützte Version der Python-Skriptsprache auf Ihrem AX-Server-Computer.
Stellen Sie die Umgebungsvariable PYTHONPATH auf AX Server ein.
Erstellen Sie in ACL Analytics ein Projekt, mit dem Sie arbeiten und das Sie auf AX Server importieren möchten.

Anmerkung

Wenn Sie bei der Erfüllung dieser Voraussetzungen Hilfe benötigen, setzen Sie sich mit Ihrem Administrator von ACL GRC Analytics Exchange in Verbindung und lesen:

Ein Python-Skript erstellen

Nachdem Sie Ihr ACL-Projekt in ACL Analytics erstellt haben, schreiben Sie ein Python-Skript, das Sie von einer Analyse aus aufrufen können.

Bitten Sie dann einen Administrator von ACL GRC Analytics Exchange, diese Skriptdatei in den PYTHONPATH-Ordner des Computers mit AX Server hochzuladen, bevor Sie das Skript von einer Analyse aufrufen. Wenn die Analyse auf AX Server ausgeführt wird, sucht die Python-Programmdatei das Skript im PYTHONPATH-Ordner, das sich also dort befinden muss.

Beispiel für Python-Datei

Das folgende Beispiel einer Python-Datei enthält ein einfaches Skript, das einen Lambda-Ausdruck enthält, um eine Zahl in ihre eigene Potenz zu erheben. Dieses Beispiel soll illustrieren, wie Python-Skripte auf AX Server ausgeführt werden und nicht wie Daten mit Python analysiert werden.

Dateiname: lambda_example.py

# myFunc berechnet das Quadrat von Wert1 und gibt den Wert zurück
myFunc = lambda value1: value1**2

Ein ACL-Skript erstellen

Erstellen Sie in Ihrem ACL-Projekt ein neues Skript, das Sie als Analyse auf AX Server ausführen lassen. Dieses Skript erledigt folgendes:

Öffnet eine einfache Tabelle namens py mit einem Datensatz.
Sie müssen eine Tabelle öffnen, um den Befehl GROUP in ACL ausführen zu können. Zu diesem Zweck wird hier die Tabelle py verwendet.
Es werden 10 Schleifen durchlaufen und in jeder Schleife wird das Python-Skript ausgeführt, indem der Zähler entsprechend erhöht wird und der Output in die Ergebnistabelle geschrieben wird.

Den Analysekopf hinzufügen

Fügen Sie am Anfang des Skripts die notwendigen Tags im Analysekopf hinzu, damit das ACL-Skript auf AX Server ausgeführt werden kann, nachdem Sie Ihre Analyse-App importiert haben:

COMMENT
//ANALYTIC Test der Python-Integration 
 Python-Integration auf AX Server überprüfen
//DATA py
//DATA Ergebnisse
//RESULT TABLE Ergebnisse
END

Die Skriptlogik hinzufügen

SET SAFETY OFF
DEL ALL OK
CLOSE

OPEN py

GROUP
  ASSIGN v_max = 11
  ASSIGN v_Zähler= 1
  LOOP WHILE v_Zähler < v_max
    EXTRACT PYNUMERIC("lambda_example,myFunc";0;v_Zähler) AS "Ergebniswerte" TO "Ergebnisse.fil"
    v_Zähler = v_Zähler + 1
  END
END
CLOSE py

Das vollständige Analyseskript

Die vollständige Analyse, die Sie auf AX Server ausführen, sieht wie folgt aus:

COMMENT
//ANALYTIC Test der Python-Integration 
 Python-Integration auf AX Server überprüfen
//DATA py
//DATA Ergebnisse
//RESULT TABLE Ergebnisse
END

SET SAFETY OFF
DEL ALL OK
CLOSE

OPEN py

GROUP
  ASSIGN v_max = 11
  ASSIGN v_Zähler= 1
  LOOP WHILE v_Zähler < v_max
    EXTRACT PYNUMERIC("lambda_example,myFunc";0;v_Zähler) AS "Ergebniswerte" TO "Ergebnisse.fil"
    v_Zähler = v_Zähler + 1
  END
END
CLOSE py

Das ACL-Projekt importieren

Sobald Sie das Analyseskript geschrieben haben, gehen Sie wie folgt vor:

Erstellen Sie eine Sammlung und einen Ordner in AX Client, in dem das ACL-Projekt abgelegt wird.
So importieren Sie das Projekt:
1. Klicken Sie mit der rechten Maustaste auf den erstellten Ordner, und wählen Sie Importieren.
2. Navigieren Sie zu Ihrem ACL-Projekt auf Ihrem lokalen Computer, wählen Sie die .acl-Projektdatei aus und klicken Sie auf Öffnen.
  Anmerkung
  Stellen Sie sicher, dass Sie die Quelldatendateien importieren, damit die py-Tabelle mit Ihrem ACL-Projekt importiert werden.

Server-Explorer nach dem Import

Sammlungsname
- Ordnername
  - Analyse-Apps
    - ACL-Projektname
      - analyticScriptName
  - Daten
    - py
  - Verbundene Dateien

Die Analyse ausführen

Im Server-Explorer von AX Client klicken Sie mit der rechten Maustaste auf die Analyse und wählen Ausführen. Das Python-Skript wird als ein Bestandteil der Analyse ausgeführt und Sie können auf die Ergebnistabelle Ergebnisse von AX Webclient aus zugreifen.

Anmerkung

Wenn die Analyse ausgeführt wird, sucht die Python-Programmdatei die Skriptdatei im PYTHONPATH-Ordner des Computers mit AX Server. Falls Ihr Administrator von ACL GRC Analytics Exchange die Datei nicht in dieses Verzeichnis hochgeladen hat, wird die Analyse fehlschlagen.

Ergebnisse

Server-Explorer nach Ausführung der Analyse

Sammlungsname
- Ordnername
  - Analyse-Apps
    - ACL-Projektname
      - analyticScriptName
  - Daten
    - py
    - Ergebnisse
  - Verbundene Dateien

Ergebnistabelle

Ergebniswert
1
4
9
16
25
36
49
64
81
100

[ Zurück an den Anfang ]