Inheritance diagram for dbxForm:

Public Member Functions
	__construct ($id='', $tpl='')
	Initialisiert Validator, TPL und DB-Service.
	__destruct ()
	Destruktor.
	clear_sys ()
	Leert nur den Sysdata-Bereich.
	clear ()
	Öffentlicher Reset-Einstieg.
	_forward_clear ()
	Setzt den internen Formularzustand zurück.
	set_editor_class_file (string $file)
	Merkt sich die geladene Modul-/Include-Class fuer den Frontend-Editor.
	set_form_callback_owner ($owner)
	set_init_callback (string $callback)
	set_submit_callback (string $callback)
	set_run_callback (string $callback)
	forward_init ($fid, $tpl='')
	Initialisiert den Form-Kontext.
	add_module_bar ($title, $icon='bi-grid', $subtitle='')
	add_module_bar_form_actions (array $options=array())
	prepare_form_shell (array $options=array())
	url_to_array ($data)
	Wandelt Query-/URL-Daten in ein Array um.
	set_msg_info ($msg)
	Setzt die Formular-Info-Meldung.
	set_msg_ok ($msg)
	Setzt die Formular-Erfolgsmeldung.
	set_msg_error ($msg)
	Setzt die Formular-Fehlermeldung.
	set_msg_warning ($msg)
	Setzt die Formular-Warnmeldung.
	get_fld_id ($fld)
	Extrahiert den Feldnamen aus HTML.
	add_norep ($content)
	Ersetzt norep-Platzhalter.
	fast_response ($response, $interpreter=0)
	Sendet eine direkte Fast-Response.
	get_tpl ($tpl, $data='', $type='htm', $i=0)
	Wrapper auf dbxTPL->get_tpl().
	obv_value ($content, $id, $value)
	Historische obv-Hilfe.
	merge_tpl_data ($tpl, $i=0)
	Führt grundlegende Form-Replaces in Templates aus.
	merge_obj ($content, $i=0)
	Ersetzt {obj:*}-Platzhalter.
	store_sysdata ()
	Speichert Sysdata des Formulars.
	load_sysdata ()
	Lädt Sysdata des Formulars.
	get_activ_id ($key='')
	Liefert die aktive Remember-ID des aktuellen DD-Kontexts.
	set_activ_id ($value, $key='')
	Setzt die aktive Remember-ID des aktuellen DD-Kontexts.
	add_rep ($key, $val)
	Fügt einen allgemeinen Replace-Wert hinzu.
	add_js_code ($javascript)
	Fügt JS-Code hinzu.
	add_js_call ($target, $function, $args='')
	Fügt einen einfachen JS-Aufruf hinzu.
	update_error_fld ($name, $msg)
	Markiert ein Feld mit Fehlerstatus.
	add_fld_error ($name, $msg='')
	Fügt einen Feldfehler hinzu.
	add_fld_warning ($name, $msg='')
	Fügt eine Feldwarnung hinzu.
	get_fld_val ($name, $default='', $rules='', $submit=-1)
	get_fld_value ($name, $default='', $rules='', $submit=-1)
	get_post_data ($name, $default='', $rules='parameter')
	Liest POST/GET-Daten mit Default-Rules parameter.
	get_post ($name, $default='', $rules='alphanum')
	Liest POST/GET-Daten mit Default-Rules alphanum.
	add_obj ($obj, $tpl, $data='', $data2='')
	Fügt ein {obj:*}-Objekt hinzu.
	add_action ($obj, $tpl, $action='', $data='')
	Fügt ein Objekt hinzu, dessen Action aus _action abgeleitet wird.
	get_dd (string $dd, string $fld, string $var)
	Liest einen Feldwert oder das ganze Feld aus einer DD-/FD-Quelle.
	add_flds ($dd='fd::')
	Fügt alle Felder der aktiven DD-/FD-Felddefinitionsquelle hinzu.
	add_fld ($name, $tpl='fd::', $label='fd::', $rules='fd::', $class='fd::', $data='fd::', $options='fd::', $tooltip='fd::', $placeholder='fd::', $errormsg='fd::', $dd='fd::', $remap='fd::')
	Fügt ein Feld zur Formular-Definition hinzu.
	check_fld_data ($submit, $fld)
	Prüft ein einzelnes Feld und baut seinen Laufzustand auf.
	check_flds_data ($submit)
	Prüft alle Felder des Formulars genau einmal pro Request-Zyklus.
	get_form_msg ($mode, $msg='')
	Gibt die Formular-Infobox zurück.
	get_fld_msg ($mode, $msg='')
	Gibt eine Feldmeldung zurück.
	get_quartal ($datum)
	Platzhalter-Helfer.
	php_date_usr ($value)
	Wandelt Datumswerte in deutsches Format um.
	php_datetime_usr ($value)
	Wandelt Datums-/Zeitwerte in deutsches Format um.
	php_date ($value)
	Wandelt Datumswerte in DB-Format um.
	add_css ($css='')
	Fügt CSS hinzu.
	forward_submit ()
	Gibt zurück, ob das Formular abgesendet wurde.
	submit ()
	Öffentliche Submit-Abfrage.
	errors ()
	Gibt die Anzahl der Fehler zurück.
	warnings ()
	Gibt die Anzahl der Warnungen zurück.
	changed ($changed=0)
	Gibt die Anzahl geänderter Felder zurück.
	get_rid ()
	Liest die aktuelle RID, optional view-synchronisiert.
	view_sync ($rid)
	Synchronisiert eine RID in den View-State.
	wait ()
	Historischer Wait-Check.
	set_post ($key, $val)
	Setzt einen _post-Wert manuell.
	save_post ($dd, $rid, $pv='', $reread=1)
	Speichert _post über dbxDB.
	next_i ($add=1)
	Liefert oder erzeugt die laufende Formularinstanz-ID.
	set_fld_val ($fld_name, $fld_val)
	Setzt einen Feldwert direkt im Feldzustand.
	create_fld ($fld, $i=0)
	Erzeugt HTML für ein Feld.
	merge_fld_data ($content, $i=0)
	Fügt Felder in den Template-Inhalt ein.
	check_try_count ($submit, $errors, $allways=1)
	Prüft Fehlversuche und baut ggf.
	forward_run ()
	Führt die Ausgabephase aus.
	init ($fid, $tpl='')
	Öffentliche Init-Methode.
	run ()
	Öffentliche Run-Methode.
	set_workflow_scope (string $scope)
	Setzt einen Workflow-Scope.
	get_workflow_scope ()
	Gibt den Workflow-Scope zurück.
	get_workflow_state_key ()
	Baut den Remember-Schlüssel für den Form-Workflow-State.
	load_workflow_state ()
	Lädt den Remember-basierten Workflow-State.
	store_workflow_state ()
	Speichert den Workflow-State.
	clear_workflow_state ()
	Löscht den Workflow-State.
	set_state_value (string $key, $value)
	Setzt einen Wert im Workflow-State.
	get_state_value (string $key, $default=null)
	Liest einen Wert aus dem Workflow-State.
	get_draft_id (bool $createIfMissing=false)
	Gibt die Draft-ID zurück, optional mit automatischer Erzeugung.
	set_draft_id (string $draftId)
	Setzt die Draft-ID explizit.
	set_form_valid (bool $state)
	Setzt den Validitätsstatus des Formulars.
	is_form_valid ()
	Gibt zurück, ob das Formular als gültig markiert ist.
	set_form_complete (bool $state)
	Setzt den Vollständigkeitsstatus des Formulars.
	is_form_complete ()
	Gibt zurück, ob das Formular als vollständig markiert ist.
	set_form_locked (bool $state)
	Setzt den Lock-Status des Formulars.
	is_form_locked ()
	Gibt zurück, ob das Formular gesperrt ist.
	set_form_saved (bool $state)
	Setzt den Save-Status des Formulars.
	is_form_saved ()
	Gibt zurück, ob das Formular bereits gespeichert wurde.
	get_form_version ()
	Gibt die aktuelle Formularversion zurück.
	bump_form_version ()
	Erhöht die Formularversion um 1.
	set_dependencies (array $formIds)
	Setzt die Abhängigkeiten dieses Formulars.
	remember_current_dependencies (?array $formIds=null)
	Speichert die aktuell gültigen Versionsstände abhängiger Formulare.
	dependencies_are_current ()
	Prüft, ob die gespeicherten Dependency-Versionen noch aktuell sind.
	get_external_form_state (string $fid)
	Liest den Workflow-State eines anderen Formulars im selben Scope.
	refresh_dependency_lock ()
	Markiert das Formular aufgrund veralteter Abhängigkeiten als gesperrt.
Public Member Functions inherited from dbxObj
	set_callback_owner ($owner)
	Setzt ein explizites Owner-Objekt fuer Callback-Aufrufe.
	set_callback_id (string $id)
	Setzt den Namenspraefix fuer konventionelle Callback-Methoden.
	set_callback (string $event, string $callback)
	Ordnet einem Event einen konkreten Methodennamen zu.
	set_property ($name, $value, $section='', $modul='modul')
	Speichert eine Objekt- oder Session-Property.
	get_property ($name, $default='', $section='', $modul='modul')
	Liest eine Objekt- oder Session-Property.
	del_property ($name, $section='', $modul='modul')
	Loescht eine Objekt- oder Session-Property.
	dbx_next_process ($content, $process='', $mode='append')
	Fuegt den naechsten dbxProcess-Schritt in eine Ausgabe ein.

Public Attributes
	$oValidator
	Zentraler Validator.
	$oTPL
	Zentrale Template-Engine.
	$oDB
	Zentraler DB-/DD-Service.
	$_dbx_view = ''
	Optionaler View-Schlüssel.
	$_view_sync = ''
	Optionaler View-Sync-Status.
	$_view_mode = ''
	Optionaler View-Modus.
	$_mode = 'mix'
	tpl\|php\|mix
	$_ajax = true
	AJAX-fähiges Formular.
	$_store_mode = 'session'
	Aktueller Sysdata-Speichermodus.
	$_dbx_modul_id = 0
	Aktive Modul-ID.
	$_dbx_modul = 'modul'
	Aktives Modul.
	$_dbx_lng = ''
	Aktive Sprache.
	$_dbx_design = ''
	Aktives Design.
	$_dbx_action = ''
	Aktive DBX-Aktion.
	$_dbx_work = ''
	Optionaler Work-Kontext.
	$_dbx_page = ''
	Aktive Seite.
	$_rid = 0
	Aktuelle Record-ID.
	$_action = ''
	Formular-Action.
	$_tpl = ''
	Template-Name.
	$_fid = ''
	Formular-ID.
	$_next_i = 0
	Laufende Formularinstanz-ID.
	$_dd = ''
	Zugeordnetes DD.
	$_fd = ''
	Optionale FD-Felddefinitionsquelle.
	$_editor_files = array()
	Dateien, die fuer den Frontend-Editor markiert werden.
	$_editor_class_file = ''
	Modul-/Include-Class-Datei fuer den Frontend-Editor.
	$_data = array()
	Aktuelle Formulardaten / Record-Daten.
	$_post = array()
	Validierte/geänderte POST-Werte.
	$_sys = array()
	Form-interne Zustände / Sysdata.
	$_obj = array()
	Platzhalter-Objekte.
	$_js = array()
	JS-Code-Blöcke.
	$_css = array()
	CSS-Dateien oder Marker.
	$_flds = array()
	Felddefinitionen.
	$_infos = array()
	Info-Meldungen.
	$_errors = array()
	Feld-/Formfehler.
	$_warnings = array()
	Warnungen.
	$_replaces = array()
	Allgemeine Replace-Werte.
	$_general_error = ''
	Allgemeiner Fehlertext.
	$_msg_info = '#form_msg_info#'
	Standard-Infotext.
	$_msg_success = '#form_msg_success#'
	Standard-Erfolgstext.
	$_msg_error = '#form_msg_error#'
	Standard-Fehlertext.
	$_msg_warning = '#form_msg_warning#'
	Standard-Warntext.
	$_tpl_form_info = 'form-alert-info'
	Template für Info-Meldungen.
	$_tpl_form_success = 'form-alert-success'
	Template für Erfolgsmeldungen.
	$_tpl_form_error = 'form-alert-danger'
	Template für Fehlermeldungen.
	$_tpl_form_warning = 'form-alert-warning'
	Template für Warnmeldungen.
	$_tpl_fld_info = 'fld-alert-info'
	Template für Feld-Info.
	$_tpl_fld_success = 'fld-alert-success'
	Template für Feld-Erfolg.
	$_tpl_fld_error = 'fld-alert-danger'
	Template für Feld-Fehler.
	$_tpl_fld_warning = 'fld-alert-warning'
	Template für Feld-Warnung.
	$_tpl_max_try = 'form-alert-maxtry'
	Template für Max-Try-Sperre.
	$_try_reset = 120
	Sekunden bis Try-Reset.
	$_try_max = 20
	Maximale Fehlversuche.
	$_try_msg = 'Max {try_count} try. Suspend for {sec} seconds'
	Sperr-Text.
	$_create_flds = 1
	1 = Felder sollen erzeugt werden
	$_reload_record = 1
	1 = Datensatz nach Save neu lesen
	$_reload_run = 0
	1 = Reload wurde ausgeführt
	$_reload_transform = 0
	Historischer Reload-Transform-Flag.
	$_reload_suffix = '_rlo'
	Historischer Reload-Suffix.
	$_fld_change_state = 'fld'
	Feldmodus fuer die Changed-Logik: fld oder *.
	$_fld_changes = -1
	Gecachter Changed-Wert.
	$_form_submit = -1
	-1 = unbekannt, 0 = nein, 1 = ja
	$_form_validate = -1
	-1 = noch nicht ausgewertet, 1 = ausgewertet
	$_editor_fld = ''
	Optionales Editor-Feld.
	$_page_reset = 1
	Historischer Page-Reset-Flag.
	$_confirm_delete = ''
	Optionaler Lösch-Bestätigungstext.
	$_confirm_copy = ''
	Optionaler Copy-Bestätigungstext.
	$_activ_id = 0
	Optional aktive ID.
	$_fld_id = 'id'
	Primärschlüsselfeld.
	$_workflow_scope = ''
	Workflow-Scope für Remember-State.
	$_workflow_state = array()
	Remember-basierter Form-Status.
Public Attributes inherited from dbxObj
Public	$_properties =array()
Public	$_section =''
Public	$_process =''

Protected Member Functions
	add_editor_file (string $kind, string $file)
	Registriert eine genutzte FD-/DD-/Class-Datei fuer Editor-Marker.
	add_editor_markers (string $content)
	Fuegt passende Editor-Marker um den gerenderten Formularinhalt.
	defaultModuleBarReplaces ()
	prepareFormFrameReplaces (int $i)
	applyModuleBarReplaces (array $values=array())
	buildModuleBarFormActionsHtml ()
	buildModuleBarObj ()
	attachAdminHelpButton ($topic='')
	add_default_search_rep (array $overrides=array())
	Standard-Suchfeld fuer Grid-Toolbars ({dbx_search}).
	resolve_fd_dd_editor_file (string $source)
	Liefert den absoluten Pfad einer FD-/DD-Quelle fuer Editor-Marker.
	get_field_editor_markers ()
	Erzeugt FD-/DD-Editor-Marker direkt am Feld-Slot.
Protected Member Functions inherited from dbxObj
	normalize_callback_id (string $id)
	Normalisiert Callback-IDs auf gueltige PHP-Methodenbestandteile.
	get_callback_name (string $event)
	Liefert den Methodennamen fuer ein Event.
	get_callback_owner ()
	Liefert das aktuelle Owner-Objekt fuer Callback-Aufrufe.
	callback (string $event, mixed $value)
	Fuehrt einen Callback aus und gibt dessen Rueckgabewert zurueck.

Protected Attributes
	$_module_bar_form_actions = array()
	Optionen fuer Standard-Aktionen in der Modul-Bar.
Protected Attributes inherited from dbxObj
	$_callback_owner = null
	$_callback_id = ''
	$_callbacks = array()

Detailed Description

DBX FORM SYSTEM (dbxForm)

Zweck

Die Klasse dbxForm ist die zentrale serverseitige Formular-Basis für DBX-Module.

Sie ist bewusst als offenes, zustandsbehaftetes Workflow-Objekt gedacht und NICHT als starres Blackbox-Form-Framework.

Typische Aufgaben

Formular-Kontext initialisieren
DD-/FD-basierte Felddefinitionen ergänzen
Request/Submit erkennen
Feldwerte lesen und validieren
geänderte Werte in _post sammeln
Formularstatus/Meldungen verwalten
optional über dbxDB speichern
HTML-Ausgabe über dbxTPL erzeugen

Architektur

Die Klasse orientiert sich an 5 klaren Phasen:

Setup
- init()
- _dd / _fd / _data / _action / Meldungen setzen
- add_fld(), add_flds(), add_obj(), JS vorbereiten
Request auswerten
Modul-Fachlogik
- Modul kann nach Standardprüfung _post ergänzen/ändern
- Speziallogik wie Hashing, Mapping, Folgeaktionen
Persistenz
- save_post()
Ausgabe
- run()
- Template, Felder, Meldungen, Objekte, JS

Wichtige Grundsätze

DD-Infrastruktur liegt zentral in dbxDB
dbxForm nutzt dbxDB als DD-/Persistenzservice
FD ist eine optionale, bevorzugte Felddefinitionsquelle
Wenn _fd gesetzt ist, nutzt dbxForm _fd für Feld-Metadaten
Wenn _fd leer ist und _dd gesetzt ist, nutzt dbxForm _dd wie bisher
Wenn weder _fd noch _dd gesetzt ist, entstehen Felder nur aus manuellen add_fld()-Parametern
Automatisch erzeugte Felder und manuelle add_fld()-Felder sind frei mischbar
dbxForm bleibt offen für Modulcode
Rendern darf den Kernzustand nicht zerstören
Workflow-/Form-Zustände werden über DBX-State (dbx_set_Remember / dbx_get_Remember) gehalten

FD-/DD-Felddefinitionen

DD und FD liefern in dbxForm dieselbe Art Feld-Metadaten:

tpl
label
rules
class
data
options
tooltip
placeholder
errormsg
remap

_dd bleibt der Daten-/DB-Kontext und ist weiterhin der Fallback für Felddefinitionen. _fd ist eine zusätzliche, generische und bevorzugte Felddefinitionsquelle für beliebige Formular-/UI-Feldgruppen, z. B. Login, Filter, Report-Selektionen, Umfragen oder Wizard-Schritte.

Workflow-/Draft-Gedanke

dbxForm unterstützt neben rid auch einen Draft-/Form-Kontext. Das ist wichtig für Fälle wie:

neuer Datensatz ohne echte DB-ID, aber mit Uploads
mehrere abhängige Formulare innerhalb eines Workflows

Dafür gibt es einen Remember-basierten Formularstatus mit Feldern wie:

draft_id
rid
is_valid
is_complete
is_locked
is_saved
version
depends_on
depends_version

Beispiel: einfache Nutzung mit DD

$oForm = dbx()->get_system_obj('dbxForm');
$oDB   = dbx()->get_system_obj('dbxDB');
 
$rid   = dbx()->get_modul_var('rid', 0, 'int');
$data  = $oDB->select1('dbx_user', $rid);
 
$oForm->init('form-user');
$oForm->_dd       = 'dbx_user';
$oForm->_data     = $data;
$oForm->_action   = '?dbx_modul=dbxUser&dbx_run1=edit&rid=' . $rid;
$oForm->_msg_info = 'Bitte prüfen Sie die Daten.';
 
$oForm->add_fld('name',  'text-label');
$oForm->add_fld('email', 'text-label');
 
if ($oForm->submit()) {
    if (!$oForm->errors() && !$oForm->warnings()) {
        if ($oForm->changed()) {
            $oForm->save_post('dbx_user', $rid);
            $oForm->_msg_success = 'Daten gespeichert';
        } else {
            $oForm->_msg_success = 'Keine Änderung';
        }
    } else {
        $oForm->_msg_error = 'Bitte Eingaben prüfen';
    }
}
 
echo $oForm->run();

Beispiel: automatische Felder aus FD

$oForm->init('form-login');
$oForm->_fd = 'dbx|login';
$oForm->add_flds();
$oForm->add_fld('remember_me', 'checkbox-label', label: 'Angemeldet bleiben', rules: 'int');
echo $oForm->run();

Beispiel: neuer Datensatz mit Draft-Kontext

$oForm->init('form-profile');
$draftId = $oForm->get_draft_id(true); // erzeugt Draft-ID, falls noch keine da ist
 
// Uploads können jetzt auf $draftId referenzieren,
// auch wenn noch keine echte RID existiert.

Beispiel: abhängige Formulare

$oForm1->set_workflow_scope('order-setup');
$oForm2->set_workflow_scope('order-setup');
 
// Form 2 hängt von Form 1 ab
$oForm2->set_dependencies(['form-step-1']);
 
// Nach gültigem Abschluss von Form 1:
$oForm1->set_form_valid(true);
$oForm1->set_form_complete(true);
$oForm1->bump_form_version();
 
// Form 2 kann prüfen, ob seine Grundlage noch aktuell ist:
if (!$oForm2->dependencies_are_current()) {
    $oForm2->set_form_locked(true);
}

Definition at line 179 of file dbxForm.class.php.

Constructor & Destructor Documentation

◆ __construct()

dbxForm::__construct	(		$id = '',
			$tpl = '' )

Initialisiert Validator, TPL und DB-Service.

Verwendung

Normalerweise wird dbxForm über dbx()->get_system_obj('dbxForm') bezogen. Optional kann direkt eine Formular-ID übergeben werden.

Auswirkung

Die zentralen Services werden referenziert. Wird $id übergeben, wird sofort init($id, $tpl) ausgeführt.

Parameters

string	$id	Optional Formular-ID für Sofort-Init
string	$tpl	Optional Template-Name

Returns: void

Definition at line 412 of file dbxForm.class.php.

References init().

◆ __destruct()

dbxForm::__destruct ( )

Destruktor.

Verwendung

Aktuell gibt es keine explizite Aufräumlogik.

Auswirkung

Keine.

Returns: void

Definition at line 439 of file dbxForm.class.php.

Member Function Documentation

◆ _forward_clear()

dbxForm::_forward_clear ( )

Setzt den internen Formularzustand zurück.

Sinn/Zweck

Dieser Reset betrifft den Formlauf selbst. Remember-basierte Workflow- Zustände werden NICHT automatisch gelöscht, da sie fachlich über den aktuellen Request hinaus gültig sein können.

Auswirkung

Leert Objekte, JS, CSS, Felder, Meldungen, Fehler, Warnungen, _post, _sys, _data und _replaces.

Wichtig

_dd und _fd werden ebenfalls geleert, weil dbxForm als zentrales Systemobjekt wiederverwendet werden kann. Dadurch können keine alten DD-/FD-Quellen in einen neuen Formularlauf durchrutschen.

Zusätzlich werden laufbezogene Einzelwerte wie _rid, _action, _next_i und _fld_id zurückgesetzt, damit keine alte Formularinstanz, kein alter Datensatz und kein alter Primärschlüssel in den nächsten Formularlauf übernommen werden.

Konsequenz

Module setzen _dd und/oder _fd nach init() neu.

Returns: void

Definition at line 519 of file dbxForm.class.php.

Referenced by clear(), and dbxReport\clear().

◆ add_action()

dbxForm::add_action	(	$obj,
		$tpl,
		$action = '',
		$data = '' )

Fügt ein Objekt hinzu, dessen Action aus _action abgeleitet wird.

Verwendung

Praktisch für Buttons/Links, die an die aktuelle Formular-Action andocken sollen.

Parameters

string	$obj	Platzhalter-ID
string	$tpl	Template
string	$action	Action oder &...-Suffix
mixed	$data	Zusätzliche Daten

Returns: void

Reimplemented in dbxReport.

Definition at line 1766 of file dbxForm.class.php.

References get_tpl().

◆ add_css()

dbxForm::add_css ( $css = '' )

Fügt CSS hinzu.

Parameters

string $css CSS-Referenz

Returns: void

Definition at line 3026 of file dbxForm.class.php.

◆ add_default_search_rep()

dbxForm::add_default_search_rep ( array $overrides = array() )

protected

Standard-Suchfeld fuer Grid-Toolbars ({dbx_search}).

Parameters

array $overrides Optionen fuer dbx()->search_html()

Returns: void

Definition at line 3343 of file dbxForm.class.php.

References add_rep().

Referenced by forward_init().

◆ add_editor_file()

dbxForm::add_editor_file	(	string	$kind,
		string	$file )

protected

Registriert eine genutzte FD-/DD-/Class-Datei fuer Editor-Marker.

Parameters

string	$kind	Marker-Typ: fd, dd oder class
string	$file	Absoluter oder relativer Dateipfad

Returns: void

Definition at line 572 of file dbxForm.class.php.

Referenced by dbxReport\run(), and set_editor_class_file().

◆ add_editor_markers()

dbxForm::add_editor_markers ( string $content )

protected

Fuegt passende Editor-Marker um den gerenderten Formularinhalt.

Parameters

string $content Formularinhalt

Returns: string Inhalt mit Editor-Marker-Kommentaren

Definition at line 592 of file dbxForm.class.php.

Referenced by forward_run(), and dbxReport\run().

◆ add_fld()

dbxForm::add_fld	(	$name,
		$tpl = 'fd::',
		$label = 'fd::',
		$rules = 'fd::',
		$class = 'fd::',
		$data = 'fd::',
		$options = 'fd::',
		$tooltip = 'fd::',
		$placeholder = 'fd::',
		$errormsg = 'fd::',
		$dd = 'fd::',
		$remap = 'fd::' )

Fügt ein Feld zur Formular-Definition hinzu.

Zweck

Diese Methode ist der zentrale Feld-Builder von dbxForm. Sie kombiniert:

direkte Feldparameter
FD-/DD-basierte Defaults
aufbereitete Daten/Optionen

Marker-Regel

fd:: bedeutet: aktive Feldquelle verwenden, also _fd wenn gesetzt, sonst _dd
dd:: bedeutet: gezielt _dd verwenden
jeder andere Wert ist ein expliziter Wert

Beispiel

$oForm->_dd = 'dbx_user';
$oForm->_fd = 'dbx_user_login';
 
// alles aus FD, sofern vorhanden
$oForm->add_fld('email');
 
// Feld überwiegend aus FD, aber Label bewusst aus DD
$oForm->add_fld('email', label: 'dd::');
 
// Template manuell, Label aus DD, Rest aus FD
$oForm->add_fld('email', tpl: 'text-label', label: 'dd::');

Auswirkung

Es wird genau ein Eintrag in _flds[$name] erzeugt oder überschrieben. Die spätere Request-Auswertung, Validierung und Ausgabe laufen unverändert über die bestehende dbxForm-Pipeline.

Parameters

string	$name	Feldname
string	$tpl	Template, fd:: oder dd::
mixed	$label	Label, fd:: oder dd::
mixed	$rules	Regeln, fd:: oder dd::
mixed	$class	CSS-Klasse, fd:: oder dd::
mixed	$data	Daten, fd:: oder dd::
mixed	$options	Optionen, fd:: oder dd::
mixed	$tooltip	Tooltip, fd:: oder dd::
mixed	$placeholder	Placeholder, fd:: oder dd::
mixed	$errormsg	Feldfehlertext, fd:: oder dd::
mixed	$dd	DD-/FD-Quelle, fd:: oder dd::
mixed	$remap	Optionaler Feld-Remap, fd:: oder dd::

Returns: void

Definition at line 2507 of file dbxForm.class.php.

References get_dd().

Referenced by add_flds(), forward_init(), and dbxReport\run().

◆ add_fld_error()

dbxForm::add_fld_error	(		$name,
			$msg = '' )

Fügt einen Feldfehler hinzu.

Auswirkung

Der Fehler wird in _errors gespeichert und der Feldzustand wird über update_error_fld() angepasst.

Parameters

string	$name	Feldname
string	$msg	Meldung

Returns: void

Definition at line 1502 of file dbxForm.class.php.

References update_error_fld().

Referenced by check_fld_data(), get_fld_val(), get_post(), and get_post_data().

◆ add_fld_warning()

dbxForm::add_fld_warning	(		$name,
			$msg = '' )

Fügt eine Feldwarnung hinzu.

Parameters

string	$name	Feldname
string	$msg	Meldung

Returns: void

Definition at line 1516 of file dbxForm.class.php.

◆ add_flds()

dbxForm::add_flds ( $dd = 'fd::' )

Fügt alle Felder der aktiven DD-/FD-Felddefinitionsquelle hinzu.

Verwendung

Diese Methode ist nur ein Auto-Wrapper über add_fld(). Sie erzeugt keine eigene Feld-Engine, validiert nicht selbst und rendert nicht selbst.

Hybrid-Regel

explizite Quelle gewinnt
fd:: nutzt _fd, falls gesetzt, sonst _dd
dd:: nutzt gezielt _dd
wenn keine Quelle vorhanden ist, passiert nichts

Beispiel

$oForm->_fd = 'dbx|login';
$oForm->add_flds();
$oForm->add_fld('remember_me', 'checkbox-label', label: 'Angemeldet bleiben', rules: 'int');

Auswirkung

Für jeden Eintrag mit name in der Feldquelle wird add_fld($name, dd: $source) aufgerufen. Manuell nachträglich hinzugefügte Felder bleiben möglich und können bestehende Namen bewusst überschreiben.

Parameters

mixed $dd Explizite DD-/FD-Quelle, fd:: oder dd::

Returns: int Anzahl angelegter Felder

Definition at line 2420 of file dbxForm.class.php.

References $count, $fields, and add_fld().

Referenced by dbxReport\create_selection_fields().

◆ add_js_call()

dbxForm::add_js_call	(	$target,
		$function,
		$args = '' )

Fügt einen einfachen JS-Aufruf hinzu.

Zweck

Einfache Übergangshilfe für modulare JS-Aufrufe. Komplexe UI-/Observe- Logik sollte heute eher in core.js / Libs liegen.

Beispiel

$oForm->add_js_call('roles', 'multiselect2');

Parameters

string	$target	Zielkennung
string	$function	Funktionsname
string	$args	Optionaler JS-Argumentstring

Returns: void

Definition at line 1446 of file dbxForm.class.php.

◆ add_js_code()

dbxForm::add_js_code ( $javascript )

Fügt JS-Code hinzu.

Verwendung

Modulcode kann damit kleine JS-Blöcke an den Formularlauf anhängen.

Auswirkung

Der Code wird später in forward_run() über [dbx:js] und norep in den Output eingebunden.

Parameters

string $javascript JS-Code

Returns: void

Definition at line 1420 of file dbxForm.class.php.

◆ add_module_bar()

dbxForm::add_module_bar	(	$title,
		$icon = 'bi-grid',
		$subtitle = '' )

Definition at line 733 of file dbxForm.class.php.

References add_rep().

Referenced by attachAdminHelpButton().

◆ add_module_bar_form_actions()

dbxForm::add_module_bar_form_actions ( array $options = array() )

Definition at line 745 of file dbxForm.class.php.

◆ add_norep()

dbxForm::add_norep ( $content )

Ersetzt norep-Platzhalter.

Zweck

Bestehende norep-Mechanik bleibt als Integrationsfunktion erhalten, ist aber nicht mehr der Kern des Form-Designs.

Auswirkung

Sucht [id]-Platzhalter im übergebenen Inhalt und ersetzt sie mit den in $_SESSION['dbx']['norep'] gespeicherten Inhalten.

Parameters

string $content Inhalt mit [id]-Platzhaltern

Returns: string

Definition at line 1123 of file dbxForm.class.php.

References $oTPL.

Referenced by fast_response().

◆ add_obj()

dbxForm::add_obj	(	$obj,
		$tpl,
		$data = '',
		$data2 = '' )

Fügt ein {obj:*}-Objekt hinzu.

Verwendung

Für Inhalte, die nicht über die Feldpipeline laufen, aber als {obj:name} im Template erscheinen sollen.

Auswirkung

Rendert bei Template-Angaben sofort das Objekt und speichert es in _obj.

Parameters

string	$obj	Platzhalter-ID
string	$tpl	Template oder obj-value/obv-value
mixed	$data	Daten
mixed	$data2	Zusätzliche Replaces

Returns: void

Definition at line 1730 of file dbxForm.class.php.

References get_tpl().

Referenced by attachAdminHelpButton(), and dbxReport\buildReportFooterObj().

◆ add_rep()

dbxForm::add_rep	(		$key,
			$val )

Fügt einen allgemeinen Replace-Wert hinzu.

Verwendung

Replaces werden beim Laden/Rendern von Templates und Objekten eingesetzt.

Parameters

string	$key	Schlüssel
mixed	$val	Wert

Returns: void

Definition at line 1400 of file dbxForm.class.php.

Referenced by add_default_search_rep(), dbxReport\add_grid_stats(), add_module_bar(), applyModuleBarReplaces(), next_i(), and prepare_form_shell().

◆ applyModuleBarReplaces()

dbxForm::applyModuleBarReplaces ( array $values = array() )

protected

Definition at line 821 of file dbxForm.class.php.

References add_rep(), and defaultModuleBarReplaces().

Referenced by buildModuleBarObj().

◆ attachAdminHelpButton()

dbxForm::attachAdminHelpButton ( $topic = '' )

protected

Definition at line 941 of file dbxForm.class.php.

References add_module_bar(), and add_obj().

Referenced by forward_init().

◆ buildModuleBarFormActionsHtml()

dbxForm::buildModuleBarFormActionsHtml ( )

protected

Definition at line 829 of file dbxForm.class.php.

References get_tpl(), and next_i().

Referenced by buildModuleBarObj().

◆ buildModuleBarObj()

dbxForm::buildModuleBarObj ( )

protected

Definition at line 871 of file dbxForm.class.php.

References applyModuleBarReplaces(), and buildModuleBarFormActionsHtml().

Referenced by forward_run(), and dbxReport\run().

◆ bump_form_version()

dbxForm::bump_form_version ( )

Erhöht die Formularversion um 1.

Zweck

Nützlich für abhängige Formulare: Änderungen an Form A können dadurch Form B/C als veraltet erkennen lassen.

Returns: int Neue Version

Definition at line 4210 of file dbxForm.class.php.

References get_form_version(), and set_state_value().

Referenced by save_post().

◆ changed()

dbxForm::changed ( $changed = 0 )

Gibt die Anzahl geänderter Felder zurück.

Parameters

int $changed Initialwert

Returns: int

Definition at line 3094 of file dbxForm.class.php.

◆ check_fld_data()

dbxForm::check_fld_data	(		$submit,
			$fld )

Prüft ein einzelnes Feld und baut seinen Laufzustand auf.

Auswirkungen

setzt value, origin, error, changed, verify
schreibt geänderte und valide Werte nach _post

Parameters

int	$submit	0\|1
array	$fld	Felddefinition

Returns: array

Definition at line 2701 of file dbxForm.class.php.

References add_fld_error().

Referenced by check_flds_data(), and create_fld().

◆ check_flds_data()

dbxForm::check_flds_data ( $submit )

Prüft alle Felder des Formulars genau einmal pro Request-Zyklus.

Auswirkung

Setzt _post, _errors, _warnings neu und aktualisiert alle Feld- Zustände in _flds.

Parameters

int $submit 0|1

Returns: void

Definition at line 2788 of file dbxForm.class.php.

References check_fld_data().

◆ check_try_count()

dbxForm::check_try_count	(	$submit,
		$errors,
		$allways = 1 )

Prüft Fehlversuche und baut ggf.

Sperrinhalt.

Parameters

bool	$submit	Submit-Status
bool	$errors	Fehlerstatus
bool	$allways	Immer prüfen

Returns: string

Definition at line 3585 of file dbxForm.class.php.

References $_SERVER, and get_tpl().

Referenced by forward_run().

◆ clear()

dbxForm::clear ( )

Öffentlicher Reset-Einstieg.

Verwendung

Wird von forward_init() genutzt und kann auch manuell aufgerufen werden, wenn ein Formularlauf neu aufgebaut werden soll.

Auswirkung

Ruft _forward_clear() auf und löscht den laufenden Formzustand inklusive _dd und _fd, damit bei wiederverwendeten Systemobjekten keine alte DD-/FD-Feldquelle in den nächsten Formularlauf durchrutscht.

Workflow-Hinweis

Der Workflow-Scope wird hier bewusst nicht zurückgesetzt, weil er sich innerhalb zusammenhängender Formularabläufe fachlich weitervererben darf.

Returns: void

Reimplemented in dbxReport, and dbxReport.

Definition at line 482 of file dbxForm.class.php.

References _forward_clear().

Referenced by forward_init().

◆ clear_sys()

dbxForm::clear_sys ( )

Leert nur den Sysdata-Bereich.

Zweck

Nützlich, wenn bewusst nur temporäre Form-Zustände zurückgesetzt werden sollen, ohne das ganze Formularobjekt neu aufzubauen.

Auswirkung

_sys wird geleert. _data, _flds, Workflow-State und andere Laufzustände bleiben unverändert.

Returns: void

Definition at line 457 of file dbxForm.class.php.

◆ clear_workflow_state()

dbxForm::clear_workflow_state ( )

Löscht den Workflow-State.

Returns: void

Definition at line 4033 of file dbxForm.class.php.

References store_workflow_state().

◆ create_fld()

dbxForm::create_fld	(		$fld,
			$i = 0 )

Erzeugt HTML für ein Feld.

Wichtig

Diese Methode ist primär Render-Logik. Sie arbeitet idealerweise mit bereits vorbereitetem Feldzustand. Falls ein Feld noch nicht geprüft wurde, wird es defensiv lokal vorbereitet, ohne den globalen Feldbestand zu zerstören.

Parameters

array	$fld	Felddefinition
int	$i	Laufindex

Returns: string

Definition at line 3397 of file dbxForm.class.php.

References check_fld_data(), get_field_editor_markers(), get_tpl(), and submit().

Referenced by merge_fld_data().

◆ defaultModuleBarReplaces()

dbxForm::defaultModuleBarReplaces ( )

protected

Definition at line 770 of file dbxForm.class.php.

Referenced by applyModuleBarReplaces().

◆ dependencies_are_current()

dbxForm::dependencies_are_current ( )

Prüft, ob die gespeicherten Dependency-Versionen noch aktuell sind.

Wirkung

Wenn ein abhängiges Vorformular inzwischen eine andere Version hat, wird false geliefert. Das ist der saubere Ersatz für starre Prozessstep-Logik.

Returns: bool

Definition at line 4276 of file dbxForm.class.php.

References get_state_value().

Referenced by refresh_dependency_lock().

◆ errors()

dbxForm::errors ( )

Gibt die Anzahl der Fehler zurück.

Returns: int

Definition at line 3067 of file dbxForm.class.php.

Referenced by dbxReport\buildReportFormMsgHtml(), forward_run(), and dbxReport\run().

◆ fast_response()

dbxForm::fast_response	(		$response,
			$interpreter = 0 )

Sendet eine direkte Fast-Response.

Zweck

Für Spezialfälle, in denen eine direkte Antwort ohne normalen Render- Endlauf ausgegeben werden soll.

Auswirkung

Speichert die Session, gibt den Response aus und beendet den Request. Optional wird vorher der dbxInterpreter angewendet.

Parameters

string	$response	Antwortinhalt
int	$interpreter	1 = dbxInterpreter vorher anwenden

Returns: void

Definition at line 1161 of file dbxForm.class.php.

References $response, add_norep(), and exit.

Referenced by dbxReport\init().

◆ forward_init()

dbxForm::forward_init	(		$fid,
			$tpl = '' )

Initialisiert den Form-Kontext.

Ablauf

internen Formzustand resetten
DBX-Kontext übernehmen
Sysdata laden
Remember-Workflow-State laden
Security-Feld für Submit-Schutz anlegen

Verwendung

Nach init() kann der Modulcode _dd, _fd, _data, _action, Meldungen und Felder setzen und das Formular weiter aufbauen.

Auswirkung

Der Formularlauf ist vorbereitet. Das Security-Feld wird als echtes dbxForm-Feld erzeugt und später durch die normale Feldpipeline gerendert. Das Security-Feld nutzt bewusst keine DD-/FD-Quelle, damit es nie durch externe Felddefinitionen beeinflusst wird.

Parameters

string	$fid	Formular-ID
string	$tpl	Optionales Template

Returns: void

Definition at line 684 of file dbxForm.class.php.

References add_default_search_rep(), add_fld(), attachAdminHelpButton(), dbxObj\callback(), clear(), load_sysdata(), load_workflow_state(), next_i(), and dbxObj\set_callback_id().

Referenced by init(), and dbxReport\init().

◆ forward_run()

dbxForm::forward_run ( )

Führt die Ausgabephase aus.

Ablauf

Request-Zustand sicherstellen
Try-Sperre prüfen
Template laden
TPL-Replaces ausführen
Felder einfügen
Objekte einfügen
Form-Meldung setzen
JS-Platzhalter füllen
Sysdata und Workflow-State speichern

Returns: string

Definition at line 3683 of file dbxForm.class.php.

References add_editor_markers(), buildModuleBarObj(), dbxObj\callback(), check_try_count(), errors(), get_form_msg(), get_tpl(), merge_fld_data(), merge_obj(), merge_tpl_data(), next_i(), prepareFormFrameReplaces(), store_sysdata(), store_workflow_state(), submit(), and warnings().

Referenced by run().

◆ forward_submit()

dbxForm::forward_submit ( )

Gibt zurück, ob das Formular abgesendet wurde.

Wirkung

Diese Methode triggert die zentrale Request-Auswertung, ist aber nach außen weiterhin bequem als Statusabfrage nutzbar.

Returns: int 0|1

Definition at line 3042 of file dbxForm.class.php.

References $result, and dbxObj\callback().

Referenced by submit(), and dbxReport\submit().

◆ get_activ_id()

dbxForm::get_activ_id ( $key = '' )

Liefert die aktive Remember-ID des aktuellen DD-Kontexts.

Verwendung

Wird für aktive Zeilen-/Datensatz-Markierungen verwendet.

Auswirkung

Liest die aktive ID aus Remember. Ohne expliziten Schlüssel wird _dd als Kontext verwendet.

Parameters

string $key Optionaler Kontextschlüssel

Returns: mixed

Definition at line 1362 of file dbxForm.class.php.

Referenced by dbxReport\get_class_tr().

◆ get_dd()

dbxForm::get_dd	(	string	$dd,
		string	$fld,
		string	$var )

Liest einen Feldwert oder das ganze Feld aus einer DD-/FD-Quelle.

Wirkung

Standard-DDs laufen über dbxDB
direkte DD-/FD-Dateiquellen bleiben möglich
leeres Ergebnis liefert ''
* liefert den kompletten Feldsatz

Performance

Die komplette Feldquelle wird über get_dd_fields_source() geladen. Zusätzlich wird der einzelne Feld-Record pro Quelle/Feldname im aktuellen PHP-Request gecacht. Dadurch muss add_fld() nicht für jedes Attribut erneut linear durch alle Felddefinitionen laufen.

Parameters

string	$dd	DD-/FD-Angabe
string	$fld	Feldname
string	$var	Variablenname oder *

Returns: mixed

Definition at line 2169 of file dbxForm.class.php.

References $field, and $fields.

Referenced by add_fld(), dbxReport\create_selection_fields(), and dbxReport\get_auto_report_format().

◆ get_draft_id()

dbxForm::get_draft_id ( bool $createIfMissing = false )

Gibt die Draft-ID zurück, optional mit automatischer Erzeugung.

Beispiel

$draftId = $oForm->get_draft_id(true);

Parameters

bool $createIfMissing 1 = erzeugen falls leer

Returns: string

Definition at line 4080 of file dbxForm.class.php.

References get_state_value(), and set_state_value().

◆ get_external_form_state()

dbxForm::get_external_form_state ( string $fid )

Liest den Workflow-State eines anderen Formulars im selben Scope.

Parameters

string $fid Formular-ID

Returns: array

Definition at line 4308 of file dbxForm.class.php.

Referenced by remember_current_dependencies().

◆ get_field_editor_markers()

dbxForm::get_field_editor_markers ( )

protected

Erzeugt FD-/DD-Editor-Marker direkt am Feld-Slot.

Returns: string

Definition at line 3860 of file dbxForm.class.php.

References resolve_fd_dd_editor_file().

Referenced by create_fld().

◆ get_fld_id()

dbxForm::get_fld_id ( $fld )

Extrahiert den Feldnamen aus HTML.

Verwendung

Legacy-Hilfe für Fälle, in denen ein bereits gerendertes HTML-Feld untersucht werden muss.

Parameters

string $fld HTML-Feld

Returns: string

Definition at line 1102 of file dbxForm.class.php.

◆ get_fld_msg()

dbxForm::get_fld_msg	(		$mode,
			$msg = '' )

Gibt eine Feldmeldung zurück.

Parameters

string	$mode	info\|success\|error\|warning
string	$msg	Meldung

Returns: string

Definition at line 2906 of file dbxForm.class.php.

References get_tpl().

◆ get_fld_val()

dbxForm::get_fld_val	(	$name,
		$default = '',
		$rules = '',
		$submit = -1 )

Definition at line 1584 of file dbxForm.class.php.

References add_fld_error().

Referenced by get_fld_value().

◆ get_fld_value()

dbxForm::get_fld_value	(	$name,
		$default = '',
		$rules = '',
		$submit = -1 )

Definition at line 1603 of file dbxForm.class.php.

References get_fld_val().

◆ get_form_msg()

dbxForm::get_form_msg	(		$mode,
			$msg = '' )

Gibt die Formular-Infobox zurück.

Parameters

string	$mode	info\|success\|error\|warning
string	$msg	Meldung

Returns: string

Definition at line 2866 of file dbxForm.class.php.

References get_tpl().

Referenced by dbxReport\buildReportFormMsgHtml(), forward_run(), and dbxReport\run().

◆ get_form_version()

dbxForm::get_form_version ( )

Gibt die aktuelle Formularversion zurück.

Returns: int

Definition at line 4196 of file dbxForm.class.php.

References get_state_value().

Referenced by bump_form_version().

◆ get_post()

dbxForm::get_post	(	$name,
		$default = '',
		$rules = 'alphanum' )

Liest POST/GET-Daten mit Default-Rules alphanum.

Parameters

string	$name	Feldname
mixed	$default	Default
string	$rules	Regeln

Returns: mixed

Definition at line 1640 of file dbxForm.class.php.

References add_fld_error().

Referenced by dbxReport\get_sel(), and dbxReport\init().

◆ get_post_data()

dbxForm::get_post_data	(	$name,
		$default = '',
		$rules = 'parameter' )

Liest POST/GET-Daten mit Default-Rules parameter.

Parameters

string	$name	Feldname
mixed	$default	Default
string	$rules	Regeln

Returns: mixed

Definition at line 1616 of file dbxForm.class.php.

References add_fld_error().

◆ get_quartal()

dbxForm::get_quartal ( $datum )

Platzhalter-Helfer.

Parameters

mixed $datum Eingabe

Returns: string

Definition at line 2941 of file dbxForm.class.php.

◆ get_rid()

dbxForm::get_rid ( )

Liest die aktuelle RID, optional view-synchronisiert.

Returns: int

Definition at line 3120 of file dbxForm.class.php.

References set_state_value().

◆ get_state_value()

dbxForm::get_state_value	(	string	$key,
			$default = null )

Liest einen Wert aus dem Workflow-State.

Parameters

string	$key	Schlüssel
mixed	$default	Default

Returns: mixed

Definition at line 4059 of file dbxForm.class.php.

References load_workflow_state().

Referenced by dependencies_are_current(), get_draft_id(), get_form_version(), is_form_complete(), is_form_locked(), is_form_saved(), is_form_valid(), and remember_current_dependencies().

◆ get_tpl()

dbxForm::get_tpl	(	$tpl,
		$data = '',
		$type = 'htm',
		$i = 0 )

Wrapper auf dbxTPL->get_tpl().

Verwendung

Zentrale Kurzform, damit dbxForm und abgeleitete Klassen Templates über die DBX-Template-Engine laden können.

Parameters

string	$tpl	Template
mixed	$data	Replaces
string	$type	Typ
int	$i	Laufindex

Returns: string

Definition at line 1187 of file dbxForm.class.php.

Referenced by add_action(), add_obj(), buildModuleBarFormActionsHtml(), dbxReport\buildReportFooterObj(), check_try_count(), create_fld(), forward_run(), dbxReport\get_delete_tab_button(), get_fld_msg(), get_form_msg(), dbxReport\render_simple_table_tpl(), dbxReport\render_table_header_action_block(), dbxReport\render_table_header_data_columns(), dbxReport\render_table_header_select(), dbxReport\render_table_row_action_block(), dbxReport\render_table_row_data_columns(), dbxReport\render_table_row_select(), dbxReport\run(), dbxReport\run(), and dbx\dbxAdmin\dbxReport_Tables\run_body().

◆ get_workflow_scope()

dbxForm::get_workflow_scope ( )

Gibt den Workflow-Scope zurück.

Returns: string

Definition at line 3933 of file dbxForm.class.php.

◆ get_workflow_state_key()

dbxForm::get_workflow_state_key ( )

Baut den Remember-Schlüssel für den Form-Workflow-State.

Schlüsselaufbau

Modul
optionaler Workflow-Scope
Formular-ID

Auswirkungen

Mehrere Formulare oder Workflows bleiben sauber getrennt.

Returns: string

Definition at line 3969 of file dbxForm.class.php.

Referenced by load_workflow_state(), and store_workflow_state().

◆ init()

dbxForm::init	(		$fid,
			$tpl = '' )

Öffentliche Init-Methode.

Parameters

string	$fid	Formular-ID
string	$tpl	Optionales Template

Returns: void

Definition at line 3888 of file dbxForm.class.php.

References forward_init().

Referenced by __construct().

◆ is_form_complete()

dbxForm::is_form_complete ( )

Gibt zurück, ob das Formular als vollständig markiert ist.

Returns: bool

Definition at line 4147 of file dbxForm.class.php.

References get_state_value().

◆ is_form_locked()

dbxForm::is_form_locked ( )

Gibt zurück, ob das Formular gesperrt ist.

Returns: bool

Definition at line 4167 of file dbxForm.class.php.

References get_state_value().

◆ is_form_saved()

dbxForm::is_form_saved ( )

Gibt zurück, ob das Formular bereits gespeichert wurde.

Returns: bool

Definition at line 4187 of file dbxForm.class.php.

References get_state_value().

◆ is_form_valid()

dbxForm::is_form_valid ( )

Gibt zurück, ob das Formular als gültig markiert ist.

Returns: bool

Definition at line 4127 of file dbxForm.class.php.

References get_state_value().

◆ load_sysdata()

dbxForm::load_sysdata ( )

Lädt Sysdata des Formulars.

Verwendung

Wird während forward_init() genutzt, damit Formularzustände zwischen Requests erhalten bleiben können.

Auswirkung

Gibt gespeicherte Sysdata als Array zurück. Ungültige Werte werden zu einem leeren Array normalisiert.

Returns: array

Definition at line 1332 of file dbxForm.class.php.

Referenced by forward_init().

◆ load_workflow_state()

dbxForm::load_workflow_state ( )

Lädt den Remember-basierten Workflow-State.

Returns: array

Definition at line 4001 of file dbxForm.class.php.

References get_workflow_state_key().

Referenced by forward_init(), get_state_value(), and set_workflow_scope().

◆ merge_fld_data()

dbxForm::merge_fld_data	(		$content,
			$i = 0 )

Fügt Felder in den Template-Inhalt ein.

Wichtige Regel

Diese Methode arbeitet mit einer lokalen Sicht auf _flds. Der globale Feldbestand wird beim Rendern NICHT zerstört.

Auswirkung

Felder mit explizitem {obj:feld}-Slot werden dort eingesetzt. Felder ohne expliziten Slot werden gesammelt und in [dbx:form] oder vor </form> eingefügt.

Parameters

string	$content	Template-Inhalt
int	$i	Laufindex

Returns: string

Definition at line 3542 of file dbxForm.class.php.

References create_fld().

Referenced by forward_run(), dbxReport\run(), and dbxReport\run().

◆ merge_obj()

dbxForm::merge_obj	(		$content,
			$i = 0 )

Ersetzt {obj:*}-Platzhalter.

Verwendung

Wird nach merge_fld_data() aufgerufen, um frei hinzugefügte Objekte wie Buttons, Action-Blöcke oder Modul-Ausgaben einzusetzen.

Auswirkung

Alle Einträge in _obj werden in passende {obj:name}-Slots eingesetzt.

Parameters

string	$content	Inhalt
int	$i	Laufindex

Returns: string

Definition at line 1278 of file dbxForm.class.php.

Referenced by forward_run(), dbxReport\run(), and dbxReport\run().

◆ merge_tpl_data()

dbxForm::merge_tpl_data	(		$tpl,
			$i = 0 )

Führt grundlegende Form-Replaces in Templates aus.

Verwendung

Wird in der Ausgabephase vor dem Einsetzen von Feldern und Objekten aufgerufen.

Auswirkung

Ersetzt Basiswerte wie {dbx_modul}, {dbx_run1}, {action}, {fid}, {rid}, {self} und {i}.

Parameters

string	$tpl	Template-Inhalt
int	$i	Laufindex

Returns: string

Definition at line 1236 of file dbxForm.class.php.

Referenced by forward_run(), dbxReport\run(), and dbxReport\run().

◆ next_i()

dbxForm::next_i ( $add = 1 )

Liefert oder erzeugt die laufende Formularinstanz-ID.

Parameters

int $add Weitergabe an dbx()->next_id()

Returns: int

Definition at line 3305 of file dbxForm.class.php.

References add_rep().

Referenced by buildModuleBarFormActionsHtml(), forward_init(), and forward_run().

◆ obv_value()

dbxForm::obv_value	(	$content,
		$id,
		$value )

Historische obv-Hilfe.

Hinweis

Diese Methode bleibt nur als Übergangshilfe erhalten. Observe-/Client-Reaktionslogik gehört heute nicht mehr in den Kern von dbxForm.

Parameters

string	$content	Inhalt
string	$id	Platzhalter-ID
mixed	$value	Wert

Returns: string

Definition at line 1206 of file dbxForm.class.php.

◆ php_date()

dbxForm::php_date ( $value )

Wandelt Datumswerte in DB-Format um.

Parameters

mixed $value Eingabe

Returns: string

Definition at line 3005 of file dbxForm.class.php.

◆ php_date_usr()

dbxForm::php_date_usr ( $value )

Wandelt Datumswerte in deutsches Format um.

Parameters

mixed $value Eingabewert

Returns: string

Definition at line 2952 of file dbxForm.class.php.

Referenced by dbxReport\rpt_format().

◆ php_datetime_usr()

dbxForm::php_datetime_usr ( $value )

Wandelt Datums-/Zeitwerte in deutsches Format um.

Parameters

mixed $value Eingabewert

Returns: string

Definition at line 2972 of file dbxForm.class.php.

Referenced by dbxReport\rpt_format().

◆ prepare_form_shell()

dbxForm::prepare_form_shell ( array $options = array() )

Definition at line 758 of file dbxForm.class.php.

References add_rep().

◆ prepareFormFrameReplaces()

dbxForm::prepareFormFrameReplaces ( int $i )

protected

Definition at line 786 of file dbxForm.class.php.

Referenced by forward_run().

◆ refresh_dependency_lock()

dbxForm::refresh_dependency_lock ( )

Markiert das Formular aufgrund veralteter Abhängigkeiten als gesperrt.

Returns: bool true = gesperrt, false = frei

Definition at line 4324 of file dbxForm.class.php.

References dependencies_are_current(), and set_form_locked().

◆ remember_current_dependencies()

dbxForm::remember_current_dependencies ( ?array $formIds = null )

Speichert die aktuell gültigen Versionsstände abhängiger Formulare.

Zweck

Nach erfolgreicher Prüfung/Speicherung eines abhängigen Formulars kann damit festgehalten werden, auf welcher Version seiner Vorgänger es basiert.

Parameters

array | null $formIds Optional explizite Form-IDs

Returns: void

Definition at line 4251 of file dbxForm.class.php.

References get_external_form_state(), get_state_value(), and set_state_value().

◆ resolve_fd_dd_editor_file()

dbxForm::resolve_fd_dd_editor_file ( string $source )

protected

Liefert den absoluten Pfad einer FD-/DD-Quelle fuer Editor-Marker.

Parameters

string	$kind	fd oder dd
string	$source	Aktive Formular-Quelle

Returns: string

Definition at line 3768 of file dbxForm.class.php.

Referenced by get_field_editor_markers().

◆ run()

dbxForm::run ( )

Öffentliche Run-Methode.

Returns: string

Reimplemented in dbxReport.

Definition at line 3897 of file dbxForm.class.php.

References forward_run().

◆ save_post()

dbxForm::save_post	(	$dd,
		$rid,
		$pv = '',
		$reread = 1 )

Speichert _post über dbxDB.

Sinn/Zweck

Diese Methode ist die bequeme Persistenz-Brücke von dbxForm. Sie ersetzt NICHT die freie Modul-Fachlogik, sondern bildet den Standard-Speicherpfad für Formulare.

Verhalten

optional zusätzliche Werte aus $pv übernehmen
dbxDB->save() aufrufen
bei Erfolg Insert-ID übernehmen
optional Datensatz erneut laden
_data und Feldwerte aktualisieren
Workflow-State aktualisieren

Parameters

string	$dd	DD/Zielstruktur
mixed	$rid	RID oder new
mixed	$pv	Zusätzliche Werte
int	$reread	1 = Datensatz nach Save neu lesen

Returns: mixed Ergebnis von dbxDB->save()

Definition at line 3225 of file dbxForm.class.php.

References bump_form_version(), set_form_complete(), set_form_saved(), set_form_valid(), set_state_value(), and store_workflow_state().

◆ set_activ_id()

dbxForm::set_activ_id	(		$value,
			$key = '' )

Setzt die aktive Remember-ID des aktuellen DD-Kontexts.

Parameters

mixed	$value	Wert
string	$key	Optionaler Kontextschlüssel

Returns: void

Definition at line 1379 of file dbxForm.class.php.

◆ set_dependencies()

dbxForm::set_dependencies ( array $formIds )

Setzt die Abhängigkeiten dieses Formulars.

Beispiel

$oForm->set_dependencies(['form-step-1', 'form-step-2']);

Parameters

array $formIds Abhängige Form-IDs

Returns: void

Definition at line 4229 of file dbxForm.class.php.

References set_state_value().

◆ set_draft_id()

dbxForm::set_draft_id ( string $draftId )

Setzt die Draft-ID explizit.

Parameters

string $draftId Draft-ID

Returns: void

Definition at line 4098 of file dbxForm.class.php.

References set_state_value().

◆ set_editor_class_file()

dbxForm::set_editor_class_file ( string $file )

Merkt sich die geladene Modul-/Include-Class fuer den Frontend-Editor.

Parameters

string $file Absoluter oder relativer Dateipfad

Returns: void

Definition at line 560 of file dbxForm.class.php.

References add_editor_file().

◆ set_fld_val()

dbxForm::set_fld_val	(		$fld_name,
			$fld_val )

Setzt einen Feldwert direkt im Feldzustand.

Parameters

string	$fld_name	Feldname
mixed	$fld_val	Wert

Returns: void

◆ set_msg_error()

dbxForm::set_msg_error ( $msg )

Setzt die Formular-Fehlermeldung.

Parameters

string $msg Meldung

Returns: void

Definition at line 1075 of file dbxForm.class.php.

◆ set_msg_info()

dbxForm::set_msg_info ( $msg )

Setzt die Formular-Info-Meldung.

Parameters

string $msg Meldung

Returns: void

Definition at line 1053 of file dbxForm.class.php.

◆ set_msg_ok()

dbxForm::set_msg_ok ( $msg )

Setzt die Formular-Erfolgsmeldung.

Parameters

string $msg Meldung

Returns: void

Definition at line 1064 of file dbxForm.class.php.

◆ set_msg_warning()

dbxForm::set_msg_warning ( $msg )

Setzt die Formular-Warnmeldung.

Parameters

string $msg Meldung

Returns: void

Definition at line 1086 of file dbxForm.class.php.

◆ set_post()

dbxForm::set_post	(		$key,
			$val )

Setzt einen _post-Wert manuell.

Zweck

Ermöglicht Modul-Fachlogik nach Standardvalidierung, ohne die Offenheit von dbxForm einzuschränken.

Parameters

string	$key	Feldname
mixed	$val	Wert

Returns: void

Definition at line 3192 of file dbxForm.class.php.

◆ set_run_callback()

dbxForm::set_run_callback ( string $callback )

Definition at line 650 of file dbxForm.class.php.

References dbxObj\set_callback().

◆ set_state_value()

dbxForm::set_state_value	(	string	$key,
			$value )

Setzt einen Wert im Workflow-State.

Parameters

string	$key	Schlüssel
mixed	$value	Wert

Returns: void

Definition at line 4046 of file dbxForm.class.php.

References store_workflow_state().

Referenced by bump_form_version(), get_draft_id(), get_rid(), remember_current_dependencies(), save_post(), set_dependencies(), set_draft_id(), set_form_complete(), set_form_locked(), set_form_saved(), and set_form_valid().

◆ set_submit_callback()

dbxForm::set_submit_callback ( string $callback )

Definition at line 646 of file dbxForm.class.php.

References dbxObj\set_callback().

◆ set_workflow_scope()

dbxForm::set_workflow_scope ( string $scope )

Setzt einen Workflow-Scope.

Zweck

Ein Scope gruppiert mehrere Formulare logisch innerhalb desselben Workflows.

Beispiel

$oForm->set_workflow_scope('order-setup');

Parameters

string $scope Scope

Returns: void

Definition at line 3923 of file dbxForm.class.php.

References load_workflow_state().

◆ store_sysdata()

dbxForm::store_sysdata ( )

Speichert Sysdata des Formulars.

Zweck

Sysdata ist der laufende Formzustand innerhalb des Session-Kontexts, nicht der übergeordnete Workflow-State. Workflow-/Draft-/Version-Status wird separat über Remember gehalten.

Auswirkung

Speichert _sys unter Formular-ID und Modul in der Session.

Returns: void

Definition at line 1305 of file dbxForm.class.php.

Referenced by forward_run(), dbxReport\run(), and dbxReport\run().

◆ store_workflow_state()

dbxForm::store_workflow_state ( )

Speichert den Workflow-State.

Returns: void

Definition at line 4023 of file dbxForm.class.php.

References get_workflow_state_key().

Referenced by clear_workflow_state(), forward_run(), save_post(), and set_state_value().

◆ submit()

dbxForm::submit ( )

Öffentliche Submit-Abfrage.

Returns: int 0|1

Reimplemented in dbxReport.

Definition at line 3058 of file dbxForm.class.php.

References forward_submit().

Referenced by create_fld(), and forward_run().

◆ update_error_fld()

dbxForm::update_error_fld	(		$name,
			$msg )

Markiert ein Feld mit Fehlerstatus.

Verwendung

Wird von add_fld_error() genutzt, damit Fehler nicht nur in _errors, sondern auch direkt am Feldzustand sichtbar werden.

Auswirkung

Setzt error, verify, ergänzt CSS-Klasse fld-error und setzt die Fehlermeldung in data.errormsg.

Parameters

string	$name	Feldname
string	$msg	Fehlermeldung

Returns: void

Definition at line 1476 of file dbxForm.class.php.

Referenced by add_fld_error().

◆ url_to_array()

dbxForm::url_to_array ( $data )

Wandelt Query-/URL-Daten in ein Array um.

Verwendung

Wird intern zur Normalisierung von data und options genutzt.

Auswirkung

Strings wie a=1&b=2 werden zu Arrays. Arrays bleiben unverändert.

Parameters

mixed $data String oder bereits Array

Returns: array|string

Definition at line 1031 of file dbxForm.class.php.

◆ view_sync()

dbxForm::view_sync ( $rid )

Synchronisiert eine RID in den View-State.

Parameters

int $rid RID

Returns: void

Definition at line 3147 of file dbxForm.class.php.

◆ wait()

dbxForm::wait ( )

Historischer Wait-Check.

Hinweis

Kein zentraler Architekturanker mehr.

Returns: int

Definition at line 3168 of file dbxForm.class.php.

◆ warnings()

dbxForm::warnings ( )

Gibt die Anzahl der Warnungen zurück.

Returns: int

Definition at line 3082 of file dbxForm.class.php.

Referenced by forward_run().

Member Data Documentation

◆ $_action

dbxForm::$_action = ''

Formular-Action.

Definition at line 233 of file dbxForm.class.php.

Referenced by dbxReport\get_report_action_url(), and dbx\dbxAdmin\dbxReport_Server\run_body().

◆ $_activ_id

dbxForm::$_activ_id = 0

Optional aktive ID.

Definition at line 383 of file dbxForm.class.php.

Referenced by dbx\myLKW\dbxReport_Dispo\run_body().

◆ $_ajax

dbxForm::$_ajax = true

AJAX-fähiges Formular.

Definition at line 203 of file dbxForm.class.php.

◆ $_confirm_copy

dbxForm::$_confirm_copy = ''

Optionaler Copy-Bestätigungstext.

Definition at line 380 of file dbxForm.class.php.

◆ $_confirm_delete

dbxForm::$_confirm_delete = ''

Optionaler Lösch-Bestätigungstext.

Definition at line 377 of file dbxForm.class.php.

◆ $_create_flds

dbxForm::$_create_flds = 1

1 = Felder sollen erzeugt werden

Definition at line 341 of file dbxForm.class.php.

◆ $_css

dbxForm::$_css = array()

CSS-Dateien oder Marker.

Definition at line 272 of file dbxForm.class.php.

◆ $_data

dbxForm::$_data = array()

Aktuelle Formulardaten / Record-Daten.

Definition at line 257 of file dbxForm.class.php.

◆ $_dbx_action

dbxForm::$_dbx_action = ''

Aktive DBX-Aktion.

Definition at line 221 of file dbxForm.class.php.

Referenced by dbxReport\get_report_action_url().

◆ $_dbx_design

dbxForm::$_dbx_design = ''

Aktives Design.

Definition at line 218 of file dbxForm.class.php.

◆ $_dbx_lng

dbxForm::$_dbx_lng = ''

Aktive Sprache.

Definition at line 215 of file dbxForm.class.php.

◆ $_dbx_modul

dbxForm::$_dbx_modul = 'modul'

Aktives Modul.

Definition at line 212 of file dbxForm.class.php.

Referenced by dbxReport\get_report_action_url().

◆ $_dbx_modul_id

dbxForm::$_dbx_modul_id = 0

Aktive Modul-ID.

Definition at line 209 of file dbxForm.class.php.

◆ $_dbx_page

dbxForm::$_dbx_page = ''

Aktive Seite.

Definition at line 227 of file dbxForm.class.php.

◆ $_dbx_view

dbxForm::$_dbx_view = ''

Optionaler View-Schlüssel.

Definition at line 191 of file dbxForm.class.php.

◆ $_dbx_work

dbxForm::$_dbx_work = ''

Optionaler Work-Kontext.

Definition at line 224 of file dbxForm.class.php.

Referenced by dbxReport\get_report_action_url().

◆ $_dd

dbxForm::$_dd = ''

Zugeordnetes DD.

Bleibt Daten-/DB-Kontext und Fallback-Feldquelle.

Definition at line 245 of file dbxForm.class.php.

◆ $_editor_class_file

dbxForm::$_editor_class_file = ''

Modul-/Include-Class-Datei fuer den Frontend-Editor.

Definition at line 254 of file dbxForm.class.php.

◆ $_editor_files

dbxForm::$_editor_files = array()

Dateien, die fuer den Frontend-Editor markiert werden.

Definition at line 251 of file dbxForm.class.php.

◆ $_editor_fld

dbxForm::$_editor_fld = ''

Optionales Editor-Feld.

Definition at line 371 of file dbxForm.class.php.

◆ $_errors

dbxForm::$_errors = array()

Feld-/Formfehler.

Definition at line 281 of file dbxForm.class.php.

◆ $_fd

dbxForm::$_fd = ''

Optionale FD-Felddefinitionsquelle.

Wenn gesetzt, bevorzugt add_fld()/add_flds() diese Quelle vor _dd.

Definition at line 248 of file dbxForm.class.php.

◆ $_fid

dbxForm::$_fid = ''

Formular-ID.

Definition at line 239 of file dbxForm.class.php.

◆ $_fld_change_state

dbxForm::$_fld_change_state = 'fld'

Feldmodus fuer die Changed-Logik: fld oder *.

Definition at line 359 of file dbxForm.class.php.

◆ $_fld_changes

dbxForm::$_fld_changes = -1

Gecachter Changed-Wert.

Definition at line 362 of file dbxForm.class.php.

◆ $_fld_id

dbxForm::$_fld_id = 'id'

Primärschlüsselfeld.

Definition at line 386 of file dbxForm.class.php.

Referenced by dbxReport\get_record_rid().

◆ $_flds

dbxForm::$_flds = array()

Felddefinitionen.

Definition at line 275 of file dbxForm.class.php.

◆ $_form_submit

dbxForm::$_form_submit = -1

-1 = unbekannt, 0 = nein, 1 = ja

Definition at line 365 of file dbxForm.class.php.

◆ $_form_validate

dbxForm::$_form_validate = -1

-1 = noch nicht ausgewertet, 1 = ausgewertet

Definition at line 368 of file dbxForm.class.php.

◆ $_general_error

dbxForm::$_general_error = ''

Allgemeiner Fehlertext.

Definition at line 290 of file dbxForm.class.php.

◆ $_infos

dbxForm::$_infos = array()

Info-Meldungen.

Definition at line 278 of file dbxForm.class.php.

◆ $_js

dbxForm::$_js = array()

JS-Code-Blöcke.

Definition at line 269 of file dbxForm.class.php.

◆ $_mode

dbxForm::$_mode = 'mix'

tpl|php|mix

Definition at line 200 of file dbxForm.class.php.

◆ $_module_bar_form_actions

dbxForm::$_module_bar_form_actions = array()

protected

Optionen fuer Standard-Aktionen in der Modul-Bar.

Definition at line 353 of file dbxForm.class.php.

◆ $_msg_error

dbxForm::$_msg_error = '#form_msg_error#'

Standard-Fehlertext.

Definition at line 299 of file dbxForm.class.php.

◆ $_msg_info

dbxForm::$_msg_info = '#form_msg_info#'

Standard-Infotext.

Definition at line 293 of file dbxForm.class.php.

◆ $_msg_success

dbxForm::$_msg_success = '#form_msg_success#'

Standard-Erfolgstext.

Definition at line 296 of file dbxForm.class.php.

◆ $_msg_warning

dbxForm::$_msg_warning = '#form_msg_warning#'

Standard-Warntext.

Definition at line 302 of file dbxForm.class.php.

◆ $_next_i

dbxForm::$_next_i = 0

Laufende Formularinstanz-ID.

Definition at line 242 of file dbxForm.class.php.

◆ $_obj

dbxForm::$_obj = array()

Platzhalter-Objekte.

Definition at line 266 of file dbxForm.class.php.

◆ $_page_reset

dbxForm::$_page_reset = 1

Historischer Page-Reset-Flag.

Definition at line 374 of file dbxForm.class.php.

◆ $_post

dbxForm::$_post = array()

Validierte/geänderte POST-Werte.

Definition at line 260 of file dbxForm.class.php.

◆ $_reload_record

dbxForm::$_reload_record = 1

1 = Datensatz nach Save neu lesen

Definition at line 344 of file dbxForm.class.php.

◆ $_reload_run

dbxForm::$_reload_run = 0

1 = Reload wurde ausgeführt

Definition at line 347 of file dbxForm.class.php.

◆ $_reload_suffix

dbxForm::$_reload_suffix = '_rlo'

Historischer Reload-Suffix.

Definition at line 356 of file dbxForm.class.php.

◆ $_reload_transform

dbxForm::$_reload_transform = 0

Historischer Reload-Transform-Flag.

Definition at line 350 of file dbxForm.class.php.

◆ $_replaces

dbxForm::$_replaces = array()

Allgemeine Replace-Werte.

Definition at line 287 of file dbxForm.class.php.

◆ $_rid

dbxForm::$_rid = 0

Aktuelle Record-ID.

Definition at line 230 of file dbxForm.class.php.

◆ $_store_mode

dbxForm::$_store_mode = 'session'

Aktueller Sysdata-Speichermodus.

Definition at line 206 of file dbxForm.class.php.

◆ $_sys

dbxForm::$_sys = array()

Form-interne Zustände / Sysdata.

Definition at line 263 of file dbxForm.class.php.

◆ $_tpl

dbxForm::$_tpl = ''

Template-Name.

Definition at line 236 of file dbxForm.class.php.

◆ $_tpl_fld_error

dbxForm::$_tpl_fld_error = 'fld-alert-danger'

Template für Feld-Fehler.

Definition at line 323 of file dbxForm.class.php.

◆ $_tpl_fld_info

dbxForm::$_tpl_fld_info = 'fld-alert-info'

Template für Feld-Info.

Definition at line 317 of file dbxForm.class.php.

◆ $_tpl_fld_success

dbxForm::$_tpl_fld_success = 'fld-alert-success'

Template für Feld-Erfolg.

Definition at line 320 of file dbxForm.class.php.

◆ $_tpl_fld_warning

dbxForm::$_tpl_fld_warning = 'fld-alert-warning'

Template für Feld-Warnung.

Definition at line 326 of file dbxForm.class.php.

◆ $_tpl_form_error

dbxForm::$_tpl_form_error = 'form-alert-danger'

Template für Fehlermeldungen.

Definition at line 311 of file dbxForm.class.php.

◆ $_tpl_form_info

dbxForm::$_tpl_form_info = 'form-alert-info'

Template für Info-Meldungen.

Definition at line 305 of file dbxForm.class.php.

◆ $_tpl_form_success

dbxForm::$_tpl_form_success = 'form-alert-success'

Template für Erfolgsmeldungen.

Definition at line 308 of file dbxForm.class.php.

◆ $_tpl_form_warning

dbxForm::$_tpl_form_warning = 'form-alert-warning'

Template für Warnmeldungen.

Definition at line 314 of file dbxForm.class.php.

◆ $_tpl_max_try

dbxForm::$_tpl_max_try = 'form-alert-maxtry'

Template für Max-Try-Sperre.

Definition at line 329 of file dbxForm.class.php.

◆ $_try_max

dbxForm::$_try_max = 20

Maximale Fehlversuche.

Definition at line 335 of file dbxForm.class.php.

◆ $_try_msg

dbxForm::$_try_msg = 'Max {try_count} try. Suspend for {sec} seconds'

Sperr-Text.

Definition at line 338 of file dbxForm.class.php.

◆ $_try_reset

dbxForm::$_try_reset = 120

Sekunden bis Try-Reset.

Definition at line 332 of file dbxForm.class.php.

◆ $_view_mode

dbxForm::$_view_mode = ''

Optionaler View-Modus.

Definition at line 197 of file dbxForm.class.php.

◆ $_view_sync

dbxForm::$_view_sync = ''

Optionaler View-Sync-Status.

Definition at line 194 of file dbxForm.class.php.

◆ $_warnings

dbxForm::$_warnings = array()

Warnungen.

Definition at line 284 of file dbxForm.class.php.

◆ $_workflow_scope

dbxForm::$_workflow_scope = ''

Workflow-Scope für Remember-State.

Definition at line 389 of file dbxForm.class.php.

◆ $_workflow_state

dbxForm::$_workflow_state = array()

Remember-basierter Form-Status.

Definition at line 392 of file dbxForm.class.php.

◆ $oDB

dbxForm::$oDB

Zentraler DB-/DD-Service.

Definition at line 188 of file dbxForm.class.php.

Referenced by dbxReport\run(), and dbx\dbxAdmin\dbxReport_Server\run_body().

◆ $oTPL

dbxForm::$oTPL

Zentrale Template-Engine.

Definition at line 185 of file dbxForm.class.php.

Referenced by add_norep(), and dbx\dbxAdmin\dbxReport_Server\run_body().

◆ $oValidator

dbxForm::$oValidator

Zentraler Validator.

Definition at line 182 of file dbxForm.class.php.

The documentation for this class was generated from the following file:

dbx/include/dbxForm.class.php

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

DBX FORM SYSTEM (dbxForm)

Zweck

Typische Aufgaben

Architektur

Wichtige Grundsätze

FD-/DD-Felddefinitionen

Workflow-/Draft-Gedanke

Beispiel: einfache Nutzung mit DD

Beispiel: automatische Felder aus FD

Beispiel: neuer Datensatz mit Draft-Kontext

Beispiel: abhängige Formulare

Constructor & Destructor Documentation

◆ __construct()

Verwendung

Auswirkung

◆ __destruct()

Verwendung

Auswirkung

Member Function Documentation

◆ _forward_clear()

Sinn/Zweck

Auswirkung

Wichtig

Konsequenz

◆ add_action()

Verwendung

◆ add_css()

◆ add_default_search_rep()

◆ add_editor_file()

◆ add_editor_markers()

◆ add_fld()

Zweck

Marker-Regel

Beispiel

Auswirkung

◆ add_fld_error()

Auswirkung

◆ add_fld_warning()

◆ add_flds()

Verwendung

Hybrid-Regel

Beispiel

Auswirkung

◆ add_js_call()

Zweck

Beispiel

◆ add_js_code()

Verwendung

Auswirkung

◆ add_module_bar()

◆ add_module_bar_form_actions()

◆ add_norep()

Zweck

Auswirkung

◆ add_obj()

Verwendung

Auswirkung

◆ add_rep()

Verwendung

◆ applyModuleBarReplaces()

◆ attachAdminHelpButton()

◆ buildModuleBarFormActionsHtml()

◆ buildModuleBarObj()

◆ bump_form_version()

Zweck

◆ changed()

◆ check_fld_data()

Auswirkungen

◆ check_flds_data()

Auswirkung

◆ check_try_count()

◆ clear()

Verwendung

Auswirkung

Workflow-Hinweis