Skripts von AX in die Robots-App migrieren

Wichtig

Fahren Sie mit der Migration von Skripts erst dann fort, wenn Sie die vorherige Migrationsphase abgeschlossen haben. Weitere Informationen finden Sie unter AX-Repository-Struktur in der Robots-App neu erstellen.

Für jeden automatisierten Prozess in AX, den Sie in der Robots-App neu erstellen möchten, müssen Sie die zugehörigen Skripts migrieren. Sie müssen alle Analyseskripts und alle Unterskripts bzw. Hilfsskripts migrieren.

Skripts lassen sich nicht direkt von AX in die Robots-App migrieren. Skripts müssen zuerst von AX in einen vorübergehenden Speicherort, auf dem Analytics installiert wurde, exportiert werden. Sie könnten dafür beispielsweise Ihren eigenen Computer verwenden. Nachdem Sie möglicherweise notwendige Vorbereitungen abgeschlossen haben, können Sie die Skripts aus dem vorübergehenden Speicherort in die Robots-App übermitteln (hochladen).

Abwärtskompatibilität der Robots-App

Im Allgemeinen ist die Robots-App für eine möglichst umfassende Abwärtskompatibilität mit AX konzipiert. Die meisten AX-Skripts sollten ohne Veränderungen auch in der Robots-App funktionieren.

Falls Skripts ein AX-spezifisches Design voraussetzen, müssen sie angepasst werden. Beispiel:

  • Skripts, welche auf die AX-Betriebsdatenbank zum Lesen von Ablaufplänen für Jobs oder Protokollen zugreifen
  • Skripts mit absoluten Pfaden auf Serverressourcen, die auf dem Robots-Agent-Server nicht mehr gültig sind

Falls Sie Hilfe bei der Anpassung von Analyseskripts zur Verwendung in der Robots-App benötigen, setzen Sie sich bitte mit dem Diligent-Support in Verbindung.

Skripts von AX exportieren

Zu Beginn der Migration verwenden Sie die Option Exportieren, um Skripts aus AX zu exportieren. Skripts werden in die Analyse-App exportiert, die sie enthält. Jede exportierte Analyse-App wird im Exportziel zu einem eigenständigen Analytics-Projekt.

Das folgende Verfahren geht davon aus, dass Sie Ihren eigenen Computer als vorübergehenden Speicherordner nutzen.

  1. Erstellen Sie auf Ihrem Computer einen Ordner zur Speicherung der exportierten Skripts.
  2. Wählen Sie im Server-Explorer die Analyse-App mit den Skripts aus, die Sie exportieren möchten.

    Um mehrere Analyse-Apps in demselben übergeordneten Ordner Analyse-App auszuwählen, verwenden Sie Strg+Anklicken. Alternativ wählen Sie den übergeordneten Ordner aus, um alle Analyse-Apps innerhalb des Ordners zu exportieren.

  3. Wählen Sie Datei > Exportieren.
  4. Im Dialogfeld Exportieren stellen Sie sicher, dass die folgenden beiden Optionen nicht ausgewählt sind:
    • Möchten Sie mit den exportierten Dateien arbeiten?
    • Sollen die Datendateien zusammen mit den ausgewählten Definitionen exportiert werden?
  5. Klicken Sie auf Durchsuchen, wählen Sie den Ordner aus, den Sie zur Speicherung der Skripts erstellt haben, und klicken Sie auf OK.
  6. Klicken Sie auf OK, um ein oder mehrere Analyse-Apps zu exportieren.

    Die Skripts werden in ihrer Analyse-App in den angegebenen Speicherort exportiert. Jede Analyse-App wird in ein Analytics-Projekt konvertiert.

  7. Wiederholen Sie diesen Vorgang für zusätzliche Skripts, die zur Migration bereit sind.

Verknüpfte Analyseskripts

Im Gegensatz zu AX unterstützt die Robots-App keine verknüpften Analyseskripts. Wenn Sie verknüpfte Analyseskripts in AX verwenden, exportieren Sie das Hauptanalyseskript und übermitteln es in jeden Robot, in dem es benötigt wird.

Notwendige Vorbereitungsarbeiten durchführen

Nach dem Export aus AX können Skripts in die Robots-App übermittelt werden, wenn

  • sich alle zum automatisierten Prozess gehörenden Skripts in einem einzelnen Analytics-Projekt befinden und
  • alle Analyseskripts, die in einem automatisierten Prozess sequenziell ausgeführt werden müssen,
    • ein angemessenes alphanumerisches Benennungsschema verwenden und
    • im Falle einer Implementierung einen angemessenen Analysetyp haben.

Analyseketten

Im Gegensatz zu AX unterstützt die Robots-App keine Analyseketten. Wenn Sie Analyseketten verwenden, müssen Sie unter Umständen einige Vorbereitungsarbeiten durchführen, bevor Skripts zum Übermitteln in die Robots-App bereit sind. Weitere Informationen finden Sie unter Analyseketten in der Robots-App replizieren.

Skripts in die Robots-App übermitteln (hochladen)

Sobald sich alle zum automatisierten Prozess gehörenden Skripts in einem einzelnen Analytics-Projekt befinden und angemessene Namen haben, können Sie sie in die Robots-App übermitteln.

Durch die Übermittlung von Skripts werden diese von einer lokalen Umgebung in die cloudbasierte Robots-App hochgeladen. Wir verwenden lieber den Begriff „übermitteln“ statt „hochladen“, weil Sie bei jeder Übermittlung von Skripts in denselben Robot eine neue Version der Skripts im Skriptverlauf erstellen.

Detaillierte Informationen finden Sie unter ACL-Skripts an Robots übermitteln (hochladen).

  1. Öffnen Sie das Analytics-Projekt mit den Skripts, die Sie übermitteln möchten.
  2. Wählen Sie aus dem Analytics-Hauptmenü Datei > Skripts übermitteln.

    Wenn eine Fehlermeldung angezeigt wird, besteht möglicherweise ein Problem mit dem Analysekopf oder der Skript-Syntax in einem oder mehreren Skripts im Projekt.

    Weitere Informationen finden Sie unter Workflow für die ACL-Skript-Entwicklung in Analytics und Robots.

  3. Falls notwendig, doppelklicken Sie im Dialogfeld Ziel auswählen auf die jeweilige Diligent One-Instanz.

    Die Robot-Sammlung wird mit der Liste bestehender Robots angezeigt.

  4. In der Liste der Robots wählen Sie den Robot aus, an den Sie die Skripts übermitteln möchten. Klicken Sie dann OK.

    Das Analytics-Projekt, das die Skripts enthält, und der bestehende Robot sind nun zugeordnet. Für zukünftige Übermittlungen muss daher nicht mehr der Robot manuell gefunden werden.

  5. Geben Sie eine kurze Übermittlungsnachricht ein, welche die übermittelten Skripts beschreibt, und klicken Sie auf OK.

    Die Skripts sind nun in den Entwicklermodus des Robots übermittelt.

  6. Klicken Sie im Dialogfeld Skripts wurden erfolgreich übermittelt auf den zweiten Link, um die neu in die Robots-App übermittelten Skripts zu sehen.

    Die Registerkarte Skriptversionen mit den übermittelten Skriptversionen wird geöffnet.

  7. Wählen Sie die Skriptversion aus (Vn).

    Der Seitenbereich Versionsdetails wird geöffnet. Die Namen der einzelnen Analyseskripts und Hilfsskripts sind unter Änderungen an der Skriptversion aufgelistet.

  8. Klicken Sie in Analytics auf OK, um das Dialogfeld Skripts wurden erfolgreich übermittelt zu verlassen.

Analyseketten in der Robots-App replizieren

Hinweis

Dieser Abschnitt ist nur relevant, falls Sie Analyseketten in AX nutzen.

Im Gegensatz zu AX unterstützt die Robots-App gegenwärtig keine Erstellung einer Analysekette durch Analyseskripts im Repository, die dann sequenziell ausgeführt wird. Um eine Reihe von Analyseskripts in der Robots-App sequenziell auszuführen, müssen Sie zwei Dinge tun:

  • die Analyseskripts in einen einzelnen Robot aufnehmen und eine einzelne Aufgabe zur Ausführung der Skripts erstellen
  • Skriptnamen und Analysetypen zum Erstellen einer Skriptsequenz verwenden

Analyseskripts in einen einzelnen Robot aufnehmen

Nehmen Sie die Analyseskripts, die Sie sequenziell ausführen möchten, in einen einzelnen Robot auf.

Um die Skripts in einen einzigen Robot aufzunehmen, müssen Sie zuerst alle verbundenen Skripts in ein einzelnes Analytics-Projekt aufnehmen. Sie übermitteln die Skripts als ein einzelnes Paket namens Skriptversion aus dem Analytics-Projekt in den Robot.

Sobald sich die Skripts in einem einzigen Robot befinden, erstellen Sie eine einzelne Aufgabe, um die Analysereihe auszuführen.

Zugehörige Skripts in ein einzelnes Analytics-Projekt aufnehmen

Wenn die zu einem einzelnen automatisierten Prozess gehörenden Skripts auf zwei oder mehr Analytics-Projekte verteilt sind, müssen Sie die Skripts zuerst in einem einzelnen Projekt vereinigen, bevor Sie sie in die Robots-App übermitteln können. Hierzu könnte es kommen, wenn Analyseskripts in AX einer Analysekette angehören.

  1. Öffnen Sie das Analytics-Projekt, das Sie zur Aufnahme aller zum automatisierten Prozess gehörenden Skripts verwenden möchten.
  2. Im Navigator und der Registerkarte Übersicht klicken Sie oben in der Baumansicht mit der rechten Maustaste auf den Projektnamen und wählen Aus einem anderen Projekt kopieren > Skript.
  3. Navigieren Sie im Dialogfeld Projektdatei suchen zum entsprechenden Analytics-Projekt, aus dem Sie ein oder mehrere Skripts kopieren möchten, und klicken Sie auf Öffnen.
  4. Im Dialogfeld Importieren führen Sie einen der folgenden Schritte aus, um ein oder mehrere Skripts der Liste Nach Projektname hinzuzufügen:
    • Doppelklicken Sie auf ein Skript.
    • Klicken Sie mit gehaltener Strg-Taste auf mehrere Skripts und klicken dann auf den Pfeil nach rechts.
    • Klicken Sie auf Alle hinzufügen, um alle Skripts hinzuzufügen.
  5. Klicken Sie auf OK, um das Skript oder die Skripts in das Zielprojekt zu kopieren.

    Wenn ein Skript mit demselben Namen bereits im Projekt existiert, wird an das kopierte Skript ein aufsteigendes numerisches Suffix angehängt.

  6. Wiederholen Sie den Prozess für Skripts in anderen Projekten, die in das Zielprojekt aufgenommen werden müssen.

Skriptnamen und Analysetypen zum Erstellen einer Skriptsequenz verwenden

Skriptnamen

Analyseskripts werden alphanumerisch nach ihrem Namen in einer Robot-Aufgabe sortiert und in dieser Reihenfolge ausgeführt. Benennen Sie also die Analyseskripts so, dass die gewünschte Ausführungssequenz hergestellt wird.

Das erste Skript in der Sequenz könnte beispielsweise das Präfix „A_01“ haben, das zweite Skript „A_02“ bzw. „B_01“ usw. Durch ein Präfixsystem ist das spätere Einfügen zusätzlicher Skripts einfacher. Unterskripts oder Hilfsskripts müssen nicht sequenziell benannt werden.

Hinweis

Sie können Skripts in der Robots-App nicht umbenennen. Stellen Sie also sicher, dass alle Skripts in Analytics korrekt benannt sind, bevor Sie sie in die Robots-App übermitteln.

Analysetyp

Als zusätzliche Hilfe für das Sequenzieren können Sie optional einen Typ für Analyseskripts festlegen. Durch das Festlegen eines Typs werden Skripts in unterschiedlichen Bereichen einer Aufgabe gruppiert. Die Bereiche werden wie folgt angeordnet und nach der Reihe ausgeführt:

  • Import
  • Vorbereitung
  • Analyse

Innerhalb jedes Bereichs werden Skripts alphanumerisch sortiert. Unabhängig vom Skriptnamen führt eine Aufgabe alle Skripts eines Bereiches aus, bevor sie in den nächsten Bereich übergeht.

Weitere Informationen finden Sie unter ANALYTIC-Tag.

Analyseskripts umbenennen, um Ausführungssequenz zu erstellen

Wenn Sie möchten, dass zwei oder mehr Analyseskripts sequenziell ausgeführt werden, müssen sie so umbenannt werden, dass die gewünschte Ausführungssequenz hergestellt wird. Weitere Informationen finden Sie unter Analyseketten in der Robots-App replizieren.

Hinweis

Der im Analysekopf angegebene Analyseskriptname ist der Name, der in der Robots-App verwendet wird. Der Skriptname in der Registerkarte Übersicht des Navigators wird nicht verwendet.

  1. Öffnen Sie in Analytics das Analyseskript, das Sie umbenennen möchten.
  2. Im //ANALYTIC-Tag des Analysekopfes aktualisieren Sie den Analysenamen. Klicken Sie dann auf Projekt speichern .

    Weitere Informationen finden Sie unter ANALYTIC-Tag.

  3. Wiederholen Sie den Prozess für alle Analyseskripts, die umbenannt werden müssen.

Analysetyp zur Gruppierung der Analyseskripts festlegen

Wenn Sie Analyseskripts in unterschiedliche Bereiche Import, Vorbereitung und Analyse einer Aufgabe gruppieren möchten, müssen Sie für jedes Skript einen entsprechenden Analysetyp festlegen. Die Gruppierung von Analyseskripts ist eine weitere Option, eine Skriptsequenz zu erstellen. Sie ist aber nicht erforderlich. Weitere Informationen finden Sie unter Analyseketten in der Robots-App replizieren.

  1. Öffnen Sie in Analytics das Analyseskript, für das Sie einen Typ festlegen möchten.
  2. Im //ANALYTIC-Tag des Analysekopfes fügen Sie einen Analysetyp hinzu. Klicken Sie dann auf Projekt speichern .

    Weitere Informationen finden Sie unter ANALYTIC-Tag.

  3. Wiederholen Sie den Prozess für alle Analyseskripts, die einen Analysetyp benötigen.

Nächste Schritte

Sobald Sie die Skripts für einen oder mehrere automatisierte Prozesse migriert haben, können Sie mit der Migration von Daten beginnen: Von AX in die Robots-App migrieren.