Für die Entwicklung eines Analyseskripts wird empfohlen, zuerst ein normales Skript in Analytics zu erstellen und zu testen. Sobald das Skript ordnungsgemäß funktioniert, fügen Sie den Analysekopf hinzu, um das Skript in ein Analyseskript zu konvertieren, das in Robots ausgeführt werden kann.
Informationen zum Erstellen normaler Skripts finden Sie unter Erste Schritte mit Skripting.
Note
Version 16 of Analytics, and all subsequent versions, are not intended for use with Analytics Exchange (AX). Diligent ended support for Analytics Exchange on January 1, 2023. Learn more or upgrade to Robots.
For information about using Analytics in conjunction with Analytics Exchange, see Analytics and ACLScript 15.1 Help.
Skripteingaben und -ausgaben identifizieren
Im Analysekopf müssen Sie alle Skripteingaben und alle Skriptausgaben mit Analysetags deklarieren, die Sie Endbenutzern zur Verfügung stellen oder als Eingabe für nachfolgende Skripte verwenden möchten. Im Folgenden werden die verschiedenen Arten von Ein- und Ausgaben beschrieben, mit den zugehörigen Analysetags in Klammern.
Tipp
Wenn Sie die erforderlichen Ein- und Ausgaben vorab identifizieren, wird die Entwicklung reibungsloser.
| Eingaben | Ausgaben |
|---|---|
|
|
Skripteingaben und -ausgaben – Übersicht
Das folgende Diagramm veranschaulicht alle möglichen Ein- und Ausgaben eines Analyseskripts. Jede Eingabe oder Ausgabe zeigt:
- den damit verbundenen Datentyp oder die Benutzereingabe
- das zugehörige Analysetag (falls anwendbar)
- die zugehörigen ACLScript-Befehle
- den Speicherort der Eingabe- oder Ausgabedaten, -tabellen oder -dateien
In Abhängigkeit von seinem Entwurf und Zweck kann ein einzelnes Analyseskript mehrere unterschiedliche Ein- und Ausgaben haben.
Zugriff auf Quelldaten
Es gibt zwei grundlegende Ansätze, um auf Quelldaten zuzugreifen, die durch ein Analyseskript benötigt werden:
- Automatisierte Konnektivität
- Manuelles Hochladen
Falls notwendig, können Sie beide Ansätze in demselben Analyseskript verwenden.
Automatisierte Konnektivität
Der Vorteil dieses Ansatzes besteht darin, dass Datenimporte in Robots vollständig automatisiert werden können, was das automatische Ausführen im Rahmen eines Ablaufplans beinhaltet.
Im Textkörper des Analyseskripts verwenden Sie einen der ACLScript-Befehle, um sich mit einer externen Datenquelle zu verbinden, Daten zu importieren und mit einer Kopie der Daten eine Analytics-Tabelle zu erstellen.
Hinweis
Diese Befehle benötigen keinen korrespondierenden Analysetag im Analysekopf.
Verwenden Sie ACCESSDATA, es sei denn, es gibt einen Grund, einen der anderen Befehle zu verwenden. DEFINE TABLE DB ist ein älterer Befehl, der aus Gründen der Abwärtskompatibilität mit älteren Skripten beibehalten wird.
Manuelles Hochladen
Das manuelle Hochladen ist eine einfache Möglichkeit, um Daten in Robots zu importieren. Es empfiehlt sich unter Umständen, falls Benutzer lokal gespeicherte Quelldatendateien besitzen.
Sie können nicht aus Analytics stammende Dateien, wie Excel-Dateien oder Dateien mit Trennzeichen, manuell in Robots hochladen. Um Analytics-Tabellen verfügbar zu machen, müssen Sie eine andere Methode verwenden.
- Nicht aus Analytics stammende Dateien Sie können nicht aus Analytics stammende Dateien, wie Excel-Dateien oder Dateien mit Trennzeichen, manuell in die Registerkarte Eingabe/Ausgabe eines Robots hochladen. Um auf die hochgeladenen Daten in einem Analyseskript zuzugreifen, verwenden Sie im Analysekopf den FILE-Tag und im Skript einen entsprechenden Importbefehl, wie beispielsweise IMPORT EXCEL.
- Analytics-Tabellen Sie können Analytics-Tabellen nicht manuell in die Registerkarte Eingabe/Ausgabe hochladen. Verwenden Sie stattdessen im Analysekopf ein Tag DATA, um eine Analytics-Ausgabetabelle in der Registerkarte Eingabe/Ausgabe zu speichern. Um auf die Analytics-Tabelle in einem späteren Skript zuzugreifen, verwenden Sie den Befehl OPEN im Textkörper des Skripts.
Workflow zum Erstellen und Testen von Analyseskripts
Hinweis
Der folgende Workflow ist ein vorgeschlagener Ansatz für die Entwicklung von Analyseskripts. Sie können Analyseskripts jedoch so entwickeln, wie es für Sie am einfachsten ist.
Analytics-Skript erstellen
Erstellen Sie ein Skript in Analytics, ohne benutzerdefinierte Dialogfelder für die Benutzereingaben oder sonstige Funktionen einzusetzen, die während der Ausführung des Skripts einen Benutzereingriff erfordern. Analyseskripts gestatten Benutzereingaben vor der Skriptausführung. Im Gegensatz zu normalen Skripts unterstützen sie jedoch während der Skriptausführung keine Benutzereingriffe.
Um Eingabewerte im Analytics-Skript zu speichern, erstellen Sie temporäre Variablen oben im Skript. Beispiel:
ASSIGN v_Analysetabelle = "Trans_Mai"
Testen und debuggen Sie das Skript, bis es fehlerfrei abläuft.
Analysekopf und -tags hinzufügen
Fügen Sie dem Skript einen Analysekopf hinzu. Kopieren Sie die Variablennamen vom Beginn des Skripts in die entsprechenden Tags des Analysekopf-Designers.
Ein Beispiel eines entstehenden Tags im Analysekopf:
//TABLE v_Analysetabelle "Zu klassifizierende Tabelle"
Weitere Informationen finden Sie unter Mit Analyseköpfen arbeiten.
Protokoll in die Ergebnisse von Analyseskripts aufnehmen
Das Protokoll ist ein entscheidendes Werkzeug zur Fehlerdiagnose in Analyseskripts. Es kann auch wichtig sein, wenn Analyseskripts erfolgreich sind, aber unerwartete Ergebnisse liefern. Das Protokoll wird beim Scheitern eines Analyseskripts automatisch ausgegeben. Wenn ein Analyseskript erfolgreich ist, wird das Protokoll jedoch nur ausgegeben, wenn Sie den Analysetag RESULT angeben.
Aktivieren Sie im Analysekopf-Designer die Option Protokolldatei behalten, um sicherzustellen, dass bei jeder Ausführung des Analyseskripts ein Protokoll verfügbar ist. Das entsprechende Tag wird dem Analysekopf hinzugefügt:
//RESULT LOG
Analysekopf validieren
Validieren Sie den Analysekopf. Sie können den Analysekopf so oft validieren, wie Sie möchten.
Weitere Informationen finden Sie unter Analyseköpfe validieren.
Den Analysetags temporäre Testwerte zuweisen
Verwenden Sie den besonderen Zuweisungsoperator (:=), und weisen Sie allen Analysetags, die Benutzereingaben erfordern, temporäre Testwerte zu. Sie können die Testwerte der temporären Variablenzuweisungen oben in das Skript kopieren. Beispiel:
//TABLE v_Analysetabelle "Zu klassifizierende Tabelle" := "Trans_Mai"
Um temporäre Testwerte mit dem Analysekopf-Designer zuzuweisen, geben Sie den Wert in das Feld Testwert für alle Analysetags ein, die Benutzereingaben benötigen.
Weitere Informationen über das Zuweisen temporärer Testwerte finden Sie unter Testeingabewerte in Analytics festlegen.
Temporäre Variablen löschen
Löschen Sie die temporären Variablen oben in Ihrem Skript oder kommentieren Sie sie aus, wenn Sie sie vielleicht später wieder verwenden möchten.
Analyseskripts schrittweise ausführen
Durchlaufen Sie das Analyseskript schrittweise, indem Sie auf Schritt 
klicken oder wiederholt F10 drücken. Überprüfen Sie die Inhalte der Registerkarte Variablen im Navigator, um sicherzustellen, dass alle Variablen im Analysekopf korrekt erstellt und die Testwerte richtig zugewiesen wurden.
Testen und debuggen Sie das Analyseskript, bis es fehlerfrei abläuft.
Hinweis
Wenn Sie das Analyseskript vor seinem Ende verlassen möchten, drücken Sie Esc und klicken in der Bestätigungsmeldung auf Ja.
Tipp
Sie können alle gespeicherten Variablen und Variablenzuweisungen aus dem Analytics-Projekt löschen, indem Sie in der Befehlszeile DELETE ALL OK eingeben. Indem Sie die Registerkarte Variablen vor dem schrittweise Durchlaufen eines Analyseskripts löschen, stellen Sie einen sauberen erneuten Start sicher.
Temporäre Testwerte löschen
Sobald Sie die Tests beendet haben, können Sie die temporären Testwerte und den besonderen Zuweisungsoperator aus allen Analysetags löschen. Falls Sie erwarten, dass zusätzliche Tests notwendig sind, können Sie sie beibehalten. Testwerte werden in Bereitstellungsumgebungen ignoriert.
Analyseskript bereitstellen
Um das Analyseskript bereitzustellen, übermitteln Sie das Skript an Robots.
Weitere Informationen finden Sie unter ACL-Skripts an Robots übermitteln (hochladen).
