Taxonomy Sample Data

The purpose of this repo is to generate Sample and Real World Taxonomy Data that can be used when testing and developing on the edx-platform.

Running this script will do the following:

1. 2 Test Organizations will be created
2. For each organization created, a sample course is created that is populated with a course export that contains a variety of section/subsections/units and components
3. For each of these created organizations the following taxonomies will be created:
   1. a disabled taxonomy with 10 Tags
   2. an enabled flat taxonomy with 5000 Tags
   3. an enabled hierarchical taxonomy with three levels and 4^x tags per level (4 root tags, each with 16 child tags, each with 64 grandchild tags)
   4. a small enabled taxonomy with 2 levels with 2 Tags each
4. A multi org Taxonomy is created and enabled/used by both orgs
5. (Optional) A 4 level Taxonomy containing data obtained from Open Canada Taxonomy
6. (Optional) A 3 level Taxonomy containing data obtained from LightCast Skills Taxonomy
7. Once the Taxonomies and their Tags have been created, the script will Tag each of the courses along with all the components they contain with 1 of each Tag from the the above

Note: This script is designed to be idempotent. Meaning that the end state is the same every time you run it. So if you make modifications to the sample courses on Studio or the Taxonomy data in the shell and run this script again, it will reset all your changes.

Getting Started

1. To begin, clone this repo to your host computer.

   • If you use Tutor devstack, mount it using this comamnd:

     tutor mounts add cms:/host/path/to/taxonomy-sample-data:/openedx/taxonomy-sample-data
     

   • If you use "devstack", put the cloned repo inside a directory so it can be accessed from within the devstack (eg: /edx/src/), and set the TAXONOMY_SAMPLE_PATH variable inside the generate.py file to point to the cloned repo inside your devstack/tutor environment, eg: /edx/src/taxonomy-sample-data

2. Set the USER_EMAIL variable in generate.py to the user the courses/units will be created under. It defaults to [email protected].

3. (Optional) If you would not like to include taxonomy data from real world examples, such as:

   • Open Canada Taxonomy
   • LightCast Skills Taxonomy

   Then set the following flags to False in generate.py accordingly:

   IMPORT_OPEN_CANADA_TAXONOMY = True
   IMPORT_LIGHTCAST_SKILLS_TAXONOMY = True

4. To run the script, enter the CMS shell (tutor dev run cms bash) and run the following command:

   python manage.py cms shell < /openedx/taxonomy-sample-data/generate.py

License Information

This includes a copy of the "Skills and Competencies Taxonomy Data" from Employment and Social Development Canada, which is under the Open Government Licence - Canada.

This includes a copy of the Lightcast Open Skills Taxonomy, which is "free for individual and not-for-profit use" and is available under the Lightcast Open Skills Terms of Use.