Este é o site histórico da documentação 4D. As documentações estão sendo movidas progressivamente para developer.4d.com |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
4D v20 R7
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 | ||||||
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.
Execute on server
GET REGISTERED CLIENTS
REGISTER CLIENT
UNREGISTER CLIENT
Produto: 4D
Tema: Processos
Número
651
Criado por: 4D v6.5
Manual de linguagem 4D ( 4D v20 R7)