Der Auswahldialog ermöglicht die Auswahl aus dem Inhalt einer Tabelle, die diskrete Werte in Form eines Schlüssels und einer Bezeichnung enthält. Die Auswahltabelle enthält dabei Checkboxen, sodass mehrere Ausprägungen gewählt werden können.
Die auswählten Schlüssel und die Bezeichnungen werden jeweils als ein String mit Trennzeichen separiert übergeben. Die Trennzeichen für Schlüssel und Bezeichnungen sind frei wählbar. Bei einstelligen Schlüsseln kann der Trenner weggelassen werden (z. B. wie in der Demo).
Als Parameter werden folgende Werte benötigt:
| Nr. | Beschreibung |
|---|---|
| 0 | Name eines PHP-Scripts, das die Datenbank öffnet Beispiel: |
| 1 | Name Feldes im aufrufenden Formular, das mit die gewählten Schlüssel gefüllt werden soll. Falls der Benutzer die Schlüssel nicht sehen soll, kann dies auch ein Feld vom Typ „hidden“ sein. |
| 2 | Name Feldes im aufrufenden Formular, das mit den Bezeichnungen gefüllt werden soll |
| 3 | Name der Tabelle aus der die Werte zu lesen sind |
| 4 | Name des Schlüsselfeldes in der Tabelle |
| 5 | Name des Bezeichnungsfeldes in der Tabelle |
| 6 | Zusätzliche Selectbedingung als SQL-Rudiment, richtig formatiert, ohne WHERE Beispiel: |
| 7 | Trenner für die ausgewählten Schlüssel. Wenn keine Trennzeichen angegeben werden, werden alle Schlüssel direkt hintereinander gestellt. Dies ist nur bei einstelligen Schlüsseln sinnvoll. |
| 8 | Trenner für die ausgewählten Bezeichnungen. Wenn keine Trennzeichen angegeben werden, benützt das Programm Kommas. |
| 9 | Übergabe bereits selektierter Schlüssel. Die Schlüssel müssen durch den unter 7 angegebenen Trenner separiert sein. Die hier übergebenen Schlüssel sind in der Auswahl bereits angehakt.Wenn dieser Parameter leer bleibt wird automatisch der Inhalt des als Parameter 1 angegebenen Formularfeldes übergeben. |
| 10 | Überschrift für den Auswahldialog |
Damit nicht ein Benutzer durch manuelle Übergabe von Parametern und direktem Aufruf des Dialogs die ganze Datenbank auskundschaften kann, bleiben die
Aufrufparameter unsichtbar. Dies durch den Aufruf eines Zwischenscripts erreicht, das die Parameter in die Session schreibt, und dann erst den eigentlichen Auswahldialog aufruft.
Die Funktion bedarf großer Vorsicht, und wird generell auf eigene Gefahr benützt.
Es ist wichtig, dass Sie den Namen des Zwischenscripts von „php-dbselect-hidden.php“ auf einen möglichst kryptischen Namen umbennen (nicht kopieren!), und den Aufruf in „auswahl.js“ entsprechend anpassen.
