Skip to main content

xSuite Interface Windows Prism 5.x – Online-Hilfe

Konfigurationsformular

interface_konfigurator_formular.png

Wenn der Benutzer im Konfigurationsbaum ein Objekt ausgewählt hat, werden im Konfigurationsformular die elementaren Konfigurationseigenschaften des Objektes angezeigt. In diesem Formular kann der Benutzer die einzelnen Werte der Konfigurationseigenschaften bearbeiten.

Obligatorische Konfigurationseigenschaften sind durch einen roten Stern (interface_konfigurator_stern_rot.png) hinter dem Feldtitel gekennzeichnet. Wenn die Angabe nur kontextabhängig obligatorisch ist, z. B. in Abhängigkeit von einer anderen Eigenschaft, ist der Stern dunkelrot dargestellt (interface_konfigurator_stern_dunkelrot.png).

Eigenschaften, die ein Passwort darstellen oder die Einbindung eines Passworts über den Button § zulassen, sind durch ein §-Zeichen im Platzhalter-Text des Eingabefeldes gekennzeichnet. Eigenschaften, deren Werte zur Laufzeit dynamisch aus Feldvariablen und Systemvariablen generiert werden können, sind durch ein %-Zeichen gekennzeichnet.

Felder

Im Konfigurationsformular sind abhängig von der Art einer Konfigurationseigenschaft verschiedene Arten von Eingabefeldern verfügbar:

Feld

Feldwert

Beschreibung

interface_konfigurator_textfeld.png

Textwert

Für Textwerte wird ein Texteingabefeld angezeigt.

interface_konfigurator_passwort.png

Passwort

Bei einem Feld zur Eingabe eines Passwortes oder Passwort-Hashes wird der Eingabewert automatisch verschlüsselt bzw. dessen Hash-Wert berechnet.

Voraussetzung für die Verschlüsselung ist die Angabe eines entsprechenden Zertifikats vom Typ "Crypt" in der globalen Konfiguration der laufenden Programminstanz.

interface_konfigurator_zahlenwert.png

Zahlenwert

Für Zahlenwerte wird ein Texteingabefeld angezeigt. Die Eingabe ist auf numerische Zeichen beschränkt.

interface_konfigurator_wahrheitswert_false.png
interface_konfigurator_wahrheitswert_true.png

Wahrheitswert

Für Wahrheitswerte wird ein Ein-/Aus-Schalter angezeigt, ergänzt um eine Klartextanzeige ihres Wertes (true oder false).

Diese Anzeige dient gleichzeitig als Eingabefeld, wenn der Wert über eine Konstante definiert werden soll.

interface_konfigurator_auswahlliste.png

Auswahlliste

In Auswahllisten werden alle verfügbaren Werte einer Konfigurationseigenschaft angezeigt. Der Benutzer kann einen dieser Werte auswählen.

Alternativ hat der Benutzer die Möglichkeit, direkt eine Konstante in das Feld einzugeben.

interface_konfigurator_multiple_werte.png

Multiple Werte

Für Eigenschaften mit multiplen Werten werden die betreffenden Eingabefelder untereinander als Liste dargestellt.

Über den Button interface_icon_plus.png wird ein Eingabefeld für einen weiteren Wert angehängt. Über den Button ButtonDelete.png neben einem Feld wird sein Wert wieder aus der Liste entfernt.

Die Werte können per Drag-and-Drop innerhalb der Liste verschoben werden. Das Symbol interface_icon_listeneintrag.png dient zum Greifen eines Listeneintrags.

Buttons

Button

Beschreibung

IconGlobal.png

Legt die globale Konfiguration fest. Dieser Button wird nur in der Menüleiste angezeigt, wenn eine Szenariokonfiguration im Konfigurator geöffnet ist.

beschriftung_interface_konfigurator_globale_konfiguration.png

Durch einen Klick auf diesen Button kann der Benutzer die globale Konfiguration auswählen, aus der bei Bedarf zusätzliche Daten zur Bearbeitung des Szenarios herangezogen werden.

Diese zusätzlichen Daten beziehen sich z. B. auf die Auswahl globaler Konstanten oder Webservice-Benutzer, die global definiert sind. Hier sollte die globale Konfiguration ausgewählt werden, die zur Laufzeit zur Ausführung des Szenarios genutzt wird.

ButtonPassword.png

Fügt einen verschlüsselten Passwort-Wert an der aktuellen Cursor-Position oder Auswahl in ein Eingabefeld ein.

Diese Funktion kann für Felder eingesetzt werden, in denen das Passwort nur einen Teilwert darstellt, z. B. in einer Verbindungszeichenfolge. Für reine Passwort-Felder findet eine automatische Verschlüsselung direkt nach der Klartext-Eingabe statt. Die notwendige Entschlüsselung zur Laufzeit erfolgt nur für Konfigurationseigenschaften, die in dieser Dokumentation und im Konfigurator entsprechend gekennzeichnet sind.

Dieser Button ist in der Titelzeile jedes Eingabeformulars verfügbar.

§

Fügt eine Konstante, die in der aktuellen oder in einer vorab ausgewählten globalen Konfiguration (Button IconGlobal.png) definiert ist, oder eine Feld-/Systemvariable an der aktuellen Cursor-Position oder Auswahl in ein Eingabefeld ein.

Dieser Button ist auch direkt neben einigen Eingabefeldern verfügbar. In diesem Fall können über diesen Button spezielle Variablen ausgewählt werden, die nur für die jeweilige Konfigurationseigenschaft relevant sind.

Dieser Button ist in der Titelzeile jedes Eingabeformulars verfügbar.

ButtonValueHelp.png

Öffnet eine Wertehilfe.

Für einige Konfigurationseigenschaften ist eine zusätzliche Wertehilfe verfügbar. Dies sind z. B. Eigenschaften, die eine spezielle Eingabesyntax erfordern oder die Auswahl eines Eintrags aus einer Auswahlliste.

ButtonFilter.png

Öffnet die Filter-Optionen.

interface_konfigurator_filter_dialog.png

In den Filter-Optionen kann der Benutzer Positiv- und/oder Negativ-Filter festlegen. Ein Klick auf den Button ButtonAdd.png fügt einen neuen Filter-Eintrag hinzu. Vorhandene Einträge können über den Button ButtonDelete.png gelöscht werden.

Ein Filter-Eintrag kann aus einem Wildcard-Ausdruck (mit *, ? und #) oder einem regulärer Ausdruck (eingebettet in /.../) bestehen. Weitere Informationen zur Syntax finden Sie unter Syntax von Namensfiltern.

ButtonMacro.png

Öffnet den Makro-Editor.

Mithilfe des Makro-Editors kann der Benutzer aus vorhanden Makroausdrücken auswählen und diese testen.

Weitere Informationen zur Verwendung des Makro-Editors finden Sie unter Makro-Editor für interne Makrofunktionen.

ButtonMultiParam.png

Öffnet eine Wertehilfe für zusammengesetzte Werte.

Für Feldwerte, die sich aus mehreren Teilparametern zusammensetzen (siehe Syntax von zusammengesetzten Werten) kann über diesen Button ein Werthilfe-Dialog geöffnet werden. Der Wertehilfe-Dialog ist generisch anhand von Metadaten aufgebaut.

Die Eingabefelder stellen jeweils einen dieser Parameter dar und sind mit seinem Namen betitelt. Gemäß der 2 Syntaxvarianten für zusammengesetzte Werte kann über die Schaltfläche Namen verwenden bestimmt werden, ob die Parameternamen in den Zielwert übernommen werden. Wenn die Parameternamen nicht übernommen werden, werden nur die reinen Parameterwerte in der vorgegebenen Reihenfolge übernommen.

ButtonJson.png

Stellt die Daten des Formularinhalts im JSON-Format dar.

In dieser JSON-Darstellung kann der Inhalt direkt bearbeitet werden. Nach einer Syntaxprüfung kann der bearbeitete Inhalt über einen Klick auf den Button Accept.png übernommen werden.

Hinweis

Dieser Button ist nur im Expertenmodus verfügbar.

Achtung

Die Bearbeitung der JSON-Daten ist eine Sonderfunktion, die nur in begründeten Ausnahmefällen genutzt werden sollte. Die Nutzung dieser Funktion kann unerwartete Folge haben.

In den JSON-Daten sollten insbesondere keine Unterelemente bearbeitet oder gar gelöscht werden, die im Konfigurationsbaum eigene Unterknoten bilden. Nach Änderung der Daten wird nur die aktuelle Formulardarstellung aktualisiert, aber nicht die Baumdarstellung. Dies kann zu Inkonsistenzen zwischen angezeigten und tatsächlichen Konfigurationsdaten führen und somit Folgefehler bei der weiteren Bearbeitung nach sich ziehen.