/** * OLAT - Online Learning and Training<br> * http://www.olat.org * <p> * Licensed under the Apache License, Version 2.0 (the "License"); <br> * you may not use this file except in compliance with the License.<br> * You may obtain a copy of the License at * <p> * http://www.apache.org/licenses/LICENSE-2.0 * <p> * Unless required by applicable law or agreed to in writing,<br> * software distributed under the License is distributed on an "AS IS" BASIS, <br> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. <br> * See the License for the specific language governing permissions and <br> * limitations under the License. * <p> * Copyright (c) since 2004 at Multimedia- & E-Learning Services (MELS),<br> * University of Zurich, Switzerland. * <hr> * <a href="http://www.openolat.org"> * OpenOLAT - Online Learning and Training</a><br> * This file has been modified by the OpenOLAT community. Changes are licensed * under the Apache 2.0 license as the original file. */ package org.olat.course.nodes; import java.io.File; import java.io.IOException; import java.util.ArrayList; import java.util.List; import java.util.Locale; import java.util.zip.ZipOutputStream; import org.olat.basesecurity.BaseSecurityManager; import org.olat.basesecurity.SecurityGroup; import org.olat.core.gui.UserRequest; import org.olat.core.gui.components.stack.StackedController; import org.olat.core.gui.control.Controller; import org.olat.core.gui.control.WindowControl; import org.olat.core.gui.control.generic.tabbable.TabbableController; import org.olat.core.gui.translator.PackageTranslator; import org.olat.core.id.Identity; import org.olat.core.id.OLATResourceable; import org.olat.core.logging.OLog; import org.olat.core.logging.Tracing; import org.olat.core.util.Util; import org.olat.core.util.resource.OresHelper; import org.olat.course.ICourse; import org.olat.course.assessment.AssessmentManager; import org.olat.course.editor.CourseEditorEnv; import org.olat.course.editor.NodeEditController; import org.olat.course.editor.StatusDescription; import org.olat.course.nodes.iq.IQEditController; import org.olat.course.nodes.iq.IQRunController; import org.olat.course.nodes.iq.IQUIFactory; import org.olat.course.properties.CoursePropertyManager; import org.olat.course.repository.ImportReferencesController; import org.olat.course.run.environment.CourseEnvironment; import org.olat.course.run.navigation.NodeRunConstructionResult; import org.olat.course.run.userview.NodeEvaluation; import org.olat.course.run.userview.UserCourseEnvironment; import org.olat.course.statistic.StatisticResourceOption; import org.olat.course.statistic.StatisticResourceResult; import org.olat.group.BusinessGroup; import org.olat.ims.qti.QTIResultManager; import org.olat.ims.qti.export.QTIExportFormatter; import org.olat.ims.qti.export.QTIExportFormatterCSVType3; import org.olat.ims.qti.export.QTIExportManager; import org.olat.ims.qti.process.AssessmentInstance; import org.olat.ims.qti.statistics.QTIStatisticResourceResult; import org.olat.ims.qti.statistics.QTIStatisticSearchParams; import org.olat.ims.qti.statistics.ui.QTI12StatisticsToolController; import org.olat.modules.ModuleConfiguration; import org.olat.repository.RepositoryEntry; import org.olat.repository.RepositoryEntryImportExport; import org.olat.repository.RepositoryManager; /** * Initial Date: Feb 9, 2004 * @author Mike Stock Comment: * @author BPS (<a href="http://www.bps-system.de/">BPS Bildungsportal Sachsen GmbH</a>) */ public class IQSURVCourseNode extends AbstractAccessableCourseNode implements QTICourseNode { private static final long serialVersionUID = 1672009454920536416L; private static final OLog log = Tracing.createLoggerFor(IQSURVCourseNode.class); private static final String PACKAGE = Util.getPackageName(IQSURVCourseNode.class); private static final String TYPE = "iqsurv"; /** category that is used to persist the node properties */ public static final String PROPERTY_CATEGORY = "iqsu"; private static final String PACKAGE_IQ = Util.getPackageName(IQRunController.class); /** * Constructor to create a course node of type IMS QTI. */ public IQSURVCourseNode() { super(TYPE); updateModuleConfigDefaults(true); } /** * @see org.olat.course.nodes.CourseNode#createEditController(org.olat.core.gui.UserRequest, * org.olat.core.gui.control.WindowControl, org.olat.course.ICourse) */ @Override public TabbableController createEditController(UserRequest ureq, WindowControl wControl, StackedController stackPanel, ICourse course, UserCourseEnvironment euce) { TabbableController childTabCntrllr = IQUIFactory.createIQSurveyEditController(ureq, wControl, stackPanel, course, this, course.getCourseEnvironment().getCourseGroupManager(), euce); CourseNode chosenNode = course.getEditorTreeModel().getCourseNode(euce.getCourseEditorEnv().getCurrentCourseNodeId()); return new NodeEditController(ureq, wControl, course.getEditorTreeModel(), course, chosenNode, course.getCourseEnvironment() .getCourseGroupManager(), euce, childTabCntrllr); } /** * @see org.olat.course.nodes.CourseNode#createNodeRunConstructionResult(org.olat.core.gui.UserRequest, * org.olat.core.gui.control.WindowControl, * org.olat.course.run.userview.UserCourseEnvironment, * org.olat.course.run.userview.NodeEvaluation) */ public NodeRunConstructionResult createNodeRunConstructionResult(UserRequest ureq, WindowControl wControl, UserCourseEnvironment userCourseEnv, NodeEvaluation ne, String nodecmd) { Controller controller = IQUIFactory.createIQSurveyRunController(ureq, wControl, userCourseEnv, ne, this); Controller ctrl = TitledWrapperHelper.getWrapper(ureq, wControl, controller, this, "o_iqsurv_icon"); return new NodeRunConstructionResult(ctrl); } @Override public List<Controller> createAssessmentTools(UserRequest ureq, WindowControl wControl, CourseEnvironment courseEnv, AssessmentToolOptions options) { List<Controller> tools = new ArrayList<>(); tools.add(new QTI12StatisticsToolController(ureq, wControl, courseEnv, options, this)); return tools; } @Override public StatisticResourceResult createStatisticNodeResult(UserRequest ureq, WindowControl wControl, UserCourseEnvironment userCourseEnv, StatisticResourceOption options) { Long courseId = userCourseEnv.getCourseEnvironment().getCourseResourceableId(); OLATResourceable courseOres = OresHelper.createOLATResourceableInstance("CourseModule", courseId); List<SecurityGroup> limitMemberships = new ArrayList<>(); if(options.getParticipantsCourse() != null) { limitMemberships.add(options.getParticipantsCourse().getParticipantGroup()); } if(options.getParticipantsGroups() != null && !options.getParticipantsGroups().isEmpty()) { for(BusinessGroup group:options.getParticipantsGroups()) { limitMemberships.add(group.getPartipiciantGroup()); } } QTIStatisticSearchParams searchParams = new QTIStatisticSearchParams(courseOres.getResourceableId(), getIdent()); searchParams.setLimitToSecGroups(limitMemberships); QTIStatisticResourceResult result = new QTIStatisticResourceResult(courseOres, this, searchParams); return result; } /** * @see org.olat.course.nodes.CourseNode#isConfigValid() */ public StatusDescription isConfigValid() { /* * first check the one click cache */ if (oneClickStatusCache != null) { return oneClickStatusCache[0]; } boolean isValid = getModuleConfiguration().get(IQEditController.CONFIG_KEY_REPOSITORY_SOFTKEY) != null; if (isValid) { /* * COnfiugre an IQxxx BB with a repo entry, do not publish this BB, mark * IQxxx as deleted, remove repo entry, undelete BB IQxxx and bang you * enter this if. */ Object repoEntry = IQEditController.getIQReference(getModuleConfiguration(), false); if (repoEntry == null) { isValid = false; IQEditController.removeIQReference(getModuleConfiguration()); } } StatusDescription sd = StatusDescription.NOERROR; if (!isValid) { String shortKey = "error.surv.undefined.short"; String longKey = "error.surv.undefined.long"; String[] params = new String[] { this.getShortTitle() }; String translPackage = Util.getPackageName(IQEditController.class); sd = new StatusDescription(StatusDescription.ERROR, shortKey, longKey, params, translPackage); sd.setDescriptionForUnit(getIdent()); // set which pane is affected by error sd.setActivateableViewIdentifier(IQEditController.PANE_TAB_IQCONFIG_SURV); } return sd; } /** * @see org.olat.course.nodes.CourseNode#isConfigValid(org.olat.course.run.userview.UserCourseEnvironment) */ public StatusDescription[] isConfigValid(CourseEditorEnv cev) { oneClickStatusCache = null; // only here we know which translator to take for translating condition // error messages String translatorStr = Util.getPackageName(IQEditController.class); List<StatusDescription> sds = isConfigValidWithTranslator(cev, translatorStr, getConditionExpressions()); oneClickStatusCache = StatusDescriptionHelper.sort(sds); return oneClickStatusCache; } /** * @see org.olat.course.nodes.CourseNode#getReferencedRepositoryEntry() */ public RepositoryEntry getReferencedRepositoryEntry() { // ",false" because we do not want to be strict, but just indicate whether // the reference still exists or not RepositoryEntry re = IQEditController.getIQReference(getModuleConfiguration(), false); return re; } /** * @see org.olat.course.nodes.CourseNode#needsReferenceToARepositoryEntry() */ public boolean needsReferenceToARepositoryEntry() { return true; } /** * @see org.olat.course.nodes.CourseNode#informOnDelete(org.olat.core.gui.UserRequest, * org.olat.course.ICourse) */ public String informOnDelete(Locale locale, ICourse course) { // Check if there are qtiresults for this questionnaire String repositorySoftKey = (String) getModuleConfiguration().get(IQEditController.CONFIG_KEY_REPOSITORY_SOFTKEY); Long repKey = RepositoryManager.getInstance().lookupRepositoryEntryBySoftkey(repositorySoftKey, true).getKey(); if (QTIResultManager.getInstance().hasResultSets(course.getResourceableId(), this.getIdent(), repKey)) { return new PackageTranslator( PACKAGE_IQ, locale).translate("info.nodedelete"); } return null; } /** * @see org.olat.course.nodes.CourseNode#cleanupOnDelete(org.olat.course.ICourse) */ public void cleanupOnDelete(ICourse course) { CoursePropertyManager pm = course.getCourseEnvironment().getCoursePropertyManager(); // 1) Delete all properties: attempts pm.deleteNodeProperties(this, null); // 2) Delete all qtiresults for this node String repositorySoftKey = (String) getModuleConfiguration().get(IQEditController.CONFIG_KEY_REPOSITORY_SOFTKEY); RepositoryEntry re = RepositoryManager.getInstance().lookupRepositoryEntryBySoftkey(repositorySoftKey, false); if(re != null) { QTIResultManager.getInstance().deleteAllResults(course.getResourceableId(), getIdent(), re.getKey()); } } @Override public boolean archiveNodeData(Locale locale, ICourse course, ArchiveOptions options, ZipOutputStream exportStream, String charset) { QTIExportManager qem = QTIExportManager.getInstance(); String repositorySoftKey = (String) getModuleConfiguration().get(IQEditController.CONFIG_KEY_REPOSITORY_SOFTKEY); RepositoryEntry re = RepositoryManager.getInstance().lookupRepositoryEntryBySoftkey(repositorySoftKey, true); QTIExportFormatter qef = new QTIExportFormatterCSVType3(locale, null,"\t", "\"", "\\", "\r\n", false); try { return qem.selectAndExportResults(qef, course.getResourceableId(), getShortTitle(), getIdent(), re, exportStream, ".xls"); } catch (IOException e) { log.error("", e); return false; } } /** * @see org.olat.course.nodes.GenericCourseNode#exportNode(java.io.File, * org.olat.course.ICourse) */ public void exportNode(File exportDirectory, ICourse course) { String repositorySoftKey = (String) getModuleConfiguration().get(IQEditController.CONFIG_KEY_REPOSITORY_SOFTKEY); if (repositorySoftKey == null) return; // nothing to export // self healing RepositoryEntry re = RepositoryManager.getInstance().lookupRepositoryEntryBySoftkey(repositorySoftKey, false); if (re == null) { // nothing to export, but correct the module configuration IQEditController.removeIQReference(getModuleConfiguration()); return; } File fExportDirectory = new File(exportDirectory, getIdent()); fExportDirectory.mkdirs(); RepositoryEntryImportExport reie = new RepositoryEntryImportExport(re, fExportDirectory); reie.exportDoExport(); } /** * @see org.olat.course.nodes.GenericCourseNode#importNode(java.io.File, * org.olat.course.ICourse, org.olat.core.gui.UserRequest, * org.olat.core.gui.control.WindowControl) */ public Controller importNode(File importDirectory, ICourse course, boolean unattendedImport, UserRequest ureq, WindowControl wControl) { File importSubdir = new File(importDirectory, getIdent()); RepositoryEntryImportExport rie = new RepositoryEntryImportExport(importSubdir); if (!rie.anyExportedPropertiesAvailable()) return null; // do import referenced repository entries if (unattendedImport) { Identity admin = BaseSecurityManager.getInstance().findIdentityByName("administrator"); ImportReferencesController.doImport(rie, this, ImportReferencesController.IMPORT_SURVEY, true, admin); return null; } else { return new ImportReferencesController(ureq, wControl, this, ImportReferencesController.IMPORT_SURVEY, rie); } } /** * @see org.olat.course.nodes.CourseNode#createInstanceForCopy() */ public CourseNode createInstanceForCopy() { CourseNode copyInstance = super.createInstanceForCopy(); IQEditController.removeIQReference(copyInstance.getModuleConfiguration()); return copyInstance; } /** * Update the module configuration to have all mandatory configuration flags * set to usefull default values * * @param isNewNode true: an initial configuration is set; false: upgrading * from previous node configuration version, set default to maintain * previous behaviour */ public void updateModuleConfigDefaults(boolean isNewNode) { ModuleConfiguration config = getModuleConfiguration(); if (isNewNode) { // add default module configuration config.set(IQEditController.CONFIG_KEY_ENABLEMENU, new Boolean(true)); config.set(IQEditController.CONFIG_KEY_SEQUENCE, AssessmentInstance.QMD_ENTRY_SEQUENCE_ITEM); config.set(IQEditController.CONFIG_KEY_TYPE, AssessmentInstance.QMD_ENTRY_TYPE_SURVEY); config.set(IQEditController.CONFIG_KEY_SUMMARY, AssessmentInstance.QMD_ENTRY_SUMMARY_NONE); // not used in survey } } /** * @see org.olat.course.nodes.AssessableCourseNode#getUserAttempts(org.olat.course.run.userview.UserCourseEnvironment) */ public Integer getUserAttempts(UserCourseEnvironment userCourseEnvironment) { AssessmentManager am = userCourseEnvironment.getCourseEnvironment().getAssessmentManager(); Identity mySelf = userCourseEnvironment.getIdentityEnvironment().getIdentity(); Integer userAttemptsValue = am.getNodeAttempts(this, mySelf); return userAttemptsValue; } /** * @see org.olat.course.nodes.AssessableCourseNode#hasAttemptsConfigured() */ public boolean hasAttemptsConfigured() { return true; } /** * @see org.olat.course.nodes.AssessableCourseNode#updateUserAttempts(java.lang.Integer, * org.olat.course.run.userview.UserCourseEnvironment, * org.olat.core.id.Identity) */ public void updateUserAttempts(Integer userAttempts, UserCourseEnvironment userCourseEnvironment, Identity coachingIdentity) { if (userAttempts != null) { AssessmentManager am = userCourseEnvironment.getCourseEnvironment().getAssessmentManager(); Identity mySelf = userCourseEnvironment.getIdentityEnvironment().getIdentity(); am.saveNodeAttempts(this, coachingIdentity, mySelf, userAttempts); } } /** * @see org.olat.course.nodes.AssessableCourseNode#incrementUserAttempts(org.olat.course.run.userview.UserCourseEnvironment) */ public void incrementUserAttempts(UserCourseEnvironment userCourseEnvironment) { AssessmentManager am = userCourseEnvironment.getCourseEnvironment().getAssessmentManager(); Identity mySelf = userCourseEnvironment.getIdentityEnvironment().getIdentity(); am.incrementNodeAttempts(this, mySelf, userCourseEnvironment); } }