EXECUTE ON CLIENT
EXECUTE ON CLIENT ( nomeCliente ; nomeMetodo {; param}{; param2 ; ... ; paramN} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| nomeCliente | Text | → | Nome da sessão 4D Client |
| nomeMetodo | Text | → | 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
Propriedades
| Número do comando | 651 |
| Thread-seguro | ✗ |
| Modificar variáveis | OK |