Skripte registrieren

Registrierte Skripte werden einer Skriptdatei (die aus einem Jython- oder Visual Basic-Skript besteht) und einer Zielanwendung zugeordnet. Bei der Ausführung des benutzerdefinierten Skriptes wird eine Liste mit Werten angezeigt, aus der Sie die Parameter für das Skript auswählen können.


Das Bild zeigt die Registerkarte "Registrierung von benutzerdefiniertem Skript".

So registrieren Sie ein Skript:

  1. Wählen Sie in der Registerkarte Einrichten unter Skripte die Option Skriptregistrierung aus.

    Das Fenster "Registrierung von benutzerdefiniertem Skript" besteht aus drei Bereichen:

    • Übersicht – Listet alle benutzerdefinierten Skripte auf.

    • Details – Zeigt den Skriptnamen, die zugeordnete Zielanwendung und die Skriptdatei an.

    • Parameter – Zeigt Name und Typ des Parameters, den Anzeigenamen, die Abfolge, den Parameterwert und die Abfragedefinition zum Abrufen einer Werteliste für ein bestimmtes benutzerdefiniertes Skript an.

  2. Klicken Sie über dem Raster "Übersicht" auf Hinzufügen.

  3. Geben Sie im Raster "Details" unter Name den Namen des benutzerdefinierten Skriptes ein.

  4. Wählen Sie unter Zielanwendung die Zielanwendung aus, die dem benutzerdefinierten Skript zugeordnet ist.

  5. Um das benutzerdefinierte Skript einer benutzerdefinierten Skriptgruppe zuzuordnen, wählen Sie unter Benutzerdefinierte Skriptgruppe die Gruppe aus.

  6. Wählen Sie unter Skriptdatei die Skriptdatei aus, die dem benutzerdefinierten Skript zugeordnet werden soll.

    Klicken Sie zum Suchen einer Skriptdatei auf Auswählen, und wählen Sie im Fenster Skriptdatei auswählen eine Skriptdatei aus.

    Um eine Skriptdatei hochzuladen, klicken Sie auf Auswählen. Klicken Sie unter Skriptdatei auswählen auf Hochladen. Klicken Sie anschließend auf Durchsuchen, navigieren Sie zur hochzuladenden Skriptdatei, und klicken Sie auf OK.

  7. Klicken Sie auf Speichern.

So definieren Sie die Parameter des benutzerdefinierten Skriptes:

  1. Wählen Sie im Raster "Übersicht" den Namen des benutzerdefinierten Skriptes aus, dem Parameter hinzugefügt werden sollen.

  2. Klicken Sie im Raster Skriptparameter auf Hinzufügen.

    Eine leere Zeile wird angezeigt, in der Parameter hinzugefügt werden können.

  3. Geben Sie unter Parametername den Namen des Parameters ein, auf den Sie im Skript verweisen.

    Beispiel: Geben Sie POVLOC für die POV-Location, POVPeriod für die POV-Periode, POVCAT für die POV-Kategorie oder POVTARGET für die Zielkategorie ein.

    Der Parametername ist benutzerdefiniert. Sie können zur Unterscheidung im benutzerdefinierten Skript ein Präfix oder ein Suffix auswählen.

  4. Wählen Sie unter Typ den Typ des Parameters aus.

    Verfügbare Typen:

    • POV – Fordert zur Eingabe der Location, Periode, Kategorie oder Regel des POV auf. Die POV-Werte werden beim Ausführen des benutzerdefinierten Skriptes aus dem Benutzer-POV übernommen.

    • Abfrage – Mit dem Typ "Abfrage" können Sie eine Abfrage erstellen, die eine Liste mit Werten lädt, aus der ein Benutzer beim Ausführen des benutzerdefinierten Skriptes eine Auswahl treffen kann.

    • Statisch – Gibt an, dass der Parameter ein konstanter oder vordefinierter Wert ist und dass der Parameterwert vom Benutzer angegeben wird. Bei der Ausführung des benutzerdefinierten Skriptes können Sie einen anderen Wert für den Parameter angeben.

    Sie können einen beliebigen Namen für den Parameter verwenden und können zur Unterscheidung im benutzerdefinierten Skript ein Präfix oder ein Suffix verwenden.

    Der Parametername muss genau mit der Angabe in der Skriptregistrierung übereinstimmen.

  5. Geben Sie unter Anzeigename den Namen ein, der im Fenster "Skript ausführen" für den Parameter angezeigt werden soll.

  6. Geben Sie unter Parameterwert den Wert für den Parametertyp "Statisch" ein.

    Der Parameterwert muss im benutzerdefinierten Skript mit der folgenden API abgerufen werden:

    fdmAPI.getCustomScriptParameterValue("PARAMETER NAME"))

  7. Geben Sie unter Abfolge die Anzeigereihenfolge des Parameters im Fenster "Skript ausführen" ein.

  8. Geben Sie unter Abfrage die Abfragedefinition an, anhand derer eine Werteliste für den Parameter abgerufen werden soll.

    Beispiel: Wenn dem Benutzer im Fenster "Bericht generieren" eine Liste mit Datenregeln zur Auswahl angezeigt werden soll, geben Sie die Abfragedefinition für diese Abfragen an.

  9. Klicken Sie auf Speichern.