Die Funktionen "msgbox" und "inputbox" und ihre Parameter.
Cloud Abo
On-Premises
In Python Scripts können Message- und Inputboxen angezeigt werden.
Wichtig ist hierbei folgendes zu beachten:
Stellen Sie sicher, dass es eine Oberfläche gibt, wo der User den Dialog auch beantworten kann. In Event Scripts, geplanten Aufgaben oder via Webservice beispielsweise ist dies nicht der Fall. Sie können dies mit dem OCL Operator .hasGUI im Script überprüfen:
if vtcapp.evalocl("Session.allInstances->first.hasGUI"): vtcapp.msgbox("Dies ist mein Text")
Dialoge dürfen keinesfalls innerhalb des SystemContext, also mit erweiterten Berechtigungen, angezeigt werden. Diese gelten nämlich systemweit, und solange ein solcher Dialog nicht geschlossen würde, würden die erweiterten Berechtigungen im gesamten Vertec gelten.
vtcapp.msgbox(text[, buttons][, title])
Der Text, der angezeigt werden soll.
Wird nur der Text angegeben, enthält die Messagebox den Titel "Information" sowie einen OK Button:
vtcapp.msgbox("Dies ist mein Text")
Lange Texte können mit \n umgebrochen werden:
vtcapp.msgbox("Hier kommt \nder Zeilenumbruch")
Hier wird die Kombination von Buttons (OK, Cancel etc.) und Zeichen (rotes X, gelbes Ausrufezeichen etc.) festgelegt, die angezeigt werden soll. Die Angabe erfolgt über eine Nummer. Wird nichts angegeben, enthält die Messagebox einen OK Button.
vtcapp.msgbox("Dies ist mein Text", 1)
Die am häufigsten verwendeten Buttons / Icons sind:
| Wert | Beschreibung |
|---|---|
| 0 | OK Button. |
| 1 | OK und Abbrechen Buttons. |
| 3 | Ja, Nein, und Abbrechen Buttons. |
| 4 | Ja und Nein Buttons. |
| 16 | Kritische Message: rotes X und einen OK-Button. |
| 48 | Warnung: gelbes Ausrufezeichen und einen OK-Button. |
| 64 | Information: Blaues i und einen OK-Buton |
Der Titel der Messagebox.
vtcapp.msgbox("Dies ist mein Text", 1, "Vertec")
Wird ein Titel angegeben, muss auch ein Button angegeben werden.
Falls nichts angegeben wird, hat die Messagebox den Titel "Information".
Die Messagebox hat folgende Rückgabewerte:
| Wert | Geklickter Button |
|---|---|
| 1 | OK |
| 2 | Abbrechen |
| 6 | Ja |
| 7 | Nein |
vtcapp.inputbox(title, text[, default])
Der Titel der Inputbox. Soll die Inputbox keinen Titel haben, geben Sie einen Leerstring an.
Der Text, der angezeigt werden soll.
vtcapp.inputbox("Vertec", "Wie lautet Ihr Name?")
Falls der Text mehrzeilig ist, können die einzelnen Zeilen durch \n getrennt werden.
Falls Sie einen Text als Standardantwort im Feld anzeigen möchten, können Sie als dritten Parameter den Wert angeben.
vtcapp.inputbox("Vertec", "Wie lautet Ihr Name?", "Hier Ihren Namen eingeben")
Wenn der Benutzer OK klickt (oder Enter drückt), wird der Inhalt der Textbox zurückgegeben.
Wenn der Benutzer Abbrechen klickt, wird ein Leerstring zurückgegeben.