PromptSet Designer

Definieren Sie interaktive Eingabeformulare auf der PromptSet Designer-Seite der PromptSet-Objekte. Konfigurieren Sie PromptSets mit verschiedenen Bedienelementen, damit Ihre Benutzer Daten auswählen oder eingeben können. Die vom Benutzer ausgewählten Werte werden an ausführbare Objekte weitergleitet. Jedes Element, das Sie im Formular aufnehmen, definiert auch eine Variable, die Sie in Scripts verwenden können. Sie können Prompts konfigurieren, die manuell eingegeben oder automatisch aus Standardwerten dynamischer Variablen aufgelöst werden.

Erstellen und Bearbeiten von PromptSets

Ein PromptSet erstellen

1. Fügen Sie ein PromptSet-Objekt (PRPT) hinzu.
2. Wechseln Sie zur PromptSet Designer-Seite des Objekts.
3. Ziehen Sie die gewünschten PromptSet-Elemente mit Drag-and-Drop von der rechten Seite des Bildschirms in die Mitte.
4. Wählen Sie ein Element aus, das Sie in das PromptSet gezogen haben, um die Einstellungen des Elements zu konfigurieren.
5. Drag-and-Drop von Elementen innerhalb des Formulars, um deren Reihenfolge zu ändern. Prompts werden in der Reihenfolge aufgerufen, in der sie hier erscheinen.
6. Um ein Element zu entfernen, markieren Sie das Element und klicken Sie auf das Symbol Entfernen oder die Schaltfläche Löschen in der Symbolleiste.
7. Speichern Sie das Objekt.

Sie können nun die Prompts auf der Prompts-Seite unter Variablen- und Prompts-Seite eines ausführbaren Objekts verwenden.

PromptSet-Vorschau

1. Fügen Sie die gewünschten PromptSet-Elemente hinzu und sortieren Sie sie.
2. Sichern Sie das PromptSet.
3. Klicken Sie in der Symbolleiste auf die Schaltfläche Vorschau.

Das Formular wird in einem Popup-Dialog mit den von Ihnen konfigurierten Elementen angezeigt.

Hinweis: Die Vorschau löst keine Variablen auf, die zur Definition von Standardwerten verwendet werden.

Verfügbare Prompts

Die folgenden Prompt-Elemente stehen zur Verfügung:

• Header/Text
  Zeigt einen Text im Formular an
  Verwenden Sie dieses Element für Header, als Abschnittüberschrift zum Gruppieren anderer Elemente oder für die Anzeige eines anderen Texts für den Benutzer. Im Gegensatz zu anderen Elementen leitet dieses Element keine Werte weiter. Der Text kann im Formular nicht bearbeitet werden.
• Zahl
  Der Benutzer kann eine Zahl (Ganzzahl) angeben.
• Textfeld
  Der Benutzer kann einen Textstring in einer oder mehreren Zeilen angeben
• Kombinationsfeld
  Der Benutzer kann einen Eintrag aus einer Dropdown-Liste auswählen
• Optionsfeld
  Der Benutzer kann eine Option auswählen
• Kontrollkästchen
  Der Benutzer kann eine oder mehrere Optionen über Kontrollkästchen auswählen
• Zeit/Datum
  Der Benutzer kann eine Zeit und ein Datum auswählen

Allgemeine Prompt-Einstellungen

Die folgenden Einstellungen sind für alle PromptSet-Elemente verfügbar, mit Ausnahme des Prompts Überschrift/Text, das nur Label, Variablenname, Tooltip und Benutzerdefiniertes Feld enthält:

• Label
  Beschreibender Text, der im Formular angezeigt wird
  Das Feld zeigt einen Standardwert an, den Sie bearbeiten können, wenn Sie das Element hinzufügen.
• Variablenname
  Definiert eine PromptSet-Variable, die Sie in Scripts verwenden können
  Die Variable wird bei jeder Ausführung des ausführbaren Objekts erstellt.
  Das Feld zeigt einen Standardvariablennamen an, wenn Sie das Element hinzufügen. Sie können diesen Namen bearbeiten, aber es gelten Einschränkungen für den Variablennamen. Weitere Informationen finden Sie unter Script-Variablen.
  Hinweis: Falls die Datenreferenz ein Variablenobjekt des Typs EXEC ist, muss der Name der PromptSet-Variable mit dem der Script-Variablen übereinstimmen, die als Parametername im EXEC-Variablenobjekt eingestellt ist.
• Tooltipp
  Text, der angezeigt wird, wenn der Benutzer den Mauszeiger über das Feld schiebt
• Fokus setzen
  Setzt die Eingabeaufforderung in den Fokus, wenn der Benutzer das Formular anzeigt
  Wenn Sie diese Option für mehrere Eingabeaufforderungen im Formular festlegen, liegt der Fokus auf der letzten Eingabeaufforderung, für den die Option ausgewählt wurde.
• Schreibgeschützt
  Standardwert wird angezeigt und kann vom Benutzer nicht bearbeitet werden
• Anführungszeichen
  Zeichen, das am Anfang und Ende des Wertes angehängt wird
• Benutzerdefiniertes Feld
  Text, der sich nicht auf die Funktionalität des PromptSet-Elements auswirkt und nicht im Formular angezeigt wird
  Verwenden Sie dieses Feld, um Hinweise zu erhalten oder Informationen zur Aufforderung zu speichern, die aus der Datenbank abgerufen werden kann.

Datenreferenz

Im Feld Datenreferenz können Sie ein Variablenobjekt auswählen, das als Referenzvariable für den Prompt dient. Mit Ausnahme des Prompts Überschrift/Text können Sie in allen Prompts eine Datenreferenz angeben. Die Datenreferenz Variablenobjekt bestimmt den zulässigen Datentyp und die im Prompt angegebenen Werte.

Die Spalte, aus der Werte abgerufen werden, hängt vom Typ des angegebenen VARA-Objekts für die Datenreferenz ab: 

• Statische Variablen: erste Wertspalte
• Dynamische Variablen: Spalte RESULT

Hinweise:

• Wenn Sie ein dynamisches VARA-Objekt (außer FILELIST VARA) als Datenreferenz verwenden, wird die Anzahl der zurückgegebenen Einträge durch den Wert von SQLVAR_MAX_ROWS in den UC_SYSTEM_SETTINGS - Systemübergreifende Einstellungen begrenzt. Der Standardwert ist 200 Zeilen.
• Wenn Sie ein EXEC VARA-Objekt als Datenreferenz verwenden, muss der Name der PromptSet-Variablen (Variablenname) mit der Script-Variablen übereinstimmen, die als Parametername im EXEC-Variablenobjekt eingestellt ist. Weitere Informationen finden Sie auf der EXEC-VARA-Objekte.

Wichtig!

• VARA-Objekte für die Datenreferenz dürfen nicht geändert werden, während Objekte mit Prompt Sets ausgeführt werden oder während diese starten. Die Prompt-Oberfläche wurde zu diesem Zeitpunkt bereits generiert, denn durch die Änderung von Variablenobjekten können Probleme entstehen.
• Entsprechen die eingegebenen Werte eines PromptSet-Elements nicht den Referenzwerten, so ist es nach Objekt-Aktivierung nicht möglich, den Prompt abzusenden. Mehr Informationen dazu finden Sie im Kapitel PromptSets aktivieren.

Erforderliche Datentypen

Das Dropdown-Menü Datenreferenz enthält nur VARA-Objekte, die einen geeigneten Datentyp für das PromptSet-Element haben. Verwenden Sie das entsprechende PromptSet-Element für den jeweiligen Referenz-Datentyp. Verwenden Sie z. B. das PromptSet-Element Zeit/Datum für Datumsdatentypen. Prompts können folgende Datentypen haben:

• Anzahl: Anzahl
  
• Textfeld: Text
• Kombinationsfeld:
  • Text
  • Zahl
  • Zeit
  • Datum
  • Zeitstempel
• Optionsfeld:
  • Text
  • Zahl
• Kontrollkästchen:
  • Text
  • Zahl
• Zeit/Datum:
  Der erforderliche Datentyp hängt von der Einstellung Typ des Prompts ab.
  • Datum
  • Datum und Zeit (Zeitstempel)
  • Zeit

Standard-Datenreferenz-Variablen

Der Systemmandant (0) liefert Standard-Datenreferenzen für die folgenden Prompts:

• Zahl: UC_DATATYPE_NUMERIC
• Textfeld: UC_DATATYPE_STRING
• Zeit/Datum:
  • Datum: UC_DATATYPE_DATE
  • Datum und Zeit: UC_DATATYPE_TIMESTAMP
  • Zeit: UC_DATATYPE_TIME

Schlüssel- und XPath/XQuery-Einstellungen

(Nur Textfeld, Kombinationsfeld, Optionsfeld und Kontrollkästchen) Wenn Sie im Feld Datenreferenz eine XML-Variable auswählen, sind die folgenden zusätzlichen Einstellungen verfügbar:

• Schlüssel
  Schlüssel aus der Schlüsselliste der XML-Variablen, die im Feld Datenreferenz ausgewählt wurde
  
• XPath/XQuery
  Der XPath- oder XQuery-Ausdruck der XML-Variable, die im Schlüssel ausgewählt ist.

Hinweis: Beide Felder erlauben Variablen.

Beispiel

Angenommen, Sie haben das folgende XML im Schlüssel:

<server>

    <name>MyUNIXServer</name>

    <ip>19.16.8.1.200</ip>

</server>

Führen Sie diese Schritte aus, um die IP-Adresse anzugeben:

1. Wählen Sie im Feld Datenreferenz die XML-Variable aus.
2. Wählen Sie im Feld Key den entsprechenden Schlüssel für die XML-Variable aus.
3. Geben Sie server/ip ein.

Standardwert/Standardauswahl

Der Standardwert wird beim Aufruf des PromptSets angezeigt. Wenn der Benutzer keinen anderen Wert auswählt oder das Feld schreibgeschützt ist, wird dieser Wert weitergegeben. Mit Ausnahme des Prompts Überschrift/Text können Sie in allen Prompts einen Standardwert angeben.

Die folgenden Einschränkungen gelten für bestimmte Prompttypen:

• Die Länge des Standardtextes für PromptSet-Elemente ist nicht begrenzt, es sei denn, in der Definition des Variablen-Sets ist eine maximale Länge als Datenreferenz des Prompts angegeben.
• Nachgestellte Leerzeichen werden abgeschnitten.
• Zeit/Datum-Abfrage-Elemente können nicht ohne Standardwerte gespeichert werden. Wollen Sie immer die aktuelle Zeit bzw. das aktuelle Datum beim Aufruf des Prompts anzeigen, so verwenden Sie die vordefinierten Variablen &$PHYS_DATE_format# bzw. &$PHYS_TIME_format# als Standardwert.

Standardwert definieren

Wählen Sie eine Option, um den Standardwert festzulegen:

• Manuell setzen
  Je nach Art des Prompts geben Sie den Standardwert ein, indem Sie entweder den Wert aus dem Steuerelement auswählen oder den Wert in die Symbolleiste des Prompt-Elements eingeben. Verwenden Sie diese Option, wenn Sie einen statischen Standardwert für den Prompt wünschen.
  
• Per Variable setzen
  Geben Sie den Variablennamen in das Feld in der Titelleiste des Prompt-Elements ein, oder klicken Sie auf die Schaltfläche $x, um den Dialog Variable hinzufügen zu öffnen, in dem Sie eine vordefinierte Variable auswählen können. Weitere Informationen finden Sie unter Variablen/VARA-Objekte in Objekte und Scripts einfügen. Verwenden Sie diese Option, wenn der aktuelle Wert der Variablen beim Aufruf des PromptSets abgerufen werden soll. Die Variable liefert Werte in Abhängigkeit vom Objekt, dem das PromptSet zugeordnet ist, und nicht vom PromptSet-Objekt selbst.

Hinweise:

• Manuelle und variable Optionen erlauben sowohl Text als auch Variablen, mit Ausnahme von Nummern-Prompts, die nur Zahlen zulassen.
• Das System prüft nicht, ob der Datentyp des angegebenen Standardwertes mit der Datenreferenz-Variablen übereinstimmt. Die einzige Ausnahme ist das Textfeld-Prompt, bei der das System eine Referenz-Prüfung durchführt, wenn das Datenreferenz Variablenobjekt Text als Datentyp hat.

Wichtig! Sie können ein Prompt Set auch dann speichern, wenn es Prompts enthält, deren Standardwerte den falschen Datentyp verwenden oder gegen die in den Einstellungen des Prompts angegebenen Einschränkungen verstoßen. Zum Fehler kommt es erst beim Speichern des Objekts, dem das PromptSet-Objekt zugeordnet wurde.

Prompt-Werte überschreiben

Der Prompt-Wert kann an mehreren Stellen überschrieben werden. Die Reihenfolge der Priorität des Prompt-Werts für die Aktivierung ist:

1. Der Standardwert (wenn einer gesetzt ist).
2. Der Prompt auf der Seite PromptSets unter Variablen- und Prompts in der Definition eines ausführbaren Objekts überschreibt den Standardwert. Weitere Informationen finden Sie auf der Seite "PromptSets".
3. Überschreiben der Aktivierung der Instanz eines Workflows oder eines anderen ausführbaren Objekts, wenn es ausgeführt wird:
   • Manuell mit dem Kommando Ausführen.
   • Über ein Schedule-Objekt.
   • Über eine Script-Funktion ACTIVATE_UC_OBJECTmit dem Parameter PASS_VALUES unter Verwendung von :PUT_READ_BUFFER, :PUT_PROMPT_BUFFER.

   Hinweis: Die Read-Buffer-Variable muss den gleichen Namen haben wie die PromptSet-Variable (Variablenname). Die Eingabeaufforderung für Prompts wird für Aufgaben, die durch Workflow, Schedule oder Script-Objekte aktiviert werden, nicht angezeigt.

Hinweis: Sie können auch workflow-spezifische Promptwerte definieren. Weitere Informationen finden Sie hier: Registerkarte "PromptSets".

Weitere prompt-spezifische Einstellungen

Einige Einstellungen sind nur für bestimmte Prompttypen verfügbar.

Dynamisch aktualisieren (Kombinationsfeld-Prompts)

Abhängig von der Datenreferenz-Variable führt diese Einstellung eine der folgenden Aktionen aus:

• Wenn der Datenreferenzwert eine dynamische Variable oder ein STATIC VARA-Objekt ist, löst diese Einstellung die Liste von Werten für das Kombinationsfeld bei jedem Aufruf des Prompts auf. Der Inhalt der Liste wird daher immer direkt von der Datenquelle ermittelt. Dieses Verhalten betrifft die Vorschau des PromptSet-Objekts, die Seite Variablen- und Prompts > Variablen für ausführbare Objekte und den Dialog Eingabeaufforderung zur Laufzeit.
• Wenn eine im aktuellen PromptSet definierte Variable auch in der Objektdefinition des Datenreferenz- Variablenobjekts des Kombinationsfeld-Prompts angegeben ist, dann können Sie den Wert des früheren Prompts in zulässigen Feldern der Datenreferenz-Variablen verwenden. Sie müssen den Variablennamen des früheren Prompts in eines der folgenden Objektdefinitionsfelder in der Datenreferenz-Variable-Objektdefinition des aktuellen Prompts eingeben. Weitere Informationen finden Sie unter Variablen-Einstellungen und Parameter in den folgenden Themen:
  • BACKEND VARA-Objekte: Spalten Agent, Login und Kommando des Betriebssystems
  • EXEC-VARA-Objekte: Geben Sie im Abschnitt Parameter die Liste der Parameter und Variablen an, die im ausführbaren Objekt verfügbar sind. Die Werte können sein:
  • FILELIST VARA-Objekte: Agent, Login, und Dateien
  • SEC_SQLI VARA-Objekte: siehe Geben Sie im Abschnitt Variableneinstellungen Folgendes an:
  • SEC_SQL VARA-Objekte: Verbindung, Login und SQL-Anweisung (Geben Sie im Abschnitt Variableneinstellungen Folgendes an:)
  • SQLI-VARA-Objekte  siehe Geben Sie im Abschnitt Variableneinstellungen Folgendes an:
  • SQL-VARA-Objekte: Verbindung, Login und SQL-Anweisung (Geben Sie im Abschnitt Variableneinstellungen Folgendes an:)

Hinweis: Um PromptSet-Variablen in Variablenobjekten zu verwenden, stellen Sie sicher, dass der Wert von VAR_SECURITY_LEVEL in UC_SYSTEM_SETTINGS - Systemübergreifende Einstellungen auf 3 eingestellt ist. Diese Einschränkung gilt nicht für SQL-Anweisungen von VARA-Objekten, die die Quellen SQL SECURE und SQLI SECURE verwenden.

Pflichtfeld (Kontrollkästchen und Textfeld-Prompts)

Der Benutzer muss in den Prompt Daten eingeben oder auswählen

Minimum und Maximum (Anzahl und Zeit/Datum Prompts)

Definieren Sie die minimalen und maximalen zulässigen Werte.

Hinweis: Diese Limitierungen werden bereits beim Speichern des Objektes, dem das PromptSet-Objekt zugeordnet wurde, überprüft. Es ist nicht möglich, Objekte zu speichern, deren PromptSet-Werte auf der Seite Variablen- und Prompts aufgrund der PromptSet-Eigenschaften ungültig sind.

Mehrfachauswahl und Trennzeichen (Kontrollkästchen und Textfeld-Prompts)

Verwenden Sie die folgenden Einstellungen, um die Auswahl mehrerer Werte zu ermöglichen:

• Mehrfachauswahl
  Ermöglicht dem Benutzer die Auswahl mehrerer Werte
• Trennzeichen
  (Nur verfügbar, wenn Sie das Optionsfeld Mehrfachauswahl aktivieren) Zeichen, das einzelne Werte in mehreren Auswahlen trennt
  (Nur Kontrollkästchen-Eingabeaufforderungen) Es ist kein Trennzeichen erforderlich, wenn Sie die Option Array auswählen.

Tipp: (Nur Textfeld-Prompts) Aktivieren Sie die Option Eingabehilfe, damit der Benutzer einfach mehrere Werte auswählen kann.

Zurücksetzen bei Änderung (Textfeld, Kombinationsfeld und Kontrollkästchen-Prompts)

Setzt automatisch den Wert anderer Textfeld-, Kombinationsfeld- und/oder Kontrollkästchen-Prompts, einschließlich Standardwerte, in diesem PromptSet zurück, wenn ein Benutzer einen Wert für diesen Prompt auswählt

Kontrollkästchen werden für jedes Textfeld, jedes Kombinationsfeld und jedes Kontrollkästchen im aktuellen Prompt angezeigt. Markieren Sie die Kontrollkästchen der Felder, die Sie zurücksetzen möchten, wenn ein Benutzer in diesen Prompt einen Wert eingibt.

Textfeld-Einstellungen

Die folgenden zusätzlichen Einstellungen sind nur für Textfeld-Prompts verfügbar:

• Mehrzeilig
  Ermöglicht, dass das Textfeld mehrere Zeilen anzeigt
  Standardmäßig ist das Textfeld einzeilig.
  
• Maximale Länge
  Begrenzt die zulässige Anzahl von Zeichen für den Prompt-Wert
  Diese Überprüfung wird durchgeführt, wenn Sie das PromptSet-Objekt oder ein ausführbares Objekt, dem Sie es zuweisen, speichern.
• Eingabehilfe
  Beinhaltet die Schaltfläche "..." neben dem Textfeld, mit der ein Dialogfeld geöffnet wird, in dem der Benutzer Werte auswählen kann
  Verwenden Sie diese Option in den folgenden Situationen:
  • Sie Werte aus der Datenreferenz-Variable auswählen möchten.
  • Die Datenreferenz ist ein FILELIST VARA-Objekt
  • Mehrfachauswahl ist aktiviert
  Hinweis: Wenn Ihre Datenreferenz ein STATIC VARA-Objekt ist und Sie eine Zeile aus dem Dialogfenster auswählen, wird der Wert aus der Spalte Wert 1 ausgewählt.
  
• Großbuchstaben
  Wandelt automatisch Kleinbuchstaben aus dem Textfeld in Großbuchstaben um
• Als Passwort anzeigen
  Verschlüsselt den Wert des Textfeldes und blendet die im Textfeld eingegebenen Zeichen aus, indem sie als Sternchen (*) angezeigt werden
  Hinweise:
  • Der Text wird in Reports nicht mehr im Klartext angezeigt.
  • Um Kommandos von Windows- oder UNIX-Jobs inklusive verschlüsselter Passwörter auszuführen, verwenden Sie den Parameter CMD des Job Messengers.
    
• Regulärer Ausdruck
  Erstellt Regeln für zulässige Textfeldinhalte mit Hilfe eines regulären Ausdrucks
  Sie können das PromptSet nicht speichern oder einen Wert in einem ausführbaren Objekt dafür angeben, wenn der Wert nicht den Regeln für den regulären Ausdruck entspricht.
  Beispiele:
  Nur zweistellige Zahlen zulassen: [0-9]{2}
  Alle Zeichen außer "x" zulassen: [^x]
  Eines der Zeichen "a", "b" oder "c": [abc]
  Alle Groß- und Kleinbuchstaben, Zahlen und das Komma dürfen so oft wie nötig verwendet werden: [A-Za-z0-9,]*
  Erlaubte Zeichen #, , ,$, @, A-Z, 0-9, und maximale Länge 10: [A-Z0-9_#@$,]{0,10}
  Hinweise:
  • Führende und nachgestellte Leerzeichen in Regulären Ausdrücken sind nicht erlaubt und werden nicht ignoriert.
  • Sie können ein ausführbares Objekt mit einem Prompt ausführen, das über Regeln zu regulären Ausdrücken verfügt, wenn der Prompt keinen Null-Wert enthält. Um sicherzustellen, dass der Prompt einen Wert hat, aktivieren Sie das Kontrollkästchen Pflichtfeld.
    
  Tipp:Nehmen Sie Regeln in den Tooltip des Prompts auf, um die Benutzer zu unterstützen.

Zeit- und Datumseinstellungen

Zusätzlich zu den allgemeinen Einstellungen sind die folgenden Einstellungen für Zeit/Datum-Prompts verfügbar:

• Typ
  Wählen Sie einen der folgenden Typen aus:
  • Datum
  • Datum und Zeit
  • Zeit
  Hinweise:
  • Diese Optionen haben unterschiedliche Standard-Datenreferenzen. Weitere Informationen finden Sie unter Datenreferenz.
  • Die Einstellungen in den Feldern Kalender, Kalenderereignis und Output-Format legen die Datums- und Zeitangaben fest.
• Kalender
  Wählen Sie ein Kalenderobjekt aus, aus dem Sie ein Datum auswählen möchten
• Kalenderereignis
  Wählen Sie ein Kalenderereignis aus dem ausgewählten Kalender aus
• Ausgabeformat
  Wählen Sie ein Datumsformat aus

Verfügbare Formate für Datumstypen:

• DD-MON-YYYY
• DD-MON-RR
• MM-DD-YYYY
• YYYYMMDD
• MMDDRR
• DDMMRR
• MM-DD-RR
• MM/DD/RR
• YYMMDD
• YY.MM.DD
• YY-MM-DD
• YYYYMMDD
• YYYY.MM.DD
• YYYY-MM-DD
• DDMMYY
• DD.MM.YY
• DD-MM-YY
• DDMMYYYY
• DD.MM.YYYY
• DD-MM-YYYY
• MMDDYY
• MMDDYYYY
• MM/DD/YY
• MM/DD/YYYY

Verfügbare Formate für Datums- und Zeittypen: 

• YYYYMMDDHH24MISS
• YYYY-MM-DD HH:MM:SS

Siehe auch:

• PromptSets (PRPT)
• PromptSets aktivieren
• Seite "PromptSets"