A user group alias is another name for a group—one that never changes, even if the group name does. When you create a new Enterprise group, or map a third-party group to the system, a user group alias is automatically added to the group's UserGroupAliases collection.

When you map a third-party group to the system, you can do one of two things: you can use one of the third-party Authentication plugins to create a new group (for which a group name and alias are automatically generated), or you can use the UserGroupAliases collection's Add Method to add a third-party user group alias to an existing Enterprise group, and then update the appropriate authentication plugin so that the members of the third-party group are added to the system. You cannot use a third-party authentication plugin to create a new group, and then re-assign the user group alias to an existing group.

Note:    You must have modify rights to use this collection. You can apply modify rights either by setting the role or by adding the security rights.

For a more comprehensive overview of the object security model used by Crystal Enterprise, see the Crystal Enterprise Administrator's Guide. See the "Appendix A: Object Rights and Access Levels" in the Crystal Enterprise Administrator's Guide for a list of the granular rights granted for each role.

Properties

Property	Description
Count Property	Indicates the number of items in the collection. Read-Only.
Item Property	Returns a user group's alias given an index. Read-Only.

Methods

Method	Description
Add Method	Adds a new user group alias to the collection.
Delete Method	Deletes an alias from the collection.