EXECUTE ON CLIENT

EXECUTE ON CLIENT ( nomeCliente ; nomeMetodo {; param}{; param2 ; ... ; paramN} )

Parâmetro	Tipo		Descrição
nomeCliente	String	🡒	Nome da sessão 4D Client
nomeMetodo	String	🡒	Nome do método a ser executado
param	🡒	Parâmetro(s) do método

Descrição

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.

Exemplo 1

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

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

Exemplo 2

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

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

Exemplo 3

Consulte o exemplo do comando REGISTER CLIENT.

Variáveis e conjuntos do sistema

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

Execute on server
GET REGISTERED CLIENTS
REGISTER CLIENT
UNREGISTER CLIENT