person_get
Methode zum Abrufen von Daten eines Kunden.
Informationen zu den Datenfelder eines Kunden finden Sie unter: Daten-Typ "Kunde".
$Params | Pflicht | Beschreibung | Beispiel |
---|---|---|---|
[fields] | optional |
String/Array (faster). Liste der Fields, die returned werden sollen. Wird nichts angegeben wird "*" angenommen, d.h. alle im Model hinterlegten Felder. Es sollten nur die Felder angegeben werden, die auch wirklich benötigt werden. Speziell bei Multi-Table-Models werden dann auch nur die Tables im SELECT dazu geJOINed, die benötigt werden. |
Als String: "firstname,lastname,birthday".
Als Array: |
[filter][<field>] | optional |
String. Pro Field kann hier ein Wert angegeben werden, der dann im WHERE-Statement aufgenommen wird. Im Falle eines virtuellen Fields, wird das in "drvd_select" hinterlegte SQL in das WHERE-Statement mit aufgenommen.
Es wird immer mit "<field> = '<auto-escaped Value>' " gesucht. Mehrere Filter-Felder werden mit AND verknüpft. Die übergebenen Werte werden automatisch escaped (Schutz vor SQL-Injection). Hiermit können einfache, SQL-Injection-sichere Filterkriterien realisiert werden. Für komplexere WHERE-Statements bitte [xwhere] benutzen! MySQL-wildcard-Filter "%" können hier aktuell leider nicht verwendet werden, da auch bei Text-Feldern mit "=" geprüft wird und nicht mit SQL LIKE. |
['lastname'] ="e-matters" |
[filter][<field>][search] | optional |
String. Pro Field kann hier ein Suchbegriff angegeben werden, der Field-Typ-spezifisch (INT, FLOAT, TEXT, DATE, DATETIME) interpretiert wird. Wird diese Option genutzt kann natürlich nicht zuvor genannte [filter][<field>]-Abfrage für dieses Feld genutzt werden. |
Text: "my_* || ecms_* || *.class.*" |
Array-Key | Typ | Beschreibung |
---|---|---|
[status] | boolean |
TRUE: Wenn die Datenabfrage durchgeführt werden konnte. FALSE: Wenn es bei der Ausführung einen Fehler gab. |
[msg][<n>][type|text] | string |
Message-Stack Ein optionales Array, um Message-Strings zur Ausgabe in der GUI und Message-Codes zurückzugeben. Vor allem bei Ausführungsfehlern ( [status]=FALSE) sollte hier etwas zurückgegeben werden.
Numerisches Array (mit n von 0 bis N). Es können prinzipiell beliebig viele Messages zurückgegeben werden. [ type] ist typischerweise einer der folgenden Werte:
|
[data][<fields>] | mixed |
Die eigentlichen Daten des angeforderten Datensatzes in einem assoziativen Array. |