MOBILE Return selection

4D v16.3


MOBILE Return selection ( laTable ) -> Résultat

Paramètre	Type	Description
laTable	Table	Table de laquelle retourner la sélection courante
Résultat	Objet	Sélection compatible Wakanda

Description

La commande MOBILE Return selection retourne un objet JSON contenant la sélection courante de laTable exprimée sous la forme d'une entity collection de Wakanda.

Cette commande est destinée à une utilisation dans le contexte d'une liaison 4D Mobile, établie généralement entre votre application 4D et une application Wakanda (via REST). Lorsqu'une liaison 4D Mobile est établie et que les droits d'accès appropriés ont été configurés, une application Wakanda peut exécuter une méthode projet 4D qui retourne une valeur dans le paramètre $0.

La commande MOBILE Return selection vous permet de retourner via $0 la sélection courante d'enregistrements de la table laTable, sous la forme d'un objet de type entity collection formaté en JSON. Cet objet est identique aux collections d'entités de Wakanda contenant une sélection d'enregistrements (i.e. d'entités).

N'oubliez pas que les accès 4D Mobile nécessitent des paramétrages spécifiques dans vos bases 4D :

Le serveur Web doit être lancé,
L'option "Activer les services 4D Mobile" doit être cochée dans les Propriétés de la base,
Vous devez disposer d'une licence autorisant l'utilisation de 4D Mobile,
L'option "Exposer avec le service 4D Mobile" doit être cochée pour les tables et les champs utilisés (option cochée par défaut).
L'option "Disponible via les appels 4D Mobile" doit être cochée pour la méthode appelée (option non cochée par défaut).

A noter que vous pouvez passer toute table valide de la base dans le paramètre laTable, et pas nécessairement la table à laquelle la méthode projet a été associée via ses propriétés 4D Mobile. Ce paramétrage est utilisé uniquement côté Wakanda pour définir les objets sur lesquels la méthode peut être appelée.

Pour plus d'informations sur la configuration 4D Mobile, veuillez vous reporter à la documentation 4D Mobile.

Exemple

Vous souhaitez afficher la sélection courante de la table [Countries] dans une grille Wakanda, basée sur une recherche.

Vous écrivez la méthode 4D suivante :

  //méthode projet FindCountries

  //FindCountries( chaine ) -> objet

 

 C_TEXT($1)

 C_OBJECT($0)

 QUERY([Countries];[Countries]ShortName=$1+"@")

 $0:=MOBILE Return selection([Countries])

La sélection retournée peut être utilisée directement dans Wakanda car c'est une collection valide.

Dans le modèle du serveur Wakanda connecté à 4D via 4D Mobile, vous avez créé une page contenant une grille (grid) associée à la table 4D [Countries]. Par défaut, à l'exécution toutes les entités de la table 4D table sont affichées :

Le code du bouton est le suivant :

button1.click = function button1_click (event)
    {
        sources.countries.FindCountries("i", {  //on appelle la méthode 4D, "i" est passé dans $1
                onSuccess:function(coll){  //fonction de rétroappel (asynchrone), récupère ce qui est passé dans $0 comme paramètre
                    sources.countries.setEntityCollection(coll.result); //remplace l'entity collection courante
                                // avec celle reçue dans l'objet coll.result
                }
            });        
    };

En résultat, la grille est mise à jour :