// (C) Copyright 2015 Moodle Pty Ltd. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. import { Injectable } from '@angular/core'; import { CoreFileUploader, CoreFileUploaderStoreFilesResult } from '@features/fileuploader/services/fileuploader'; import { CoreSites, CoreSitesCommonWSOptions } from '@services/sites'; import { CoreWSExternalFile } from '@services/ws'; import { FileEntry } from '@ionic-native/file/ngx'; import { AddonModAssignProvider, AddonModAssignAssign, AddonModAssignSubmission, AddonModAssignParticipant, AddonModAssignSubmissionFeedback, AddonModAssign, } from './assign'; import { AddonModAssignOffline } from './assign-offline'; import { CoreUtils } from '@services/utils/utils'; import { CoreFile } from '@services/file'; import { CoreCourseCommonModWSOptions } from '@features/course/services/course'; import { CoreGroups } from '@services/groups'; import { AddonModAssignSubmissionDelegate } from './submission-delegate'; import { AddonModAssignFeedbackDelegate } from './feedback-delegate'; import { makeSingleton } from '@singletons'; /** * Service that provides some helper functions for assign. */ @Injectable({ providedIn: 'root' }) export class AddonModAssignHelperProvider { /** * Check if a submission can be edited in offline. * * @param assign Assignment. * @param submission Submission. * @return Whether it can be edited offline. */ async canEditSubmissionOffline(assign: AddonModAssignAssign, submission: AddonModAssignSubmission): Promise<boolean> { if (!submission) { return false; } if (submission.status == AddonModAssignProvider.SUBMISSION_STATUS_NEW || submission.status == AddonModAssignProvider.SUBMISSION_STATUS_REOPENED) { // It's a new submission, allow creating it in offline. return true; } let canEdit = true; const promises = submission.plugins ? submission.plugins.map((plugin) => AddonModAssignSubmissionDelegate.instance.canPluginEditOffline(assign, submission, plugin).then((canEditPlugin) => { if (!canEditPlugin) { canEdit = false; } return; })) : []; await Promise.all(promises); return canEdit; } /** * Clear plugins temporary data because a submission was cancelled. * * @param assign Assignment. * @param submission Submission to clear the data for. * @param inputData Data entered in the submission form. */ clearSubmissionPluginTmpData(assign: AddonModAssignAssign, submission: AddonModAssignSubmission, inputData: any): void { submission.plugins?.forEach((plugin) => { AddonModAssignSubmissionDelegate.instance.clearTmpData(assign, submission, plugin, inputData); }); } /** * Copy the data from last submitted attempt to the current submission. * Since we don't have any WS for that we'll have to re-submit everything manually. * * @param assign Assignment. * @param previousSubmission Submission to copy. * @return Promise resolved when done. */ async copyPreviousAttempt(assign: AddonModAssignAssign, previousSubmission: AddonModAssignSubmission): Promise<void> { const pluginData: any = {}; const promises = previousSubmission.plugins ? previousSubmission.plugins.map((plugin) => AddonModAssignSubmissionDelegate.instance.copyPluginSubmissionData(assign, plugin, pluginData)) : []; await Promise.all(promises); // We got the plugin data. Now we need to submit it. if (Object.keys(pluginData).length) { // There's something to save. return AddonModAssign.instance.saveSubmissionOnline(assign.id, pluginData); } } /** * Create an empty feedback object. * * @return Feedback. */ createEmptyFeedback(): AddonModAssignSubmissionFeedback { return { grade: undefined, gradefordisplay: undefined, gradeddate: undefined, }; } /** * Create an empty submission object. * * @return Submission. */ createEmptySubmission(): AddonModAssignSubmissionFormatted { return { id: undefined, userid: undefined, attemptnumber: undefined, timecreated: undefined, timemodified: undefined, status: undefined, groupid: undefined, }; } /** * Delete stored submission files for a plugin. See storeSubmissionFiles. * * @param assignId Assignment ID. * @param folderName Name of the plugin folder. Must be unique (both in submission and feedback plugins). * @param userId User ID. If not defined, site's current user. * @param siteId Site ID. If not defined, current site. * @return Promise resolved when done. */ async deleteStoredSubmissionFiles(assignId: number, folderName: string, userId?: number, siteId?: string): Promise<void> { const folderPath = await AddonModAssignOffline.instance.getSubmissionPluginFolder(assignId, folderName, userId, siteId); await CoreFile.instance.removeDir(folderPath); } /** * Delete all drafts of the feedback plugin data. * * @param assignId Assignment Id. * @param userId User Id. * @param feedback Feedback data. * @param siteId Site ID. If not defined, current site. * @return Promise resolved when done. */ async discardFeedbackPluginData( assignId: number, userId: number, feedback: AddonModAssignSubmissionFeedback, siteId?: string, ): Promise<void> { const promises = feedback.plugins ? feedback.plugins.map((plugin) => AddonModAssignFeedbackDelegate.instance.discardPluginFeedbackData(assignId, userId, plugin, siteId)) : []; await Promise.all(promises); } /** * Check if a submission has no content. * * @param assign Assignment object. * @param submission Submission to inspect. * @return Whether the submission is empty. */ isSubmissionEmpty(assign: AddonModAssignAssign, submission?: AddonModAssignSubmission): boolean { if (!submission) { return true; } const anyNotEmpty = submission.plugins?.some((plugin) => !AddonModAssignSubmissionDelegate.instance.isPluginEmpty(assign, plugin)); // If any plugin is not empty, we consider that the submission is not empty either. if (anyNotEmpty) { return false; } // If all the plugins were empty (or there were no plugins), we consider the submission to be empty. return true; } /** * List the participants for a single assignment, with some summary info about their submissions. * * @param assign Assignment object. * @param groupId Group Id. * @param options Other options. * @return Promise resolved with the list of participants and summary of submissions. */ async getParticipants( assign: AddonModAssignAssign, groupId?: number, options: CoreSitesCommonWSOptions = {}, ): Promise<AddonModAssignParticipant[]> { groupId = groupId || 0; options.siteId = options.siteId || CoreSites.instance.getCurrentSiteId(); // Create new options including all existing ones. const modOptions: CoreCourseCommonModWSOptions = { cmId: assign.cmid, ...options }; const participants = await AddonModAssign.instance.listParticipants(assign.id, groupId, modOptions); if (groupId || participants && participants.length > 0) { return participants; } // If no participants returned and all groups specified, get participants by groups. const groupsInfo = await CoreGroups.instance.getActivityGroupInfo(assign.cmid, false, undefined, modOptions.siteId); []; const participantsIndexed: {[id: number]: AddonModAssignParticipant} = {}; const promises = groupsInfo.groups ? groupsInfo.groups.map((userGroup) => AddonModAssign.instance.listParticipants(assign.id, userGroup.id, modOptions).then((participantsFromList) => { // Do not get repeated users. participantsFromList.forEach((participant) => { participantsIndexed[participant.id] = participant; }); return; })) :[]; await Promise.all(promises); return CoreUtils.instance.objectToArray(participantsIndexed); } /** * Get plugin config from assignment config. * * @param assign Assignment object including all config. * @param subtype Subtype name (assignsubmission or assignfeedback) * @param type Name of the subplugin. * @return Object containing all configurations of the subplugin selected. */ getPluginConfig(assign: AddonModAssignAssign, subtype: string, type: string): AddonModAssignPluginConfig { const configs: AddonModAssignPluginConfig = {}; assign.configs.forEach((config) => { if (config.subtype == subtype && config.plugin == type) { configs[config.name] = config.value; } }); return configs; } /** * Get enabled subplugins. * * @param assign Assignment object including all config. * @param subtype Subtype name (assignsubmission or assignfeedback) * @return List of enabled plugins for the assign. */ getPluginsEnabled(assign: AddonModAssignAssign, subtype: string): AddonModAssignPluginsEnabled { const enabled: AddonModAssignPluginsEnabled = []; assign.configs.forEach((config) => { if (config.subtype == subtype && config.name == 'enabled' && parseInt(config.value, 10) === 1) { // Format the plugin objects. enabled.push({ type: config.plugin, }); } }); return enabled; } /** * Get a list of stored submission files. See storeSubmissionFiles. * * @param assignId Assignment ID. * @param folderName Name of the plugin folder. Must be unique (both in submission and feedback plugins). * @param userId User ID. If not defined, site's current user. * @param siteId Site ID. If not defined, current site. * @return Promise resolved with the files. */ async getStoredSubmissionFiles( assignId: number, folderName: string, userId?: number, siteId?: string, ): Promise<(FileEntry | DirectoryEntry)[]> { const folderPath = await AddonModAssignOffline.instance.getSubmissionPluginFolder(assignId, folderName, userId, siteId); return CoreFile.instance.getDirectoryContents(folderPath); } /** * Get the size that will be uploaded to perform an attempt copy. * * @param assign Assignment. * @param previousSubmission Submission to copy. * @return Promise resolved with the size. */ async getSubmissionSizeForCopy(assign: AddonModAssignAssign, previousSubmission: AddonModAssignSubmission): Promise<number> { let totalSize = 0; const promises = previousSubmission.plugins ? previousSubmission.plugins.map((plugin) => AddonModAssignSubmissionDelegate.instance.getPluginSizeForCopy(assign, plugin).then((size) => { totalSize += (size || 0); return; })) : []; await Promise.all(promises); return totalSize; } /** * Get the size that will be uploaded to save a submission. * * @param assign Assignment. * @param submission Submission to check data. * @param inputData Data entered in the submission form. * @return Promise resolved with the size. */ async getSubmissionSizeForEdit( assign: AddonModAssignAssign, submission: AddonModAssignSubmission, inputData: any, ): Promise<number> { let totalSize = 0; const promises = submission.plugins ? submission.plugins.map((plugin) => AddonModAssignSubmissionDelegate.instance.getPluginSizeForEdit(assign, submission, plugin, inputData) .then((size) => { totalSize += (size || 0); return; })) : []; await Promise.all(promises); return totalSize; } /** * Get user data for submissions since they only have userid. * * @param assign Assignment object. * @param submissions Submissions to get the data for. * @param groupId Group Id. * @param options Other options. * @return Promise always resolved. Resolve param is the formatted submissions. */ async getSubmissionsUserData( assign: AddonModAssignAssign, submissions: AddonModAssignSubmissionFormatted[] = [], groupId?: number, options: CoreSitesCommonWSOptions = {}, ): Promise<AddonModAssignSubmissionFormatted[]> { // Create new options including all existing ones. const modOptions: CoreCourseCommonModWSOptions = { cmId: assign.cmid, ...options }; const parts = await this.getParticipants(assign, groupId, options); const blind = assign.blindmarking && !assign.revealidentities; const promises: Promise<void>[] = []; const result: AddonModAssignSubmissionFormatted[] = []; const participants: {[id: number]: AddonModAssignParticipant} = CoreUtils.instance.arrayToObject(parts, 'id'); submissions.forEach((submission) => { submission.submitid = submission.userid && submission.userid > 0 ? submission.userid : submission.blindid; if (typeof submission.submitid == 'undefined' || submission.submitid <= 0) { return; } const participant = participants[submission.submitid]; if (!participant) { // Avoid permission denied error. Participant not found on list. return; } delete participants[submission.submitid]; if (!blind) { submission.userfullname = participant.fullname; submission.userprofileimageurl = participant.profileimageurl; } submission.manyGroups = !!participant.groups && participant.groups.length > 1; submission.noGroups = !!participant.groups && participant.groups.length == 0; if (participant.groupname) { submission.groupid = participant.groupid!; submission.groupname = participant.groupname; } let promise = Promise.resolve(); if (submission.userid && submission.userid > 0 && blind) { // Blind but not blinded! (Moodle < 3.1.1, 3.2). delete submission.userid; promise = AddonModAssign.instance.getAssignmentUserMappings(assign.id, submission.submitid, modOptions) .then((blindId) => { submission.blindid = blindId; return; }); } promises.push(promise.then(() => { // Add to the list. if (submission.userfullname || submission.blindid) { result.push(submission); } return; })); }); await Promise.all(promises); // Create a submission for each participant left in the list (the participants already treated were removed). CoreUtils.instance.objectToArray(participants).forEach((participant: AddonModAssignParticipant) => { const submission = this.createEmptySubmission(); submission.submitid = participant.id; if (!blind) { submission.userid = participant.id; submission.userfullname = participant.fullname; submission.userprofileimageurl = participant.profileimageurl; } else { submission.blindid = participant.id; } submission.manyGroups = !!participant.groups && participant.groups.length > 1; submission.noGroups = !!participant.groups && participant.groups.length == 0; if (participant.groupname) { submission.groupid = participant.groupid!; submission.groupname = participant.groupname; } submission.status = participant.submitted ? AddonModAssignProvider.SUBMISSION_STATUS_SUBMITTED : AddonModAssignProvider.SUBMISSION_STATUS_NEW; result.push(submission); }); return result; } /** * Check if the feedback data has changed for a certain submission and assign. * * @param assign Assignment. * @param submission The submission. * @param feedback Feedback data. * @param userId The user ID. * @return Promise resolved with true if data has changed, resolved with false otherwise. */ async hasFeedbackDataChanged( assign: AddonModAssignAssign, submission: AddonModAssignSubmission, feedback: AddonModAssignSubmissionFeedback, userId: number, ): Promise<boolean> { let hasChanged = false; const promises = feedback.plugins ? feedback.plugins.map((plugin) => this.prepareFeedbackPluginData(assign.id, userId, feedback).then(async (inputData) => { const changed = await CoreUtils.instance.ignoreErrors( AddonModAssignFeedbackDelegate.instance.hasPluginDataChanged(assign, submission, plugin, inputData, userId), false, ); if (changed) { hasChanged = true; } return; })) : []; await CoreUtils.instance.allPromises(promises); return hasChanged; } /** * Check if the submission data has changed for a certain submission and assign. * * @param assign Assignment. * @param submission Submission to check data. * @param inputData Data entered in the submission form. * @return Promise resolved with true if data has changed, resolved with false otherwise. */ async hasSubmissionDataChanged( assign: AddonModAssignAssign, submission: AddonModAssignSubmission, inputData: any, ): Promise<boolean> { let hasChanged = false; const promises = submission.plugins ? submission.plugins.map((plugin) => AddonModAssignSubmissionDelegate.instance.hasPluginDataChanged(assign, submission, plugin, inputData) .then((changed) => { if (changed) { hasChanged = true; } return; }).catch(() => { // Ignore errors. })) : []; await CoreUtils.instance.allPromises(promises); return hasChanged; } /** * Prepare and return the plugin data to send for a certain feedback and assign. * * @param assignId Assignment Id. * @param userId User Id. * @param feedback Feedback data. * @param siteId Site ID. If not defined, current site. * @return Promise resolved with plugin data to send to server. */ async prepareFeedbackPluginData( assignId: number, userId: number, feedback: AddonModAssignSubmissionFeedback, siteId?: string, ): Promise<any> { const pluginData = {}; const promises = feedback.plugins ? feedback.plugins.map((plugin) => AddonModAssignFeedbackDelegate.instance.preparePluginFeedbackData(assignId, userId, plugin, pluginData, siteId)) : []; await Promise.all(promises); return pluginData; } /** * Prepare and return the plugin data to send for a certain submission and assign. * * @param assign Assignment. * @param submission Submission to check data. * @param inputData Data entered in the submission form. * @param offline True to prepare the data for an offline submission, false otherwise. * @return Promise resolved with plugin data to send to server. */ async prepareSubmissionPluginData( assign: AddonModAssignAssign, submission: AddonModAssignSubmission, inputData: any, offline = false, ): Promise<any> { const pluginData = {}; const promises = submission.plugins ? submission.plugins.map((plugin) => AddonModAssignSubmissionDelegate.instance.preparePluginSubmissionData( assign, submission, plugin, inputData, pluginData, offline, )) : []; await Promise.all(promises); return pluginData; } /** * Given a list of files (either online files or local files), store the local files in a local folder * to be submitted later. * * @param assignId Assignment ID. * @param folderName Name of the plugin folder. Must be unique (both in submission and feedback plugins). * @param files List of files. * @param userId User ID. If not defined, site's current user. * @param siteId Site ID. If not defined, current site. * @return Promise resolved if success, rejected otherwise. */ async storeSubmissionFiles( assignId: number, folderName: string, files: (CoreWSExternalFile | FileEntry)[], userId?: number, siteId?: string, ): Promise<CoreFileUploaderStoreFilesResult> { // Get the folder where to store the files. const folderPath = await AddonModAssignOffline.instance.getSubmissionPluginFolder(assignId, folderName, userId, siteId); return CoreFileUploader.instance.storeFilesToUpload(folderPath, files); } /** * Upload a file to a draft area. If the file is an online file it will be downloaded and then re-uploaded. * * @param assignId Assignment ID. * @param file Online file or local FileEntry. * @param itemId Draft ID to use. Undefined or 0 to create a new draft ID. * @param siteId Site ID. If not defined, current site. * @return Promise resolved with the itemId. */ uploadFile(assignId: number, file: CoreWSExternalFile | FileEntry, itemId?: number, siteId?: string): Promise<number> { return CoreFileUploader.instance.uploadOrReuploadFile(file, itemId, AddonModAssignProvider.COMPONENT, assignId, siteId); } /** * Given a list of files (either online files or local files), upload them to a draft area and return the draft ID. * Online files will be downloaded and then re-uploaded. * If there are no files to upload it will return a fake draft ID (1). * * @param assignId Assignment ID. * @param files List of files. * @param siteId Site ID. If not defined, current site. * @return Promise resolved with the itemId. */ uploadFiles(assignId: number, files: (CoreWSExternalFile | FileEntry)[], siteId?: string): Promise<number> { return CoreFileUploader.instance.uploadOrReuploadFiles(files, AddonModAssignProvider.COMPONENT, assignId, siteId); } /** * Upload or store some files, depending if the user is offline or not. * * @param assignId Assignment ID. * @param folderName Name of the plugin folder. Must be unique (both in submission and feedback plugins). * @param files List of files. * @param offline True if files sould be stored for offline, false to upload them. * @param userId User ID. If not defined, site's current user. * @param siteId Site ID. If not defined, current site. * @return Promise resolved when done. */ uploadOrStoreFiles( assignId: number, folderName: string, files: (CoreWSExternalFile | FileEntry)[], offline = false, userId?: number, siteId?: string, ): Promise<any> { if (offline) { return this.storeSubmissionFiles(assignId, folderName, files, userId, siteId); } return this.uploadFiles(assignId, files, siteId); } } export const AddonModAssignHelper = makeSingleton(AddonModAssignHelperProvider); /** * Assign submission with some calculated data. */ export type AddonModAssignSubmissionFormatted = Omit<AddonModAssignSubmission, 'id' | 'userid' | 'attemptnumber' | 'timecreated' | 'timemodified' | 'status' | 'groupid'> & { id?: number; // Submission id. userid?: number; // Student id. attemptnumber?: number; // Attempt number. timecreated?: number; // Submission creation time. timemodified?: number; // Submission last modified time. status?: string; // Submission status. groupid?: number; // Group id. blindid?: number; // Calculated in the app. Blindid of the user that did the submission. submitid?: number; // Calculated in the app. Userid or blindid of the user that did the submission. userfullname?: string; // Calculated in the app. Full name of the user that did the submission. userprofileimageurl?: string; // Calculated in the app. Avatar of the user that did the submission. manyGroups?: boolean; // Calculated in the app. Whether the user belongs to more than 1 group. noGroups?: boolean; // Calculated in the app. Whether the user doesn't belong to any group. groupname?: string; // Calculated in the app. Name of the group the submission belongs to. }; /** * Assingment subplugins type enabled. */ export type AddonModAssignPluginsEnabled = { type: string; // Plugin type. }[]; /** * Assingment plugin config. */ export type AddonModAssignPluginConfig = {[name: string]: string};