Registerkarte Designer

Eingabe von Text.

Leerzeichen am Ende des Textes werden abgeschnitten.

Mit der Referenzvariable werden die erlaubten Werte festgelegt, die in das Textfeld eingegeben werden dürfen (=Referenzwerte). Enthält das Variablen-Objekt keine Werte, so gibt es diesbezüglich keine Beschränkung.

Die Referenz-Prüfung wird bei Textfeldern nur dann durchgeführt, wenn das Referenz-Variablenobjekt den Datentyp "Text" aufweist. Bei anderen Datentypen wird nicht überprüft, ob der eingegebene Wert den Referenzwerten entspricht. Verwenden Sie daher bei anderen Referenz-Datentypen die spezifischen PromptSet-Elemente dafür (zum Beispiel: Datums-Element beim Datentyp "Datum").

Die Verwendung von "Mehrfachselektion" benötigt die Eigenschaft "Trennzeichen". Dabei handelt sich um das Zeichen, dass mehrere Werte voneinander trennt. Beachten Sie, dass bei Mehrfachselektion alle eingegebenen Werte mit den Referenzwerten übereinstimmen müssen!

Für die Länge von Textfeldern gibt es keine Beschränkung.

• Text

Auswahl bzw. Eingabe einer Zahl

Die Referenzvariable bestimmt die erlaubten Werte. Dem Element können nur Variablen-Objekte mit dem Datentyp "Zahl" zugeordnet werden. Sind keine Referenzwerte vorhanden, so gibt es keine Beschränkung. Mehrfachselektion ist nicht möglich.

• Zahl

Auswahl eines bestimmten Punktes von mehreren Optionen.

Das Referenzvariablen-Objekt legt die Anzahl der Optionen und deren Werte fest. Sinnvoll ist die Verwendung des Optionsfeldes erst ab mindestens zwei Auswählmöglichkeiten.

Wurde kein oder ein ungültiger Standardwert (Referenzwerte) im PromptSet-Objekt definiert, so wird in der Eingabeaufforderung automatisch der erste Eintrag selektiert.

• Text
• Zahl

Mehrfachselektion von Optionen

Mit der Referenzvariable wird die Zahl der Checkboxen (empfohlenes Minimum: eins) und deren Beschriftung festgelegt. Wird das Maximum von 32 Auswahlmöglichkeiten überschritten, wird das Element automatisch als Checkliste mit einem Scroller dargestellt.

Wurde kein oder ein auf Grund der Referenzwerte ungültiger Standardwert gesetzt, ist in der aufgerufenen Eingabemaske kein Feld ausgewählt.

• Text
• Zahl

Mehrfachselektion von Optionen

Die Verwendung der Checkliste ist dann sinnvoll, wenn mehrere Checkboxen verwendet werden. Enthält die Checkliste mehr als acht Einträge, wird eine Scroll-Leiste angezeigt.

Die Anzahl und Beschriftung der Einträge wird aus der Referenzvariable bezogen.

Ist kein oder ein falscher Standardwert (Datenreferenz) hinterlegt, so ist zur Laufzeit keine Option gewählt.

• Text
• Zahl

Auswahl eines Eintrages aus einer Liste.

Der Inhalt der Liste wird aus der Referenzvariable ermittelt.

Bei Kombinationsfelder mit vorhandenen Referenzwerten (Referenz-Variable besitzt Einträge), ist immer ein Wert erforderlich!

• Text
• Zahl
• Zeit
• Datum
• Zeitstempel

Datum-Auswahlfeld

Als Referenz kann statt einer Variable auch ein Kalender-Objekt angegeben werden.

Es können nur Datumswerte ausgewählt werden, die den Referenzwerten entsprechen. Als Standardwert wird automatisch das aktuelle Datum eingetragen. Ist dieser Wert auf Grund der Referenzwerte nicht gültig, so wird das zukünftig nächste gültige Datum verwendet.

Datums- und Zeit-Elemente können nicht ohne einen Standardwert gespeichert werden! Wollen Sie immer die aktuelle Zeit bzw. Datum beim Aufruf der Eingabeaufforderung anzeigen, so verwenden Sie die vordefinierten Variablen &$PHYS_DATE_format# bzw. &$PHYS_TIME_format# als Standardwert.

Das Datum kann manuell eingetragen werden oder mittels Dialog selektiert werden. In diesem Datumsdialog werden die ungültigen Tage ausgegraut.

• Datum
• Zeitstempel

Zeit-Auswahlfeld

Als Standardwert wird automatisch die aktuelle Uhrzeit gewählt. Ist kein Wert eingetragen, kann das PromptSet-Objekt nicht gespeichert werden! Ist der Standardwert auf Grund der Referenzwerte ungültig, wird automatisch der nächste gültige Wert ermittelt und in der Eingabemaske angezeigt.

• Zeit

Zeitstempel-Auswahlfeld

Wird ein Kalender angegeben, ist für die Zeit jeder beliebige Wert möglich. Es wird automatisch das aktuelle Datum / Uhrzeit als Standardwert verwendet. Eine Speicherung des Objektes ohne Standardwert ist nicht möglich! Entspricht der Standardwert nicht den Referenzwerten, wird in der Eingabeaufforderung der zukünftig nächste gültige Wert ermittelt und eingetragen.

• Zeitstempel

Das Element dient zur Anzeige von Text und nicht zur Übermittlung von Werten. Die Verwendung ist sinnvoll, um andere Elemente zu beschriften.

Einzelner Wert, den das PromptSet-Element beim Aufruf der Eingabemaske besitzt. Dieser kann in der Registerkarte Variablen & Prompts oder in den Eigenschaften von Workflow- und Schedule-Aufgaben übersteuert werden.

Entspricht der Standardwert nicht dem Datentyp oder den Beschränkungen, die auf PromptSet-Ebene definiert wurden (Minimum, Maximum, Max. Länge, Wert erforderlich), kann das PromptSet-Objekt gespeichert werden. Zum Fehler kommt es erst beim Speichern des Objektes, dem das PromptSet-Objekt zugeordnet wurde!

Als Standardwert können auch vordefinierte Variablen eingetragen werden (Schaltfläche Variablen...). Diese sind zur Laufzeit bereits aufgelöst.

Entspricht der Standardwert von Checkboxen, Kombinationsfelder und Checklisten nicht den Werten oder dem Format der Referenzvariable, so ist beim Aufruf der Eingabemaske keine Option ausgewählt. Kombinationsfelder werden in diesem Fall durch eine gelbe Markierung hervorgehoben, da immer ein Wert ausgewählt werden muss. Beim Optionsfeld ist in diesem Fall automatisch die erste Option selektiert.
Bei Text-, Kombinations-, Datums-, Zeit- und Zeitstempel-Felder wird der falsche Wert angezeigt, es kommt jedoch zu Fehler wenn man die Eingabeaufforderung mit "Fertig" absenden möchte. Achten Sie daher darauf, dass der Standardwert den Referenzwerten entspricht!

Auf fehlerhafte Standardwerte wird in der Eingabeaufforderung in einem eigenen Meldungsfenster hingewiesen.

• Text
• Zahl
• Checkbox
• Optionsfeld
• Checkliste
• Kombinationsfeld
• Datum
• Zeit
• Zeitstempel

Variablen-Objekt, dass festlegt, welche Werte mit dem Steuerelement ausgewählt bzw. eingegeben werden dürfen. Neben den Werten der Variable spielt auch der Datentyp und die Begrenzungen (Minimum, Maximum, Max. Länge) eine Rolle. Welche Referenz-Datentypen für jedes PromptSet-Element erlaubt sind, finden Sie in der oberen Tabelle.

Die Referenzwerte werden dabei immer aus der ersten Wertespalte (statische Variablen) bzw. der Result-Spalte (dynamische Variablen) bezogen!

In dem DropDown-Menü sind nur Variablen-Objekte als Referenz auswählbar, die den passenden Datentyp für das PromptSet-Element aufweisen (siehe Tabelle oben).

Entsprechen die eingegebenen Werten eines PromptSet-Elementes nicht den Referenzwerten, so ist es nach Objekt-Aktivierung nicht möglich, die Eingabeaufforderung abzusenden! Mehr Informationen dazu erhalten Sie im Kapitel PromptSet - Aktivierung.

Beachten Sie folgendes, wenn Sie Dynamische Variablen (Quelle "Dateiliste" ausgenommen) als Datenreferenz verwenden: Die Anzahl der Einträge, die durch dynamischen Variablen-Objekten zurückgeliefert werden, ist durch Einstellung SQLVAR_MAX_ROWS in der Variable UC_SYSTEM_SETTINGS beschränkt (Standardwert: 200 Zeilen).

Achten Sie bei der Anwendung des dynamischen Variablen-Objektes EXEC darauf, dass der Name des PromptSet-Elements und der Name der Script-Variablen einander entsprechen.

Das Variablen-Objekt darf nicht geändert werden während der Job startet oder wenn das Prompt auf dem Bildschirm angezeigt wird, weil dann die Prompt-Oberfläche bereits generiert wurde. Wenn Sie dann die Variable bearbeiten, kann dies Probleme verursachen.

Im Systemmandanten werden statische Variablen-Objekte für jeden Datentyp ausgeliefert, die als Standard-Datenreferenz für jedes PromptSet-Element verwendet werden können: 

• UC_DATATYPE_STRING
• UC_DATATYPE_DATE
• UC_DATATYPE_NUMERIC
• UC_DATATYPE_TIME
• UC_DATATYPE_TIMESTAMP

• Text
• Zahl
• Checkbox
• Optionsfeld
• Checkliste
• Kombinationsfeld
• Datum
• Zeit
• Zeitstempel

Enter the "Key" value of a static Variable object XML (mandatory).

Automation Engine variables may be used as attributes.

May only be used, when the "Data reference" is an XML static Variable object.

• static Variable object XML

Enter an XPath or XQuery expression (mandatory).

Automation Engine variables may be used as attributes.

May only be used, when the "Data reference" is an XML static Variable object.

• static Variable object XML

Verwendung eines Kalenders als Datenreferenz.

Nur möglich für die Elemente Datum und Zeitstempel. Wurde bereits eine Variable als Referenz selektiert, ist das Feld Begriff deaktiviert.

• Datum
• Zeitstempel

Bezeichnender Text, der neben dem Element in der Eingabemaske angezeigt wird.

Durch einen Klick auf die Beschriftung in der Registerkarte "Variablen & Prompts" von ausführbaren Objekten oder Workflow- bzw. Schedule-Aufgaben, wird das PromptSet-Element in ein Textfeld verwandelt in dem eine vordefinierte Variable eingetragen werden kann.

Ist diese Option aktiviert, so kann das Textfeld mehrere Zeilen aufweisen.

Standardmäßig ist diese Option nicht aktiktiviert, daher ist das Textfeld nur einzeilig.

Mehrzeilige Textfelder werden größer als übliche Textfelder dargestellt und besitzen eine Schaltfläche in der rechten oberen Ecke. Wird diese Schaltfläche im PromptSet-Dialog angeklickt, so wird ein Editor-Dialog geöffnet, der eine übsichtlicher und einfacher Bearbeitung des Textfeld-Inhalts ermöglicht.

Der Editor besitzt folgende Funktionen, welche über die Editor-Symbolleiste oder das Kontextmenü erreichbar sind:

• Ausschneiden - Entfernt den markierten Text und kopiert diesen in die Zwischenablage
  
• Kopieren - Kopiert den markierten Text in die Zwischenablage
  
• Einfügen - Fügt den Text aus der Zwischenablage an der Position des Textcursors ein.
  
• Rückgängig - Macht die letzte Änderung rückgängig
  
• Wiederholen - Stellt eine rückgängig gemachte Änderung wieder her.
  
• Suche - Suchen & Ersetzen von Text
  
• Zeilenumbruch - Ist diese Funktion aktiviert, so werden Zeilen am Rand des Editor-Dialogs umgebrochen. Diese Funktion betrifft nur die Anzeige, verändert den Inhalt aber nicht.
  
• Variablen - Öffnet einen Dialog, um vordefinierte Variablen einzufügen.
  
• In Großbuchstaben/In Kleinbuchstaben - Wandelt den markierten Text in Groß- bzw. Kleinschreibung um.
  
• Alles markieren - Markiert den kompletten Inhalt des Textfelds.

• Text

Auswahl bzw. Eingabe mehrerer Werte erlauben

Bei Textfeldern mit Multiselektion können mehrere Werte getrennt durch das Trennzeichen eingegeben werden. Bei vorhandenen Referenzwerten werden alle diese Werte auf Gültigkeit überprüft!

Bei Checkliste / Checkboxen ist diese Option immer gesetzt und kann nicht deaktiviert werden!

• Text
• Checkbox
• Checkliste

Zeichen, das die einzelnen Werte bei Mehrfachselektion trennt.

Standardwert: ";"

Das Trennzeichen ist nicht anzugeben, wenn die Option Array aktiviert ist.

• Text
• Checkbox
• Checkliste

Mehrere Werte von Checkboxen und Checklisten werden an das Objekt als Array-Variable zur Verfügung gestellt. Die Verwendung ist daher nur im Zusammenhang mit der Eigenschaften "Multiselektion" möglich. Der Name der Variable wird unter "Variablenname" festgelegt.

Ist diese Option deaktiviert, werden alle gewählten Optionen getrennt durch das Trennzeichen als ein Wert übergeben.

• Checkbox
• Checkliste

Beschränkung des erlaubten Wertebereichs für das Element

Minimum, Maximum: Zeichenkette, welche den minimalen und/oder maximalen Wert angibt.
Max. Länge (nur bei Textfeldern): Anzahl der maximalen Zeichen für Textfelder. Bei "0" oder keiner Angabe gibt es keine Beschränkung.

Diese Limitierungen werden bereits beim Speichern des Objektes, dem das PromptSet-Objekt zugeordnet wurde, überprüft. Dadurch ist es nicht möglich Objekte zu speichern, deren PromptSet-Werte in der Registerkarte "Variablen & Prompts" auf Grund der PromptSet-Eigenschaften ungültig sind!

Ist "Max. Länge" gesetzt, so können nicht mehr als die maximale Anzahl an Zeichen in das Textfeld eingegeben werden.

Minimum, Maximum:

• Zahl
• Datum
• Zeit
• Zeitstempel
  

Max. Länge:

• Text
  

• Text

• Text
• Zahl
• Checkbox
• Optionsfeld
• Checkliste
• Kombinationsfeld

Ausgabeformat für die Werte der Steuerelemente Datum und Zeitstempel.

Dieses Feld ist nur aktiviert, wenn als Referenz ein Kalender-Objekt gesetzt wurde (Mussfeld). Ansonsten ist die Definition des Ausgabeformats im Referenz-Variablen-Objekt durchzuführen.

• Datum
• Zeitstempel

Name der PromptSet-Variable, die dem Objekt zur Verfügung steht und den bzw. die Werte des Elementes speichert. PromptSet-Variablen können wie Objektvariablen verwendet werden (Änderung, Vererbung usw. möglich).

Der Variablenname ist dabei ohne führendes & anzugeben! Im Objekt selbst sind PromptSet-Variablen immer mit & anzusprechen!

• Text
• Zahl
• Checkbox
• Optionsfeld
• Checkliste
• Kombinationsfeld
• Datum
• Zeit
• Zeitstempel

Diese Eigenschaft ist nur bei Kombinationsfeldern verfügbar und macht nur Sinn, wenn es sich bei der Datenreferenz um ein dynamisches Variablen-Objekt (EXEC, SQL, SQLI oder FILELIST) handelt!

Ist diese Option gesetzt, wird die Referenzvariable bei jedem Aufruf des Kombinationsfeldes neu aufgelöst. Der Inhalt der Liste wird daher beim Aufklappen immer direkt von Datenquelle ermittelt. Dieses Verhalten betrifft die Vorschau des PromptSet-Objektes, die Registerkarte "Variablen & Prompts" und den PrompSet-Dialog zur Laufzeit.

Mehr Informationen dazu finden Sie bei der Beschreibung von dynamischen Eingabedialogen.

• Kombinationsfeld

Kann mit einem Pfeil erweitert werden, wenn Sie zwei oder mehr Comboboxen, Checkboxen oder Checklisten definieren und diese im Designbereich aktiv sind.
Wenn Sie dieses Element erweitern, werden die Namen der inaktiven Comboboxen, Checkboxen oder Checklisten sowie ein Kontrollkästchen neben dem jeweiligen Namen angezeigt.
Ein Element mit aktivem Kontrollkästchen wird zurückgesetzt, wenn das aktuell aktive Element geändert wird.

Eine Hervorhebung zeigt die abhängigen Elemente an.

Beispiel: Combobox 1 und 2 wurden erstellt. Sie aktivieren Combobox 1 im Designbereich, erweitern den Pfeil neben "Reset bei Änderung" und aktivieren das Kontrollkästchen neben dem Name der Combobox 2.
Folglich wird die Combobox 2 zurückgesetzt, wenn ein Benutzer die Inhalte der Combobox 1 im resultierenden PromptSet ändert.

• Text
• Kombinationsfeld
• Checkbox
• Checkliste

Ist die Eingabehilfe aktiviert, wird neben dem Textfeld die Schaltfläche "..." angezeigt. Über diesen Button wird ein Dialog geöffnet, der die Einträge der Referenzvariable auflistet. Die Key-Spalte von statischen Variablen-Objekten ist dabei nicht verfügbar. Aufrufbar ist diese Schaltfläche sowohl in der Registerkarte "Variablen & Prompts" als auch zur Laufzeit in der Eingabeaufforderung.

Mit dem Suchfeld kann die Liste gefiltert werden. Es wird dabei immer das gesamte Variablen-Objekt durchsucht und nicht nur die angezeigten Einträge. Sie können auch einstellen, in welcher Spalte gesucht werden soll. Sie wird durch ein -Symbol gekennzeichnet .

Wird eine Zeile ausgewählt und der Dialog mit OK bestätigt, so wird der Wert der ersten Spalte in das Textfeld übernommen. Bei Mehrfachselektion besteht die Möglichkeit mehrere Einträge auszuwählen. Die Werte werden dann mit Trennzeichen dem Textfeld zugewiesen.

• Text

Erstellung von Regeln für den erlaubten Inhalt des Textfeldes mit Hilfe eines regulären Ausdrucks

Mehr Informationen zum regulären Ausdruck finden Sie hier.

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. Maximale Länge 10:  [A-Z0-9_#@$,]{0,10}

Achten Sie darauf, keine Leerzeichen zu Beginn und am Ende des regulären Ausdrucks zu verwenden, da diese nicht erlaubt sind und nicht automatisch ignoriert werden.

• Text

• Text
• Zahl
• Checkbox
• Optionsfeld
• Checkliste
• Kombinationsfeld
• Datum
• Zeit
• Zeitstempel

Der Benutzer muss einen Wert eintragen bzw. auswählen oder den Standardwert übernehmen.

Textfelder mit dieser Option werden zur Laufzeit gelb hervorgehoben, wenn kein Wert eingetragen ist. Es daraufhin nicht möglich, den PromptSet-Dialog abzusenden.

• Text
• Checkbox
• Checkliste

Selektierung des Element in der Eingabemaske. Die Aktivierung dieser Option ist nur für ein bestimmtes Steuerelement pro PromptSet-Objekt sinnvoll. Wird diese Einstellung mehrfach gesetzt, erhält das letzte betroffene Steuerelement den Fokus.

• Text
• Zahl
• Checkbox
• Optionsfeld
• Checkliste
• Kombinationsfeld
• Datum
• Zeit
• Zeitstempel

Im Textfeld eingegebene Zeichen werden als '*' angezeigt.

Aktivieren Sie die Option, so wird der Wert des Textfeldes zusätzlich verschlüsselt und scheint beispielsweise in Reports nicht mehr im Klartext auf!

Um Befehle von Windows- oder UNIX-Jobs inklusive verschlüsselter Passwörter auszuführen, dient der Parameter CMD des Jobmelders.

• Text

Zusätzliches Feld, in dem Sie einen beliebigen Text eintragen können.

Das Feld hat keine Auswirkung auf die Funktionalität des PromptSet-Elementes.