curam.participant.impl

Interface ConcernRole

All Superinterfaces:

ConcernRoleAccessor, curam.util.persistence.Entity<java.lang.Long>, MeetingAttendee, curam.util.persistence.StandardEntity

All Known Subinterfaces:

Individual, Person, ProspectEmployer, ProspectPerson

All Known Implementing Classes:

ConcernRoleImpl

@AccessLevel(value=EXTERNAL)
 @Implementable
public interface ConcernRole
extends ConcernRoleAccessor, MeetingAttendee

A wrapper object for ConcernRole.

A concern role represents a type of party with whom the organization has an interaction with. The various types are identified on the concern role type code table. Wrapper interfaces have been provided for following concern role types. Each interface extends this concern role interface.

• Employer
• ExternalParty
• Person
• ProductProvider
• ProspectEmployer
• ProspectPerson
• InformationProvider
• Representative
• ServiceSupplier
• Utility

If additional concern role types have been added it is recommended a wrapper interface be created that extend this interface. The created interface should then be added to the list of available concern role instances that can be retrieved through implementing the ConcernRoleGetConcreteReaderDAOsEvent#addConcreteReaderDAO(ConcernRoleDAO) event.

Method Summary

Modifier and Type	Method and Description
void	checkSecurity() Performs the security check for this concern role.
EmailAddress	getEmailAddress() Gets the e-mail address if specified.
Address	getPrimaryAddress() Gets the primary address of the concern role.
PhoneNumber	getPrimaryPhoneNumber() Gets the immutable primary phone number if specified.
WebAddress	getWebAddress() Gets the web address of the concern role.
java.util.List<curam.piwrapper.participantmanager.impl.ConcernRoleRelationship>	listRelationships() Retrieves a list of active relationships for a ConcernRole.

Methods inherited from interface curam.participant.impl.ConcernRoleAccessor

getComments, getConcernRoleType, getCreationDate, getEndDate, getName, getPreferredCommunicationMethod, getPreferredLanguage, getPrimaryAddressID, getPrimaryAlternateID, getPrimaryEmailAddressID, getRegisteredUserName, getRegistrationDate, getSensitivity, getStartDate, getStatusCode

Methods inherited from interface curam.util.persistence.Entity

getContextContainer, getID, getPersistenceEventDispatcher

Methods inherited from interface curam.piwrapper.impl.MeetingAttendee

getCaseRole, getMeetingAttendeeInfo

Method Detail

getPrimaryPhoneNumber

PhoneNumber getPrimaryPhoneNumber()

Gets the immutable primary phone number if specified.

Specified by:

getPrimaryPhoneNumber in interface ConcernRoleAccessor

Returns:

The immutable primary phone number if one has been specified, otherwise null.

getEmailAddress

EmailAddress getEmailAddress()

Gets the e-mail address if specified.

Returns:

The e-mail address of the Concern role if one has been specified, otherwise null.

getWebAddress

WebAddress getWebAddress()

Gets the web address of the concern role.

Returns:

The web address of the concern role

listRelationships

java.util.List<curam.piwrapper.participantmanager.impl.ConcernRoleRelationship> listRelationships()

Retrieves a list of active relationships for a ConcernRole. An active relationship is denoted by one that has a record status of RECORDSTATUS#NORMAL and doesn't have an end date in the past.

Returns:

A list of active relationships, or an empty list if none are found.

getPrimaryAddress

Address getPrimaryAddress()

Gets the primary address of the concern role.

Returns:

The address of the concern role

checkSecurity

void checkSecurity()
            throws curam.util.exception.InformationalException

Performs the security check for this concern role. The check determines if the current user has access to read the details of this concern role.

The following checks are performed in this process:

• Asserts the currents users sensitivity is greater than or equal to the sensitivity level of the concern role.

Throws:

curam.util.exception.InformationalException - GENERALCONCERNExceptionCreator#ERR_CONCERNROLE_FV_SENSITIVE() if the user does not have access rights to view this concern role

See Also:

ParticipantSecurityCheck.authorize(curam.core.sl.struct.ParticipantKeyStruct, curam.core.struct.UsersKey), LocationBasedSecurity.checkClientSecurity(curam.core.struct.ClientSecurityKey)