ACL-Skripts an Robots übermitteln (hochladen)

Für die Übermittlung, oder das Hochladen, von ACL-Skripts an die Robots-App sind zwei verschiedene Methoden verfügbar:

  • Skripts aus Analytics an Robots übermitteln

  • Mit Robots ACL-Skripts hochladen

    Hinweis

    Diese Methode der Verwendung von Robots zum Hochladen von ACL-Skripts ist nicht dasselbe wie die Verwendung von Robots zum erstmaligen Hochladen von ACL-Skripts in einen neu erstellten Robot. Weitere Informationen finden Sie unter Skript-Automatisierung zu einem Robot hinzufügen.

Vergleich der Methoden

Jede Methode zum Übermitteln von Skripts liefert dasselbe Endergebnis: Eine neue Version der Skripts wird auf dem Ziel-Robot erstellt. Zwischen den Methoden bestehen jedoch folgende Unterschiede:

  • Syntaxvalidierung Die automatische Syntaxvalidierung wird durchgeführt, wenn Sie Skripts aus Analytics übermitteln. Wenn Sie mit Robots Skripts hochladen, erfolgt keine Validierung.

  • Projekt-Robot-Zuordnung Das Analytics-Projekt, das die Skripts enthält, und der Ziel-Robot werden automatisch zugeordnet, wenn Sie Skripts aus Analytics übermitteln. Wenn Sie mit Robots Skripts hochladen, erfolgt keine Zuordnung.

Die Syntaxvalidierung und die Projekt-Robot-Zuordnung sind nützliche Funktionen, daher ist die empfohlene Vorgehensweise Skripts aus Analytics an Robots zu übermitteln. Sie können das Hochladen aus Robots heraus als praktische Funktion verwenden, nachdem eine Projekt-Robots-Zuordnung hergestellt wurde, und für kleinere Skriptaktualisierungen, bei denen die Umgehung der Syntaxvalidierung weniger problematisch ist.

So funktioniert das Übermitteln von Skripts

Wenn Sie Skripts an die Robots-App übertragen, werden alle Skripts im Analytics-Projekt übertragen und bilden zusammen eine „Version“ im zugehörigen ACL-Robot. Sie können nicht selektiv Skripts eines Projekts übermitteln. Weitere Informationen finden Sie unter Workflow für die ACL-Skript-Entwicklung in Analytics und Robots.

Um Skripts an Robots zu übermitteln, muss Ihnen die entsprechende Rolle in der Robots-App zugewiesen sein. Weitere Informationen finden Sie unter Berechtigungen der Robots-App.

Skripts aus Analytics an Robots übermitteln

Es gibt mehrere Möglichkeiten, wenn Sie Skripts aus Analytics an einen ACL-Robot in der Robots-App übertragen oder hochladen.

Der einfachste Weg, die verschiedenen Möglichkeiten zu verstehen, ist, sich ein Analytics-Projekt und einen ACL-Robot als zwei Container vorzustellen, die jeweils Skripts enthalten, die miteinander verknüpft werden können. Sobald sie zugeordnet sind, können Sie aufeinanderfolgende Versionen der Skripts aus dem Projekt an den Robot übermitteln.

Aktion Ergebnis nach der Übermittlung
Skripts an einen neuen ACL-Robot übertragen

Ein neuer ACL-Robot wird erstellt, der Version 1 der übertragenen Skripts enthält.
Skripts an bestehenden ACL-Robot übertragen

Der bestehende ACL-Robot enthält die übertragenen Skripts mit einer Versionsnummer, die davon abhängt, ob der Robot bereits Skripts enthält.
Bearbeitete Skripts an einen ACL-Robot übertragen

Eine neue Version der Skripts wird an den ACL-Robot übertragen, der dem Projekt zugeordnet ist.
Skripts an einen anderen ACL-Robot übertragen

Die Skripts werden entweder an einen neu erstellten oder einen bestehende ACL-Robot übertragen.

Die Zuordnung zwischen dem Projekt und dem vorherigen Robot ist gelöscht.

Skripts an einen neuen ACL-Robot übertragen

Überträgt Skripts zum ersten Mal an die Robots-App, um einen neuen ACL-Robot zu erstellen, der die übertragenen Skripts enthält.

  1. Öffnen Sie auf Ihrem Computer das Analytics-Projekt, das die Skripts enthält.

  2. Wählen Sie aus dem Analytics-Hauptmenü Datei > Skripts übermitteln aus.

    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. Geben Sie einen Namen in das Feld Neuer Robot ein, und klicken Sie auf Erstellen.

    Der Robot wird erstellt, und eine Robot-ID wird automatisch generiert.

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

    Hinweis

    Verwenden Sie nicht die folgenden Zeichen innerhalb des Robot-Namens: „$“, „€“.

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

    Version 1 der Skripts wurde an den neu erstellten Robot übermittelt. Die Skripts existieren zu diesem Zeitpunkt nur im Entwicklermodus.

  6. Optional. Im Dialogfeld Skripts wurden erfolgreich übermittelt klicken Sie auf einen der Links, um den neu erstellten Robot oder die übermittelten Skripts anzuschauen.
  7. Klicken Sie auf OK, um das Dialogfeld zu verlassen.

Skripts an bestehenden ACL-Robot übertragen

Überträgt Skripts auf einen bereits vorhandenen ACL-Robot, um den Robot mit Daten zu versehen. Der existierende Robot kann schon Skripts enthalten oder leer sein.

Hinweis

Verwenden Sie diese Methode, wenn das Projekt noch keinem Robot zugeordnet ist. Falls das Projekt schon einem Robot zugeordnet ist, lesen Sie Skripts an einen anderen ACL-Robot übertragen.

  1. Öffnen Sie auf Ihrem Computer das Analytics-Projekt, das die Skripts enthält.

  2. Wählen Sie aus dem Analytics-Hauptmenü Datei > Skripts übermitteln aus.

    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 werden an den bestehenden Robot übermittelt. Die Versionsnummer der Skripts hängt davon ab, ob der Robot bereits Skripts enthielt oder ob er zuvor leer war.

    Die Skripts existieren zu diesem Zeitpunkt nur im Entwicklermodus.

  6. Optional. Im Dialogfeld Skripts wurden erfolgreich übermittelt klicken Sie auf einen der Links, um den bestehenden Robot oder die übermittelten Skripts anzuschauen.
  7. Klicken Sie auf OK, um das Dialogfeld zu verlassen.

Bearbeitete Skripts an einen ACL-Robot übertragen

Überträgt bearbeitete Skripts, um eine neue Version der Skripts im zugehörigen ACL-Robot zu erstellen.

Es gibt zwei Methoden für die Bearbeitung von Skripts vor der Übermittlung. Sie können die Skripts im zugeordneten Projekt bearbeiten oder sie von Robots in ein neues Analytics-Projekt herunterladen und die Skripts im neuen Projekt bearbeiten.

Hinweis

Es empfiehlt sich, die Skripts von Robots herunterzuladen, bevor Sie eine Bearbeitung beginnen. Sie können dann sicher sein, dass die heruntergeladenen Skripts nicht verändert wurden, was bei lokal gespeicherten Skripts nicht der Fall ist.

Während einer einzelnen Skripterstellungssitzung ist es in der Regel sicher, iterative Versionen der Skripts direkt an das Projekt zu übermitteln, falls Sie die einzige Person sind, die an den Skripts arbeitet. In diesem Fall müssen Sie zwischen den Iterationen die Skripts nicht herunterladen.

Skripts aus Robots herunterladen

Führen Sie diesen Teil des Verfahrens durch, wenn Sie mit Skripts in Robots statt Skripts auf Ihrem lokalen Computer arbeiten möchten.

  1. Wählen Sie auf der Launchpad-Startseite (www.highbond.com) die Robots-App aus, um sie zu öffnen.

    Wenn Sie sich bereits in Diligent One befinden, können Sie über das linke Navigationsmenü zur Robots-App wechseln.

  2. Wählen Sie im Dashboard in Robots ACL Robots aus.
  3. Navigieren Sie zu dem Robot, der die Skripts enthält, die Sie herunterladen möchten, und wählen Sie den Robot aus, um ihn zu öffnen.

  4. Klicken Sie oben rechts im Robot auf Produktion bzw. Entwicklung, um den jeweiligen Modus auszuwählen.

    Weitere Informationen finden Sie unter Entwicklungsmodus und Produktionsmodus in der Robots-App.

  5. Führen Sie einen der folgenden Schritte aus:

    • Aktuell aktivierte Skriptversion herunterladen

      Klicken Sie im Produktionsmodus auf Robot herunterladen.

    • Aktuelle Entwicklungsskriptversion herunterladen

      Klicken Sie im Entwicklermodus auf Robot herunterladen.

    • Frühere Skriptversion herunterladen

      1. Wählen Sie im Entwicklermodus die Registerkarte Skriptversionen aus.

      2. Wählen Sie in der Liste Skriptversionen die Version aus, die Sie herunterladen möchten.

      3. Klicken Sie im Bereich Versionsdetails auf Herunterladen.

    Die Skripts werden in den Standard-Downloadordner Ihres Computers heruntergeladen. Die Skripts sind in einem neu erstellten Analytics-Projekt enthalten, das denselben Namen wie der Robot aufweist, von dem Sie sie heruntergeladen haben. Das Projekt und der Robot werden automatisch zugeordnet.

    Anmerkung

    Der Robot ist nun zwei Projekten zugeordnet: dem Projekt, das durch den Download gerade erstellt wurde, und dem zuvor zum Übermitteln der Skripts verwendeten Projekt. Ein Robot kann mehreren Projekten zugeordnet sein.

  6. Optional. Verschieben Sie das Projekt mit dem heruntergeladenen Skript, wenn Sie in einem anderen Ordner mit ihm arbeiten möchten.

Skripts in Analytics bearbeiten und übermitteln

  1. Öffnen Sie auf Ihrem Computer das Analytics-Projekt, das die Skripts enthält.

  2. Bearbeiten Sie die Skripts, und speichern Sie Ihre Änderungen.

    Hinweis

    Sie können, falls notwendig, auch Skripts hinzufügen oder löschen.

  3. 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.

  4. Geben Sie eine kurze Übermittlungsnachricht ein, welche die Änderung der übermittelten Skripts beschreibt, und klicken Sie auf OK.

    Die Skripts werden an den zugeordneten Robot übermittelt, wo sie als neue Version gespeichert werden. Bestehende Versionen der Skripts im Robot werden nicht überschrieben.

    Wenn eine Fehlermeldung angezeigt wird, die besagt, dass der zugeordnete Robot nicht gefunden wurde, prüfen Sie, ob der Robot in Robots vorhanden ist und ob Ihre Rolle die Übermittlung von Skripts zulässt.

  5. Optional. Im Dialogfeld Skripts wurden erfolgreich übermittelt klicken Sie auf einen der Links, um den Robot oder die neue Version der Skripts anzuschauen.
  6. Klicken Sie auf OK, um das Dialogfeld zu verlassen.

Skripts an einen anderen ACL-Robot übertragen

Überträgt Skripts an einen anderen ACL-Robot, um dem Robot eine Version der Skripts hinzuzufügen und um den mit dem Projekt verbundenen Robot zu ändern. Die Skripts können bearbeitet oder unbearbeitet sein.

Zur Übermittlung von Skripts an einen anderen Robot gibt es zwei Möglichkeiten:

  • Skripts an einen neuen Robot übermitteln
  • Skripts an bestehenden Robot übermitteln

  1. Öffnen Sie auf Ihrem Computer das Analytics-Projekt, das die Skripts enthält.

  2. Wählen Sie aus dem Analytics-Hauptmenü Datei > Skripts übermitteln als aus.

    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, navigieren Sie im Dialogfeld Ziel auswählen zur jeweiligen Diligent One-Instanz.

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

  4. Führen Sie einen der folgenden Schritte aus:
    • Skripts an einen neuen Robot übermitteln Geben Sie einen Namen in das Feld Neuer Robot ein, und klicken Sie auf Erstellen.

      Der Robot wird erstellt, und eine Robot-ID wird automatisch generiert. Das Analytics-Projekt, welches die Skripts enthält, ist nun dem neuen Robot zugeordnet.

      Anmerkung

      Verwenden Sie nicht die folgenden Zeichen innerhalb des Robot-Namens: „$“, „€“.

    • Skripts an bestehenden Robot übermitteln 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, welches die Skripts enthält, ist nun dem bestehenden Robot zugeordnet.

    Die Zuordnung zwischen dem Projekt und dem vorherigen Robot ist gelöscht.

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

    Die Skripts werden an den neu erstellten oder den bestehenden Robot übermittelt. Die Versionsnummer der Skripts hängt davon ab, ob der Robot bereits Skripts enthielt oder ob er zuvor leer war.

    Die Skripts existieren zu diesem Zeitpunkt nur im Entwicklermodus.

  6. Optional. Im Dialogfeld Skripts wurden erfolgreich übermittelt klicken Sie auf einen der Links, um den neu erstellten oder bestehenden Robot bzw. die übermittelten Skripts anzuschauen.
  7. Klicken Sie auf OK, um das Dialogfeld zu verlassen.

Mit Robots ACL-Skripts hochladen

Sie können Robots verwenden, um ACL-Skripts herunterzuladen, ohne Analytics öffnen zu müssen. Diese Methode zum Hochladen von Skripts umgeht die Syntaxvalidierung, daher sollten Sie sie nur zum Hochladen kleiner Skriptaktualisierungen zuvor validierter Skripts verwenden.

Hinweis

Diese Methode steht für das erste Hochladen von ACL-Skripts in einen neu erstellen Robot nicht zur Verfügung.

  1. Wählen Sie auf der Launchpad-Startseite (www.highbond.com) die Robots-App aus, um sie zu öffnen.

    Wenn Sie sich bereits in Diligent One befinden, können Sie über das linke Navigationsmenü zur Robots-App wechseln.

  2. Wählen Sie im Dashboard in Robots ACL Robots aus.

  3. Klicken Sie auf einen ACL-Robot, um ihn zu öffnen.

  4. Klicken Sie in der oberen rechten Ecke des Robot auf Entwicklung, um in den Entwicklermodus zu wechseln.

  5. Klicken Sie auf der Registerkarte Skriptversionen auf Hochladen.

  6. Führen Sie im angezeigten Dialogfeld Folgendes aus:

    1. Klicken Sie auf wählen Sie auf Ihrem Computer aus und navigieren Sie zum Analytics-Projekt, das die Skripts enthält.

    2. Wählen Sie das Projekt und klicken Sie auf Öffnen.

      Sie können das Analytics-Projekt auch in den Bereich Hochgeladenes Skript ziehen.

  7. Geben Sie eine Übermittlungsnachricht ein und klicken Sie auf Hochladen und übermitteln.

    Die Skripts werden zu dem Robot hochgeladen und erstellen eine neue Skriptversion oben in der Liste Skriptversionen.