org.odpi.openmetadata.accessservices.governanceprogram.client

Class GovernanceRoleManager

java.lang.Object

org.odpi.openmetadata.accessservices.governanceprogram.client.GovernanceRoleManager

All Implemented Interfaces:

GovernanceRolesInterface

public class GovernanceRoleManager
extends Object
implements GovernanceRolesInterface

GovernanceRoleManager provides one of the client-side interface for the Governance Program Open Metadata Access Service (OMAS). This client manages all of the interaction with an open metadata repository. It is initialized with the URL of the server that is running the Open Metadata Access Services. This server is responsible for locating and managing the governance program definitions exchanged with this client.

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
String	appointGovernanceRole(String userId, String governanceRoleGUID, String profileGUID, Date startDate) Link a person to a governance role.
String	createGovernanceRole(String userId, GovernanceRoleProperties properties) Create the governance role.
void	deleteGovernanceRole(String userId, String governanceRoleGUID) Remove the requested governance role.
List<GovernanceRoleAppointee>	getCurrentGovernanceRoleAppointments(String userId, int domainIdentifier, int startFrom, int pageSize) Return all of the governance roles and their incumbents (if any).
GovernanceRoleElement	getGovernanceRoleByGUID(String userId, String governanceRoleGUID) Retrieve a governance role description by unique guid.
List<GovernanceRoleElement>	getGovernanceRoleByRoleId(String userId, String roleId) Retrieve the properties of a governance role using its unique name.
GovernanceRoleHistory	getGovernanceRoleHistoryByGUID(String userId, String governanceRoleGUID) Retrieve a governance role description by unique guid along with the history of who has been appointed to the role.
List<GovernanceRoleElement>	getGovernanceRolesByDomainId(String userId, int domainIdentifier, int startFrom, int pageSize) Return all of the defined governance roles for a specific governance domain.
List<GovernanceRoleElement>	getGovernanceRolesByTitle(String userId, String title, int startFrom, int pageSize) Retrieve all of the governance roles for a particular title.
void	linkRoleToResource(String userId, String governanceRoleGUID, String resourceGUID) Link a governance role to the description of a resource that the role is responsible for.
void	linkRoleToResponsibility(String userId, String governanceRoleGUID, String responsibilityGUID) Link a governance role to a governance control that defines a governance responsibility that a person fulfils.
void	relieveGovernanceRole(String userId, String governanceRoleGUID, String profileGUID, String appointmentGUID, Date endDate) Unlink a person from a governance role appointment.
void	unlinkRoleFromResource(String userId, String governanceRoleGUID, String resourceGUID) Remove the link between a governance role and a resource.
void	unlinkRoleFromResponsibility(String userId, String governanceRoleGUID, String responsibilityGUID) Remove the link between a governance role and a governance responsibility.
void	updateGovernanceRole(String userId, String governanceRoleGUID, boolean isMergeUpdate, GovernanceRoleProperties properties) Update selected fields for the governance role.

Methods inherited from class java.lang.Object

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

Constructor Detail

GovernanceRoleManager

public GovernanceRoleManager(String serverName,
                             String serverPlatformURLRoot)
                      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 servers

Throws:

InvalidParameterException - bad input parameters

GovernanceRoleManager

public GovernanceRoleManager(String serverName,
                             String serverPlatformURLRoot,
                             String userId,
                             String password)
                      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 servers

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

Throws:

InvalidParameterException - bad input parameters

GovernanceRoleManager

public GovernanceRoleManager(String serverName,
                             String serverPlatformURLRoot,
                             int maxPageSize,
                             AuditLog auditLog)
                      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 servers

maxPageSize - pre-initialized parameter limit

auditLog - logging destination

Throws:

InvalidParameterException - bad input parameters

GovernanceRoleManager

public GovernanceRoleManager(String serverName,
                             String serverPlatformURLRoot,
                             String userId,
                             String password,
                             int maxPageSize,
                             AuditLog auditLog)
                      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 servers

userId - caller's userId embedded in all HTTP requests

password - caller's userId embedded in all HTTP requests

maxPageSize - pre-initialized parameter limit

auditLog - logging destination

Throws:

InvalidParameterException - bad input parameters

GovernanceRoleManager

public GovernanceRoleManager(String serverName,
                             String serverPlatformURLRoot,
                             GovernanceProgramRESTClient restClient,
                             int maxPageSize)
                      throws InvalidParameterException

Create a new client that uses the supplied rest client. This is typically used when called fro manother OMAG Server.

Parameters:

serverName - name of the server to connect to

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

restClient - internal client for rest calls

maxPageSize - pre-initialized parameter limit

Throws:

InvalidParameterException - bad input parameters

Method Detail

createGovernanceRole

public String createGovernanceRole(String userId,
                                   GovernanceRoleProperties properties)
                            throws InvalidParameterException,
                                   PropertyServerException,
                                   UserNotAuthorizedException

Create the governance role.

Specified by:

createGovernanceRole in interface GovernanceRolesInterface

Parameters:

userId - the name of the calling user.

properties - the description of the governance role

Returns:

Unique identifier (guid) of the governance role

Throws:

InvalidParameterException - the governance domain, title or appointment id is null.

PropertyServerException - the server is not available.

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

updateGovernanceRole

public void updateGovernanceRole(String userId,
                                 String governanceRoleGUID,
                                 boolean isMergeUpdate,
                                 GovernanceRoleProperties properties)
                          throws InvalidParameterException,
                                 PropertyServerException,
                                 UserNotAuthorizedException

Update selected fields for the governance role.

Specified by:

updateGovernanceRole in interface GovernanceRolesInterface

Parameters:

userId - the name of the calling user.

governanceRoleGUID - unique identifier (guid) of the governance role

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

properties - the description of the governance role

Throws:

InvalidParameterException - the title is null or the governanceDomain/appointmentId does not match the the existing values associated with the governanceRoleGUID.

PropertyServerException - the server is not available.

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

linkRoleToResponsibility

public void linkRoleToResponsibility(String userId,
                                     String governanceRoleGUID,
                                     String responsibilityGUID)
                              throws InvalidParameterException,
                                     UserNotAuthorizedException,
                                     PropertyServerException

Link a governance role to a governance control that defines a governance responsibility that a person fulfils.

Specified by:

linkRoleToResponsibility in interface GovernanceRolesInterface

Parameters:

userId - calling user

governanceRoleGUID - unique identifier of the governance role

responsibilityGUID - unique identifier of the governance responsibility control

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

unlinkRoleFromResponsibility

public void unlinkRoleFromResponsibility(String userId,
                                         String governanceRoleGUID,
                                         String responsibilityGUID)
                                  throws InvalidParameterException,
                                         UserNotAuthorizedException,
                                         PropertyServerException

Remove the link between a governance role and a governance responsibility.

Specified by:

unlinkRoleFromResponsibility in interface GovernanceRolesInterface

Parameters:

userId - calling user

governanceRoleGUID - unique identifier of the governance role

responsibilityGUID - unique identifier of the governance responsibility control

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

linkRoleToResource

public void linkRoleToResource(String userId,
                               String governanceRoleGUID,
                               String resourceGUID)
                        throws InvalidParameterException,
                               UserNotAuthorizedException,
                               PropertyServerException

Link a governance role to the description of a resource that the role is responsible for.

Specified by:

linkRoleToResource in interface GovernanceRolesInterface

Parameters:

userId - calling user

governanceRoleGUID - unique identifier of the governance role

resourceGUID - unique identifier of the resource description

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

unlinkRoleFromResource

public void unlinkRoleFromResource(String userId,
                                   String governanceRoleGUID,
                                   String resourceGUID)
                            throws InvalidParameterException,
                                   UserNotAuthorizedException,
                                   PropertyServerException

Remove the link between a governance role and a resource.

Specified by:

unlinkRoleFromResource in interface GovernanceRolesInterface

Parameters:

userId - calling user

governanceRoleGUID - unique identifier of the governance role

resourceGUID - unique identifier of the resource description

Throws:

InvalidParameterException - one of the guids is null or not known

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

deleteGovernanceRole

public void deleteGovernanceRole(String userId,
                                 String governanceRoleGUID)
                          throws InvalidParameterException,
                                 PropertyServerException,
                                 UserNotAuthorizedException

Remove the requested governance role.

Specified by:

deleteGovernanceRole in interface GovernanceRolesInterface

Parameters:

userId - the name of the calling user

governanceRoleGUID - unique identifier (guid) of the governance role

Throws:

InvalidParameterException - the appointmentId or governance domain is either null or invalid.

PropertyServerException - the server is not available.

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

getGovernanceRoleByGUID

public GovernanceRoleElement getGovernanceRoleByGUID(String userId,
                                                     String governanceRoleGUID)
                                              throws InvalidParameterException,
                                                     PropertyServerException,
                                                     UserNotAuthorizedException

Retrieve a governance role description by unique guid.

Specified by:

getGovernanceRoleByGUID in interface GovernanceRolesInterface

Parameters:

userId - the name of the calling user.

governanceRoleGUID - unique identifier (guid) of the governance role.

Returns:

governance role object

Throws:

InvalidParameterException - the unique identifier of the governance role is either null or invalid.

PropertyServerException - the server is not available.

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

getGovernanceRoleHistoryByGUID

public GovernanceRoleHistory getGovernanceRoleHistoryByGUID(String userId,
                                                            String governanceRoleGUID)
                                                     throws InvalidParameterException,
                                                            PropertyServerException,
                                                            UserNotAuthorizedException

Retrieve a governance role description by unique guid along with the history of who has been appointed to the role.

Specified by:

getGovernanceRoleHistoryByGUID in interface GovernanceRolesInterface

Parameters:

userId - the name of the calling user.

governanceRoleGUID - unique identifier (guid) of the governance role.

Returns:

governance role object

Throws:

InvalidParameterException - the unique identifier of the governance role is either null or invalid.

PropertyServerException - the server is not available.

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

getGovernanceRoleByRoleId

public List<GovernanceRoleElement> getGovernanceRoleByRoleId(String userId,
                                                             String roleId)
                                                      throws InvalidParameterException,
                                                             PropertyServerException,
                                                             UserNotAuthorizedException

Retrieve the properties of a governance role using its unique name. The results are returned as a list since it is possible that two roles have the same identifier due to the distributed nature of the open metadata ecosystem. By returning all of the search results here it is possible to manage the duplicates through this interface.

Specified by:

getGovernanceRoleByRoleId in interface GovernanceRolesInterface

Parameters:

userId - calling user

roleId - unique name

Returns:

list of roles retrieved

Throws:

InvalidParameterException - name or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getGovernanceRolesByDomainId

public List<GovernanceRoleElement> getGovernanceRolesByDomainId(String userId,
                                                                int domainIdentifier,
                                                                int startFrom,
                                                                int pageSize)
                                                         throws InvalidParameterException,
                                                                PropertyServerException,
                                                                UserNotAuthorizedException

Return all of the defined governance roles for a specific governance domain.

Specified by:

getGovernanceRolesByDomainId in interface GovernanceRolesInterface

Parameters:

userId - the name of the calling user

domainIdentifier - domain of interest - 0 means all domains

startFrom - where to start from in the list of definitions

pageSize - max number of results to return in one call

Returns:

list of governance role objects

Throws:

InvalidParameterException - the governance domain is either null or invalid.

PropertyServerException - the server is not available.

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

getGovernanceRolesByTitle

public List<GovernanceRoleElement> getGovernanceRolesByTitle(String userId,
                                                             String title,
                                                             int startFrom,
                                                             int pageSize)
                                                      throws UserNotAuthorizedException,
                                                             InvalidParameterException,
                                                             PropertyServerException

Retrieve all of the governance roles for a particular title. The title can include regEx wildcards.

Specified by:

getGovernanceRolesByTitle in interface GovernanceRolesInterface

Parameters:

userId - calling user

title - short description of the role

startFrom - where to start from in the list of definitions

pageSize - max number of results to return in one call

Returns:

list of matching roles (null if no matching elements)

Throws:

InvalidParameterException - title or userId is null

PropertyServerException - problem accessing property server

UserNotAuthorizedException - security access problem

getCurrentGovernanceRoleAppointments

public List<GovernanceRoleAppointee> getCurrentGovernanceRoleAppointments(String userId,
                                                                          int domainIdentifier,
                                                                          int startFrom,
                                                                          int pageSize)
                                                                   throws InvalidParameterException,
                                                                          PropertyServerException,
                                                                          UserNotAuthorizedException

Return all of the governance roles and their incumbents (if any).

Specified by:

getCurrentGovernanceRoleAppointments in interface GovernanceRolesInterface

Parameters:

userId - the name of the calling user

domainIdentifier - identifier of domain - 0 means all

startFrom - where to start from in the list of definitions

pageSize - max number of results to return in one call

Returns:

list of governance role objects

Throws:

InvalidParameterException - the userId is either null or invalid.

PropertyServerException - the server is not available.

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

appointGovernanceRole

public String appointGovernanceRole(String userId,
                                    String governanceRoleGUID,
                                    String profileGUID,
                                    Date startDate)
                             throws InvalidParameterException,
                                    PropertyServerException,
                                    UserNotAuthorizedException

Link a person to a governance role.

Specified by:

appointGovernanceRole in interface GovernanceRolesInterface

Parameters:

userId - the name of the calling user.

governanceRoleGUID - unique identifier (guid) of the governance role

profileGUID - unique identifier for the profile

startDate - the official start date of the appointment - null means effective immediately

Returns:

unique identifier (guid) of the appointment relationship

Throws:

InvalidParameterException - the unique identifier of the governance role or profile is either null or invalid.

PropertyServerException - the server is not available.

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

relieveGovernanceRole

public void relieveGovernanceRole(String userId,
                                  String governanceRoleGUID,
                                  String profileGUID,
                                  String appointmentGUID,
                                  Date endDate)
                           throws InvalidParameterException,
                                  PropertyServerException,
                                  UserNotAuthorizedException

Unlink a person from a governance role appointment.

Specified by:

relieveGovernanceRole in interface GovernanceRolesInterface

Parameters:

userId - the name of the calling user

governanceRoleGUID - unique identifier (guid) of the governance role

profileGUID - unique identifier for the profile

appointmentGUID - unique identifier (guid) of the appointment relationship

endDate - the official end of the appointment - null means effective immediately

Throws:

InvalidParameterException - the profile is not linked to this governance role.

PropertyServerException - the server is not available.

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