diff --git a/source/_images/educator_how_tos/ctag_add_delete_unit_page.png b/source/_images/educator_how_tos/ctag_add_delete_unit_page.png new file mode 100644 index 000000000..39cd617da Binary files /dev/null and b/source/_images/educator_how_tos/ctag_add_delete_unit_page.png differ diff --git a/source/_images/educator_how_tos/ctag_course_tag_step1a_dropdown.png b/source/_images/educator_how_tos/ctag_course_tag_step1a_dropdown.png new file mode 100644 index 000000000..94b4ebb48 Binary files /dev/null and b/source/_images/educator_how_tos/ctag_course_tag_step1a_dropdown.png differ diff --git a/source/_images/educator_how_tos/ctag_course_tag_step8_card.png b/source/_images/educator_how_tos/ctag_course_tag_step8_card.png new file mode 100644 index 000000000..7ce827914 Binary files /dev/null and b/source/_images/educator_how_tos/ctag_course_tag_step8_card.png differ diff --git a/source/_images/educator_how_tos/taxonomies_import_successful.png b/source/_images/educator_how_tos/taxonomies_import_successful.png new file mode 100644 index 000000000..226741e4e Binary files /dev/null and b/source/_images/educator_how_tos/taxonomies_import_successful.png differ diff --git a/source/_images/educator_how_tos/taxonomies_new_name_description.png b/source/_images/educator_how_tos/taxonomies_new_name_description.png new file mode 100644 index 000000000..98e3cbfdc Binary files /dev/null and b/source/_images/educator_how_tos/taxonomies_new_name_description.png differ diff --git a/source/_images/educator_how_tos/taxonomies_new_name_prompt.png b/source/_images/educator_how_tos/taxonomies_new_name_prompt.png new file mode 100644 index 000000000..742ee24c6 Binary files /dev/null and b/source/_images/educator_how_tos/taxonomies_new_name_prompt.png differ diff --git a/source/_images/educator_how_tos/taxonomies_studio_home.png b/source/_images/educator_how_tos/taxonomies_studio_home.png new file mode 100644 index 000000000..aa96c80a8 Binary files /dev/null and b/source/_images/educator_how_tos/taxonomies_studio_home.png differ diff --git a/source/_images/educator_how_tos/taxonomies_three_dot_export.png b/source/_images/educator_how_tos/taxonomies_three_dot_export.png new file mode 100644 index 000000000..f7cf7486b Binary files /dev/null and b/source/_images/educator_how_tos/taxonomies_three_dot_export.png differ diff --git a/source/_images/educator_how_tos/taxonomies_view_single_taxonomy_tags.png b/source/_images/educator_how_tos/taxonomies_view_single_taxonomy_tags.png new file mode 100644 index 000000000..e7807b3ea Binary files /dev/null and b/source/_images/educator_how_tos/taxonomies_view_single_taxonomy_tags.png differ diff --git a/source/_images/educator_how_tos/taxonomy-csv-export.png b/source/_images/educator_how_tos/taxonomy-csv-export.png new file mode 100644 index 000000000..a2da61fbd Binary files /dev/null and b/source/_images/educator_how_tos/taxonomy-csv-export.png differ diff --git a/source/_images/educator_how_tos/taxonomy-csv-modify-tag.png b/source/_images/educator_how_tos/taxonomy-csv-modify-tag.png new file mode 100644 index 000000000..ced051dc1 Binary files /dev/null and b/source/_images/educator_how_tos/taxonomy-csv-modify-tag.png differ diff --git a/source/_images/educator_how_tos/taxonomy-reimport-diff.png b/source/_images/educator_how_tos/taxonomy-reimport-diff.png new file mode 100644 index 000000000..d6b2ec7f3 Binary files /dev/null and b/source/_images/educator_how_tos/taxonomy-reimport-diff.png differ diff --git a/source/_images/educator_how_tos/taxonomy-three-dot-reimport.png b/source/_images/educator_how_tos/taxonomy-three-dot-reimport.png new file mode 100644 index 000000000..2d9a7f28c Binary files /dev/null and b/source/_images/educator_how_tos/taxonomy-three-dot-reimport.png differ diff --git a/source/_images/educator_how_tos/taxonomy_assign_org.png b/source/_images/educator_how_tos/taxonomy_assign_org.png new file mode 100644 index 000000000..4b45c60a0 Binary files /dev/null and b/source/_images/educator_how_tos/taxonomy_assign_org.png differ diff --git a/source/_images/educator_how_tos/taxonomy_manage_org.png b/source/_images/educator_how_tos/taxonomy_manage_org.png new file mode 100644 index 000000000..fd47e1e31 Binary files /dev/null and b/source/_images/educator_how_tos/taxonomy_manage_org.png differ diff --git a/source/_images/educator_how_tos/taxonomy_tag_drawer.png b/source/_images/educator_how_tos/taxonomy_tag_drawer.png new file mode 100644 index 000000000..f08e63b52 Binary files /dev/null and b/source/_images/educator_how_tos/taxonomy_tag_drawer.png differ diff --git a/source/educators/concepts/advanced_features/why_taxonomy_tag_id.rst b/source/educators/concepts/advanced_features/why_taxonomy_tag_id.rst new file mode 100644 index 000000000..0b5fdc06b --- /dev/null +++ b/source/educators/concepts/advanced_features/why_taxonomy_tag_id.rst @@ -0,0 +1,91 @@ +.. _tag-ids-for-taxonomy-import: + +Why does each tag need an ID when importing a taxonomy? +####################################################### + +When creating a taxonomy via import, or updating one via re-import, the “id” +column is required. In addition, it must be unique for every row. There are two +reasons why such IDs are required. + +Renaming tags +************* + +First, the IDs allow you to rename tags. When you upload a new version of the +taxonomy, the IDs are compared to determine when a tag has been renamed or +deleted. + +For example, if you uploaded this taxonomy and used it to tag content in your +courses: + ++---------------+--------------------------------------------------------------+ +| **ID** | **Value** | ++---------------+--------------------------------------------------------------+ +| 1 | *Untied* States | ++---------------+--------------------------------------------------------------+ +| 3 | *Canadia* | ++---------------+--------------------------------------------------------------+ + +Then you fixed the spelling to create this new version of the taxonomy, and re-imported it: + ++---------------+--------------------------------------------------------------+ +| **ID** | **Value** | ++---------------+--------------------------------------------------------------+ +| 1 | United States | ++---------------+--------------------------------------------------------------+ +| 17 | Canada | ++---------------+--------------------------------------------------------------+ + +You would find that your "*Untied* States" content would be properly tagged as +"United States", while your "*Canadia*" content would be entirely untagged. Why? + +Because the ID of the first tag is the same (1), any content that was tagged +with “*Untied* States” will now be fixed to show “United States”. But because the +ID of the second tag has been changed, it is treated as a totally new tag - all +instances of the *"Canadia"* tag will be deleted, and a new “Canada” tag will be +created in the taxonomy, but no content will have that tag yet. + +By keeping the ID the same (or not), you can control what will happen with new +versions of the taxonomy - adding, renaming, moving, and deleting tags as +needed. (Note that during the re-import workflow, you'll get a chance to preview +what changes will be applied before you finalize the update. That's a good time +to double-check that the right thing - rename or delete - is about to happen.) + +If in doubt, a good rule of thumb is to **never change the ID once a tag has been +created**, unless you're certain you want to delete all occurrences of that tag +and re-create a new similar tag from scratch. + +Matching external systems/taxonomies +************************************ + +Secondly, the IDs can be used to keep your taxonomy in sync with an external +system. + +For example, you could have an airports taxonomy: + ++---------------+--------------------------------------------------------------+ +| **ID** | **Value** | ++---------------+--------------------------------------------------------------+ +| ORD | Chicago O'Hare International Airport | ++---------------+--------------------------------------------------------------+ +| LAS | Harry Reid International Airport | ++---------------+--------------------------------------------------------------+ +| LAX | Los Angeles International Airport | ++---------------+--------------------------------------------------------------+ +| BOS | Boston Logan International Airport | ++---------------+--------------------------------------------------------------+ + +In this case, using the airport codes as the ID makes it easy to align the tags +with other systems that reference airports, accounting for the fact that some +airport names may be different (e.g. the Boston airport may be called “General +Edward Lawrence Logan International Airport” or “Logan Airport”; the “Harry Reid +International Airport in Las Vegas” was previously known as “McCarran +International Airport”; etc.) + +As another example, learning outcome standards often have unique identifiers +assigned to individual concepts. For example, the mathematics skill “`Extend The +Properties Of Exponents To Rational Exponents`_” has the ID “HS.N-RN.A.1“, which +can be used to cross-reference it across various systems and publications. If +you are creating a taxonomy related to learning outcomes, you can use these +unique identifiers as the IDs. + +.. _Extend The Properties Of Exponents To Rational Exponents: https://tools.achievethecore.org/coherence-map/HS/N/118/633/632/ \ No newline at end of file diff --git a/source/educators/how-tos/content-tagging-how-tos/Create_flat_taxonomy_by_uploading_CSV.rst b/source/educators/how-tos/content-tagging-how-tos/Create_flat_taxonomy_by_uploading_CSV.rst index d279411a0..92d9fe0f7 100644 --- a/source/educators/how-tos/content-tagging-how-tos/Create_flat_taxonomy_by_uploading_CSV.rst +++ b/source/educators/how-tos/content-tagging-how-tos/Create_flat_taxonomy_by_uploading_CSV.rst @@ -1,28 +1,46 @@ +.. _create-flat-taxonomy: + ######################################### Create a flat taxonomy by uploading a CSV ######################################### .. tags:: educator, how-to -Tags that can be applied to content are organized into hierarchical taxonomies. Currently, the only way to create or modify a taxonomy is by uploading a CSV or JSON file. +Tags that can be applied to content are organized into hierarchical taxonomies. +Currently, the only way to create or modify a taxonomy is by uploading a CSV or +JSON file. -The simplest type of taxonomy is a flat taxonomy that doesn’t have any hierarchy. For example, if you want to tag the “difficulty” of problems as either “Easy”, “Medium”, or “Hard”, you could do that by creating a flat taxonomy. Here’s how to do that: +The simplest type of taxonomy is a flat taxonomy that doesn't have any +hierarchy. For example, if you want to tag the “difficulty” of problems as +either “Easy”, “Medium”, or “Hard”, you could do that by creating a flat +taxonomy. Here's how to do that: -#. Open any spreadsheet application (Excel, Numbers, Google Sheets, etc.) and create a new blank spreadsheet. In the first row, add two columns called **id** and **value**. +#. Open any spreadsheet application (Excel, Numbers, Google Sheets, etc.) and + create a new blank spreadsheet. In the first row, add two columns called + **id** and **value**. .. image:: /_images/educator_how_tos/ctag_create_taxonomy_step1.png :alt: Screenshot showing new blank spreadsheet with one row and two columns, the first column called id and the second called value. -#. Below that, enter the new tags that you want to create in the “value” column, and give each tag an ID in the “id” column. The “id” for each tag is required, but mostly relevant when you are aligning your taxonomy with some external system that uses IDs for each tag. If you don’t have that use case, just enter the same text for the id as for the value. +#. Below that, enter the new tags that you want to create in the “value” column, + and give each tag an ID in the “id” column. The “id” for each tag is + required, but mostly relevant when you are aligning your taxonomy with some + external system that uses IDs for each tag. If you don't have that use case, + just enter the same text for the id as for the value. .. image:: /_images/educator_how_tos/ctag_create_taxonomy_step2.png :alt: Screenshot showing a spreadsheet with two columns, the first column called id and the second called value. The same tag values are populated in the id column and the value column. -#. Save the spreadsheet using the default format, in case you want to edit it later. +#. Save the spreadsheet using the default format, in case you want to edit it + later. #. Export the spreadsheet to a CSV file. - #. In Excel, use File > Save As…, and set the “File format” to “CSV UTF-8 (comma-delimited) (.csv)” (preferred) or “Comma Separated Values (.csv)” then enter a filename and save it. + #. In Excel, use File > Save As…, and set the “File format” to “CSV UTF-8 + (comma-delimited) (.csv)” (preferred) or “Comma Separated Values (.csv)” + then enter a filename and save it. #. In Google Sheets, use File > Download > Comma Separated Values (.csv). #. In Numbers, use File > Export To > CSV… and use the default options. -#. Import the taxonomy following `How-To: Import and export a taxonomy `_ guide. +#. Import the taxonomy following `How-To: Import and export a taxonomy + `_ + guide. diff --git a/source/educators/how-tos/content-tagging-how-tos/add_delete_course_tags.rst b/source/educators/how-tos/content-tagging-how-tos/add_delete_course_tags.rst index 25304dfa8..1413e10bd 100644 --- a/source/educators/how-tos/content-tagging-how-tos/add_delete_course_tags.rst +++ b/source/educators/how-tos/content-tagging-how-tos/add_delete_course_tags.rst @@ -1,3 +1,5 @@ +.. _add-tags-to-a-course: + ############################## Add and delete tags on courses ############################## diff --git a/source/educators/how-tos/content-tagging-how-tos/add_delete_tags_course_content.rst b/source/educators/how-tos/content-tagging-how-tos/add_delete_tags_course_content.rst new file mode 100644 index 000000000..b2a76d224 --- /dev/null +++ b/source/educators/how-tos/content-tagging-how-tos/add_delete_tags_course_content.rst @@ -0,0 +1,124 @@ +Add and delete tags on course content +##################################### + +.. note:: + + Tags can be added to course content from three places in Studio: From the + Course Outline Page, from the Unit Page, and from individual Component + Blocks. + +.. note:: + + Tags can be added to all four levels of the course outline: Sections, + Subsections, Units and Component Blocks. Tags do not inherit from one level + of the course to another. In other words, when a tag is added to a unit, it + is not added to the subsection that the unit is in. Likewise, if a tag is + added to a unit, it is not added to the components within. + + For instructions on how to add tags to full courses, see + :ref:`add-tags-to-a-course` + +Adding Tags from the Course Outline Page +**************************************** + +#. Choose a section, a subsection or a unit that you would like to add tags to. + +#. In the 3-dot menu in the upper right corner of the content block, click + “Manage Tags”. + + .. image:: /_images/educator_how_tos/ctag_course_tag_step1a_dropdown.png + :alt: Screenshot of clicking Manage tags from the hamburger menu. + +#. The tag drawer will open. + + .. image:: /_images/educator_how_tos/ctag_course_tag_step1b.png + :alt: Screenshot of tag drawer opening. + +#. Click “Edit Tags”. + +#. Click in the “Add a tag” field in any taxonomy from which you'd like to + choose tags. (For instructions on how to add and enable a taxonomy, see + :ref:`import-export-taxonomy`). + + .. image:: /_images/educator_how_tos/ctag_course_tag_step3.png + :alt: Screenshot of clicking in the Add a tag field. + +#. If you know the tag you would like to add, start typing the tag in the “Add a + tag” field and potential matches will display. + + .. image:: /_images/educator_how_tos/ctag_course_tag_step4.png + :alt: Screenshot of field matches displaying beneath the Add a tag field. + +#. If you don't know the tag you would like to add, scroll through the list of tags until you find the tag you would like to add. + + .. note:: + + Tags may be nested as subtags, and that clicking on the arrows will open any nested tags. + + .. image:: /_images/educator_how_tos/ctag_course_tag_step5.png + :alt: Screenshot of arrows next to tags with nested subtags. + +#. Once you have decided which tag you would like to add, click on the checkbox + next to the tag. Add as many tags as you would like. + + .. note:: + + Choosing a nested tag will automatically add its parent tag(s) as well. + + .. image:: /_images/educator_how_tos/ctag_course_tag_step6.png + :alt: Screenshot of parent tags being automatically added. + +#. When you are finished, click “Add tags”. You will see the newly added tags in the tag drawer view. + + .. image:: /_images/educator_how_tos/ctag_course_tag_step7.png + :alt: Screenshot of added tags in the tag drawer. + +#. Click save and close out of the tag drawer. You will see the tag count + updated in the content block. + + .. image:: /_images/educator_how_tos/ctag_course_tag_step8_card.png + :alt: Screenshot of the tag count under the Course tags field. + +Deleting tags from the Course Outline Page +****************************************** + +#. Choose a section, a subsection or a unit that you would like to delete tags + from. + +#. In the 3-dot menu in the upper right corner of the content block, click + “Manage Tags”, OR, Click on the tag icon/tag count. The tag drawer will open. + +#. Click “edit tags”. + +#. Click the “x” button next to the tag you wish to delete. + + .. warning:: + + If you delete a tag that is nested underneath another tag, all tags in the hierarchy will delete. + + .. image:: /_images/educator_how_tos/ctag_course_tag_del_step3.png + :alt: Screenshot of x button next to tag. + +#. Click “save” and close the tag drawer. You will see the tag count updated in + the content block. + +Adding/deleting tags from the Unit Page +*************************************** + +#. Click on the “Manage Tags” button from the Unit tags widget in the right + sidebar. The tag drawer will open. + + .. image:: /_images/educator_how_tos/ctag_add_delete_unit_page.png + :alt: Screenshot of tag drawer opening. + +#. Continue steps 2-9 from above. + +Adding/deleting tags from a Component Block +******************************************* + +#. Choose a component that you would like to add tags to. + +#. In the 3-dot menu in the upper right corner of the content block, click + “Manage Tags”. The tag drawer will open. + +#. Continue steps 3-9 from above. \ No newline at end of file diff --git a/source/educators/how-tos/content-tagging-how-tos/build_taxonomy_using_template.rst b/source/educators/how-tos/content-tagging-how-tos/build_taxonomy_using_template.rst index 3672fbfd6..ebee77777 100644 --- a/source/educators/how-tos/content-tagging-how-tos/build_taxonomy_using_template.rst +++ b/source/educators/how-tos/content-tagging-how-tos/build_taxonomy_using_template.rst @@ -1,12 +1,19 @@ +.. _build-taxonomy-using-template: + ################################# Build a taxonomy using a template ################################# .. tags:: educator, how-to -Tags that can be applied to content are organized into hierarchical taxonomies. Currently, the only way to create or modify a taxonomy is by uploading a CSV or JSON file. +Tags that can be applied to content are organized into hierarchical taxonomies. +Currently, the only way to create or modify a taxonomy is by uploading a CSV or +JSON file. -The simplest type of taxonomy is a flat taxonomy that doesn’t have any hierarchy - see `“How-to: Create a flat taxonomy by uploading a CSV” `_ for a simpler procedure to create such a flat taxonomy. For the purposes of this guide, we’ll assume you want to create a taxonomy of cities, like this: +The simplest type of taxonomy is a flat taxonomy that doesn't have any hierarchy - +see :ref:`create-flat-taxonomy` for a simpler procedure to create +such a flat taxonomy. For the purposes of this guide, we'll assume you want to +create a taxonomy of cities, like this: * United States @@ -92,4 +99,4 @@ The simplest type of taxonomy is a flat taxonomy that doesn’t have any hierarc * In Google Sheets, use File > Download > Comma Separated Values (.csv). * In Numbers, use File > Export To > CSV… and use the default options. -* Import your taxonomy following the `How-to: Import and export a taxonomy guide `_. \ No newline at end of file +* Import your taxonomy following the How To :ref:`import-export-taxonomy`. \ No newline at end of file diff --git a/source/educators/how-tos/content-tagging-how-tos/import_export_a_taxonomy.rst b/source/educators/how-tos/content-tagging-how-tos/import_export_a_taxonomy.rst new file mode 100644 index 000000000..48f74bbcb --- /dev/null +++ b/source/educators/how-tos/content-tagging-how-tos/import_export_a_taxonomy.rst @@ -0,0 +1,64 @@ +.. _import-export-taxonomy: + +Import and Export A Taxonomy +############################ + +Taxonomies can be imported via the Taxonomies Dashboard, accessible via Studio +Home. + +.. image:: /_images/educator_how_tos/taxonomies_studio_home.png + :alt: The location of the Taxonomies tab on the Studio homepage is at the same level as the Courses and Libraries tabs. + +.. note:: + + Taxonomies can be imported as either CSV or JSON files. For instructions on + how to build a taxonomy by using a taxonomy template, see + :ref:`build-taxonomy-using-template`. + +Import a new taxonomy +********************* + +#. Navigate to the Taxonomies page and click “Import”. + +#. You will be prompted to choose a file from your local machine. Choose your + taxonomy file and click “open”. + +#. You will be prompted to add a name for your taxonomy. Add a name and click + :guilabel:`OK`. + + .. image:: /_images/educator_how_tos/taxonomies_new_name_prompt.png + :alt: A screenshot showing the pop up dialog box prompting for an entry of a new name + +#. You will be prompted to add a description for your taxonomy. Add a + description and click :guilabel:`OK`. + + .. image:: /_images/educator_how_tos/taxonomies_new_name_description.png + :alt: A screenshot showing the pop up dialog box prompting for an entry of a description for the new taxonomy + +#. You will see an indicator in the lower righthand screen indicating that the + import is underway. Once the import is complete, you will receive a + notification. Click :guilabel:`OK`. + + .. image:: /_images/educator_how_tos/taxonomies_import_successful.png + :alt: A screenshot showing the pop up dialog box indicating the import was successful with the text, "Taxonomy imported successfully" + +#. To view your newly imported taxonomy, find the taxonomy card in your taxonomy + listing and click the title. You will see your taxonomy and all its + associated tags in the taxonomy view page. + + .. image:: /_images/educator_how_tos/taxonomies_view_single_taxonomy_tags.png + :alt: A screenshot showing a single taxonomy and its nested tags + +Export a taxonomy +***************** + +#. Find the taxonomy you wish to export from the Taxonomy Listing Page. + +#. Click on the three-dot menu and click on :guilabel:`Export`. + + .. image:: /_images/educator_how_tos/taxonomies_three_dot_export.png + :alt: A screenshot showing the "Export" option available from the hamburger menu on one specific taxonomy card. + +#. Select the file format you wish to export in. + +#. Click :guilabel:`Export`. The file will export to your local machine. \ No newline at end of file diff --git a/source/educators/how-tos/content-tagging-how-tos/manage_permissions_taxonomy.rst b/source/educators/how-tos/content-tagging-how-tos/manage_permissions_taxonomy.rst new file mode 100644 index 000000000..e1c9baa1f --- /dev/null +++ b/source/educators/how-tos/content-tagging-how-tos/manage_permissions_taxonomy.rst @@ -0,0 +1,32 @@ +Manage Permissions on a Taxonomy +################################ + +.. note:: + On import, new taxonomies are not enabled by default. + + Once a taxonomy is enabled for an organization, it will appear in all courses in that organization. + +#. Find the taxonomy you wish to enable from the Taxonomy Listing page, click + the 3-dot menu and choose :guilabel:`Manage Organizations`. + + .. image:: /_images/educator_how_tos/taxonomy_manage_org.png + :alt: A screenshot showing the "Manage Organizations" option in the three-dot menu from a taxonomy card on Studio Home. + +#. Type the name of the organization you wish to enable for in the dropdown + field, or scroll through the list of all orgs. + +#. Add as many organizations as you would like, OR, check the box to assign to + all organizations. If your instance is a single-organization instance, check + :guilabel:`Assign to all organizations`. + + .. image:: /_images/educator_how_tos/taxonomy_assign_org.png + :alt: A screenshot showing a pop-up dialog allowing a user to assign an organization to the specified taxonomy. + +#. Click :guilabel:`Save`. + +#. To validate that the taxonomy has been added, navigate to a course and open + the tag drawer. You should see the taxonomy and its tags available in the Tag + Drawer. + + .. image:: /_images/educator_how_tos/taxonomy_tag_drawer.png + :alt: A screenshot showing a taxonomy and its tag in the Tag Drawer. \ No newline at end of file diff --git a/source/educators/how-tos/content-tagging-how-tos/update_reimport_taxonomy.rst b/source/educators/how-tos/content-tagging-how-tos/update_reimport_taxonomy.rst new file mode 100644 index 000000000..21bdfde0d --- /dev/null +++ b/source/educators/how-tos/content-tagging-how-tos/update_reimport_taxonomy.rst @@ -0,0 +1,61 @@ +Update/Re-import a taxonomy +########################### + +In order to update taxonomies, they must be updated locally and re-imported. +This document walks through that process. + +Updating a taxonomy locally +*************************** + +Before a taxonomy can be re-imported, it must be updated locally. Here's how to +do that. + +#. Export the taxonomy you wish to update. See :ref:`import-export-taxonomy` for + instructions on how to export. + +#. Open the file locally. It should look like this: + + .. image:: /_images/educator_how_tos/taxonomy-csv-export.png + :alt: A screenshot showing a CSV export of a taxonomy in Google Sheets. There are three columns labeled "id", "value", and "parent_id". + +#. Find the tag value that you wish to modify. Only tags in the “Value” column + should be changed. + + .. image:: /_images/educator_how_tos/taxonomy-csv-modify-tag.png + :alt: A screenshot showing a CSV export of a taxonomy in Google Sheets. A value in the second column, labeled "value", is highlighted in yellow. + + .. note:: + + DO NOT change the tag id. This will render the taxonomy un-usable. + See :ref:`tag-ids-for-taxonomy-import` for more detail. + +#. Once you've finished making changes, export the file as a CSV or JSON file + and navigate back to the Taxonomy Dashboard. + +#. Find the taxonomy you wish to update. Click on the three-dot menu and click + on :guilabel:`Re-import`: + + .. image:: /_images/educator_how_tos/taxonomy-three-dot-reimport.png + :alt: A screenshot showing the Re-import option in the three-dot menu from a taxonomy card on Studio Home. + +#. You will be prompted with an option to export and save a copy of the taxonomy + in its current state, before updating it. During the update process, the + current taxonomy will be replaced with the updated version, and its advisable + to keep a copy of the current version in case something goes wrong in the + updating process. + +#. After exporting a copy of your taxonomy in its current state, click :guilabel:`Next`. + +#. Find your local file, upload, and click :guilabel:`Import`. + +#. You will be prompted to accept a list of changes. If everything looks ok, + click :guilabel:`Continue`: + + .. image:: /_images/educator_how_tos/taxonomy-reimport-diff.png + :alt: A screenshot showing a pop-up that lists the changes between the current taxonomy and the newly reimported one. + +#. You will be prompted with a notification when the re-import is complete. + +#. To view your newly imported taxonomy, find the taxonomy card in your taxonomy + listing and click the title. You will see your taxonomy and all its + associated tags in the taxonomy view page. diff --git a/source/educators/navigation/advanced_features.rst b/source/educators/navigation/advanced_features.rst index 3c99eb7a0..82ad9bbd5 100644 --- a/source/educators/navigation/advanced_features.rst +++ b/source/educators/navigation/advanced_features.rst @@ -79,8 +79,13 @@ Course Tags and Taxonomies :glob: ../how-tos/content-tagging-how-tos/build_taxonomy_using_template.rst + ../how-tos/content-tagging-how-tos/import_export_a_taxonomy.rst ../how-tos/content-tagging-how-tos/Create_flat_taxonomy_by_uploading_CSV.rst + ../how-tos/content-tagging-how-tos/update_reimport_taxonomy.rst + ../concepts/advanced_features/why_taxonomy_tag_id.rst + ../how-tos/content-tagging-how-tos/manage_permissions_taxonomy.rst ../how-tos/content-tagging-how-tos/add_delete_course_tags.rst + ../how-tos/content-tagging-how-tos/add_delete_tags_course_content.rst ../how-tos/content-tagging-how-tos/export_tag_data_from_course.rst Google Calendar Tool