4D v16.3

MOBILE Return selection

Home

 
4D v16.3
MOBILE Return selection

MOBILE Return selection 


 

MOBILE Return selection ( Tabellenname ) -> Funktionsergebnis 
Parameter Typ   Beschreibung
Tabellenname  Tabelle in Tabelle, deren Auswahl zurückgegeben werden soll
Funktionsergebnis  Objekt in Für Wakanda kompatible Auswahl

Die Funktion MOBILE Return selection gibt ein JSON Objekt mit der aktuellen Auswahl von Tabellenname zurück, die in eine für Wakanda geeignete Entity Collection umgewandelt wurde. 

Diese Funktion wird im Rahmen einer 4D Mobile Verbindung aufgerufen, normalerweise zwischen Ihrer 4D Applikation und einer Wakanda Applikation (via REST). Ist eine 4D Mobile Verbindung mit passenden Zugriffsrechten eingerichtet, kann eine Wakanda Applikation eine 4D Projektmethode ausführen, die im Parameter $0 einen Wert zurückgibt.

Die Funktion MOBILE Return selection ermöglicht, in $0 die aktuelle Datensatzauswahl von Tabellenname in Form eines Objekts Entity Collection im JSON Format zurückzugeben. Dieses Objekt ist kompatibel mit Entity Collections in Wakanda, die eine Auswahl von Datensätzen enthalten (z.B. von entities).

Beachten Sie, dass für 4D Mobile Zugriffe in Ihrer 4D Anwendung spezifische Einstellungen erforderlich sind:

  • Der Web Server muss gestartet sein,
  • In den Datenbank-Eigenschaften muss die Option "Aktiviere 4D Mobile Service" markiert sein,
  • Sie müssen eine gültige Lizenz haben,
  • Für Tabellen und Felder muss die Option "Mit 4D Mobile Service veröffentlichen" markiert sein (ist standardmäßig markiert). 
  • Für aufgerufene Methoden muss die Option "Verfügbar per 4D Mobile Aufruf" markiert sein (ist nicht standardmäßig markiert). 

Beachten Sie, dass Sie in Tabellenname jede gültige Tabelle der Anwendung übergeben können. Das muss nicht zwingend die Tabelle sein, der die Projektmethode in den Eigenschaften zugewiesen wurde. Dieser Parameter wird nur auf der Wakanda Seite zur Definition der Objekte verwendet, für die sich die Methode aufrufen lässt.

Weitere Informationen dazu finden Sie in der Dokumentation zu 4D Mobile

Die aktuelle Auswahl zu einer Suche in der Tabelle [Countries] in einem Grid in Wakanda anzeigen.

Sie schreiben folgende 4D Methode:

  //Projektmethode FindCountries
  //FindCountries( string ) -> object
 
 C_TEXT($1)
 C_OBJECT($0)
 QUERY([Countries];[Countries]ShortName=$1+"@")
 $0:=MOBILE Return selection([Countries])

Die zurückgegebene Auswahl lässt sich direkt in Wakanda als gültige Collection verwenden.

Im Wakanda Server Model, das via 4D Mobile mit 4D verbunden ist, haben Sie eine Seite mit einem Grid erstellt, das an die Tabelle 4D Countries gebunden ist. Standardmäßig werden alle Entities aus der 4D Tabelle angezeigt:

Der Code für die Schaltfläche lautet:

button1.click = function button1_click (event)
    {
        sources.countries.FindCountries("i", {  //die 4D Methode aufrufen, "i" wird als $1 übergeben
                onSuccess:function(coll){  //Callback Funktion (asynchron), empfängt $0 als Parameter
                    sources.countries.setEntityCollection(coll.result); //die aktuelle Entity Collection
                                // mit der im Objekt coll.result ersetzen
                }
            });        
    };

Hier als Ergebnis das upgedatete Grid:

 
EIGENSCHAFTEN 

Produkt: 4D
Thema: Auswahl
Nummer: 1315

This command can be run in preemptive processes

 
GESCHICHTE 

Erstellt: 4D v14 R3

 
ARTIKELVERWENDUNG

4D Programmiersprache ( 4D v16)
4D Programmiersprache ( 4D v16.1)
4D Programmiersprache ( 4D v16.2)
4D Programmiersprache ( 4D v16.3)