public interface GroupService extends ContextSensitiveSingletonService
username
starts with "m" are
members.
Every group can have at most one parent, as long as it is not recursive.
That is A cannot be a parent of B, B a parent of C and C a parent of A.
When a child group is created, it is automatically added as a member of
the parent group. However, the parent group can have many member groups
that do not have it as the parent group.
There are three different membership policies: open, exclusive and closed.
Open means that anyone can join. Exclusive means users can request to be
added by the administrator. Closed means administrators can add.
There are two viewing policies: high and low. High means that only
administrators can see members, while low means members can see each
other.
"My Groups" is bookmark for a user's frequently used groups, so that these
groups can be accessed quickly.
Delegated creation means that a user is granted permission by the group
Administrator to create groups with the delegated group as parent.CONFIGURE_METHOD_NAME
Modifier and Type | Method and Description |
---|---|
void |
addAdminGroups(java.lang.Long[] adminGroupIds_,
java.lang.Long groupId_)
Adds the given groups as administrator groups for group given by
groupId_ |
void |
addAdminUsers(java.lang.String[] usernames_,
java.lang.Long groupId_)
Adds the users by given username's as administrators of group given by
groupId_ |
void |
addGroupsToMyGroups(java.lang.Long[] groupIds_)
Adds a list of groups to My Groups for logged in user.
|
void |
addGroupToFavorites(java.lang.Long groupId_)
Associates
Group as one of the current User 's favorites |
void |
addMemberGroup(java.lang.Long memgroupId_,
java.lang.Long groupId_)
Adds a member group to a group.
|
void |
addMemberGroups(java.lang.Long[] memgroupIds_,
java.lang.Long groupId_)
Adds member groups to a group
|
void |
addMemberUser(java.lang.String username_,
java.lang.Long groupId_)
Adds a member user to a group .
|
void |
addMemberUsers(java.lang.String[] usernames_,
java.lang.Long groupId_)
Adds member users to a group
|
void |
addMyselfToGroup(java.lang.Long groupId_)
Adds oneself to the given group
|
boolean[] |
areGroupsAddedByRule(java.lang.Long groupId_,
java.lang.Long[] groupIds_)
Checks to see if the given groups were added to the group by a rule.
|
boolean[] |
areUsersAddedByRule(java.lang.Long groupId_,
java.lang.String[] userIds_)
Checks to see if the given users where added to the group by a rule.
|
boolean[][] |
areUsersMembersOfGroups(java.lang.String[] usernames,
java.lang.Long[] groupIds)
Determines if the specified user is a member of each of the specified groups.
|
boolean[][] |
areUsersMembersOfGroups(java.lang.String[] usernames,
java.lang.String[] groupUuid_)
Determines if the specified user is a member of each of the specified groups.
|
boolean |
canUseGroupName(java.lang.String groupName_,
java.lang.Long groupSecurityType_)
Indicates whether a user can create a new group with the
given name of the given group security type.
|
void |
changeGroupTypeOfGroup(java.lang.Long groupId,
java.lang.Long newGroupTypeId)
Changes the GroupType of a Group.
|
java.lang.Integer[] |
changeGroupTypesOfGroups(java.lang.Long[] groupIds,
java.lang.Long[] newGroupTypeIds)
Changes the GroupTypes of Groups.
|
java.lang.Long |
createGroup(Group group_)
Create a new group.
|
java.lang.Long[] |
createGroups(Group[] groups_)
Create new groups.
|
void |
deleteGroup(java.lang.Long groupId_)
Deletes a single group.
|
boolean |
doesGroupExist(java.lang.Long groupId_)
Checks to see if a given group exists.
|
Group[] |
findAdminGroups(GroupSearch groupSearch_,
boolean caseSensitive_)
|
ResultPage |
findAdminGroupsPaging(GroupSearch groupSearch_,
boolean caseSensitive_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Finds all groups of which you are administrator and which also
match the given search criteria.
|
Group[] |
findAvailableParentGroups(GroupSearch groupSearch_,
boolean caseSensitive_,
java.lang.Long groupId_)
|
ResultPage |
findAvailableParentGroupsPaging(GroupSearch groupSearch_,
boolean caseSensitive_,
java.lang.Long groupId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets a ResultPage containing a list of all groups
available for setting as parent.
|
Group[] |
findGroups(GroupSearch groupSearch_,
boolean caseSensitive_)
|
ResultPage |
findGroupsPaging(GroupSearch groupSearch_,
boolean caseSensitive_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Finds groups based on criteria submitted in the
GroupSearch
The supported search operators are specified in GroupSearch for a
group
See getOperatorsForAttributeType() in
GroupTypeService to obtain a list of possible operators
Operator for a given data type. |
Group[] |
findNonMemberAncestorGroups(GroupSearch groupSearch_,
boolean caseSensitive_,
java.lang.Long groupId_)
|
ResultPage |
findNonMemberAncestorGroupsPaging(GroupSearch groupSearch_,
boolean caseSensitive_,
java.lang.Long groupId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Retrieves a
ResultPage of list of groups for a
group search that are not ancestors (by parent-member relationship) of the
given group. |
int |
getAdminGroupCount(java.lang.Long groupId_)
Gets the number of distinct groups {that are administrators of
the specified group.
|
ResultPage |
getAdminGroupsPaging(java.lang.Long groupId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Retrieves the groups that are administrator groups for the given
groupId_ |
int |
getAdminUserCount(java.lang.Long groupId_)
Gets a count of distinct users that are administrators of the
specified group.
|
ResultPage |
getAdminUsersDirectPaging(java.lang.Long groupId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets a ResultPage containing a list of distinct users
that are direct admins of the specified
group ie user admins of subgroups are not included.
|
ResultPage |
getAdminUsersPaging(java.lang.Long groupId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Retrieves the users that are administrator users for the given
groupId_ |
AttributeType[] |
getAllAttributeTypes()
Gets the list of group attribute types in the system
|
java.lang.String |
getApplicationName()
Gets the name of the application on which this service is running.
|
Credentials |
getCachedCredentials()
Returns the cached Credentials bean containing the group
membership relations for the user in this Service Context.
|
Credentials |
getCredentials()
Returns a Credentials bean directly from the back-end,
containing the group membership relations for the user
in this Service Context.
|
java.lang.Long[] |
getDirectAdminGroupIds(java.lang.Long groupId)
Gets the group IDs of all the administrator groups added directly to a given group
(excludes those who are administrators via membership in an administrator group)
|
java.lang.String[] |
getDirectAdminUsernames(java.lang.Long groupId)
Gets the usernames of all the administrator users added directly to a given group
(excludes those who are administrators via membership in an administrator group)
|
java.lang.Long[] |
getDirectMemberGroupIds(java.lang.Long groupId)
Gets the group IDs of all the member groups added directly to a given group
(excludes those who are members via rule or via membership in a member group)
|
java.lang.String[] |
getDirectMemberUsernames(java.lang.Long groupId)
Gets the usernames of all the member users added directly to a given group
(excludes those who are members via rule or via membership in a member group)
|
ResultPage |
getFavoriteGroups(int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets a ResultPage containing a list of groups
for the current user's Favorite Groups.
|
java.lang.String |
getGlobalHomePage()
Gets the global home page for the application.
|
Group |
getGroup(java.lang.Long groupId_)
Get a group by id.
|
java.lang.Boolean[] |
getGroupActions(java.lang.Long groupId_,
java.lang.Integer[] actionIds_)
Gets s Boolean array, representing whether actions with the given ids can
be performed on a given group by the current user
|
Attribute |
getGroupAttribute(java.lang.Long groupId_,
java.lang.String attributeName_)
Gets a group attribute for a given group id.
|
java.lang.Long[] |
getGroupIdsForUserByRole(java.lang.String username_,
java.lang.Integer role_)
Gets a list of group ids for which a given user has a given role.
|
java.lang.Long[][] |
getGroupIdsForUserByRoles(java.lang.String username_,
java.lang.Integer[] roles_)
Gets the group Ids for which the specified user
has any of the specified roles
|
GroupMemberPolicy[] |
getGroupMembershipPolicyTypes(java.lang.Long groupSecurityTypeId_)
Gets the list of group membership policy types
for a particular group security type.
|
GroupMemberViewingPolicy[] |
getGroupMemberViewingPolicyTypes(java.lang.Long groupSecurityTypeId_)
Gets the list of group member viewing policies
for a particular group security type.
|
java.lang.String |
getGroupName(java.lang.Long groupId_)
Gets a group name for a given group id.
|
java.lang.String[] |
getGroupNames(java.lang.Long[] groupIds_)
Gets a list of group names for a given list of group ids.
|
ResultList |
getGroupNamesList(java.lang.Long[] groupIds_)
Gets a list of group names for a given list of group ids.
|
Group[] |
getGroups(java.lang.Long[] groupIds_)
Gets a list of groups for a given list of group ids.
|
GroupSecurityType[] |
getGroupSecurityTypes(java.lang.Integer actionId_)
Gets the list of group security types that are available
for a particular action.
|
Group[] |
getGroupsForUserByRole(java.lang.String username_,
java.lang.Integer role_)
Gets a list of groups for which a given user has a given role.
|
ResultPage |
getGroupsForUserByRolePaging(java.lang.String username_,
java.lang.Integer role_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets a ResultPage containing list of groups for which a given user has a
given role.
|
Group[] |
getGroupsForUserByRoles(java.lang.String username_,
java.lang.Integer[] roles_)
Deprecated.
|
ResultPage |
getGroupsForUserByRolesPaging(java.lang.String username_,
java.lang.Integer[] roles_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Retrieves a ResultPage containing the list of groups for which the given
user has any of the given roles.
|
ResultList |
getGroupsList(java.lang.Long[] groupIds_)
Returns a ResultList
ResultList containing error codes for all
Ids and Group s for valid Ids |
Group[] |
getGroupsOfType(java.lang.Long groupTypeId_)
Deprecated.
|
Group[] |
getGroupsOfTypeForMemberUser(java.lang.Long[] groupTypeIds_,
java.lang.String username_)
Deprecated.
Use
getGroupsForUserByRolePaging(String, Integer, int, int, Integer, Integer) and
extract groups of the desired types from the results. |
ResultPage |
getGroupsOfTypePaging(java.lang.Long groupTypeId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets a ResultPage containing a list of groups for a given group type
|
GroupSummary[] |
getGroupSummaryForUser(java.lang.String username_)
Deprecated.
|
ResultPage |
getGroupSummaryForUserPaging(java.lang.String username_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Retrieves
GroupSummary beans for every group for which the given
User is a member or administrator. |
java.lang.Long[] |
getGroupTypeForGroup(java.lang.Long[] groupIds_)
Gets group types for a list of groups.
|
int |
getMemberGroupCount(java.lang.Long groupId_)
Gets the number of distinct groups {that are members of
the specified group.
|
Group[] |
getMemberGroups(java.lang.Long groupId_)
Gets a list of members groups of a group
|
Group[] |
getMemberGroupsDirect(java.lang.Long groupId_)
Gets group members of a group that are explicitly defined,
no cascading (group members of subgroups are not included)
|
ResultPage |
getMemberGroupsDirectPaging(java.lang.Long groupId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets a ResultPage containing a list of groups that
are direct members, i.e. group members of subgroups are not included in
the result set.
|
ResultPage |
getMemberGroupsPaging(java.lang.Long groupId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets a ResultPage containing a list of group members of a group
|
int |
getMemberUserCount(java.lang.Long groupId_)
Gets a count of distinct users that are members of the
specified group.
|
java.lang.String[] |
getMemberUsernames(java.lang.Long groupId_)
Gets the usernames of all the member users for given
group
|
java.lang.String[] |
getMemberUsernamesDirect(java.lang.Long groupId_)
Deprecated.
|
User[] |
getMemberUsers(java.lang.Long groupId_)
Gets a list of member users of the specified group
|
User[] |
getMemberUsers(java.lang.Long[] groupIds_)
Gets a list of distinct users that are members of any of the specified
groups.
|
User[] |
getMemberUsersDirect(java.lang.Long groupId_)
Deprecated.
|
ResultPage |
getMemberUsersDirectPaging(java.lang.Long groupId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets a ResultPage containing a list of distinct users
that are direct members of the specified group i.e user members of
subgroups are not included.
|
ResultPage |
getMemberUsersPaging(java.lang.Long groupId_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets a ResultPage containing a list of member users of the specified group
|
java.lang.Long[] |
getMyGroupIds()
Gets Ids for logged-in user's My Groups.
|
ResultPage |
getMyGroups(int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Deprecated.
use getFavoriteGroups
|
java.lang.String |
getMyHomePage()
Gets the home page for the current user if he has set one, otherwise
returns the global home page.
|
Group[] |
getParentGroupsForDelegatedCreation()
Gets the groups for which the logged-in user is authorized to
set as a parent when creating public child groups.
|
ResultPage |
getParentGroupsForDelegatedCreationPaging(int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets a ResultPage of parent groups for
which the logged-in user is authorized to create public
child groups.
|
Group[] |
getParentGroupsForDelegatedUpdate(java.lang.Long groupId_)
Gets the groups for which the logged-in user is authorized to
set as parent when updating public child groups.
|
Tree[] |
getRootTrees(java.lang.Long groupTypeId_,
java.lang.String relationshipType_,
boolean singleGroupType_,
int descendentDepth_)
Get a set of groups structured into one or more trees.
|
Tree[] |
getRootTrees(java.lang.Long groupTypeId_,
java.lang.String relationshipType_,
java.lang.Long[] groupTypeIds_,
int descendentDepth_)
Get a set of groups structured into one or more trees
|
Tree[] |
getRootTreesSameTypeWithRoles(java.lang.Long groupTypeId_,
java.lang.Integer[] roleTypes_,
int descendantDepth_)
|
RuleSet |
getRuleSetForGroup(java.lang.Long groupId_)
Gets membership rule set for a Group
|
java.lang.Long |
getSystemDefaultApplication()
Deprecated.
Use
ApplicationService.getDefaultApplication() |
GroupHierarchyBean[] |
getTopLevelGroupsForHierarchy(java.lang.Long groupTypeId_,
boolean sameType_) |
ResultPage |
getTopLevelGroupsForHierarchyPaging(java.lang.Long groupTypeId_,
boolean sameType_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Gets all top level
GroupHierarchyBean objects (
Group s without a parent group) given the
Group type. |
ResultPage |
getTopLevelGroupsPaging(java.lang.Long groupTypeId_,
java.lang.String relationshipType_,
boolean singleGroupType_,
int startIndex_,
int batchSize_,
java.lang.Integer sortProperty_,
java.lang.Integer sortOrder_)
Get a ResultPage containing a list of groups structured into one or
more trees in the
result field. |
TreePivot |
getTreeViewForGroup(java.lang.Long groupId_,
boolean singleGroupType_,
java.lang.String relationshipType_,
int descendentDepth_)
Get a view into the tree pivoted at a particular group.
|
TreePivot |
getTreeViewForGroup(java.lang.Long groupId_,
java.lang.Long[] groupTypeIds_,
java.lang.String relationshipType_,
int descendentDepth_)
Get a view into the tree pivoted at a particular group
Each node in the tree will represent a group.
|
TreePivot |
getTreeViewForGroupSameTypeWithRoles(java.lang.Long groupId_,
java.lang.Integer[] roleTypes_,
int descendantDepth_)
Get a view into the tree pivoted at a particular group
Each node in the tree will represent a group.
|
java.lang.Long |
getUserDefaultApplication(java.lang.String username)
Deprecated.
Use
ApplicationService.getDefaultApplication() for the site-wide default. |
java.lang.String[] |
getWorkspace()
Gets the current memory profile for the workspace.
|
boolean |
isGroupDescendant(java.lang.Long groupId_,
java.lang.Long parentGroupId_)
Checks if a group is a descendant of another group
(by parent-child relationship).
|
boolean |
isGroupSystemGroup(java.lang.Long groupId_)
Checks to see if a given group is a system group.
|
boolean[] |
isMemberOfGroups(java.lang.Long[] groupId_)
Determines if the current user is a member of each of the specified groups.
|
boolean[] |
isMemberOfGroups(java.lang.String[] groupUuid_)
Determines if the current user is a member of each of the specified groups.
|
boolean |
isUserMember(java.lang.String[] username_,
java.lang.Long groupId_)
Checks multiple potential usernames to determine if a user is a member of a group
|
boolean |
isUserMember(java.lang.String[] username_,
java.lang.String groupUuid_)
Checks multiple potential usernames to determine if a user is a member of a group
|
boolean |
isUserMember(java.lang.String username_,
java.lang.Long groupId_)
Checks if a user is a member of a group
|
boolean |
isUserMember(java.lang.String username_,
java.lang.String groupUuid_)
Checks if a user is a member of a group
|
boolean[] |
isUserMemberOfGroups(java.lang.String[] usernames,
java.lang.Long[] groupId_)
Determines if the specified user is a member of each of the specified groups.
|
boolean[] |
isUserMemberOfGroups(java.lang.String[] usernames,
java.lang.String[] groupUuid_)
Determines if the specified user is a member of each of the specified groups.
|
boolean[] |
isUserMemberOfGroups(java.lang.String username_,
java.lang.Long[] groupId_)
Determines if the specified user is a member of each of the specified groups.
|
boolean[] |
isUserMemberOfGroups(java.lang.String username_,
java.lang.String[] groupUuid_)
Determines if the specified user is a member of each of the specified groups.
|
void |
removeAdminGroups(java.lang.Long[] adminGroupIds_,
java.lang.Long groupId_)
Removes the groups specified by adminGroupIds_ as administrators of group
|
void |
removeAdminUsers(java.lang.String[] usernames_,
java.lang.Long groupId_)
Removes the users specified by
usernames_ as administrators
of group |
void |
removeGroupFromFavorites(java.lang.Long groupId_)
removes this group (groupId_) as one of the current user's favorites
|
void |
removeGroupsFromMyGroups(java.lang.Long[] groupIds_)
Removes a list of groups from My Groups for logged-in user.
|
void |
removeMemberGroup(java.lang.Long memgroupId_,
java.lang.Long groupId_)
Removes a member group from a group
|
void |
removeMemberGroups(java.lang.Long[] memgroupIds_,
java.lang.Long groupId_)
Removes a list of member groups from a group
|
void |
removeMemberUser(java.lang.String username_,
java.lang.Long groupId_)
Deprecated.
Use
removeMemberUsers(String[], Long) and
pass a single user in the array. |
void |
removeMemberUsers(java.lang.String[] usernames_,
java.lang.Long groupId_)
Removes a list of member users from a group
|
void |
removeMyselfFromGroup(java.lang.Long groupId_)
Removes oneself from the given group
|
ResolvedEmailAddresses |
resolveEmailAddress(LocalObject emailRecipient_)
|
ResolvedEmailAddresses |
resolveEmailAddresses(LocalObject[] emailRecipients_)
|
ResolvedEmailAddresses[] |
resolveEmailDestinations(LocalObject[] to_,
LocalObject[] cc_,
LocalObject[] bcc_)
Resolves three sets of email recipients, which form the email destination, into email
addresses.
|
void |
setGlobalHomePage(java.lang.String url)
Sets home page for all users (default).
|
void |
setHomePageForUser(java.lang.String username_,
java.lang.String url_) |
void |
setMyHomePage(java.lang.String url)
Sets home page for current user, overriding the system default for
this user.
|
java.lang.String |
suggest(java.lang.String query,
int maxItems,
SuggestParam[] params,
java.lang.Boolean groupResults) |
java.lang.String |
suggest(java.lang.String query,
int maxItems,
SuggestParam[] params,
java.lang.Boolean groupResults,
java.lang.Long[] allowList) |
java.lang.String |
suggestGroups(java.lang.String query_,
int maxSuggestions_)
Deprecated.
use
suggest(String, int, SuggestParam[], Boolean) instead |
Suggestion[][] |
suggestGroupsBulk(java.lang.String[] queries_,
int maxSuggestionsPerQuery_)
Deprecated.
use
suggest(String, int, SuggestParam[], Boolean) instead |
java.lang.String |
suggestUsersAndGroups(java.lang.String query_,
int maxSuggestions_)
Deprecated.
use
suggest(String, int, SuggestParam[], Boolean) instead |
Suggestion[][] |
suggestUsersAndGroupsBulk(java.lang.String[] queries_,
int maxSuggestionsPerQuery_)
Deprecated.
use
suggest(String, int, SuggestParam[], Boolean) instead |
void |
updateGroup(Group group_)
Updates a
Group . |
void |
updateGroups(Group[] groups_)
Updates multiple
Group objects. |
void |
updateRuleSetForGroup(RuleSet ruleSet_)
Updates the membership rule set for a
Group . |
boolean |
validateTypedValues(TypedValue[] typedValues)
Validates given TypedValues.
|
configureContextSensitiveSingletonService
static final java.lang.Integer USER_ROLE_SUPERADMIN
static final java.lang.Integer USER_ROLE_CREATOR
static final java.lang.Integer USER_ROLE_ADMINISTRATOR
static final java.lang.Integer USER_ROLE_VIEWER
static final java.lang.Integer USER_ROLE_MEMBER
static final java.lang.Integer USER_ROLE_NONMEMBER
static final java.lang.String RELATIONSHIP_TYPE_HEIRARCHY
static final java.lang.Integer ACTION_GROUP_DELETE_GROUP
static final java.lang.Integer ACTION_GROUP_EDIT_GROUP_ATTRIBUTES
static final java.lang.Integer ACTION_GROUP_ADD_GROUP_MEMBERS
static final java.lang.Integer ACTION_GROUP_DELETE_GROUP_MEMBERS
static final java.lang.Integer ACTION_GROUP_ADD_GROUP_RULES
static final java.lang.Integer ACTION_GROUP_DELETE_GROUP_RULES
static final java.lang.Integer ACTION_GROUP_VIEW_GROUP_EXISTENCE
static final java.lang.Integer ACTION_GROUP_VIEW_GROUP_ATTRIBUTES
static final java.lang.Integer ACTION_GROUP_VIEW_GROUP_MEMBERS
static final java.lang.Integer ACTION_GROUP_VIEW_GROUP_RULES
static final java.lang.Integer ACTION_GROUP_ADD_SELF_TO_GROUP
static final java.lang.Integer ACTION_GROUP_REMOVE_SELF_FROM_GROUP
static final java.lang.Integer ACTION_GROUP_UPDATE_DELEGATED_ADMINISTRATION
static final java.lang.Integer ACTION_GROUP_USE_GROUP_AS_DELEGATED_PARENT
static final java.lang.Integer GROUP_TYPE_CHANGE_SUCCESS
static final java.lang.Integer GROUP_TYPE_CHANGE_NO_PRIVILEGE
static final java.lang.Integer GROUP_TYPE_CHANGE_INVALID_GROUP
static final java.lang.Integer GROUP_TYPE_CHANGE_INVALID_GROUPTYPE
static final boolean createGroup$UPDATES
static final boolean createGroups$UPDATES
static final boolean updateGroup$UPDATES
static final boolean updateGroups$UPDATES
static final boolean deleteGroup$UPDATES
static final boolean getGroupName$UPDATES
static final boolean getGroupNames$UPDATES
static final boolean getGroupNamesList$UPDATES
static final boolean getGroupAttribute$UPDATES
static final boolean getGroup$UPDATES
static final boolean getGroups$UPDATES
static final boolean getCredentials$UPDATES
static final boolean getCachedCredentials$UPDATES
static final boolean getGroupsOfType$UPDATES
static final boolean getGroupsOfTypePaging$UPDATES
static final boolean getGroupTypeForGroup$UPDATES
static final boolean getGroupIdsForUserByRole$UPDATES
static final boolean getGroupsForUserByRole$UPDATES
static final boolean getGroupsForUserByRolePaging$UPDATES
static final boolean getGroupsOfTypeForMemberUser$UPDATES
static final boolean getMemberGroups$UPDATES
static final boolean getMemberGroupsPaging$UPDATES
static final boolean getMemberUsers$UPDATES
static final boolean getMemberUsersPaging$UPDATES
static final boolean getMemberUserCount$UPDATES
static final boolean getMemberGroupCount$UPDATES
static final boolean addMemberGroup$UPDATES
static final boolean addMemberGroups$UPDATES
static final boolean addMemberUser$UPDATES
static final boolean addMemberUsers$UPDATES
static final boolean addMyselfToGroup$UPDATES
static final boolean removeMemberGroup$UPDATES
static final boolean removeMemberGroups$UPDATES
static final boolean removeMemberUser$UPDATES
static final boolean removeMemberUsers$UPDATES
static final boolean removeMyselfFromGroup$UPDATES
static final boolean findGroups$UPDATES
static final boolean isGroupDescendant$UPDATES
static final boolean isUserMember$UPDATES
static final boolean getRootTrees$UPDATES
static final boolean getRootTreesSameTypeWithRoles$UPDATES
static final boolean getTopLevelGroupsPaging$UPDATES
static final boolean getTreeViewForGroup$UPDATES
static final boolean getTreeViewForGroupSameTypeWithRoles$UPDATES
static final boolean doesGroupExist$UPDATES
static final boolean addGroupsToMyGroups$UPDATES
static final boolean removeGroupsFromMyGroups$UPDATES
static final boolean getMyGroupIds$UPDATES
static final boolean getMyGroups$UPDATES
static final boolean getGroupSecurityTypes$UPDATES
static final boolean getGroupMembershipPolicyTypes$UPDATES
static final boolean getGroupMemberViewingPolicyTypes$UPDATES
static final boolean getAllAttributeTypes$UPDATES
static final boolean findNonMemberAncestorGroups$UPDATES
static final boolean findAvailableParentGroups$UPDATES
static final boolean findAdminGroups$UPDATES
static final boolean getRuleSetForGroup$UPDATES
static final boolean updateRuleSetForGroup$UPDATES
static final boolean getGroupSummaryForUser$UPDATES
static final boolean getGroupSummaryForUserPaging$UPDATES
static final boolean isGroupSystemGroup$UPDATES
static final boolean getGroupsForUserByRoles$UPDATES
static final boolean getGroupsForUserByRolesPaging$UPDATES
static final boolean getGroupActions$UPDATES
static final boolean canUseGroupName$UPDATES
static final boolean getParentGroupsForDelegatedCreation$UPDATES
static final boolean getParentGroupsForDelegatedUpdate$UPDATES
static final boolean getParentGroupsForDelegatedCreationPaging$UPDATES
static final boolean findGroupsPaging$UPDATES
static final boolean findNonMemberAncestorGroupsPaging$UPDATES
static final boolean findAvailableParentGroupsPaging$UPDATES
static final boolean findAdminGroupsPaging$UPDATES
static final boolean getApplicationName$UPDATES
static final boolean getWorkspace$UPDATES
static final boolean getMemberUsernames$UPDATES
static final boolean getGroupIdsForUserByRoles$UPDATES
static final boolean getGroupsList$UPDATES
static final boolean getMemberGroupsDirect$UPDATES
static final boolean getMemberGroupsDirectPaging$UPDATES
static final boolean getMemberUsersDirect$UPDATES
static final boolean getMemberUsersDirectPaging$UPDATES
static final boolean getAdminUsersDirectPaging$UPDATES
static final boolean getMemberUsernamesDirect$UPDATES
static final boolean getTopLevelGroupsForHierarchy$UPDATES
static final boolean getTopLevelGroupsForHierarchyPaging$UPDATES
static final boolean areUsersAddedByRule$UPDATES
static final boolean areGroupsAddedByRule$UPDATES
static final boolean suggestGroups$UPDATES
static final boolean suggestUsersAndGroups$UPDATES
static final boolean suggestGroupsBulk$UPDATES
static final boolean suggestUsersAndGroupsBulk$UPDATES
static final boolean getUserDefaultApplication$UPDATES
static final boolean getSystemDefaultApplication$UPDATES
static final boolean getMyHomePage$UPDATES
static final boolean setGlobalHomePage$UPDATES
static final boolean setHomePageForUser$UPDATES
static final boolean setMyHomePage$UPDATES
static final boolean getGlobalHomePage$UPDATES
static final boolean addGroupToFavorites$UPDATES
static final boolean removeGroupFromFavorites$UPDATES
static final boolean getFavoriteGroups$UPDATES
static final boolean addAdminUsers$UPDATES
static final boolean removeAdminUsers$UPDATES
static final boolean addAdminGroups$UPDATES
static final boolean removeAdminGroups$UPDATES
static final boolean getAdminGroupsPaging$UPDATES
static final boolean getAdminUsersPaging$UPDATES
static final boolean getAdminUserCount$UPDATES
static final boolean getAdminGroupCount$UPDATES
static final boolean isMemberOfGroups$UPDATES
static final boolean isUserMemberOfGroups$UPDATES
static final boolean areUsersMembersOfGroups$UPDATES
static final boolean getDirectMemberGroupIds$UPDATES
static final boolean getDirectMemberUsernames$UPDATES
static final boolean getDirectAdminGroupIds$UPDATES
static final boolean getDirectAdminUsernames$UPDATES
static final boolean suggest$UPDATES
static final boolean resolveEmailAddress$UPDATES
static final boolean resolveEmailAddresses$UPDATES
static final boolean resolveEmailDestinations$UPDATES
static final boolean changeGroupTypeOfGroup$UPDATES
static final boolean changeGroupTypesOfGroups$UPDATES
static final boolean validateTypedValues$UPDATES
java.lang.Long createGroup(Group group_) throws DuplicateNameException, UnsupportedAttributeTypeException, InvalidAttributeException, InvalidGroupTypeException, InvalidParentException, InvalidNameException, InvalidCreatorException, InvalidSecurityMapException, InvalidMemberPolicyException, InvalidViewingPolicyException, InvalidAttributeValueException, PrivilegeException, DuplicateUuidException
Create a new group. groupName
must be unique
for public and team groups. If the Group
is of a
group type with attributes, you
must pass the correct Attribute
list with the correct
name
and type
for each Attribute
with the Group
.
Should be used in conjunction with
GroupTypeService.getGroupTypeAttributes(Long groupTypeId)
in order to properly fill the setAttributes(Attribute[])
field of the Group
passed in. If the Attribute[]
does not match the group type's attributes, then an
InvalidAttributeException
will be thrown.
Note that when a Group
specifies a parent, it automatically
becomes a member Group
of its parent.
The Group
fields required for creation are:
groupName
, groupTypeId
, creatorName
,
securityMapId
. If groupTypeId
points to a
GroupType
with attributes, then all the attributes fields are
required.
In order to minimize possible breaks with the user interface, it is
HIGHLY recommended that the groupName
in the
Group
object be validated for illegal characters (only
allow alphanumeric symbols and underscores).
Note: Personal Groups must have CLOSED membership policy and HIGH member
viewing policy and Team Groups cannot have an AUTOMATIC membership policy;
otherwise InvalidMemberPolicyException
or
InvalidViewingPolicyException
will be thrown
group_
- the Group
to createGroup
createdDuplicateNameException
- Thrown when the group is a public or team group and its name is
not unique.UnsupportedAttributeTypeException
- Thrown when trying to create or update an attribute type that
is not supported by the GroupService
.InvalidAttributeException
- Thrown when trying to get, update, or delete an
attribute
for a GroupType
that does
not exist.InvalidGroupTypeException
- This exception may be thrown by service methods detecting that
a given GroupType
does not exist.InvalidParentException
- Thrown when user passes in invalid Group
as parent.InvalidNameException
- thrown when the groupname is null or empty.InvalidCreatorException
- Thrown when a invalid user is passed as creator of
Group
.InvalidSecurityMapException
- thrown if the securitymapId field passed in Group
object is invalid.InvalidMemberPolicyException
- Thrown when membership policy is invalid or not applicable to the
Group
.InvalidViewingPolicyException
- Thrown when viewing policy is invalid or not applicable to the
Group
.InvalidAttributeValueException
- Thrown when incorrect attributes values are passed.PrivilegeException
- Thrown when the user does not have privileges to create a
Group
.DuplicateUuidException
- Thrown when the UUID passed in already exists in the system.java.lang.Long[] createGroups(Group[] groups_) throws UnsupportedAttributeTypeException, InvalidGroupTypeException, InvalidParentException, InvalidNameException, InvalidCreatorException, InvalidSecurityMapException, InvalidMemberPolicyException, InvalidViewingPolicyException, PrivilegeException, InvalidAttributeException, InvalidAttributeValueException, DuplicateUuidException
Create new groups. groupName
must be unique
for public and team groups. It does not support creating groups with group
types having attributes. If groups with group type having attributes are
passed, it simply returns null
ids in the corresponding entries
for those groups in the return list, as no groups are created for these cases.
Note that when a Group
specifies a parent, it automatically
becomes a member Group
of its parent.
The Group
fields required for creation are:
groupName
, groupTypeId
, creatorName
,
securityMapId
.
In order to minimize possible breaks with the user interface, it is
HIGHLY recommended that groupName
in the Group
object be validated for illegal characters (only allow alphanumeric
symbols and underscores).
Note: Personal Groups must have CLOSED membership policy and HIGH member
viewing policy and Team Groups cannot have AUTOMATIC membership policy;
otherwise InvalidMemberPolicyException
or
InvalidViewingPolicyException
will be thrown
groups_
- the groups to createUnsupportedAttributeTypeException
- Thrown when trying to create or update an attribute type that
is not supported by the Personalization service.InvalidGroupTypeException
- This exception may be thrown by service methods detecting that
a given GroupType
does not exist.InvalidParentException
- Thrown when user passes in invalid Group
as parent.InvalidNameException
- thrown when the groupname is null or empty.InvalidCreatorException
- Thrown when a invalid user is passed as creator of
Group
.InvalidSecurityMapException
- thrown if the securitymapId field passed in Group
object is invalid.InvalidMemberPolicyException
- Thrown when membership policy is invalid or not applicable to the
Group
.InvalidViewingPolicyException
- Thrown when viewing policy is invalid or not applicable to the
Group
.PrivilegeException
- Thrown when the user does not have privileges to create one or
more of the Group
s.InvalidAttributeException
- Never thrown. Is only declared for backwards compatibility.InvalidAttributeValueException
- Never thrown. Is only declared for backwards compatibility.DuplicateUuidException
- Thrown when the UUID of any of the groups already exists or
if the same UUID is passed in for several groupsvoid updateGroup(Group group_) throws InvalidGroupException, DuplicateNameException, RecursiveRelationshipException, InvalidParentException, UnsupportedAttributeTypeException, InvalidAttributeException, InvalidGroupTypeException, InvalidSecurityMapException, InvalidMemberPolicyException, InvalidViewingPolicyException, InvalidAttributeValueException, PrivilegeException
Group
. groupName
must be unique for
public and team groups. If the group
is of a
group type with attributes, you must
pass the correct Attribute
list with the correct
name
and type
for each Attribute
with the Group
. Should be used in conjunction with
GroupTypeService.getGroupTypeAttributes(Long groupTypeId)
in order to properly fill the setAttributes(Attribute[])
field of the Group
passed in. If the Attribute[]
does not match the Group Type's attributes, then an
InvalidAttributeException
will be thrown.
The following fields are set when a Group
is created and
cannot be changed using this method: id
and
groupTypeId
.
Only the following fields can be changed:
groupName
, description
, parentId
,
securityMapId
, attributes
,
memberPolicyId
, viewingPolicyId
,
delegatedCreation
.
If the group does not have a parent then parentId
should be
set to -1.
Note that when a group
specifies a parent, it automatically
becomes a member group
of its parent.
In order to minimize possible breaks with the user interface, it is
HIGHLY recommended that the groupName
be validated for illegal
characters (only allow alphanumeric symbols and underscores).
group_
- the group
to update. Group id
must be
populated as well as groupName
, groupTypeId
,
creatorName
, securityMapId
,
viewingPolicyId
, memberPolicyId
, and
parentId
. If groupTypeId
points to a
GroupType
with attributes
, then all the
attributes
fields are required.InvalidGroupException
- This exception is thrown whenever an invalid group id or group
name is passed into a service method.DuplicateNameException
- This exception may be thrown by service methods detecting that
a given name is not unique.RecursiveRelationshipException
- Thrown when a relationship is trying to be created that will
result in a recursive loop (for instance, if the group is being
updated to be a child of itself).InvalidParentException
- Thrown when user passes in invalid group as parent.UnsupportedAttributeTypeException
- Thrown when trying to create or update an attribute type that
is not supported by the Personalization service.InvalidAttributeException
- Thrown when trying to get, update, or delete an attribute for
a group type that does not exist.InvalidGroupTypeException
- This exception may be thrown by service methods detecting that
a given group type does not exist.InvalidSecurityMapException
- thrown if the securitymap Id field passed in Group object is
invalid.InvalidMemberPolicyException
- Thrown when membership policy is invalid or not applicable to the
group.InvalidViewingPolicyException
- Thrown when viewing policy is invalid or not applicable to the
group.InvalidAttributeValueException
- Thrown when incorrect attributes values are passed.PrivilegeException
- Thrown when the user does not have privileges to update the
group.void updateGroups(Group[] groups_) throws InvalidGroupException, RecursiveRelationshipException, InvalidParentException, UnsupportedAttributeTypeException, InvalidAttributeException, InvalidGroupTypeException, InvalidSecurityMapException, InvalidMemberPolicyException, InvalidViewingPolicyException, InvalidAttributeValueException, PrivilegeException
Group
objects. groupName
must be unique for
public and team groups. If the group
is of a
group type with attributes, you must
pass the correct Attribute
list with the correct
name
and type
for each Attribute
with the group
. Should be used in conjunction with
GroupTypeService.getGroupTypeAttributes(Long groupTypeId)
in order to properly fill the setAttributes(Attribute[])
field of the Group
passed in. If the Attribute[]
does not match the Group Type's attributes, then an
InvalidAttributeException
will be thrown.
The following fields are set when a Group
is created and
cannot be changed using this method: id
and
groupTypeId
.
Only the following fields can be changed:
groupName
, description
, parentId
,
securityMapId
, attributes
,
memberPolicyId
, viewingPolicyId
,
delegatedCreation
.
If the group does not have a parent then parentId
should be
set to -1.
Note that when a group
specifies a parent, it automatically
becomes a member group
of its parent.
In order to minimize possible breaks with the user interface, it is
HIGHLY recommended that the groupName
be validated for illegal
characters (only allow alphanumeric symbols and underscores).
groups_
- the groups
to update. Group id
must be
populated as well as groupName
, groupTypeId
,
creatorName
, securityMapId
,
viewingPolicyId
, memberPolicyId
, and
parentId
. If groupTypeId
points to a
GroupType
with attributes
, then all the
attributes
fields are required.InvalidGroupException
- This exception is thrown whenever an invalid group id or group
name is passed into a service method.RecursiveRelationshipException
- Thrown when a relationship is trying to be created that will
result in a recursive loop (for instance, if the group is being
updated to be a child of itself).InvalidParentException
- Thrown when user passes in invalid group as parent.UnsupportedAttributeTypeException
- Thrown when trying to create or update an attribute type that
is not supported by the Personalization service.InvalidAttributeException
- Thrown when trying to get, update, or delete an attribute for
a group type that does not exist.InvalidGroupTypeException
- This exception may be thrown by service methods detecting that
a given group type does not exist.InvalidSecurityMapException
- thrown if the securitymap Id field passed in Group object is
invalid.InvalidMemberPolicyException
- Thrown when membership policy is invalid or not applicable to the
group.InvalidViewingPolicyException
- Thrown when viewing policy is invalid or not applicable to the
group.InvalidAttributeValueException
- Thrown when incorrect attributes values are passed.PrivilegeException
- Thrown when the user does not have privileges to update
one or more of the groups.void deleteGroup(java.lang.Long groupId_) throws InvalidGroupException, SystemGroupException, GroupIsAttributeException
group
has been deleted, this call must be followed
by a call to
AdministrationService.notifyGroupDeletion(java.lang.Long)
groupId_
- the id of the group to deleteInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.SystemGroupException
- Thrown when trying to delete a group that is core to the
Personalization service such as Portal Administrators or
Collaboration Administrators.GroupIsAttributeException
- Thrown when trying to delete a group that is being used as an
attribute for another group.java.lang.String getGroupName(java.lang.Long groupId_) throws InvalidGroupException
groupId_
- the id of the groupInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.java.lang.String[] getGroupNames(java.lang.Long[] groupIds_) throws InvalidGroupException
groupIds_
- the ids of groupsInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.ResultList getGroupNamesList(java.lang.Long[] groupIds_)
groupIds_
- the ids of groupsResultList
containing group names and result codes. Each result
code will be either CODE_VALID
(for valid group ids) or
CODE_INVALID
(for invalid group ids) from ResultList
.
The results will only contain the names of the valid groups and thus may have
a length less than the number of group ids passed in.Attribute getGroupAttribute(java.lang.Long groupId_, java.lang.String attributeName_) throws InvalidGroupException
groupId_
- the id of the groupattributeName_
- the name of the desired attributeInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.java.lang.NullPointerException
- if the passed group id and/or the attribute
name are null.Group getGroup(java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
groupId_
- the group idInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if the current User
does not have
rights to view the groupGroup[] getGroups(java.lang.Long[] groupIds_) throws InvalidGroupException, PrivilegeException
groupIds_
- the group idsInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if the current user does not have
rights to view the one or more of groups.Credentials getCredentials() throws InvalidUserException
InvalidUserException
- if the credentials for that
user cannot be retrieved.Credentials getCachedCredentials() throws InvalidUserException
Credentials
bean is
for practical purposed read only.
This is a System-level call not meant to be used externally.Credentials
bean with the user's membership data.InvalidUserException
- if the credentials for that
user cannot be retrieved.@Deprecated Group[] getGroupsOfType(java.lang.Long groupTypeId_) throws InvalidGroupTypeException
getGroupsOfTypePaging(java.lang.Long, int, int, java.lang.Integer, java.lang.Integer)
insteadgroupTypeId_
- the group type idServiceException
- if any system-level error occursInvalidGroupTypeException
- This exception is thrown whenever an invalid group type id is
passed into a service method.ResultPage getGroupsOfTypePaging(java.lang.Long groupTypeId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidGroupTypeException
groupTypeId_
- the group type idstartIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Group
objectsInvalidGroupTypeException
- This exception is thrown whenever an invalid group type id is
passed into a service method.java.lang.Long[] getGroupTypeForGroup(java.lang.Long[] groupIds_) throws InvalidGroupException
groupIds_
- the group idsInvalidGroupException
- This exception is thrown whenever an invalid group ids are
passed into a service method.java.lang.Long[] getGroupIdsForUserByRole(java.lang.String username_, java.lang.Integer role_) throws InvalidUserException, UnsupportedRoleException, PrivilegeException
USER_ROLE_CREATOR
USER_ROLE_ADMINISTRATOR
- Note that when using this role, if the user is a System Administrator, only system groups will be returned.
USER_ROLE_MEMBER
username_
- the unique key for the userrole_
- the role idInvalidUserException
- This exception is thrown whenever an invalid username is
passed into a service method.UnsupportedRoleException
- This exception is thrown whenever an invalid role id is passed
into a service method.PrivilegeException
Group[] getGroupsForUserByRole(java.lang.String username_, java.lang.Integer role_) throws InvalidUserException, UnsupportedRoleException, PrivilegeException
USER_ROLE_CREATOR
USER_ROLE_ADMINISTRATOR
- Note that when using this role, if the user is a System Administrator, only system groups will be returned.
USER_ROLE_MEMBER
username_
- the userrole_
- the role idInvalidUserException
- This exception is thrown whenever an invalid username is
passed into a service method.UnsupportedRoleException
- This exception is thrown whenever an invalid role id is passed
into a service method.PrivilegeException
ResultPage getGroupsForUserByRolePaging(java.lang.String username_, java.lang.Integer role_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidUserException, UnsupportedRoleException, PrivilegeException
username_
- the userrole_
- the rolestartIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list group objectsInvalidUserException
- This exception is thrown whenever an invalid username is
passed into a service method.UnsupportedRoleException
- thrown when an invalid role id is passed.PrivilegeException
@Deprecated Group[] getGroupsOfTypeForMemberUser(java.lang.Long[] groupTypeIds_, java.lang.String username_) throws InvalidGroupTypeException, InvalidUserException
getGroupsForUserByRolePaging(String, Integer, int, int, Integer, Integer)
and
extract groups of the desired types from the results.groupTypeIds_
- the group type idsusername_
- the username of the user to get groups forInvalidGroupTypeException
- This exception is thrown whenever an invalid group type id is
passed into a service method.InvalidUserException
- This exception is thrown whenever an invalid username is
passed into a service method.Group[] getMemberGroups(java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
groupId_
- the group for which to get membersInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if the user is not the administrator of
the group and the group is not public.ResultPage getMemberGroupsPaging(java.lang.Long groupId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidGroupException, PrivilegeException
groupId_
- the group for which to get group membersstartIndex_
- the index of the first Group
that will be
returnedbatchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the Group
objects will be
sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Group
objects, representing
the member groups.
Note: If the user can see the group but cannot view members
of group, the results array will be of length 0.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if the user is not the administrator of
the group and the group is not public.User[] getMemberUsers(java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
groupId_
- the group to get members from.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if the user is not the administrator of
the group and the group is not public.ResultPage getMemberUsersPaging(java.lang.Long groupId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidGroupException, PrivilegeException
groupId_
- the group for which to get membersstartIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in User
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list of User
objects.
Note: If the current user can see the group
but cannot view members of group, the results array
will be of length 0.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if the user is not the administrator of
the group and the group is not public.User[] getMemberUsers(java.lang.Long[] groupIds_) throws InvalidGroupException, PrivilegeException
groupIds_
- the groups to get members from.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method. *PrivilegeException
- if the user is not the administrator of
one of the groups and the group is not public.int getMemberUserCount(java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
groupId_
- the group whose user members are to be countedInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if the user does not have sufficient privilegesint getMemberGroupCount(java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
groupId_
- the group to count group members of.ServiceException
- if any system-level error occursInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if the user does not have sufficient privilegesvoid addMemberGroup(java.lang.Long memgroupId_, java.lang.Long groupId_) throws InvalidGroupException, RecursiveRelationshipException, PrivilegeException
memgroupId_
- id of the group to addgroupId_
- the group to add the member toInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.RecursiveRelationshipException
- Thrown when a relationship is trying to be created that will
result in a recursive loop (eg if the member group ID and
the group ID refer to the same group).PrivilegeException
- Thrown when the user does not have privileges to add the
group as a membervoid addMemberGroups(java.lang.Long[] memgroupIds_, java.lang.Long groupId_) throws InvalidGroupException, RecursiveRelationshipException, PrivilegeException
memgroupIds_
- ids of the groups to addgroupId_
- the group to add members toInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.RecursiveRelationshipException
- Thrown when a relationship is trying to be created that will
result in a recursive loop (eg if a member group ID and
the group ID refer to the same group)..PrivilegeException
- Thrown when the user does not have privileges to add
one or more of the groups as membersvoid addMemberUser(java.lang.String username_, java.lang.Long groupId_) throws InvalidUserException, InvalidGroupException, PrivilegeException
username_
- username of the user to add to the groupgroupId_
- the group to add the member toInvalidUserException
- This exception is thrown whenever an invalid username is
passed into a service method.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- Thrown when the user does not have privileges to add
the user as a membervoid addMemberUsers(java.lang.String[] usernames_, java.lang.Long groupId_) throws InvalidUserException, InvalidGroupException, PrivilegeException
usernames_
- the usernames of the users to addgroupId_
- the group to add members toInvalidUserException
- This exception is thrown whenever an invalid username is
passed into a service method.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- Thrown when the user does not have privileges to add
one or more the users as membersvoid addMyselfToGroup(java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
groupId_
- the id of the group which the current user wishes to joinInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- Thrown when the user does not have privileges to add
himself or herself as a member of the groupvoid removeMemberGroup(java.lang.Long memgroupId_, java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
memgroupId_
- id of the member to removegroupId_
- id of the group to remove member fromInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- Thrown when the user does not have privileges to remove
the group's membershipvoid removeMemberGroups(java.lang.Long[] memgroupIds_, java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
memgroupIds_
- the ids of members to removegroupId_
- id of the group
to remove member fromInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- Thrown when the user does not have privileges to remove
any of the group's memberships@Deprecated void removeMemberUser(java.lang.String username_, java.lang.Long groupId_) throws InvalidUserException, InvalidGroupException, PrivilegeException
removeMemberUsers(String[], Long)
and
pass a single user in the array.username_
- the username of the member to removegroupId_
- the id of the group to remove the member fromInvalidUserException
- This exception is thrown whenever an invalid username is
passed into a service method.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- Thrown when the user does not have privileges to remove
the user's membershipvoid removeMemberUsers(java.lang.String[] usernames_, java.lang.Long groupId_) throws InvalidUserException, InvalidGroupException, PrivilegeException
usernames_
- the usernames of the members to removegroupId_
- the id of the group to remove members fromInvalidUserException
- This exception is thrown whenever an invalid username is
passed into a service method.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- Thrown when the user does not have privileges to remove
any of the users' membershipvoid removeMyselfFromGroup(java.lang.Long groupId_) throws InvalidGroupException
groupId_
- the id of the group from which one wants to remove
oneselfInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.@Deprecated Group[] findGroups(GroupSearch groupSearch_, boolean caseSensitive_) throws UnsupportedOperatorException
findGroupsPaging(com.appiancorp.suiteapi.personalization.GroupSearch, boolean, int, int, java.lang.Integer, java.lang.Integer)
insteadGroupSearch
The supported search operators are specified in GroupSearch
for a group
See getOperatorsForAttributeType()
in
GroupTypeService
to obtain a list of possible operators
Operator
for a given data type.
The GroupSearch
object should be populated with the group
fields to be searched on, and the criteria to be used in performing the
search. For example, the GroupSearch
might have the
groupName
field set to "myGroup" and the
operatorGroupName
field set to Operator#EQUALS
.
Such a search will return all groups whose groupName
is
"myGroup".groupSearch_
- the group search beancaseSensitive_
- false
for case insensitive, true
for
case sensitive.UnsupportedOperatorException
- Thrown when a given operation is not supported by the
Personalization service.boolean isGroupDescendant(java.lang.Long groupId_, java.lang.Long parentGroupId_) throws InvalidGroupException
groupId_
- the id of the groupparentGroupId_
- id of the group for which to check the descendantsInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.boolean isUserMember(java.lang.String username_, java.lang.Long groupId_) throws InvalidUserException, InvalidGroupException, PrivilegeException
username_
- the usernamegroupId_
- the group id to checkInvalidUserException
- This exception is thrown whenever a non-empty invalid username is passed
into the service method.InvalidGroupException
- This exception is thrown whenever an invalid group id is passed into the
service method.java.lang.NullPointerException
- If the passed username is either null or empty.PrivilegeException
boolean isUserMember(java.lang.String[] username_, java.lang.Long groupId_) throws InvalidUserException, InvalidGroupException, PrivilegeException
username_
- the usernamesgroupId_
- the group id to checkInvalidUserException
- This exception is thrown whenever all non-empty/non-null usernames passed
into the service method are invalid.InvalidGroupException
- This exception is thrown whenever an invalid group id is passed into the
service method.java.lang.NullPointerException
- If all passed usernames are either null or empty.PrivilegeException
boolean isUserMember(java.lang.String username_, java.lang.String groupUuid_) throws InvalidUserException, InvalidGroupException, PrivilegeException
username_
- the usernamegroupUuid_
- the group UUID to checkInvalidUserException
- This exception is thrown whenever all non-empty/non-null usernames passed
into the service method are invalid.InvalidGroupException
- This exception is thrown whenever an invalid group id is passed into the
service method.java.lang.NullPointerException
- If all passed usernames are either null or empty.PrivilegeException
boolean isUserMember(java.lang.String[] username_, java.lang.String groupUuid_) throws InvalidUserException, InvalidGroupException, PrivilegeException
username_
- the usernamesgroupUuid_
- the group UUID to checkInvalidUserException
- This exception is thrown whenever all non-empty/non-null usernames passed
into the service method are invalid.InvalidGroupException
- This exception is thrown whenever an invalid group id is passed into the
service method.java.lang.NullPointerException
- If all passed usernames are either null or empty.PrivilegeException
Tree[] getRootTrees(java.lang.Long groupTypeId_, java.lang.String relationshipType_, boolean singleGroupType_, int descendentDepth_) throws InvalidGroupTypeException
id
,
name
of the node will be id
and
groupName
of the group, and data
field of
the node will be the group itself.groupTypeId_
- The group type of the root node groups.relationshipType_
- The relationship connecting the groups. Currently, the only
permissible value is
RELATIONSHIP_TYPE_HEIRARCHY
.singleGroupType_
- true
if only groups of the same group type as
the root should be returned; false
if all
groups, regardless of group type, should be returned.descendentDepth_
- The number of levels below the root that should be returned.tree
representing the root level groupsInvalidGroupTypeException
- This exception is thrown whenever an invalid group type id is
passed into a service method.Tree[] getRootTreesSameTypeWithRoles(java.lang.Long groupTypeId_, java.lang.Integer[] roleTypes_, int descendantDepth_) throws InvalidGroupTypeException
Group
structured into one or more trees
Tree
. Only those groups are returned for which the user's privilege
matches the specified rolesgroupTypeId_
- The group type GroupType
of the root node groups.roleTypes_
- array of roles which should match user's privilegedescendantDepth_
- The number of levels below the root that should be returned.tree
representing the root level groupsInvalidGroupTypeException
- This exception is thrown whenever an invalid group type id is
passed into a service method.ResultPage getTopLevelGroupsPaging(java.lang.Long groupTypeId_, java.lang.String relationshipType_, boolean singleGroupType_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidGroupTypeException
result
field.
Each node in the tree will represent a group. The id
,
name
of the node will be id
and
groupName
of the group, and data
field of
the node will be the group itself.groupTypeId_
- The group type of the root node groups.relationshipType_
- The relationship connecting the groups. Currently, the only
permissible value is
RELATIONSHIP_TYPE_HEIRARCHY
.singleGroupType_
- true
if only groups of the same group type as
the root should be returned; false
if all
groups, regardless of group type, should be returned.startIndex_
- the index of the first Group
that will be
returnedbatchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the Group
objects will be
sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing batchSize_ Group
objects.InvalidGroupTypeException
- This exception is thrown whenever an invalid group type id is
passed into a service method.Tree[] getRootTrees(java.lang.Long groupTypeId_, java.lang.String relationshipType_, java.lang.Long[] groupTypeIds_, int descendentDepth_) throws InvalidGroupTypeException
id
,
name
of the node will be id
and
groupName
of the group, and data
field of
the node will be the group itself.groupTypeId_
- The group type of the root node groups.relationshipType_
- The relationship connecting the groups. Currently, the only
permissible value is
RELATIONSHIP_TYPE_HEIRARCHY
.groupTypeIds_
- Only groups of these group types
should be returned in the tree.descendentDepth_
- The number of levels below the root that should be returned.Tree
sInvalidGroupTypeException
- This exception is thrown whenever an invalid group type id is
passed into a service method.TreePivot getTreeViewForGroup(java.lang.Long groupId_, boolean singleGroupType_, java.lang.String relationshipType_, int descendentDepth_) throws InvalidGroupException, PrivilegeException
TreePivot
Each node in the tree will represent a group. The id
,
name
of the node will be id
and
groupName
of the group, and data
field of
the node will be the group itself.groupId_
- The id of the group
to use as the root of the
tree
.singleGroupType_
- true
if only groups of the same group type as
the root should be returned; false
if all
groups, regardless of group type, should be returned.relationshipType_
- The relationship connecting the groups. Currently, the only
permissible value is
RELATIONSHIP_TYPE_HEIRARCHY
descendentDepth_
- The number of levels below the root that should be returned.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- This exception is thrown when the user is not a member of the
received groupTree
TreePivot getTreeViewForGroup(java.lang.Long groupId_, java.lang.Long[] groupTypeIds_, java.lang.String relationshipType_, int descendentDepth_) throws InvalidGroupException, InvalidGroupTypeException, PrivilegeException
id
,
name
of the node will be id
and
groupName
of the group, and data
field of
the node will be the group itself.groupId_
- The id of the group
to use as the root of the
tree
.groupTypeIds_
- Only groups of these group types
should be returned in the tree.relationshipType_
- The relationship connecting the groups. Currently, the only
permissible value is RELATIONSHIP_TYPE_HEIRARCHY
.descendentDepth_
- The number of levels below the root that should be returned.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.InvalidGroupTypeException
- This exception is thrown whenever an invalid group type id is
passed into a service method.PrivilegeException
- This exception is thrown when the user is not a member of the
received groupTree
TreePivot getTreeViewForGroupSameTypeWithRoles(java.lang.Long groupId_, java.lang.Integer[] roleTypes_, int descendantDepth_) throws InvalidGroupException
id
,
name
of the node will be id
and
groupName
of the group, and data
field of
the node will be the group itself.groupId_
- The id of the group
to use as the root of the
tree
.roleTypes_
- array of roles which should match user's privilegedescendantDepth_
- The number of levels below the root that should be
returned.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.boolean doesGroupExist(java.lang.Long groupId_)
groupId_
- id of the group to check for existence in system.void addGroupsToMyGroups(java.lang.Long[] groupIds_) throws InvalidGroupException
groupIds_
- groups to add to My GroupsInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.void removeGroupsFromMyGroups(java.lang.Long[] groupIds_)
groupIds_
- groups to remove from My GroupsaddGroupsToMyGroups(java.lang.Long[])
java.lang.Long[] getMyGroupIds()
@Deprecated ResultPage getMyGroups(int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
startIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing the Group
objects.GroupSecurityType[] getGroupSecurityTypes(java.lang.Integer actionId_)
actionId_
- id of the action for which security types are needed. This is
one of the ACTION_GROUP_XXX
constantsGroupMemberPolicy[] getGroupMembershipPolicyTypes(java.lang.Long groupSecurityTypeId_)
groupSecurityTypeId_
- id of group security type.GroupMemberViewingPolicy[] getGroupMemberViewingPolicyTypes(java.lang.Long groupSecurityTypeId_)
groupSecurityTypeId_
- id of group security type.AttributeType[] getAllAttributeTypes()
@Deprecated Group[] findNonMemberAncestorGroups(GroupSearch groupSearch_, boolean caseSensitive_, java.lang.Long groupId_) throws UnsupportedOperatorException
findNonMemberAncestorGroupsPaging(com.appiancorp.suiteapi.personalization.GroupSearch, boolean, java.lang.Long, int, int, java.lang.Integer, java.lang.Integer)
instead.GroupSearch
object should be populated with the group
fields to be searched on, and the criteria to be used in performing the
search. For example, the GroupSearch
might have the
groupName
field set to "myGroup" and the
operatorGroupName
field set to Operator#EQUALS
.
Such a search will return all groups whose groupName
is
"myGroup".
The supported search operators are specified in GroupSearch for a groupgroupSearch_
- the group search formcaseSensitive_
- true if search is case sensitivegroupId_
- the group idUnsupportedOperatorException
- Thrown when a given operation is not supported by the
Personalization service.@Deprecated Group[] findAvailableParentGroups(GroupSearch groupSearch_, boolean caseSensitive_, java.lang.Long groupId_) throws UnsupportedOperatorException
findAvailableParentGroupsPaging(com.appiancorp.suiteapi.personalization.GroupSearch, boolean, java.lang.Long, int, int, java.lang.Integer, java.lang.Integer)
insteadOperator
are specified in
GroupSearch GroupSearch
The GroupSearch
object should be populated with the group
fields to be searched on, and the criteria to be used in performing the
search. For example, the GroupSearch
might have the
groupName
field set to "myGroup" and the
operatorGroupName
field set to Operator#EQUALS
.
Such a search will return all groups whose groupName
is
"myGroup".groupSearch_
- the group search formcaseSensitive_
- true if search is case sensitivegroupId_
- the group idUnsupportedOperatorException
- Thrown when a given operation is not supported by the
Personalization service.@Deprecated Group[] findAdminGroups(GroupSearch groupSearch_, boolean caseSensitive_) throws UnsupportedOperatorException
findAdminGroupsPaging(com.appiancorp.suiteapi.personalization.GroupSearch, boolean, int, int, java.lang.Integer, java.lang.Integer)
insteadGroupSearch
The GroupSearch
object should be populated with the group
fields to be searched on, and the criteria to be used in performing the
search. For example, the GroupSearch
might have the
groupName
field set to "myGroup" and the
operatorGroupName
field set to Operator#EQUALS
.
Such a search will return all groups whose groupName
is
"myGroup".groupSearch_
- the group search formcaseSensitive_
- true if search is case sensitiveUnsupportedOperatorException
- Thrown when a given operation is not supported by the
Personalization service.RuleSet getRuleSetForGroup(java.lang.Long groupId_) throws InvalidGroupException
groupId_
- the group id of the group that all
these rules belong to.RuleSet
for the given roup.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.void updateRuleSetForGroup(RuleSet ruleSet_) throws InvalidGroupException
Group
. Note that
there is only one RuleSet
for each Group
,
but each RuleSet
may contain multiple rules.
This method will replace the current RuleSet
with the
one passed in.ruleSet_
- adds the given RuleSet
to the group.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.@Deprecated GroupSummary[] getGroupSummaryForUser(java.lang.String username_) throws InvalidUserException, PrivilegeException
getGroupSummaryForUserPaging(String, int, int, Integer, Integer)
instead.username_
- the usernameGroupSummary
InvalidUserException
- thrown when an invalid username is passed in.PrivilegeException
ResultPage getGroupSummaryForUserPaging(java.lang.String username_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidUserException, PrivilegeException
GroupSummary
beans for every group for which the given
User
is a member or administrator. Note: the security on personal
groups will further filter out groups of which the user is a
member but not an administrator as only administrators of personal groups
have permissions to see those groups.username_
- The username of the User
for which to
retrieve the groups.startIndex_
- the index into the collection of total results at which
to start. Negative numbers are treated as zeros.batchSize_
- the number of results to return.
Use Constants.COUNT_ALL
to return the entire collection, but this is STRONGLY discouraged.sortProperty_
- the property by which the results will be sorted.sortOrder_
- the order in which to sort the results.
This is one of
Constants.SORT_ORDER_ASCENDING
or Constants.SORT_ORDER_DESCENDING
ResultPage
which contains an array of
GroupSummary
objects.InvalidUserException
- if the specified User
does not
existPrivilegeException
boolean isGroupSystemGroup(java.lang.Long groupId_) throws InvalidGroupException
groupId_
- the group IDInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.@Deprecated Group[] getGroupsForUserByRoles(java.lang.String username_, java.lang.Integer[] roles_) throws UnsupportedRoleException, InvalidUserException, PrivilegeException
getGroupsForUserByRolesPaging(String, Integer[], int, int, Integer, Integer)
instead.username_
- the userroles_
- ids of rolesInvalidUserException
- thrown when an invalid username is passed to this service
method.UnsupportedRoleException
- thrown when an invalid role id is passed.PrivilegeException
ResultPage getGroupsForUserByRolesPaging(java.lang.String username_, java.lang.Integer[] roles_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws UnsupportedRoleException, InvalidUserException, PrivilegeException
username_
- the userroles_
- ids of rolesstartIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing list of Group
objects.UnsupportedRoleException
- thrown when an invalid role id is passed.InvalidUserException
- thrown when an invalid username is passed to this service
method.PrivilegeException
java.lang.Boolean[] getGroupActions(java.lang.Long groupId_, java.lang.Integer[] actionIds_) throws InvalidGroupException
groupId_
- id of the groupactionIds_
- ids of actions that are requested to be checked. Each of these is
one of the ACTION_GROUP_XXX
constantsBoolean.TRUE
if the current user can perform the action at the corresponding index in
actionIds_
on the given groupInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.boolean canUseGroupName(java.lang.String groupName_, java.lang.Long groupSecurityType_) throws InvalidSecurityMapException
groupName_
- name of the groupgroupSecurityType_
- group security type can be one of the following:
InvalidSecurityMapException
- thrown when a invalid groupSecurity Type is passed.GroupSecurityType
Group[] getParentGroupsForDelegatedCreation()
Group[] getParentGroupsForDelegatedUpdate(java.lang.Long groupId_)
getParentGroupsForDelegatedCreation()
except that it filters out groups that are members of the
passed in group and those that are children or sub-children of
the passed in group.groupId_
- the id of the groupResultPage getParentGroupsForDelegatedCreationPaging(int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
startIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list of Group
objects.ResultPage findGroupsPaging(GroupSearch groupSearch_, boolean caseSensitive_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws UnsupportedOperatorException
group
See getOperatorsForAttributeType()
in
GroupTypeService
to obtain a list of possible operators
Operator
for a given data type.
The GroupSearch
object should be populated with the group
fields to be searched on, and the criteria to be used in performing the
search. For example, the GroupSearch
might have the
groupName
field set to "myGroup" and the
operatorGroupName
field set to Operator#EQUALS
.
Such a search will return all groups whose groupName
is
"myGroup".groupSearch_
- the group search formcaseSensitive_
- true if search is case sensitivestartIndex_
- the
index into the collection of total results at which to start.
Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list of groups matching
search criteriaUnsupportedOperatorException
- Thrown when a given operation is not supported by the
Personalization service.ResultPage findNonMemberAncestorGroupsPaging(GroupSearch groupSearch_, boolean caseSensitive_, java.lang.Long groupId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws UnsupportedOperatorException
ResultPage
of list of groups for a
group search that are not ancestors (by parent-member relationship) of the
given group. This is used to prevent circular member relationships.
The supported search operators are specified in GroupSearch for a
group
The GroupSearch
object should be populated with the group
fields to be searched on, and the criteria to be used in performing the
search. For example, the GroupSearch
might have the
groupName
field set to "myGroup" and the
operatorGroupName
field set to Operator#EQUALS
.
Such a search will return all groups whose groupName
is
"myGroup".groupSearch_
- the group search formcaseSensitive_
- true if search is case sensitivegroupId_
- the id of a groupstartIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Group
objectsUnsupportedOperatorException
- Thrown when a given operation is not supported by the
Personalization service.ResultPage findAvailableParentGroupsPaging(GroupSearch groupSearch_, boolean caseSensitive_, java.lang.Long groupId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws UnsupportedOperatorException
GroupSearch
object should be populated with the group
fields to be searched on, and the criteria to be used in performing the
search. For example, the GroupSearch
might have the
groupName
field set to "myGroup" and the
operatorGroupName
field set to Operator#EQUALS
.
Such a search will return all groups whose groupName
is
"myGroup".groupSearch_
- the group search formcaseSensitive_
- true if search is case sensitivegroupId_
- the id of a GroupstartIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list of Groups
objects, representing those groups available to be used as
parent groups.UnsupportedOperatorException
- Thrown when a given operation is not supported by the
Personalization service.ResultPage findAdminGroupsPaging(GroupSearch groupSearch_, boolean caseSensitive_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws UnsupportedOperatorException
GroupSearch
object should be populated with the group
fields to be searched on, and the criteria to be used in performing the
search. For example, the GroupSearch
might have the
groupName
field set to "myGroup" and the
operatorGroupName
field set to Operator#EQUALS
.
Such a search will return all groups whose groupName
is
"myGroup".groupSearch_
- the group search formcaseSensitive_
- true if search is case sensitivestartIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list of Group
objects matching the search criteria.UnsupportedOperatorException
- Thrown when a given operation is not supported by the
Personalization service.java.lang.String getApplicationName()
java.lang.String[] getWorkspace()
java.lang.String[] getMemberUsernames(java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
groupId_
- id of the group to get users forInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
java.lang.Long[][] getGroupIdsForUserByRoles(java.lang.String username_, java.lang.Integer[] roles_) throws InvalidUserException, UnsupportedRoleException, PrivilegeException
username_
- the userroles_
- ids of rolesInvalidUserException
- This exception is thrown whenever an invalid username is
passed into a service method.UnsupportedRoleException
- This exception is thrown whenever an invalid role id is passed
into a service method.PrivilegeException
ResultList getGroupsList(java.lang.Long[] groupIds_)
ResultList
containing error codes for all
Ids and Group
s for valid IdsgroupIds_
- Ids of groups to retrieveResultList
containing Group
group
objects, and error codes. Each error code will be one of the
CODE_XXX
constants in ResultList
Group[] getMemberGroupsDirect(java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
groupId_
- the group to get group members forInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if there is a security violationResultPage getMemberGroupsDirectPaging(java.lang.Long groupId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidGroupException, PrivilegeException
groupId_
- the group to get members forstartIndex_
- the index of the first Group
that will be
returnedbatchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the Group
objects will be
sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Group
objects, representing
the group member.
Note: If the user can see the group but cannot view members
of the group, the results array will be of length 0.ServiceException
- if any system-level error occursInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if there is a security violation@Deprecated User[] getMemberUsersDirect(java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
getMemberUsersDirectPaging(Long, int, int, Integer, Integer)
groupId_
- the group to get members for.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if there is a security violationResultPage getMemberUsersDirectPaging(java.lang.Long groupId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidGroupException, PrivilegeException
groupId_
- the group to get members for.startIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in User
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list of User
objects, representing the direct member users of the group.
Note: If the current user can see the group
but cannot view members of group, the results array
will be of length 0.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if there is a security violationResultPage getAdminUsersDirectPaging(java.lang.Long groupId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidGroupException, PrivilegeException
groupId_
- the group to get admins for.startIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in User
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing a list of User
objects, representing the direct user admins of the group.
Note: If the current user can see the group
but cannot view members of group, the results array
will be of length 0.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if there is a security violation@Deprecated java.lang.String[] getMemberUsernamesDirect(java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
getMemberUsersDirectPaging(Long, int, int, Integer, Integer)
groupId_
- id of the Group to get users forInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if there is a security violationGroupHierarchyBean[] getTopLevelGroupsForHierarchy(java.lang.Long groupTypeId_, boolean sameType_) throws InvalidGroupTypeException
groupTypeId_
- sameType_
- InvalidGroupTypeException
- This exception may be thrown by service methods detecting that
a given GroupType
does not exist.java.lang.SecurityException
- if there is a security violationResultPage getTopLevelGroupsForHierarchyPaging(java.lang.Long groupTypeId_, boolean sameType_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidGroupTypeException
GroupHierarchyBean
objects (
Group
s without a parent group) given the
Group
type.groupTypeId_
- The type of the Group
to retrieve.sameType_
- Affects the value of the hasChildren
field.
If true
, then hasChildren
is only true if the
Group
has children of the same Group
type.
If false
, then hasChildren
is true if the
Group
has any children at all.startIndex_
- The index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- The number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- The property by which the results will be sorted. This should be
one of the SORTY_BY_XXX constants in GroupHierarchyBean
.sortOrder_
- The order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing an array of Group
objects.InvalidGroupTypeException
- If the groupTypeId_
parameter does not correspond to an existing Group
type.boolean[] areUsersAddedByRule(java.lang.Long groupId_, java.lang.String[] userIds_) throws InvalidUserException, InvalidGroupException
groupId_
- The id of the group that contains the users that are being checked.userIds_
- The ids of the users being checked to see if they were added by a rule.userIds_
that contains
as a value in each element either true or false.
true means the user was added by a rule, while false means it was not.InvalidUserException
- This exception is thrown whenever an invalid user id is
passed into a service method.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.boolean[] areGroupsAddedByRule(java.lang.Long groupId_, java.lang.Long[] groupIds_) throws InvalidGroupException
groupId_
- The id of the group that contains the users that are being checked.groupIds_
- The ids of the groups being checked to see if they were added by a rule.groupIds_
that contains
as a value in each element either true or false.
true means the user was added by a rule, while false means it was not.InvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.@Deprecated java.lang.String suggestGroups(java.lang.String query_, int maxSuggestions_)
suggest(String, int, SuggestParam[], Boolean)
insteadGroup
s whose name matches or partially
matches the query string. The number of suggestions is limited.
Format (for User
s and Group
s:
[[4, 'john.user', John User],[5, 32, 'Finance']]query_
- The search query.maxSuggestions_
- The maximum number of suggestions to return.@Deprecated java.lang.String suggestUsersAndGroups(java.lang.String query_, int maxSuggestions_)
suggest(String, int, SuggestParam[], Boolean)
insteadUser
s whose first, last, or username match or partially
match the query string and Group
s whose name matches or
partially matches the query string. The number of suggestions is limited.
Format (for User
s and Group
s:
[[4, 'john.user', John User],[5, 32, 'Finance']]query_
- The search query.maxSuggestions_
- The maximum number of suggestions to return.@Deprecated Suggestion[][] suggestGroupsBulk(java.lang.String[] queries_, int maxSuggestionsPerQuery_)
suggest(String, int, SuggestParam[], Boolean)
insteadGroup
s whose name matches each query.queries_
- An array of queries by which to search for
Group
s.maxSuggestionsPerQuery_
- The maximum number of suggestions to return
for each query.Suggestion[]
which are the suggestions
corresponding to each query string. The first dimension of the array is
equal to the number of queries. The second dimension of the array is
less than or equal to the max suggestions per query.@Deprecated Suggestion[][] suggestUsersAndGroupsBulk(java.lang.String[] queries_, int maxSuggestionsPerQuery_)
suggest(String, int, SuggestParam[], Boolean)
insteadUser
s whose first, last, and usernames match each
query and Group
s whose name matches each query.queries_
- An array of queries by which to search for
Group
s.maxSuggestionsPerQuery_
- The maximum number of suggestions to return
for each query.Suggestion[]
which are the suggestions
corresponding to each query string. The first dimension of the array is
equal to the number of queries. The second dimension of the array is
less than or equal to the max suggestions per query.@Deprecated java.lang.Long getUserDefaultApplication(java.lang.String username)
ApplicationService.getDefaultApplication()
for the site-wide default.username
- the user for which to fetch the application@Deprecated java.lang.Long getSystemDefaultApplication()
ApplicationService.getDefaultApplication()
java.lang.String getMyHomePage()
void setGlobalHomePage(java.lang.String url) throws PrivilegeException
url
- the absolute url of the default home page for all
users (i.e. /portal/home.do).PrivilegeException
- Thrown when the user does not have privileges to create a
Group
.void setHomePageForUser(java.lang.String username_, java.lang.String url_) throws InvalidUserException, PrivilegeException
void setMyHomePage(java.lang.String url) throws java.lang.Exception
url
- the absolute url of the pagejava.lang.Exception
- if there is any errorjava.lang.String getGlobalHomePage()
void addGroupToFavorites(java.lang.Long groupId_) throws InvalidGroupException
Group
as one of the current User
's favoritesgroupId_
- the id of the group that is to be added to user's favoritesInvalidGroupException
- This exception is thrown whenever an invalid group id or group
name is passed into a service method.void removeGroupFromFavorites(java.lang.Long groupId_) throws InvalidGroupException
groupId_
- the id of the group that is to be removed from user's favoritesInvalidGroupException
- This exception is thrown whenever an invalid group id or group
name is passed into a service method.ResultPage getFavoriteGroups(int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_)
startIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.ResultPage
containing the Group
objects.void addAdminUsers(java.lang.String[] usernames_, java.lang.Long groupId_) throws InvalidUserException, InvalidGroupException, PrivilegeException
groupId_
usernames_
- username's of the users to be added as administrators.groupId_
- the group to add the administrator to.InvalidGroupException
- This exception is thrown whenever an invalid
group id is passed for the groupId_
PrivilegeException
- This exception is thrown when the user does not
have privileges to add the group(s) as adminsitratorsInvalidUserException
void removeAdminUsers(java.lang.String[] usernames_, java.lang.Long groupId_) throws InvalidUserException, InvalidGroupException, PrivilegeException
usernames_
as administrators
of groupusernames_
- username's of the users to be removed.groupId_
- the target group whose administrators are updatedInvalidGroupException
- This exception is thrown whenever an invalid
group id is passed for the groupId_
PrivilegeException
- This exception is thrown when the user does not
have privileges to remove the user(s)InvalidUserException
void addAdminGroups(java.lang.Long[] adminGroupIds_, java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
groupId_
adminGroupIds_
- Ids of the group to be added as administrators.groupId_
- the group to add the administrator to.InvalidGroupException
- This exception is thrown whenever an invalid
group id is passed for either the groupId_ or the groups to be added as
administratorPrivilegeException
- This exception is thrown when the user does not
have privileges to add the group(s) as adminsitratorsvoid removeAdminGroups(java.lang.Long[] adminGroupIds_, java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
adminGroupIds_
- Ids of the group to be removed.groupId_
- the target group whose administrators are updatedInvalidGroupException
- This exception is thrown whenever an invalid
group id is passed for either the groupId_ or the groups to be removed as
administratorsPrivilegeException
- This exception is thrown when the user does not
have privileges to remove the group(s)ResultPage getAdminGroupsPaging(java.lang.Long groupId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidGroupException, PrivilegeException
groupId_
groupId_
- Id of the group whose administrator groups are requestedstartIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in Group
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.Group
objects that
are administrator groups.InvalidGroupException
- This exception is thrown whenever an invalid
group id is passed for the groupId_
PrivilegeException
- This exception is thrown whenever the user does
not have view privileges to group specified by groupId_
ResultPage getAdminUsersPaging(java.lang.Long groupId_, int startIndex_, int batchSize_, java.lang.Integer sortProperty_, java.lang.Integer sortOrder_) throws InvalidGroupException, PrivilegeException
groupId_
groupId_
- Id of the group whose administrator groups are requestedstartIndex_
- the index into the collection of total results at which to
start. Negative numbers are treated as zeros.batchSize_
- the number of results to return. Negative numbers will result
in the entire collection being returned, but this is STRONGLY
discouraged.sortProperty_
- the property by which the results will be sorted. This is one of
the SORT_BY_XXX
constants in User
sortOrder_
- the order in which to sort the results. This should be
either
Constants.SORT_ORDER_ASCENDING
or
Constants.SORT_ORDER_DESCENDING
.User
objects that
are administrator users.InvalidGroupException
- This exception is thrown whenever an invalid
group id is passed for the groupId_
PrivilegeException
- This exception is thrown whenever the user does
not have view privileges to group specified by groupId_
int getAdminUserCount(java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
groupId_
- the group whose user members are to be countedInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if the user does not have sufficient privilegesint getAdminGroupCount(java.lang.Long groupId_) throws InvalidGroupException, PrivilegeException
groupId_
- the group to count group members of.ServiceException
- if any system-level error occursInvalidGroupException
- This exception is thrown whenever an invalid group id is
passed into a service method.PrivilegeException
- if the user does not have sufficient privilegesboolean[] isMemberOfGroups(java.lang.Long[] groupId_)
groupId_
- array of group idsboolean[] isMemberOfGroups(java.lang.String[] groupUuid_)
groupUuid_
- array of group UUIDs.boolean[] isUserMemberOfGroups(java.lang.String username_, java.lang.Long[] groupId_) throws InvalidUserException
username_
- usernamegroupId_
- array of group idsInvalidUserException
- If the passed username is invalid.boolean[] isUserMemberOfGroups(java.lang.String username_, java.lang.String[] groupUuid_) throws InvalidUserException
username_
- usernamegroupUuid_
- array of group uuidsInvalidUserException
- If the passed username is either null or empty.boolean[] isUserMemberOfGroups(java.lang.String[] usernames, java.lang.Long[] groupId_) throws InvalidUserException
usernames
- usernamesgroupId_
- array of group idsInvalidUserException
- If all passed usernames are invalid.boolean[] isUserMemberOfGroups(java.lang.String[] usernames, java.lang.String[] groupUuid_) throws InvalidUserException
usernames
- usernamesgroupUuid_
- array of group uuidsInvalidUserException
- If all passed usernames are invalid.boolean[][] areUsersMembersOfGroups(java.lang.String[] usernames, java.lang.Long[] groupIds) throws InvalidUserException
usernames
- groupIds
- array of group idsInvalidUserException
boolean[][] areUsersMembersOfGroups(java.lang.String[] usernames, java.lang.String[] groupUuid_) throws InvalidUserException
usernames
- groupUuid_
- array of group uuidsInvalidUserException
java.lang.Long[] getDirectMemberGroupIds(java.lang.Long groupId) throws InvalidGroupException, PrivilegeException
groupId
- id of the group for which to get member groupsInvalidGroupException
- if the group ID is invalidPrivilegeGroupException
- if the user does not have rights to view
the groupPrivilegeException
java.lang.String[] getDirectMemberUsernames(java.lang.Long groupId) throws InvalidGroupException, PrivilegeException
groupId
- id of the group for which to get member usersInvalidGroupException
- if the group ID is invalidPrivilegeGroupException
- if the user does not have rights to view
the groupPrivilegeException
java.lang.Long[] getDirectAdminGroupIds(java.lang.Long groupId) throws InvalidGroupException, PrivilegeException
groupId
- id of the group for which to get admin groupsInvalidGroupException
- if the group ID is invalidPrivilegeGroupException
- if the user does not have rights to view
the groupPrivilegeException
java.lang.String[] getDirectAdminUsernames(java.lang.Long groupId) throws InvalidGroupException, PrivilegeException
groupId
- id of the group for which to get admin usersInvalidGroupException
- if the group ID is invalidPrivilegeGroupException
- if the user does not have rights to view
the groupPrivilegeException
java.lang.String suggest(java.lang.String query, int maxItems, SuggestParam[] params, java.lang.Boolean groupResults)
query
- maxItems
- params
- list of information on what is being suggested and what format the results should be in. valid types are group, user.groupResults
- if specifying more than one SuggestParam, would you like to group the results by type, or mixed together and
sorted? Default is true. If grouped, order of types matches the order of the suggestParams passed in.java.lang.String suggest(java.lang.String query, int maxItems, SuggestParam[] params, java.lang.Boolean groupResults, java.lang.Long[] allowList)
query
- maxItems
- params
- list of information on what is being suggested and what format the results should be in. valid types are group, user.groupResults
- if specifying more than one SuggestParam, would you like to group the results by type, or mixed together and
sorted? Default is true. If grouped, order of types matches the order of the suggestParams passed in.allowList
- list of IDs that will be automatically added to returned results, filtered by query. Ignored if null or empty.@Deprecated ResolvedEmailAddresses resolveEmailAddress(LocalObject emailRecipient_) throws InvalidGroupException, InvalidUserException, PrivilegeException
emailRecipient_
- the LocalObject representing an email recipient for which to
retrieve the email address information.InvalidGroupException
- if the recipient type is GROUP and the id is not validInvalidUserException
- if the recipient type is USER and the id is not validPrivilegeException
- if the user doesn't have rights to see the address@Deprecated ResolvedEmailAddresses resolveEmailAddresses(LocalObject[] emailRecipients_)
emailRecipients_
- the LocalObject[] representing email recipients for which to
retrieve the email address information.ResolvedEmailAddresses[] resolveEmailDestinations(LocalObject[] to_, LocalObject[] cc_, LocalObject[] bcc_)
to_
- the LocalObject[] representing email recipients for the "to" fieldcc_
- the LocalObject[] representing email recipients for the "cc" fieldbcc_
- the LocalObject[] representing email recipients for the "bcc" fieldresolveEmailAddresses
void changeGroupTypeOfGroup(java.lang.Long groupId, java.lang.Long newGroupTypeId) throws PrivilegeException, InvalidGroupException, InvalidGroupTypeException
groupId
- id of group to change grouptype ofnewGroupTypeId
- newGroupTypeId id of groupType to change group toPrivilegeException
- if user is not a SystemAdministrator-type userInvalidGroupException
- if groupId is invalidInvalidGroupTypeException
- if newGroupTypeId is invalidjava.lang.Integer[] changeGroupTypesOfGroups(java.lang.Long[] groupIds, java.lang.Long[] newGroupTypeIds) throws java.lang.IllegalArgumentException
groupIds
- ids of groups to change grouptypes ofnewGroupTypeIds
- ids of groupTypes to change groups toInteger
array containing success or error codes. This
is one of the GROUP_TYPE_CHANGE_XXX Constantsjava.lang.IllegalArgumentException
- if groupIds not uniqueboolean validateTypedValues(TypedValue[] typedValues) throws InvalidGroupException, InvalidUserException
typedValues
- InvalidGroupException
InvalidUserException
Copyright © 2003-2024 Appian Corporation. All Rights Reserved.