HTTP-Request-Parameter
Einige HTTP-Request-Parameter werden von der LivingAPI selbst verwendet zur Steuerung welches Anzeige-Template zur Datenanzeige verwendet wird, und welche Daten diesem Anzeige-Template zur Verfügung gestellt werden.
Alle Parameter-Namen die mit la- beginnen sind für die LivingAPI reserviert
und sollten nicht für andere Zwecke verwendet werden.
Template
Der Request-Parameter template bestimmt welches Anzeige-Template verwendet
wird. D.h. der Parameter-Wert muß der
Identifizierer eines Anzeige-Templates
sein. Ist der Parameter template nicht angegeben wird das
Standard-Anzeige-Template verwendet (d.h. das Template dessen
Standard-Haken gesetzt ist). Gibt es kein
Standard-Anzeige-Template erhalten Sie einen 404-HTTP-Fehler.
Paging
Wenn eine Datenquelle so konfiguriert ist, daß die Datensätze dieser App einem
Anzeige-Template zur Verfügung gestellt werden, kann es vorkommen, daß die
Anzahl der Datensätze zu groß ist um sie auf einer HTML-Seite anzuzeigen. In
diesem Fall können Sie durch Request-Parameter festlegen, daß für diese
Datenquelle nur ein Teil der Datensätze zur Verfügung gestellt wird. Wenn Sie
z.B. eine Datenquelle mit dem Identifizierer personen haben, können Sie
mit folgendem Request-Parameter festlegen, daß Sie nur die ersten 20 Datensätze
haben wollen:
la-ds-personen-paging=0_20
0_20 bedeutet dabei, daß beginnend beim ersten Datensatz (also mit dem
Index 0) 20 Datensätze ausgeliefert werden sollen.
Dieselbe Funktionalität steht für untergeordnete Datensätze zur Verfügung. Wenn
z.B. bei obiger Datenquelle personen noch eine Konfiguration für
untergeordnete Datensätze mit den Identifizierer bestellungen existiert,
können Sie folgenden Request-Parameter verwenden:
la-dsc-personen-1234567890abcdef12345678-bestellungen-paging=20_10
Damit werden dann bei dem Personen-Datensatz mit der Id
1234567890abcdef12345678 aus der Datenquelle personen von den
untergeordneten bestellungen-Datensätzen nur der 20.-29. ausgeliefert. Ist
der Parameter für diesen Datensatz nicht angegeben, wird zusätzlich noch der
Parameter
la-dsc-personen-bestellungen-paging
verwendet (d.h. dieser Parameter kann verwendet werden um ein Default-Paging für die untergeordneten BEstellungs-Datensätze aller Personen-Datensätze anzugeben).