atomic_assessments_import 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +50 -82
  3. data/lib/atomic_assessments_import/csv/converter.rb +3 -1
  4. data/lib/atomic_assessments_import/version.rb +1 -1
  5. metadata +2 -2
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 4da5264007a4f90b2beb7c2237855d31229aac3e7266d8c2c6a47a30d364177b
4
- data.tar.gz: 2d592d63a61a4888c5df9e4c374d68083b91c8db0fbef079330af3417a440912
3
+ metadata.gz: 8835925585b53920707af014ffdb4b2e122329dcfa91cc69e4bde1b49ad6576a
4
+ data.tar.gz: a2036e81017e48fc11b6a2e3f1ecdb36919d0533c3164d0c4253376e1f87754d
5
5
  SHA512:
6
- metadata.gz: f7ee30d1484fbf993757311a0b76f2ddcfa2aa3dffc64b2bfb1ff42e5a02693cf27dad1c42f684bd8659955b8a5306024440ce462a99d37f8dceeb139dcb5d28
7
- data.tar.gz: 514f3ac7e9d57e41cbcac462c3f8d55593e282584ddd827c1851d74008cc4549ef2271e83afa83c76e7a9babc6f867f2815d634bb76ca6f0db5350b4451d4741
6
+ metadata.gz: d6bbfc4462ce067eaafbb4af3a57f31b39c46a4ef1acd4b52a2067cf35791d1a5f54b3176159a373f1885fe6649b600e22a983b0c0ec53dba5d2facc13d38ff7
7
+ data.tar.gz: bef404031f2f7e3bc34d4e292fe88581b2037702f8b5c07c4068568d7c5ea34a2f52d5935355496132d3113b7a400540845e39c4d72fc3e8bf749528402fe55e
data/README.md CHANGED
@@ -1,103 +1,71 @@
1
- # AtomicAssessmentsImports
1
+ # Atomic Assessments Import
2
+
3
+ Import converters for atomic assessments. Currently only CSV multiple choice format is supported by this GEM.
4
+
5
+ For QTI conversion, see:
6
+
7
+ https://github.com/atomicjolt/qti_to_learnosity_converter
2
8
 
3
- Import converters for atomic assessments
4
9
 
5
10
  ## Installation
6
11
 
7
- Install the gem and add to the application's Gemfile by executing:
12
+ To install for standalone use:
13
+
14
+ $ bundle install
8
15
 
9
- $ bundle add atomic_assessments_imports
16
+ To use in another ruby application, install the gem and add to the application's Gemfile by executing:
17
+
18
+ $ bundle add atomic_assessments_import
10
19
 
11
20
  If bundler is not being used to manage dependencies, install the gem by executing:
12
21
 
13
- $ gem install atomic_assessments_imports
22
+ $ gem install atomic_assessments_import
14
23
 
15
- ## Conversion scripts
24
+ ## Standalone conversion scripts
16
25
 
17
26
  Convert a CSV to a learnosity archive:
18
27
 
19
28
  $ bin/convert input.csv output.zip
20
29
 
21
- Convert a CSV to json:
30
+ Convert a CSV to json on standard out:
22
31
 
23
32
  $ bin/convert_to_json input.csv
24
33
 
25
34
  ## CSV input format
26
35
 
27
- CSV Columns:
28
-
29
- ### Question ID
30
- External question id. Importing the same question ID twice will overwrite previous imports
31
- ### Title
32
- Item title
33
- ### Tag: tag_type
34
- Entries in this column represent tag names in type "tag_type". This column can be repeated any number of times with multiple tag types.
35
- ### Question Text
36
- Question stem
37
- ### Question Type
38
- Question type. One of:
39
- - Multiple choice (default)
40
- ### Template
41
- Question type template. One of:
42
- - Standard (default)
43
- - Block layout
44
- - Multiple response
45
- - Block layout multiple response
46
- - Choice matrix
47
- - Choice matrix inline
48
- - Choice matrix labels
49
- "Standard" and "Block layout" are single response question types. The other templates are multiple response.
50
- ### Correct Answer
51
- Correct response option, e.g. "A"
52
- For multiple response questions, use a semicolon separator. e.g. "A;C;D"
53
- ### Option A
54
- Text for option A
55
- ### Option B
56
- Text for option B
57
- ### Option C through Option O
58
- Text for subsequent options
59
- ### Option A Feedback
60
- Feedback for option A
61
- ### Option B Feedback
62
- Feedback for option B
63
- ### Option C Feedback through Option O Feedback
64
- Feedback for subsequent options
65
- ### Scoring Type
66
- Learnosity scoring type. One of:
67
- - Partial Match Per Response (default)
68
- - Partial Match
69
- - Exact Match
70
- ### Shuffle options
71
- Whether to shuffle answers. One of:
72
- - Yes
73
- - No (default)
74
- ### Points
75
- Question points (default 1)
76
- ### General Feedback
77
- General feedback
78
- ### Correct Feedback
79
- Correct feedback
80
- ### Partially Correct Feedback
81
- Partially correct feedback
82
- ### Incorrect Feedback
83
- Incorrect feedback
84
- ### Distractor Rationale
85
- Distractor rationale feedback
86
- ### Stimulus review
87
- Stimulus (review only)
88
- ### Acknowledgements
89
- Acknowledgements
90
- ### Instructor stimulus
91
- Instructor stimulus
92
- ### Sample Answer
93
- Sample answer
94
- ### Description
95
- Item description
96
- ### Alignment URL
97
- URL used to generate standard alignment tags. This column can be repeated.
98
-
99
-
100
-
36
+ All columns are optional execpt "Option A", "Option B", and "Correct Answer".
37
+
38
+ | Column Name | Description |
39
+ |--------------------------------|-------------|
40
+ | 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 |
41
+ | Title | Item title |
42
+ | Question Text | Question stem |
43
+ | Question Type | Currently only supports "Multiple choice" |
44
+ | Template | Question type template. One of: <br />- Standard <br />- Block layout <br />- Multiple response <br />- Block layout multiple response <br />- Choice matrix <br />- Choice matrix inline <br />- Choice matrix labels <br />"Standard" and "Block layout" are single response question types. The other templates are multiple response. The default is "Standard" |
45
+ | Correct Answer | Correct response option, e.g., "A". <br />For multiple response questions, use a semicolon separator, e.g., "A;C;D" |
46
+ | Points | Question points, defaults to 1 |
47
+ | Option A | Text for option A |
48
+ | Option B | Text for option B |
49
+ | Option C | Text for option C |
50
+ | Option [D-O] | Text for subsequent options |
51
+ | Option A Feedback | Feedback for option A |
52
+ | Option B Feedback | Feedback for option B |
53
+ | Option C Feedback | Feedback for option C |
54
+ | Option [D-O] Feedback | Feedback for subsequent options |
55
+ | Scoring Type | Learnosity scoring type. One of: <br />- Partial Match Per Response <br />- Partial Match <br />- Exact Match <br />The default is "Partial Match Per Response" |
56
+ | Shuffle options | Whether to shuffle answers. One of: <br />- Yes <br />- No <br />Default is "No" |
57
+ | General Feedback | General feedback |
58
+ | Correct Feedback | Correct feedback |
59
+ | Partially Correct Feedback| Partially correct feedback |
60
+ | Incorrect Feedback | Incorrect feedback |
61
+ | Distractor Rationale | Distractor rationale feedback |
62
+ | Stimulus review | Stimulus (review only) |
63
+ | Acknowledgements | Acknowledgements |
64
+ | Instructor stimulus | Instructor stimulus |
65
+ | Sample Answer | Sample answer |
66
+ | Description | Item description |
67
+ | 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 |
68
+ | Alignment URL | URL used to generate standard alignment tags. This column can be repeated |
101
69
 
102
70
  ## Development
103
71
 
@@ -107,4 +75,4 @@ To install this gem onto your local machine, run `bundle exec rake install`. To
107
75
 
108
76
  ## Contributing
109
77
 
110
- Bug reports and pull requests are welcome on GitHub at https://github.com/atomicjolt/atomic_assessments_imports.
78
+ Bug reports and pull requests are welcome on GitHub at https://github.com/atomicjolt/atomic_assessments_import.
data/lib/atomic_assessments_import/csv/converter.rb CHANGED
@@ -117,8 +117,10 @@ module AtomicAssessmentsImport
117
117
  tags: tags(row),
118
118
  metadata: {
119
119
  import_date: Time.now.iso8601,
120
+ import_type: "csv",
120
121
  **{
121
- question_id: row["question id"],
122
+ external_id: row["question id"],
123
+ external_id_domain: row["question id"].present? ? "csv" : nil,
122
124
  alignment: alignment_urls(row),
123
125
  }.compact,
124
126
  },
data/lib/atomic_assessments_import/version.rb CHANGED
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module AtomicAssessmentsImport
4
- VERSION = "0.1.0"
4
+ VERSION = "0.2.0"
5
5
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: atomic_assessments_import
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.1.0
4
+ version: 0.2.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Sean Collings
@@ -9,7 +9,7 @@ authors:
9
9
  autorequire:
10
10
  bindir: exe
11
11
  cert_chain: []
12
- date: 2025-02-27 00:00:00.000000000 Z
12
+ date: 2025-03-07 00:00:00.000000000 Z
13
13
  dependencies:
14
14
  - !ruby/object:Gem::Dependency
15
15
  name: activesupport