org.odpi.openmetadata.accessservices.governanceprogram.handlers

Class GovernanceOfficerHandler

java.lang.Object

org.odpi.openmetadata.accessservices.governanceprogram.handlers.GovernanceOfficerHandler

public class GovernanceOfficerHandler
extends Object

GovernanceOfficerHandler retrieves GovernanceOfficer objects from the property server and maintains the relationship between the governance officer and the profile of the individual that is appointed as the governance officer. It runs server-side in the GovernanceProgram OMAS and retrieves entities and relationships through the OMRSRepositoryConnector.

Constructor Summary

Constructors

Constructor and Description
GovernanceOfficerHandler(String serviceName, String serverName, InvalidParameterHandler invalidParameterHandler, OMRSRepositoryHelper repositoryHelper, RepositoryHandler repositoryHandler, PersonalProfileHandler personalProfileHandler, ExternalReferencesHandler externalReferencesHandler) Construct the handler caching the objects needed to operate within a single server instance.

Method Summary

Modifier and Type	Method and Description
void	appointGovernanceOfficer(String userId, String governanceOfficerGUID, String profileGUID, Date startDate) Link a person to a governance officer.
String	createGovernanceOfficer(String userId, GovernanceDomain governanceDomain, String appointmentId, String appointmentContext, String title, Map<String,String> additionalProperties, List<ExternalReference> externalReferences) Create the governance officer appointment.
void	deleteGovernanceOfficer(String userId, String governanceOfficerGUID, String appointmentId, GovernanceDomain governanceDomain) Remove the requested governance officer.
List<GovernanceOfficer>	getActiveGovernanceOfficers(String userId) Return all of the active governance officers.
GovernanceOfficer	getGovernanceOfficerByAppointmentId(String userId, String appointmentId) Retrieve a governance officer by unique appointment id.
GovernanceOfficer	getGovernanceOfficerByGUID(String userId, String governanceOfficerGUID) Retrieve a governance officer description by unique guid.
List<GovernanceOfficer>	getGovernanceOfficers(String userId) Return all of the defined governance officers.
List<GovernanceOfficer>	getGovernanceOfficersByDomain(String userId, GovernanceDomain governanceDomain) Return all of the defined governance officers for a specific governance domain.
void	relieveGovernanceOfficer(String userId, String governanceOfficerGUID, String profileGUID, Date endDate) Unlink a person from a governance officer appointment.
void	updateGovernanceOfficer(String userId, String governanceOfficerGUID, GovernanceDomain governanceDomain, String appointmentId, String appointmentContext, String title, Map<String,String> additionalProperties, List<ExternalReference> externalReferences) Update selected fields for the governance officer.

Methods inherited from class java.lang.Object

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

Constructor Detail

GovernanceOfficerHandler

public GovernanceOfficerHandler(String serviceName,
                                String serverName,
                                InvalidParameterHandler invalidParameterHandler,
                                OMRSRepositoryHelper repositoryHelper,
                                RepositoryHandler repositoryHandler,
                                PersonalProfileHandler personalProfileHandler,
                                ExternalReferencesHandler externalReferencesHandler)

Construct the handler caching the objects needed to operate within a single server instance.

Parameters:

serviceName - name of the consuming service

serverName - name of this server instance

invalidParameterHandler - handler for invalid parameters

repositoryHelper - helper used by the converters

repositoryHandler - handler for calling the repository services

personalProfileHandler - handler to manage personal profiles

externalReferencesHandler - handler to manage external references

Method Detail

createGovernanceOfficer

public String createGovernanceOfficer(String userId,
                                      GovernanceDomain governanceDomain,
                                      String appointmentId,
                                      String appointmentContext,
                                      String title,
                                      Map<String,String> additionalProperties,
                                      List<ExternalReference> externalReferences)
                               throws InvalidParameterException,
                                      PropertyServerException,
                                      UserNotAuthorizedException

Create the governance officer appointment.

Parameters:

userId - the name of the calling user.

governanceDomain - the governance domain for the governance officer.

appointmentId - the unique identifier of the governance officer.

appointmentContext - the context in which the governance officer is appointed. This may be an organizational scope, location, or scope of assets.

title - job title for the governance officer

additionalProperties - additional properties for the governance officer.

externalReferences - links to addition information. This could be, for example, the home page for the governance officer, or details of the role.

Returns:

Unique identifier (guid) of the governance officer.

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.

updateGovernanceOfficer

public void updateGovernanceOfficer(String userId,
                                    String governanceOfficerGUID,
                                    GovernanceDomain governanceDomain,
                                    String appointmentId,
                                    String appointmentContext,
                                    String title,
                                    Map<String,String> additionalProperties,
                                    List<ExternalReference> externalReferences)
                             throws InvalidParameterException,
                                    PropertyServerException,
                                    UserNotAuthorizedException

Update selected fields for the governance officer.

Parameters:

userId - the name of the calling user.

governanceOfficerGUID - unique identifier (guid) of the governance officer.

governanceDomain - the governance domain for the governance officer.

appointmentId - the unique identifier of the governance officer.

appointmentContext - the context in which the governance officer is appointed. This may be an organizational scope, location, or scope of assets.

title - job title for the governance officer

additionalProperties - additional properties for the governance officer.

externalReferences - links to addition information. This could be, for example, the home page for the governance officer, or details of the role.

Throws:

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

PropertyServerException - the server is not available.

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

deleteGovernanceOfficer

public void deleteGovernanceOfficer(String userId,
                                    String governanceOfficerGUID,
                                    String appointmentId,
                                    GovernanceDomain governanceDomain)
                             throws InvalidParameterException,
                                    PropertyServerException,
                                    UserNotAuthorizedException

Remove the requested governance officer.

Parameters:

userId - the name of the calling user.

governanceOfficerGUID - unique identifier (guid) of the governance officer.

appointmentId - the unique identifier of the governance officer.

governanceDomain - the governance domain for the governance officer.

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.

getGovernanceOfficerByGUID

public GovernanceOfficer getGovernanceOfficerByGUID(String userId,
                                                    String governanceOfficerGUID)
                                             throws InvalidParameterException,
                                                    PropertyServerException,
                                                    UserNotAuthorizedException

Retrieve a governance officer description by unique guid.

Parameters:

userId - the name of the calling user.

governanceOfficerGUID - unique identifier (guid) of the governance officer.

Returns:

governance officer object

Throws:

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

PropertyServerException - the server is not available.

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

getGovernanceOfficerByAppointmentId

public GovernanceOfficer getGovernanceOfficerByAppointmentId(String userId,
                                                             String appointmentId)
                                                      throws InvalidParameterException,
                                                             PropertyServerException,
                                                             AppointmentIdNotUniqueException,
                                                             UserNotAuthorizedException

Retrieve a governance officer by unique appointment id.

Parameters:

userId - the name of the calling user.

appointmentId - the unique appointment identifier of the governance officer.

Returns:

governance officer object

Throws:

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

AppointmentIdNotUniqueException - more than one governance officer entity was retrieved for this appointmentId

PropertyServerException - the server is not available.

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

getGovernanceOfficers

public List<GovernanceOfficer> getGovernanceOfficers(String userId)
                                              throws InvalidParameterException,
                                                     PropertyServerException,
                                                     UserNotAuthorizedException

Return all of the defined governance officers.

Parameters:

userId - the name of the calling user.

Returns:

list of governance officer objects

Throws:

InvalidParameterException - the userId is null.

PropertyServerException - the server is not available.

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

getActiveGovernanceOfficers

public List<GovernanceOfficer> getActiveGovernanceOfficers(String userId)
                                                    throws InvalidParameterException,
                                                           PropertyServerException,
                                                           UserNotAuthorizedException

Return all of the active governance officers.

Parameters:

userId - the name of the calling user.

Returns:

list of governance officer objects

Throws:

InvalidParameterException - the userId is null.

PropertyServerException - the server is not available.

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

getGovernanceOfficersByDomain

public List<GovernanceOfficer> getGovernanceOfficersByDomain(String userId,
                                                             GovernanceDomain governanceDomain)
                                                      throws InvalidParameterException,
                                                             PropertyServerException,
                                                             UserNotAuthorizedException

Return all of the defined governance officers for a specific governance domain. In a small organization there is typically only one governance officer. However a large organization may have multiple governance officers, each with a different scope. The governance officer with a null scope is the overall leader.

Parameters:

userId - the name of the calling user.

governanceDomain - domain of interest

Returns:

list of governance officer 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.

appointGovernanceOfficer

public void appointGovernanceOfficer(String userId,
                                     String governanceOfficerGUID,
                                     String profileGUID,
                                     Date startDate)
                              throws InvalidParameterException,
                                     PropertyServerException,
                                     UserNotAuthorizedException

Link a person to a governance officer. Only one person may be appointed at any one time.

Parameters:

userId - the name of the calling user.

governanceOfficerGUID - unique identifier (guid) of the governance officer.

profileGUID - unique identifier for the profile.

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

Throws:

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

PropertyServerException - the server is not available.

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

relieveGovernanceOfficer

public void relieveGovernanceOfficer(String userId,
                                     String governanceOfficerGUID,
                                     String profileGUID,
                                     Date endDate)
                              throws InvalidParameterException,
                                     PropertyServerException,
                                     UserNotAuthorizedException

Unlink a person from a governance officer appointment.

Parameters:

userId - the name of the calling user.

governanceOfficerGUID - unique identifier (guid) of the governance officer.

profileGUID - unique identifier for the profile.

endDate - date at which the current incumbent leaves the position

Throws:

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

PropertyServerException - the server is not available.

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