org.sakaiproject.tool.assessment.facade

Interface AssessmentGradingFacadeQueriesAPI

All Known Implementing Classes:

AssessmentGradingFacadeQueries

public interface AssessmentGradingFacadeQueriesAPI

Method Summary

Modifier and Type	Method and Description
Long	add(AssessmentGradingData a) This grades multiple choice and true false questions.
int	autoSubmitAssessments() Checks for assessment attempts that should be autosubmitted
void	completeItemGradingData(AssessmentGradingData assessmentGradingData)
AssessmentGradingAttachment	createAssessmentGradingtAttachment(AssessmentGradingData assessmentGrading, String resourceId, String filename, String protocol)
ItemGradingAttachment	createItemGradingtAttachment(ItemGradingData itemGrading, String resourceId, String filename, String protocol)
void	deleteAll(Collection c)
int	getActualNumberRetake(Long publishedAssessmentId, String agentIdString)
Map<Long,Integer>	getActualNumberRetakeHash(String agentIdString)
List	getAllAssessmentGradingByAgentId(Long publishedAssessmentId, String agentIdString)
List	getAllAssessmentGradingData(Long publishedId)
List<ItemGradingData>	getAllItemGradingDataForItemInGrading(Long assesmentGradingId, Long publishedItemId) Get all answers for a a particular published item This is needed by certain question types like EMI
List	getAllSubmissions(String publishedId) Get all submissions that are flagged for grading
Map<Long,AssessmentGradingData>	getAssessmentGradingByItemGradingId(Long publishedAssessmentId)
List<Long>	getAssessmentGradingIds(Long publishedItemId)
Map<Long,List<Long>>	getAverageAssessmentGradingByPublishedItem(Long publishedAssessmentId)
Double	getAverageSubmittedAssessmentGrading(Long publishedAssessmentId, String agentId)
List	getExportResponsesData(String publishedAssessmentId, boolean anonymous, String audioMessage, String fileUploadMessage, String noSubmissionMessage, boolean showPartAndTotalScoreSpreadsheetColumns, String poolString, String sectionString, String questionString, String textString, String rationaleString, String itemGradingCommentsString, Map useridMap, String responseCommentString)
String	getFilename(Long itemGradingId, String agentId, String filename)
boolean	getHasGradingData(Long publishedAssessmentId)
List<Boolean>	getHasGradingDataAndHasSubmission(Long publishedAssessmentId)
AssessmentGradingData	getHighestAssessmentGrading(Long publishedAssessmentId, String agentId)
Map<Long,List<Long>>	getHighestAssessmentGradingByPublishedItem(Long publishedAssessmentId)
List	getHighestAssessmentGradingList(Long publishedAssessmentId)
AssessmentGradingData	getHighestSubmittedAssessmentGrading(Long publishedAssessmentId, String agentId, Long assessmentGradingId)
List	getHighestSubmittedAssessmentGradingList(Long publishedAssessmentId)
List	getHighestSubmittedOrGradedAssessmentGradingList(Long publishedAssessmentId)
HashMap	getInProgressCounts(String siteId)
ItemGradingData	getItemGrading(Long id)
ItemGradingData	getItemGradingData(Long assessmentGradingId)
ItemGradingData	getItemGradingData(Long assessmentGradingId, Long publishedItemId)
List	getItemGradingIds(Long assessmentGradingId)
Set	getItemGradingSet(Long assessmentGradingId)
Map<Long,List<ItemGradingData>>	getItemScores(Long itemId, List<AssessmentGradingData> scores, boolean loadItemGradingAttachment)
Map<Long,List<ItemGradingData>>	getItemScores(Long publishedId, Long itemId, String which)
Map<Long,List<ItemGradingData>>	getItemScores(Long publishedId, Long itemId, String which, boolean loadItemGradingAttachment)
Set<PublishedItemData>	getItemSet(Long publishedAssessmentId, Long sectionId)
AssessmentGradingData	getLastAssessmentGradingByAgentId(Long publishedAssessmentId, String agentIdString)
Map<Long,List<Long>>	getLastAssessmentGradingByPublishedItem(Long publishedAssessmentId)
List	getLastAssessmentGradingList(Long publishedAssessmentId)
Map<Long,List<ItemGradingData>>	getLastItemGradingData(Long publishedId, String agentId) This returns a hashmap of all the latest item entries, keyed by item id for easy retrieval.
ItemGradingData	getLastItemGradingDataByAgent(Long publishedItemId, String agentId)
List<Integer>	getLastItemGradingDataPosition(Long assessmentGradingId, String agentId)
AssessmentGradingData	getLastSavedAssessmentGradingByAgentId(Long publishedAssessmentId, String agentIdString)
AssessmentGradingData	getLastSubmittedAssessmentGradingByAgentId(Long publishedAssessmentId, String agentIdString, Long assessmentGradingId)
List	getLastSubmittedAssessmentGradingList(Long publishedAssessmentId)
List	getLastSubmittedOrGradedAssessmentGradingList(Long publishedAssessmentId)
int	getLateSubmissionsNumberByAgentId(Long publishedAssessmentId, String agentIdString, Date dueDate)
MediaData	getMedia(Long mediaId)
List<MediaData>	getMediaArray(ItemGradingData item)
List<MediaData>	getMediaArray(Long itemGradingId)
List	getMediaArray(Long publishedItemId, Long agentId, String which)
List<MediaData>	getMediaArray2(Long itemGradingId)
List<Long>	getMediaConversionBatch() Get a batch of IDs for Media objects that have blobs in the database
List<Long>	getMediaInConversion() Sanity check for Media objects left in the converting state
Map<Long,List<ItemGradingData>>	getMediaItemGradingHash(Long assessmentGradingId)
List<Long>	getMediaWithDataAndLocation() Sanity check query for Media objects with conflicting state of holding a blob and location
int	getNumberRetake(Long publishedAssessmentId, String agentIdString)
Map<Long,StudentGradingSummaryData>	getNumberRetakeHash(String agentIdString)
PublishedAssessmentIfc	getPublishedAssessmentByAssessmentGradingId(Long assessmentGradingId)
PublishedAssessmentIfc	getPublishedAssessmentByPublishedItemId(Long publishedItemId)
List	getPublishedItemIds(Long assessmentGradingId)
Map<Long,Map<String,Long>>	getSiteActualNumberRetakeHash(String siteIdString)
Map<Long,Map<String,Long>>	getSiteInProgressCountHash(String siteId)
List	getSiteNeedResubmitList(String siteId)
Map<Long,Map<String,Integer>>	getSiteNumberRetakeHash(String siteIdString)
Map<Long,Map<String,Integer>>	getSiteSubmissionCountHash(String siteId)
HashMap	getStudentGradingData(String assessmentGradingId) This returns a hashmap of all the submitted items, keyed by item id for easy retrieval.
List	getStudentGradingSummaryData(Long publishedAssessmentId, String agentIdString)
int	getSubmissionSizeOfPublishedAssessment(Long publishedAssessmentId)
Map<Long,List<ItemGradingData>>	getSubmitData(Long publishedId, String agentId, Integer scoringoption, Long assessmentGradingId)
HashMap	getSubmittedCounts(String siteId)
List	getTotalScores(String publishedId, String which)
List	getTotalScores(String publishedId, String which, boolean getSubmittedOnly)
Long	getTypeId(Long itemGradingId)
List	getUnSubmittedAssessmentGradingDataList(Long publishedAssessmentId, String agentIdString)
List	getUpdatedAssessmentList(String agentId, String siteId)
AssessmentGradingData	load(Long id)
AssessmentGradingData	load(Long id, boolean loadGradingAttachment)
boolean	markMediaForConversion(List<Long> mediaIds) Mark a list of Media objects as being converted
void	removeAssessmentGradingAttachment(Long attachmentId)
void	removeAssessmentGradingData(AssessmentGradingData data)
void	removeItemGradingAttachment(Long attachmentId)
void	removeMediaById(Long mediaId)
void	removeMediaById(Long mediaId, Long itemGradingId)
void	removeUnsubmittedAssessmentGradingData(AssessmentGradingData data)
void	saveItemGrading(ItemGradingData item)
Long	saveMedia(byte[] media, String mimeType)
Long	saveMedia(MediaData mediaData)
void	saveOrUpdateAll(Collection<ItemGradingData> c)
boolean	saveOrUpdateAssessmentGrading(AssessmentGradingData assessment)
void	saveOrUpdateAttachments(List<AttachmentIfc> list)
void	saveStudentGradingSummaryData(StudentGradingSummaryIfc studentGradingSummaryData)

Method Detail

getTotalScores

List getTotalScores(String publishedId,
                    String which)

getTotalScores

List getTotalScores(String publishedId,
                    String which,
                    boolean getSubmittedOnly)

getAllSubmissions

List getAllSubmissions(String publishedId)

Get all submissions that are flagged for grading

Parameters:

publishedId - the published assesment id

Returns:

getAllAssessmentGradingData

List getAllAssessmentGradingData(Long publishedId)

getAllItemGradingDataForItemInGrading

List<ItemGradingData> getAllItemGradingDataForItemInGrading(Long assesmentGradingId,
                                                            Long publishedItemId)

Get all answers for a a particular published item This is needed by certain question types like EMI

Parameters:

assesmentGradingId -

publishedItemId -

Returns:

an list of all the items or an empty list if none

getItemScores

Map<Long,List<ItemGradingData>> getItemScores(Long publishedId,
                                              Long itemId,
                                              String which)

getItemScores

Map<Long,List<ItemGradingData>> getItemScores(Long publishedId,
                                              Long itemId,
                                              String which,
                                              boolean loadItemGradingAttachment)

getItemScores

Map<Long,List<ItemGradingData>> getItemScores(Long itemId,
                                              List<AssessmentGradingData> scores,
                                              boolean loadItemGradingAttachment)

getLastItemGradingData

Map<Long,List<ItemGradingData>> getLastItemGradingData(Long publishedId,
                                                       String agentId)

This returns a hashmap of all the latest item entries, keyed by item id for easy retrieval.

getStudentGradingData

HashMap getStudentGradingData(String assessmentGradingId)

This returns a hashmap of all the submitted items, keyed by item id for easy retrieval.

getSubmitData

Map<Long,List<ItemGradingData>> getSubmitData(Long publishedId,
                                              String agentId,
                                              Integer scoringoption,
                                              Long assessmentGradingId)

add

Long add(AssessmentGradingData a)

This grades multiple choice and true false questions. Since multiple choice/multiple select has a separate ItemGradingIfc for each choice, they're graded the same way the single choice are. Choices should be given negative score values if one wants them to lose points for the wrong choice.

getSubmissionSizeOfPublishedAssessment

int getSubmissionSizeOfPublishedAssessment(Long publishedAssessmentId)

saveMedia

Long saveMedia(byte[] media,
               String mimeType)

saveMedia

Long saveMedia(MediaData mediaData)

removeMediaById

void removeMediaById(Long mediaId)

removeMediaById

void removeMediaById(Long mediaId,
                     Long itemGradingId)

getMedia

MediaData getMedia(Long mediaId)

getMediaArray

List<MediaData> getMediaArray(Long itemGradingId)

getMediaArray2

List<MediaData> getMediaArray2(Long itemGradingId)

getMediaArray

List<MediaData> getMediaArray(ItemGradingData item)

getMediaItemGradingHash

Map<Long,List<ItemGradingData>> getMediaItemGradingHash(Long assessmentGradingId)

getMediaArray

List getMediaArray(Long publishedItemId,
                   Long agentId,
                   String which)

getMediaConversionBatch

List<Long> getMediaConversionBatch()

Get a batch of IDs for Media objects that have blobs in the database

getMediaWithDataAndLocation

List<Long> getMediaWithDataAndLocation()

Sanity check query for Media objects with conflicting state of holding a blob and location

getMediaInConversion

List<Long> getMediaInConversion()

Sanity check for Media objects left in the converting state

markMediaForConversion

boolean markMediaForConversion(List<Long> mediaIds)

Mark a list of Media objects as being converted

getLastItemGradingDataByAgent

ItemGradingData getLastItemGradingDataByAgent(Long publishedItemId,
                                              String agentId)

getItemGradingData

ItemGradingData getItemGradingData(Long assessmentGradingId)

getItemGradingData

ItemGradingData getItemGradingData(Long assessmentGradingId,
                                   Long publishedItemId)

load

AssessmentGradingData load(Long id)

load

AssessmentGradingData load(Long id,
                           boolean loadGradingAttachment)

getItemGrading

ItemGradingData getItemGrading(Long id)

getLastAssessmentGradingByAgentId

AssessmentGradingData getLastAssessmentGradingByAgentId(Long publishedAssessmentId,
                                                        String agentIdString)

getLastSavedAssessmentGradingByAgentId

AssessmentGradingData getLastSavedAssessmentGradingByAgentId(Long publishedAssessmentId,
                                                             String agentIdString)

getLastSubmittedAssessmentGradingByAgentId

AssessmentGradingData getLastSubmittedAssessmentGradingByAgentId(Long publishedAssessmentId,
                                                                 String agentIdString,
                                                                 Long assessmentGradingId)

getLastAssessmentGradingList

List getLastAssessmentGradingList(Long publishedAssessmentId)

getLastSubmittedAssessmentGradingList

List getLastSubmittedAssessmentGradingList(Long publishedAssessmentId)

getLastSubmittedOrGradedAssessmentGradingList

List getLastSubmittedOrGradedAssessmentGradingList(Long publishedAssessmentId)

saveItemGrading

void saveItemGrading(ItemGradingData item)

saveOrUpdateAssessmentGrading

boolean saveOrUpdateAssessmentGrading(AssessmentGradingData assessment)

getAssessmentGradingIds

List<Long> getAssessmentGradingIds(Long publishedItemId)

getHighestAssessmentGrading

AssessmentGradingData getHighestAssessmentGrading(Long publishedAssessmentId,
                                                  String agentId)

getHighestSubmittedAssessmentGrading

AssessmentGradingData getHighestSubmittedAssessmentGrading(Long publishedAssessmentId,
                                                           String agentId,
                                                           Long assessmentGradingId)

getLastAssessmentGradingByPublishedItem

Map<Long,List<Long>> getLastAssessmentGradingByPublishedItem(Long publishedAssessmentId)

getHighestAssessmentGradingByPublishedItem

Map<Long,List<Long>> getHighestAssessmentGradingByPublishedItem(Long publishedAssessmentId)

getHighestAssessmentGradingList

List getHighestAssessmentGradingList(Long publishedAssessmentId)

getHighestSubmittedOrGradedAssessmentGradingList

List getHighestSubmittedOrGradedAssessmentGradingList(Long publishedAssessmentId)

getItemGradingSet

Set getItemGradingSet(Long assessmentGradingId)

getAssessmentGradingByItemGradingId

Map<Long,AssessmentGradingData> getAssessmentGradingByItemGradingId(Long publishedAssessmentId)

deleteAll

void deleteAll(Collection c)

saveOrUpdateAll

void saveOrUpdateAll(Collection<ItemGradingData> c)

getPublishedAssessmentByAssessmentGradingId

PublishedAssessmentIfc getPublishedAssessmentByAssessmentGradingId(Long assessmentGradingId)

getPublishedAssessmentByPublishedItemId

PublishedAssessmentIfc getPublishedAssessmentByPublishedItemId(Long publishedItemId)

getLastItemGradingDataPosition

List<Integer> getLastItemGradingDataPosition(Long assessmentGradingId,
                                             String agentId)

getPublishedItemIds

List getPublishedItemIds(Long assessmentGradingId)

getItemGradingIds

List getItemGradingIds(Long assessmentGradingId)

getItemSet

Set<PublishedItemData> getItemSet(Long publishedAssessmentId,
                                  Long sectionId)

getTypeId

Long getTypeId(Long itemGradingId)

getAllAssessmentGradingByAgentId

List getAllAssessmentGradingByAgentId(Long publishedAssessmentId,
                                      String agentIdString)

getSiteSubmissionCountHash

Map<Long,Map<String,Integer>> getSiteSubmissionCountHash(String siteId)

getSiteInProgressCountHash

Map<Long,Map<String,Long>> getSiteInProgressCountHash(String siteId)

getActualNumberRetake

int getActualNumberRetake(Long publishedAssessmentId,
                          String agentIdString)

getActualNumberRetakeHash

Map<Long,Integer> getActualNumberRetakeHash(String agentIdString)

getSiteActualNumberRetakeHash

Map<Long,Map<String,Long>> getSiteActualNumberRetakeHash(String siteIdString)

getStudentGradingSummaryData

List getStudentGradingSummaryData(Long publishedAssessmentId,
                                  String agentIdString)

getNumberRetake

int getNumberRetake(Long publishedAssessmentId,
                    String agentIdString)

getNumberRetakeHash

Map<Long,StudentGradingSummaryData> getNumberRetakeHash(String agentIdString)

getSiteNumberRetakeHash

Map<Long,Map<String,Integer>> getSiteNumberRetakeHash(String siteIdString)

saveStudentGradingSummaryData

void saveStudentGradingSummaryData(StudentGradingSummaryIfc studentGradingSummaryData)

getLateSubmissionsNumberByAgentId

int getLateSubmissionsNumberByAgentId(Long publishedAssessmentId,
                                      String agentIdString,
                                      Date dueDate)

getExportResponsesData

List getExportResponsesData(String publishedAssessmentId,
                            boolean anonymous,
                            String audioMessage,
                            String fileUploadMessage,
                            String noSubmissionMessage,
                            boolean showPartAndTotalScoreSpreadsheetColumns,
                            String poolString,
                            String sectionString,
                            String questionString,
                            String textString,
                            String rationaleString,
                            String itemGradingCommentsString,
                            Map useridMap,
                            String responseCommentString)

getHasGradingData

boolean getHasGradingData(Long publishedAssessmentId)

removeUnsubmittedAssessmentGradingData

void removeUnsubmittedAssessmentGradingData(AssessmentGradingData data)

removeAssessmentGradingData

void removeAssessmentGradingData(AssessmentGradingData data)

getHasGradingDataAndHasSubmission

List<Boolean> getHasGradingDataAndHasSubmission(Long publishedAssessmentId)

getFilename

String getFilename(Long itemGradingId,
                   String agentId,
                   String filename)

getUpdatedAssessmentList

List getUpdatedAssessmentList(String agentId,
                              String siteId)

getSiteNeedResubmitList

List getSiteNeedResubmitList(String siteId)

autoSubmitAssessments

int autoSubmitAssessments()

Checks for assessment attempts that should be autosubmitted

Returns:

number of attempts/submissions that could not be processed due to error

createItemGradingtAttachment

ItemGradingAttachment createItemGradingtAttachment(ItemGradingData itemGrading,
                                                   String resourceId,
                                                   String filename,
                                                   String protocol)

createAssessmentGradingtAttachment

AssessmentGradingAttachment createAssessmentGradingtAttachment(AssessmentGradingData assessmentGrading,
                                                               String resourceId,
                                                               String filename,
                                                               String protocol)

removeItemGradingAttachment

void removeItemGradingAttachment(Long attachmentId)

saveOrUpdateAttachments

void saveOrUpdateAttachments(List<AttachmentIfc> list)

removeAssessmentGradingAttachment

void removeAssessmentGradingAttachment(Long attachmentId)

getInProgressCounts

HashMap getInProgressCounts(String siteId)

getSubmittedCounts

HashMap getSubmittedCounts(String siteId)

completeItemGradingData

void completeItemGradingData(AssessmentGradingData assessmentGradingData)

getHighestSubmittedAssessmentGradingList

List getHighestSubmittedAssessmentGradingList(Long publishedAssessmentId)

getAverageSubmittedAssessmentGrading

Double getAverageSubmittedAssessmentGrading(Long publishedAssessmentId,
                                            String agentId)

getAverageAssessmentGradingByPublishedItem

Map<Long,List<Long>> getAverageAssessmentGradingByPublishedItem(Long publishedAssessmentId)

getUnSubmittedAssessmentGradingDataList

List getUnSubmittedAssessmentGradingDataList(Long publishedAssessmentId,
                                             String agentIdString)