Interface OrganizationController
-
- All Known Implementing Classes:
DefaultOrganizationController
public interface OrganizationController
The organization controller is the gateway for accessing the organizational resources of Silverpeas: spaces, component instances, users, groups, roles, and so one. It performs additional controls and treatments on these resources according to some authorization and privacy rules before returning them. This is why their access have to be centralized to this controller. For organizational resources management or for technical transverse services (like the user notification service for example), prefer to use directly theAdministration
service.
-
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Modifier and Type Method Description static OrganizationController
get()
Gets an object satisfying theOrganizationController
interface.String[]
getAdministratorUserIds(String fromUserId)
Return all administrators idsString[]
getAllComponentIds(String sSpaceId)
Returns all the component identifiers of the space represented by the given identifier.String[]
getAllComponentIdsRecur(String sSpaceId)
Returns all the component identifiers of the space, and its sub spaces, represented by the given identifier.Domain[]
getAllDomains()
Gets all the user domains defined in Silverpeas.String[]
getAllGroupIdsOfUser(String userId)
Gets all the groups to which the specified user belongs.<T extends Group>
T[]getAllGroups()
Return all the groups of silverpeasString[]
getAllowedComponentIds(String userId)
Gets all the component instances in Silverpeas allowed to be accessed by the specified user.String[]
getAllowedSubSpaceIds(String userId, String spaceFatherId)
Gets the all the subspaces of the specified space accessible to the given user.<T extends Group>
T[]getAllRootGroups()
Return all root groups of silverpeas or null if an error occurred when getting the root groups.<T extends Group>
T[]getAllRootGroupsInDomain(String domainId)
Gets all the user groups that belong to the specified domain.String[]
getAllRootSpaceIds()
Return all the root spaceIdsString[]
getAllRootSpaceIds(String sUserId)
Return all the root spaceIds available for the user sUserIdString[]
getAllSpaceIds()
Return all the spaces available in silverpeasString[]
getAllSpaceIds(String sUserId)
<T extends Group>
T[]getAllSubGroups(String parentGroupId)
For use in userPanel : return the direct subgroupsString[]
getAllSubSpaceIds(String sSpaceId)
Return all the subSpaces available in silverpeas given a space id (driver format)String[]
getAllSubSpaceIds(String sSpaceId, String sUserId)
Return all the subSpaces id available given a space id (driver format)int
getAllSubUsersNumber(String sGroupId)
Returns the total number of distinct users recursively contained in the specified group<T extends User>
T[]getAllUsers()
Return all the users of Silverpeas<T extends User>
T[]getAllUsers(String componentId)
Return all the users allowed to access the given componentString[]
getAllUsersIds()
Return all the users of Silverpeas<T extends User>
T[]getAllUsersInDomain(String domainId)
Gets all the users that belong to the specified domain.<T extends User>
T[]getAllUsersOfGroup(String groupId)
Get ALL the users that are in a group or his subgroupsList<String>
getAvailableComponentsByUser(String userId)
Gets the component instance identifiers available for the specified user?String[]
getAvailCompoIds(String sUserId)
Return the component ids available for the current user idString[]
getAvailCompoIds(String sClientSpaceId, String sUserId)
Return the component ids available for the current user id in the given space idString[]
getAvailCompoIdsAtRoot(String sClientSpaceId, String sUserId)
Return the component ids available for the current user id in the given space idList<ComponentInstLight>
getAvailComponentInstLights(String userId, String componentName)
Gets the available component for a given userCompoSpace[]
getCompoForUser(String sUserId, String sCompoName)
Return the tuples (space id, compo id) allowed for the given user and given component nameString[]
getCompoId(String sCompoName)
Return the compo id for the given component nameString[]
getComponentIdsForUser(String sUserId, String sCompoName)
Gets the component instances accessible by the specified user and spawn from the specified application in Silverpeas.ComponentInst
getComponentInst(String sComponentId)
Return the component Instance corresponding to the given component idOptional<SilverpeasComponentInstance>
getComponentInstance(String componentInstanceIdentifier)
Gets the component instance related to the given identifier.
In contrary togetComponentInst(String)
,getComponentInstLight(String)
signatures, this one is able to return different kinds of implementation ofSilverpeasComponentInstance
and it is able to deal with administration cache too.
So, this signature is useful into contexts of transverse treatments.ComponentInstLight
getComponentInstLight(String sComponentId)
Return the component Instance Light corresponding to the given component idString
getComponentParameterValue(String sComponentId, String parameterName)
Gets the value of the specified parameter of the given application instance.List<ComponentInstLight>
getComponentsWithParameterValue(String param, String value)
Gets all the component instance having the specified value for the given application parameter.List<GroupDetail>
getDirectGroupsOfUser(String userId)
Gets all the groups to which the specified user belongs explicitly.Domain
getDomain(String domainId)
Gets the domain with the specified identifier.<T extends User>
T[]getFilteredDirectUsers(String sGroupId, String sUserLastNameFilter)
For use in userPanel : return the users that are direct child of a given groupSpaceWithSubSpacesAndComponents
getFullTreeview()
Gets the complete treeview of spaces and component instances defined in Silverpeas.SpaceWithSubSpacesAndComponents
getFullTreeview(String userId)
Gets the complete treeview of spaces and component instances defined in Silverpeas accessible to the specified user.SpaceWithSubSpacesAndComponents
getFullTreeview(String userId, String spaceId)
Gets the complete treeview of spaces and component instances contained in the specified space and that are accessible to the specified user.SpaceWithSubSpacesAndComponents
getFullTreeviewOnComponentName(String userId, String componentName)
Gets the complete treeview of spaces and of instances of the specified application and that are accessible to the specified user.<T extends Group>
TgetGroup(String sGroupId)
Return the Group of the group with the given id<T extends Group>
T[]getGroups(String[] groupsId)
Return all groups specified by the groupsIdsMap<String,Map<String,String>>
getParameterValuesByComponentIdThenByParamName(Collection<String> componentIds, Collection<String> paramNames)
Gets all parameters values by component and by parameter name.List<SpaceInstLight>
getPathToComponent(String componentId)
Gets the path of the specified component instance in the organizational tree of Silverpeas.List<String>
getPathToGroup(String groupId)
Get path to GroupList<SpaceInstLight>
getPathToSpace(String spaceId)
Gets the path of the specified space in the organizational tree of Silverpeas.<T extends Group>
T[]getRecursivelyAllSubgroups(String parentGroupId)
Gets all the groups and subgroups that are children of the specified group.SpaceInstLight
getRootSpace(String spaceId)
Gets the root space for which the specified space is a direct or indirect child.List<SpaceInstLight>
getRootSpacesContainingComponent(String userId, String componentName)
Gets all the spaces at root level accessible by the specified user and containing at least one instance of the specified application.List<String>
getSearchableComponentsByCriteria(ComponentSearchCriteria criteria)
Gets the identifier of the component instances that are both searchable and that satisfy the specified criteria.SpaceInst
getSpaceInstById(String sSpaceId)
Return the space instance corresponding to the given space idSpaceInstLight
getSpaceInstLightById(String spaceId)
Return the space light corresponding to the given space idString[]
getSpaceNames(String[] asSpaceIds)
Return the spaces name corresponding to the given space ids.SpaceProfile
getSpaceProfile(String spaceId, SilverpeasRole role)
Gets the space profile instance which provides all user and group identifiers through simple methods.List<SpaceInstLight>
getSpaceTreeview(String userId)
Gets the treeview of spaces in Silverpeas available to the specified user.List<String>
getSpaceUserProfilesBySpaceId(String userId, String spaceId)
Gets all the profiles the specified user plays in the given space.Map<String,Set<String>>
getSpaceUserProfilesBySpaceIds(String userId, Collection<String> spaceIds)
Gets the profile names of given user indexed by the given space.List<SpaceInstLight>
getSubSpacesContainingComponent(String spaceId, String userId, String componentName)
Gets all the subspaces of the given space accessible by the specified user and containing at least one instance of the specified application.<T extends User>
TgetUserDetail(String sUserId)
Return the detail of the user with the given ldap id<T extends User>
T[]getUserDetails(String[] asUserIds)
Return an array of users corresponding to the given user id arrayUserFull
getUserFull(String sUserId)
Return the full detail of the user with the given ldap idList<UserFull>
getUserFulls(Collection<String> userIds)
Return a list of full detail of users corresponding toString[]
getUserManageableSpaceIds(String sUserId)
Return all the spaces id manageable by given user in SilverpeasMap<String,List<String>>
getUserObjectProfiles(String userId, String componentId, ProfiledObjectType profiledObjectType)
Gets the profile names the given user plays in the component instance for accessing the resources of the given type. instances.ProfileInst
getUserProfile(String profileId)
Gets the user profile with the specified unique identifier.String[]
getUserProfiles(String userId, String componentId)
Gets all the profiles the specified user plays in the given component instance.String[]
getUserProfiles(String userId, String componentId, ProfiledObjectId objectId)
Gets all the profiles the user have for the specified resource in the given component instance.List<ProfileInst>
getUserProfiles(String componentId, ProfiledObjectId objectId)
Gets all the user profiles defined in the specified component instance to access the specified resource.Map<String,Set<String>>
getUserProfilesByComponentId(String userId, Collection<String> componentIds)
Gets the profile names of given user indexed by the given component instances.Map<org.silverpeas.kernel.util.Pair<String,String>,Set<String>>
getUserProfilesByComponentIdAndObjectId(String userId, Collection<String> componentIds, ProfiledObjectIds profiledObjectIds)
Gets the profile names of given user indexed by couple of given component instances and object instances.<T extends User>
T[]getUsers(String componentId, String profile)
Return all the users with the given profile allowed to access the given component of the given spaceString[]
getUsersIdsByRoleNames(String componentId, List<String> profileNames)
Return userIds according to a list of profile namesString[]
getUsersIdsByRoleNames(String componentId, List<String> profileNames, boolean includeRemovedUsersAndGroups)
Return userIds according to a list of profile namesString[]
getUsersIdsByRoleNames(String componentId, ProfiledObjectId objectId, List<String> profileNames)
Gets the users playing the specified roles for the given protected resource in the specified component instance.String[]
getUsersIdsByRoleNames(String componentId, ProfiledObjectId objectId, List<String> profileNames, boolean includeRemovedUsersAndGroups)
Gets the users playing the specified roles for the given protected resource in the specified component instance.Collection<SilverpeasRole>
getUserSilverpeasRolesOn(User user, String componentInstanceIdentifier)
Gets the collection of silverpeas roles the given user has on the component instance represented by the given identifier.
In contrary togetUserProfiles(String, String)
,getUserProfiles(String, ProfiledObjectId)
orgetUserProfiles(String, String, ProfiledObjectId)
signatures, this one is able to return user roles of different kinds of implementation ofSilverpeasComponentInstance
.
So, this signature is useful into contexts of transversal treatments.
BE CAREFUL, the manager role is never returned as it corresponds to a space role.<T extends User>
List<T>getUsersOfDomains(List<String> domainIds)
Get all the users (except delete ones) that are defined in the specified domains.<T extends User>
List<T>getUsersOfDomainsFromNewestToOldest(List<String> domainIds)
Get all the users (except delete ones) that are defined in the specified domains.UserSpaceAvailabilityChecker
getUserSpaceAvailabilityChecker(String userId)
This method allows callers to perform several space availability checks for a given user.boolean
isAdminTool(String toolId)
Is the specified tool belongs to the administration component?boolean
isComponentAvailableToGroup(String componentId, String groupId)
Is the specified component instance available among the components instances accessible by the specified group of users?boolean
isComponentAvailableToUser(String componentId, String userId)
Is the specified component instance available among the components instances accessible by the specified user?boolean
isComponentExist(String componentId)
Is the specified component instance exists in Silverpeas?boolean
isComponentManageable(String componentId, String userId)
Is the specified component instance manageable by the given user?boolean
isObjectAvailableToGroup(ProfiledObjectId objectId, String componentId, String groupId)
Is the specified resource protected by access rights in the given component instance is allowed to be accessed by the specified group of users?boolean
isObjectAvailableToUser(ProfiledObjectId objectId, String componentId, String userId)
Is the specified resource protected by access rights in the given component instance is allowed to be accessed by the specified user?boolean
isSpaceAvailable(String spaceId, String userId)
Is the specified space is allowed to be accessed by the given user?boolean
isToolAvailable(String toolId)
Is the specified tool is available in Silverpeas?<T extends Group>
SilverpeasList<T>searchGroups(GroupsSearchCriteria criteria)
Searches the groups that match the specified criteria.<T extends User>
SilverpeasList<T>searchUsers(UserDetailsSearchCriteria criteria)
Searches the users that match the specified criteria.
-
-
-
Method Detail
-
get
static OrganizationController get()
Gets an object satisfying theOrganizationController
interface.- Returns:
- an
OrganizationController
object.
-
getAllSpaceIds
String[] getAllSpaceIds()
Return all the spaces available in silverpeas- Returns:
- an array with the identifiers of the spaces
-
getAllSubSpaceIds
String[] getAllSubSpaceIds(String sSpaceId)
Return all the subSpaces available in silverpeas given a space id (driver format)- Parameters:
sSpaceId
- the identifier of the parent space- Returns:
- an array with the identifiers of the subspaces.
-
getSpaceNames
String[] getSpaceNames(String[] asSpaceIds)
Return the spaces name corresponding to the given space ids.- Parameters:
asSpaceIds
- one or more space identifiers.- Returns:
- the names of the specified spaces
-
getSpaceInstLightById
SpaceInstLight getSpaceInstLightById(String spaceId)
Return the space light corresponding to the given space id- Parameters:
spaceId
- the unique identifier of a space.- Returns:
- the space
-
getSpaceInstById
SpaceInst getSpaceInstById(String sSpaceId)
Return the space instance corresponding to the given space id
-
getAvailCompoIds
String[] getAvailCompoIds(String sClientSpaceId, String sUserId)
Return the component ids available for the current user id in the given space id
-
getAvailCompoIds
String[] getAvailCompoIds(String sUserId)
Return the component ids available for the current user id
-
getAvailCompoIdsAtRoot
String[] getAvailCompoIdsAtRoot(String sClientSpaceId, String sUserId)
Return the component ids available for the current user id in the given space id
-
getCompoForUser
CompoSpace[] getCompoForUser(String sUserId, String sCompoName)
Return the tuples (space id, compo id) allowed for the given user and given component name- Parameters:
sUserId
- the identifier of a usersCompoName
- the name of a component- Returns:
- an array of tuples (space id, component instance id) of resources available by the user
-
getAvailComponentInstLights
List<ComponentInstLight> getAvailComponentInstLights(String userId, String componentName)
Gets the available component for a given user- Parameters:
userId
- user identifier used to get componentcomponentName
- type of component to retrieve ( for example : kmelia, forums, blog)- Returns:
- a list of ComponentInstLight object
-
getComponentIdsForUser
String[] getComponentIdsForUser(String sUserId, String sCompoName)
Gets the component instances accessible by the specified user and spawn from the specified application in Silverpeas.- Parameters:
sUserId
- the unique identifier of a user in Silverpeas.sCompoName
- the name of the application for which the instances have to be got.- Returns:
- an array with the identifier of component instances.
-
getCompoId
String[] getCompoId(String sCompoName)
Return the compo id for the given component name- Parameters:
sCompoName
- the name of a component- Returns:
- an array of identifiers of instances of the given component
-
getComponentParameterValue
String getComponentParameterValue(String sComponentId, String parameterName)
Gets the value of the specified parameter of the given application instance.- Parameters:
sComponentId
- the unique identifier of a component instance.parameterName
- the name of an application parameter.- Returns:
- a textual representation of the value of the parameter or an empty string if no such parameter is defined for the given component instance.
-
getComponentsWithParameterValue
List<ComponentInstLight> getComponentsWithParameterValue(String param, String value)
Gets all the component instance having the specified value for the given application parameter.- Parameters:
param
- the name of an application parameter.value
- the value of the application parameter.- Returns:
- a list of component instances.
-
getParameterValuesByComponentIdThenByParamName
Map<String,Map<String,String>> getParameterValuesByComponentIdThenByParamName(Collection<String> componentIds, Collection<String> paramNames)
Gets all parameters values by component and by parameter name.- Parameters:
componentIds
- list of component identifier.paramNames
- optional list of parameter name. All parameters are retrieved if it is not filled or null- Returns:
- a map filled with couples of parameter name / value per component instance identifier.
-
getComponentInstance
Optional<SilverpeasComponentInstance> getComponentInstance(String componentInstanceIdentifier)
Gets the component instance related to the given identifier.
In contrary togetComponentInst(String)
,getComponentInstLight(String)
signatures, this one is able to return different kinds of implementation ofSilverpeasComponentInstance
and it is able to deal with administration cache too.
So, this signature is useful into contexts of transverse treatments.- Parameters:
componentInstanceIdentifier
- the identifier of the requested component instance.- Returns:
- an optional component instance.
-
getComponentInst
ComponentInst getComponentInst(String sComponentId)
Return the component Instance corresponding to the given component id
-
getComponentInstLight
ComponentInstLight getComponentInstLight(String sComponentId)
Return the component Instance Light corresponding to the given component id
-
getUserFull
UserFull getUserFull(String sUserId)
Return the full detail of the user with the given ldap id
-
getUserFulls
List<UserFull> getUserFulls(Collection<String> userIds)
Return a list of full detail of users corresponding to
-
getUserDetail
<T extends User> T getUserDetail(String sUserId)
Return the detail of the user with the given ldap id
-
getUserDetails
<T extends User> T[] getUserDetails(String[] asUserIds)
Return an array of users corresponding to the given user id array
-
getAllUsers
<T extends User> T[] getAllUsers(String componentId)
Return all the users allowed to access the given component
-
getAllUsersInDomain
<T extends User> T[] getAllUsersInDomain(String domainId)
Gets all the users that belong to the specified domain.- Parameters:
domainId
- the unique identifier of the domain.- Returns:
- an array of users objects or null if no such domain exists.
-
searchUsers
<T extends User> SilverpeasList<T> searchUsers(UserDetailsSearchCriteria criteria)
Searches the users that match the specified criteria.- Parameters:
criteria
- the criteria in searching of user details.- Returns:
- a slice of the list of user details matching the criteria or an empty list of no ones are found. user details.
-
getAllRootGroupsInDomain
<T extends Group> T[] getAllRootGroupsInDomain(String domainId)
Gets all the user groups that belong to the specified domain.- Parameters:
domainId
- the unique identifier of the domain.- Returns:
- an array of Group objects or null if no such domain exists.
-
getFilteredDirectUsers
<T extends User> T[] getFilteredDirectUsers(String sGroupId, String sUserLastNameFilter)
For use in userPanel : return the users that are direct child of a given group
-
searchGroups
<T extends Group> SilverpeasList<T> searchGroups(GroupsSearchCriteria criteria)
Searches the groups that match the specified criteria.- Parameters:
criteria
- the criteria in searching of user groups.- Returns:
- a slice of the list of user groups matching the criteria or an empty list of no ones are found. user groups.
-
getAllSubUsersNumber
int getAllSubUsersNumber(String sGroupId)
Returns the total number of distinct users recursively contained in the specified group
-
getAllSubGroups
<T extends Group> T[] getAllSubGroups(String parentGroupId)
For use in userPanel : return the direct subgroups
-
getRecursivelyAllSubgroups
<T extends Group> T[] getRecursivelyAllSubgroups(String parentGroupId)
Gets all the groups and subgroups that are children of the specified group.- Type Parameters:
T
- the concrete type of theGroup
instances to return.- Parameters:
parentGroupId
- the unique identifier of a group.- Returns:
- an array with all the groups that are children of the specified group.
-
getAllUsers
<T extends User> T[] getAllUsers()
Return all the users of Silverpeas
-
getUsers
<T extends User> T[] getUsers(String componentId, String profile)
Return all the users with the given profile allowed to access the given component of the given space
-
getUserSilverpeasRolesOn
Collection<SilverpeasRole> getUserSilverpeasRolesOn(User user, String componentInstanceIdentifier)
Gets the collection of silverpeas roles the given user has on the component instance represented by the given identifier.
In contrary togetUserProfiles(String, String)
,getUserProfiles(String, ProfiledObjectId)
orgetUserProfiles(String, String, ProfiledObjectId)
signatures, this one is able to return user roles of different kinds of implementation ofSilverpeasComponentInstance
.
So, this signature is useful into contexts of transversal treatments.
BE CAREFUL, the manager role is never returned as it corresponds to a space role.- Parameters:
componentInstanceIdentifier
- the identifier of the component instance.- Returns:
- an optional component instance.
-
getUserProfiles
String[] getUserProfiles(String userId, String componentId)
Gets all the profiles the specified user plays in the given component instance.- Parameters:
userId
- the unique identifier of a user in Silverpeas.componentId
- the unique identifier of a component instance.- Returns:
- an array with the name of all the user profiles in the given component instance. The name of the profiles correspond to the roles the user plays in the component instance.
-
getUserProfilesByComponentId
Map<String,Set<String>> getUserProfilesByComponentId(String userId, Collection<String> componentIds)
Gets the profile names of given user indexed by the given component instances.- Parameters:
userId
- a user identifier as string.componentIds
- list of component instance identifier as string.- Returns:
- a map filled with list of profile name as string by component instance identifier as string.
-
getSpaceUserProfilesBySpaceId
List<String> getSpaceUserProfilesBySpaceId(String userId, String spaceId)
Gets all the profiles the specified user plays in the given space.- Parameters:
userId
- the unique identifier of a user in Silverpeas.spaceId
- the unique identifier of a space.- Returns:
- a list with the name of all the user profiles in the given space. The name of the profiles correspond to the roles the user plays in the space.
-
getSpaceUserProfilesBySpaceIds
Map<String,Set<String>> getSpaceUserProfilesBySpaceIds(String userId, Collection<String> spaceIds)
Gets the profile names of given user indexed by the given space.- Parameters:
userId
- a user identifier as string.spaceIds
- list of space identifier as string.- Returns:
- a map filled with list of profile name as string by space identifier as string.
-
getUserProfiles
String[] getUserProfiles(String userId, String componentId, ProfiledObjectId objectId)
Gets all the profiles the user have for the specified resource in the given component instance.- Parameters:
userId
- the unique identifier of a user.componentId
- the unique identifier of a component instance.objectId
- the unique identifier of a resource in Silverpeas whose access is covered by some user profiles.- Returns:
- an array with the name of all the user profiles the user play for the given resource in the application instance. The name of the profiles correspond to the roles the user plays.
-
getUserProfilesByComponentIdAndObjectId
Map<org.silverpeas.kernel.util.Pair<String,String>,Set<String>> getUserProfilesByComponentIdAndObjectId(String userId, Collection<String> componentIds, ProfiledObjectIds profiledObjectIds)
Gets the profile names of given user indexed by couple of given component instances and object instances.- Parameters:
userId
- a user identifier as string.componentIds
- list of component instance identifier as string.profiledObjectIds
- if NOTHING is given, then all the rows associated to the type are returned, otherwise all the rows associated to type and ids.- Returns:
- a map filled with list of profile name as string by couple component instance identifier as string - object identifier as String.
-
getUserObjectProfiles
Map<String,List<String>> getUserObjectProfiles(String userId, String componentId, ProfiledObjectType profiledObjectType)
Gets the profile names the given user plays in the component instance for accessing the resources of the given type. instances.- Parameters:
userId
- the unique identifier of a user.componentId
- the unique identifier of a component instance.profiledObjectType
- if NONE is given, then all the rows associated to the type are returned, otherwise all the rows associated to type.- Returns:
- a map associating each object whose type matches the specified one with a list of profile names.
-
getUserProfiles
List<ProfileInst> getUserProfiles(String componentId, ProfiledObjectId objectId)
Gets all the user profiles defined in the specified component instance to access the specified resource.- Parameters:
componentId
- the unique identifier of a component instance.objectId
- the unique identifier of a resource covered by access rights.- Returns:
- a list of user profiles.
-
getUserProfile
ProfileInst getUserProfile(String profileId)
Gets the user profile with the specified unique identifier.- Parameters:
profileId
- the unique identifier of a user profile.- Returns:
- the profile instance or null if no such profile exists.
-
getAdministratorUserIds
String[] getAdministratorUserIds(String fromUserId)
Return all administrators ids
-
getGroup
<T extends Group> T getGroup(String sGroupId)
Return the Group of the group with the given id
-
getGroups
<T extends Group> T[] getGroups(String[] groupsId)
Return all groups specified by the groupsIds
-
getAllGroups
<T extends Group> T[] getAllGroups()
Return all the groups of silverpeas
-
getAllRootGroups
<T extends Group> T[] getAllRootGroups()
Return all root groups of silverpeas or null if an error occurred when getting the root groups.
-
getAllUsersOfGroup
<T extends User> T[] getAllUsersOfGroup(String groupId)
Get ALL the users that are in a group or his subgroups
-
getUserManageableSpaceIds
String[] getUserManageableSpaceIds(String sUserId)
Return all the spaces id manageable by given user in Silverpeas
-
getAllRootSpaceIds
String[] getAllRootSpaceIds()
Return all the root spaceIds
-
getAllRootSpaceIds
String[] getAllRootSpaceIds(String sUserId)
Return all the root spaceIds available for the user sUserId
-
getAllSubSpaceIds
String[] getAllSubSpaceIds(String sSpaceId, String sUserId)
Return all the subSpaces id available given a space id (driver format)
-
getAllComponentIds
String[] getAllComponentIds(String sSpaceId)
Returns all the component identifiers of the space represented by the given identifier.Component instance of sub spaces are not retrieved.
It returns also ids of
SilverpeasPersonalComponentInstance
instances.
-
getAllComponentIdsRecur
String[] getAllComponentIdsRecur(String sSpaceId)
Returns all the component identifiers of the space, and its sub spaces, represented by the given identifier.It returns also ids of
SilverpeasPersonalComponentInstance
instances.
-
getRootSpacesContainingComponent
List<SpaceInstLight> getRootSpacesContainingComponent(String userId, String componentName)
Gets all the spaces at root level accessible by the specified user and containing at least one instance of the specified application.- Parameters:
userId
- the unique identifier of a user in Silverpeas.componentName
- the name of an application in Silverpeas.- Returns:
- a list of space instances.
-
getSubSpacesContainingComponent
List<SpaceInstLight> getSubSpacesContainingComponent(String spaceId, String userId, String componentName)
Gets all the subspaces of the given space accessible by the specified user and containing at least one instance of the specified application.- Parameters:
spaceId
- the unique identifier of a space in Silverpeas.userId
- the unique identifier of a user in Silverpeas.componentName
- the name of an application in Silverpeas.- Returns:
- a list of space instances.
-
isToolAvailable
boolean isToolAvailable(String toolId)
Is the specified tool is available in Silverpeas? A tool in Silverpeas is a singleton component that is dedicated to a given user. Each tool is identified by a unique identifier, and it is unique to each user.- Parameters:
toolId
- the unique identifier of a tool.- Returns:
- true if the tool is available, false otherwise.
-
getAvailableComponentsByUser
List<String> getAvailableComponentsByUser(String userId)
Gets the component instance identifiers available for the specified user? A component is an application in Silverpeas to perform some tasks and to manage some resources. Each component in Silverpeas can be instantiated several times, each of them corresponding then to a running application in Silverpeas, and it is uniquely identified from others instances by a given identifier.- Parameters:
userId
- the unique identifier of a user.- Returns:
- a list of component instance identifier as string.
-
isComponentAvailableToUser
boolean isComponentAvailableToUser(String componentId, String userId)
Is the specified component instance available among the components instances accessible by the specified user? A component is an application in Silverpeas to perform some tasks and to manage some resources. Each component in Silverpeas can be instantiated several times, each of them corresponding then to a running application in Silverpeas, and it is uniquely identified from others instances by a given identifier.- Parameters:
componentId
- the unique identifier of a component instance.userId
- the unique identifier of a user.- Returns:
- true if the component instance is available, false otherwise.
-
isComponentAvailableToGroup
boolean isComponentAvailableToGroup(String componentId, String groupId)
Is the specified component instance available among the components instances accessible by the specified group of users? A component is an application in Silverpeas to perform some tasks and to manage some resources. Each component in Silverpeas can be instantiated several times, each of them corresponding then to a running application in Silverpeas, and it is uniquely identified from others instances by a given identifier.- Parameters:
componentId
- the unique identifier of a component instance.groupId
- the unique identifier of a group of users.- Returns:
- true if the component instance is available, false otherwise.
-
isComponentExist
boolean isComponentExist(String componentId)
Is the specified component instance exists in Silverpeas?- Parameters:
componentId
- the unique identifier of a component instance.- Returns:
- true if a component instance exists in Silverpeas with the given identifier. False otherwise.
-
isComponentManageable
boolean isComponentManageable(String componentId, String userId)
Is the specified component instance manageable by the given user? The component instance is manageable if the user has enough access right to manage it.- Parameters:
componentId
- the unique identifier of the component instance.userId
- the unique identifier of a user.- Returns:
- true of the user can manage the specified component instance. False otherwise.
-
isSpaceAvailable
boolean isSpaceAvailable(String spaceId, String userId)
Is the specified space is allowed to be accessed by the given user?- Parameters:
spaceId
- the unique identifier of a spaceuserId
- the unique identifier of a user- Returns:
- true if user is allowed to access at least to one component instance in given space, false otherwise.
-
getUserSpaceAvailabilityChecker
UserSpaceAvailabilityChecker getUserSpaceAvailabilityChecker(String userId)
This method allows callers to perform several space availability checks for a given user.This is useful for treatments requiring highest performances than calling each time
isSpaceAvailable(String, String)
for example.IMPORTANT: the
UserSpaceAvailabilityChecker
MUST not be an attribute of a singleton instance.- Parameters:
userId
- the unique identifier of a user- Returns:
- a
UserSpaceAvailabilityChecker
instance initialized for the given user identifier.
-
isObjectAvailableToUser
boolean isObjectAvailableToUser(ProfiledObjectId objectId, String componentId, String userId)
Is the specified resource protected by access rights in the given component instance is allowed to be accessed by the specified user?- Parameters:
objectId
- the unique identifier of a resource protected by access rights.componentId
- the unique identifier of a component instance.userId
- the unique identifier of a user in Silverpeas.- Returns:
- true if the user can access the given resource in the component instance. False otherwise.
-
isObjectAvailableToGroup
boolean isObjectAvailableToGroup(ProfiledObjectId objectId, String componentId, String groupId)
Is the specified resource protected by access rights in the given component instance is allowed to be accessed by the specified group of users?- Parameters:
objectId
- the unique identifier of a resource protected by access rights.componentId
- the unique identifier of a component instance.groupId
- the unique identifier of a group of users in Silverpeas.- Returns:
- true if the group can access the given resource in the component instance. False otherwise.
-
getSpaceTreeview
List<SpaceInstLight> getSpaceTreeview(String userId)
Gets the treeview of spaces in Silverpeas available to the specified user.- Parameters:
userId
- the unique identifier of a user.- Returns:
- a list of space instances accessible by the user and modeling a treeview.
-
getAllowedSubSpaceIds
String[] getAllowedSubSpaceIds(String userId, String spaceFatherId)
Gets the all the subspaces of the specified space accessible to the given user.- Parameters:
userId
- the unique identifier of a user.spaceFatherId
- the unique identifier of a space.- Returns:
- an array with the identifiers of the subspaces.
-
getRootSpace
SpaceInstLight getRootSpace(String spaceId)
Gets the root space for which the specified space is a direct or indirect child. If the given space is yet a root space, it returns just its instance.- Parameters:
spaceId
- the unique identifier of a space in Silverpeas.- Returns:
- the space instance representing the root space, parent of the given space, or null if the given space doesn't exist.
-
getAllUsersIds
String[] getAllUsersIds()
Return all the users of Silverpeas
-
getUsersIdsByRoleNames
String[] getUsersIdsByRoleNames(String componentId, List<String> profileNames)
Return userIds according to a list of profile names- Parameters:
componentId
- the instance idprofileNames
- the list which contains the profile names- Returns:
- a string array of user id
-
getUsersIdsByRoleNames
String[] getUsersIdsByRoleNames(String componentId, List<String> profileNames, boolean includeRemovedUsersAndGroups)
Return userIds according to a list of profile names- Parameters:
componentId
- the instance idprofileNames
- the list which contains the profile namesincludeRemovedUsersAndGroups
- users in removed state are taken into account- Returns:
- a string array of user id
-
getUsersIdsByRoleNames
String[] getUsersIdsByRoleNames(String componentId, ProfiledObjectId objectId, List<String> profileNames)
Gets the users playing the specified roles for the given protected resource in the specified component instance.- Parameters:
componentId
- the unique identifier of a component instance.profileNames
- the list which contains the profile names- Returns:
- an array with the user identifiers.
-
getUsersIdsByRoleNames
String[] getUsersIdsByRoleNames(String componentId, ProfiledObjectId objectId, List<String> profileNames, boolean includeRemovedUsersAndGroups)
Gets the users playing the specified roles for the given protected resource in the specified component instance.- Parameters:
componentId
- the unique identifier of a component instance.profileNames
- the list which contains the profile namesincludeRemovedUsersAndGroups
- users in removed state are taken into account- Returns:
- an array with the user identifiers.
-
getDomain
Domain getDomain(String domainId)
Gets the domain with the specified identifier.- Parameters:
domainId
- the unique identifier of a user domain.- Returns:
- a
Domain
instance or null if no such user domain exists.
-
getAllDomains
Domain[] getAllDomains()
Gets all the user domains defined in Silverpeas.- Returns:
- an array of
Domain
instances.
-
getDirectGroupsOfUser
List<GroupDetail> getDirectGroupsOfUser(String userId)
Gets all the groups to which the specified user belongs explicitly. The parent groups to which the user doesn't belong directly but only by the children group(s) it belongs to aren't taken into account.- Parameters:
userId
- the unique identifier of a user.- Returns:
- a list of group of users to which the given user explicitly belongs.
-
getAllGroupIdsOfUser
String[] getAllGroupIdsOfUser(String userId)
Gets all the groups to which the specified user belongs. All the groups are taken into account, even those to which he doesn't belong directly but only by a child group.- Parameters:
userId
- the unique identifier of a user.- Returns:
- an array with the identifier of all the groups the user is concerned.
-
getAllowedComponentIds
String[] getAllowedComponentIds(String userId)
Gets all the component instances in Silverpeas allowed to be accessed by the specified user.- Parameters:
userId
- the unique identifier of a user.- Returns:
- an array with the identifier of the component instances accessible to the given user.
-
getUsersOfDomainsFromNewestToOldest
<T extends User> List<T> getUsersOfDomainsFromNewestToOldest(List<String> domainIds)
Get all the users (except delete ones) that are defined in the specified domains.- Parameters:
domainIds
- a list of domain identifiers.- Returns:
- a list of users belonging to the given domains sorted by reverse creation order.
-
getUsersOfDomains
<T extends User> List<T> getUsersOfDomains(List<String> domainIds)
Get all the users (except delete ones) that are defined in the specified domains.- Parameters:
domainIds
- a list of domain identifiers.- Returns:
- a list of users belonging to the given domains sorted by the alphabetic order of their name.
-
isAdminTool
boolean isAdminTool(String toolId)
Is the specified tool belongs to the administration component? The administration component (or administrative console) forms a particular component made up of several tools, each of them providing an administrative feature. Each tool in the administration component have the same identifier that refers in fact the administration console.- Parameters:
toolId
- the unique identifier of the tool.- Returns:
- true if the tool belongs to the administration component.
-
getSearchableComponentsByCriteria
List<String> getSearchableComponentsByCriteria(ComponentSearchCriteria criteria)
Gets the identifier of the component instances that are both searchable and that satisfy the specified criteria.- Parameters:
criteria
- the criteria on the component instances to get.- Returns:
- a list of component instance identifiers.
-
getSpaceProfile
SpaceProfile getSpaceProfile(String spaceId, SilverpeasRole role)
Gets the space profile instance which provides all user and group identifiers through simple methods.- Parameters:
spaceId
- the identifier of aimed space.role
- the aimed technical role name.- Returns:
- the
SpaceProfile
instance.
-
getFullTreeview
SpaceWithSubSpacesAndComponents getFullTreeview() throws AdminException
Gets the complete treeview of spaces and component instances defined in Silverpeas.- Returns:
- a
SpaceWithSubSpacesAndComponents
instance representing the complete treeview of the organizational resources defined in Silverpeas. - Throws:
AdminException
- if an error occurs while computing the treeview.
-
getFullTreeview
SpaceWithSubSpacesAndComponents getFullTreeview(String userId) throws AdminException
Gets the complete treeview of spaces and component instances defined in Silverpeas accessible to the specified user.- Parameters:
userId
- the unique identifier of a user in Silverpeas.- Returns:
- a
SpaceWithSubSpacesAndComponents
instance representing the complete treeview of the organizational resources defined in Silverpeas and accessible to the given user. - Throws:
AdminException
- if an error occurs while computing the treeview.
-
getFullTreeviewOnComponentName
SpaceWithSubSpacesAndComponents getFullTreeviewOnComponentName(String userId, String componentName) throws AdminException
Gets the complete treeview of spaces and of instances of the specified application and that are accessible to the specified user.- Parameters:
userId
- the unique identifier of a user in Silverpeas.componentName
- the name of an application in Silverpeas.- Returns:
- a
SpaceWithSubSpacesAndComponents
instance representing the complete treeview accessible to the given user, with only as component instances those of the given application. - Throws:
AdminException
- if an error occurs while computing the treeview.
-
getFullTreeview
SpaceWithSubSpacesAndComponents getFullTreeview(String userId, String spaceId) throws AdminException
Gets the complete treeview of spaces and component instances contained in the specified space and that are accessible to the specified user.- Parameters:
userId
- the unique identifier of a user in Silverpeas.spaceId
- the unique identifier of a space.- Returns:
- a
SpaceWithSubSpacesAndComponents
instance representing the complete treeview rooted to the given space and accessible to the given user. - Throws:
AdminException
- if an error occurs while computing the treeview.
-
getPathToSpace
@NonNull List<SpaceInstLight> getPathToSpace(@NonNull String spaceId)
Gets the path of the specified space in the organizational tree of Silverpeas.- Parameters:
spaceId
- the unique identifier of a space.- Returns:
- a list of space instances ordered from the root space to the specified one, each of them representing a node of the path.
-
getPathToComponent
List<SpaceInstLight> getPathToComponent(String componentId)
Gets the path of the specified component instance in the organizational tree of Silverpeas.- Parameters:
componentId
- the unique identifier of a component instance.- Returns:
- a list of space instances ordered from the root space to the space to which the component instance belongs directly. Each of then represents a node in the path to the given component instance.
-
-