SEND MESSAGE TO REMOTE USER
SEND MESSAGE TO REMOTE USER ( message {; userSession} )
| Parameter | Type | Description | |
|---|---|---|---|
| message | Text | → | Text sent to user |
| userSession | Text | → | User's session ID |
Description
The SEND MESSAGE TO REMOTE USER command sends a message to all remote users or to a specific remote user.
In message, pass the text of the message to be displayed. It will be displayed as an alert or a notification on the screen of the session user(s).
The optional userSession parameter can be used to designate a specific user by passing their session ID. You can retrieve the session ID with the Process activity command. If userSession is omitted, the message is sent to all users.
Note: This command can only be executed on 4D Server. If the method calling the command is executed locally on a remote client or on 4D single user, SEND MESSAGE TO REMOTE USER does nothing.
Example
You want to send a message to all users, then send a message to a specific user:
// Method to be executed on server
var $message : Text
var $element : Object
var $userCol : Collection
// retrieve session information
$userCol:=(Get process activity(Sessions only)).sessions
// send message to all users
$message:="A maintenance operation is scheduled for 10pm. The server will be restarted. Please log out before 10pm."
SEND MESSAGE TO REMOTE USER($message)
// send message to a single user, "Vanessa"
$message:="Hello Vanessa"
$userCol:=Get process activity(Sessions only).sessions.query("systemUserName = :1";"Vanessa")
For each($element;$userCol)
SEND MESSAGE TO REMOTE USER($message;$element.ID)
End for each