MOBILE Return selection

4D v15


MOBILE Return selection ( umaTabela ) -> Resultado

Parâmetro	Tipo	Descrição
umaTabela	Tabela	Tabela cuja seleção atual você quer retornar
Resultado	Objeto	Seleção Wakanda-compliant

Descrição

O comando MOBILE Return selection devolve um objeto JSON que contém a seleção atual de aTabela transformada em uma coleção de entidades Wakanda.

Este comando está destinado para ser chamado no contexto de uma conexão 4D Mobile, geralmente entre a aplicação 4D e uma aplicação Wakanda (via REST). Quando se estabelece uma conexão 4D Mobile e foram configurados os direitos de acesso adequados, uma aplicação Wakanda pode executar um método projeto 4D que devolve um valor no parâmetro $0.

O comando MOBILE Return selection lhe permite devolver em $0, a seleção atual de registros da tabela aTabela, na forma de um objeto tipo coleção de entidades em formato JSON. Este objeto é compatível com as coleções de entidades de Wakanda que contém uma seleção de registros (ou seja, de entidades).

Tenha em conta que os acessos 4D Mobile requerem configurações específicas em suas bases 4D:

O servidor Web deve estar em marcha,
A opção "Ativar os serviços 4D Mobile" se estiver selecionada nas Propriedades da base,
Deve ter uma licença válida,
As tabelas e campos utilizados devem ter selecionado a opção "Expose para 4D Mobile" (selecionada por padrão).
Os métodos chamados devem ter a opção "Disponível via as chamadas 4D Mobile" ativa (não selecionada por padrão).

Tenha em cuenta que pode passar toda tabela válida da base em aTabela e não necessariamente a tabela com a que o método projeto foi associado em suas propriedades. Este parâmetro só se utiliza do lado Wakanda para definir os objetos para os que se pode chamar ao método.

Para obter mais informação sobre a configuração 4D Mobile, consulte a documentação 4D Mobile.

Exemplo

Você deseja mostrar a seleção atual da tabela [Countries] em uma grade Wakanda, baseado em uma pesquisa.

Escreva o seguinte método:

  //FindCountries project method

  //FindCountries( string ) -> object

 

 C_TEXT($1)

 C_OBJECT($0)

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

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

a seleção devolvida pode ser utilizada diretamente em Wakanda como uma coleção válida.

No modelo do servidor de Wakanda conectado a 4D via 4D Mobile, você criou uma página com uma grade associada a tabela 4D Countries. Por padrão, durante a execução, se mostram todas as entidades da tabela 4D:

O código do botão é:

button1.click = function button1_click (event)
<p>    {
        sources.countries.FindCountries("i", {  /chamamos ao método 4D, "i" se passar em $1
                onSuccess:function(coll){  //função de retro chamada (assíncrona), recebe $0 como parâmetro
                    sources.countries.setEntityCollection(coll.result); //substitui a coleção de entidades atual
                                // com a que recebe no objeto coll.result
                }
            });        
    };

Como resultado, a grade se atualiza: