- name: canvas-quiz-response-pdfs
- ops-run-with: jupyter
- python>=3.7
- canvasapi>=2.0.0
- supports universal environment 🌎
Canvas Quiz Response PDFs (canvas-quiz-response-pdfs) is a Jupyter Notebook and Python application that pulls quiz data from Canvas LMS to create PDF documents containing student answers to essay questions. This was created to support formatting and anonymization of data to be run through Turnitin. The application requires the following user inputs:
- Canvas instance (ex. https://ubc.instructure.com)
- Active Canvas access token
- Course ID
- Quiz ID
You will also be prompted to answer 2 questions
- Does this quiz use any Question Banks?
- Would you like question text to appear in the output PDFs?
- ID (randomly-generated, anonymous student identifier)
- Course name (as it appears on Canvas)
- Question text (as it appears on Canvas)
⚠️ During execution you'll be given the option to exclude question text in the output pdfs. Question text may be useful to give context about which question is being answered. On the other hand, you may not want to include question text as the text will match across submissions to Turnitin. Ensure that you review the output to be sure it is suitable for your use case. - Student's response (all submitted text -- does not preserving formatting)
NOTE: all of the above will repeat for as many questions as are in the quiz (on seperate pages)
- Student Name (as it appears on Canvas)
- Student ID (UBC student ID)
- Canvas ID (Canvas LMS ID)
- Anonymous ID (as it appears in the output PDFs)
NOTE: this table contains sensitive information and should NOT be distributed or uploaded anywhere
- Only works for “Classic Quizzes” on Canvas (not New Quizzes)
- Formatting in the student response is not preserved
- Will only output questions of type “Essay Question” on Canvas
- Tool is designed for a Final Exam use case and therefore, should not be run on Quizzes that allow more than one attempt. Doing so may cause unexpected and/or unreliable behaviour.
Are you Sauder Operations Staff? Please go here for detailed instructions to run in Jupyter. ("The Project", or "the-project" is "canvas-quiz-response-pdfs" or "Canvas Quiz Response PDFs").
Project uses conda to manage environment (See official conda documentation here)
- Ensure you have conda installed (Python 3.7 version)
- Clone canvas-quiz-response-pdfs repository
- Import environment (once):
$ conda env create -f environment.yml
- Run:
- navigate to your directory
$ cd YOUR_PATH/canvas-quiz-response-pdfs
- activate the environment (see step 3 on first run)
$ conda activate canvas-quiz-response-pdfs
- run the script and follow prompts in terminal
$ python src/quiz_response_pdfs.py
- navigate to your directory