On Mobile App Action database method

4D v19.8


$1 -> On Mobile App Action database method -> Resultado

Parâmetro	Tipo	Descrição
$1	Objeto	Informação passada pela aplicação móvel
Resultado	Objeto	Estado da ação e sincronização de dados

Descrição

O On Mobile App Action database method se encarrega de administrar as ações requeridas pela aplicação móvel para uma sessão específica.

Nota: a aplicação móvel deve ter sido autenticada por On Mobile App Authentication database method.

4D chama a este método banco de dados quando uma aplicação móvel envia uma solicitação de ação.

Nota: para mais informação, consulte a documentação de 4D for iOS.

O método banco recebe a informação exigida da aplicação móvel no parâmetro $1 (objeto), e deve devolver o estado da ação no parâmetro $0 (objeto). Deve declarar e inicializar estes parâmetros da seguinte maneira:

  //Método base On Mobile App Action

 C_OBJECT($0;$1)

  // ...Código para o método

 $0:=New object //Não esqueça de criar o objeto a devolver

As propriedades abaixo são recebidas no parâmetro objeto $1:

Nome da propriedade	Tipo	Descrição
action		Texto	Nome de ação
session		Objeto	Informação da sessão
	id	Texto	Identificador de sessão
	ip	Texto	IP da sessão
application		Objeto	Informação da aplicação móvel
	id	Texto	ID da aplicação
userInfo		Texto	Informação usuário
context		Objeto	Parâmetros para a ação solicitada
	dataClass	Texto	Nome de dataclass 4D
	entity.primaryKey	Texto \| Inteiro longo	(opcional, devolvido se a ação estiver relacionada com uma selecção de entidades Chave primária da entidade
	entity.relationName	Texto	(opcional,Se devolve se a ação estiver relacionada com uma entidade relacionada. ) Nome da relação Muitos a Um
	parent.primaryKey	Texto \| inteiro longo	(opcional, chave primaria da entidade pai. Devolvida se a ação estiver relacionada com uma entidade associada. Chave primária da entidade pai
	parent.relationName	Texto	(opcional, devolvida se a ação estiver relacionada com uma entidade associada.) Nome da relação Um a Muitos
	parent.dataClass	Texto	(opcional) Nome da classe de dados 4D pai. Devolvida se a ação estiver relacionada com uma entidade associada) Nome da classe de dados 4D pai.

Depois de processar a informação, o método base deve devolver um objeto com as seguintes propriedades em $0:

Nome da propriedade	Tipo	Descrição
success	Booleano	True se a ação for processada corretamente, caso contrário False.
statusText	Texto	(Opcional) Mensagem a mostrar na aplicação móvel. Se success=true, mostra a mensagem; se success= false, pode usar para oferecer ao usuário uma explicação
dataSynchro	Booleano	True se a seleção de entidade ou da tabela necessitar ser atualizada, do contrário false. Se for True, a aplicação móvel ativará automaticamente uma sincronização de dados

Exemplo

  // On Mobile App Action

  // 2 ações são definidas: "done" e "postponeAll"

 

 C_OBJECT($0)

 C_OBJECT($1)

 

 C_OBJECT($o;$params;$request;$result)

 

 $request:=$1 //Informação fornecida pela app móvel

 $params:=$request.parameters

 

 Case of

 

    :($request.action="done")

       $o:=New object(\

       "dataClass";$params.dataClass;\

       "ID";$params.entity.primaryKey;\

       "CompletePercentage";100)

 

       $result:=modifyStatus($o) //chamada ao método projeto para modificar o estado da entidade

 

    :($request.action="postponeAll")

       $o:=New object("dataClass";$context.dataClass)

 

       $result:=postponeAll($o) //chamada ao método projeto para adiar todas as entidades de dataClass

 

    Else //Petição desconhecida

       $result:=New object("success";False)

 

 End case

 

 $0:=$result  //Informação devolvida pelo app móvel

Ver também

On Mobile App Authentication database method