SET GROUP ACCESS

SET GROUP ACCESS {( groups )}

Parameter	Type		Description
groups	Collection	→	Name of group(s) to which the 4D user account must belong during the session

Description

The SET GROUP ACCESS command modifies the memberships of the 4D user account for the current session. It resets any former group membership and sets the new memberships to the listed groups.

Notes:

• The scope of this command is the current session. Calling CHANGE CURRENT USER afterwards for example would reset defined memberships.
• This command can only be called from 4D remote or 4D single-user applications. It is not allowed on 4D Server.

Pass in the groups parameter a collection of existing group name(s) to which the 4D user account must belong (if a group name does not exist, it is ignored). If you pass an empty collection, the 4D user account will no longer belong to any group.

If you omit the groups parameter, the memberships of the 4D user account are reset to the group memberships stored on disk.

Note: When a group membership provides access to a "serialized" feature (e.g. a plug-in), a corresponding license is used and will remain attached to the 4D user account until the end of the session, even if the SET GROUP ACCESS command is called and group membership cancelled.

Example

You want to promote the current user to the "admin" and "plugins" groups for the session:

 $groups:=New collection("admin";"plugins")
 SET GROUP ACCESS($groups)

See also

Get group access
Get plugin access
SET PLUGIN ACCESS
SET USER ALIAS

Properties

Command number	1737
Thread safe	✓
Forbidden on the server