The ability to import question pools offers an individual the ability:

* to move questions from an existing Samigo assessments in a single batch

* to migrate single-section or pool xml files from another system which are translated to Samigo format prior to import

* when coupled with an export question pool feature, the ability to share question pools with others

The goal of this project is to add the import question pool feature to collab source code for use in the larger community as well as local use at MyUCDavis. Success will be measured by proven ability to import a single, Samigo-compliant assessment with all current (as of 8/10/06) question types. Failure to import successfully will elicit an error message.


h1.

 Progress/Status

*[Phase One]:* Code review and prototype importing a single xml Samigo-compliant file. Samigo already features the ability to import a QTI-compliant xml file that meets application-specific metatdata. Phase One success parameters include the successful import of a single-section Samigo-compliant assessment.

*Timeline: _July 24 - August 11; 3 weeks_* *Status: Completed

*

*[Phase Two#codemods]:* Clean up code and port to testing. Remaining code clean up includes error handling and messages. Code will be ported to current collab version and current Davis versions for testing in both environments. Fixes will be completed before porting to Sakai collab QA. Success will be measured by proven ability to import a single, Samigo-compliant assessment with all current (as of 8/10/06) question types in multiple test environments. Failure to import successfully will elicit an error message.

*Estimated timeline: _August 14 - September 8; 4 weeks

_* 
*Revised delivery due to sick leave and svn setup: _August 14 - September 22; 6 weeks_* *Status: In Progress at 90%

*
*Status Update: Code release to Stanford for review on 9/13/06. Awaiting testing and feedback

*

*Phase Three:* Release to collab source code is the final measurement. Major or higher priority fixes reported within 6 months of release are within the scope of this phase.

*Estimated release to collab source code:* _current release estimate is now after the 9/15 sakai v2.3

 release_ 


h1. Sakai Question Pools Documentation


h3. UI Specifications
UI specifications were previously documented at [http://issues.sakaiproject.org/confluence/x/ZTw] in qPools.pdf

Explanation of the navigation and UI were documented in an [email to Marc Brierley|^UI_Design_review.txt], Stanford, on 8/10/06.

*Question Pools

 screenshot*
!qpoo_main.bmp!

*Import Pool screenshot*
!importPool_screen.bmp!


h3. {Code Modifications:codemods}




||Path/File name|| Modification||Purpose||
|samigo-app/src/webapp/

jsf/questionpool/poolList.jsp

|added link with action="importPool"; added new msg values

|Added the Import link to the main Question Pools screen

|
|samigo-app/src/java/org/sakaiproject/

tool/assessment/bundle/AuthorImportExport.properties

|Added import_qp=Import Pool for importing question pools

|text used in importPool.jsp

|
|samigo-app/src/webapp/

jsf/qti/importPool.jsp

|importPool.jsp created

|The jsf file is modeled on importAssessment.jsp for user to browse and upload xml file

|
|samigo-app/src/java/org/sakaiproject/

tool/assessment/bundle/QuestionPoolMessages.properties

|removed duplicate t_addSubpool; added t_importPool

|clean up and added text for poolList.jsp

|
|samigo-app/src/webapp/WEB-INF/faces-config.xml

|Added questionPoolBean to XML Import; changed navigation path for question pool import to qti folder to be consistent with other import files

|added navigation and bean for xml import

|
|samigo-app/src/java/org/sakaiproject/

tool/assessment/ui/bean/qti/XMLImportBean.java

|Added importPoolFromQTI to mirror import assessment function; Added processAsPoolFile to call createImportedQuestionPool

|mirrored functions to assessment calls createImportedQuestionPool

|
|v2.1.x: samigo-app/src/java/org/sakaiproject/

tool/assessment/services/qti/QTIService.java

v2.2.x: samigo-qti/src/java/org/sakaiproject/tool/assessment/services/qti/QTIService.java

|Added createImportedQuestionPool to service

|Calls AuthoringHelper.createImportedQuestionPool; service allows outside connectivity

|
|v2.1.x: samigo-app/src/java/org/sakaiproject/

tool/assessment/qti/helper/AuthoringHelper.java

v2.2.x: samigo-qti/src/java/org/sakaiproject/tool/assessment/qti/helper/AuthoringHelper.java

|Added createImportedQuestionPool; process mirrors createImportedAssessment; calls updateQuestionPool; Exception thrown if import of more than one section is attempted

Does the question pool title need to be unique?

|Reads xml map and assigns values for data entry;fields require testing;

requires additional code for removeAssessment functionality - may affect several more files

|
|v2.1.x: samigo-app/src/java/org/sakaiproject/

tool/assessment/qti/helper/ExtractionHelper.java

v2.2.x: samigo-qti/src/java/org/sakaiproject/tool/assessment/qti/helper/ExtractionHelper.java

|Added updateQuestionPool(QuestionPoolFacade questionpool,Map assessmentMap) to pull additional optional fields from an imported question pool

|Note: these fields are not populated by imported assessments, but are specific to question pools and may be populated with qtimetadata when an export pool function is available in Samigo|