Atomic Assessments Import
Import converters for atomic assessments. Currently only CSV multiple choice format is supported by this GEM.
For QTI conversion, see:
https://github.com/atomicjolt/qti_to_learnosity_converter
Installation
To install for standalone use:
$ bundle install
To use in another ruby application, install the gem and add to the application's Gemfile by executing:
$ bundle add atomic_assessments_import
If bundler is not being used to manage dependencies, install the gem by executing:
$ gem install atomic_assessments_import
Standalone conversion scripts
Convert a CSV to a learnosity archive:
$ bin/convert input.csv output.zip
Convert a CSV to json on standard out:
$ bin/convert_to_json input.csv
CSV input format
All columns are optional execpt "Option A", "Option B", and "Correct Answer".
| Column Name | Description |
|---|---|
| Question ID | External question id. Importing the same question ID twice into a course will overwrite previous imports. Omit this to generate a random id |
| Title | Item title |
| Question Text | Question stem |
| Question Type | Currently only supports "Multiple choice" |
| Template | Question type template. One of: - Standard - Block layout - Multiple response - Block layout multiple response - Choice matrix - Choice matrix inline - Choice matrix labels "Standard" and "Block layout" are single response question types. The other templates are multiple response. The default is "Standard" |
| Correct Answer | Correct response option, e.g., "A". For multiple response questions, use a semicolon separator, e.g., "A;C;D" |
| Points | Question points, defaults to 1 |
| Option A | Text for option A |
| Option B | Text for option B |
| Option C | Text for option C |
| Option [D-O] | Text for subsequent options |
| Option A Feedback | Feedback for option A |
| Option B Feedback | Feedback for option B |
| Option C Feedback | Feedback for option C |
| Option [D-O] Feedback | Feedback for subsequent options |
| Scoring Type | Learnosity scoring type. One of: - Partial Match Per Response - Partial Match - Exact Match The default is "Partial Match Per Response" |
| Shuffle options | Whether to shuffle answers. One of: - Yes - No Default is "No" |
| General Feedback | General feedback |
| Correct Feedback | Correct feedback |
| Partially Correct Feedback | Partially correct feedback |
| Incorrect Feedback | Incorrect feedback |
| Distractor Rationale | Distractor rationale feedback |
| Stimulus review | Stimulus (review only) |
| Acknowledgements | Acknowledgements |
| Instructor stimulus | Instructor stimulus |
| Sample Answer | Sample answer |
| Description | Item description |
| Tag: tag_type | Entries in this column represent tag names in type "tag_type". This column can be repeated any number of times with the same or multiple tag types |
| Alignment URL | URL used to generate standard alignment tags. This column can be repeated |
Development
After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/atomicjolt/atomic_assessments_import.