Interface | osid.calendaring.CommitmentLookupSession | ||
---|---|---|---|
Implements | osid.OsidSession | ||
Description |
This session provides methods for examining event commitments. This session defines views that offer differing behaviors when retrieving multiple objects.
| ||
Method | getCalendarId | ||
Description |
Gets the | ||
Return | osid.id.Id | the Calendar Id associated with this session | |
Compliance | mandatory | This method must be implemented. | |
Method | getCalendar | ||
Description |
Gets the | ||
Return | osid.calendaring.Calendar | the Calendar associated with this session | |
Errors | OPERATION_FAILED | unable to complete request | |
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | canLookupCommitments | ||
Description |
Tests if this user can lookup event commitments. A
return of true does not guarantee successful
authorization. A return of false indicates that it is
known all methods in this session will result in a | ||
Return | boolean | false if lookup methods are not authorized, true
otherwise | |
Compliance | mandatory | This method must be implemented. | |
Method | useComparativeCommitmentView | ||
Description |
The returns from the lookup methods may omit or translate elements based on this session, such as authorization, and not result in an error. This view is used when greater interoperability is desired at the expense of precision. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | usePlenaryCommitmentView | ||
Description |
A complete view of the | ||
Compliance | mandatory | This method is must be implemented. | |
Method | useFederatedCalendarView | ||
Description |
Federates the view for methods in this session. A federated view will include commitments in calendars which are children of this calendar in the calendar hierarchy. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | useIsolatedCalendarView | ||
Description |
Isolates the view for methods in this session. An isolated view restricts lookups to this calendar only. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | useEffectiveCommitmentView | ||
Description |
The commitments in this lookup session return only commitments currently in effect. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | useAnyEffectiveCommitmentView | ||
Description |
The commitments in this lookup session return both effective and ineffective commitments. | ||
Compliance | mandatory | This method is must be implemented. | |
Method | getCommitment | ||
Description |
Gets the In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.Id | commitmentId | Id of the Commitment |
Return | osid.calendaring.Commitment | the commitment | |
Errors | NOT_FOUND | commitmentId not found | |
NULL_ARGUMENT | commitmentId is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method is must be implemented. | |
Method | getCommitmentsByIds | ||
Description |
Gets a In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.IdList | commitmentIds | the list of Ids to retrieve |
Return | osid.calendaring.CommitmentList | the returned Commitment list | |
Errors | NOT_FOUND | an Id was not found | |
NULL_ARGUMENT | commitmentIds is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCommitmentsByGenusType | ||
Description |
Gets the commitments for the given event genus 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. | ||
Parameters | osid.type.Type | commitmentGenusType | commitment genus type |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | NULL_ARGUMENT | commitmentGenusType is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method is must be implemented. | |
Method | getCommitmentsByParentGenusType | ||
Description |
Gets the commitments for the given event genus type and include any commitments with a genus type derived from the specified genus 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. | ||
Parameters | osid.type.Type | commitmentGenusType | commitment genus type |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | NULL_ARGUMENT | commitmentGenusType is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method is must be implemented. | |
Method | getCommitmentsByRecordType | ||
Description |
Gets a In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.type.Type | commitmentRecordType | a commitment record type |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | NULL_ARGUMENT | eventRecordType is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCommitmentsOnDate | ||
Description |
Gets a In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.calendaring.DateTime | from | starting date |
osid.calendaring.DateTime | to | ending date | |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | from or to is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCommitmentsByGenusTypeOnDate | ||
Description |
Gets a In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.type.Type | commitmentGenusType | a commitment genus type |
osid.calendaring.DateTime | from | starting date | |
osid.calendaring.DateTime | to | ending date | |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | commitmentGenusType, from, or to is
null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCommitmentsForEvent | ||
Description |
Gets the commitments for the given event. If the event is a recurring event, the commitments are returned for the recurring event only. In plenary mode, the returned list contains all of the
commitments mapped to the event In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.Id | eventId | Id of the Event |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | NULL_ARGUMENT | eventId is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method is must be implemented. | |
Method | getCommitmentsForEventOnDate | ||
Description |
Gets a In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.Id | eventId | Id of the Event |
osid.calendaring.DateTime | from | starting date | |
osid.calendaring.DateTime | to | ending date | |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | eventId, from or to is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCommitmentsByGenusTypeForEvent | ||
Description |
Gets the commitments for the given event and commitment genus type including any genus types derived from the given genus type. If the event is a recurring event, the commitments are
returned for the recurring event only. In plenary mode,
the returned list contains all of the commitments mapped
to the event In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.Id | eventId | Id of the Event |
osid.type.Type | commitmentGenusType | commitment genus type | |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | NULL_ARGUMENT | eventId or commitmentGenusType is null
| |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method is must be implemented. | |
Method | getCommitmentsByGenusTypeForEventOnDate | ||
Description |
Gets a In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.Id | eventId | Id of the Event |
osid.type.Type | commitmentGenusType | commitment genus type | |
osid.calendaring.DateTime | from | starting date | |
osid.calendaring.DateTime | to | ending date | |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | eventId, commitmentGenusType, from or to is
null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCommitmentsForResource | ||
Description |
Gets the commitments for the given resource. In plenary mode, the returned list contains all of the
commitments mapped to the resource In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.Id | resourceId | Id of a Resource |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | NULL_ARGUMENT | resourceId is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method is must be implemented. | |
Method | getCommitmentsForResourceOnDate | ||
Description |
Gets a In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.Id | resourceId | Id of the Event |
osid.calendaring.DateTime | from | starting date | |
osid.calendaring.DateTime | to | ending date | |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | resourceId, from or to is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCommitmentsByGenusTypeForResource | ||
Description |
Gets the commitments for the given resource and commitment genus type including any genus types derived from the given genus type. In plenary mode, the returned list contains all of the
commitments mapped to the resource In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.Id | resourceId | Id of a Resource |
osid.type.Type | commitmentGenusType | commitment genus type | |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | NULL_ARGUMENT | resourceId or commitmentGenusType is
null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method is must be implemented. | |
Method | getCommitmentsByGenusTypeForResourceOnDate | ||
Description |
Gets a In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.Id | resourceId | Id of the Event |
osid.type.Type | commitmentGenusType | commitment genus type | |
osid.calendaring.DateTime | from | starting date | |
osid.calendaring.DateTime | to | ending date | |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | resourceId, commitmentGenusType, from or to
is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCommitmentsForEventAndResource | ||
Description |
Gets the commitments for the given event and resource. If the event is a recurring event, the commitments are returned for the recurring event only. In plenary mode, the returned list contains all of the
commitments mapped to the event In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.Id | eventId | Id of the Event |
osid.id.Id | resourceId | Id of a Resource | |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | NULL_ARGUMENT | eventId or resourceId is null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method is must be implemented. | |
Method | getCommitmentsForEventAndResourceOnDate | ||
Description |
Gets a In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.Id | eventId | Id of the Event |
osid.id.Id | resourceId | Id of a Resource | |
osid.calendaring.DateTime | from | starting date | |
osid.calendaring.DateTime | to | ending date | |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | eventId, resourceId, from or to is
null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCommitmentsByGenusTypeForEventAndResource | ||
Description |
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. If the event is a recurring event, the commitments are returned for the recurring event only. In plenary mode, the returned list contains all of the
commitments mapped to the event In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.Id | eventId | Id of the Event |
osid.id.Id | resourceId | Id of a Resource | |
osid.type.Type | commitmentGenusType | commitment genus type | |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | NULL_ARGUMENT | eventId, resourceId or commitmentGenusType is
null | |
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method is must be implemented. | |
Method | getCommitmentsByGenusTypeForEventAndResourceOnDate | ||
Description |
Gets a In effective mode, commitments are returned that are currently effective. In any effective mode, effective commitments and those currently expired are returned. | ||
Parameters | osid.id.Id | eventId | Id of the Event |
osid.id.Id | resourceId | Id of a Resource | |
osid.type.Type | commitmentGenusType | commitment genus type | |
osid.calendaring.DateTime | from | starting date | |
osid.calendaring.DateTime | to | ending date | |
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | INVALID_ARGUMENT | from is greater than to | |
NULL_ARGUMENT | eventId, resourceId, commitmentGenusType, from or to
is null | ||
OPERATION_FAILED | unable to complete request | ||
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method must be implemented. | |
Method | getCommitments | ||
Description |
Gets all commitments. 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. | ||
Return | osid.calendaring.CommitmentList | list of commitments | |
Errors | OPERATION_FAILED | unable to complete request | |
PERMISSION_DENIED | authorization failure | ||
Compliance | mandatory | This method is must be implemented. |