Package org.odpi.openmetadata.accessservices.communityprofile.client

Class OrganizationManagement

java.lang.Object

org.odpi.openmetadata.accessservices.communityprofile.client.CommunityProfileBaseClient

org.odpi.openmetadata.accessservices.communityprofile.client.OrganizationManagement

All Implemented Interfaces:

OrganizationManagementInterface, RelatedElementsManagementInterface

public class OrganizationManagement
extends CommunityProfileBaseClient
implements OrganizationManagementInterface

OrganizationManagement is the client used by the Organization Integrator OMIS that is responsible with synchronizing organizational structures, profiles rules and users with open metadata.

Field Summary

Fields inherited from class org.odpi.openmetadata.accessservices.communityprofile.client.CommunityProfileBaseClient

baseURLTemplatePrefix, openMetadataStoreClient, propertyHelper

Constructor Summary

Constructors

Constructor	Description
OrganizationManagement(String serverName, String serverPlatformURLRoot, int maxPageSize)	Create a new client with no authentication embedded in the HTTP request.
OrganizationManagement(String serverName, String serverPlatformURLRoot, String userId, String password, int maxPageSize)	Create a new client that passes userId and password in each HTTP request.
OrganizationManagement(String serverName, String serverPlatformURLRoot, String userId, String password, AuditLog auditLog, int maxPageSize)	Create a new client that passes userId and password in each HTTP request.
OrganizationManagement(String serverName, String serverPlatformURLRoot, CommunityProfileRESTClient restClient, int maxPageSize)	Create a new client that passes userId and password in each HTTP request.
OrganizationManagement(String serverName, String serverPlatformURLRoot, AuditLog auditLog, int maxPageSize)	Create a new client with no authentication embedded in the HTTP request.

Method Summary

Modifier and Type	Method	Description
String	addContactMethod(String userId, String externalSourceGUID, String externalSourceName, String actorProfileGUID, ContactMethodProperties properties)	Add a new contact method to the profile.
String	createActorProfile(String userId, String externalSourceGUID, String externalSourceName, ActorProfileProperties properties, ContributionRecord contributionRecord)	Create a definition of an actor profile.
String	createPersonRole(String userId, String externalSourceGUID, String externalSourceName, PersonRoleProperties properties)	Create a definition of a person role.
void	deleteActorProfile(String userId, String externalSourceGUID, String externalSourceName, String actorProfileGUID)	Remove the definition of an actor profile.
void	deleteContactMethod(String userId, String externalSourceGUID, String externalSourceName, String contactMethodGUID)	Remove an obsolete contact method from the profile.
void	deletePersonRole(String userId, String externalSourceGUID, String externalSourceName, String personRoleGUID)	Remove the definition of a person role.
List<ActorProfileElement>	findActorProfiles(String userId, String searchString, int startFrom, int pageSize)	Retrieve the list of matching profiles for the search string.
List<ActorRoleElement>	findPersonRoles(String userId, String searchString, int startFrom, int pageSize)	Retrieve the list of matching roles for the search string.
ActorProfileElement	getActorProfileByGUID(String userId, String actorProfileGUID)	Return information about a specific actor profile.
ActorProfileElement	getActorProfileByUserId(String userId, String actorProfileUserId)	Return information about a specific actor profile.
List<ActorProfileElement>	getActorProfiles(String userId, int startFrom, int pageSize)	Return information about all actor profiles.
List<ActorProfileElement>	getActorProfilesByLocation(String userId, String locationGUID, int startFrom, int pageSize)	Return information about the actor profiles associated with a location.
List<ActorProfileElement>	getActorProfilesByName(String userId, String name, int startFrom, int pageSize)	Return information about a named actor profile.
List<Appointee>	getAppointees(String userId, String personRoleGUID, Date effectiveTime, int startFrom, int pageSize)	Return the list of people appointed to a particular role.
List<ActorRoleElement>	getLeadershipRolesForTeam(String userId, String teamGUID, int startFrom, int pageSize)	Return information about the leadership person roles linked to a team.
List<ActorRoleElement>	getMembershipRolesForTeam(String userId, String teamGUID, int startFrom, int pageSize)	Return information about the membership person roles linked to a team.
ActorRoleElement	getPersonRoleByGUID(String userId, String personRoleGUID)	Return information about a specific person role.
List<ActorRoleElement>	getPersonRolesByName(String userId, String name, int startFrom, int pageSize)	Return information about a named person role.
String	linkPersonRoleToProfile(String userId, String externalSourceGUID, String externalSourceName, String personRoleGUID, String personProfileGUID, AppointmentProperties properties)	Link a person role to a person profile to show that that person is performing the role.
void	linkTeamPlayer(String userId, String externalSourceGUID, String externalSourceName, String teamRoleGUID, String teamProfileGUID, String position, boolean leadershipPosition)	Link a team leader person role or team member person role to a team profile.
void	linkTeamsInHierarchy(String userId, String externalSourceGUID, String externalSourceName, String superTeamProfileGUID, String subTeamProfileGUID, boolean delegationEscalationAuthority, Date effectiveFrom, Date effectiveTo)	Link two related team/organization actor profiles together as part of a hierarchy.
void	unlinkPersonRoleFromProfile(String userId, String externalSourceGUID, String externalSourceName, String appointmentGUID)	Remove the link between a person role and a person profile.
void	unlinkTeamPlayer(String userId, String externalSourceGUID, String externalSourceName, String teamRoleGUID, String teamProfileGUID, boolean leadershipPosition)	Remove the link between a person role and a team profile.
void	unlinkTeamsInHierarchy(String userId, String externalSourceGUID, String externalSourceName, String superTeamProfileGUID, String subTeamProfileGUID)	Remove the link between two actor profiles in the actor profile hierarchy.
void	updateActorProfile(String userId, String externalSourceGUID, String externalSourceName, String actorProfileGUID, boolean isMergeUpdate, ActorProfileProperties properties, ContributionRecord contributionRecord)	Update the definition of an actor profile.
void	updateAppointment(String userId, String externalSourceGUID, String externalSourceName, String appointmentGUID, boolean isMergeUpdate, AppointmentProperties properties)	Update the properties for the appointment of a person to a role.
void	updatePersonRole(String userId, String externalSourceGUID, String externalSourceName, String personRoleGUID, boolean isMergeUpdate, PersonRoleProperties properties)	Update the definition of a person role.

Methods inherited from class org.odpi.openmetadata.accessservices.communityprofile.client.CommunityProfileBaseClient

clearAssignmentScope, clearMoreInformation, clearResource, clearStakeholder, getAssignedActors, getAssignedScopes, getDescriptiveElements, getMoreInformation, getResourceList, getStakeholderCommissionedElements, getStakeholders, getSupportedByResource, removeReferenceable, setupAssignmentScope, setupMoreInformation, setupResource, setupStakeholder, updateRelationship

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

OrganizationManagement

public OrganizationManagement(String serverName,
 String serverPlatformURLRoot,
 int maxPageSize)
                       throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST services

maxPageSize - maximum value allowed for page size

Throws:

InvalidParameterException - bad input parameters

OrganizationManagement

public OrganizationManagement(String serverName,
 String serverPlatformURLRoot,
 AuditLog auditLog,
 int maxPageSize)
                       throws InvalidParameterException

Create a new client with no authentication embedded in the HTTP request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST services

auditLog - logging destination

maxPageSize - maximum value allowed for page size

Throws:

InvalidParameterException - there is a problem creating the client-side components to issue any REST API calls.

OrganizationManagement

public OrganizationManagement(String serverName,
 String serverPlatformURLRoot,
 String userId,
 String password,
 int maxPageSize)
                       throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST services

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

maxPageSize - maximum value allowed for page size

Throws:

InvalidParameterException - bad input parameters

OrganizationManagement

public OrganizationManagement(String serverName,
 String serverPlatformURLRoot,
 String userId,
 String password,
 AuditLog auditLog,
 int maxPageSize)
                       throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST services

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

auditLog - logging destination

maxPageSize - maximum value allowed for page size

Throws:

InvalidParameterException - bad input parameters

OrganizationManagement

public OrganizationManagement(String serverName,
 String serverPlatformURLRoot,
 CommunityProfileRESTClient restClient,
 int maxPageSize)
                       throws InvalidParameterException

Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.

Parameters:

serverName - name of the server to connect to

serverPlatformURLRoot - the network address of the server running the OMAS REST services

restClient - pre-initialized REST client

maxPageSize - pre-initialized parameter limit

Throws:

InvalidParameterException - there is a problem with the information about the remote OMAS

Method Details

createActorProfile

public String createActorProfile(String userId,
 String externalSourceGUID,
 String externalSourceName,
 ActorProfileProperties properties,
 ContributionRecord contributionRecord)
                          throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Create a definition of an actor profile. This could be for the whole organization, a team, a person or a system.

Specified by:

createActorProfile in interface OrganizationManagementInterface

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

properties - properties for a actor profile

contributionRecord - optional properties for the contribution record

Returns:

unique identifier of actor profile

Throws:

InvalidParameterException - qualifiedName or userId is null; qualifiedName is not unique

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

updateActorProfile

public void updateActorProfile(String userId,
 String externalSourceGUID,
 String externalSourceName,
 String actorProfileGUID,
 boolean isMergeUpdate,
 ActorProfileProperties properties,
 ContributionRecord contributionRecord)
                        throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Update the definition of an actor profile.

Specified by:

updateActorProfile in interface OrganizationManagementInterface

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

actorProfileGUID - unique identifier of actor profile

isMergeUpdate - are unspecified properties unchanged (true) or replaced with null?

properties - properties to change

contributionRecord - additional properties for contribution record.

Throws:

InvalidParameterException - guid, qualifiedName or userId is null; qualifiedName is not unique; guid is not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

deleteActorProfile

public void deleteActorProfile(String userId,
 String externalSourceGUID,
 String externalSourceName,
 String actorProfileGUID)
                        throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the definition of an actor profile.

Specified by:

deleteActorProfile in interface OrganizationManagementInterface

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

actorProfileGUID - unique identifier of actor profile

Throws:

InvalidParameterException - guid or userId is null; guid is not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

addContactMethod

public String addContactMethod(String userId,
 String externalSourceGUID,
 String externalSourceName,
 String actorProfileGUID,
 ContactMethodProperties properties)
                        throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Add a new contact method to the profile.

Specified by:

addContactMethod in interface OrganizationManagementInterface

Parameters:

userId - the name of the calling user.

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

actorProfileGUID - identifier of the profile to update.

properties - properties of contact method.

Returns:

unique identifier (guid) for the new contact method.

Throws:

InvalidParameterException - the userId is null or invalid. Another property is invalid.

PropertyServerException - there is a problem retrieving information from the property server(s).

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

deleteContactMethod

public void deleteContactMethod(String userId,
 String externalSourceGUID,
 String externalSourceName,
 String contactMethodGUID)
                         throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Remove an obsolete contact method from the profile.

Specified by:

deleteContactMethod in interface OrganizationManagementInterface

Parameters:

userId - the name of the calling user.

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

contactMethodGUID - unique identifier (guid) for the obsolete contact method.

Throws:

InvalidParameterException - the userId is null or invalid. Another property is invalid.

PropertyServerException - there is a problem retrieving information from the property server(s).

UserNotAuthorizedException - the requesting user is not authorized to issue this request.

linkTeamsInHierarchy

public void linkTeamsInHierarchy(String userId,
 String externalSourceGUID,
 String externalSourceName,
 String superTeamProfileGUID,
 String subTeamProfileGUID,
 boolean delegationEscalationAuthority,
 Date effectiveFrom,
 Date effectiveTo)
                          throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Link two related team/organization actor profiles together as part of a hierarchy. A team/organization actor profile can only have one parent but many child actor profiles.

Specified by:

linkTeamsInHierarchy in interface OrganizationManagementInterface

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

superTeamProfileGUID - unique identifier of the parent team profile

subTeamProfileGUID - unique identifier of the child team profile

delegationEscalationAuthority - can workflows delegate/escalate through this link?

effectiveFrom - start date for the team relationship

effectiveTo - end date for the team relationship

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

unlinkTeamsInHierarchy

public void unlinkTeamsInHierarchy(String userId,
 String externalSourceGUID,
 String externalSourceName,
 String superTeamProfileGUID,
 String subTeamProfileGUID)
                            throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the link between two actor profiles in the actor profile hierarchy.

Specified by:

unlinkTeamsInHierarchy in interface OrganizationManagementInterface

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

superTeamProfileGUID - unique identifier of the parent actor profile

subTeamProfileGUID - unique identifier of the child actor profile

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getActorProfileByGUID

public ActorProfileElement getActorProfileByGUID(String userId,
 String actorProfileGUID)
                                          throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about a specific actor profile.

Specified by:

getActorProfileByGUID in interface OrganizationManagementInterface

Parameters:

userId - calling user

actorProfileGUID - unique identifier for the actor profile

Returns:

properties of the actor profile

Throws:

InvalidParameterException - actorProfileGUID or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getActorProfileByUserId

public ActorProfileElement getActorProfileByUserId(String userId,
 String actorProfileUserId)
                                            throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about a specific actor profile.

Specified by:

getActorProfileByUserId in interface OrganizationManagementInterface

Parameters:

userId - calling user

actorProfileUserId - unique identifier for the actor profile

Returns:

properties of the actor profile

Throws:

InvalidParameterException - actorProfileUserId or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getActorProfilesByName

public List<ActorProfileElement> getActorProfilesByName(String userId,
 String name,
 int startFrom,
 int pageSize)
                                                 throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about a named actor profile.

Specified by:

getActorProfilesByName in interface OrganizationManagementInterface

Parameters:

userId - calling user

name - unique name for the actor profile

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

Returns:

list of matching actor profiles (hopefully only one)

Throws:

InvalidParameterException - name or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getActorProfiles

public List<ActorProfileElement> getActorProfiles(String userId,
 int startFrom,
 int pageSize)
                                           throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about all actor profiles.

Specified by:

getActorProfiles in interface OrganizationManagementInterface

Parameters:

userId - calling user

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

Returns:

list of matching actor profiles (hopefully only one)

Throws:

InvalidParameterException - name or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getActorProfilesByLocation

public List<ActorProfileElement> getActorProfilesByLocation(String userId,
 String locationGUID,
 int startFrom,
 int pageSize)
                                                     throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about the actor profiles associated with a location.

Specified by:

getActorProfilesByLocation in interface OrganizationManagementInterface

Parameters:

userId - calling user

locationGUID - unique identifier for the location

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

Returns:

list of matching actor profiles (hopefully only one)

Throws:

InvalidParameterException - locationGUID or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

findActorProfiles

public List<ActorProfileElement> findActorProfiles(String userId,
 String searchString,
 int startFrom,
 int pageSize)
                                            throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Retrieve the list of matching profiles for the search string.

Specified by:

findActorProfiles in interface OrganizationManagementInterface

Parameters:

userId - the name of the calling user.

searchString - RegEx string to search for

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

Returns:

list of matching actor profiles

Throws:

InvalidParameterException - guid invalid or the external references are not correctly specified, or are null.

PropertyServerException - the server is not available.

UserNotAuthorizedException - the calling user is not authorized to issue the call.

createPersonRole

public String createPersonRole(String userId,
 String externalSourceGUID,
 String externalSourceName,
 PersonRoleProperties properties)
                        throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Create a definition of a person role.

Specified by:

createPersonRole in interface OrganizationManagementInterface

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

properties - properties for a person role

Returns:

unique identifier of person role

Throws:

InvalidParameterException - qualifiedName or userId is null; qualifiedName is not unique

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

updatePersonRole

public void updatePersonRole(String userId,
 String externalSourceGUID,
 String externalSourceName,
 String personRoleGUID,
 boolean isMergeUpdate,
 PersonRoleProperties properties)
                      throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Update the definition of a person role.

Specified by:

updatePersonRole in interface OrganizationManagementInterface

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

personRoleGUID - unique identifier of person role

isMergeUpdate - are unspecified properties unchanged (true) or replaced with null?

properties - properties to change

Throws:

InvalidParameterException - guid, qualifiedName or userId is null; qualifiedName is not unique; guid is not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

deletePersonRole

public void deletePersonRole(String userId,
 String externalSourceGUID,
 String externalSourceName,
 String personRoleGUID)
                      throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the definition of a person role.

Specified by:

deletePersonRole in interface OrganizationManagementInterface

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

personRoleGUID - unique identifier of person role

Throws:

InvalidParameterException - guid or userId is null; guid is not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

linkPersonRoleToProfile

public String linkPersonRoleToProfile(String userId,
 String externalSourceGUID,
 String externalSourceName,
 String personRoleGUID,
 String personProfileGUID,
 AppointmentProperties properties)
                               throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Link a person role to a person profile to show that that person is performing the role.

Specified by:

linkPersonRoleToProfile in interface OrganizationManagementInterface

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

personRoleGUID - unique identifier of the person role

personProfileGUID - unique identifier of the person profile

properties - optional properties for the appointment

Returns:

unique identifier of the appointment

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getAppointees

public List<Appointee> getAppointees(String userId,
 String personRoleGUID,
 Date effectiveTime,
 int startFrom,
 int pageSize)
                              throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return the list of people appointed to a particular role.

Specified by:

getAppointees in interface OrganizationManagementInterface

Parameters:

userId - calling user

personRoleGUID - unique identifier of the person role

effectiveTime - time for appointments, null for full appointment history

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return

Returns:

list of appointees

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

updateAppointment

public void updateAppointment(String userId,
 String externalSourceGUID,
 String externalSourceName,
 String appointmentGUID,
 boolean isMergeUpdate,
 AppointmentProperties properties)
                       throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Update the properties for the appointment of a person to a role.

Specified by:

updateAppointment in interface OrganizationManagementInterface

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

appointmentGUID - unique identifier of the appointment relationship

isMergeUpdate - are unspecified properties unchanged (true) or replaced with null?

properties - properties to change

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

unlinkPersonRoleFromProfile

public void unlinkPersonRoleFromProfile(String userId,
 String externalSourceGUID,
 String externalSourceName,
 String appointmentGUID)
                                 throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the link between a person role and a person profile.

Specified by:

unlinkPersonRoleFromProfile in interface OrganizationManagementInterface

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

appointmentGUID - unique identifier of the appointment relationship

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

linkTeamPlayer

public void linkTeamPlayer(String userId,
 String externalSourceGUID,
 String externalSourceName,
 String teamRoleGUID,
 String teamProfileGUID,
 String position,
 boolean leadershipPosition)
                    throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Link a team leader person role or team member person role to a team profile.

Specified by:

linkTeamPlayer in interface OrganizationManagementInterface

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

teamRoleGUID - unique identifier of the person role

teamProfileGUID - unique identifier of the team profile

position - position name of the role in the team

leadershipPosition - is this a leadership position

Throws:

InvalidParameterException - one of the guids is null or not known; the person role is not a team member or team leader

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

unlinkTeamPlayer

public void unlinkTeamPlayer(String userId,
 String externalSourceGUID,
 String externalSourceName,
 String teamRoleGUID,
 String teamProfileGUID,
 boolean leadershipPosition)
                      throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Remove the link between a person role and a team profile.

Specified by:

unlinkTeamPlayer in interface OrganizationManagementInterface

Parameters:

userId - calling user

externalSourceGUID - guid of the software server capability entity that represented the external source - null for local

externalSourceName - name of the software server capability entity that represented the external source

teamRoleGUID - unique identifier of the person role

teamProfileGUID - unique identifier of the team profile

leadershipPosition - is this a leadership position

Throws:

InvalidParameterException - one of the guids is null or not known; the person role is not a team member or team leader

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getPersonRoleByGUID

public ActorRoleElement getPersonRoleByGUID(String userId,
 String personRoleGUID)
                                     throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about a specific person role.

Specified by:

getPersonRoleByGUID in interface OrganizationManagementInterface

Parameters:

userId - calling user

personRoleGUID - unique identifier for the person role

Returns:

properties of the person role

Throws:

InvalidParameterException - personRoleGUID or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getPersonRolesByName

public List<ActorRoleElement> getPersonRolesByName(String userId,
 String name,
 int startFrom,
 int pageSize)
                                            throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about a named person role.

Specified by:

getPersonRolesByName in interface OrganizationManagementInterface

Parameters:

userId - calling user

name - unique name for the actor profile

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

Returns:

list of matching actor profiles (hopefully only one)

Throws:

InvalidParameterException - name or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getLeadershipRolesForTeam

public List<ActorRoleElement> getLeadershipRolesForTeam(String userId,
 String teamGUID,
 int startFrom,
 int pageSize)
                                                 throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about the leadership person roles linked to a team.

Specified by:

getLeadershipRolesForTeam in interface OrganizationManagementInterface

Parameters:

userId - calling user

teamGUID - unique identifier for the Team actor profile

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

Returns:

list of matching actor profiles (hopefully only one)

Throws:

InvalidParameterException - name or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getMembershipRolesForTeam

public List<ActorRoleElement> getMembershipRolesForTeam(String userId,
 String teamGUID,
 int startFrom,
 int pageSize)
                                                 throws InvalidParameterException,
UserNotAuthorizedException,
PropertyServerException

Return information about the membership person roles linked to a team.

Specified by:

getMembershipRolesForTeam in interface OrganizationManagementInterface

Parameters:

userId - calling user

teamGUID - unique identifier for the Team actor profile

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

Returns:

list of matching actor profiles (hopefully only one)

Throws:

InvalidParameterException - name or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

findPersonRoles

public List<ActorRoleElement> findPersonRoles(String userId,
 String searchString,
 int startFrom,
 int pageSize)
                                       throws InvalidParameterException,
PropertyServerException,
UserNotAuthorizedException

Retrieve the list of matching roles for the search string.

Specified by:

findPersonRoles in interface OrganizationManagementInterface

Parameters:

userId - the name of the calling user.

searchString - RegEx string to search for

startFrom - index of the list to start from (0 for start)

pageSize - maximum number of elements to return.

Returns:

list of matching actor profiles

Throws:

InvalidParameterException - guid invalid or the external references are not correctly specified, or are null.

PropertyServerException - the server is not available.

UserNotAuthorizedException - the calling user is not authorized to issue the call.