Summary

With an import question pool feature pending in SmartSite's Tests & Quizzes (Samigo), it is desirable to be able to export instructor's questions from MyUCDavis Quiz Builder in a Saimgo-compliant format to initiate the migration path.

Quiz Builder stores all questions in a single question pool, but gives the instructor an option of organizing subsets of these questions in a collection. In Tests & Quizzes, there is no primary question pool and users are free to organize their questions into pools and subpools as desired. For migration purposes, collections and subpools represent the same concept in two different systems.

Some instructors do not use Quiz Builder collections, so they will need the ability to export their entire question pool. Other instructors use collections heavily and may prefer to export their questions in these smaller, pre-organized sets. Therefore, both Export Question Pool and Export Collection functions will be developed in Quiz Builder to allow instructors to export their questions in either manner.

Phases

• #Design Specification
• #GUI Review
• #Code Functionality
• #Code Review
• #QA Testing
• #Release

Design Specification

The goals for the Quiz Builder question pool export design are as follows:

1. Minimal code changes to Quiz Builder. Since new development is no longer being promoted for faculty, the simplest functionality to achieve the result is desirable.
2. Simple export functionality consistent with the existing export quiz function.
3. The export process must document gains/losses from one system to the other.
4. The export format must be consistent with the current Samigo import requirements.

Faculty who use the existing Edit/Browse Questions and Edit/Browse Collections features are already familiar with Quiz Builder. It's desirable to limit changes to make the new exports easy for faculty to access and use. For faculty who are migrating their Quiz Builder content, a consistent UI and functionality for quiz, question pool or collection exports will minimize the amount of learning required to use these functions.

The export process will inform faculty of any content that will not be exported and question differences between Quiz Builder and Tests & Quizzes. The export process will be as close to a one-button process as possible. Finally, the content must be exported in a format that is readily consumable by Tests & Quizzes, i.e., that requires no modifications by faculty for the import to succeed.

GUI Review: Export Question Pool

The existing default screen for Edit/Browse Questions is the Browse Questions screen which allows the user to select questions from their pool list.

I propose to add a link entitled 'Export Question Pool' beneath the 'Edit Question' and 'Copy Question' under the list of questions. When the user selects this link, a new window will open, similar to the export quiz window. The screen will be titled 'Question Pool Export for username' where the user's first and last name are in place of username. Download instructions appear next, followed by detailed information under Question Pool Export Notes. Details listed will include any media associated with the questions, listing question types that will not be translated (i.e., calculated questions) and how the questions differ between Quiz Builder and Tests & Quizzes.

Pressing the Download button will generate a Samigo-compliant xml file which will be exported to the user's local machine. A separate download in the media listing under Question Pool Export Notes will download a ZIP file with any media files associated with the pool questions.

GUI Review: Export Collection

The existing default screen for Edit/Browse Collections is the New Collection screen which allows the user to create a new collection from their list of questions. After selecting an existing collection, the screen changes to show the name of the collection and to allow additional links Delete Collection and/or Add Collection to Quiz.

I propose to add a link entitled 'Export Collection' to the list of links for an existing collection. When the user selects this link, a new window will open, similar to the export quiz window. The new window will be entitled 'Collection Export: collectionname' where the collection name is displayed in place of collectionname. Download instructions will appear next, followed by detailed information under Collection Export Notes. Details listed will include any media associated with the questions, listing question types that will not be translated (i.e., calculated questions) and how the questions differ between Quiz Builder and Samigo.

Pressing the Download button will generate a Samigo-compliant xml file which will be exported to the user's local machine. A separate download in the media listing under Collection Export Notes will download a ZIP file with any media files associated with the pool questions.

Code Functionality

Currently, the MyUCDavis cms runs on ColdFusion MX 6 with an Oracle database. New code for exporting question pools will use the existing environment and will include ColdFusion code, CF components, and JavaScript. The export file generated via download will be Samigo-compliant XML.

Code modifications to 5 existing files in the directory 'login/CourseManagement/quiz/' is required. No new files are anticipated at this time.

Code Review

Brian Donnelly, or another qualified member of the MyUCDavis team, will perform code review on these file changes.

QA Testing

A test document will be created to allow testers to step through the expected new feature behaviour and function results. Export question pools will be tested as a stand-alone feature and the same test will be used when all parts of the MyUCDavis-Samigo quiz/question pool migration features are accessible. The separate tests for each process encompass the test plan.

Release

The code migration path after code review and QA process are completed follow the existing MyUCDavis code release. Release of this code set may be delayed to coincide with or follow the release of import question pool code in SmartSite.