A | B | C | D | E | F | G | H | I | ||
---|---|---|---|---|---|---|---|---|---|---|
1 | Field | Required? | Identifier? | Unique? | Limit | Case sensitive? | Illegal characters | Special character rules | Submission Guidelines | |
2 | Knewton Client ID | Yes | Yes | Yes | N/A | Yes | Double quote (“) | Your integration team will provide this ID for you as part of the build process. | ||
3 | Partner Inventory ID | Yes | Yes | Yes | N/A | Yes | Double quote (“) | You may fill this in with whatever alphanumeric ID you’d like to assign to your Content Inventory. - This ID is equivalent to “graph_id” in the Knewton API. | ||
4 | Superheader | N/A | N/A | N/A | N/A | Yes | Any discrepancy from the template | Every cell in row 3 of the Content Inventory is considered a Superheader. Superheaders group categories of content data (e.g. “Atom Taxons”). - Each Superheader therefore must be placed directly above its corresponding Headers (e.g. the “Atom Taxons” Superheader must be placed directly above every column used to submit an Atom Taxonomy). | ||
5 | Header | N/A | N/A | N/A | N/A | Yes | Any discrepancy from the template For Taxonomies: - Double quote (“) - Colon (:) - Comma (,) | Every cell in row 6 of the Content Inventory is considered a Header. Headers specify what type of content data (e.g. “Atom Name”, “Learning Objective ID”) is contained by the corresponding column of the spreadsheet. | ||
6 | Atom ID | Yes | Yes | Yes | 40,000 (Atoms and Containers total) | Yes | Backslash as last character (\) Double quote (“) | If you think your content will exceed the entity limit, please consult your integration team. We will work with you on a solution. | ||
7 | Atom Name | Yes | 40,000 (Atoms and Containers total) | Yes | Atom names should be in a human-readable format, e.g.,“Chapter 2, Reading Quiz Question 3.” - If you think your content will exceed the entity limit, please consult your integration team. We will work with you on a solution. | |||||
8 | Atom Type | Yes | N/A | Must be one of three values: - Instructional - Assessment - Both | ||||||
9 | Atom URL | N/A | If available, link to the assessment or instruction content. | |||||||
10 | Instructional Text | N/A | If available, include the full instructional text of the Atom here. | |||||||
11 | Question Stem | N/A | If available, include the full text of the Question Stem here. | |||||||
12 | Answer/Choice | N/A | If available, include the full text of the answer or answer choice here. Screenshots, text rendered as images, and other image-based answers cannot be submitted. | |||||||
13 | Correct Answer | N/A | If available, include the correct answer choice or full text of the correct answer itself here. Images cannot be submitted. - Any Correct Answer must accurately reflect your content. | |||||||
14 | Explanation | N/A | If available, the full text of the explanation here. Images cannot be submitted. | |||||||
15 | LO ID | Yes | Yes | N/A | Yes | Tilde (~) Colon (:) Pipe (|) Backslash (\) Backslash (\) last character Comma (,) Double Quote (") | Must be consistently spelled, punctuated, and capitalized. - Short IDs that reflect your content structure (e.g. LO-01, ALG-24, GR7_CH01_LO03) work best. | |||
16 | LO Description | N/A | Yes | Cannot be submitted without corresponding ID. - Must be consistently spelled, punctuated, and capitalized. - Detailed, human-readable descriptions of concrete student learning outcomes work best. | ||||||
17 | LO Type | Yes | There are only three valid values: "REMEMBER", "UNDERSTAND" and "APPLY" | This column is only required for "fact-based" domains/subjects, where students need to learn e.g. facts and definitions as well as demonstrating a skill; if your content is focused on skills (e.g. math), you do not need to use this column. | ||||||
18 | [Atom Taxon] | Yes | 55 per Atom 2,000 unique Taxons total 7 levels per Taxonomy | Yes | Name of the column = Name of the Taxonomy. You own this name. Illegal characters in the Name of the taxonomy: Tilde (~) Colon (:) Pipe (|) Backslash (\) Backslash (\) last character Comma (,) Double Quote (") For the taxon values, a comma (,) is a valid character; it will be escaped in the graph. Double quotes (") and backslashes (\) are illegal. - Must be consistently spelled, punctuated, and capitalized. - If you think your Taxonomies will exceed entity limits, please consult your integration team. We will work with you on a solution. | Pipe (|): Knewton always interprets a pipe as the separation between two levels of the Taxonomy. Tilde (~): Knewton always interprets a tilde as the end of one Taxon value and the start of another Taxon value. Space: Knewton treats spaces within Taxons as distinct characters. If two Taxon values are identical in the Content Inventory, but one contains a space in the middle of it and the other does not, then Knewton will interpret these as two entirely different Taxons. Leading or Trailing Space: Knewton always removes spaces at the start or end of a value when processing Inventories. | Name of the column = Name of the Taxonomy. You own this name. Illegal characters in the Name of the taxonomy: Tilde (~) Colon (:) Pipe (|) Backslash (\) Backslash (\) last character Comma (,) Double Quote (") For the taxon values, a comma (,) is a valid character; it will be escaped in the graph. - Must be consistently spelled, punctuated, and capitalized. - If you think your Taxonomies will exceed entity limits, please consult your integration team. We will work with you on a solution. | |||
19 | Pool Size | N/A | Anything that is not a positive integer | If you are using algorithmic questions, then the value for Pool Size should reflect the number of times an algorithmically generated version of that question can be seen before the question would feel repetitive to a learner. - If you are not using algorithmic questions, then do not include Pool Size in your Content Inventory. | ||||||
20 | Difficulty | N/A | Any character that is not a number between 1 and 3, inclusive | If you have tagged your assessments with difficulty levels, you should normalize these values to a scale of 1-3. This cell should be blank for all instructional content. | ||||||
21 | Recommendable | N/A | Anything that is not "Yes" or "No" | Must have a value of "Yes" or "No". | ||||||
22 | Container ID | Yes | 40,000 (Atoms and Containers total) | Yes | Backslash as last character (\) Double quote (“) | Must be consistently spelled, punctuated, and capitalized for all instances of a given Container ID. - If you think your content will exceed the entity limit, please consult your integration team. We will work with you on a solution. | ||||
23 | Container Name | 40,000 (Atoms and Containers total) | Yes | Cannot be submitted without corresponding ID. - Must be consistently spelled, punctuated, and capitalized for all instances of a given Container name. - If you think your content will exceed the entity limit, please consult your integration team. We will work with you on a solution. | ||||||
24 | Container URL | N/A | Cannot be submitted without corresponding ID. - Container URL must link to the correct assessment or instruction. - Each time a Container appears in the graph, enter the same URL in this field. | |||||||
25 | [Container Taxon] | Yes | 55 per Atom 2,000 unique Taxons total 7 levels per Taxonomy | Yes | Colon (:) Backslash (\) Backslash (\) last character Escaped Comma (,) Double Quote (") | Pipe (|): Knewton always interprets a pipe as the separation between two levels of the Taxonomy. Tilde (~): Knewton always interprets a tilde as the end of one Taxon value and the start of another Taxon value. Space: Knewton treats spaces within Taxons as distinct characters. If two Taxon values are identical in the Content Inventory, but one contains a space in the middle of it and the other does not, then Knewton will interpret these as two entirely different Taxons. Leading or Trailing Space: Knewton always removes spaces at the start or end of a value when processing Inventories. | Name of the column = Name of the Taxonomy. You own this Name. Illegal characters in the Name of the taxonomy: Tilde (~) Colon (:) Pipe (|) Backslash (\) Backslash (\) last character Comma (,) Double Quote (") For the taxon values, a comma (,) is a valid character; it will be escaped in the graph. - Must be consistently spelled, punctuated, and capitalized. - If you think your Taxonomies will exceed entity limits, please consult your integration team. We will work with you on a solution. |