PromptSet Designer

Sie konfigurieren PromptSet-Objekte im PromptSet Designer, wo Sie interaktive Eingabeformulare hinzufügen, mit denen 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.

Diese Seite beinhaltet Folgendes:

Definieren von PromptSets

Klicken Sie in der Perspektive "Process Assembly" auf Objekt hinzufügen. Wählen Sie im Dialogfeld Objekt hinzufügen die Option PromptSet aus. Weitere Informationen zum Hinzufügen von Objekten finden Sie unter Hinzufügen von Objekten.

Die Definition eines PromptSet-Objekts besteht aus den folgenden Seiten:
- Standardseiten, die unabhängig von dem von Ihnen definierten Objekttyp zu jeder Zeit verfügbar sind:
- Die hier beschriebene, objektspezifische Seite.
Hinweis: Sie können PromptSet-Objekte auch direkt über die Kombinationsfelder erstellen, die zur Auswahl von Objekten dienen, siehe AWI-Kombinationsfelder verwenden.
Geben Sie im Dialogfeld Objektname den Namen des neuen Objekts ein. Wählen Sie ihn mit Bedacht aus. Weitere Informationen finden Sie unter Best Practices: Namenskonventionen für Objekte.
Klicken Sie auf OK, um die Objektdefinition auf der Seite PromptSet Designer zu öffnen.
Ziehen Sie die gewünschten PromptSet-Elemente per Drag-and-drop aus dem Bereich Elemente rechts im Bildschirm in die PRPT-Canvas.
Konfigurieren Sie die Einstellungen der Elemente. Die verfügbaren Optionen werden unten beschrieben.
Verwenden Sie Drag-and-drop, um die Reihenfolge der Elemente im Formular zu ändern. Prompts werden in der Reihenfolge aufgerufen, in der sie hier erscheinen.
Um ein Element zu entfernen, wählen Sie es aus und wählen dann Löschen in der Symbolleiste aus.
Um eine Vorschau des PromptSet-Objekts anzuzeigen, klicken Sie auf die Schaltfläche Vorschau in der Symbolleiste. Das Formular wird in einem Pop-up-Dialogfeld angezeigt.

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

Sie können nun das PromptSet-Objekt ausführbaren Objekten zuordnen. Dies tun Sie auf der Seite Variablen & Prompts > PromptSets von ausführbaren Objekten. Weitere Informationen finden Sie unter Definieren der Seite "PromptSets".

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 im Formular. Das Feld zeigt beim Hinzufügen des Elements einen Standardwert an, den Sie bearbeiten können.
Variablenname

Definiert eine Prompt Set-Variable, die Sie in Scripts verwenden können. Die Variable wird jedes Mal angelegt, wenn das ausführbare Objekt ausgeführt wird. 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.

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.
ToolTip

Text, der angezeigt wird, wenn der Benutzer mit der Maus über das Feld fährt.
Fokus setzen

Setzt den Prompt in den Fokus, wenn der Benutzer das Formular ansieht. Wird diese Einstellung für mehrere Prompts gesetzt, erhält der letzte ausgewählte Prompt mit dieser Option den Fokus.
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 die Funktionalität des Prompt Set-Elements nicht beeinträchtigt und nicht im Formular angezeigt wird. Verwenden Sie dieses Feld für Notizen oder zum Speichern von Informationen über den Prompt, die von der Datenbank gelesen werden können.

Weitere Informationen finden Sie unter Script-Variablen.

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-Objekte 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 der UC_SYSTEM_SETTINGS-Variablen 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.

Wichtig!

VARA-Objekte für die Datenreferenz dürfen nicht geändert werden, während Objekte mit PromptSets 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.

Weitere Informationen finden Sie hier:

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:

<name>MyUNIXServer</name>

</server>

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

Wählen Sie im Feld Datenreferenz die XML-Variable aus.
Wählen Sie im Feld Schlüssel den entsprechenden Schlüssel für die XML-Variable aus.
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.
Durch Variable setzen

Geben Sie den Variablennamen in das Feld in der Symbolleiste 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. 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 PromptSet 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 Objektes, dem das PromptSet-Objekt zugeordnet wurde.

Weitere Informationen finden Sie unter Variablen/VARA-Objekte in Objekte und Scripts einfügen.

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:

Der Standardwert (wenn einer gesetzt ist).
Der Prompt auf der Seite PromptSets unter Variablen & Prompts in der Definition eines ausführbaren Objekts überschreibt den Standardwert.
Ü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: Sie können auch workflow-spezifische Promptwerte definieren. Weitere Informationen finden Sie hier.

Weitere Informationen finden Sie hier:

Weitere prompt-spezifische Einstellungen

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

Dynamisch aktualisieren

(Eingabeaufforderungen für Kombinationsfeld)

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-Objektes, die Seite Variablen & 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.

Hinweis: Um PromptSet-Variablen in Variablenobjekten zu verwenden, stellen Sie sicher, dass der Wert von VAR_SECURITY_LEVEL in der UC_SYSTEM_SETTINGS-Systemvariablen auf 3 gesetzt ist. Diese Einschränkung gilt allerdings nicht für die SQL-Statements von VARA-Objekten mit der Quelle SQL SECURE und SQLI SECURE.

Weitere Informationen finden Sie unter Variablen-Einstellungen und Parameter in den folgenden Themen:

Definieren von VARA-Objekten vom Typ BACKEND
VARA-Objekte vom Typ EXEC
VARA-Objekte vom Typ FILELIST
VARA-Objekte vom Typ SEC_SQLI: siehe Legen Sie im Abschnitt Variableneinstellungen fest, wie das VARA-Objekt auf das Zielsystem zugreifen soll, von dem es die Werte abruft:
SEC_SQL VARA-Objekte: Verbindung, Login und SQL-Anweisung (SEC_SQL VARA-Objekte)
SQLI-VARA-Objekte: siehe Legen Sie im Abschnitt Variableneinstellungen fest, wie das VARA-Objekt auf das Zielsystem zugreifen soll, von dem es die Werte abruft:
SQL-VARA-Objekte: Verbindung, Anmeldung und SQL-Anweisung (SQL-VARA-Objekte)
VAR_SECURITY_LEVEL
UC_SYSTEM_SETTINGS: Systemweite Einstellungen

Pflichtfeld

(Kontrollkästchen und Textfeld-Prompts)

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

Minimum und Maximum

(Eingabeaufforderungen für Anzahl und Uhrzeit/Datum)

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 & 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.

Bei Änderung zurücksetzen

(Textfeld, Kombinationsfeld und Kontrollkästchen-Prompts)

Setzt automatisch den Wert anderer Textfeld-, Kombinationsfeld- und/oder Kontrollkästchen-Prompts (einschließlich Standardwerten) in diesem PromptSet zurück, wenn ein Benutzer einen Wert für diese 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

Erlaubt dem Textfeld, mehrere Zeilen anzuzeigen. Standardmäßig ist das Textfeld einzeilig.
Maximale Länge

Begrenzt die Anzahl an erlaubten Zeichen für den Prompt-Wert. Diese Überprüfung wird durchgeführt, wenn Sie das PromptSet-Objekt speichern oder ein ausführbares Objekt, dem Sie es zuordnen.
Eingabehilfe

Enthält eine Schaltfläche "...." neben dem Textfeld, die ein Dialogfenster öffnet, 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 Objekt vom Typ "STATIC VARA" ist und Sie eine Zeile aus dem Dialogfenster auswählen, wird der Wert aus der Spalte "Wert 1" ausgewählt.
Großschreibung

Konvertiert automatisch Kleinbuchstaben aus dem Textfeld in Großbuchstaben
Als Kennwort anzeigen

Verschleiert den Wert des Textfeldes und maskiert die im Textfeld eingegebenen Zeichen, 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 Kennwörter auszuführen, verwenden Sie den Parameter CMD des Job Messengers.
Regulärer Ausdruck

Erstellung von Regeln für den erlaubten Inhalt des Textfeldes mithilfe eines regulären Ausdrucks. Sie können das Prompt Set nicht speichern oder einen Wert in einem ausführbaren Objekt festlegen, wenn der Wert diesen Regeln nicht entspricht.

Beispiele:

Nur zweistellige Zahlen erlauben: [0-9]{2}

Alle Zeichen außer "x" erlauben: [^x]

Entweder das Zeichen "a", "b" oder "c": [abc]

Alle Groß- und Kleinbuchstaben, Ziffern und das Kommazeichen sind beliebig oft erlaubt: [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 die Prompt einen Wert hat, aktivieren Sie das Kontrollkästchen Pflichtfeld.
Tipp: Nennen Sie Regeln im Tooltip der Prompt, 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.
- 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: