WebCenter Interaction API  
 

IPTUserGroup Members

IPTUserGroup overview

Public Instance Methods

public methodAddChildGroupsOverloaded. Adds the indicated groups to this group
public methodAddUsersOverloaded. Adds the indicated users to this group as static members.
public methodGetAuthenticationGroup Used when synchronizing with external usergroup repositories (e.g. LDAP.) Each external repository is associated with a unique group name, so that users and groups from different repositories don't have naming conflicts.
public methodGetAuthenticationSourceID Retrieves the authentication source ID for this group.
public methodGetDynamicMembershipRule 
public methodGetMappingAuthName Retrieves the Mapping Auth Name for the group. The Mapping Auth Name is used with groups that are synchronized from an external authentication source, and is specific to the Authentication Source Provider. It maps the group name used in ACL sync agents.
public methodGetUniqueAuthName Returns the unique name for this group in the authentication source from which the group was synced (e.g., the unique name for the group in LDAP).
public methodGrantActivityRights Grant the indicated activity rights to members of this group
public methodPreviewDynamicMembershipRule Returns an IPTQueryResult that shows what users match the given IPTFilter. This function does not update the dynamic members of this group. Because the search for matching users is done in real-time, this function may take some time to return related users.

NOTE: If this is a remote group, a PTException of type PT_RESULTCODES.PT_E_USERGROUP_IS_REMOTE will be thrown.

Returned properties include PT_PROPID_OBJECTID, PT_PROPID_NAME, PT_PROPID_DESCRIPTION, PT_PROPID_ISLOCALIZED, PT_PROPID_USER_UNIQUENAME, PT_PROPID_USER_LOGINNAME.
public methodQueryActivityRights Returns a QueryResult containing the activity rights granted to members of this group. This does NOT include any activity rights inherited from groups to which this group belongs.
public methodQueryAllActivityRights Similar to QueryActivityRights, but returns a QueryResult containing all properties for all activity rights granted to members of this group. This does NOT include any activity rights inherited from groups to which this group belongs.
public methodQueryAllInheritedActivityRights Similar to QueryInheritedActivityRights, but returns a QueryResult containing all properties for all activity rights granted to members of this group, including those that were obtained through groups that this group is a member of. This includes ALL activity rights granted to users, whether they are through THIS group, through PARENT groups, through parents of parents, etc.
public methodQueryDirectChildGroupsOverloaded. Returns an IPTQueryResult describing all groups in this group (excluding the groups that are in subgroups- this function returns ONLY the groups that are direct members of this group.) Returned properties include PT_PROPID_OBJECTID, PT_PROPID_NAME, PT_PROPID_ISLOCALIZED, PT_PROPID_USERGROUP_UNIQUENAME.
public methodQueryDirectChildGroupsCount Returns the number of groups that are direct members of this group. Does not include groups that are members of groups that are in turn members of this group, etc.
public methodQueryDirectParentGroups Returns a QueryResult describing the groups that directly contain this group. Does NOT include groups that contain this group indirectly, through a third group. Returned properties include PT_PROPID_OBJECTID, PT_PROPID_NAME, PT_PROPID_ISLOCALIZED.
public methodQueryFlattenedParentGroups Returns a QueryResult describing the groups that directly or indirectly contain this group. DOES include groups that contain this group indirectly, through a third group. Returned properties include PT_PROPID_OBJECTID, PT_PROPID_NAME, PT_PROPID_ISLOCALIZED.
public methodQueryInheritedActivityRights Returns a QueryResult containing the activity rights granted to members of this group, including those that were obtained through groups that this group is a member of. This includes ALL activity rights granted to users, whether they are through THIS group, through PARENT groups, through parents of parents, etc.
public methodQueryUsersOverloaded. Returns the direct user members of this group. Allows one to distinguish between dynamic and static memberships, or return both.

Returned properties include PT_PROPID_OBJECTID, PT_PROPID_NAME, PT_PROPID_DESCRIPTION, PT_PROPID_ISLOCALIZED, PT_PROPID_USER_UNIQUENAME, PT_PROPID_USER_LOGINNAME.
NOTE: providing a value of true for both bIncludeDynamicMembers and bIncludeStaticMembers will return all memberships for this group.
public methodQueryUsersCountOverloaded. Returns the number of users that are direct static members of this group. Does not include users that are members of groups that are in turn members of this group, etc.

This function only returns users that are static members. Use the QueryUsersCount(boolean, boolean) override to get dynamic memberships as well.
public methodRemoveAllUsers Removes all users from this group that have static memberships.
public methodRemoveChildGroupsOverloaded. Removes the indicated groups from this group
public methodRemoveUsersOverloaded. Removes the indicated users from this group as static members.
public methodRevokeActivityRights Revoke the indicated activity rights from members of this group
public methodSetAuthenticationGroup Used when synchronizing with external usergroup repositories (e.g. LDAP.) Each external repository is associated with a unique group name, so that users and groups from different repositories don't have naming conflicts.
public methodSetAuthenticationSourceID Sets the authentication source ID for this group. Cannot modify built-in groups.
public methodSetDynamicMembershipRule Sets the dynamic membership rule to be used for this group. Once set, the dynamic memberships rule will be assessed by the Dynamic Membership Update Agent periodically. To force an update of this group's dynamic memeberships, see UpdateDynamicMembers().

To clear all dynamic memberships for this group, set the rule to null and store the group. Finally, call UpdateDynamicMembers() to clear the dynamic memberships.
NOTE: If this is a remote group, a PTException of type PT_RESULTCODES.PT_E_USERGROUP_IS_REMOTE will be thrown.
public methodSetMappingAuthName Sets the Mapping Auth Name for the group. The Mapping Auth Name is used with groups that are synchronized from an external authentication source, and is specific to the Authentication Source Provider. It maps the group name used in ACL sync agents.
public methodSetUniqueAuthName Sets the unique name on the IPTUserGroup object. Used during authentication source synchronization.
public methodUpdateDynamicMembers Reconciles the dynamic members of this group with those that match the current dynamic membership rule. If users no longer match this rule, they will be removed as dynamic members. If they are also listed as static members, this membership will be maintained. New users that match the rule will become dynamic members. All changes are persisted to the database in real-time, no store is necessary after calling this function.

NOTE: A PTObjectLock should not be held against this object when calling this function. If a lock is a held, an Exception will be thrown.

NOTE: If this is a remote group, a PTException of type PT_RESULTCODES.PT_E_USERGROUP_IS_REMOTE will be thrown.

See Also

IPTUserGroup Interface | com.plumtree.server Namespace