Data Form

Die GAPTEQ-Komponente Data Form ist eine Datenformularkomponente, die einzelne Felder und Felder in Gruppen auf eine strukturierte Weise anzeigt.

In diesem Artikel lesen Sie folgende Inhalte:

Examples

Data Form Properties

Data Form Funktionalitäten

Examples

Formularfeld in Gruppen

WEK_2

Label-Varianten der Formularfelder

TD_FT_DataForm

Formularfelder mit Auswahlmöglichkeiten

TD_FT_DataForm2

Tipp! Hier sehen Sie mehr von der Komponente.

1. Data Form Properties

Properties	Beschreibung
ID	Bezeichnung / Benamung der Headline
Color scheme	Initiale Farbschemen: Normal: schwarz Default: blau Success: grün Danger: rot
Color scheme	Konfiguriert über Color Schemes
CSS class	Elemente einer Gruppe/Klasse zuordnen, für die bestimmte Formatierungen gelten sollen Option 1: in Properties bestehende Bootstrap-Klassen einfügen Option 2: über Hauptmenü in den Page Templates (für “alles verfügbar”) Option 3: Page definitions (nur für diese Seite)
Tab index	Legt die Navigation in der Page bzw. im Formular durch die Tab-Taste fest (Tab-Reihenfolge). Für jedes Formularfeld kann ein Tab-index vergeben werden.
Access	Access rights / Berechtigungen der Komponente: Insert: Daten in das Formularfeld einpflegen Update: Daten aus dem Formularfeld bearbeiten Read data: ausgegebenen Daten sehen / lesen
Data layer	Data layer der Datenbank-Tabelle, View oder einer Abfrage.
Header / Footer	Show header / Show footer: Checkbox steuert, ob der Header / Footer angezeigt wird Display: Option 1: Use Text (Text wird ohne Formatierung ausgegeben) Option 2: Use HTML (Im Text kann HTML verwendet werden) Border: Checkbox Show border steuert ob die Komponente mit Rahmen angezeigt wird. Zusätzlich kann bei Padding der Abstand in Pixel definiert werden.
Columns	Anzahl der Spalten, in denen Formularfelder innerhalb der Komponente Data form platziert werden können.
Label display	Position der Formularfelder-Labels On top of field: über dem Formularfeld On left of field: Links des Formularfeldes Static, inside field: innerhalb des Formularfeldes Floating, inside field: innerhalb des Formularfeldes als Placeholder Do not display label: kein Label Konfigurationen aller Formularfelder-Labels Align labels in all groups: Ausrichtung der Formularfelder-Labels Show colons after label: Doppelpunkte nach Label
Required mark	Show required mark for required fields: Ausgeben eines definierten Zeichens: i.d.R. "*" deklariert Label als Pflichtfeld
Optional mark	Show optional mark for optional fields: Bei aktivierter Checkbox wird nach dem Label, das im Textfeld definierte Zeichen ausgegeben. Das definierte Zeichen oder Text, wird nach dem Label angezeigt.
Validation	Show validation summary: Alle durch Validierung ausgelöste Fehler oder Pflichtfelder werden bei aktiver Checkbox unter dem Formular ausgegeben

2. Data Form Funktionalitäten

Events

Event (Form Object)	Beschreibung
valueChanged	Dieses Ereignis wird ausgelöst, wenn einer der Werte im Formular ohnehin geändert wurde.
changedByUser	Dieses Ereignis wird ausgelöst, wenn einer der Werte im Formular durch den Benutzer geändert wurde.
Label display	Dieses Ereignis wird ausgelöst, wenn die Eingabetaste in einem der Felder gedrückt wurde.

Event (Form Item Objekt)	Beschreibung
valueChanged	Dieses Ereignis wird ausgelöst, wenn der Wert ohnehin geändert wurde.
changedByUser	Dieses Ereignis wird ausgelöst, wenn der Wert durch den Benutzer geändert wurde.

Actions

Kategorisierung	Action (Form Objekt)	Beschreibung (GAPTEQ Designer)
State	enable()	Aktivieren Sie das Formular.
	disable()	Deaktivieren Sie das Formular. (Formular ist nicht bearbeitbar)
	setEnabled(enabled)	Aktivieren/Deaktivieren des Formulars. aktiviert: Flagge zur Anzeige von aktiviert oder deaktiviert.
	show()	Zeigt das Formular an.
	hide()	Blendet das Formular aus.
	setVisible(visible)	Zeigt/verbirgt das Formular. sichtbar: Flagge zum Anzeigen oder Ausblenden.
	readonly()	Machen Sie das Formular schreibgeschützt.
	writeable()	Machen Sie das Formular beschreibbar.
	setReadOnly(readOnly)	Setzt das Formular auf schreibgeschützt/schreibbar. NurLesen: Flagge, die angibt, ob das Formular schreibgeschützt oder beschreibbar ist.
	setFieldReadOnly(name, readOnly)	Ein Feld schreibgeschützt einstellen. name: Der Name des Feldes. NurLesen: Ein boolesches Flag, das angibt, ob das Feld nur gelesen oder auch geschrieben werden kann.
Appearance	setTitle(title)	Legen Sie den Titel des Formulars fest. Titel: Der zu setzende Titel.
	setTitleText(title)	Legen Sie den Titel des Formulars fest. Titel: Der zu setzende Texttitel.
	setTitleHtml(title)	Legen Sie den Titel des Formulars fest. Titel: Der zu setzende HMTL-Titel.
	setFooter(footer)	Legen Sie die Fußzeile des Formulars fest. Titel: Der zu setzende Titel der Fußzeile.
	setFooterText(footer)	Legen Sie die Fußzeile des Formulars fest. Fußzeile: Der zu setzende Fußzeilentext.
	setFooterHtml(footer)	Legen Sie die Fußzeile des Formulars fest. Fußzeile: Die zu setzende HTML-Fußzeile.
	setFieldLabel(name, label)	Legen Sie die Bezeichnung eines Feldes fest. name: Der Name des Feldes. Beschriftung: Die zu setzende Beschriftung.
Data	updateFormat()	Aktualisieren Sie das Format aller Formularfelder.
	clear()	Alle Felder löschen.
	loadRow(key)	Laden und Anzeigen einer Zeile (nur Lesen). Schlüssel: Schlüssel der zu ladenden Zeile.
	findRow(key)	Laden und Anzeigen einer Zeile (nur Lesen), wenn nicht gefunden, Anzeige einer leeren Zeile. Schlüssel: Schlüssel der zu suchenden Zeile.
	editRow(key)	Laden und Bearbeiten einer Zeile. Schlüssel: Schlüssel der zu bearbeitenden Zeile.
	newRow()	Legen Sie eine neue Zeile zur Bearbeitung an.
	editOrNewRow(key)	Laden und Bearbeiten einer Zeile, neue Zeile, wenn die Zeile nicht gefunden wurde. Schlüssel: Schlüssel der zu bearbeitenden Zeile.
	validate()	Validieren Sie alle Formularfelder.
	saveEdit()	Daten des Formulars speichern.
	cancelEdit()	Bearbeitung abbrechen.
User interaction	focus()	Legt den Fokus auf das Formular.

Kategorisierung	Action (Form Item Objekt)	Beschreibung (GAPTEQ Designer)
State	enable()	Aktivieren Sie das Feld.
	disable()	Disable the field.
	setEnabled(enabled)	Aktivieren/deaktivieren Sie das Feld. aktiviert: Flagge zur Anzeige von aktiviert oder deaktiviert.
	show()	Zeigt das Feld an.
	hide()	Blendet das Feld aus.
	setVisible(visible)	Zeigt/verbirgt das Feld. sichtbar: Flagge, die anzeigt, ob das Feld ein- oder ausgeblendet ist.
	writeable()	Machen Sie das Feld beschreibbar.
	readonly()	Machen Sie das Feld schreibgeschützt.
	setReadOnly(readOnly)	Setzen Sie das Feld schreibgeschützt. nur lesen: Ein boolesches Flag, das angibt, ob das Feld nur gelesen oder auch geschrieben werden kann.
Appearance	setLabel(text)	Legen Sie die Beschriftung des Feldes fest. text: Der zu setzende Beschriftungstext.
Data	refresh()	Aktualisieren (nur Lookup, RadioGroup)
	clearValue()	Löschen Sie den Wert.
	setValue(value)	Legen Sie einen Wert fest. Wert: Der zu setzende Wert.
User interaction	focus()	Setzt den Fokus auf das Feld.