Skripts erstellen und bearbeiten

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

  • Skript-Editor Befehlssyntax im Fenster Skript-Editor eingeben
  • Befehlsprotokoll Skriptsyntax aus dem Befehlsprotokoll kopieren
  • Skript-Rekorder Befehlssyntax bei ihrer Ausführung aufzeichnen
  • Syntaxerfassung Befehlssyntax einfügen, während Sie sie in der Benutzeroberfläche auswählen, ohne sie jedoch auszuführen
  • Tabellenverlauf Skriptsyntax 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.Analytics

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

Automatische Syntaxvervollständigung

Während Sie Syntax in den Skript-Editor eingeben, vervollständigt Analytics automatisch ACLScript-Befehle sowie -Schlüsselwörter und blendet Hilfe für Funktionsparameter ein.AnalyticsACLScript

Sie können die automatische Vervollständigung ausschalten, indem Sie unter Extras > Optionen im Dialogfeld Optionen und der Registerkarte Schnittstelle den Eintrag Automatische Vervollständigung in Skripts deaktivieren auswählen. Die eingeblendete Hilfe für Funktionsparameter kann nicht deaktiviert werden.

Importieren von Skripts oder Ausschnitten aus SkriptHub

Eine weitere Möglichkeit zur Erstellung von Skripts ist die Nutzung von Inhalten in SkriptHub. SkriptHub ist eine webbasierte Bibliothek aus Analytics-Skriptelementen, die durch Diligent-Mitarbeiter und die Diligent-Benutzer-Community entwickelt wurden. Im Rahmen Ihres Abonnements können Sie alle Inhalte von SkriptHub herunterladen und verwenden.

Weitere Informationen finden Sie unter Aus SkriptHub importieren.

Skripts im Skript-Editor erstellen oder bearbeiten

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

Hinweis

Wenn Sie ein Skript erstellen oder bearbeiten, müssen Sie sicherstellen, dass jeder ACLScript-Befehl in einer separaten Zeile eingegeben wird.

Skript erstellen oder bearbeiten

  1. Führen Sie einen der folgenden Schritte durch, um das Skript im Skript-Editor zu öffnen:
    • Um ein neues Skript zu erstellen, wählen Sie Datei > Neu > Skript.

      Das Skript wird mit dem Namen Neues_Skript erstellt. Klicken Sie den Name mit der rechten Maustaste an und wählen Sie Umbenennen, um das Skript umzubenennen.

      Hinweis

      Skriptnamen sind auf 64 alphanumerische Zeichen beschränkt. Der Name kann den Unterstrich beinhalten ( _ ), aber keine anderen Sonderzeichen oder Leerzeichen. Er kann nicht mit einer Ziffer beginnen.

    • Um ein vorhandenes Skript zu öffnen, doppelklicken Sie auf das Skript in der Registerkarte Übersicht im Navigator.
  2. Fügen Sie die ACLScript-Syntax im Skript-Editor ein, ändern oder löschen Sie sie.

    Tipp

    Sie können diese Tastenkombination für häufige Aktionen verwenden:

    • Strg+Z Ein oder mehrere Aktionen rückgängig machen
    • Strg+Y Ein oder mehrere Aktionen wiederholen
    • Strg+S Analytics-Projekt und auch das offene Skript speichern
  3. (Optional) Positionieren Sie den Cursor an einer geeigneten Stelle im Skript, und führen Sie einen der folgenden Schritte aus, um ein oder mehrere spezifische Elemente einzufügen:
    ElementSchritte

    Projektelementname

    (Tabelle, Skript, Ansicht, Arbeitsbereich oder Index)

    1. Klicken Sie mit der rechten Maustaste, und wählen Sie Einfügen > Projektelement.
    2. Wählen Sie den Elementtyp aus der Dropdown-Liste Elementtyp aus.
    3. Wählen Sie einen oder mehrere Elementnamen, und klicken Sie auf OK.
    Feldname
    1. In der Symbolleiste des Skript-Editors klicken Sie auf Feld einfügen .
    2. Wählen Sie einen oder mehrere Feldnamen aus, und klicken Sie auf OK.
    Ausdruck
    1. In der Symbolleiste des Skript-Editors klicken Sie auf Ausdruck einfügen .
    2. Erstellen Sie einen Ausdruck, und klicken Sie auf OK.
    Dialogfeld
    1. In der Symbolleiste des Skript-Editors klicken Sie auf Neues Dialogfeld erstellen .
    2. Erstellen Sie ein benutzerdefiniertes Dialogfeld, klicken Sie auf Schließen und dann auf OK.

    Weitere Informationen finden Sie unter Erstellen von benutzerdefinierten Dialogfeldern.

    Datum und Uhrzeit
    1. Klicken Sie mit der rechten Maustaste, und wählen Sie Einfügen > Datum und Zeit.
    2. Geben Sie ein Datum, eine Datumzeit oder eine Zeit ein, oder wählen Sie eine solche aus, und klicken Sie auf OK.
    Diligent One Token

    Weitere Informationen finden Sie unter HighBond-Zugriffstoken beschaffen.

  4. Wählen Sie Datei > Projekt speichern.
  5. Sie klicken im Bestätigungsdialogfeld auf Ja.

Befehlssyntax mit einem Dialogfeld bearbeiten

Statt Befehle in einem Skript manuell zu bearbeiten, können Sie sie mit dem zugehörigen Dialogfeld bearbeiten.

Hinweis

Diese Methode steht nur für Befehle mit Dialogfeldern zur Verfügung.

  1. Wählen Sie einen existierenden ACLScript-Befehl im Skript.
  2. In der Symbolleiste des Skript-Editors klicken Sie auf Befehl bearbeiten .

    Das Dialogfeld „Befehl“ wird geöffnet.

  3. Im Dialogfeld nehmen Sie die notwendigen Änderungen an den Befehlsparametern vor und und klicken auf OK.

    Die Skriptsyntax wird aktualisiert.

Das Skript testen

Wenn Sie das Skript testen möchten, klicken Sie in der Skript-Editor-Symbolleiste auf Ausführen  oder Schritt .

Hinweis

Wenn Sie ein Skript ausführen oder es schrittweise durchlaufen, werden alle offenen Skripts automatisch gespeichert.

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
  1. Klicken Sie im Navigator auf die Registerkarte Protokoll, um das Protokoll anzuzeigen.
  2. Wählen Sie den Protokolleintrag oder die Gruppe von Einträgen aus, die Sie im Skript verwenden möchten.

    Wenn Sie Elemente von höheren Ebenen in der Baumansicht wählen, werden die Untereinträge automatisch ausgewählt.

  3. Gehen Sie anhand einer der folgenden Methoden vor:
    Ein neues Skript erstellen
    1. Klicken Sie mit der rechten Maustaste in die Registerkarte Protokoll und wählen Sie Markierte Elemente speichern > Skript.
    2. Geben Sie im Dialogfeld Skript speichern unter einen Namen für das neue Skript ein, und klicken Sie auf OK.

      Hinweis

      Skriptnamen sind auf 64 alphanumerische Zeichen beschränkt. Der Name kann den Unterstrich beinhalten ( _ ), aber keine anderen Sonderzeichen oder Leerzeichen. Er kann nicht mit einer Ziffer beginnen.

      Das neue Skript wird der Registerkarte Übersicht im Navigator hinzugefügt. Das Skript wird im Ordner der aktiven Analytics-Tabelle gespeichert oder im Stammordner des Projekts, falls keine Tabelle geöffnet ist.

    Syntax in ein existierendes Skript kopieren
    1. Klicken Sie mit der rechten Maustaste auf die Registerkarte Protokoll, und wählen Sie Kopieren aus.
    2. Öffnen Sie ein existierendes Skript, falls noch keines geöffnet ist.
    3. Positionieren Sie den Mauszeiger im Skript-Editor an der Stelle, an der Sie die kopierte Syntax einfügen möchten.
    4. Klicken Sie mit der rechten Maustaste, und wählen Sie Einfügen.

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.

  1. Wählen Sie aus dem Analytics-Hauptmenü Extras > Skript-Rekorder an.

    Das Symbol für den Skript-Rekorder wird in der Statusleiste angezeigt. Links vom Menüelement wird ein Kontrollkästchen angezeigt, das symbolisiert, dass der Skript-Rekorder aktiviert ist.

  2. Führen Sie die Analyseschritte oder Verarbeitung durch, die Sie aufzeichnen möchten.

    Analytics zeichnet jeden verarbeiteten Befehl in einem neuen Skript auf.

  3. Wenn Sie die Analyse oder Verarbeitung von Daten beendet haben, wählen Sie erneut Extras > Skript-Rekorder an, um den Skript-Rekorder auszuschalten.

    Analytics fordert Sie auf, das Skript zu speichern.

  4. Geben Sie einen sinnvollen Namen für das Skript in das Textfeld ein, und klicken Sie auf OK.

    Hinweis

    Skriptnamen sind auf 64 alphanumerische Zeichen beschränkt. Der Name kann den Unterstrich beinhalten ( _ ), aber keine anderen Sonderzeichen oder Leerzeichen. Er kann nicht mit einer Ziffer beginnen.

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.

  1. Öffnen Sie das Skript, das Sie bearbeiten möchten.
  2. (Optional) Öffnen Sie die Tabelle, die Sie bearbeiten möchten.

    Tipp

    Wenn Sie die Syntaxerfassung starten, bevor Sie eine Tabelle öffnen, wird die Tabelle in der Ansichtsregisterkarte nicht physisch geöffnet, weil die Befehle während der Syntaxerfassung nicht wirklich ausgeführt werden. Möglicherweise fällt es Ihnen schwer, sich die anschließenden Befehle vorzustellen, ohne durch eine geöffnete Tabelle angeleitet zu werden.

  3. In der Symbolleiste des Skript-Editors klicken Sie auf Syntaxerfassung starten .
  4. Führen Sie die Analyseschritte oder die Verarbeitung durch, die Sie aufzeichnen möchten.

    Die zugehörige Syntax wird automatisch in das Skript eingefügt. Die Befehle selbst werden dabei aber nicht ausgeführt.

  5. Klicken Sie Syntaxerfassung beenden  um das Einfügen von Befehlssyntax in das Skript anzuhalten.

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.

  1. Öffnen Sie eine Ausgabetabelle, die durch den Prozess entstanden ist, den Sie in einem Skript automatisieren möchten.
  2. Wählen Sie Extras Skript aus Tabellenverlauf erstellen.

    Wenn „Default_View“ (Standardansicht) aktiv ist, fordert Analytics Sie auf, die Ansicht umzubenennen, damit Sie sie bei der Ausführung des neuen Skripts nicht überschreiben.

  3. Wenn Analytics Sie zur Umbenennung der Ansicht auffordert, klicken Sie auf Umbenennen, geben einen neuen Namen ein und klicken auf OK.Analytics
  4. Geben Sie im Dialogfeld Speichern unter einen Namen für das neue Skript ein und klicken Sie OK.

    Hinweis

    Skriptnamen sind auf 64 alphanumerische Zeichen beschränkt. Der Name kann den Unterstrich beinhalten ( _ ), aber keine anderen Sonderzeichen oder Leerzeichen. Er kann nicht mit einer Ziffer beginnen.

  5. (Optional) Öffnen und bearbeiten Sie das neue Skript, wenn Sie das Skriptverhalten anpassen möchten.

    Beispielsweise könnten Sie die Ausgabe in eine Tabelle mit einem unterschiedlichen Namen speichern, anstatt die Originaltabelle zu überschreiben.

HighBond-Zugriffstoken beschaffen

Achtung

Der generierte Zugriffstoken entspricht dem Konto, das zur Anmeldung bei 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 > HighBond-Zugriffstoken.AnalyticsHighBond Access Token

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

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

    Sie können ganz einfach über Analytics auf die Seite API-Token verwalten zugreifen. Sie können sich aber auch ohne Analytics über Ihr Benutzerprofil bei Diligent One 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.Diligent One

        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
        • Aktiviert der Token läuft nach der von Ihnen angegebenen Anzahl von Tagen ab
        • Deaktiviert der 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-Analysetag Fügen Sie im Aufgaben-Designer in einem ACL-Robot den kopierten Token in ein Kennwort-Parameterfeld ein.ACL robot

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

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

  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.

    Weitere Informationen finden Sie unter HighBond-Zugriffstoken erstellen und verwalten.HighBond access tokens