4D v16.3

EXECUTER SUR CLIENT

Accueil

 
4D v16.3
EXECUTER SUR CLIENT

EXECUTER SUR CLIENT 


 

EXECUTER SUR CLIENT ( nomClient ; nomMéthode {; param}{; param2 ; ... ; paramN} ) 
Paramètre Type   Description
nomClient  Chaîne in Nom d’inscription du 4D Client
nomMéthode  Chaîne in Nom de la méthode à exécuter
param  in Paramètre(s) de la méthode

La commande EXECUTER SUR CLIENT provoque l’exécution de la méthode nomMéthode, avec, éventuellement, le(s) paramètre(s) param1... paramN, sur le ou les 4D Client inscrit(s) sous le nom nomClient. Le nom d’inscription du ou des 4D Client est défini par la commande INSCRIRE CLIENT.

Cette commande peut être appelée depuis un 4D Client ou une procédure stockée sur 4D Server.
Si la méthode admet des paramètres, passez-les après le nom de la méthode.

L’exécution de la méthode sur le 4D Client s’effectue dans un process créé automatiquement sur le poste client, et portant le nom d’inscription du 4D Client.

Si cette commande est appelée plusieurs fois de suite pour un même 4D Client, les ordres d’exécution seront empilés. Par conséquent, les méthodes seront traitées les unes à la suite des autres : les exécutions sont asynchrones. Plus l’empilement est grand, plus la “charge de travail” est grande pour le 4D Client. Vous pouvez connaître l’état de la charge de travail de chaque client à l’aide de la commande LIRE CLIENTS INSCRITS.

Note : L’empilement des ordres d’exécutions ne peut être modifié ou stoppé, sauf si le 4D Client est désinscrit à l’aide de la commande DESINSCRIRE CLIENT.

Il est possible d’exécuter simultanément la même méthode sur plusieurs ou sur la totalité des 4D Clients inscrits : pour cela, passez le caractère joker (@) dans le paramètre nomClient.

Vous souhaitez exécuter sur le poste client “Client1” la méthode “GénéreNums”, comportant trois paramètres :

 EXECUTER SUR CLIENT("Client1";"GénéreNums";12;$a;"Text")

Vous souhaitez que tous les clients inscrits exécutent la méthode “VideTemp” :

 EXECUTER SUR CLIENT("@";"VideTemp")

Reportez-vous à l’exemple de la commande INSCRIRE CLIENT.

La variable système OK prend la valeur 1 si 4D Server a correctement reçu la requête d’exécution d’une méthode — cela ne garantit pas toutefois la bonne exécution de la méthode sur le 4D Client.



Voir aussi  

DESINSCRIRE CLIENT
INSCRIRE CLIENT
LIRE CLIENTS INSCRITS

 
PROPRIÉTÉS 

Produit : 4D
Thème : Process
Numéro : 651
Nom intl. : EXECUTE ON CLIENT

Cette commande modifie la variable système OKComportement différent en mode distant

 
HISTORIQUE 

Créé : 4D v6.5

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v16)
4D - Langage ( 4D v16.1)
4D - Langage ( 4D v16.2)
4D - Langage ( 4D v16.3)