Skripts erstellen und bearbeiten

Zur Erstellung von Skripts stehen Ihnen mehrere Optionen zur Verfügung:

  • Skript-EditorBefehlssyntax im Fenster Skript-Editor eingeben.
  • BefehlsprotokollSkriptsyntax aus dem Befehlsprotokoll kopieren.
  • Skript-RekorderBefehlssyntax bei ihrer Ausführung aufzeichnen.
  • SyntaxerfassungBefehlssyntax einfügen, während Sie sie in der Benutzeroberfläche auswählen, ohne sie jedoch auszuführen.
  • TabellenverlaufSkriptsyntax aus dem Verlauf einer Ausgabetabelle kopieren.

Sie können diese Option kombiniert verwenden. Sie könnten beispielsweise ein Skript beginnen, indem Sie Syntax aus dem Befehlsprotokoll kopieren, und dann zusätzliche Syntaxzeilen direkt in das Fenster Skript-Editor eingeben.

Um ein bestehendes Skript in Analytics zu bearbeiten, müssen Sie den Skript-Editor verwenden.

Sie können auch einen Texteditor Ihrer Wahl benutzen, die Syntax dann kopieren und in ein Analytics-Skript einfügen.

Code-Vervollständigung

Bei der Eingabe einer Skriptsyntax im Skript-Editor führt Analytics verschiedene Arten der Code-Vervollständigung durch. Die Code-Vervollständigung reduziert die mit der Eingabe der Syntax verbundene Arbeit und zeigt die gültige Form von ACLScript-Befehlen, Funktionen, Schlüsselwörtern und Parametern an.

  • Automatische Vervollständigung von Befehlen, Funktionen und SchlüsselwörternWenn Sie mit der Eingabe beginnen, bietet die Autovervollständigung eine fortlaufend aktualisierte Auswahlliste von ACLScript-Befehlen, Funktionen und Schlüsselwörtern, die mit den eingegebenen Zeichen übereinstimmen. Sie können ein Element aus der Liste auswählen, um das Syntaxelement automatisch zu vervollständigen.

  • Popup-Hilfe für FunktionsparameterWenn Sie die öffnende Klammer nach einem gültigen Funktionsnamen eingeben, zeigt die Popup-Hilfe den Datentyp der von der Funktion zurückgegebenen Ausgabe und das erforderliche Format für die Funktionsparameter an.

  • Automatisches Schließen von gepaarten SyntaxelementenWenn Sie das Anfangszeichen eines der unten aufgeführten gepaarten Syntaxelemente eingeben, wird das Schlusszeichen automatisch angegeben:

    • Doppelte Anführungszeichen ""

    • Einfache Anführungszeichen ''

    • Schräge Anführungszeichen ``

    • Klammern ()

Sie können die automatische Vervollständigung von Befehlen, Funktionen und Schlüsselwörtern deaktivieren, indem Sie in der Registerkarte Schnittstelle im Dialogfeld Optionen (Extras > Optionen) die Option Automatische Vervollständigung in Skripts deaktivieren auswählen.

Die Popup-Hilfe für Funktionsparameter und das automatische Schließen von allgemeinen Syntaxelementen kann nicht deaktiviert werden.

Skripts im Skript-Editor erstellen oder bearbeiten

Sie können Skripts erstellen oder bearbeiten, indem Sie die erforderliche ACLScript-Syntax direkt in den Skript-Editor eingeben oder eine der anderen unterstützten Methoden zur Syntaxeingabe verwenden.

Hinweis

Wenn Sie ACLScript-Befehle zu einem Skript hinzufügen, müssen Sie die folgenden Syntaxregeln für Zeilenumbrüche befolgen:

  • Jeder Befehl muss in eine eigene Zeile eingegeben werden. Zwei Befehle können nicht dieselbe Zeile (gleiche Zeilennummer) belegen.

  • Fast alle ACLScript-Befehle müssen in einer Zeile eingegeben werden (eine Zeilennummer). Einzeilige Befehle können nicht auf mehrere Zeilen aufgeteilt werden. Mehrzeilige Befehle müssen der vorgeschriebenen mehrzeiligen Syntax folgen. Die erforderliche Syntax finden Sie in den Hilfethemen für die einzelnen Befehle. Siehe Befehle.

Skripts aus dem Befehlsprotokoll erstellen

Sie können die Protokolleinträge aus der Registerkarte Protokoll im Navigator als Ausgangspunkt für das Erstellen eines neuen Skripts kopieren oder ein bestehendes Skript hinzufügen. Die Syntax jedes zuvor in Analytics ausgeführten Befehls wird in einem einzelnen Protokolleintrag aufgezeichnet.

Sie können die folgenden Protokolleinträge auswählen und sie in ein neues oder bestehendes Skript kopieren:

  • einzelne Einträge
  • eine Reihe von Einträgen, die zu einer Tabelle gehören
  • größere Eintragsgruppen, die zu einer Sitzung oder einem Zeitraum gehören

Skript mit dem Skript-Recorder erstellen

Der Analytics-Skript-Rekorder ermöglicht Ihnen das Erstellen eines Skripts, das während der Arbeit mit Tabellen und Befehlen Ihre Handlungen innerhalb der Analytics-Benutzeroberfläche aufzeichnet. Der Vorteil der Verwendung des Skript-Rekorders besteht darin, dass Sie bei der Erstellung von Skripts nicht für jeden verwendeten ACLScript-Befehl die erforderliche Syntax manuell eingeben müssen. Vielmehr müssen Sie die Syntax noch nicht einmal kennen.

Der Skript-Rekorder kann nur Befehle aufzeichnen. Allgemein gilt: Wenn ein Befehl im Befehlsprotokoll angezeigt wird, kann er durch den Skript-Rekorder aufgezeichnet werden.

Tipp

Der Skript-Rekorder ist auch eine nützliche Anwendung zum Erlernen von ACLScript. Sie können mithilfe des Skript-Rekorders Analyseschritte aufzeichnen und dann das resultierende Skript einsehen, um Befehle und Syntax zu sehen, die erforderlich sind, um das Verhalten in einem Skript zu reproduzieren.

Skript mit Syntaxerfassung erstellen

Mit der Syntaxerfassung können Sie Analytics-Menüs und Dialogfelder verwenden, und die entsprechende ACLScript-Syntax wird automatisch in ein Skript eingefügt.

Ein Skript aus dem Tabellenverlauf erstellen

Sie können auf Basis des Verlaufs im Zusammenhang mit einer Analytics-Ausgabe oder einer Ergebnistabelle ein Skript erstellen.

Wenn Sie einem Analytics-Projekt beispielsweise eine monatliche Vorratstabelle hinzufügen und die relevanten Abteilungen sowie Posten in eine neue Tabelle extrahieren, könnten Sie auf Basis des Tabellenverlaufs der ersten, von Ihnen erstellten Ausgabetabelle ein Skript für diesen Vorgang erstellen.

Analytics zeichnet für jede Tabelle, die als Ausgabe eines Analytics-Befehls erstellt wurde, die Befehle auf, die zum Erstellen dieser Tabelle verwendet wurden, einschließlich der Befehle, die Zwischentabellen zwischen der ursprünglichen Analytics-Tabelle und der Ausgabetabelle erstellt haben. Diesem Tabellenverlauf können Sie in ein neues Skript kopieren, das dann zur automatischen Erstellung der späteren Ausgabetabellen verwendet werden kann.

Skripts oder Snippets aus SkriptHub importieren

Eine weitere Möglichkeit zur Erstellung von Skripts ist die Nutzung von ACLScript-Codebeispielen im Diligent Developer Portal. Das Portal enthält eine Reihe von Entwicklerressourcen für die Arbeit mit Diligent-Produkten, einschließlich einer webbasierten Bibliothek mit skriptbasierten Analytics-Elementen, die von Diligent-Mitarbeitern entwickelt wurden. Im Rahmen Ihres Abonnements können Sie alle Inhalte von SkriptHub herunterladen und verwenden.

Diligent One-Zugriffstoken-Zugriffstoken beantragen

Achtung

Der erstellte Zugriffstoken entspricht dem Konto, das zur Anmeldung an Diligent One verwendet wurde. Es empfiehlt sich unter Umständen nicht, als Skriptautor in einem Skript Ihren eigenen Zugriffstoken festzulegen, wenn das Skript durch andere Personen benutzt wird.

Schützen Sie Zugriffstoken genauso wie Ihr Kontokennwort.

Verwenden Sie einen bereits bestehenden Token, solange es keinen Grund gibt, einen neuen zu erstellen. Erstellen Sie einen neuen Token, falls der existierende Token nicht funktioniert. Wenn Sie bestehende Token verwenden, müssen Sie eine geringere Anzahl von Token verwalten.

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

    • Wählen Sie aus dem Analytics-Hauptmenü Extras > Diligent One-Zugriffstoken.

    • Im Skript-Editor klicken Sie mit der rechten Maustaste und wählen Einfügen > Diligent One-Token.

    Die Seite API-Token verwalten wird in Ihrem Browser geöffnet. Möglicherweise müssen Sie sich zuerst am Diligent One anmelden.

    Sie können ganz einfach über Analytics auf die Seite API-Token verwalten zugreifen. Sie können sich aber auch ohne Diligent One über Ihr Benutzerprofil bei Analytics anmelden und die Seite aufrufen.

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

    • Bestehenden Token verwenden

      1. Klicken Sie in der Spalte Token auf die teilweise verborgene Version des gewünschten Tokens.

      2. Geben Sie Ihr Diligent One-Kennwort ein und klicken Sie auf Bestätigen.

        Der Token wird nicht verborgen angezeigt.

      3. Klicken Sie auf Kopieren, um den Token zu kopieren.

        Tipp

        Schließen Sie das Dialogfeld mit dem Token nicht, bevor Sie den Token erfolgreich eingefügt haben.

    • Neuen Token erstellen

      1. Klicken Sie auf Token hinzufügen > Analytics.

      2. Geben Sie im Seitenbereich Neuer Analytics-Token die folgenden Informationen ein:

        Feld oder Option Beschreibung
        Beschreibung

        Geben Sie eine Beschreibung ein, die nützliche Informationen enthält, wie beispielsweise:

        • Der Zweck des Tokens
        • Wo der Token verwendet wird – zum Beispiel den Namen und Ort des Analytics-Skripts oder den Namen und Ort der Robot-Aufgabe
        Token-Ablauf
        • AktiviertDer Token läuft nach der von Ihnen angegebenen Anzahl von Tagen ab.
        • DeaktiviertDer Token läuft niemals ab.

        Hinweis

        Möglicherweise gilt in Ihrer Organisation eine Sicherheitsrichtlinie, die verlangt, dass Token nach einer gewissen Zeitdauer ablaufen. Die Erstellung von Token mit einer Ablauffrist ist eine gute Praxis. Diligent One sendet Ihnen vor dem Ablaufdatum eine automatisierte E-Mail-Benachrichtigung.

        Läuft ab in Geben Sie die Anzahl der Tage an, bevor das Token abläuft (1 bis 365).
        Kennwort Geben Sie das Kennwort für Ihr Diligent One-Konto ein.
      3. Klicken Sie auf Token generieren.

      4. Klicken Sie auf Kopieren, um den Token zu kopieren.

        Tipp

        Schließen Sie den Seitenbereich mit dem Token nicht, bevor Sie den Token erfolgreich eingefügt haben.

  3. Führen Sie einen der folgenden Schritte aus, je nach Ihrer Kennwortdefinitionsmethode:

    • PASSWORD-AnalysetagFügen Sie im Aufgaben-Designer in einem ACL-Robot den kopierten Token in ein Kennwort-Parameterfeld ein.

    • PASSWORD-BefehlFügen Sie in Analytics den kopierten Token in eine Kennwortaufforderung ein, die bei der Skriptausführung angezeigt wird.

    • SET-PASSWORD-BefehlFügen Sie den kopierten Token in Analytics in die SET-PASSWORD-Befehlssyntax an der geeigneten Stelle des Skripts ein.

  4. Schließen Sie in Launchpad das Dialogfeld oder den Seitenbereich mit dem Token.

    Nachdem Sie einen neuen Token erstellt haben, wird eine teilweise verborgene Version des Tokens am Anfang Ihrer Tokenliste hinzugefügt.

    Für weitere Informationen siehe Diligent One-Zugriffstoken erstellen und verwalten.