UserAliases Collection
| Crystal Enterprise User PlugIn Library
|
See Also
When you create a new Enterprise user, or when a member of a third-party group is mapped to the Enterprise system, an alias is automatically created for the user and added to the UserAliases collection. Use this collection to delete an alias, or to assign an available third-party alias to an existing user.
Each alias that is added to the collection can be used to log the user on to the Enterprise system. For example, a user may have both an Enterprise alias and a Windows NT alias that he or she can access the system with. If desired, the third-party NT alias can be re-assigned to a different user.
Depending on which options are enabled, when a third-party group is mapped to the system, the following will occur:
- If the SI_ALIAS_AUTOADD Property is set to True, then the third-party aliases are added to existing Enterprise users with the same name, or if a user with the same name does not exist, a new user is created. If the alias is deleted from the collection, and then the user tries to log on with it, the alias is re-created if the Enterprise user that it was previously mapped to still exists.
- If the SI_ALIAS_AUTOADD Property is set to False, then a new user is created for each third-party alias. If the alias is deleted, then the user is deleted; if the user then tries to log on with the third-party alias, then the alias is re-created as a new user.
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's alias given an index. Read-Only.
|
Methods
Method
| Description
|
Add Method
| Adds a new alias to the collection.
|
Delete Method
| Deletes an alias from the collection.
|