org.osid.resourcing

Interface CommissionForm

All Superinterfaces:

Extensible, Identifiable, OsidBrowsableForm, OsidExtensibleForm, OsidForm, OsidIdentifiableForm, OsidObjectForm, OsidRelationshipForm, OsidTemporalForm, Suppliable

All Known Subinterfaces:

CommissionBatchForm

public interface CommissionForm
extends OsidRelationshipForm

This is the form for creating and updating Commissions. Like all OsidForm objects, various data elements may be set here for use in the create and update methods in the CommissionAdminSession. 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	clearCompetency() Removes the competency.
void	clearPercentage() Removes the percentage availability.
CommissionFormRecord	getCommissionFormRecord(Type commissionRecordType) Gets the CommissionFormRecord corresponding to the given commission record Type.
Metadata	getCompetencyMetadata() Gets the metadata for the competency.
Metadata	getPercentageMetadata() Gets the metadata for the percentage availability.
void	setCompetency(Id competencyId) Sets the competency.
void	setPercentage(long availability) Sets the percent availability.

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.OsidTemporalForm

clearEndDate, clearStartDate, getEndDateMetadata, getStartDateMetadata, setEndDate, setStartDate

Method Detail

getCompetencyMetadata

Metadata getCompetencyMetadata()

Gets the metadata for the competency.

Returns:

metadata for the competency

Compliance:

mandatory - This method must be implemented.

setCompetency

void setCompetency(Id competencyId)

Sets the competency.

Parameters:

competencyId - the new competency

Throws:

InvalidArgumentException - competencyId is invalid

NoAccessException - Metadata.isReadOnly() is true

NullArgumentException - competencyId is null

Compliance:

mandatory - This method must be implemented.

clearCompetency

void clearCompetency()

Removes the competency.

Throws:

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

Compliance:

mandatory - This method must be implemented.

getPercentageMetadata

Metadata getPercentageMetadata()

Gets the metadata for the percentage availability.

Returns:

metadata for the percentage availability

Compliance:

mandatory - This method must be implemented.

setPercentage

void setPercentage(long availability)

Sets the percent availability.

Parameters:

availability - the new percentage vaailability

Throws:

InvalidArgumentException - availability is invalid

NoAccessException - Metadata.isReadOnly() is true

Compliance:

mandatory - This method must be implemented.

clearPercentage

void clearPercentage()

Removes the percentage availability.

Throws:

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

Compliance:

mandatory - This method must be implemented.

getCommissionFormRecord

CommissionFormRecord getCommissionFormRecord(Type commissionRecordType)
                                             throws OperationFailedException

Gets the CommissionFormRecord corresponding to the given commission record Type.

Parameters:

commissionRecordType - a commission record type

Returns:

the commission form record

Throws:

NullArgumentException - commissionRecordType is null

OperationFailedException - unable to complete request

UnsupportedException - hasRecordType(commissionRecordType) is false

Compliance:

mandatory - This method must be implemented.