org.osid.rules.check

Interface CheckForm

All Superinterfaces:

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

public interface CheckForm
extends OsidRuleForm

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

Checks come in a variety of flavors. Each type of Check

• Fail Check
• Time Check By Date
• Time Check by Event
• Time Check By Cyclic Event
• Hold Check

is determined based on what data is set. If multiple fields are set, the provider will pick one at random.

Method Summary

Methods

Modifier and Type	Method and Description
void	clearFailCheck() Removes the fail check setting.
void	clearHoldCheckBlock() Removes the block.
void	clearInquiryCheckAudit() Removes the audit.
void	clearProcessCheckAgenda() Removes the agenda.
void	clearTimeCheckCyclicEvent() Removes the cyclic event.
void	clearTimeCheckEndDate() Removes the end date.
void	clearTimeCheckEvent() Removes the event.
void	clearTimeCheckStartDate() Removes the start date.
CheckFormRecord	getCheckFormRecord(Type checkRecordType) Gets the CheckFormRecord corresponding to the given check record Type.
Metadata	getFailCheckMetadata() Gets the metadata for making this a fail check.
Metadata	getHoldCheckBlockMetadata() Gets the metadata for making this a hold check and for the block.
Metadata	getInquiryCheckAuditMetadata() Gets the metadata for making this an inquiry check and for the audit.
Metadata	getProcessCheckAgendaMetadata() Gets the metadata for making this a process check and for the agenda.
Metadata	getTimeCheckCyclicEventMetadata() Gets the metadata for making this a time check and for the cyclic event.
Metadata	getTimeCheckEndDateMetadata() Gets the metadata for making this a time check and for the end date.
Metadata	getTimeCheckEventMetadata() Gets the metadata for making this a time check and for the event.
Metadata	getTimeCheckStartDateMetadata() Gets the metadata for making this a time check and for the start date.
void	setFailCheck() Makes this check a fail check.
void	setHoldCheckBlock(Id blockId) Sets the block and make this a hold check,.
void	setInqiiryCheckAudit(Id auditId) Sets the audit and make this an inquiry check,.
void	setProcessCheckAgenda(Id agendaId) Sets the agenda and make this a process check,.
void	setTimeCheckCyclicEvent(Id cyclicEventId) Sets the cyclic event and make this a time check,.
void	setTimeCheckEndDate(DateTime date) Sets the end date and make this a time check,.
void	setTimeCheckEvent(Id eventId) Sets the event and make this a time check,.
void	setTimeCheckStartDate(DateTime date) Sets the start date and make this a time check,.

Methods inherited from interface org.osid.OsidRuleForm

clearRule, getRuleMetadata, setRule

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

getFailCheckMetadata

Metadata getFailCheckMetadata()

Gets the metadata for making this a fail check.

Returns:

metadata for the competency

Compliance:

mandatory - This method must be implemented.

setFailCheck

void setFailCheck()

Makes this check a fail check.

Throws:

NoAccessException - Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

clearFailCheck

void clearFailCheck()

Removes the fail check setting.

Throws:

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

Compliance:

mandatory - This method must be implemented.

getTimeCheckStartDateMetadata

Metadata getTimeCheckStartDateMetadata()

Gets the metadata for making this a time check and for the start date.

Returns:

metadata for time check start date

Compliance:

mandatory - This method must be implemented.

setTimeCheckStartDate

void setTimeCheckStartDate(DateTime date)

Sets the start date and make this a time check,.

Parameters:

date - the new start date

Throws:

InvalidArgumentException - date is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - date is null

Compliance:

mandatory - This method must be implemented.

clearTimeCheckStartDate

void clearTimeCheckStartDate()

Removes the start date.

Throws:

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

Compliance:

mandatory - This method must be implemented.

getTimeCheckEndDateMetadata

Metadata getTimeCheckEndDateMetadata()

Gets the metadata for making this a time check and for the end date.

Returns:

metadata for time check end date

Compliance:

mandatory - This method must be implemented.

setTimeCheckEndDate

void setTimeCheckEndDate(DateTime date)

Sets the end date and make this a time check,.

Parameters:

date - the new end date

Throws:

InvalidArgumentException - date is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - date is null

Compliance:

mandatory - This method must be implemented.

clearTimeCheckEndDate

void clearTimeCheckEndDate()

Removes the end date.

Throws:

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

Compliance:

mandatory - This method must be implemented.

getTimeCheckEventMetadata

Metadata getTimeCheckEventMetadata()

Gets the metadata for making this a time check and for the event.

Returns:

metadata for time check event

Compliance:

mandatory - This method must be implemented.

setTimeCheckEvent

void setTimeCheckEvent(Id eventId)

Sets the event and make this a time check,.

Parameters:

eventId - the new event

Throws:

InvalidArgumentException - eventId is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - eventId is null

Compliance:

mandatory - This method must be implemented.

clearTimeCheckEvent

void clearTimeCheckEvent()

Removes the event.

Throws:

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

Compliance:

mandatory - This method must be implemented.

getTimeCheckCyclicEventMetadata

Metadata getTimeCheckCyclicEventMetadata()

Gets the metadata for making this a time check and for the cyclic event.

Returns:

metadata for time check cyclic event

Compliance:

mandatory - This method must be implemented.

setTimeCheckCyclicEvent

void setTimeCheckCyclicEvent(Id cyclicEventId)

Sets the cyclic event and make this a time check,.

Parameters:

cyclicEventId - the new cyclic event

Throws:

InvalidArgumentException - cyclicEventId is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - cyclicEventId is null

Compliance:

mandatory - This method must be implemented.

clearTimeCheckCyclicEvent

void clearTimeCheckCyclicEvent()

Removes the cyclic event.

Throws:

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

Compliance:

mandatory - This method must be implemented.

getHoldCheckBlockMetadata

Metadata getHoldCheckBlockMetadata()

Gets the metadata for making this a hold check and for the block.

Returns:

metadata for hold check block

Compliance:

mandatory - This method must be implemented.

setHoldCheckBlock

void setHoldCheckBlock(Id blockId)

Sets the block and make this a hold check,.

Parameters:

blockId - the new block

Throws:

InvalidArgumentException - blockId is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - blockId is null

Compliance:

mandatory - This method must be implemented.

clearHoldCheckBlock

void clearHoldCheckBlock()

Removes the block.

Throws:

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

Compliance:

mandatory - This method must be implemented.

getInquiryCheckAuditMetadata

Metadata getInquiryCheckAuditMetadata()

Gets the metadata for making this an inquiry check and for the audit.

Returns:

metadata for inquiry check audit

Compliance:

mandatory - This method must be implemented.

setInqiiryCheckAudit

void setInqiiryCheckAudit(Id auditId)

Sets the audit and make this an inquiry check,.

Parameters:

auditId - the new audit

Throws:

InvalidArgumentException - auditId is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - auditId is null

Compliance:

mandatory - This method must be implemented.

clearInquiryCheckAudit

void clearInquiryCheckAudit()

Removes the audit.

Throws:

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

Compliance:

mandatory - This method must be implemented.

getProcessCheckAgendaMetadata

Metadata getProcessCheckAgendaMetadata()

Gets the metadata for making this a process check and for the agenda.

Returns:

metadata for process check agenda

Compliance:

mandatory - This method must be implemented.

setProcessCheckAgenda

void setProcessCheckAgenda(Id agendaId)

Sets the agenda and make this a process check,.

Parameters:

agendaId - the new agenda

Throws:

InvalidArgumentException - agendaId is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - agendaId is null

Compliance:

mandatory - This method must be implemented.

clearProcessCheckAgenda

void clearProcessCheckAgenda()

Removes the agenda.

Throws:

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

Compliance:

mandatory - This method must be implemented.

getCheckFormRecord

CheckFormRecord getCheckFormRecord(Type checkRecordType)
                                   throws OperationFailedException,
                                          PermissionDeniedException

Gets the CheckFormRecord corresponding to the given check record Type.

Parameters:

checkRecordType - a check record type

Returns:

the check form record

Throws:

NullArgumentException - checkRecordType is null

OperationFailedException - unable to complete request

PermissionDeniedException - authorization failure occurred

UnsupportedException - hasRecordType(checkRecordType) is false

Compliance:

mandatory - This method must be implemented.