4.5 Organizing and Sharing Questions - Maple T.A. 2016 Help
Maple T.A. Online Help

Instructor
Search Maple T.A. 2016 Help:

4.5 Organizing and Sharing Questions

Searching for Questions in the Content Repository

In the top banner, you can click Search () to perform an advanced search using keyword, language, difficulty, (question) type, or information fields. Use the drop-down menus to specify each field.

Note: If a drop-down menu is not available, then it means the question details have not been specified and you cannot search by this criterion.

To perform a more specific search, type the keyword(s) into the search field. You will notice that as you type in your keywords, the results will update accordingly. The search feature in Maple T.A. searches the question type, title, text, description, language, hints, feedback, difficulty, and information fields for an exact match. See Figure 4.9.

Search Results in the Content Repository

Figure 4.9: Search Results in the Content Repository


From the top banner, you can also choose to Sort content by clicking the icon. Options to sort include: Manual, Name, (Date) Created, (Date) Modified.

Note: Manual sort allows you to change the existing order by using the icon to drag and drop content into a different order. In addition, when the content is oranized by Name, (Date) Created, (Date) Modified, Name, (Date) Created, (Date) Modified, an additonal small arrow appears, as shown below:

Clicking this arrow allows the user to control whether the content is sorted in an ascending (arrow up) or descending (arrow down) order.

Lastly, you will see your inherited questions from your parent class.

Note: Inherited questions cannot be deleted. However, you can clone an inherited question to create a local, editable copy of the question. You can also export an inherited question to save to your computer.

Editing Question Details in the Content Repository

You can edit details of a single question using the Content Repository

  1. Locate the question you want to preview by searching for it in the Content Repository.
  1. Click on the name of the question you wish to view.
  1. This expands another panel (called the Question Summary pane) with the question's details.
  1. Click Edit Details. This opens another window where you can edit the name of the question, its short name, its description, the author of the question (Attribution), Difficulty, Language, Subjects, and Information Fields.

Edit Source

From the Question Summary pane, click the drop-down menu next to Edit, then click Edit Source to edit the source code of the question.

Note: If you enter invalid field or value data, you may make your questions unworkable.

Table 4.5 summarizes the actions that are available when editing a question within your current class. You can edit questions through: 1) The Question Summary pane, 2) The Question Summary pane > Edit Details, or 3) by clicking Edit to reach the Question Designer. Use the table below to help you navigate the various options available.

Table 4.5: Question Repository: Actions Available in the Question Summary Pane

Actions Available from ...

Question Details

Description

Content Repository > Question Summary pane

Preview Question

This option allows the instructor to preview the question before it is finalized.

Details

Pre-existing tags on questions are displayed here for convenience. You can also choose to click Edit Details for additional options, which are explained below.

Authors

View the authors for this question. An author can be a person or an institution.

Statistics

You can view various statistics for the question. For a description of what each statistic means, see Item Statistics.

Hints

You can view any hints for the question or click Edit to create or revise an existing hint. You can also use click here to add one to create or revise an existing hint. For an overview of creating hints in questions, see Adding and Editing Hints.

Revisions

You can view the revision history for the question. For each revision, you can click the date or View to see a preview of the revisions. Clicking Clone will clone the revision into a new question.

Report this queston to administrators

You can report a question to an administrator to review by clicking Report this question to administrators. You need to fill out a message explaining what is wrong with the question and then click Send to send it to the administrators to review. Alternatively, click Cancel to cancel the report to administrators.

Content Repository > Question Summary pane > Edit Details

Name and (optional) Short Name

You can change the name of the question and/or add an optional short name.

Description

You can view or revise the existing description of the question. When searching the Content Repository, the description is included in what is searched under keywords. For more information, see Searching for Questions.

Authors

You can view the authors (person or institution) of the question. If you have made a revision to the question, you can make changes to your authoring attribution. If you have imported content, you will see who the original authors were. Also, the environment in which the question was created is displayed.

Difficulty

You can view the difficulty of the question. You can also choose a difficulty for this question (Easy, Medium, or Hard) using the drop-down menu. The Search () feature will filter for question difficulty in the Content Repository. For more information, see Searching for Questions.

Language

You can specify a language for this question using the list of languages provided in the drop-down menu. If a language is specified, the Search () feature will filter questions in the Content Repository. For more information, see Searching for Questions.

Subjects

You can view the subject(s) of the question. You can also choose the subject(s) by selecting the check boxes for the subject(s) you want associated with this question. Click Save when you have chosen the subject(s) you want associated with the question.

Groups

You can view the question groups of the question. You can also choose the question groups for this question by clicking Edit and then selecting the boxes for the question groups you want associated with this question. Click Save when you have chosen the question groups you want associated with the question. When browsing the Content Repository, you can view different question groups. For an overview of organizing questions in the Content Repository, see Organizing Questions in the Content Repository.

Information Fields

You can view information fields for the question or click Add Row to create an existing information field. You can choose to be shown all the questions with that information field in the Content Repository by using the Search () feature. For an overview on adding and editing information fields in a question, see Adding and Editing Information Fields.

Content Repository > Question Summary pane > Edit > Question Designer

(Question) Name

You can view or edit the name of the question using the Question Designer.

Question Text

You can edit the question in two different ways. Click Edit to edit the question using the Question Designer. When searching the Content Repository, the question text is included in what is searched for keywords. For more information, see Searching for Questions. You can also click Edit > Edit Source to edit the source code of the question.

Algorithm

You can view any algorithms for the question or click Edit to create or revise an existing algorithm. You can also select click here to add one to create or revise an existing algorithm. For an overview of creating algorithms in questions, see Adding and Editing Algorithms.

Custom CSS

Custom CSS can be applied to the entire system via System Settings, or it can be applied on a question-by-question basis using the Question Designer. Custom CSS is applied after the themes get applied, so you have the ability to manually override the features of a theme. For more information about themes, see Adding and Editing Themes.

Feedback

You can add or edit the feedback a student receives during or after an assignment. For more specific information, see Adding and Editing Feedback or Configuring Feedback Options.


See Also:

Details on Managing Assignments in the Content Repository

Organizing Questions in the Content Repository

Question Groups

In the Content Repository, questions are organized into groups. You can add a new group, create a subgroup, rename a group, delete a group, or share a group. Groups are indicated by the icon in the Content Repository.

Adding New Groups

To add a new group:

  1. From the Content Repository, click Questions under the Current class panel.
  1. Click Create New at the bottom of the page, and then click Group (as shown in the image below).

  1. This brings up the Add Group dialog where you can assign a Group Name.
  1. Clicking Add Group will automatically create a new group (indicated by the icon) under the Questions panel.
  1. Click the newly created group name to open the Group Details pane.
  1. Click the check box(es) next to the question(s) you wish to group.
  1. Use the drag and drop icon () to move your question(s) from the Questions panel to the Group Details pane.
Creating Subgroups

To create a new subgroup:

  1. From the first Group panel, click Create New.
  1. Select Group.
  1. This brings up the Add Group dialog where you can assign a Group Name.
  1. Clicking Add Group will automatically create a new subgroup (indicated by the icon) under the first Group's panel.

Note: You can also move groups into and out of other groups or subgroups by using the drag and drop icon (). In addition, you can create as many subgroups as necessary to organize your questions.

Editing Existing Groups

To edit a group:

  1. From the Questions panel, click the group you wish to edit in order to bring up the Group Details pane.
  1. Click Edit. This brings up the Edit Group dialog shown below.

  1. To rename the group, change the Name. Then, click Save to save and close the dialog.
  1. To delete the group, click Delete and select Confirm.

Note: If you delete a group, the questions in that group are no longer associated with a group. To find such questions, click Deleted Content at the bottom of the Current class panel.

Sharing Groups

To share a group:

  1. From the first Group panel, click Share ().
  1. This brings up the Share dialog, where you can select the level of sharing or privacy you want to enable for this assignment. For more information about these options, see Sharing Questions.

Assignment Units

Similar to question groups, you can organize assignments into units in the Content Repository. Assignments are indicated by theicon in the Content Repository.

Creating a New Unit

To create a new unit:

1. From the Content Repository, click the Assignments link in the View panel.

2. At the bottom of the Assignments panel click Create New, then select Unit from the submenu.

3. In the Add Unit window, enter a name for your new unit, then click Add Unit.

Adding Assignments to a Unit

To add an assignment to a unit:

1. In the Assignments panel, check the box beside the assignment you want to add to the unit.

2. Click beside the selected assignment, then drag it over the unit you want to add the assignment to.

3. When the summary panel for the unit opens, drag the assignment onto the unit panel.

4. Repeat steps 2 and 3 for each additional assignment you want to add.

Creating an Assignment Within a Unit

To create an assignment within a unit:

1. Open the Unit panel for the unit you want to create the assignment in.

2. At the bottom of the panel click Create New, then select either Assignment or Adaptive Assignment.

3. In the Assignment Editor, create the assignment then click Save & Close to return to the Unit panel.

Deleting a Unit from the Content Repository

To delete a unit from the Content Repository:

1. In the Unit panel of the unit you want to delete, click Edit.

2. From the Edit Unit window, click Delete.

3. Then, click Confirm.

Editing Unit Properties

To edit a unit:

1. Open the panel for the unit you want to edit.

2. Click Edit.

3. Edit/complete the information in the Edit Unit dialog window.

4. Click Save.

Sharing Units

You can share an assignment unit on the Maple Cloud, your institution, or restrict sharing to your class only.

To set up sharing for a unit:

1. Open the panel for the unit you want to edit.

2. Click Share.

3. In the Share dialog, select the level of sharing/privacy you want to enable for this assignment. For more information about these options, see Sharing Questions.

4. Click Done.

See Also:

Details on Managing Assignments in the Content Repository

Subjects

Subjects are helpful in organizing content across classes or on the Maple Cloud. They are indicated by the icon in the Content Repository. You can add a new subject, rename a subject, or delete a subject.

Adding New Subjects

To add a new subject:

  1. From the Content Repository, click Subjects under the Current class panel.
  1. Click Create New at the bottom of the page, and then click Subject (as shown in the image below).

  1. This brings up the Add Subject dialog where you can assign a Subject Name.
  1. Clicking Add Subject will automatically create a new subject (indicated by the icon).
  1. Click the newly created group name to open the Subject Details pane, where you can edit subjects.
Editing Existing Subjects

To edit a subject

  1. From the Subject Details pane, click Edit. This brings up the Edit Group dialog shown below.

  1. To rename the group, change the Name. Then, click Save to save and close the dialog.
  1. To delete the group, click Delete and select Confirm.

Deleting Questions from the Content Repository

You can delete a question from the Content Repository.

To delete a question, select the check box next to the question you want to delete and click Delete at the bottom of the Content Repository. Then, click Confirm.

To view the deleted questions, in the Content Repository, select the Deleted questions group. In addition to the standard actions, there are these actions:

  1. Undelete restores the selected deleted questions. The questions are restored to their original groups.
  1. Permanently Delete removes the selected questions shown on the current page of the search results.
  1. Cleanup performs a full cleanup of the Content Repository for the current class. The Cleanup action will:
  • Permanently delete all deleted questions
  • Permanently delete all unused old revisions of all questions (including earlier versions of active questions)

See Also:

Details on Managing Assignments in the Content Repository

Previewing a Question

  1. Locate the question you want to preview by searching for it in the Content Repository.
  1. Click on the name of the question you wish to view.
  1. This expands another panel (called the Question Summary pane) with the question's details.
  1. Hover over the text box and click on the magnifying glass that appears.
  1. This opens a preview window.

You can also preview a question when you are editing it by clicking Preview in the Question Text area.

In Preview Mode, you can interact with the question as a student, for example, enter a response to the question in the input cells or use check boxes and radio buttons. To test the grading of the question, select Grade.

See Also:

Details on Managing Assignments in the Content Repository

Exporting Work to Your Hard Drive

You can back up questions by downloading them to your hard drive. The questions are saved in a .zip file.

To export a copy of your work on the local hard drive on your computer:

  1. From the Content Repository, find the question(s) you wish to save.
  1. Select the check boxes beside the questions you wish to export, then click Export. See Figure 4.10. This exports them as a course module. Alternatively, you may wish to share the content by clicking Share () in the bottom banner. For detailed information on sharing questions, see Sharing Questions.

Important: Exporting questions, assignments, units and course modules all follow a similar procedure from the Content Repository.

Exporting Questions

Figure 4.10: Exporting Questions


Why Export Your Questions?

You may want to have your own local copy of your questions (which normally reside on the Maple T.A. server). You may also want to share your content with others who are not part of your institution. If you save your questions as a course module (by default, a .zip file) and share that file with another instructor, that instructor can import the course module into the Content Repository for their class in their instance of Maple T.A. For more information on course modules, see Course Modules.

Sharing Questions

Sharing content makes a wider range of questions available to all users. You can share questions from your class with your other classes you instruct, other instructors in the system, or even users all around the world with the Maple Cloud.

Questions belong to a class. The creator of a question becomes the owner of the question. Questions can only be modified by the owner.

Instructors can obtain questions in two ways:

  1. Inherit a question from a parent class. Child classes automatically inherit questions from their parent class. Instructors can use an inherited question in their assignments, but cannot modify the question. Only the original owner (creator) of the question can modify the question, and those changes will be automatically propagated to all subscribers' question groups.
  1. Clone a question (public or private) from the Content Repository or Maple Cloud. This operation creates a local copy, or clone, of the original question and sets the owner to the instructor who made the clone. Instructors who clone a question can edit the cloned question. (No one other than the instructor who created the cloned question will be able to modify the clone.) Changes made to the original question will not be visible in cloned questions.

When you inherit or clone a question, it is available in the Content Repository for your class, and you can use it in assignments. For more information, see Cloning Questions.

To determine which method of obtaining questions is appropriate for your class, take the following behaviors into consideration and choose the method that makes the most sense for you:

  • When an instructor inherits a question, the instructor should expect it to be modified by the question owner at any time without notice. However, the question is likely to be a valid question with all resources (images, etc.) in place.
  • When an instructor clones a question, the instructor becomes the full owner of the clone, and can be certain that it will not be edited by anyone else. However, there is a danger of losing resources (images, etc.) because the cloning process does not copy the resource files to the Class File Manager; therefore, it is possible that the resources files may be deleted by the original author at any time.

To share question(s):

  1. In the Content Repository, select the question(s) you wish to share and click .
  1. Share brings up the Share dialog (shown below), where you have three options: Share with: Maple Cloud, This instance, and This class.
Share Dialog

Figure 4.11: Share Dialog


Share with Maple Cloud, This Instance or This Class

  • Sharing with the Maple Cloud makes the course module available to any Maple T.A. user who has access to the Maple Cloud.
  • Sharing with This instance makes the course module available to everyone using the particular instance of Maple T.A. from your school. In other words, all instructors at your institution will see the question in their Content Repository.
  • Sharing with This class means only your current class has access to it. As a result, only instructors of this particular class will see the question in their Content Repository.

Important: If you want to increase the privacy level, you can always revert back to This class to reduce the number of people the class is shared with. The question(s) will be unpublished from the Maple Cloud and This instance automatically.

  1. This method works well when you are sharing a limited number of questions. Other methods for sharing content include primarily using course modules (Course Modules) or if necessary, older question banks (Exporting Work to Your Hard Drive).

See Also:

Creating a Shared Class

Cloning Questions

To add a question that is similar to an existing question in the repository, you can save time by cloning the existing question and then editing the clone.

To clone a question:

  1. In the Content Repository, find the question(s) you want to clone.
  1. Select the question(s). A new banner appears at the bottom.
  1. Click Clone. The question(s) can now be edited.
  1. (Alternatively, you can select questions, click Share, and then click Clone).

See Also:

Course Modules

Creating a Shared Class