org.sakaiproject.tool.assessment.services.qti

Class QTIService

java.lang.Object

org.sakaiproject.tool.assessment.services.qti.QTIService

All Implemented Interfaces:

org.sakaiproject.tool.assessment.shared.api.qti.QTIServiceAPI

public class QTIService
extends Object
implements org.sakaiproject.tool.assessment.shared.api.qti.QTIServiceAPI

This service provides translation between database and QTI representations. This is used to import/export IMS QTI format XML, and for web services.

Copyright: Copyright (c) 2005 Sakai

Version:

$Id: QTIService.java 120835 2013-03-06 13:29:53Z azeckoski@unicon.net $

Author:

Ed Smiley esmiley@stanford.edu

Constructor Summary

Constructors

Constructor and Description
QTIService()

Method Summary

Methods

Modifier and Type	Method and Description
org.sakaiproject.tool.assessment.facade.AssessmentFacade	createImportedAssessment(Document document, int qtiVersion) Import an assessment XML document in QTI format, extract & persist the data.
org.sakaiproject.tool.assessment.facade.AssessmentFacade	createImportedAssessment(Document document, int qtiVersion, String unzipLocation) Import an assessment XML document in QTI format, extract & persist the data.
org.sakaiproject.tool.assessment.facade.AssessmentFacade	createImportedAssessment(Document document, int qtiVersion, String unzipLocation, boolean isRespondus, ArrayList failedMatchingQuestions)
org.sakaiproject.tool.assessment.facade.AssessmentFacade	createImportedAssessment(Document document, int qtiVersion, String unzipLocation, String templateId)
org.sakaiproject.tool.assessment.facade.AssessmentFacade	createImportedAssessment(Document document, int qtiVersion, String unzipLocation, String templateId, String siteId)
org.sakaiproject.tool.assessment.facade.AssessmentFacade	createImportedAssessment(String documentPath, int qtiVersion, String siteId) Import an assessment XML document in QTI format, extract & persist the data.
org.sakaiproject.tool.assessment.facade.ItemFacade	createImportedItem(Document document, int qtiVersion) Import an item XML document in QTI format, extract & persist the data.
org.sakaiproject.tool.assessment.facade.QuestionPoolFacade	createImportedQuestionPool(Document document, int qtiVersion) Import an assessment XML document in QTI format, extract & persist the data.
Document	getExportedAssessment(String assessmentId, int qtiVersion) Get an assessment in Document form.
String	getExportedAssessmentAsString(String assessmentId, int qtiVersion) Get an assessment in String form.
Document	getExportedItem(String itemId, int qtiVersion) Get an item in Document form.
Document	getExportedItemBank(String[] itemIds, int qtiVersion) Get an item bank in Document form.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

QTIService

public QTIService()

Method Detail

createImportedAssessment

public org.sakaiproject.tool.assessment.facade.AssessmentFacade createImportedAssessment(Document document,
                                                                                int qtiVersion)

Import an assessment XML document in QTI format, extract & persist the data.

Specified by:

createImportedAssessment in interface org.sakaiproject.tool.assessment.shared.api.qti.QTIServiceAPI

Parameters:

document - the assessment XML document in QTI format

qtiVersion - either QTIVersion.VERSION_1_2 or QTIVersion.VERSION_2_0;

Returns:

a persisted assessment

createImportedAssessment

public org.sakaiproject.tool.assessment.facade.AssessmentFacade createImportedAssessment(Document document,
                                                                                int qtiVersion,
                                                                                String unzipLocation,
                                                                                String templateId)

createImportedAssessment

public org.sakaiproject.tool.assessment.facade.AssessmentFacade createImportedAssessment(Document document,
                                                                                int qtiVersion,
                                                                                String unzipLocation,
                                                                                String templateId,
                                                                                String siteId)

createImportedAssessment

public org.sakaiproject.tool.assessment.facade.AssessmentFacade createImportedAssessment(Document document,
                                                                                int qtiVersion,
                                                                                String unzipLocation)

Import an assessment XML document in QTI format, extract & persist the data.

Parameters:

document - the assessment XML document in QTI format

qtiVersion - either QTIVersion.VERSION_1_2 or QTIVersion.VERSION_2_0;

Returns:

a persisted assessment

createImportedAssessment

public org.sakaiproject.tool.assessment.facade.AssessmentFacade createImportedAssessment(Document document,
                                                                                int qtiVersion,
                                                                                String unzipLocation,
                                                                                boolean isRespondus,
                                                                                ArrayList failedMatchingQuestions)

createImportedAssessment

public org.sakaiproject.tool.assessment.facade.AssessmentFacade createImportedAssessment(String documentPath,
                                                                                int qtiVersion,
                                                                                String siteId)

Import an assessment XML document in QTI format, extract & persist the data.

Specified by:

createImportedAssessment in interface org.sakaiproject.tool.assessment.shared.api.qti.QTIServiceAPI

Parameters:

documentPath - the pathname to a file with the assessment XML document in QTI format

qtiVersion - either 1=QTI VERSION 1.2 or 2=QTI Version 2.0

siteId - the site the assessment will be associated with

Returns:

a persisted assessment

createImportedQuestionPool

public org.sakaiproject.tool.assessment.facade.QuestionPoolFacade createImportedQuestionPool(Document document,
                                                                                    int qtiVersion)

Import an assessment XML document in QTI format, extract & persist the data. import process assumes assessment structure, not objectbank or itembank based on usage in other potential migration systems, Respondus, BlackBoard, etc. QTI version 2.x will probably focus on content packaging for question pools

Parameters:

document - the assessment XML document in QTI format

qtiVersion - QTIVersion.VERSION_1_2;

Returns:

a persisted assessment

createImportedItem

public org.sakaiproject.tool.assessment.facade.ItemFacade createImportedItem(Document document,
                                                                    int qtiVersion)

Import an item XML document in QTI format, extract & persist the data.

Specified by:

createImportedItem in interface org.sakaiproject.tool.assessment.shared.api.qti.QTIServiceAPI

Parameters:

document - the item XML document in QTI format

qtiVersion - either QTIVersion.VERSION_1_2 or QTIVersion.VERSION_2_0;

Returns:

a persisted item

getExportedAssessment

public Document getExportedAssessment(String assessmentId,
                             int qtiVersion)

Get an assessment in Document form. Note: this service requires a Faces context.

Specified by:

getExportedAssessment in interface org.sakaiproject.tool.assessment.shared.api.qti.QTIServiceAPI

Parameters:

assessmentId - the assessment's Id

qtiVersion - either QTIVersion.VERSION_1_2 or QTIVersion.VERSION_2_0;

Returns:

the Document with the assessment data

getExportedAssessmentAsString

public String getExportedAssessmentAsString(String assessmentId,
                                   int qtiVersion)

Get an assessment in String form. Note: this service requires a Faces context.

Specified by:

getExportedAssessmentAsString in interface org.sakaiproject.tool.assessment.shared.api.qti.QTIServiceAPI

Parameters:

assessmentId - the assessment's Id

qtiVersion - either 1=QTI VERSION 1.2 or 2=QTI Version 2.0

Returns:

the Document with the assessment data

getExportedItem

public Document getExportedItem(String itemId,
                       int qtiVersion)

Get an item in Document form. Note: this service requires a Faces context.

Specified by:

getExportedItem in interface org.sakaiproject.tool.assessment.shared.api.qti.QTIServiceAPI

Parameters:

itemId - the item's Id

qtiVersion - either QTIVersion.VERSION_1_2 or QTIVersion.VERSION_2_0;

Returns:

the Document with the assessment data

getExportedItemBank

public Document getExportedItemBank(String[] itemIds,
                           int qtiVersion)

Get an item bank in Document form. Note: this service requires a Faces context.

Specified by:

getExportedItemBank in interface org.sakaiproject.tool.assessment.shared.api.qti.QTIServiceAPI

Parameters:

itemIds - an array of item ids

qtiVersion - either QTIVersion.VERSION_1_2 or QTIVersion.VERSION_2_0;

Returns:

the Document with the item bank