<websocketClient variable>.Execute (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Communication / WebSocket

Execution contexts
Asynchronous operating mode

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<websocketClient variable>.Execute (Function)

In french: <Variable websocketClient>.Exécute

Executes a global procedure in the context of a client connected to the WebSocket server.

Example

// Récupère la liste des clients
tabClients is array of websocketClient = WebSocketListConnectedClient()
// Force l'appel de la procédure EnvoieInformations dans chacun des clients
sInformations is string = RécupèreInformations()
FOR EACH Client OF tabClients
	Client.Execute(EnvoieInformations)
	// EnvoieInformations est une procédure globale qui utilise la variable sInformations
END

Syntax

<Client>.Execute(<WLanguage procedure> [, <Parameters>])

<Client>: websocketClient variable

Name of the websocketClient variable corresponding to the client in which the procedure will be executed.

<WLanguage procedure>: Procedure name

Name of the global WLanguage procedure to be executed in the context of the client.

<Parameters>: List of values enclosed in brackets and separated by commas

Parameters of the procedure. This list of parameters has the following format:
(<Parameter 1>, ..., <Parameter N>)
where:
<Parameter 1> is the first parameter of the procedure.
...
<Parameter N> is the nth parameter of the procedure.
Caution:
Parameters are passed by value.
Only simple types are allowed: Boolean, integer, ... For example, it is not possible to have a parameter corresponding to an instance of class.

Remarks

Execution contexts

The global service of the WebSocket server and the connected clients are executed independently. Each is executed in its own context with:

its own copy of global variables.
its own database context.
etc.

Therefore, it is not possible to handle the global context or the context of another client.

<websocketClient variable>.Execute is used to execute the WLanguage procedure passed as parameter in the context of another client. During the execution of the procedure, the global variables will be those of the target client.

Asynchronous operating mode

Asynchronous operation: the function simply requests execution of the Procedure. The procedure can actually be executed later (after <websocketClient variable>.Execute has been executed). <websocketClient variable>.Execute never returns an error (for example, if the client has been disconnected in the meantime).

Business / UI classification: Business Logic

Component: wd300awws.dll