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

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

    Firma feld
  • On left of field: Links des Formularfeldes

  • Static, inside field: innerhalb des Formularfeldes

    Lieferantfeld
  • 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

Lieferant-feld

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.