public interface ParticipantLookupSession extends OsidSession
This session defines methods for retrieving participants.
This lookup session defines several views:
ParticipantAdminSession.
The methods useFederatedCatalogueView()
and
useIsolatedCatalogueView()
behave as a radio group and one should
be selected before invoking any lookup methods.
Modifier and Type | Method and Description |
---|---|
boolean |
canLookupParticipants()
Tests if this user can examine this catalogue.
|
Catalogue |
getCatalogue()
Gets the
Catalogue associated with this session. |
Id |
getCatalogueId()
Gets the
Catalogue Id associated with
this session. |
Participant |
getParticipant(Id participantId)
Gets the
Participant specified by its Id. |
ParticipantList |
getParticipants()
Gets all participants.
|
ParticipantList |
getParticipantsByGenusType(Type participantGenusType)
Gets a
ParticipantList corresponding to the given
participant genus Type which does not include
participants of types derived from the specified Type. |
ParticipantList |
getParticipantsByGenusTypeForOffering(Id offeringId,
Type participantGenusType)
Gets a
ParticipantList by genus type for the given
offering . |
ParticipantList |
getParticipantsByGenusTypeForOfferingAndResource(Id offeringId,
Id resourceId,
Type participantGenusType)
Gets a
ParticipantList by genus type for the given
offering and resource . |
ParticipantList |
getParticipantsByGenusTypeForOfferingAndResourceOnDate(Id offeringId,
Id resourceId,
Type participantGenusType,
DateTime from,
DateTime to)
Gets a
ParticipantList by genus type for an offering,
resource, and effective during the entire given date range inclusive
but not confined to the date range. |
ParticipantList |
getParticipantsByGenusTypeForOfferingOnDate(Id offeringId,
Type participantGenusType,
DateTime from,
DateTime to)
Gets a
ParticipantList by genus type for an offering
and effective during the entire given date range inclusive but not
confined to the date range. |
ParticipantList |
getParticipantsByGenusTypeForResource(Id resourceId,
Type participantGenusType)
Gets a
ParticipantList by genus type for the given
resource. |
ParticipantList |
getParticipantsByGenusTypeForResourceOnDate(Id resourceId,
Type participantGenusType,
DateTime from,
DateTime to)
Gets a
ParticipantList by genus type for a resource and
effective during the entire given date range inclusive but not
confined to the date range. |
ParticipantList |
getParticipantsByGenusTypeOnDate(Type participantGenusType,
DateTime from,
DateTime to)
Gets a
ParticipantList by genus type and effective
during the entire given date range inclusive but not confined to the
date range. |
ParticipantList |
getParticipantsByIds(IdList participantIds)
Gets a
ParticipantList corresponding to the given
IdList. |
ParticipantList |
getParticipantsByParentGenusType(Type participantGenusType)
Gets a
ParticipantList corresponding to the given
participant genus Type and include any additional
participants with genus types derived from the specified Type. |
ParticipantList |
getParticipantsByRecordType(Type participantRecordType)
Gets a
ParticipantList containing the given participant
record Type. |
ParticipantList |
getParticipantsByTimePeriodAndGenusTypeForOffering(Id offeringId,
Id timePeriodId,
Type participantGenusType)
Gets a
ParticipantList by genus type for the given
offering in a time period . |
ParticipantList |
getParticipantsByTimePeriodAndGenusTypeForOfferingAndResource(Id offeringId,
Id resourceId,
Id timePeriodId,
Type participantGenusType)
Gets a
ParticipantList by genus type for the given
offering and resource in a time period . |
ParticipantList |
getParticipantsByTimePeriodAndGenusTypeForOfferingAndResourceOnDate(Id offeringId,
Id resourceId,
Id timePeriodId,
Type participantGenusType,
DateTime from,
DateTime to)
Gets a
ParticipantList by genus type for an offering
and resource in a time period and effective during the entire given
date range inclusive but not confined to the date range. |
ParticipantList |
getParticipantsByTimePeriodAndGenusTypeForOfferingOnDate(Id offeringId,
Id timePeriodId,
Type participantGenusType,
DateTime from,
DateTime to)
Gets a
ParticipantList by genus type for an offering in
a time period and effective during the entire given date range
inclusive but not confined to the date range. |
ParticipantList |
getParticipantsByTimePeriodAndGenusTypeForResource(Id resourceId,
Id timePeriodId,
Type participantGenusType)
Gets a
ParticipantList by genus type for the given
resource in a time period . |
ParticipantList |
getParticipantsByTimePeriodAndGenusTypeForResourceOnDate(Id resourceId,
Id timePeriodId,
Type participantGenusType,
DateTime from,
DateTime to)
Gets a
ParticipantList by genus type for a resource in
a time period and effective during the entire given date range
inclusive but not confined to the date range. |
ParticipantList |
getParticipantsByTimePeriodForOffering(Id offeringId,
Id timePeriodId)
Gets a
ParticipantList for the given offering in a time
period . |
ParticipantList |
getParticipantsByTimePeriodForOfferingAndResource(Id offeringId,
Id resourceId,
Id timePeriodId)
Gets a
ParticipantList for the given offering and
resource in a time period . |
ParticipantList |
getParticipantsByTimePeriodForOfferingAndResourceOnDate(Id offeringId,
Id resourceId,
Id timePeriodId,
DateTime from,
DateTime to)
Gets a
ParticipantList for an offering and resource in
a time period and effective during the entire given date range
inclusive but not confined to the date range. |
ParticipantList |
getParticipantsByTimePeriodForOfferingOnDate(Id offeringId,
Id timePeriodId,
DateTime from,
DateTime to)
Gets a
ParticipantList for an offering in a time period
and effective during the entire given date range inclusive but not
confined to the date range. |
ParticipantList |
getParticipantsByTimePeriodForResource(Id resourceId,
Id timePeriodId)
Gets a
ParticipantList for the given resource in a time
period . |
ParticipantList |
getParticipantsByTimePeriodForResourceOnDate(Id resourceId,
Id timePeriodId,
DateTime from,
DateTime to)
Gets a
ParticipantList for a resource in a time period
and effective during the entire given date range inclusive but not
confined to the date range. |
ParticipantList |
getParticipantsForOffering(Id offeringId)
Gets a
ParticipantList for the given offering . |
ParticipantList |
getParticipantsForOfferingAndResource(Id offeringId,
Id resourceId)
Gets a
ParticipantList for the given offering and
resource . |
ParticipantList |
getParticipantsForOfferingAndResourceOnDate(Id offeringId,
Id resourceId,
DateTime from,
DateTime to)
Gets a
ParticipantList for an offering, resource, and
effective during the entire given date range inclusive but not
confined to the date range. |
ParticipantList |
getParticipantsForOfferingOnDate(Id offeringId,
DateTime from,
DateTime to)
Gets a
ParticipantList for an offering and effective
during the entire given date range inclusive but not confined to the
date range. |
ParticipantList |
getParticipantsForResource(Id resourceId)
Gets a
ParticipantList for the given resource. |
ParticipantList |
getParticipantsForResourceOnDate(Id resourceId,
DateTime from,
DateTime to)
Gets a
ParticipantList for a resource and effective
during the entire given date range inclusive but not confined to the
date range. |
ParticipantList |
getParticipantsOnDate(DateTime from,
DateTime to)
Gets a
ParticipantList effective during the entire
given date range inclusive but not confined to the date range. |
void |
useAnyEffectiveParticipantView()
All participants of any effective dates are returned by methods in
this session.
|
void |
useComparativeParticipantView()
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 |
useEffectiveParticipantView()
Only participants whose effective dates are current are returned by
methods in this session.
|
void |
useFederatedCatalogueView()
Federates the view for methods in this session.
|
void |
useIsolatedCatalogueView()
Isolates the view for methods in this session.
|
void |
usePlenaryParticipantView()
A complete view of the
Participant returns is desired. |
getAuthenticatedAgent, getAuthenticatedAgentId, getClockRate, getDate, getEffectiveAgent, getEffectiveAgentId, getFormatType, getLocale, isAuthenticated, startTransaction, supportsTransactions
close
Id getCatalogueId()
Catalogue
Id
associated with
this session. Catalogue Id
associated with this sessionmandatory
- This method must be implemented. Catalogue getCatalogue() throws OperationFailedException, PermissionDeniedException
Catalogue
associated with this session.OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. boolean canLookupParticipants()
PERMISSION_DENIED.
This is intended as a hint to an
application that may opt not to offer these operations. false
if catalogue reading methods are not
authorized, true
otherwisemandatory
- This method must be implemented. void useComparativeParticipantView()
mandatory
- This method is must be implemented. void usePlenaryParticipantView()
Participant
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 useFederatedCatalogueView()
mandatory
- This method is must be implemented. void useIsolatedCatalogueView()
mandatory
- This method is must be implemented. void useEffectiveParticipantView()
mandatory
- This method is must be implemented. void useAnyEffectiveParticipantView()
mandatory
- This method is must be implemented. Participant getParticipant(Id participantId) throws NotFoundException, OperationFailedException, PermissionDeniedException
Participant
specified by its Id.
In plenary mode, the exact Id
is found
or a NOT_FOUND
results. Otherwise, the returned
Participant
may have a different Id
than
requested, such as the case where a duplicate Id
was
assigned to a Participant
and retained for
compatibility.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.participantId
- the Id
of the Participant
to retrieve Participant
NotFoundException
- no Participant
found
with the given Id
NullArgumentException
- participantId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByIds(IdList participantIds) throws NotFoundException, OperationFailedException, PermissionDeniedException
ParticipantList
corresponding to the given
IdList.
In plenary mode, the returned list contains all of the
participants 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 participants may be omitted from the list and may present
the elements in any order including returning a unique set.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.participantIds
- the list of Ids
to retrieve Participant list
NotFoundException
- an Id was
not foundNullArgumentException
- participantIds
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByGenusType(Type participantGenusType) throws OperationFailedException, PermissionDeniedException
ParticipantList
corresponding to the given
participant genus Type
which does not include
participants of types derived from the specified Type.
In plenary mode, the returned list contains all known
participants or an error results. Otherwise, the returned list may
contain only those participants that are accessible through this
session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.participantGenusType
- a participant genus type Participant list
NullArgumentException
- participantGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByParentGenusType(Type participantGenusType) throws OperationFailedException, PermissionDeniedException
ParticipantList
corresponding to the given
participant genus Type
and include any additional
participants with genus types derived from the specified Type.
In plenary mode, the returned list contains all known
participants or an error results. Otherwise, the returned list may
contain only those participants that are accessible through this
session.
In active mode, participants are returned that are currently active.
In any status mode, active and inactive participants are returned.participantGenusType
- a participant genus type Participant list
NullArgumentException
- participantGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByRecordType(Type participantRecordType) throws OperationFailedException, PermissionDeniedException
ParticipantList
containing the given participant
record Type.
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.participantRecordType
- a participant record type ParticipantList
NullArgumentException
- participantRecordType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsOnDate(DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
effective during the entire
given date range inclusive but not confined to the date range.
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.from
- start of date rangeto
- end of date range ParticipantList
InvalidArgumentException
- from
is
greater than to
NullArgumentException
- from
or
to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByGenusTypeOnDate(Type participantGenusType, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
by 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 participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.participantGenusType
- a participant genus typefrom
- start of date rangeto
- end of date range ParticipantList
InvalidArgumentException
- from
is
greater than to
NullArgumentException
- participantGenusType,
from,
or to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsForOffering(Id offeringId) throws OperationFailedException, PermissionDeniedException
ParticipantList
for the given offering .
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
ParticipantList
NullArgumentException
- offeringId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByGenusTypeForOffering(Id offeringId, Type participantGenusType) throws OperationFailedException, PermissionDeniedException
ParticipantList
by genus type for the given
offering .
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
participantGenusType
- a participant genus type ParticipantList
NullArgumentException
- participantGenusType
or offeringId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsForOfferingOnDate(Id offeringId, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
for an offering 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 participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
from
- start of date rangeto
- end of date rangeInvalidArgumentException
- from
is
greater than to
NullArgumentException
- offeringId, from,
or to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByGenusTypeForOfferingOnDate(Id offeringId, Type participantGenusType, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
by genus type for an offering
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 participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
participantGenusType
- a participant genus typefrom
- start of date rangeto
- end of date rangeInvalidArgumentException
- from
is
greater than to
NullArgumentException
- offeringId,
participantGenusType, from,
or to
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByTimePeriodForOffering(Id offeringId, Id timePeriodId) throws OperationFailedException, PermissionDeniedException
ParticipantList
for the given offering in a time
period .
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
timePeriodId
- a time period Id
ParticipantList
NullArgumentException
- offeringId
or
timePeriodId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByTimePeriodAndGenusTypeForOffering(Id offeringId, Id timePeriodId, Type participantGenusType) throws OperationFailedException, PermissionDeniedException
ParticipantList
by genus type for the given
offering in a time period .
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
timePeriodId
- a time period Id
participantGenusType
- a participant genus type ParticipantList
NullArgumentException
- offeringId,
timePeriodId,
or participantGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByTimePeriodForOfferingOnDate(Id offeringId, Id timePeriodId, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
for an offering in a time period
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 participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
timePeriodId
- a time period Id
from
- start of date rangeto
- end of date rangeInvalidArgumentException
- from
is
greater than to
NullArgumentException
- offeringId,
timePeriodId, from,
or to
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByTimePeriodAndGenusTypeForOfferingOnDate(Id offeringId, Id timePeriodId, Type participantGenusType, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
by genus type for an offering in
a time period 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 participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
timePeriodId
- a time period Id
participantGenusType
- a participant genus typefrom
- start of date rangeto
- end of date rangeInvalidArgumentException
- from
is
greater than to
NullArgumentException
- offeringId,
timePeriodId, participantGenusType, from,
or to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsForResource(Id resourceId) throws OperationFailedException, PermissionDeniedException
ParticipantList
for the given resource.
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.resourceId
- a resource Id
ParticipantList
NullArgumentException
- resourceId
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByGenusTypeForResource(Id resourceId, Type participantGenusType) throws OperationFailedException, PermissionDeniedException
ParticipantList
by genus type for the given
resource.
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.resourceId
- a resource Id
participantGenusType
- a participant genus type ParticipantList
NullArgumentException
- resourceId
or
participantGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsForResourceOnDate(Id resourceId, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
for a 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 participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.resourceId
- a resource Id
from
- start of date rangeto
- end of date rangeInvalidArgumentException
- from
is
greater than to
NullArgumentException
- resourceId, from,
or to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByGenusTypeForResourceOnDate(Id resourceId, Type participantGenusType, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
by genus type for a 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 participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.resourceId
- a resource Id
participantGenusType
- a participant genus typefrom
- start of date rangeto
- end of date rangeInvalidArgumentException
- from
is
greater than to
NullArgumentException
- resourceId,
participantGenusType, from,
or to
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByTimePeriodForResource(Id resourceId, Id timePeriodId) throws OperationFailedException, PermissionDeniedException
ParticipantList
for the given resource in a time
period .
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.resourceId
- a resource Id
timePeriodId
- a time period Id
ParticipantList
NullArgumentException
- resourceId
or
timePeriodId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByTimePeriodAndGenusTypeForResource(Id resourceId, Id timePeriodId, Type participantGenusType) throws OperationFailedException, PermissionDeniedException
ParticipantList
by genus type for the given
resource in a time period .
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.resourceId
- a resource Id
timePeriodId
- a time period Id
participantGenusType
- a participant genus type ParticipantList
NullArgumentException
- resourceId,
timePeriodId,
or participantGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByTimePeriodForResourceOnDate(Id resourceId, Id timePeriodId, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
for a resource in a time period
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 participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.resourceId
- a resource Id
timePeriodId
- a time period Id
from
- start of date rangeto
- end of date rangeInvalidArgumentException
- from
is
greater than to
NullArgumentException
- resourceId,
timePeriodId, from,
or to
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByTimePeriodAndGenusTypeForResourceOnDate(Id resourceId, Id timePeriodId, Type participantGenusType, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
by genus type for a resource in
a time period 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 participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.resourceId
- a resource Id
timePeriodId
- a time period Id
participantGenusType
- a participant genus typefrom
- start of date rangeto
- end of date rangeInvalidArgumentException
- from
is
greater than to
NullArgumentException
- resourceId,
timePeriodId, participantGenusType, from,
or to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsForOfferingAndResource(Id offeringId, Id resourceId) throws OperationFailedException, PermissionDeniedException
ParticipantList
for the given offering and
resource .
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
resourceId
- a resource Id
ParticipantList
NullArgumentException
- offeringId
or
resourceId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByGenusTypeForOfferingAndResource(Id offeringId, Id resourceId, Type participantGenusType) throws OperationFailedException, PermissionDeniedException
ParticipantList
by genus type for the given
offering and resource .
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
resourceId
- a resource Id
participantGenusType
- a participant genus type ParticipantList
NullArgumentException
- offeringId, resourceId
or participantGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsForOfferingAndResourceOnDate(Id offeringId, Id resourceId, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
for an offering, 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 participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
resourceId
- a resource Id
from
- start of date rangeto
- end of date rangeInvalidArgumentException
- from
is
greater than to
NullArgumentException
- resourceId, from,
or to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByGenusTypeForOfferingAndResourceOnDate(Id offeringId, Id resourceId, Type participantGenusType, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
by genus type for an offering,
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 participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
resourceId
- a resource Id
participantGenusType
- a participant genus typefrom
- start of date rangeto
- end of date rangeInvalidArgumentException
- from
is
greater than to
NullArgumentException
- resourceId,
participantGenusType, from,
or to
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByTimePeriodForOfferingAndResource(Id offeringId, Id resourceId, Id timePeriodId) throws OperationFailedException, PermissionDeniedException
ParticipantList
for the given offering and
resource in a time period .
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
resourceId
- a resource Id
timePeriodId
- a time period Id
ParticipantList
NullArgumentException
- offeringId, resourceId,
or timePeriodId
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByTimePeriodAndGenusTypeForOfferingAndResource(Id offeringId, Id resourceId, Id timePeriodId, Type participantGenusType) throws OperationFailedException, PermissionDeniedException
ParticipantList
by genus type for the given
offering and resource in a time period .
In plenary mode, the returned list contains all known participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
resourceId
- a resource Id
timePeriodId
- a time period Id
participantGenusType
- a participant genus type ParticipantList
NullArgumentException
- offeringId, resourceId,
timePeriodId
or
participantGenusType
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByTimePeriodForOfferingAndResourceOnDate(Id offeringId, Id resourceId, Id timePeriodId, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
for an offering and resource in
a time period 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 participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
resourceId
- a resource Id
timePeriodId
- a time period Id
from
- start of date rangeto
- end of date rangeInvalidArgumentException
- from
is
greater than to
NullArgumentException
- offeringId, resourceId,
timePeriodId, from,
or to
is
null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipantsByTimePeriodAndGenusTypeForOfferingAndResourceOnDate(Id offeringId, Id resourceId, Id timePeriodId, Type participantGenusType, DateTime from, DateTime to) throws OperationFailedException, PermissionDeniedException
ParticipantList
by genus type for an offering
and resource in a time period 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 participants or
an error results. Otherwise, the returned list may contain only those
participants that are accessible through this session.
In effective mode, participants are returned that are currently
effective. In any effective mode, effective participants and those
currently expired are returned.offeringId
- an offering Id
resourceId
- a resource Id
timePeriodId
- a time period Id
participantGenusType
- a participant genus typefrom
- start of date rangeto
- end of date rangeInvalidArgumentException
- from
is
greater than to
NullArgumentException
- offeringId, resourceId,
timePeriodId,participantGenusType, from,
or to
is null
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented. ParticipantList getParticipants() throws OperationFailedException, PermissionDeniedException
OperationFailedException
- unable to complete requestPermissionDeniedException
- authorization failuremandatory
- This method must be implemented.