org.osid.course

Interface ActivityUnitForm

All Superinterfaces:

Extensible, Identifiable, OsidBrowsableForm, OsidExtensibleForm, OsidForm, OsidIdentifiableForm, OsidObjectForm, OsidOperableForm, OsidSubjugateableForm, Suppliable

All Known Subinterfaces:

ActivityUnitBatchForm

public interface ActivityUnitForm
extends OsidObjectForm, OsidOperableForm, OsidSubjugateableForm

This is the form for creating and updating ActivityUnits. Like all OsidForm objects, various data elements may be set here for use in the create and update methods in the ActivityUnitAdminSession. For each data element that may be set, metadata may be examined to provide display hints or data constraints.

Method Summary

Methods

Modifier and Type	Method and Description
void	clearContact() Removes the contact flag.
void	clearLearningObjectives() Removes the learning objectives.
void	clearRecurringWeekly() Removes the recurring weekly flag.
void	clearTotalTargetContactTime() Removes the total contact time.
void	clearTotalTargetEffort() Removes the total effort.
void	clearTotalTargetIndividualEffort() Removes the total individual effort.
void	clearWeeklyContactTime() Removes the weekly contact time.
void	clearWeeklyEffort() Removes the weekly effort.
void	clearWeeklyIndividualEffort() Removes the weekly individual effort.
ActivityUnitFormRecord	getActivityUnitFormRecord(Type activityUnitRecordType) Gets the ActivityUnitFormRecord corresponding to the given activity unit record Type.
Metadata	getContactMetadata() Gets the metadata for the contact flag.
Metadata	getLearningObjectiveMetadata() Gets the metadata for a set of learning objectives.
Metadata	getRecurringWeeklyMetadata() Gets the metadata for the recurring weekly flag.
Metadata	getTotalTargetContactTimeMetadata() Gets the metadata for the total contact time.
Metadata	getTotalTargetEffortMetadata() Gets the metadata for the total effort.
Metadata	getTotalTargetIndividualEffortMetadata() Gets the metadata for the total individual effort.
Metadata	getWeeklyContactTimeMetadata() Gets the metadata for the weekly contact time.
Metadata	getWeeklyEffortMetadata() Gets the metadata for the weekly effort.
Metadata	getWeeklyIndividualEffortMetadata() Gets the metadata for the weekly individual effort.
void	setContact(boolean contact) Sets the contact flag.
void	setLearningObjectives(Id[] objectiveIds) Sets the learning objectives.
void	setRecurringWeekly(boolean recurring) Sets the recurring weekly flag.
void	setTotalTargetContactTime(Duration time) Sets the total contact time.
void	setTotalTargetEffort(Duration time) Sets the total effort.
void	setTotalTargetIndividualEffort(Duration time) Sets the total individual effort.
void	setWeeklyContactTime(Duration time) Sets the weekly contact time.
void	setWeeklyEffort(Duration time) Sets the weekly effort.
void	setWeeklyIndividualEffort(Duration time) Sets the weekly individual effort.

Methods inherited from interface org.osid.OsidObjectForm

clearDescription, clearDisplayName, clearGenusType, getDescriptionMetadata, getDisplayNameMetadata, getGenusTypeMetadata, setDescription, setDisplayName, setGenusType

Methods inherited from interface org.osid.OsidExtensibleForm

getRequiredRecordTypes

Methods inherited from interface org.osid.Extensible

getRecordTypes, hasRecordType

Methods inherited from interface org.osid.OsidForm

getDefaultLocale, getInvalidMetadata, getJournalCommentMetadata, getLocales, getValidationMessages, isForUpdate, isValid, setJournalComment, setLocale

Methods inherited from interface org.osid.Identifiable

getId, isCurrent

Methods inherited from interface org.osid.OsidOperableForm

clearDisabled, clearEnabled, getDisabledMetadata, getEnabledMetadata, setDisabled, setEnabled

Method Detail

getTotalTargetEffortMetadata

Metadata getTotalTargetEffortMetadata()

Gets the metadata for the total effort. The amount may be calculated from the other data.

Returns:

metadata for the total effort

Compliance:

mandatory - This method must be implemented.

setTotalTargetEffort

void setTotalTargetEffort(Duration time)

Sets the total effort.

Parameters:

time - the new total effort

Throws:

InvalidArgumentException - time is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - time is null

Compliance:

mandatory - This method must be implemented.

clearTotalTargetEffort

void clearTotalTargetEffort()

Removes the total effort.

Throws:

NoAccessException - Metadata.isRequired() is true or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getContactMetadata

Metadata getContactMetadata()

Gets the metadata for the contact flag.

Returns:

metadata for the contact

Compliance:

mandatory - This method must be implemented.

setContact

void setContact(boolean contact)

Sets the contact flag.

Parameters:

contact - the new contact flag

Throws:

InvalidArgumentException - contact is invalid

NoAccessException - Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

clearContact

void clearContact()

Removes the contact flag.

Throws:

NoAccessException - Metadata.isRequired() is true or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getTotalTargetContactTimeMetadata

Metadata getTotalTargetContactTimeMetadata()

Gets the metadata for the total contact time.

Returns:

metadata for the total contact time

Compliance:

mandatory - This method must be implemented.

setTotalTargetContactTime

void setTotalTargetContactTime(Duration time)

Sets the total contact time.

Parameters:

time - the new total contact time

Throws:

InvalidArgumentException - time is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - time is null

Compliance:

mandatory - This method must be implemented.

clearTotalTargetContactTime

void clearTotalTargetContactTime()

Removes the total contact time.

Throws:

NoAccessException - Metadata.isRequired() is true or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getTotalTargetIndividualEffortMetadata

Metadata getTotalTargetIndividualEffortMetadata()

Gets the metadata for the total individual effort. The amount may be calculated from the other data.

Returns:

metadata for the total individual effort

Compliance:

mandatory - This method must be implemented.

setTotalTargetIndividualEffort

void setTotalTargetIndividualEffort(Duration time)

Sets the total individual effort.

Parameters:

time - the new total individual effort

Throws:

InvalidArgumentException - time is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - time is null

Compliance:

mandatory - This method must be implemented.

clearTotalTargetIndividualEffort

void clearTotalTargetIndividualEffort()

Removes the total individual effort.

Throws:

NoAccessException - Metadata.isRequired() is true or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getRecurringWeeklyMetadata

Metadata getRecurringWeeklyMetadata()

Gets the metadata for the recurring weekly flag.

Returns:

metadata for the contact

Compliance:

mandatory - This method must be implemented.

setRecurringWeekly

void setRecurringWeekly(boolean recurring)

Sets the recurring weekly flag.

Parameters:

recurring - the new recurring weekly flag

Throws:

InvalidArgumentException - recurring is invalid

NoAccessException - Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

clearRecurringWeekly

void clearRecurringWeekly()

Removes the recurring weekly flag.

Throws:

NoAccessException - Metadata.isRequired() is true or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getWeeklyEffortMetadata

Metadata getWeeklyEffortMetadata()

Gets the metadata for the weekly effort. The amount may be calculated from the other data.

Returns:

metadata for the weekly effort

Compliance:

mandatory - This method must be implemented.

setWeeklyEffort

void setWeeklyEffort(Duration time)

Sets the weekly effort.

Parameters:

time - the new weekly effort

Throws:

InvalidArgumentException - time is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - time is null

Compliance:

mandatory - This method must be implemented.

clearWeeklyEffort

void clearWeeklyEffort()

Removes the weekly effort.

Throws:

NoAccessException - Metadata.isRequired() is true or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getWeeklyContactTimeMetadata

Metadata getWeeklyContactTimeMetadata()

Gets the metadata for the weekly contact time.

Returns:

metadata for the weekly contact time

Compliance:

mandatory - This method must be implemented.

setWeeklyContactTime

void setWeeklyContactTime(Duration time)

Sets the weekly contact time.

Parameters:

time - the new weekly contact time

Throws:

InvalidArgumentException - time is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - time is null

Compliance:

mandatory - This method must be implemented.

clearWeeklyContactTime

void clearWeeklyContactTime()

Removes the weekly contact time.

Throws:

NoAccessException - Metadata.isRequired() is true or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getWeeklyIndividualEffortMetadata

Metadata getWeeklyIndividualEffortMetadata()

Gets the metadata for the weekly individual effort. The amount may be calculated from the other data.

Returns:

metadata for the weekly individual effort

Compliance:

mandatory - This method must be implemented.

setWeeklyIndividualEffort

void setWeeklyIndividualEffort(Duration time)

Sets the weekly individual effort.

Parameters:

time - the new weekly individual effort

Throws:

InvalidArgumentException - time is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - time is null

Compliance:

mandatory - This method must be implemented.

clearWeeklyIndividualEffort

void clearWeeklyIndividualEffort()

Removes the weekly individual effort.

Throws:

NoAccessException - Metadata.isRequired() is true or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getLearningObjectiveMetadata

Metadata getLearningObjectiveMetadata()

Gets the metadata for a set of learning objectives.

Returns:

metadata for the obecjtives

Compliance:

mandatory - This method must be implemented.

setLearningObjectives

void setLearningObjectives(Id[] objectiveIds)

Sets the learning objectives.

Parameters:

objectiveIds - the new obejctives

Throws:

InvalidArgumentException - objectiveIds is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - objectiveIds is null

Compliance:

mandatory - This method must be implemented.

clearLearningObjectives

void clearLearningObjectives()

Removes the learning objectives.

Throws:

NoAccessException - Metadata.isRequired() is true or Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

getActivityUnitFormRecord

ActivityUnitFormRecord getActivityUnitFormRecord(Type activityUnitRecordType)
                                                 throws OperationFailedException

Gets the ActivityUnitFormRecord corresponding to the given activity unit record Type.

Parameters:

activityUnitRecordType - an activity unit record type

Returns:

the activity unit form record

Throws:

NullArgumentException - activityUnitRecordType is null

OperationFailedException - unable to complete request

UnsupportedException - hasRecordType(activityUnitRecordType) is false

Compliance:

mandatory - This method must be implemented.