org.kuali.student.enrollment.lui.service
Interface LuiService

All Superinterfaces:

org.kuali.student.core.dictionary.service.DictionaryService, org.kuali.student.core.search.service.SearchService, org.kuali.student.core.versionmanagement.service.VersionManagementService

public interface LuiService
extends org.kuali.student.core.dictionary.service.DictionaryService, org.kuali.student.core.search.service.SearchService, org.kuali.student.core.versionmanagement.service.VersionManagementService

LUI Service

Method Summary

LuiInfo	createLui(String cluId, String atpKey, LuiInfo luiInfo, ContextInfo context) Creates a new LUI.
LuiLuiRelationInfo	createLuiLuiRelation(String luiId, String relatedLuiId, String luLuRelationType, LuiLuiRelationInfo luiLuiRelationInfo, ContextInfo context) Create a relationship between two LUIs.
org.kuali.student.core.dto.StatusInfo	deleteLui(String luiId, ContextInfo context) Deletes a LUI record.
org.kuali.student.core.dto.StatusInfo	deleteLuiLuiRelation(String luiLuiRelationId, ContextInfo context) Deletes a relationship between two LUIs.
List<String>	getAllowedLuiLuiRelationTypesByLuiId(String luiId, String relatedLuiId, ContextInfo context) Retrieves the list of allowed relation types between the two specified LUIs.
LuiInfo	getLui(String luiId, ContextInfo context) Retrieves information about a LUI.
List<String>	getLuiIdsByCluId(String cluId, ContextInfo context) Retrieves the list of LUI ids for the specified CLU.
List<String>	getLuiIdsByRelation(String relatedLuiId, String luLuRelationType, ContextInfo context) Retrieves the list of LUI Ids for the specified related LUI Id and LU to LU relation type (getRelatedLuiIdsByLuiId from the other direction).
List<String>	getLuiIdsInAtpByCluId(String cluId, String atpKey, ContextInfo context) Retrieves the list of LUI ids for the specified CLU and Time period.
LuiLuiRelationInfo	getLuiLuiRelation(String luiLuiRelationId, ContextInfo context) Retrieves the relationship information between LUIs given a specific relation instance.
List<LuiLuiRelationInfo>	getLuiLuiRelationsByLui(String luiId, ContextInfo context) Retrieves the list of relationship information for the specified LUI.
List<LuiInfo>	getLuisByIdList(List<String> luiIdList, ContextInfo context) Retrieves information about LUIs from a list of Ids.
List<LuiInfo>	getLuisByRelation(String relatedLuiId, String luLuRelationType, ContextInfo context) Retrieves the list of LUI information for the LUIs related to the specified LUI Id with a certain LU to LU relation type.
List<LuiInfo>	getLuisInAtpByCluId(String cluId, String atpKey, ContextInfo context) Retrieves the list of LUIs for the specified CLU and period.
List<String>	getRelatedLuiIdsByLuiId(String luiId, String luLuRelationType, ContextInfo context) Retrieves the list of related LUI Ids for the specified LUI Id and LU to LU relation type.
List<LuiInfo>	getRelatedLuisByLuiId(String luiId, String luLuRelationType, ContextInfo context) Retrieves the list of related LUI information for the specified LUI Id and LU to LU relation type (getLuisByRelation from the other direction).
LuiInfo	updateLui(String luiId, LuiInfo luiInfo, ContextInfo context) Updates an existing LUI.
LuiLuiRelationInfo	updateLuiLuiRelation(String luiLuiRelationId, LuiLuiRelationInfo luiLuiRelationInfo, ContextInfo context) Updates a relationship between two LUIs.
LuiInfo	updateLuiState(String luiId, String luState, ContextInfo context) Updates the state of the LUI.
List<org.kuali.student.core.validation.dto.ValidationResultInfo>	validateLui(String validationType, LuiInfo luiInfo, ContextInfo context) Validates a LUI.
List<org.kuali.student.core.validation.dto.ValidationResultInfo>	validateLuiLuiRelation(String validationType, LuiLuiRelationInfo luiLuiRelationInfo, ContextInfo context) Validates a relationship between LUIs.

Methods inherited from interface org.kuali.student.core.dictionary.service.DictionaryService

getObjectStructure, getObjectTypes

Methods inherited from interface org.kuali.student.core.search.service.SearchService

getSearchCriteriaType, getSearchCriteriaTypes, getSearchResultType, getSearchResultTypes, getSearchType, getSearchTypes, getSearchTypesByCriteria, getSearchTypesByResult, search

Methods inherited from interface org.kuali.student.core.versionmanagement.service.VersionManagementService

getCurrentVersion, getCurrentVersionOnDate, getFirstVersion, getLatestVersion, getVersionBySequenceNumber, getVersions, getVersionsInDateRange

Method Detail

getLui

LuiInfo getLui(String luiId,
               ContextInfo context)
               throws org.kuali.student.core.exceptions.DoesNotExistException,
                      org.kuali.student.core.exceptions.InvalidParameterException,
                      org.kuali.student.core.exceptions.MissingParameterException,
                      org.kuali.student.core.exceptions.OperationFailedException

Retrieves information about a LUI.

Parameters:

luiId - identifier of the LUI

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

information about a LUI

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - lui not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid luiId

org.kuali.student.core.exceptions.MissingParameterException - missing luiId

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

getLuisByIdList

List<LuiInfo> getLuisByIdList(List<String> luiIdList,
                              ContextInfo context)
                              throws org.kuali.student.core.exceptions.DoesNotExistException,
                                     org.kuali.student.core.exceptions.InvalidParameterException,
                                     org.kuali.student.core.exceptions.MissingParameterException,
                                     org.kuali.student.core.exceptions.OperationFailedException

Retrieves information about LUIs from a list of Ids.

Parameters:

luiIdList - List of LUI identifiers

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

information about a list of LUIs

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - One or more luis not found

org.kuali.student.core.exceptions.InvalidParameterException - One or more invalid luiIds

org.kuali.student.core.exceptions.MissingParameterException - missing luiIdList

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

getLuisInAtpByCluId

List<LuiInfo> getLuisInAtpByCluId(String cluId,
                                  String atpKey,
                                  ContextInfo context)
                                  throws org.kuali.student.core.exceptions.DoesNotExistException,
                                         org.kuali.student.core.exceptions.InvalidParameterException,
                                         org.kuali.student.core.exceptions.MissingParameterException,
                                         org.kuali.student.core.exceptions.OperationFailedException

Retrieves the list of LUIs for the specified CLU and period.

Parameters:

cluId - identifier of the CLU

atpKey - identifier for the academic time period

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

list of LUI information

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - clu, atp not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid cluId, atpKey

org.kuali.student.core.exceptions.MissingParameterException - missing cluId, atpKey

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

getLuiIdsByCluId

List<String> getLuiIdsByCluId(String cluId,
                              ContextInfo context)
                              throws org.kuali.student.core.exceptions.DoesNotExistException,
                                     org.kuali.student.core.exceptions.InvalidParameterException,
                                     org.kuali.student.core.exceptions.MissingParameterException,
                                     org.kuali.student.core.exceptions.OperationFailedException

Retrieves the list of LUI ids for the specified CLU.

Parameters:

cluId - identifier of the CLU

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

list of LUI identifiers

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - clu not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid cluId

org.kuali.student.core.exceptions.MissingParameterException - missing cluId

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

getLuiIdsInAtpByCluId

List<String> getLuiIdsInAtpByCluId(String cluId,
                                   String atpKey,
                                   ContextInfo context)
                                   throws org.kuali.student.core.exceptions.DoesNotExistException,
                                          org.kuali.student.core.exceptions.InvalidParameterException,
                                          org.kuali.student.core.exceptions.MissingParameterException,
                                          org.kuali.student.core.exceptions.OperationFailedException

Retrieves the list of LUI ids for the specified CLU and Time period.

Parameters:

cluId - identifier of the CLU

atpKey - identifier for the academic time period

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

list of LUI identifiers

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - clu, atp not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid cluId, atpKey

org.kuali.student.core.exceptions.MissingParameterException - missing cluId, atpKey

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

getAllowedLuiLuiRelationTypesByLuiId

List<String> getAllowedLuiLuiRelationTypesByLuiId(String luiId,
                                                  String relatedLuiId,
                                                  ContextInfo context)
                                                  throws org.kuali.student.core.exceptions.DoesNotExistException,
                                                         org.kuali.student.core.exceptions.InvalidParameterException,
                                                         org.kuali.student.core.exceptions.MissingParameterException,
                                                         org.kuali.student.core.exceptions.OperationFailedException

Retrieves the list of allowed relation types between the two specified LUIs.

Parameters:

luiId - identifier of the first LUI

relatedLuiId - identifier of the second LUI

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

list of LU to LU relation types

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - lui, relatedLui not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid luiId, relatedLuiId

org.kuali.student.core.exceptions.MissingParameterException - missing luiId, relatedLuiId

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

getLuisByRelation

List<LuiInfo> getLuisByRelation(String relatedLuiId,
                                String luLuRelationType,
                                ContextInfo context)
                                throws org.kuali.student.core.exceptions.DoesNotExistException,
                                       org.kuali.student.core.exceptions.InvalidParameterException,
                                       org.kuali.student.core.exceptions.MissingParameterException,
                                       org.kuali.student.core.exceptions.OperationFailedException

Retrieves the list of LUI information for the LUIs related to the specified LUI Id with a certain LU to LU relation type.

(getRelatedLuisByLuiId from the other direction)

Parameters:

relatedLuiId - identifier of the LUI

luLuRelationType - the LU to LU relation type

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

list of LUI information

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - relatedLui, luLuRelationType not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid relatedLuiId, luLuRelationType

org.kuali.student.core.exceptions.MissingParameterException - missing relatedLuiId, luLuRelationType

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

getLuiIdsByRelation

List<String> getLuiIdsByRelation(String relatedLuiId,
                                 String luLuRelationType,
                                 ContextInfo context)
                                 throws org.kuali.student.core.exceptions.DoesNotExistException,
                                        org.kuali.student.core.exceptions.InvalidParameterException,
                                        org.kuali.student.core.exceptions.MissingParameterException,
                                        org.kuali.student.core.exceptions.OperationFailedException

Retrieves the list of LUI Ids for the specified related LUI Id and LU to LU relation type (getRelatedLuiIdsByLuiId from the other direction).

Parameters:

relatedLuiId - identifier of the LUI

luLuRelationType - the LU to LU relation type

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

list of LUI identifiers

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - relatedLui, luLuRelationType not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid relatedLuiId, luLuRelationType

org.kuali.student.core.exceptions.MissingParameterException - missing relatedLuiId, luLuRelationType

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

getRelatedLuisByLuiId

List<LuiInfo> getRelatedLuisByLuiId(String luiId,
                                    String luLuRelationType,
                                    ContextInfo context)
                                    throws org.kuali.student.core.exceptions.DoesNotExistException,
                                           org.kuali.student.core.exceptions.InvalidParameterException,
                                           org.kuali.student.core.exceptions.MissingParameterException,
                                           org.kuali.student.core.exceptions.OperationFailedException

Retrieves the list of related LUI information for the specified LUI Id and LU to LU relation type (getLuisByRelation from the other direction).

Parameters:

luiId - identifier of the LUI

luLuRelationType - the LU to LU relation type

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

list of LUI information

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - lui, luLuRelationType not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid luiId, luLuRelationType

org.kuali.student.core.exceptions.MissingParameterException - missing luiId, luLuRelationType

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

getRelatedLuiIdsByLuiId

List<String> getRelatedLuiIdsByLuiId(String luiId,
                                     String luLuRelationType,
                                     ContextInfo context)
                                     throws org.kuali.student.core.exceptions.DoesNotExistException,
                                            org.kuali.student.core.exceptions.InvalidParameterException,
                                            org.kuali.student.core.exceptions.MissingParameterException,
                                            org.kuali.student.core.exceptions.OperationFailedException

Retrieves the list of related LUI Ids for the specified LUI Id and LU to LU relation type. (getLuiIdsByRelation from the other direction).

Parameters:

luiId - identifier of the LUI

luLuRelationType - the LU to LU relation type

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

list of LUI identifiers

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - luiId, luLuRelationType not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid luiId, luLuRelationType

org.kuali.student.core.exceptions.MissingParameterException - missing luiId, luLuRelationType

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

getLuiLuiRelation

LuiLuiRelationInfo getLuiLuiRelation(String luiLuiRelationId,
                                     ContextInfo context)
                                     throws org.kuali.student.core.exceptions.DoesNotExistException,
                                            org.kuali.student.core.exceptions.InvalidParameterException,
                                            org.kuali.student.core.exceptions.MissingParameterException,
                                            org.kuali.student.core.exceptions.OperationFailedException

Retrieves the relationship information between LUIs given a specific relation instance.

Parameters:

luiLuiRelationId - identifier of LUI to LUI relatio

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

information on the relation between two LUIs

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - luiLuiRelation not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid luiLuiRelationId

org.kuali.student.core.exceptions.MissingParameterException - missing luiLuiRelationId

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

getLuiLuiRelationsByLui

List<LuiLuiRelationInfo> getLuiLuiRelationsByLui(String luiId,
                                                 ContextInfo context)
                                                 throws org.kuali.student.core.exceptions.DoesNotExistException,
                                                        org.kuali.student.core.exceptions.InvalidParameterException,
                                                        org.kuali.student.core.exceptions.MissingParameterException,
                                                        org.kuali.student.core.exceptions.OperationFailedException

Retrieves the list of relationship information for the specified LUI.

Parameters:

luiId - identifier of the LUI

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

list of LUI to LUI relation information

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - lui not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid luiId

org.kuali.student.core.exceptions.MissingParameterException - missing luiId

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

validateLui

List<org.kuali.student.core.validation.dto.ValidationResultInfo> validateLui(String validationType,
                                                                             LuiInfo luiInfo,
                                                                             ContextInfo context)
                                                                             throws org.kuali.student.core.exceptions.DoesNotExistException,
                                                                                    org.kuali.student.core.exceptions.InvalidParameterException,
                                                                                    org.kuali.student.core.exceptions.MissingParameterException,
                                                                                    org.kuali.student.core.exceptions.OperationFailedException

Validates a LUI. Depending on the value of validationType, this validation could be limited to tests on just the current object and its directly contained sub-objects or expanded to perform all tests related to this object. If an identifier is present for the LUI (and/or one of its contained sub-objects) and a record is found for that identifier, the validation checks if the LUI can be shifted to the new values. If an identifier is not present or a record cannot be found for the identifier, it is assumed that the record does not exist and as such, the checks performed will be much shallower, typically mimicking those performed by setting the validationType to the current object.

Parameters:

validationType - identifier of the extent of validation

luiInfo - LUI information to be tested.

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

results from performing the validation

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - validationTypeKey not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid validationTypeKey, luiInfo

org.kuali.student.core.exceptions.MissingParameterException - missing validationTypeKey, luiInfo

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

createLui

LuiInfo createLui(String cluId,
                  String atpKey,
                  LuiInfo luiInfo,
                  ContextInfo context)
                  throws org.kuali.student.core.exceptions.AlreadyExistsException,
                         org.kuali.student.core.exceptions.DataValidationErrorException,
                         org.kuali.student.core.exceptions.DoesNotExistException,
                         org.kuali.student.core.exceptions.InvalidParameterException,
                         org.kuali.student.core.exceptions.MissingParameterException,
                         org.kuali.student.core.exceptions.OperationFailedException,
                         org.kuali.student.core.exceptions.PermissionDeniedException

Creates a new LUI.

Parameters:

cluId - identifier of the CLU for the LUI being created

atpKey - identifier of the academic time period for the LUI being created

luiInfo - information about the LUI being created

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

the created LUI information

Throws:

org.kuali.student.core.exceptions.AlreadyExistsException - LUI already exists

org.kuali.student.core.exceptions.DataValidationErrorException - One or more values invalid for this operation

org.kuali.student.core.exceptions.DoesNotExistException - clu, atp not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid cluId, atpKey, luiInfo

org.kuali.student.core.exceptions.MissingParameterException - missing cluId, atpKey, luiInfo

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

org.kuali.student.core.exceptions.PermissionDeniedException - authorization failure

updateLui

LuiInfo updateLui(String luiId,
                  LuiInfo luiInfo,
                  ContextInfo context)
                  throws org.kuali.student.core.exceptions.DataValidationErrorException,
                         org.kuali.student.core.exceptions.DoesNotExistException,
                         org.kuali.student.core.exceptions.InvalidParameterException,
                         org.kuali.student.core.exceptions.MissingParameterException,
                         org.kuali.student.core.exceptions.OperationFailedException,
                         org.kuali.student.core.exceptions.PermissionDeniedException,
                         org.kuali.student.core.exceptions.VersionMismatchException

Updates an existing LUI.

Parameters:

luiId - identifier for the LUI to be updated

luiInfo - updated information about the LUI

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

the updated LUI information

Throws:

org.kuali.student.core.exceptions.DataValidationErrorException - One or more values invalid for this operation

org.kuali.student.core.exceptions.DoesNotExistException - lui not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid luiId, luiInfo

org.kuali.student.core.exceptions.MissingParameterException - missing luiId, luiInfo

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

org.kuali.student.core.exceptions.PermissionDeniedException - authorization failure

org.kuali.student.core.exceptions.VersionMismatchException - The action was attempted on an out of date version.

deleteLui

org.kuali.student.core.dto.StatusInfo deleteLui(String luiId,
                                                ContextInfo context)
                                                throws org.kuali.student.core.exceptions.DependentObjectsExistException,
                                                       org.kuali.student.core.exceptions.DoesNotExistException,
                                                       org.kuali.student.core.exceptions.InvalidParameterException,
                                                       org.kuali.student.core.exceptions.MissingParameterException,
                                                       org.kuali.student.core.exceptions.OperationFailedException,
                                                       org.kuali.student.core.exceptions.PermissionDeniedException

Deletes a LUI record.

Parameters:

luiId - identifier for the LUI to be deleted

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

status of the operation

Throws:

org.kuali.student.core.exceptions.DependentObjectsExistException - delete would leave orphaned objects or violate integrity constraints

org.kuali.student.core.exceptions.DoesNotExistException - lui not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid luiId

org.kuali.student.core.exceptions.MissingParameterException - missing luiId

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

org.kuali.student.core.exceptions.PermissionDeniedException - authorization failure

updateLuiState

LuiInfo updateLuiState(String luiId,
                       String luState,
                       ContextInfo context)
                       throws org.kuali.student.core.exceptions.DataValidationErrorException,
                              org.kuali.student.core.exceptions.DoesNotExistException,
                              org.kuali.student.core.exceptions.InvalidParameterException,
                              org.kuali.student.core.exceptions.MissingParameterException,
                              org.kuali.student.core.exceptions.OperationFailedException,
                              org.kuali.student.core.exceptions.PermissionDeniedException

Updates the state of the LUI.

Parameters:

luiId - identifier for the LUI to be updated

luState - New state for LUI. Value is expected to be constrained to those in the luState enumeration.

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

the updated LUI information

Throws:

org.kuali.student.core.exceptions.DataValidationErrorException - New state not valid for existing state of LUI

org.kuali.student.core.exceptions.DoesNotExistException - lui, luState not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid luiId, luState

org.kuali.student.core.exceptions.MissingParameterException - missing luiId, luState

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

org.kuali.student.core.exceptions.PermissionDeniedException - authorization failure

validateLuiLuiRelation

List<org.kuali.student.core.validation.dto.ValidationResultInfo> validateLuiLuiRelation(String validationType,
                                                                                        LuiLuiRelationInfo luiLuiRelationInfo,
                                                                                        ContextInfo context)
                                                                                        throws org.kuali.student.core.exceptions.DoesNotExistException,
                                                                                               org.kuali.student.core.exceptions.InvalidParameterException,
                                                                                               org.kuali.student.core.exceptions.MissingParameterException,
                                                                                               org.kuali.student.core.exceptions.OperationFailedException

Validates a relationship between LUIs. Depending on the value of validationType, this validation could be limited to tests on just the current object and its directly contained sub-objects or expanded to perform all tests related to this object. If an identifier is present for the relationship (and/or one of its contained sub-objects) and a record is found for that identifier, the validation checks if the relationship can be shifted to the new values. If an identifier is not present or a record cannot be found for the identifier, it is assumed that the record does not exist and as such, the checks performed will be much shallower, typically mimicking those performed by setting the validationType to the current object.

Parameters:

validationType - identifier of the extent of validation

luiLuiRelationInfo - LUI to LUI relationship information to be tested.

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

results from performing the validation

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - validationTypeKey not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid validationTypeKey, luiLuiRelationInfo

org.kuali.student.core.exceptions.MissingParameterException - missing validationTypeKey, luiLuiRelationInfo

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

createLuiLuiRelation

LuiLuiRelationInfo createLuiLuiRelation(String luiId,
                                        String relatedLuiId,
                                        String luLuRelationType,
                                        LuiLuiRelationInfo luiLuiRelationInfo,
                                        ContextInfo context)
                                        throws org.kuali.student.core.exceptions.AlreadyExistsException,
                                               org.kuali.student.core.exceptions.CircularRelationshipException,
                                               org.kuali.student.core.exceptions.DataValidationErrorException,
                                               org.kuali.student.core.exceptions.DoesNotExistException,
                                               org.kuali.student.core.exceptions.InvalidParameterException,
                                               org.kuali.student.core.exceptions.MissingParameterException,
                                               org.kuali.student.core.exceptions.OperationFailedException,
                                               org.kuali.student.core.exceptions.PermissionDeniedException

Create a relationship between two LUIs.

Parameters:

luiId - identifier of the first LUI in the relationship

relatedLuiId - identifier of the second LUI in the relationship to be related to

luLuRelationType - the LU to LU relationship type of the relationship

luiLuiRelationInfo - information about the relationship between the two LUIs

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

the created LUI to LUI relation information

Throws:

org.kuali.student.core.exceptions.AlreadyExistsException - relationship already exists

org.kuali.student.core.exceptions.CircularRelationshipException - luiId equals relatedLuiId

org.kuali.student.core.exceptions.DataValidationErrorException - One or more values invalid for this operation

org.kuali.student.core.exceptions.DoesNotExistException - luiId, relatedLuiId, luLuRelationType not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid luiIds, luluRelationType, luiLuiRelationInfo

org.kuali.student.core.exceptions.MissingParameterException - missing luiIds, luluRelationType, luiLuiRelationInfo

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

org.kuali.student.core.exceptions.PermissionDeniedException - authorization failure

updateLuiLuiRelation

LuiLuiRelationInfo updateLuiLuiRelation(String luiLuiRelationId,
                                        LuiLuiRelationInfo luiLuiRelationInfo,
                                        ContextInfo context)
                                        throws org.kuali.student.core.exceptions.DataValidationErrorException,
                                               org.kuali.student.core.exceptions.DoesNotExistException,
                                               org.kuali.student.core.exceptions.InvalidParameterException,
                                               org.kuali.student.core.exceptions.MissingParameterException,
                                               org.kuali.student.core.exceptions.OperationFailedException,
                                               org.kuali.student.core.exceptions.PermissionDeniedException,
                                               org.kuali.student.core.exceptions.VersionMismatchException

Updates a relationship between two LUIs.

Parameters:

luiLuiRelationId - identifier of the LUI to LUI relation to update

luiLuiRelationInfo - changed information about the relationship between the two LUIs

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

the update LUI to LUI relation information

Throws:

org.kuali.student.core.exceptions.DataValidationErrorException - One or more values invalid for this operation

org.kuali.student.core.exceptions.DoesNotExistException - luiLuiRelation not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid luiLuiRelationId, luiLuiRelationInfo

org.kuali.student.core.exceptions.MissingParameterException - missing luiLuiRelationId, luiLuiRelationInfo

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

org.kuali.student.core.exceptions.PermissionDeniedException - authorization failure

org.kuali.student.core.exceptions.VersionMismatchException - The action was attempted on an out of date version.

deleteLuiLuiRelation

org.kuali.student.core.dto.StatusInfo deleteLuiLuiRelation(String luiLuiRelationId,
                                                           ContextInfo context)
                                                           throws org.kuali.student.core.exceptions.DoesNotExistException,
                                                                  org.kuali.student.core.exceptions.InvalidParameterException,
                                                                  org.kuali.student.core.exceptions.MissingParameterException,
                                                                  org.kuali.student.core.exceptions.OperationFailedException,
                                                                  org.kuali.student.core.exceptions.PermissionDeniedException

Deletes a relationship between two LUIs.

Parameters:

luiLuiRelationId - identifier of the LUI to LUI relation to delete

context - Context information containing the principalId and locale information about the caller of service operation

Returns:

status of the operation (success or failure)

Throws:

org.kuali.student.core.exceptions.DoesNotExistException - luiLuiRelation not found

org.kuali.student.core.exceptions.InvalidParameterException - invalid luiLuiRelationId

org.kuali.student.core.exceptions.MissingParameterException - missing luiLuiRelationId

org.kuali.student.core.exceptions.OperationFailedException - unable to complete request

org.kuali.student.core.exceptions.PermissionDeniedException - authorization failure