MOBILE Return selection

4D v15

4D v15 - Actualización (standard edition)


MOBILE Return selection ( tabla ) -> Resultado

Parámetro	Tipo	Descripción
tabla	Tabla	Tabla cuya selección actual usted desea retornar
Resultado	Objeto	Wakanda-compliant selection

Descripción

Originalmente introducido en 4D v14 R3

El comando MOBILE Return selection devuelve un objeto JSON que contiene la selección actual de tabla transformada en una colección de entidades Wakanda.

Este comando está destinado para ser llamado en el contexto de una conexión 4D Mobile, por lo general entre la aplicación 4D y una aplicación Wakand (vía REST). Cuando se establece una conexión 4D Mobile y se han configurado los derechos de acceso adecuados, una aplicación Wakanda puede ejecutar un método proyecto 4D que devuelve un valor en el parámetro $0.

El comando MOBILE Return selection le permite devolver en $0, la selección actual de registros de la tabla tabla, en la forma de un objeto tipo colección de entidades en formato JSON. Este objeto es compatible con las colecciones de entidades de Wakanda que contienen una selección de registros (es decir, de entidades).

Tenga en cuenta que los accesos 4D Mobile requieren configuraciones específicas en sus bases 4D:

El servidor Web debe estar en marcha,
La opción "Activar los servicios 4D Mobile" se estar seleccionada en las Propiedades de la base,
Debe tener una licencia válida,
Las tablas y campos utilizados deben tener seleccionada la opción "Expose para 4D Mobile" (seleccionada por defecto).
Los métodos llamados deben tener la opción "Disponible vía las llamadas 4D Mobile" activa (no seleccionada por defecto).

Tenga en cuenta que puede pasar toda tabla válida de la base en tabla y no necesariamente la tabla con la que el método proyecto se ha asociado en sus propiedades. Este parámetro sólo se utiliza del lado Wakanda para definir los objetos para los que se puede llamar al método.

Para obtener más información sobre la configuración 4D Mobile, consulte la documentación 4D Mobile.

Ejemplo

Usted desea mostrar la selección actual de la tabla [Countries] en una rejilla Wakanda, basado en una búsqueda.

Escribe el siguiente método:

  //FindCountries project method

  //FindCountries( string ) -> object

 

 C_TEXT($1)

 C_OBJECT($0)

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

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

la selección devuelta puede ser utilizada directamente en Wakanda como una colección válida.

En el modelo del servidor de Wakanda conectado a 4D vía 4D Mobile, usted ha creado una página con una rejilla asociada a la tabla 4D Countries. Por defecto, durante la ejecución, se muestran todas las entidades de la tabla 4D:

El código del botón es:

button1.click = function button1_click (event)
<p>    {
        sources.countries.FindCountries("i", {  //llamamos al método 4D, "i" se pasa en $1
                onSuccess:function(coll){  //función de retrollamada (asíncrona), recibe $0 como parámetro
                    sources.countries.setEntityCollection(coll.result); //remplaza la colección de entidades actual
                                // con la que recibe en el objeto coll.result
                }
            });        
    };

Como resultado, la rejilla se actualiza: