Funktion „pool_select_update()“
bool pool_select_update(numeric $gtabid, numeric $fieldid, numeric $ID, array $update_values);
Funktion die das Bearbeiten von Einträgen aus Auswahlpools erlaubt. Diese können vom Typ Auswahlfeld oder Attribut sein.
Parameter:
Die Übergabe-Parameter werden an den erforderlichen Stellen des Rückgabe-Arrays eingefügt.
$gtabid
- Tabellen-ID der Tabelle, die das Feld mit der Verknüpfung enthält
$fieldid
- Feld-ID des Feldes mit der Verknüpfung
$ID
- ID des Datensatzes, für den Datensätze aus der verknüpften Tabelle hinzugefügt, gelöscht oder angezeigt werden sollen
$update_values
- Array das die Anweisungen beinhaltet. Das Array ist wie folgt aufgebaut:
- ‚action‘ – Aktion, a = hinzufügen; d = löschen; v = ändern von Attribut Inhalt
- ‚wid‘ – W_ID des Verknüpften Datensatzes aus [LMB_SELECT_W]
- ‚id‘ – ID des Verknüpften Datensatzes aus [LMB_SELECT_D] / [LMB_ATTRIBUTE_D]
- ‚value‘ – Attribut Inhalt
Es kann entweder die ID des Verknüpfungsdatensatzes (LMB_SELECT_D), die W_ID des Pooleintrags (LMB_SELECT_W) oder Beide angegeben werden. Dabei ist bei aktiviertem „multiple mode“ des Pools die ID zur eindeutigen Identifizierung notwendig da Pooleinträge mehrfach vorkommen können.
Beispiel
Diese Beispiele sollen auf eine Tabelle mit der ID 2 und dessen Feld mit der ID 3 sowie auf den Datensatz 123 angewendet werden.
Dieses Beispiel fügt aus einem Auswahlpool (definiert über den Feldtyp) den Wert mit der ID 12 hinzu und löscht den Wert mit der ID 11.
$update_values[] = array('action'=>'a','wid'=>12);
$update_values[] = array('action'=>'d','wid'=>11);
pool_select_update(2, 3, 123, $update_values);Dieses Beispiel fügt aus einem Auswahlpool (definiert über den Feldtyp) den Wert mit der ID 12 hinzu und ändert den Attribut Inhalt in ‚Limbas‘.
$update_values[] = array('action'=>'v','wid'=>12, 'value'=>'Limbas');
pool_select_update(2, 3, 123, $update_values);Dieses Beispiel ändert den Inhalt des Attributs mit der W_ID 12 in ‚Limbas 1‘ und den Inhalt des Attributs mit der ID 13 in ‚Limbas 2‘. Dabei wird unterschieden ob die ID oder die W_ID zur Identifikation genutzt wird. Für Pools mit aktivierten „multiple mode“ ist es sinnvoll die ID aus [LMB_SELECT/ATTRIBUTE_D] zu nutzen da ansonsten alle Werte mit der gleichen W_ID geändert werden würden.
$update_values[] = array('action'=>'v','wid'=>12, 'value'=>'Limbas 1');
$update_values[] = array('action'=>'v','id'=>13, 'value'=>'Limbas 2');
pool_select_update(2, 3, 123, $update_values);