QFQ

h1. Form Wizard

h2. Skizze

!clipboard-202312141454-ndbms.png!

!clipboard-202312141455-gkid6.png!

h2. Funktionbeschreibung

* Datenbanktabelle Auslesen und Struktur Erkennen:

** Automatisches Auslesen und Anzeigen der Struktur von Tabellen aus einer Datenbank.

* Automatische Input-Felder

** Felder werden basierend auf den Datentypen in der Datenbanktabelle generiert (z.B. wird für 'VARCHAR' standardmässig ein Text verwendet, Datetime => datetime).

* Anpassbare Formularfelder

** Die Art der Felder (Text, Dropdown, etc.) über ein Dropdown-Menü anpassbar.

** Für alle type, die eine sql1 benötigen, wird automatisch ein neues Eingabefeld für diese Abfrage hinzugefügt.

* Zusätzliche Felder

** Manuelle Hinzufügung von Feldern, die nicht direkt mit der Datenbanktabelle verbunden sind (wie 'Pill', 'Action').

** Variante 1: Bei Auswahl eines Containers (z.B. 'Pill') erhält jedes Formularelement ein zusätzliches Dropdown-Menü zur Auswahl des entsprechenden Containers.

** Variante 2: Man kann in das Pillfeld eine neue Pill generieren zur suche werden TypeAhead 

** TypeAhead für existierende Felder

* Lösch/disable funktion

** Jedes Formularelement kann über einen "Delete"-Button entfernt werden.

** Checkbox damit man den Formelement disable zu können.

* Tooltipps

** Nützliche Informationen zu bestimmten Formularelemente.

h2. Multi Form

Für die Implementierung des Form Wizard haben wir Gedanken gemacht, und sind dabei auf das QFQ Multi Form gestossen, da es viele ähnliche Eigenschaften aufweist. Um das Multi Form jedoch als geeigneten Stoff für eine IPA zu qualifizieren, muss es entsprechend erweitert werden.

* Flexibilität bei der Datensatz-Identifikation: 

** Aktuell benötigt das Multi Form eine ID, die nur für existierende Tabellen mit Datensätzen funktioniert. 

** Es soll so erweitert werden, dass es auch ohne vorhandene Datensätze (ID 0) nutzbar ist.

* Dynamisches Update:

** Das Multi Form soll dynamisch auf Änderungen reagieren können, z.B. wenn im Form Wizard der Klassentyp auf 'Container' geändert wird und daraufhin der Typ automatisch im Dropdown-Menü angepasst wird.

* Neuer 'Create'-Button:

** Dieser Button soll das Erstellen neuer Formelemente ermöglichen, ähnlich wie bestehende Formularelemente.

* Delete-Button zur Datensatzlöschung: 

** Eine Funktion zum Löschen von Datensätzen direkt aus dem Multi Form.

* Drag and Drop function:

** Ermöglicht es, beispielsweise ein Pill-Formularelement per Drag-and-Drop dem zugehörigen Pill-Bereich zuzuordnen.

h2. Grobe Zeit einschätzung

Implementierung:

*Multiform erweitern* 24h~

* add row 10h + 2h ~

** Logik in JavaScript implementieren (4 Stunden)

** Button rendern logic PHP (2 Stunden)

** Template auf 'hidden' setzen, um das Hinzufügen neuer Zeilen auch ohne vorhandene records zu ermöglichen (4 Stunden in PHP)

** Add Button kann Aufgeruft werden mit form.parameter.multiFormAddRow = 1 (1.5 Stunden in PHP)

** unit test (2h PHP)

* delete row 8 + 2~

** Zeile kann nicht gelöscht werden wenn der record schon vorhanden ist. 2h PHP

** Zeile die id = 0 sind werden clientseitig gelöscht, falls es nicht gespeichert wurde. 2h

** button rendern 2h PHP

** logic javascript 3h

** unit test 1.5 PHP 

*Formwizard* (16h) ~

* struktur aufbauen 1h QFQ

** name,label,native...

* Datenbanktabelle Auslesen und Struktur Erkennen. 8h QFQ

** Die existierende FormElement werden nicht nochmals neue erstellt 1h

** Automatisches Auslesen und Anzeigen der Struktur von Tabellen aus einer Datenbank 1h 

** Felder werden basierend auf den Datentypen in der Datenbanktabelle generiert. sql1 query 6h 

* Form erweitern um auf FormWizard zuzugreifen. 2h QFQ

* Speichern 4h QFQ/JS

** slaveId logic before save ...etc 2h QFQ

** neue pill hizufügen per textInput 1h JS