Quellstruktur - Eigenschaften für das Portal

Die Quellstruktur beschreibt mit Hilfe einiger portalspezifischer Eigenschaften das zu erzeugende Portal-Formular.

Satzarterkennungen sind nicht notwendig.

Es können keine Felder direkt auf der obersten Ebene angelegt werden.

Portal-Eigenschaften für Knoten


images/download/attachments/62865006/Portal_3-version-1-modificationdate-1611285536883-api-v2.png


(1) Wert _hAlign_ z. B. bewirkt, dass die Felder dieses Knotens im daraus erzeugten Formular nicht untereinander, sondern nebeneinander dargestellt werden. Für eine vollständige Liste siehe Abschnitt Werte für Eigenschaft "Portalsteuerung".

(2) Soll im Formular statt des Namens des Knotens ein anderes Label verwendet werden, muss hier ein Schlüsselname für die Lokalisierung eingetragen werden (frei wählbar, hier Kopf). Dasselbe gilt auch für Felder. Über den Schlüsselnamen kann dann der lokalisierte Name zugeordnet werden. Mehr dazu im Abschnitt Lokalisierung.

(3) Pro Quellknoten kann hier ein Profil angegeben werden zur dynamischen Befüllung der Felder dieses Knotens. Siehe Abschnitt Dynamisches Befüllen von Formularfeldern.

Portal-Eigenschaften für Felder


images/download/attachments/62865006/Portal_4-version-1-modificationdate-1611285536914-api-v2.png images/download/thumbnails/62865006/Portal_5-version-1-modificationdate-1611285536938-api-v2.png


(1) Bei Ja wird dieses Feld in Listen des Portal-Formulars gezeigt. Diese Einstellung hat keinen Einfluss auf die Anzeige des Formular-Eingabefeldes des entsprechenden Profil-Feldes selbst. Dafür bitte den Wert _hidden_ in der Feld-Eigenschaft (3) verwenden.

(2) Sind dort mehrere Werte mit Semikolon ; getrennt hinterlegt, wird im Formular automatisch eine Auswahlliste erzeugt. Tragen Sie die Werte A;B;C ein. Diese Werte können ebenfalls lokalisiert werden - siehe Abschnitt Lokalisierung. Ein hinterlegter regulärer Ausdruck regex:xxx kann zur Prüfung erlaubter Werte verwendet werden (was keine Auswahlliste erzeugt).

(3) Für eine vollständige Liste siehe Abschnitt Werte für Eigenschaft "Portalsteuerung".

(4) Zu Listen: Kann es den Knoten dieses Feldes mehr als einmal geben (Eigenschaft Maximum des Knotens > 1), wird im Formular eine Übersichtsliste erzeugt. Diese Liste wird nicht erzeugt bei Maximum = 1. Eigenschaft Minimum hat keinen Effekt. Siehe Listenfeld Text und Eingabefeld Text in der Ansicht im Portal.

Hinweis: Will man im Profil auswerten, welche Datensätze (Zeilen) in einer Liste erzeugt, geändert oder gelöscht wurden (das kann gerade beim dynamischen Befüllen von Formularfeldern interessant sein), kann man ein zusätzliches Feld mit dem Namen row_change_kind und dem Wert _hidden_ für die Feldeigenschaft Portalsteuerung in diesem Knoten erzeugen. Dieses Feld erhält dann im Profil automatisch jeweils einen der Werte created, updated oder deleted. Wichtiger Hinweis: Wenn Sie mehrere Felder row_change_kind verwenden, dann erhalten diese in Lobster_data ein Feldnamen-Suffix (z. B. row_change_kind-1), da Feldnamen eindeutig sein müssen. Verwenden Sie dann bitte auf allen diesen Feldern eine Satzarterkennung mit der Bedingung Ist gleich und dem Wert row_change_kind.


images/download/thumbnails/62865006/Portal_10-version-1-modificationdate-1611285536863-api-v2.png


Hinweis: Wenn für ein Profil-Feld der Typ Blob verwendet wird, ist das Eingabefeld im Formular ein mehrzeiliges Textfeld (siehe Feld Freitext).

Hinweis: Bei numerischen Typen muss eine Vorlage ohne Tausendertrenner angegeben werden. Ein Dezimaltrennzeichen "." darf gegebenenfalls verwendet werden. Der verwendete Browser gibt je nach Spracheinstellung dann das passende Dezimaltrennzeichen aus, also für Deutsch ein Komma (,) und für Englisch einen Punkt (.). Wenn also einer der Typen BigDecimal, Float oder Double verwendet wird, könnte man z. B. die Vorlage ####0.00 benutzen oder stattdessen die Vorlage ####0 für die Typen Integer und BigInteger.

Hinweis: Ein Formular-Feld kann zum Pflichtfeld gemacht werden, indem man das Feld-Eigenschaft Minimum in der Hauptprofil-Quellstruktur auf 1 setzt. Das Formularfeld wird dann mit einem roten Sternchen angezeigt. Die Eigenschaft Maximum hat keinen Effekt.

Hinweis: Die Zielstruktur können Sie für dieses Beispiel einfach mit dem Button 1:1 erzeugen. Wir werden in diesem Beispiel die Zielstruktur und die Ausgangswege des Portal-Hauptprofils nicht benutzen.