4D v16.3

EXECUTE ON CLIENT

Página Inicial

 
4D v16.3
EXECUTE ON CLIENT

EXECUTE ON CLIENT 


 

EXECUTE ON CLIENT ( nomeCliente ; nomeMetodo {; param}{; param2 ; ... ; paramN} ) 
Parâmetro Tipo   Descrição
nomeCliente  String in Nome da sessão 4D Client
nomeMetodo  String in Nome do método a ser executado
param  in Parâmetro(s) do método

O comando EXECUTE ON CLIENT é usado para forçar a execução do método nomeMetodo, com lo parâmetros param1... paramN, se necessário, no cliente 4D registrado de nome nomeCliente.. O nome registrado do cliente 4D é definido pelo comando REGISTER CLIENT

Este comando pode ser chamado desde um cliente 4D ou desde um procedimento armazenado em 4D Server.

Se o método requer um ou mais parâmetros, passe-os depois do nome do método. 

A execução do método no cliente 4D é efetuada num processo criado automaticamente na máquina cliente, e seu nome será o nome de registro de 4D Client.

Se este comando é chamado muitas vezes para o mesmo 4D Client, as ordens de execução serão empilhadas. Portanto, os métodos serão tratados um depois do outro em modo assíncrono. Quanto mais métodos estejam empilhados, maior será a carga de trabalho para o 4D Client. Agora você pode conhecer o estado da carga de trabalho de cada cliente utilizando o comando GET REGISTERED CLIENTS.

Nota: O empilhamento de ordens de execução não pode ser modificado ou detido, a não ser que o cliente 4D seja removido do registro com a ajuda do comando UNREGISTER CLIENT.

Pode executar simultaneamente o mesmo método em vários ou em todos os 4D Clients registrados. Para fazê-lo, utilize o caractere arroba (@) no parâmetro nomeCliente.

Vamos supor que você quer executar o método “GerarNums” na máquina cliente “Client1”:

 EXECUTE ON CLIENT("Client1";"GerarNums";12;$a;"Text")

Se você quiser que todos os clientes executem o método “VazioTemp”:

 EXECUTE ON CLIENT("@";"EmptyTemp")

Consulte o exemplo do comando REGISTER CLIENT.

A variável do sistema OK é igual a 1 se o 4D Server recebeu corretamente o pedido de execução de um método; contudo, isto não é garantia de que o método foi executado pelo 4D Client.



Ver também 

GET REGISTERED CLIENTS
REGISTER CLIENT
UNREGISTER CLIENT

 
PROPRIEDADES 

Produto: 4D
Tema: Processos
Número 651

Este comando modifica a variável sistema OKComportamento diferente em modo remoto

 
HISTÓRIA 

Criado por: 4D v6.5

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)