Description

mapp Services V5.16

This function can be used to add a new user group to the user management system. The rights for machine functions are assigned via input "AccessRights". Each function is an element of an array. The size of this array corresponds to the number of possible functions (up to 20). A right must be assigned for each function. Rights are defined using enumerator MpUserAccessRightEnum. The following table shows a possible user group:

Function	Recipe management	Process control	Alarm control	Process parameters	User management
Element of the array	0	1	2	3	4
Right	mpUSER_ACCESS_VIEW	mpUSER_ACCESS_ACTUATE	mpUSER_ACCESS_VIEW	mpUSER_ACCESS_VIEW	mpUSER_ACCESS_NONE

This table displays an array with five elements of type MpUserAccessRightEnum. A user group is created that is assigned various rights for the functions listed above. Which element applies to which function must be defined and can be displayed using a text group, for example.

The user group must be added to the initialization subroutine. When calling the function, all user group data will be overwritten if the user group already exists. The group index and group name must be specified correctly for this. If the group name and group index are new, then a new group is created using the specified data. As soon as the user group data has been changed once via the HMI application, the data in the initialization subroutine is no longer overwritten.

If a user group is created in the user management configuration in Automation Studio, then more than 20 rights can be defined. These will then not be visible using MpUserManagerUI. The MpUserMgrUIGroupInfoType and MpUserMgrUIGroupDlgType structures are limited to 20 rights. Regardless of this, the rights can be queried using MpUserAccessRight.