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

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

• SQLVAR_MAX_ROWS
• UC_SYSTEM_SETTINGS - Systemübergreifende Einstellungen
• EXEC VARA-Objekte 
• 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 Schlüssel 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.
  

• 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:

1. Der Standardwert (wenn einer gesetzt ist).

2. Der Prompt auf der Seite PromptSets unter Variablen & Prompts in der Definition eines ausführbaren Objekts überschreibt den Standardwert.

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 .

Weitere Informationen finden Sie hier:

• ACTIVATE_UC_OBJECT
• :PUT_READ_BUFFER, :PUT_PROMPT_BUFFER
• Registerkarte "PromptSets" (für Workflows)

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:

• BACKEND VARA-Objekte
• EXEC VARA-Objekte 
• FILELIST VARA-Objekte 
• SEC_SQLI VARA-Objekte: siehe Geben Sie im Abschnitt Variableneinstellungen Folgendes an:
• SEC_SQL VARA-Objekte: Verbindung, Anmeldung und SQL-Anweisung (SEC_SQL VARA-Objekte)
• SQLI VARA-Objekte : siehe Geben Sie im Abschnitt Variableneinstellungen Folgendes an:
• SQL-VARA-Objekte: Verbindung, Anmeldung und SQL-Anweisung (SQL-VARA-Objekte)
• VAR_SECURITY_LEVEL
• UC_SYSTEM_SETTINGS - Systemübergreifende Einstellungen

Muss verpflichtend angepasst werden

(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 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

  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 oder ein ausführbares Objekt, das Sie diesem zuweisen, speichern.

• 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 STATIC VARA-Objekt 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 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

  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 Komma-Zeichen 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 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.
  • 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"