Erstellen von benutzerdefinierten Dialogfeldern

Der Dialog-Generator in Analytics ermöglicht Ihnen, ein oder mehrere benutzerdefinierte Dialogfelder zu erstellen, um während der Ausführung eines Skripts Benutzereingaben entgegenzunehmen.

Sie können ein benutzerdefiniertes Dialogfeld für zahlreiche Funktionen verwenden:

  • einen Benutzer zu einer Eingabe auffordern, z.B. einen Tabellennamen, Feldnamen oder einen Datumsbereich
  • einem Benutzer eine Auswahl aus mehreren Optionen ermöglichen
  • weitere Informationen als in einem üblichen Meldungsfeld darstellen
  • Analytics-Projektelemente dynamisch auflisten

Hinweis

Die Verwendung eines benutzerdefinierten Dialogfelds zur Eingabe von Kennwörtern ist nicht sicher. Sie sollten stattdessen den PASSWORD-Befehl verwenden.

Steuerelemente von Dialogfeldern

Im Dialog-Generator entwerfen und erstellen Sie ein benutzerdefiniertes Dialogfeld, indem Sie dem Dialogfeld Steuerelemente für Benutzereingaben hinzufügen.

Steuerelemente sind kleine, interaktive Softwarekomponenten, die unterschiedliche Möglichkeiten zur Entgegennahme von Benutzereingaben innerhalb eines Skripts bieten. Sie fügen Ihrem einfachen Dialogfeld ein oder mehrere Steuerelemente hinzu und konfigurieren diese entsprechend Ihren Anforderungen.

Die folgenden Steuerelemente sind verfügbar:

  • Textbeschriftung
  • Textfeld
  • Kontrollkästchen
  • Optionsfeld
  • Dropdown-Liste
  • Projektelementliste

Das folgende Beispiel eines benutzerdefinierten Dialogfelds enthält alle Steuerelementtypen.

Automatisch in einen Befehl umgesetztes Dialogfeld

Wenn Sie ein neu erstelltes, benutzerdefiniertes Dialogfeld speichern, wandelt Analytics das visuell dargestellte Dialogfeld automatisch in einen entsprechenden DIALOG-Befehl von ACLScript um.

Der Befehl wird in der Zeile des Skripts eingefügt, in der sich der Cursor befindet. Wenn Sie das Skript ausführen, wird das visuelle Dialogfeld angezeigt.

Das folgende Beispiel zeigt ein einfaches, benutzerdefiniertes Dialogfeld mit einer Beschriftung und einer Dropdown-Liste sowie den entsprechenden DIALOG-Befehl.

Benutzerdefiniertes Dialogfeld

Entsprechender DIALOG-Befehl

DIALOG (DIALOG TITLE "Zweigstelle auswählen" WIDTH 464 HEIGHT 116 ) (BUTTONSET TITLE "&OK;&Abbrechen" AT 336 12 DEFAULT 1 ) (TEXT TITLE "Wählen Sie die Zweigstelle:" AT 12 16 ) (DROPDOWN TITLE "Zentrale Zweigstelle;Zweigstelle Ost;Zweigstelle West" TO "DROPDOWN1" AT 156 12 )

Benutzerdefiniertes Dialogfeld erstellen – allgemeine Schritte

  1. Öffnen Sie das Analytics-Skript, dem Sie ein benutzerdefiniertes Dialogfeld hinzufügen möchten.
  2. Positionieren Sie den Cursor in der Zeile des Skripts, in der Sie den DIALOG-Befehl einfügen möchten.

    Hinweis

    Positionieren Sie den Cursor in einer leeren Zeile. Erstellen Sie, falls notwendig, eine neue leere Zeile.

  3. Klicken Sie auf Neues Dialogfeld erstellen .

    Analytics zeigt den Dialog-Generator mit dem Standardtitel „Benutzerdialog“ an.

  4. Führen Sie einen der folgenden Schritte durch, um das benutzerdefinierte Dialogfeld zu erstellen:
    • Doppelklicken Sie auf den Dialog-Generator, um den Titel oder die Größe des Dialogfelds zu ändern.

      Sie geben die Breite und Höhe des Dialogfelds in Pixeln ein. Sie können die Größe des Dialogfelds auch ändern, indem Sie die rechte untere Ecke des Arbeitsbereichs im Dialog-Generator ziehen (Am Raster ausrichten muss dafür eingeschaltet sein).

    • Klicken Sie auf Am Raster ausrichten , um das Raster im Dialog-Generator an- oder auszuschalten.

      Verwenden Sie das Raster, um Steuerelemente im Layout-Bereich auszurichten. Wenn das Raster aktiviert ist, wird die oberste linke Ecke jedes Steuerelements am nächstliegenden Rasterpunkt ausgerichtet.

    • Klicken Sie links im Dialog-Generator auf das Symbol eines der Steuerelemente und dann auf den Layout-Bereich, um das Steuerelement hinzuzufügen.

      Hinweis

      Die Schritte für das Hinzufügen und den Entwurf spezifischer Steuerelemente folgen weiter unten.

  5. Fügen Sie so viele Steuerelemente hinzu, wie Sie benötigen.
  6. Wenn Sie ein Steuerelement nach dem Hinzufügen verändern müssen, doppelklicken Sie auf es.
  7. Wenn Sie ein Steuerelement aus dem Dialog-Generator löschen möchten, wählen Sie das Steuerelement aus und klicken auf Löschen .

    Hinweis

    Die Schaltflächen OK und Abbrechen können nicht gelöscht werden, Sie können sie jedoch umbenennen (siehe unten).

  8. Klicken Sie auf Schließen, um den Dialog-Generator zu verlassen.
  9. Klicken Sie im Bestätigungsdialogfeld auf OK, um Ihre Änderungen zu speichern.

    Analytics zeigt den entsprechenden DIALOG-Befehl im Skript-Editor an. Sie können alle Steuerelemente in dem benutzerdefinierten Dialogfeld ansehen, wenn Sie die Bildschirmanzeige nach rechts bewegen.

  10. Optional. Bearbeiten Sie die Beschriftung für die Schaltflächen „OK“ oder „Abbrechen“ innerhalb des DIALOG-Befehls des Skripts.

    Normalerweise sollten Sie die Bezeichnungen „OK“ und „Abbrechen“ nicht bearbeiten. Wenn Sie sie trotzdem bearbeiten, muss sichergestellt werden, dass der positive Wert (zum Beispiel „Ja“) vor dem negativen Wert (zum Beispiel „Nein“) steht.

    Bearbeiten Sie lediglich die Beschriftung. Beispiel: "&Ja;&Nein"

Benutzerdefinierte Dialogfelder ändern

Wenn Sie ein benutzerdefiniertes Dialogfeld nach der Erstellung ändern müssen, positionieren Sie den Cursor auf dem entsprechenden DIALOG-Befehl und klicken auf Befehl Bearbeiten .

Beschriftung hinzufügen

Verwenden Sie das Steuerelement „Text“, um dem benutzerdefinierten Dialogfeld eine Beschriftung hinzuzufügen.

Eine Beschriftung kann für die folgenden Zwecke verwendet werden:

  • um ein anderes Steuerelement zu identifizieren
  • um eine Benachrichtigung zu übermitteln
  • um Benutzer zu Eingaben aufzufordern oder um ihnen Anweisungen zu geben
  • um sonstige textbasierte Informationen zu übermitteln, die in einem benutzerdefinierten Dialogfeld benötigt werden

Beschriftungen werden nur angezeigt und haben keine interaktiven Funktionen.

Schritte

Ein Textfeld hinzufügen

Verwenden Sie das Steuerelement „Eingabefeld“, um dem benutzerdefinierten Dialogfeld ein Textfeld hinzuzufügen.

Ein Textfeld nimmt Informationen auf, die der Benutzer eingeben muss, wie Datumswerte, Lieferanten- oder Kundennummern.

Variable eines Eingabefelds

Das Steuerelement „Eingabefeld“ erstellt eine Zeichenvariable zur Speicherung der Benutzereingabe.

Schritte

Kontrollkästchen hinzufügen

Verwenden Sie das Steuerelement „Kontrollkästchen“, um dem benutzerdefinierten Dialogfeld ein Kontrollkästchen hinzuzufügen.

Ein Kontrollkästchen ermöglicht dem Benutzer eine binäre Auswahl. Die Option ist also entweder an- oder ausgeschaltet. Sie könnten ein Kontrollkästchen verwenden, um einem Benutzer entweder das Ein- oder Ausschließen des E-Mail-Adressenfelds in einer Datenextraktion einer Personaltabelle zu ermöglichen.

Optionen kombinieren

Verwenden Sie mehrere Kontrollkästchen, damit ein Benutzer beliebige Optionskombinationen in einem benutzerdefinierten Dialogfeld auswählen kann. Wenn sich Optionen gegenseitig ausschließen, verwenden Sie stattdessen Optionsfelder.

Variable eines Kontrollkästchens

Das Steuerelement „Kontrollkästchen“ erstellt eine logische Variable zur Speicherung der Benutzereingabe. Die Variable speichert den Wert „Wahr“, falls das Kontrollkästchen ausgewählt ist, und „Falsch“, wenn es nicht ausgewählt ist.

Schritte

Optionsfelder hinzufügen

Verwenden Sie das Steuerelement „Optionsfeld“, um innerhalb des benutzerdefinierten Dialogfelds ein oder mehrere Optionsfelder hinzuzufügen.

Optionsfelder bieten dem Benutzer sich gegenseitig ausschließende Optionen. Es kann also stets nur eine der angebotenen Optionen gleichzeitig ausgewählt werden. Sie könnten beispielsweise zwei Optionsfelder verwenden, um einem Benutzer eine der folgenden Auswahloptionen zu ermöglichen:

  • Beträge kleiner als $5000
  • Beträge größer oder gleich $5000

Sich gegenseitig ausschließende Optionen

Verwenden Sie mehrere Optionsfelder, damit ein Benutzer in einem benutzerdefinierten Dialogfeld aus einigen Optionen nur eine Option auswählen kann. Wenn sich die Optionen nicht gegenseitig ausschließen, verwenden Sie stattdessen Kontrollkästchen.

Variable eines Optionsfelds

Das Steuerelement „Optionsfeld“ erstellt eine numerische Variable zur Speicherung der Benutzereingabe. Die Variable speichert den Wert „1“, wenn das erste Optionsfeld gewählt ist, „2“, wenn das zweite Optionsfeld gewählt ist, usw.

Schritte

Dropdown-Liste hinzufügen

Verwenden Sie das Steuerelement „Dropdown-Liste“, um dem benutzerdefinierten Dialogfeld eine Dropdown-Liste hinzuzufügen.

Eine Dropdown-Liste bietet dem Benutzer eine Liste von benutzerdefinierten, textbasierten Optionen. Der Benutzer kann immer nur eine der Optionen gleichzeitig auswählen. Sie könnten beispielsweise eine Dropdown-Liste verwenden, um einem Benutzer die folgende Auswahl zu ermöglichen:

  • Monat des Jahres
  • Kategorie
  • Unternehmensabteilung oder Zweigstelle

Sich gegenseitig ausschließende Optionen

Die Optionen in einer Dropdown-Liste schließen sich gegenseitig aus. Mit Optionsfeldern können Sie ein ähnliches Ergebnis erreichen, bei Listen mit vielen Elementen sind Dropdown-Listen aber kompakter und einfacher zu verwenden.

Wenn Sie einem Benutzer die Auswahl mehrerer Optionen ermöglichen möchten, verwenden Sie stattdessen Kontrollkästchen.

Variable einer Dropdown-Liste

Das Steuerelement „Dropdown-Liste“ erstellt eine Zeichenvariable zur Speicherung der Benutzereingabe.

Schritte

Projektelementliste hinzufügen

Verwenden Sie das Steuerelement „Projektelementliste“, um dem benutzerdefinierten Dialogfeld eine Projektelementliste hinzuzufügen.

Eine Projektelementliste bietet dem Benutzer eine Liste mit Analytics-Projektelementen, wie beispielsweise Tabellen oder Feldern. Die Elementliste wird dynamisch auf Basis der Inhalte des Analytics-Projekts gefüllt, in dem das Skript ausgeführt wird.

Der Benutzer kann immer nur eine der Optionen gleichzeitig auswählen. Sie könnten beispielsweise eine Projektelementliste verwenden, um einem Benutzer die folgende Auswahl zu ermöglichen:

  • Tabelle für einen bestimmten Monat aus allen Tabellen des Jahres
  • bestimmtes numerisches Feld aus allen numerischen Feldern in einer Tabelle
  • bestimmtes Unterskript aus mehreren möglichen Unterskripts

Kategorien von Projektelementen

Wenn Sie eine Projektelementliste erstellen, legen Sie keine tatsächlichen Projektelemente sondern eine Projektelementkategorie fest. Sie geben beispielsweise die Kategorie Zeichenfelder an, wenn Sie dem Benutzer bei der Skriptausführung eine Liste aller Zeichenfelder der offenen Tabelle anbieten möchten.

Auf Basis der von Ihnen angegebenen Kategorien füllt Analytics die Projektelementliste im benutzerdefinierten Dialogfeld automatisch.

Verfügbare Kategorien

Die folgenden Kategorien sind verfügbar:

  • Zeichenfelder
  • Numerische Felder
  • Datumzeit-Felder
  • Logische Felder
  • Zeichenvariablen
  • Numerische Variablen
  • Datumzeit-Variablen
  • Logische Variablen
  • Tabellen
  • Ansichten
  • Skripts
  • Indizes
  • Arbeitsbereiche

Variable einer Projektelementliste

Das Steuerelement „Projektelementliste“ erstellt eine Zeichenvariable zur Speicherung der Benutzereingabe.

Schritte

Hilfe für Analytics 14.1