public interface ActivityQuery extends OsidRelationshipQuery, OsidSubjugateableQuery
This is the query for searching activities. Each method match specifies
an AND
term while multiple invocations of the same method
produce a nested OR.
Modifier and Type | Method and Description |
---|---|
void |
clearActivityUnitIdTerms()
Clears the activity unit
Id terms. |
void |
clearActivityUnitTerms()
Clears the activity unit terms.
|
void |
clearBlackoutInclusiveTerms()
Clears all blackout inclusive terms.
|
void |
clearBlackoutTerms()
Clears all blackout terms.
|
void |
clearContactTerms()
Clears the contact terms.
|
void |
clearCourseCatalogIdTerms()
Clears the course catalog
Id terms. |
void |
clearCourseCatalogTerms()
Clears the course catalog terms.
|
void |
clearCourseOfferingIdTerms()
Clears the course offering
Id terms. |
void |
clearCourseOfferingTerms()
Clears the course offering terms.
|
void |
clearImplicitTerms()
Clears the implcit terms.
|
void |
clearInstructorIdTerms()
Clears the instructor
Id terms. |
void |
clearInstructorTerms()
Clears the instructor terms.
|
void |
clearMaximumSeatsTerms()
Clears the maximum seating terms.
|
void |
clearMeetingLocationIdTerms()
Clears the location
Id terms. |
void |
clearMeetingLocationTerms()
Clears the location
Id terms. |
void |
clearMeetingTimeInclusiveTerms()
Clears the meeting time inclusive terms.
|
void |
clearMeetingTimeTerms()
Clears the meeting time terms.
|
void |
clearMinimumSeatsTerms()
Clears the minimum seating terms.
|
void |
clearRecurringWeeklyTerms()
Clears the recurring weekly terms.
|
void |
clearScheduleIdTerms()
Clears the schedule
Id terms. |
void |
clearScheduleTerms()
Clears the schedule terms.
|
void |
clearSpecificMeetingTimeTerms()
Clears the specific date terms.
|
void |
clearSupersedingActivityIdTerms()
Clears the superseding activity
Id terms. |
void |
clearSupersedingActivityTerms()
Clears the superseding activity terms.
|
void |
clearTermIdTerms()
Clears the term
Id terms. |
void |
clearTermTerms()
Clears the term terms.
|
void |
clearTotalTargetContactTimeTerms()
Clears the total contact terms.
|
void |
clearTotalTargetEffortTerms()
Clears the total effort terms.
|
void |
clearTotalTargetIndividualEffortTerms()
Clears the individual effort terms.
|
void |
clearWeeklyContactTimeTerms()
Clears the weekly contact time terms.
|
void |
clearWeeklyEffortTerms()
Clears the weekly effort terms.
|
void |
clearWeeklyIndividualEffortTerms()
Clears the weekly individual effort terms.
|
ActivityQueryRecord |
getActivityQueryRecord(Type activityRecordType)
Gets the activity query record corresponding to the given
Activity record Type. |
ActivityUnitQuery |
getActivityUnitQuery()
Gets the query for an activity unit.
|
CourseCatalogQuery |
getCourseCatalogQuery()
Gets the query for a course catalog.
|
CourseOfferingQuery |
getCourseOfferingQuery()
Gets the query for a coure offering.
|
ResourceQuery |
getInstructorQuery()
Gets the query for an instructor.
|
LocationQuery |
getMeetingLocationQuery()
Gets the query for a location.
|
ScheduleQuery |
getScheduleQuery()
Gets the query for a schedule.
|
ActivityQuery |
getSupersedingActivityQuery()
Gets the query for a superseding activity.
|
TermQuery |
getTermQuery()
Gets the query for a reporting term.
|
void |
matchActivityUnitId(Id activityUnitId,
boolean match)
Sets the activity unit
Id for this query. |
void |
matchAnyBlackout(boolean match)
Matches an activity that has any blackout.
|
void |
matchAnyInstructor(boolean match)
Matches course offerings that have any instructor.
|
void |
matchAnyMaximumSeats(boolean match)
Matches activities with any maximum seating assigned.
|
void |
matchAnyMinimumSeats(boolean match)
Matches activities with any minimum seating assigned.
|
void |
matchAnySchedule(boolean match)
Matches an activity that has any schedule.
|
void |
matchAnySpecificMeetingTime(boolean match)
Matches an activity that has any specific date.
|
void |
matchAnySupersedingActivity(boolean match)
Matches an activity that has any superseding activity.
|
void |
matchAnyTotalTargetContactTime(boolean match)
Matches an activity that has any total contact assigned.
|
void |
matchAnyTotalTargetEffort(boolean match)
Matches an activity that has any total effort assigned.
|
void |
matchAnyTotalTargetIndividualEffort(boolean match)
Matches an activity that has any individual effort assigned.
|
void |
matchAnyWeeklyContactTime(boolean match)
Matches an activity that has any weekly contact time assigned.
|
void |
matchAnyWeeklyEffort(boolean match)
Matches an activity that has any weekly effort assigned.
|
void |
matchAnyWeeklyIndividualEffort(boolean match)
Matches an activity that has any weekly individual effort assigned.
|
void |
matchBlackout(DateTime date,
boolean match)
Matches activities containing the given blackout date.
|
void |
matchBlackoutInclusive(DateTime start,
DateTime end,
boolean match)
Matches activities with blackouts within the given date range
inclousive.
|
void |
matchContact(boolean match)
Matches activities that are contact activities.
|
void |
matchCourseCatalogId(Id courseCatalogId,
boolean match)
Sets the course catalog
Id for this query to match
activities assigned to course catalogs. |
void |
matchCourseOfferingId(Id courseOfferingId,
boolean match)
Sets the course offering
Id for this query. |
void |
matchImplicit(boolean match)
Matches an activity that is implicitly generated.
|
void |
matchInstructorId(Id resourceId,
boolean match)
Sets the resource
Id for this query to match course
offerings that have an instructor. |
void |
matchMaximumSeats(long min,
long max,
boolean match)
Matches activities with a maximum seating between the given numbers
inclusive.
|
void |
matchMeetingLocationId(Id locationId,
boolean match)
Matches activities with any meeting location.
|
void |
matchMeetingTime(DateTime date,
boolean match)
Matches activities where the given time falls within a denormalized
meeting time inclusive.
|
void |
matchMeetingTimeInclusive(DateTime start,
DateTime end,
boolean match)
Matches activities with any denormalized meeting time within the given
date range inclusive.
|
void |
matchMinimumSeats(long min,
long max,
boolean match)
Matches activities with a minimum seating between the given numbers
inclusive.
|
void |
matchRecurringWeekly(boolean match)
Matches activities that recur weekly.
|
void |
matchScheduleId(Id scheduleId,
boolean match)
Sets the schedule
Id for this query. |
void |
matchSpecificMeetingTime(DateTime start,
DateTime end,
boolean match)
Matches activities with specific dates between the given range
inclusive.
|
void |
matchSupersedingActivityId(Id activityId,
boolean match)
Sets the superseding activity
Id for this query. |
void |
matchTermId(Id termId,
boolean match)
Sets the term
Id for this query to match course
offerings that have a related term. |
void |
matchTotalTargetContactTime(Duration min,
Duration max,
boolean match)
Matches activities with a total contact time between the given
durations inclusive.
|
void |
matchTotalTargetEffort(Duration min,
Duration max,
boolean match)
Matches activities with a total effort between the given durations
inclusive.
|
void |
matchTotalTargetIndividualEffort(Duration min,
Duration max,
boolean match)
Matches activities with a individual effort between the given
durations inclusive.
|
void |
matchWeeklyContactTime(Duration min,
Duration max,
boolean match)
Matches activities with a weekly contact time between the given
durations inclusive.
|
void |
matchWeeklyEffort(Duration min,
Duration max,
boolean match)
Matches activities with a weekly effort between the given durations
inclusive.
|
void |
matchWeeklyIndividualEffort(Duration min,
Duration max,
boolean match)
Matches activities with a weekly individual effort between the given
durations inclusive.
|
boolean |
supportsActivityUnitQuery()
Tests if an
ActivityUnitQuery is available. |
boolean |
supportsCourseCatalogQuery()
Tests if a
CourseCatalogQuery is available. |
boolean |
supportsCourseOfferingQuery()
Tests if a
CourseOfferingQuery is available. |
boolean |
supportsInstructorQuery()
Tests if a
ResourceQuery is available. |
boolean |
supportsMeetingLocationQuery()
Tests if a
LocationQuery is available. |
boolean |
supportsScheduleQuery()
Tests if a
ScheduleQuery is available. |
boolean |
supportsSupersedingActivityQuery()
Tests if an
ActivityQuery is available. |
boolean |
supportsTermQuery()
Tests if a
TermQuery is available. |
clearEndReasonIdTerms, clearEndReasonTerms, getEndReasonQuery, matchAnyEndReason, matchEndReasonId, supportsEndReasonQuery
clearCommentIdTerms, clearCommentTerms, clearCreditIdTerms, clearCreditTerms, clearDescriptionTerms, clearDisplayNameTerms, clearGenusTypeTerms, clearJournalEntryIdTerms, clearJournalEntryTerms, clearParentGenusTypeTerms, clearRelationshipIdTerms, clearRelationshipPeerIdTerms, clearRelationshipTerms, clearStateIdTerms, clearStateTerms, clearStatisticTerms, clearSubjectIdTerms, clearSubjectRelevancyTerms, clearSubjectTerms, getCommentQuery, getCreditQuery, getJournalEntryQuery, getRelationshipQuery, getStateQuery, getStatisticQuery, getSubjectQuery, getSubjectRelevancyQuery, matchAnyComment, matchAnyCredit, matchAnyDescription, matchAnyDisplayName, matchAnyGenusType, matchAnyJournalEntry, matchAnyRelationship, matchAnyState, matchAnyStatistic, matchAnySubject, matchCommentId, matchCreditId, matchDescription, matchDisplayName, matchGenusType, matchJournalEntryId, matchParentGenusType, matchRelationshipId, matchRelationshipPeerId, matchStateId, matchSubjectId, supportsCommentQuery, supportsCreditQuery, supportsJournalEntryQuery, supportsRelationshipQuery, supportsStateQuery, supportsStatisticQuery, supportsSubjectQuery, supportsSubjectRelevancyQuery
clearIdTerms, matchId
clearRecordTerms, matchAnyRecord, matchRecordType
getRecordTypes, hasRecordType
clearAnyTerms, clearKeywordTerms, getStringMatchTypes, matchAny, matchKeyword, supportsStringMatchType
clearDateTerms, clearEffectiveTerms, clearEndDateTerms, clearStartDateTerms, matchAnyEndDate, matchAnyStartDate, matchDate, matchEffective, matchEndDate, matchStartDate
void matchImplicit(boolean match)
match
- true
to match activities implicitly
generated, false
to match activities explicitly
definedmandatory
- This method must be implemented. void clearImplicitTerms()
mandatory
- This method must be implemented. void matchActivityUnitId(Id activityUnitId, boolean match)
Id
for this query.activityUnitId
- an activity unit Id
match
- true
if a positive match, false
for a negative matchNullArgumentException
- activityUnitId
is null
mandatory
- This method must be implemented. void clearActivityUnitIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsActivityUnitQuery()
ActivityUnitQuery
is available. true
if an activity unit query is available,
false
otherwisemandatory
- This method must be implemented. ActivityUnitQuery getActivityUnitQuery()
OR
term.UnimplementedException
-
supportsActivityUnitQuery()
is false
optional
- This method must be implemented if
supportsActivityUnitQuery()
is true.
void clearActivityUnitTerms()
mandatory
- This method must be implemented. void matchCourseOfferingId(Id courseOfferingId, boolean match)
Id
for this query.courseOfferingId
- a course offering Id
match
- true
if a positive match, false
for a negative matchNullArgumentException
- courseOfferingId
is null
mandatory
- This method must be implemented. void clearCourseOfferingIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsCourseOfferingQuery()
CourseOfferingQuery
is available. true
if a course offering query is available,
false
otherwisemandatory
- This method must be implemented. CourseOfferingQuery getCourseOfferingQuery()
OR
term.UnimplementedException
-
supportsCourseOfferingQuery()
is false
optional
- This method must be implemented if
supportsCourseOfferingQuery()
is true.
void clearCourseOfferingTerms()
mandatory
- This method must be implemented. void matchTermId(Id termId, boolean match)
Id
for this query to match course
offerings that have a related term.termId
- a term Id
match
- true
if a positive match, false
for a negative matchNullArgumentException
- termId
is
null
mandatory
- This method must be implemented. void clearTermIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsTermQuery()
TermQuery
is available. true
if a term query is available, false
otherwisemandatory
- This method must be implemented. TermQuery getTermQuery()
OR
term.UnimplementedException
- supportsTermQuery()
is false
optional
- This method must be implemented if
supportsTermQuery()
is true.
void clearTermTerms()
mandatory
- This method must be implemented. void matchMeetingTime(DateTime date, boolean match)
date
- a datematch
- true
if a positive match, false
for a negative matchNullArgumentException
- date
is
null
mandatory
- This method must be implemented. void clearMeetingTimeTerms()
mandatory
- This method must be implemented. void matchMeetingTimeInclusive(DateTime start, DateTime end, boolean match)
start
- a start dateend
- an end datematch
- true
if a positive match, false
for a negative matchInvalidArgumentException
- start
is
greater than end
NullArgumentException
- start
or
end
is null
mandatory
- This method must be implemented. void clearMeetingTimeInclusiveTerms()
mandatory
- This method must be implemented. void matchMeetingLocationId(Id locationId, boolean match)
locationId
- a location Id
match
- true
if a positive match, false
for a negative matchNullArgumentException
- locationId
is
null
mandatory
- This method must be implemented. void clearMeetingLocationIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsMeetingLocationQuery()
LocationQuery
is available. true
if a location query is available,
false
otherwisemandatory
- This method must be implemented. LocationQuery getMeetingLocationQuery()
OR
term.UnimplementedException
-
supportsMeetingLocationQuery()
is false
optional
- This method must be implemented if
supportsMeetingLocationQuery()
is true.
void clearMeetingLocationTerms()
Id
terms.mandatory
- This method must be implemented. void matchScheduleId(Id scheduleId, boolean match)
Id
for this query.scheduleId
- a schedule Id
match
- true
if a positive match, false
for a negative matchNullArgumentException
- scheduleId
is
null
mandatory
- This method must be implemented. void clearScheduleIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsScheduleQuery()
ScheduleQuery
is available. true
if a schedule query is available,
false
otherwisemandatory
- This method must be implemented. ScheduleQuery getScheduleQuery()
OR
term.UnimplementedException
- supportsScheduleQuery()
is false
optional
- This method must be implemented if
supportsScheduleQuery()
is true.
void matchAnySchedule(boolean match)
match
- true
to match activitiies with any
schedule, false
to match activitiies with no
schedulemandatory
- This method must be implemented. void clearScheduleTerms()
mandatory
- This method must be implemented. void matchSupersedingActivityId(Id activityId, boolean match)
Id
for this query.activityId
- a superseding activity Id
match
- true
if a positive match, false
for a negative matchNullArgumentException
- activityId
is
null
mandatory
- This method must be implemented. void clearSupersedingActivityIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsSupersedingActivityQuery()
ActivityQuery
is available. true
if a superseding activity query is
available, false
otherwisemandatory
- This method must be implemented. ActivityQuery getSupersedingActivityQuery()
OR
term.UnimplementedException
-
supportsSupersedingActivityQuery()
is false
optional
- This method must be implemented if
supportsSupersedingActivityQuery()
is true.
void matchAnySupersedingActivity(boolean match)
match
- true
to match activitiies with any
superseding activity, false
to match
activitiies with no superseding activitiesmandatory
- This method must be implemented. void clearSupersedingActivityTerms()
mandatory
- This method must be implemented. void matchSpecificMeetingTime(DateTime start, DateTime end, boolean match)
start
- start dateend
- end datematch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- end
is less
than start
NullArgumentException
- start
or
end
is zero
mandatory
- This method must be implemented. void matchAnySpecificMeetingTime(boolean match)
match
- true
to match activitiies with any
specific date, false
to match activitiies with
no specific datesmandatory
- This method must be implemented. void clearSpecificMeetingTimeTerms()
mandatory
- This method must be implemented. void matchBlackout(DateTime date, boolean match)
date
- a datematch
- true
if a positive match, false
for a negative matchNullArgumentException
- date
is
null
mandatory
- This method must be implemented. void matchAnyBlackout(boolean match)
match
- true
to match activitiies with any
blackout, false
to match activitiies with no
blackoutsmandatory
- This method must be implemented. void clearBlackoutTerms()
mandatory
- This method must be implemented. void matchBlackoutInclusive(DateTime start, DateTime end, boolean match)
start
- a start dateend
- an end datematch
- true
if a positive match, false
for a negative matchInvalidArgumentException
- start
is
greater than end
NullArgumentException
- star
t or
end
is null
mandatory
- This method must be implemented. void clearBlackoutInclusiveTerms()
mandatory
- This method must be implemented. void matchInstructorId(Id resourceId, boolean match)
Id
for this query to match course
offerings that have an instructor.resourceId
- a resource Id
match
- true
if a positive match, false
for a negative matchNullArgumentException
- resourceId
is
null
mandatory
- This method must be implemented. void clearInstructorIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsInstructorQuery()
ResourceQuery
is available. true
if a resource query is available,
false
otherwisemandatory
- This method must be implemented. ResourceQuery getInstructorQuery()
OR
term.UnimplementedException
-
supportsInstructorQuery()
is false
optional
- This method must be implemented if
supportsInstructorQuery()
is true.
void matchAnyInstructor(boolean match)
match
- true
to match course offerings with any
instructor, false
to match course offerings
with no instructorsmandatory
- This method must be implemented. void clearInstructorTerms()
mandatory
- This method must be implemented. void matchMinimumSeats(long min, long max, boolean match)
min
- low numbermax
- high numbermatch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- max
is less
than min
mandatory
- This method must be implemented. void matchAnyMinimumSeats(boolean match)
match
- true
to match activities with any minimum
seating, false
to match activities with no
minimum seatingmandatory
- This method must be implemented. void clearMinimumSeatsTerms()
mandatory
- This method must be implemented. void matchMaximumSeats(long min, long max, boolean match)
min
- low numbermax
- high numbermatch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- max
is less
than min
mandatory
- This method must be implemented. void matchAnyMaximumSeats(boolean match)
match
- true
to match activities with any maximum
seating, false
to match activities with no
maximum seatingmandatory
- This method must be implemented. void clearMaximumSeatsTerms()
mandatory
- This method must be implemented. void matchTotalTargetEffort(Duration min, Duration max, boolean match)
min
- low rangemax
- high rangematch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- max
is less
than min
NullArgumentException
- min
or
max
is null
mandatory
- This method must be implemented. void matchAnyTotalTargetEffort(boolean match)
match
- true
to match activities with any total
effort, false
to match activities with no total
effortmandatory
- This method must be implemented. void clearTotalTargetEffortTerms()
mandatory
- This method must be implemented. void matchContact(boolean match)
match
- true
to match activities that have
contact, false
to match activities with no
contactmandatory
- This method must be implemented. void clearContactTerms()
mandatory
- This method must be implemented. void matchTotalTargetContactTime(Duration min, Duration max, boolean match)
min
- low rangemax
- high rangematch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- max
is less
than min
NullArgumentException
- min
or
max
is null
mandatory
- This method must be implemented. void matchAnyTotalTargetContactTime(boolean match)
match
- true
to match activities with any total
contatc, false
to match activities with no
total contactmandatory
- This method must be implemented. void clearTotalTargetContactTimeTerms()
mandatory
- This method must be implemented. void matchTotalTargetIndividualEffort(Duration min, Duration max, boolean match)
min
- low rangemax
- high rangematch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- max
is less
than min
NullArgumentException
- min
or
max
is null
mandatory
- This method must be implemented. void matchAnyTotalTargetIndividualEffort(boolean match)
match
- true
to match activities with any
individual effort, false
to match activities
with no individual effortmandatory
- This method must be implemented. void clearTotalTargetIndividualEffortTerms()
mandatory
- This method must be implemented. void matchRecurringWeekly(boolean match)
match
- true
to match activities that recur
weekly, false
to match activities with no
weekly recurrancemandatory
- This method must be implemented. void clearRecurringWeeklyTerms()
mandatory
- This method must be implemented. void matchWeeklyEffort(Duration min, Duration max, boolean match)
min
- low rangemax
- high rangematch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- max
is less
than min
NullArgumentException
- min
or
max
is null
mandatory
- This method must be implemented. void matchAnyWeeklyEffort(boolean match)
match
- true
to match activities with any weekly
effort, false
to match activities with no
weekly effortmandatory
- This method must be implemented. void clearWeeklyEffortTerms()
mandatory
- This method must be implemented. void matchWeeklyContactTime(Duration min, Duration max, boolean match)
min
- low rangemax
- high rangematch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- max
is less
than min
NullArgumentException
- min
or
max
is null
mandatory
- This method must be implemented. void matchAnyWeeklyContactTime(boolean match)
match
- true
to match activities with any weekly
contact time, false
to match activities with no
weekly contact timemandatory
- This method must be implemented. void clearWeeklyContactTimeTerms()
mandatory
- This method must be implemented. void matchWeeklyIndividualEffort(Duration min, Duration max, boolean match)
min
- low rangemax
- high rangematch
- true
for a positive match, false
for a negative matchInvalidArgumentException
- max
is less
than min
NullArgumentException
- min
or
max
is null
mandatory
- This method must be implemented. void matchAnyWeeklyIndividualEffort(boolean match)
match
- true
to match activities with any weekly
individual effort, false
to match activities
with no weekly individual effortmandatory
- This method must be implemented. void clearWeeklyIndividualEffortTerms()
mandatory
- This method must be implemented. void matchCourseCatalogId(Id courseCatalogId, boolean match)
Id
for this query to match
activities assigned to course catalogs.courseCatalogId
- the course catalog Id
match
- true
for a positive match, false
for a negative matchNullArgumentException
- courseCatalogId
is null
mandatory
- This method must be implemented. void clearCourseCatalogIdTerms()
Id
terms.mandatory
- This method must be implemented. boolean supportsCourseCatalogQuery()
CourseCatalogQuery
is available. true
if a course catalog query is available,
false
otherwisemandatory
- This method must be implemented. CourseCatalogQuery getCourseCatalogQuery()
OR
term.UnimplementedException
-
supportsCourseCatalogQuery()
is false
optional
- This method must be implemented if
supportsCourseCatalogQuery()
is true.
void clearCourseCatalogTerms()
mandatory
- This method must be implemented. ActivityQueryRecord getActivityQueryRecord(Type activityRecordType) throws OperationFailedException
Activity
record Type.
Multiple record
retrievals produce a nested OR
term.activityRecordType
- an activity record typeNullArgumentException
- activityRecordType
is null
OperationFailedException
- unable to complete requestUnsupportedException
-
hasRecordType(activityRecordType)
is false
mandatory
- This method must be implemented.