/// <summary> /// Process data returned from a form generated by an instance of this class. Also sets the data model's /// evaluation points field to the total points, computed from the autograding or teacher grading. /// </summary> /// <param name="context"> /// The context within which to process the form data. </param> /// <param name="formData">The collection of information from the form that should be processed.</param> /// <param name="files">Collection of valid files, posted from the request. This may be a subset of the files /// included in the request, as some posted files may have been removed by the application as invalid.</param> /// <remarks> /// <p>Data that does not correspond to expected information is ignored.</p> /// </remarks> /// <exception cref="InvalidFormDataException">Thrown if posted data contains invalid data.</exception> public override void ProcessFormData(RloProcessFormDataContext context, NameValueCollection formData, IDictionary <string, HttpPostedFile> files) { // Do two passes here through all the interactions. This allows detecting any error in the posted data // before making changes to the data model based on posted data AssessmentItemManager.ProcessFormContext = context; LearningDataModel learningDataModel = context.LearningDataModel; // Validate the form data for all interactions. Any validation error throws InvalidFormDataException. foreach (Interaction interaction in learningDataModel.Interactions) { FormDataProcessor processor = m_assessmentItemMgr.GetFormDataProcessor(interaction); // must check that processor is non null, since GetFormDataProcessor() can return null if (processor != null) { processor.ValidateFormData(formData, files); // throws exception if not valid } } // Process the form data. This won't execute if ValidateFormData threw and exception, above. // Keep a running sum the Interaction.Evaluation.Points values to set the page's Points value. float?totalPoints = null; foreach (Interaction interaction in learningDataModel.Interactions) { FormDataProcessor processor = m_assessmentItemMgr.GetFormDataProcessor(interaction); // must check that processor is non null, since GetFormDataProcessor() can return null. // If it is null, any item score associated with this interaction is not totalled into // EvaluationPoints. if (processor != null) { processor.ProcessFormData(formData, files); if (interaction.Evaluation.Points.HasValue) { if (totalPoints.HasValue) { totalPoints += interaction.Evaluation.Points.Value; } else { totalPoints = interaction.Evaluation.Points.Value; } } } } learningDataModel.EvaluationPoints = totalPoints; if (context.View == SessionView.Execute) { SetPageHasBeenAutograded(learningDataModel); } }
/// <summary> /// Gets the processor that can process posted data related to the specified interaction, or <c>null</c> if none. /// </summary> /// <remarks>ProcessFormContext must have been set prior to calling this method. If this /// interaction's InteractionType does not have a value (such as when it represents a rubric or item score /// with no associated assessment) this method returns <c>null</c>. /// </remarks> internal FormDataProcessor GetFormDataProcessor(Interaction interaction) { if (interaction.InteractionType.HasValue) { FormDataProcessor processor = m_formProcessors[interaction.InteractionType.Value]; processor.Interaction = interaction; return(processor); } else { return(null); } }
/// <summary> /// Requests the RloHandler to do whatever is required to exit from the current activity. /// This request may only be issued when the session is in Execute view and is not active -- it is /// either Completed or Abandoned. /// </summary> /// <param name="context">The context within which the command is processed</param> /// <remarks> /// This method should only be called for the <c>SessionView.Execute</c> view. However, /// no checks are done internally to verify this - if this is called with other views, /// unexpected results will occur. /// </remarks> public override void ProcessSessionEnd(RloDataModelContext context) { LearningDataModel learningDataModel = context.LearningDataModel; // Set ExitMode to suspend so that when a student exits the activity it is left in a suspended state. // This way if the activity is reactivated, the student's previous answers are intact. learningDataModel.NavigationRequest.ExitMode = ExitMode.Suspended; // If the page has never been visited, "visit" it. if (!GetPageHasBeenVisited(learningDataModel)) { AssessmentItemManager.DataModelContext = context; // Get the input stream containing the primary file from the resource associated with the // current activity in the session. using (Stream inputStream = context.GetInputStream()) { // find all the assessment items (<IMG> tags that contain the text "mslamrk" as part of the src attribute.) using (HtmlTextReader reader = new HtmlTextReader(inputStream)) { int srcIndex; while (reader.Read()) { if (IsAITag(reader, out srcIndex)) { try { AssessmentItem ai = AssessmentItem.Parse(reader.GetAttributeValue(srcIndex)); AssessmentItemRenderer renderer = AssessmentItemManager.GetRenderer(ai); renderer.TryAddToDataModel(); } catch (FormatException) { // skip this one. } } } } } SetPageHasBeenVisited(learningDataModel); } // If the page has never been autograded, call ProcessSessionEnd on the form data processors if (!GetPageHasBeenAutograded(learningDataModel)) { AssessmentItemManager.ProcessFormContext = new RloProcessFormDataContext(SessionView.Execute, learningDataModel); float?totalPoints = null; foreach (Interaction interaction in learningDataModel.Interactions) { FormDataProcessor processor = m_assessmentItemMgr.GetFormDataProcessor(interaction); // must check that processor is non null, since GetFormDataProcessor() can return null. // If it is null, any item score associated with this interaction is not totalled into // EvaluationPoints. if (processor != null) { processor.ProcessSessionEnd(context); if (interaction.Evaluation.Points.HasValue) { if (totalPoints.HasValue) { totalPoints += interaction.Evaluation.Points; } else { totalPoints = interaction.Evaluation.Points; } } } } learningDataModel.EvaluationPoints = totalPoints; SetPageHasBeenAutograded(learningDataModel); } }