public interface CommitmentLookupSession extends OsidSession
This session provides methods for examining event commitments.
This session defines views that offer differing behaviors when retrieving multiple objects.
CommitmentAdminSession.
Modifier and Type | Method and Description |
---|---|
boolean |
canLookupCommitments()
Tests if this user can lookup event commitments.
|
Calendar |
getCalendar()
Gets the
Calendar associated with this session. |
Id |
getCalendarId()
Gets the
Calendar Id associated with
this session. |
Commitment |
getCommitment(Id commitmentId)
Gets the
Commitment specified by its Id. |
CommitmentList |
getCommitments()
Gets all commitments.
|
CommitmentList |
getCommitmentsByGenusType(Type commitmentGenusType)
Gets the commitments for the given event genus type.
|
CommitmentList |
getCommitmentsByGenusTypeForEvent(Id eventId,
Type commitmentGenusType)
Gets the commitments for the given event and commitment genus type
including any genus types derived from the given genus type.
|
CommitmentList |
getCommitmentsByGenusTypeForEventAndResource(Id eventId,
Id resourceId,
Type commitmentGenusType)
Gets the commitments of the given genus type for the given event,
resource, and commitment genus type including any genus types derived
from the given genus type.
|
CommitmentList |
getCommitmentsByGenusTypeForEventAndResourceOnDate(Id eventId,
Id resourceId,
Type commitmentGenusType,
DateTime from,
DateTime to)
Gets a
CommitmentList of the given genus type for the
given event, resource, commitment genus type and effective during the
entire given date range inclusive but not confined to the date range. |
CommitmentList |
getCommitmentsByGenusTypeForEventOnDate(Id eventId,
Type commitmentGenusType,
DateTime from,
DateTime to)
Gets a
CommitmentList for the given event and
commitment genus type effective during the entire given date range
inclusive but not confined to the date range. |
CommitmentList |
getCommitmentsByGenusTypeForResource(Id resourceId,
Type commitmentGenusType)
Gets the commitments for the given resource and commitment genus type
including any genus types derived from the given genus type.
|
CommitmentList |
getCommitmentsByGenusTypeForResourceOnDate(Id resourceId,
Type commitmentGenusType,
DateTime from,
DateTime to)
Gets a
CommitmentList for the given resource,
commitment genus type, and effective during the entire given date
range inclusive but not confined to the date range. |
CommitmentList |
getCommitmentsByGenusTypeOnDate(Type commitmentGenusType,
DateTime from,
DateTime to)
Gets a
CommitmentList of the given genus type and
effective during the entire given date range inclusive but not
confined to the date range. |
CommitmentList |
getCommitmentsByIds(IdList commitmentIds)
Gets a
CommitmentList corresponding to the given
IdList. |
CommitmentList |
getCommitmentsByParentGenusType(Type commitmentGenusType)
Gets the commitments for the given event genus type and include any
commitments with a genus type derived from the specified genus type.
|
CommitmentList |
getCommitmentsByRecordType(Type commitmentRecordType)
Gets a
CommitmentList containing the given event
commitment record Type. |
CommitmentList |
getCommitmentsForEvent(Id eventId)
Gets the commitments for the given event.
|
CommitmentList |
getCommitmentsForEventAndResource(Id eventId,
Id resourceId)
Gets the commitments for the given event and resource.
|
CommitmentList |
getCommitmentsForEventAndResourceOnDate(Id eventId,
Id resourceId,
DateTime from,
DateTime to)
Gets a
CommitmentList for the given event and resource
and effective during the entire given date range inclusive but not
confined to the date range. |
CommitmentList |
getCommitmentsForEventOnDate(Id eventId,
DateTime from,
DateTime to)
Gets a
CommitmentList for the given event and effective
during the entire given date range inclusive but not confined to the
date range. |
CommitmentList |
getCommitmentsForResource(Id resourceId)
Gets the commitments for the given resource.
|
CommitmentList |
getCommitmentsForResourceOnDate(Id resourceId,
DateTime from,
DateTime to)
Gets a
CommitmentList for the given resource and
effective during the entire given date range inclusive but not
confined to the date range. |
CommitmentList |
getCommitmentsOnDate(DateTime from,
DateTime to)
Gets a
CommitmentList effective during the entire given
date range inclusive but not confined to the date range. |
void |
useAnyEffectiveCommitmentView()
The commitments in this lookup session return both effective and
ineffective commitments.
|
void |
useComparativeCommitmentView()
The returns from the lookup methods may omit or translate elements
based on this session, such as authorization, and not result in an
error.
|
void |
useEffectiveCommitmentView()
The commitments in this lookup session return only commitments
currently in effect.
|
void |
useFederatedCalendarView()
Federates the view for methods in this session.
|
void |
useIsolatedCalendarView()
Isolates the view for methods in this session.
|
void |
usePlenaryCommitmentView()
A complete view of the
Commitment returns is desired. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getCalendarId()
Calendar
Id
associated with
this session. Calendar Id
associated with this sessionmandatory
- This method must be implemented. Calendar getCalendar() throws OperationFailedException, PermissionDeniedException
Calendar
associated with this session. Calendar
associated with this sessionOperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canLookupCommitments()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer lookup operations to
unauthorized users. false
if lookup methods are not authorized,
true
otherwisemandatory
- This method must be implemented. void useComparativeCommitmentView()
mandatory
- This method is must be implemented. void usePlenaryCommitmentView()
Commitment
returns is desired.
Methods will return what is requested or result in an error. This view
is used when greater precision is desired at the expense of
interoperability.mandatory
- This method is must be implemented. void useFederatedCalendarView()
mandatory
- This method is must be implemented. void useIsolatedCalendarView()
mandatory
- This method is must be implemented. void useEffectiveCommitmentView()
mandatory
- This method is must be implemented. void useAnyEffectiveCommitmentView()
mandatory
- This method is must be implemented. Commitment getCommitment(Id commitmentId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Commitment
specified by its Id.
In plenary mode, the exact Id
is found
or a NOT_FOUND
results. Otherwise, the returned
Commitment
may have a different Id
than
requested, such as the case where a duplicate Id
was
assigned to a Commitment
and retained for
compatibility.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.commitmentId
- Id
of the Commitment
NotFoundException
- commitmentId
not
foundNullArgumentException
- commitmentId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented. CommitmentList getCommitmentsByIds(IdList commitmentIds) throws NotFoundException, OperationFailedException, PermissionDeniedException
CommitmentList
corresponding to the given
IdList.
In plenary mode, the returned list contains all of the
commitments specified in the Id
list, in the order of
the list, including duplicates, or an error results if an Id
in the supplied list is not found or inaccessible. Otherwise,
inaccessible Commitments
may be omitted from the list
and may present the elements in any order including returning a unique
set.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.commitmentIds
- the list of Ids
to retrieve Commitment
listNotFoundException
- an Id
was not foundNullArgumentException
- commitmentIds
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CommitmentList getCommitmentsByGenusType(Type commitmentGenusType) throws OperationFailedException, PermissionDeniedException
commitmentGenusType
- commitment genus typeNullArgumentException
- commitmentGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented. CommitmentList getCommitmentsByParentGenusType(Type commitmentGenusType) throws OperationFailedException, PermissionDeniedException
commitmentGenusType
- commitment genus typeNullArgumentException
- commitmentGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented. CommitmentList getCommitmentsByRecordType(Type commitmentRecordType) throws OperationFailedException, PermissionDeniedException
CommitmentList
containing the given event
commitment record Type.
In plenary mode, the returned list contains all known
commitments or an error results. Otherwise, the returned list may
contain only those commitments that are accessible through this
session.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.commitmentRecordType
- a commitment record typeNullArgumentException
- eventRecordType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CommitmentList getCommitmentsOnDate(DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
CommitmentList
effective during the entire given
date range inclusive but not confined to the date range.
In plenary mode, the returned list contains all known
commitments or an error results. Otherwise, the returned list may
contain only those commitments that are accessible through this
session.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.from
- starting dateto
- ending dateInvalidArgumentException
- from
is
greater than to
NullArgumentException
- from
or
to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CommitmentList getCommitmentsByGenusTypeOnDate(Type commitmentGenusType, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
CommitmentList
of the given genus type and
effective during the entire given date range inclusive but not
confined to the date range.
In plenary mode, the returned list contains all known
commitments or an error results. Otherwise, the returned list may
contain only those commitments that are accessible through this
session.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.commitmentGenusType
- a commitment genus typefrom
- starting dateto
- ending dateInvalidArgumentException
- from
is
greater than to
NullArgumentException
- commitmentGenusType,
from,
or to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CommitmentList getCommitmentsForEvent(Id eventId) throws OperationFailedException, PermissionDeniedException
Id
or an error results if an Id in
the supplied list is not found or inaccessible. Otherwise,
inaccessible Commitments
may be omitted from the list
and may present the elements in any order including returning a unique
set.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.eventId
- Id
of the Event
NullArgumentException
- eventId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented. CommitmentList getCommitmentsForEventOnDate(Id eventId, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
CommitmentList
for the given event and effective
during the entire given date range inclusive but not confined to the
date range.
In plenary mode, the returned list contains all known
commitments or an error results. Otherwise, the returned list may
contain only those commitments that are accessible through this
session.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.eventId
- Id
of the Event
from
- starting dateto
- ending dateInvalidArgumentException
- from
is
greater than to
NullArgumentException
- eventId, from
or
to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CommitmentList getCommitmentsByGenusTypeForEvent(Id eventId, Type commitmentGenusType) throws OperationFailedException, PermissionDeniedException
Id
or an
error results if an Id in the supplied list is not found or
inaccessible. Otherwise, inaccessible commitments may be ommitted.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.eventId
- Id
of the Event
commitmentGenusType
- commitment genus typeNullArgumentException
- eventId
or
commitmentGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented. CommitmentList getCommitmentsByGenusTypeForEventOnDate(Id eventId, Type commitmentGenusType, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
CommitmentList
for the given event and
commitment genus type effective during the entire given date range
inclusive but not confined to the date range.
In plenary mode, the returned list contains all known
commitments or an error results. Otherwise, the returned list may
contain only those commitments that are accessible through this
session.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.eventId
- Id
of the Event
commitmentGenusType
- commitment genus typefrom
- starting dateto
- ending dateInvalidArgumentException
- from
is
greater than to
NullArgumentException
- eventId,
commitmentGenusType, from
or to
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CommitmentList getCommitmentsForResource(Id resourceId) throws OperationFailedException, PermissionDeniedException
Id
or an error results if an Id
in the supplied list is not found or inaccessible. Otherwise,
inaccessible Commitments
may be omitted from the list
and may present the elements in any order including returning a unique
set.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.resourceId
- Id
of a Resource
NullArgumentException
- resourceId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented. CommitmentList getCommitmentsForResourceOnDate(Id resourceId, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
CommitmentList
for the given resource and
effective during the entire given date range inclusive but not
confined to the date range.
In plenary mode, the returned list contains all known
commitments or an error results. Otherwise, the returned list may
contain only those commitments that are accessible through this
session.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.resourceId
- Id
of the Event
from
- starting dateto
- ending dateInvalidArgumentException
- from
is
greater than to
NullArgumentException
- resourceId, from
or to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CommitmentList getCommitmentsByGenusTypeForResource(Id resourceId, Type commitmentGenusType) throws OperationFailedException, PermissionDeniedException
Id
or an error results if an Id
in the supplied list is not found or inaccessible. Otherwise,
inaccessible Commitments
may be omitted from the list
and may present the elements in any order including returning a unique
set.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.resourceId
- Id
of a Resource
commitmentGenusType
- commitment genus typeNullArgumentException
- resourceId
or
commitmentGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented. CommitmentList getCommitmentsByGenusTypeForResourceOnDate(Id resourceId, Type commitmentGenusType, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
CommitmentList
for the given resource,
commitment genus type, and effective during the entire given date
range inclusive but not confined to the date range.
In plenary mode, the returned list contains all known
commitments or an error results. Otherwise, the returned list may
contain only those commitments that are accessible through this
session.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.resourceId
- Id
of the Event
commitmentGenusType
- commitment genus typefrom
- starting dateto
- ending dateInvalidArgumentException
- from
is
greater than to
NullArgumentException
- resourceId,
commitmentGenusType, from
or to
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CommitmentList getCommitmentsForEventAndResource(Id eventId, Id resourceId) throws OperationFailedException, PermissionDeniedException
Id
or an error results if an Id in
the supplied list is not found or inaccessible. Otherwise,
inaccessible Commitments
may be omitted from the list
and may present the elements in any order including returning a unique
set.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.eventId
- Id
of the Event
resourceId
- Id
of a Resource
NullArgumentException
- eventId
or
resourceId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented. CommitmentList getCommitmentsForEventAndResourceOnDate(Id eventId, Id resourceId, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
CommitmentList
for the given event and resource
and effective during the entire given date range inclusive but not
confined to the date range.
In plenary mode, the returned list contains all known
commitments or an error results. Otherwise, the returned list may
contain only those commitments that are accessible through this
session.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.eventId
- Id
of the Event
resourceId
- Id
of a Resource
from
- starting dateto
- ending dateInvalidArgumentException
- from
is
greater than to
NullArgumentException
- eventId, resourceId,
from
or to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CommitmentList getCommitmentsByGenusTypeForEventAndResource(Id eventId, Id resourceId, Type commitmentGenusType) throws OperationFailedException, PermissionDeniedException
Id
or an error results if an Id in
the supplied list is not found or inaccessible. Otherwise,
inaccessible Commitments
may be omitted from the list
and may present the elements in any order including returning a unique
set.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.eventId
- Id
of the Event
resourceId
- Id
of a Resource
commitmentGenusType
- commitment genus typeNullArgumentException
- eventId, resourceId
or commitmentGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented. CommitmentList getCommitmentsByGenusTypeForEventAndResourceOnDate(Id eventId, Id resourceId, Type commitmentGenusType, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
CommitmentList
of the given genus type for the
given event, resource, commitment genus type and effective during the
entire given date range inclusive but not confined to the date range.
In plenary mode, the returned list contains all known
commitments or an error results. Otherwise, the returned list may
contain only those commitments that are accessible through this
session.
In effective mode, commitments are returned that are currently
effective. In any effective mode, effective commitments and those
currently expired are returned.eventId
- Id
of the Event
resourceId
- Id
of a Resource
commitmentGenusType
- commitment genus typefrom
- starting dateto
- ending dateInvalidArgumentException
- from
is
greater than to
NullArgumentException
- eventId, resourceId,
commitmentGenusType, from
or to
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. CommitmentList getCommitments() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method is must be implemented.