Interface GradeEntryForm
- All Superinterfaces:
Extensible, Identifiable, OsidBrowsableForm, OsidExtensibleForm, OsidForm, OsidIdentifiableForm, OsidObjectForm, OsidRelationshipForm, OsidTemporalForm, Suppliable
- All Known Subinterfaces:
GradeEntryBatchForm
This is the form for creating and updating GradeEntries . Like
all OsidForm objects, various data elements may be set here for
use in the create and update methods in the GradeEntryAdminSession
. For each data element that may be set, metadata may be examined to
provide display hints or data constraints.
-
Method Summary
Modifier and TypeMethodDescriptionvoidClears the grade.voidClears the ignore for calculations flag.voidClears the score.getGradeEntryFormRecord(Type gradeEntryRecordType) Gets theGradeEntryFormRecordcorresponding to the given grade entry recordType.Gets the metadata for a grade.Gets the metadata for the ignore flag.Gets the metadata for a score.voidSets the grade.voidsetIgnoredForCalculations(boolean ignore) Sets the ignore for calculations flag.voidsetScore(BigDecimal score) Sets the score.Methods inherited from interface Extensible
getRecordTypes, hasRecordTypeModifier and TypeMethodDescriptionGets the record types available in this object.booleanhasRecordType(Type recordType) Tests if this object supports the given recordType.Methods inherited from interface Identifiable
getId, isCurrentMethods inherited from interface OsidExtensibleForm
getRequiredRecordTypesModifier and TypeMethodDescriptionGets the minimum required record types for successful submission of thisOsidForm.Methods inherited from interface OsidForm
getDefaultLocale, getInvalidMetadata, getJournalCommentMetadata, getLocales, getValidationMessages, isForUpdate, isValid, setJournalComment, setLocaleModifier and TypeMethodDescriptionGets a default locale for the form.Metadata[]Gets a list of metadata for the elements in this form which are not valid.Gets the metadata for the comment corresponding to this form submission.Gets the locales available for this form.Gets text messages corresponding to additional instructions to pass form validation.booleanTests if this form is for an update operation.booleanisValid()Tests if this form is in a valid state for submission.voidsetJournalComment(String comment) Sets a comment.voidSpecifies a language and script type for the form.Methods inherited from interface OsidObjectForm
clearDescription, clearDisplayName, clearGenusType, getDescriptionMetadata, getDisplayNameMetadata, getGenusTypeMetadata, setDescription, setDisplayName, setGenusTypeModifier and TypeMethodDescriptionvoidClears the description.voidClears the display name.voidClears the genus type.Gets the metadata for a description.Gets the metadata for a display name.Gets the metadata for a genus type.voidsetDescription(String description) Sets a description.voidsetDisplayName(String displayName) Sets a display name.voidsetGenusType(Type genusType) Sets a genus.Methods inherited from interface OsidRelationshipForm
clearEndReason, getEndReasonMetadata, setEndReasonModifier and TypeMethodDescriptionvoidRemoves the end reason.Gets the metadata for the end reason.voidsetEndReason(Id stateId) Sets the end reason.Methods inherited from interface OsidTemporalForm
clearEndDate, clearStartDate, getEndDateMetadata, getStartDateMetadata, setEndDate, setStartDateModifier and TypeMethodDescriptionvoidClears the end date.voidClears the start date.Gets the metadata for an end date.Gets the metadata for a start date.voidsetEndDate(DateTime date) Sets the end date.voidsetStartDate(DateTime date) Sets the start date.
-
Method Details
-
getIgnoredForCalculationsMetadata
Metadata getIgnoredForCalculationsMetadata()Gets the metadata for the ignore flag.- Returns:
- metadata for the ignore flag
- Compliance:
mandatory- This method must be implemented.
-
setIgnoredForCalculations
void setIgnoredForCalculations(boolean ignore) Sets the ignore for calculations flag.- Parameters:
ignore- the new ignore flag- Throws:
InvalidArgumentException-ignoreis invalidNoAccessException-ignorecannot be modified- Compliance:
mandatory- This method must be implemented.
-
clearIgnoredForCalculations
void clearIgnoredForCalculations()Clears the ignore for calculations flag.- Throws:
NoAccessException-Metadata.isRequired()orMetadata.isReadOnly()istrue- Compliance:
mandatory- This method must be implemented.
-
getGradeMetadata
Metadata getGradeMetadata()Gets the metadata for a grade.- Returns:
- metadata for the grade
- Compliance:
mandatory- This method must be implemented.
-
setGrade
Sets the grade.- Parameters:
gradeId- the new grade- Throws:
InvalidArgumentException-gradeIdis invalid orGradebookColumn.getGradeSystem().isBasedOnGrades()isfalseNoAccessException-gradeIdcannot be modifiedNullArgumentException-gradeIdisnull- Compliance:
mandatory- This method must be implemented.
-
clearGrade
void clearGrade()Clears the grade.- Throws:
NoAccessException-Metadata.isRequired()orMetadata.isReadOnly()istrue- Compliance:
mandatory- This method must be implemented.
-
getScoreMetadata
Metadata getScoreMetadata()Gets the metadata for a score.- Returns:
- metadata for the score
- Compliance:
mandatory- This method must be implemented.
-
setScore
Sets the score.- Parameters:
score- the new score- Throws:
InvalidArgumentException-scoreis invalid orGradebookColumn.getGradeSystem().isBasedOnGrades()istrueNoAccessException-scorecannot be modified- Compliance:
mandatory- This method must be implemented.
-
clearScore
void clearScore()Clears the score.- Throws:
NoAccessException-Metadata.isRequired()orMetadata.isReadOnly()istrue- Compliance:
mandatory- This method must be implemented.
-
getGradeEntryFormRecord
GradeEntryFormRecord getGradeEntryFormRecord(Type gradeEntryRecordType) throws OperationFailedException Gets theGradeEntryFormRecordcorresponding to the given grade entry recordType.- Parameters:
gradeEntryRecordType- the grade entry record type- Returns:
- the grade entry form record
- Throws:
NullArgumentException-gradeEntryRecordTypeisnullOperationFailedException- unable to complete requestUnsupportedException-hasRecordType(gradeEntryRecordType)isfalse- Compliance:
mandatory- This method must be implemented.
-