com.collabnet.ce.soap60.webservices.rbac
Interface IRbacAppSoap


public interface IRbacAppSoap

SOAP APIs for Role Based Access Control (RBAC).

Change History
Version 6.1
Version 6.0.1
Version 6.0
Version 5.4
Version 5.2
Version 4.4

Since:
4.1-HOTFIX4

Method Summary
 void addCluster(java.lang.String sessionId, java.lang.String roleId, java.lang.String operationCluster, java.lang.String folderId)
          Adds an operation cluster to a role, expanding the permission set that the role grants access to.
 void addGroup(java.lang.String sessionId, java.lang.String groupId, java.lang.String roleId, java.lang.String projectOrProjectGroupId)
          Adds a user group to a role, within the Project/ProjectGroup scope.
 void addUser(java.lang.String sessionId, java.lang.String roleId, java.lang.String username)
          Adds a user to the role, giving them all of the permissions of that role
 void addUserToProjectRole(java.lang.String sessionId, java.lang.String roleId, java.lang.String username, java.lang.String projectOrProjectGroupId)
          Adds a user to the role in the given project context, giving them all of the permissions of that role in that project Same as addUser but also takes projectOrProjectGroupId as an additional parameter.
 void approveRoleRequest(java.lang.String sessionId, java.lang.String requestId, java.lang.String projectId)
          Approves a role request
 RoleSoapDO createGlobalRole(java.lang.String sessionId, java.lang.String title, java.lang.String description, boolean preventInheritance, boolean requestable)
          Creates a global role.
 RoleSoapDO createRole(java.lang.String sessionId, java.lang.String projectOrProjectGroupId, java.lang.String title, java.lang.String description, boolean preventInheritance, boolean requestable, boolean autoGrant)
          Creates a role in a given project
 RoleSoapDO createSiteWideRole(java.lang.String sessionId, java.lang.String title, java.lang.String description, boolean preventInheritance)
          Creates a site-wide role.
 void deleteRole(java.lang.String sessionId, java.lang.String roleId)
          Deletes a role.
 boolean getAutomaticallyGrantOnRequest(java.lang.String sessionId, java.lang.String roleId, java.lang.String projectId)
          Gets the role's Automatically Grant On Request for the given project.
 RoleSoapList getGlobalRoleList(java.lang.String sessionId)
          Returns a list of all the global roles available on the site.
 RoleSoapList getGlobalRolesForAssignment(java.lang.String sessionId, java.lang.String projectOrProjectGroupId)
          Returns a list of global roles available in the project or project group for user/user group assignment.
 RoleSoapList getGroupRoleList(java.lang.String sessionId, java.lang.String groupId, java.lang.String projectIdOrProjectGroupId)
          Returns a list of roles the user group is associated with in a project or projectGroup.
 RoleSoapList getInheritedRoleList(java.lang.String sessionId, java.lang.String projectId)
          Gets a list of roles inherited from any of the parent projects.
 java.lang.String[] getIntegratedAppPermissionsForProject(java.lang.String sessionId, java.lang.String projectId, java.lang.String linkId)
          Returns integratedApp permissions for the user associated with a project
 RoleRequestSoapList getPendingRequestedRoles(java.lang.String sessionId, java.lang.String projectId)
          Lists the pending requested roles for the given projectId
 UserSoapList getProjectRoleMemberList(java.lang.String sessionId, java.lang.String roleId, java.lang.String projectOrProjectGroupId)
          Returns a list of users that are in a specified role in the given project or project group. 1.
 java.lang.String[] getProjectsByIntegratedAppPermission(java.lang.String sessionId, java.lang.String perm, java.lang.String integratedAppName)
          Returns the list of projects by integratedApp permission.
 ProjectSoapList getProjectsForAction(java.lang.String sessionId, java.lang.String operationString, java.lang.String userName)
          Gets the list of all projects in which the given user has given permission.
 UserGroupSoapList getRoleGroupList(java.lang.String sessionId, java.lang.String roleId)
          Returns a list of user groups that belong to the specified role.
 UserSoapList getRoleGroupUsers(java.lang.String sessionId, java.lang.String projectIdOrProjectGroupId, java.lang.String roleId)
          Returns a list of users who are part of a group and associated with the specified role.
 RoleSoapList getRoleList(java.lang.String sessionId, java.lang.String projectOrProjectGroupId)
          Gets a list of Roles in a project context.
 UserSoapList getRoleMemberList(java.lang.String sessionId, java.lang.String roleId)
          Returns a list of users that are assigned to the specified role.
 RoleSoapList getSiteWideRoleList(java.lang.String sessionId)
          Returns a list of all the site-wide roles available on the site.
 RoleSoapList getUserRoleList(java.lang.String sessionId, java.lang.String projectOrProjectGroupId, java.lang.String username)
          Returns a list of roles that a user is a member of in the specified project or project group.
 RoleSoapList getUserSiteWideRoleList(java.lang.String sessionId, java.lang.String username)
          Returns a list of roles that a user is a member of site wide role.
 void grantRolesToMembers(java.lang.String sessionId, UserRolesSoapDO[] userRolesSoapDOs, java.lang.String projectId)
          Grants roles to list of users in a given project and user is made as member of the project if not already.
 RoleClusterSoapList listClusters(java.lang.String sessionId, java.lang.String roleId)
          Gets the list of operation cluster assigned to a role.
 RoleGroupSoapList listGroupRolesByProject(java.lang.String sessionId, java.lang.String projectId)
          Returns a list of user groups and the roles it is associated with in a project.
 RoleGroupSoapList listGroupRolesByProjectGroup(java.lang.String sessionId, java.lang.String projectGroupId)
          Returns a list of user groups and the roles it is associated with in a project group.
 SoapNamedValues listRolePaths(java.lang.String sessionId, java.lang.String roleId, java.lang.String repositoryId)
          Gets the list of paths for a role.
 void rejectRoleRequest(java.lang.String sessionId, java.lang.String requestId, java.lang.String projectId)
          Rejects a role request
 void removeCluster(java.lang.String sessionId, java.lang.String roleId, java.lang.String operationCluster, java.lang.String folderId)
          Removes an operation cluster to a role, removing the permission set.
 void removeGroup(java.lang.String sessionId, java.lang.String groupId, java.lang.String roleId, java.lang.String projectOrProjectGroupId)
          Removes the user group for the role, within the Project/ProjectGroup scope
 void removeUser(java.lang.String sessionId, java.lang.String roleId, java.lang.String username)
          Removes a user from a role The behavior of this API is as follows. 1) Removing users is not supported for global role.
 void removeUserFromProjectRole(java.lang.String sessionId, java.lang.String roleId, java.lang.String username, java.lang.String projectOrProjectGroupId)
          Removes a user from a role in the given project Same as removeUser but also takes projectOrProjectGroupId as an additional parameter.
 void requestRole(java.lang.String sessionId, java.lang.String roleId, java.lang.String projectId)
          Requests a role
 void revokeRolesFromMembers(java.lang.String sessionId, UserRolesSoapDO[] userRolesSoapDOs, java.lang.String projectId)
          Removes roles from users in the project
 void setAutomaticallyGrantOnRequest(java.lang.String sessionId, java.lang.String roleId, java.lang.String projectId, boolean autoGrant)
          Sets the role's Automatically Grant On Request for the given project.
 void setRoleData(java.lang.String sessionId, RoleSoapDO roleData)
          Saves a role object.
 void setRolePaths(java.lang.String sessionId, java.lang.String roleId, java.lang.String repositoryId, SoapNamedValues rolePaths)
          Sets the list of paths for a role.
 

Method Detail

createRole

RoleSoapDO createRole(java.lang.String sessionId,
                      java.lang.String projectOrProjectGroupId,
                      java.lang.String title,
                      java.lang.String description,
                      boolean preventInheritance,
                      boolean requestable,
                      boolean autoGrant)
                      throws java.rmi.RemoteException
Creates a role in a given project

Parameters:
sessionId - User session Id
projectOrProjectGroupId - The project /project group Id to create the role in
title - The title of the role
description - A description of the role
preventInheritance - If the role's permission is prevented from applying to private subprojects.
requestable - If the role is available upon request:Only applicable for Project Roles Not for Project Groups.
autoGrant - If the role is granted automatically on request:Only applicable for Project Roles Not for Project Groups.
Returns:
The Role2SoapDO that was created
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the projectId is invalid or the created roleId is invalid.
com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - If the role exists with the specified title in the project
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
4.1-HOTFIX4

createSiteWideRole

RoleSoapDO createSiteWideRole(java.lang.String sessionId,
                              java.lang.String title,
                              java.lang.String description,
                              boolean preventInheritance)
                              throws java.rmi.RemoteException
Creates a site-wide role. Users with site-admin permissions or users having rolecreate permissions for creating site-wide role will be able to create site-wide role.

Parameters:
sessionId - User session Id
title - The title of the site-wide role
description - A description of the role
preventInheritance - If the role's permission is prevented from applying to private projects.
Returns:
The Role2SoapDO that was created
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the created roleId is invalid
com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - If the role exists with the specified title in the project
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
6.0

createGlobalRole

RoleSoapDO createGlobalRole(java.lang.String sessionId,
                            java.lang.String title,
                            java.lang.String description,
                            boolean preventInheritance,
                            boolean requestable)
                            throws java.rmi.RemoteException
Creates a global role. Only Super-users or users having Role-Create permission can create global role.

Parameters:
sessionId - User session Id
title - The title of the global role
description - The description of the global role
preventInheritance - If the role's permission is prevented from applying to private projects.
requestable - If the role is available upon request
Returns:
The Role2SoapDO that was created
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the created roleId is invalid
com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - If the global role exists with the specified title
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
6.0

setRoleData

void setRoleData(java.lang.String sessionId,
                 RoleSoapDO roleData)
                 throws java.rmi.RemoteException
Saves a role object. Project Admins in the case of a project-level role and users having Role - Edit permissions through a site-wide role in the case of SiteWide/Global roles are allowed to save.

Parameters:
sessionId - User session Id
roleData - the role object to save
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.VersionMismatchFault - The role version being edited is not the latest one
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
java.rmi.RemoteException
Since:
6.0

deleteRole

void deleteRole(java.lang.String sessionId,
                java.lang.String roleId)
                throws java.rmi.RemoteException
Deletes a role.

Parameters:
sessionId - User session Id
roleId - The id of the role to be deleted
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the projectId is invalid
java.rmi.RemoteException
Since:
4.4

addCluster

void addCluster(java.lang.String sessionId,
                java.lang.String roleId,
                java.lang.String operationCluster,
                java.lang.String folderId)
                throws java.rmi.RemoteException
Adds an operation cluster to a role, expanding the permission set that the role grants access to.

Parameters:
sessionId - User session Id
roleId - The role id to add the cluster to
operationCluster - The cluster name to add to the role. See OperationClusterConstants.
folderId - the folder id for the specified cluster. Pass in empty string to apply to all folders of the same type in the project. Note that passing in an empty folder id will not replace existing folder specific clusters.
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid
com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - If the cluster already exists in the role
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
4.4

removeCluster

void removeCluster(java.lang.String sessionId,
                   java.lang.String roleId,
                   java.lang.String operationCluster,
                   java.lang.String folderId)
                   throws java.rmi.RemoteException
Removes an operation cluster to a role, removing the permission set.

Parameters:
sessionId - User session Id
roleId - The role id to remove the cluster to
operationCluster - The cluster name to add to the role
folderId - the folder id for the specified cluster. Pass in empty string to remove a cluster defined for all folders. Note that passing in an empty folder id will not remove existing folder specific clusters.
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid
java.rmi.RemoteException
Since:
4.4

listClusters

RoleClusterSoapList listClusters(java.lang.String sessionId,
                                 java.lang.String roleId)
                                 throws java.rmi.RemoteException
Gets the list of operation cluster assigned to a role.

Parameters:
sessionId - User session Id
roleId - The ID of the role for which clusters will be listed
Returns:
list of clusters for a role
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid
java.rmi.RemoteException
Since:
4.4

addUser

void addUser(java.lang.String sessionId,
             java.lang.String roleId,
             java.lang.String username)
             throws java.rmi.RemoteException
Adds a user to the role, giving them all of the permissions of that role

Parameters:
sessionId - User sessionId
roleId - The role id to add the user to
username - The username of the user to add to the role
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid
com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - If the user already exists in the role
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
4.1-HOTFIX4

grantRolesToMembers

void grantRolesToMembers(java.lang.String sessionId,
                         UserRolesSoapDO[] userRolesSoapDOs,
                         java.lang.String projectId)
                         throws java.rmi.RemoteException
Grants roles to list of users in a given project and user is made as member of the project if not already.

Parameters:
sessionId - User sessionId
userRolesSoapDOs - user to roles data container, simulation of map - key as user and lists of roles as values
projectId - project to which users would be the members with the given roles.
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid
com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - If the user already exists in the role
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
6.0

removeUser

void removeUser(java.lang.String sessionId,
                java.lang.String roleId,
                java.lang.String username)
                throws java.rmi.RemoteException
Removes a user from a role The behavior of this API is as follows. 1) Removing users is not supported for global role. When a global role's id is passed to this API it will throw a NoSuchObjectFault.

Parameters:
sessionId - User sessionId
roleId - The role id to add the user to
username - The username of the user to add to the role
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
4.3-HOTFIX1

revokeRolesFromMembers

void revokeRolesFromMembers(java.lang.String sessionId,
                            UserRolesSoapDO[] userRolesSoapDOs,
                            java.lang.String projectId)
                            throws java.rmi.RemoteException
Removes roles from users in the project

Parameters:
sessionId - User sessionId
userRolesSoapDOs - user to roles data container, simulation of map - key as user and lists of roles to remove as values
projectId - project in which roles would be removed from the users.
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
6.0

addUserToProjectRole

void addUserToProjectRole(java.lang.String sessionId,
                          java.lang.String roleId,
                          java.lang.String username,
                          java.lang.String projectOrProjectGroupId)
                          throws java.rmi.RemoteException
Adds a user to the role in the given project context, giving them all of the permissions of that role in that project Same as addUser but also takes projectOrProjectGroupId as an additional parameter. If a Project Group's role is being assigned in a normal project (even if it is a member of this Project Group) or in another Project Group a SystemFault will be thrown. Because A Project Group's role can only be assigned within that Project Group and nowhere else. Also site-wide role are not supported. For site-wide role use addUser method.

Parameters:
sessionId - User sessionId
roleId - The role id to add the user to
username - The username of the user to add to the role
projectOrProjectGroupId - projectId (or) Project group ID. The project/Project Group in which the role has to be added to the user. The permission check varies accordingly for Project- User with Edit Role permissions. ProjectGroup-ProjectGroup.Admin Permission
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid
com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - If the user already exists in the role
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
6.0 (renamed from addUser2 in 6.1)
See Also:
addUser(java.lang.String, java.lang.String, java.lang.String)

removeUserFromProjectRole

void removeUserFromProjectRole(java.lang.String sessionId,
                               java.lang.String roleId,
                               java.lang.String username,
                               java.lang.String projectOrProjectGroupId)
                               throws java.rmi.RemoteException
Removes a user from a role in the given project Same as removeUser but also takes projectOrProjectGroupId as an additional parameter.

Parameters:
sessionId - User sessionId
roleId - The role id to add the user to
username - The username of the user to add to the role
projectOrProjectGroupId - projectId (or) Project group ID. The project/Project Group in which the role has to be removed from the user. The permission check varies accordingly: for Project - User with Edit Role permissions. for ProjectGroup - ProjectGroup.Admin Permission
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
6.0 (renamed from removeUser2 in 6.1)
See Also:
removeUser(java.lang.String, java.lang.String, java.lang.String)

addGroup

void addGroup(java.lang.String sessionId,
              java.lang.String groupId,
              java.lang.String roleId,
              java.lang.String projectOrProjectGroupId)
              throws java.rmi.RemoteException
Adds a user group to a role, within the Project/ProjectGroup scope. If a Project Group's role is being assigned in a normal project (even if it is a member of this Project Group) or in another Project Group a SystemFault will be thrown. Because A Project Group's role can only be assigned within that Project Group and nowhere else.

Parameters:
sessionId - User sessionId.
groupId - the user group to be added.
roleId - The role to which the user group is to be added.
projectOrProjectGroupId - The project/projectgroup id to which the role belongs.
Throws:
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid.
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user does not have permission to perform the operation.
com.collabnet.ce.soap60.fault.SystemFault - When an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid.
com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - If the user group already exists in the role.
java.rmi.RemoteException
Since:
4.4-SP1

removeGroup

void removeGroup(java.lang.String sessionId,
                 java.lang.String groupId,
                 java.lang.String roleId,
                 java.lang.String projectOrProjectGroupId)
                 throws java.rmi.RemoteException
Removes the user group for the role, within the Project/ProjectGroup scope

Parameters:
sessionId - User sessionId.
groupId - the user group to be added.
roleId - The role to which the user group is to be added.
projectOrProjectGroupId - The project/projectgroup id to which the role belongs.
Throws:
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid.
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user does not have permission to perform the operation.
com.collabnet.ce.soap60.fault.SystemFault - When an unexpected system level error occurs.
java.rmi.RemoteException
Since:
4.4-SP1

getRoleList

RoleSoapList getRoleList(java.lang.String sessionId,
                         java.lang.String projectOrProjectGroupId)
                         throws java.rmi.RemoteException
Gets a list of Roles in a project context. This call required project admin permissions.

Parameters:
sessionId - User session Id
projectOrProjectGroupId - The Project/Project Group Id to list roles from
Returns:
The RoleSoapList describing all roles in the project
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the projectId is invalid
com.collabnet.ce.soap60.fault.ObjectAlreadyExistsFault - If the role exists with the specified title in the project
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
4.3

getInheritedRoleList

RoleSoapList getInheritedRoleList(java.lang.String sessionId,
                                  java.lang.String projectId)
                                  throws java.rmi.RemoteException
Gets a list of roles inherited from any of the parent projects. This call requires project admin permission.

Parameters:
sessionId - User session Id
projectId - The project Id to list the inherited roles from
Returns:
The Role2SoapList describing all inherited roles in the project
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the projectId is invalid
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
6.0

getRoleMemberList

UserSoapList getRoleMemberList(java.lang.String sessionId,
                               java.lang.String roleId)
                               throws java.rmi.RemoteException
Returns a list of users that are assigned to the specified role. The behavior of this API is as follows. 1) Retrieving users assigned to a global role is not supported. When a global role's id is passed to this API it will throw a NoSuchObjectFault 2) When invoked on a project role (i.e., a role created in a project) returns all the users assigned to this role in that project and any users assigned to this role in any of the sub projects of the project in which this role is created. 3) When invoked on a site-wide role returns all the users assigned to that site-wide role. 4) When invoked on a role created in a Project Group, returns all the users assigned to that role in the Project Group.

Parameters:
sessionId - User session id.
roleId - Role id.
Returns:
List of users in the specified role.
Throws:
com.collabnet.ce.soap60.fault.IllegalArgumentFault - Role id is not specified or invalid.
com.collabnet.ce.soap60.fault.InvalidSessionFault - if the session is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - if the user does not have permission to perform the operation
com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified role id is invalid
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
java.rmi.RemoteException
Since:
4.3-SP1

getProjectRoleMemberList

UserSoapList getProjectRoleMemberList(java.lang.String sessionId,
                                      java.lang.String roleId,
                                      java.lang.String projectOrProjectGroupId)
                                      throws java.rmi.RemoteException
Returns a list of users that are in a specified role in the given project or project group. 1. Supports depreciated method getRoleMemberListForProject 2. Supports project roles assigned in the project where the role is created. 3. Supports inherited role assignments in any of its subprojects. 4. Assignments to roles created in Project Groups. 5. Global role assignments in projects and project groups.

Parameters:
sessionId - User session id.
roleId - Role id.
projectOrProjectGroupId - Project or Project Group Id
Returns:
List of users in the specified role in the given project or project group.
Throws:
com.collabnet.ce.soap60.fault.IllegalArgumentFault - Role id is not specified or invalid.
com.collabnet.ce.soap60.fault.InvalidSessionFault - if the session is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - if the user does not have permission to perform the operation
com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified role id is invalid
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
java.rmi.RemoteException
Since:
6.0.1 (renamed from getRoleMemberList2 in 6.1)

getUserRoleList

RoleSoapList getUserRoleList(java.lang.String sessionId,
                             java.lang.String projectOrProjectGroupId,
                             java.lang.String username)
                             throws java.rmi.RemoteException
Returns a list of roles that a user is a member of in the specified project or project group. In order to view the list of roles another user belongs to, the caller must be an admin of that project or project group.

Parameters:
sessionId - User session id.
projectOrProjectGroupId - Project or Project Group id.
username - Name of the user.
Returns:
List of roles that a user is a member of.
Throws:
com.collabnet.ce.soap60.fault.IllegalArgumentFault - Username is not specified or invalid.
com.collabnet.ce.soap60.fault.InvalidSessionFault - if the session is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - if the user does not have permission to perform the operation
com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project or project group id is invalid
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
java.rmi.RemoteException
Since:
4.3-SP1

getUserSiteWideRoleList

RoleSoapList getUserSiteWideRoleList(java.lang.String sessionId,
                                     java.lang.String username)
                                     throws java.rmi.RemoteException
Returns a list of roles that a user is a member of site wide role. To view the site wide role members the uses must have admin permissions or role view permissions.

Parameters:
sessionId - User session id.
username - Name of the user.
Returns:
List of site-wide roles that a user is a member of.
Throws:
com.collabnet.ce.soap60.fault.IllegalArgumentFault - Username is not specified or invalid.
com.collabnet.ce.soap60.fault.InvalidSessionFault - if the session is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - if the user does not have permission to perform the operation
com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project id is invalid
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
java.rmi.RemoteException
Since:
6.0

getSiteWideRoleList

RoleSoapList getSiteWideRoleList(java.lang.String sessionId)
                                 throws java.rmi.RemoteException
Returns a list of all the site-wide roles available on the site. The user must have site admin permission or site-wide role admin permission to list all the site-wide roles.

Parameters:
sessionId - User session id.
Returns:
List of site-wide roles available
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - if the session is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - if the user does not have the permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
java.rmi.RemoteException
Since:
6.0

getGlobalRoleList

RoleSoapList getGlobalRoleList(java.lang.String sessionId)
                               throws java.rmi.RemoteException
Returns a list of all the global roles available on the site. The user must have site admin permission or site-wide role admin/view permission to list all the global roles.

Parameters:
sessionId - User session id.
Returns:
List of global roles available
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - if the session is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - if the user does not have the permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
java.rmi.RemoteException
Since:
6.0

getGlobalRolesForAssignment

RoleSoapList getGlobalRolesForAssignment(java.lang.String sessionId,
                                         java.lang.String projectOrProjectGroupId)
                                         throws java.rmi.RemoteException
Returns a list of global roles available in the project or project group for user/user group assignment. The user must be an admin of that project or project group to get the list.

Parameters:
sessionId - User session id.
projectOrProjectGroupId - the project or project group from which to get the global roles list
Returns:
List of global roles available
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - if the session is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - if the user does not have the permission to perform the operation
com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project or project group id is invalid
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
java.rmi.RemoteException
Since:
6.0

getGroupRoleList

RoleSoapList getGroupRoleList(java.lang.String sessionId,
                              java.lang.String groupId,
                              java.lang.String projectIdOrProjectGroupId)
                              throws java.rmi.RemoteException
Returns a list of roles the user group is associated with in a project or projectGroup.

Parameters:
sessionId - User session id.
groupId - User Group id.
projectIdOrProjectGroupId - Project id or project group id.
Returns:
List of roles the user group is associated with.
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - if the session is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - if the user does not have permission to perform the operation.
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project id or project group id is invalid.
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid.
java.rmi.RemoteException
Since:
4.4-SP1

getRoleGroupList

UserGroupSoapList getRoleGroupList(java.lang.String sessionId,
                                   java.lang.String roleId)
                                   throws java.rmi.RemoteException
Returns a list of user groups that belong to the specified role.

Parameters:
sessionId - User session id.
roleId - Role id.
Returns:
List of user groups associated with a role.
Throws:
com.collabnet.ce.soap60.fault.IllegalArgumentFault - roleId is not specified or invalid.
com.collabnet.ce.soap60.fault.InvalidSessionFault - if the session is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - if the user does not have permission to perform the operation.
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project id is invalid.
java.rmi.RemoteException
Since:
4.4-SP1

listGroupRolesByProject

RoleGroupSoapList listGroupRolesByProject(java.lang.String sessionId,
                                          java.lang.String projectId)
                                          throws java.rmi.RemoteException
Returns a list of user groups and the roles it is associated with in a project.

Parameters:
sessionId - User session id.
projectId - Project id.
Returns:
list of user groups and the roles it is associated with
Throws:
com.collabnet.ce.soap60.fault.IllegalArgumentFault - projectId is not specified or invalid.
com.collabnet.ce.soap60.fault.InvalidSessionFault - if the session is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - if the user does not have permission to perform the operation.
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project id is invalid.
java.rmi.RemoteException
Since:
4.4-SP1

getRoleGroupUsers

UserSoapList getRoleGroupUsers(java.lang.String sessionId,
                               java.lang.String projectIdOrProjectGroupId,
                               java.lang.String roleId)
                               throws java.rmi.RemoteException
Returns a list of users who are part of a group and associated with the specified role.

Parameters:
sessionId - User session id.
projectIdOrProjectGroupId - Project or Project Group's id.
roleId - Role id.
Returns:
List of users in the specified role.
Throws:
com.collabnet.ce.soap60.fault.IllegalArgumentFault - Role id is not specified or invalid.
com.collabnet.ce.soap60.fault.InvalidSessionFault - if the session is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - if the user does not have permission to perform the operation
com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified role id is invalid
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
java.rmi.RemoteException
Since:
4.4-SP1

listRolePaths

SoapNamedValues listRolePaths(java.lang.String sessionId,
                              java.lang.String roleId,
                              java.lang.String repositoryId)
                              throws java.rmi.RemoteException
Gets the list of paths for a role.

Parameters:
sessionId - User session Id
roleId - the key of the role the role paths belongs to
repositoryId - the repository id
Returns:
role path in soap named values format
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
5.2

setRolePaths

void setRolePaths(java.lang.String sessionId,
                  java.lang.String roleId,
                  java.lang.String repositoryId,
                  SoapNamedValues rolePaths)
                  throws java.rmi.RemoteException
Sets the list of paths for a role.

Parameters:
sessionId - User session Id
roleId - the key of the role the role paths belongs to
repositoryId - the repository id
rolePaths - list of role paths
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId is invalid
com.collabnet.ce.soap60.fault.IllegalArgumentFault - If one of the parameters is invalid
java.rmi.RemoteException
Since:
5.2

getProjectsForAction

ProjectSoapList getProjectsForAction(java.lang.String sessionId,
                                     java.lang.String operationString,
                                     java.lang.String userName)
                                     throws java.rmi.RemoteException
Gets the list of all projects in which the given user has given permission.

Parameters:
sessionId - User session Id
operationString - Operation in format type.category.name, except for integrated application, which is in format PluggableLink.<id of the integrated app>.<permission name>.<permission name>.
userName - the user who would have cluster permission in the returned project list
Returns:
List of projects
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - when the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - when the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.IllegalArgumentFault - when the arguments are null or empty.
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the userName doesn't exist.
java.rmi.RemoteException
Since:
6.0

requestRole

void requestRole(java.lang.String sessionId,
                 java.lang.String roleId,
                 java.lang.String projectId)
                 throws java.rmi.RemoteException
Requests a role

Parameters:
sessionId - User session Id
roleId - the role id
projectId - project in which to make the request
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the roleId or projectId is invalid
com.collabnet.ce.soap60.fault.IllegalArgumentFault - incorrect parameters
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
java.rmi.RemoteException
Since:
6.0

setAutomaticallyGrantOnRequest

void setAutomaticallyGrantOnRequest(java.lang.String sessionId,
                                    java.lang.String roleId,
                                    java.lang.String projectId,
                                    boolean autoGrant)
                                    throws java.rmi.RemoteException
Sets the role's Automatically Grant On Request for the given project.

Parameters:
sessionId - User session Id
roleId - the role id
projectId - the project to which automatically grant property to be set
autoGrant - true to set it available upon request
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the projectId is invalid
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.IllegalArgumentFault - when the role is not available upon request
java.rmi.RemoteException
Since:
6.0

getAutomaticallyGrantOnRequest

boolean getAutomaticallyGrantOnRequest(java.lang.String sessionId,
                                       java.lang.String roleId,
                                       java.lang.String projectId)
                                       throws java.rmi.RemoteException
Gets the role's Automatically Grant On Request for the given project.

Parameters:
sessionId - User session Id
roleId - the role id
projectId - the project to which automatically grant property to be set
Returns:
Auto grant flag of role
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the projectId is invalid
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.IllegalArgumentFault - when there is a request for global role with Projects project id.
java.rmi.RemoteException
Since:
6.0

getPendingRequestedRoles

RoleRequestSoapList getPendingRequestedRoles(java.lang.String sessionId,
                                             java.lang.String projectId)
                                             throws java.rmi.RemoteException
Lists the pending requested roles for the given projectId

Parameters:
sessionId - User session Id
projectId - project in which the pending requested roles needs to be retrieved
Returns:
List of pending requested roles.
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When projectId is invalid
com.collabnet.ce.soap60.fault.IllegalArgumentFault - incorrect parameters
com.collabnet.ce.soap60.fault.SystemFault - unexpected error occurs
java.rmi.RemoteException
Since:
6.0

approveRoleRequest

void approveRoleRequest(java.lang.String sessionId,
                        java.lang.String requestId,
                        java.lang.String projectId)
                        throws java.rmi.RemoteException
Approves a role request

Parameters:
sessionId - User session Id
requestId - Role request Id
projectId - project in which the role request was raised
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the projectId is invalid
com.collabnet.ce.soap60.fault.IllegalArgumentFault - incorrect parameters
com.collabnet.ce.soap60.fault.SystemFault - unexpected error occurs
java.rmi.RemoteException
Since:
6.0

rejectRoleRequest

void rejectRoleRequest(java.lang.String sessionId,
                       java.lang.String requestId,
                       java.lang.String projectId)
                       throws java.rmi.RemoteException
Rejects a role request

Parameters:
sessionId - User session Id
requestId - Role request Id
projectId - project in which the role request was raised
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - If the session is invalid
com.collabnet.ce.soap60.fault.PermissionDeniedFault - If the user doesn't have permission to perform the operation
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the projectId is invalid
com.collabnet.ce.soap60.fault.IllegalArgumentFault - incorrect parameters
com.collabnet.ce.soap60.fault.SystemFault - unexpected error occurs
java.rmi.RemoteException
Since:
6.0

listGroupRolesByProjectGroup

RoleGroupSoapList listGroupRolesByProjectGroup(java.lang.String sessionId,
                                               java.lang.String projectGroupId)
                                               throws java.rmi.RemoteException
Returns a list of user groups and the roles it is associated with in a project group.

Parameters:
sessionId - User session id.
projectGroupId - Project group id.
Returns:
list of user groups and the roles it is associated with
Throws:
com.collabnet.ce.soap60.fault.IllegalArgumentFault - projectGroupId is not specified or invalid.
com.collabnet.ce.soap60.fault.InvalidSessionFault - if the session is invalid.
com.collabnet.ce.soap60.fault.PermissionDeniedFault - if the user does not have permission to perform the operation.
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - when the specified project group id is invalid.
java.rmi.RemoteException
Since:
6.0.1

getProjectsByIntegratedAppPermission

java.lang.String[] getProjectsByIntegratedAppPermission(java.lang.String sessionId,
                                                        java.lang.String perm,
                                                        java.lang.String integratedAppName)
                                                        throws java.rmi.RemoteException
Returns the list of projects by integratedApp permission.

Parameters:
sessionId - User session key.
perm - permission criteria
integratedAppName - the IntegratedApp plugName.
Returns:
string array of id of projects in which the current user has given permission to given integrated app.
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
com.collabnet.ce.soap60.fault.SystemFault - when an unexpected system level error occurs.
com.collabnet.ce.soap60.fault.NoSuchObjectFault - When the plugName is invalid
com.collabnet.ce.soap60.fault.IllegalArgumentFault - When the userId is invalid
java.rmi.RemoteException
Since:
5.4

getIntegratedAppPermissionsForProject

java.lang.String[] getIntegratedAppPermissionsForProject(java.lang.String sessionId,
                                                         java.lang.String projectId,
                                                         java.lang.String linkId)
                                                         throws java.rmi.RemoteException
Returns integratedApp permissions for the user associated with a project

Parameters:
sessionId - User session key.
projectId - the projectId
linkId - the linkId between integrated app and project
Returns:
String array of permissions for given integrated application
Throws:
com.collabnet.ce.soap60.fault.InvalidSessionFault - when the specified session id is invalid.
com.collabnet.ce.soap60.fault.NoSuchObjectFault
java.rmi.RemoteException
Since:
5.4