Topics screen

Applies to the following products: 
Questionmark OnDemand
Questionmark OnPremise

On this screen, you can:​

Creating a topic

When creating a topic, rename the new topic before trying out questions from the topic or publishing assessments that pull content from the topic to avoid issues.

A topic contains any number of questions. To create a topic:

  1. ​​Select the level in the topic tree at which you want to create a new topic.
  2. Click Topics, and then click New.
  3. Enter a title for the new topic (50 characters maximum) and press Enter.

The topic will now appear in the topic tree at one level below the one at which you selected to create it. You will be able to add questions and view and edit any of the questions that are added to the topic.​

Renaming a topic

To rename a topic:

  1. Select the topic from the topic tree you wish to rename.
  2. Click Topics, and then click Rename.
  3. Confirm that you want to change the topic's title by clicking OK (you can click Cancel to abort the renaming).
  4. Rename the topic (50 characters maximum) and press Enter.

Deleting a topic

To delete a topic:

  1. Select the topic you want to delete.
  2. Click Topics, and then click Delete.
  3. Confirm that you want to delete the selected topic by clicking OK (you can click Cancel to abort the deletion).

Copying an existing topic

When copying a topic, rename the pasted topic before trying out questions from the topic or publishing assessments that pull content from the topic to avoid issues.

To copy a topic and all the items (subfolders and questions) contained within it:

  1. Select the topic you want to copy.
  2. Click the Topics button, and then click Copy.
  3. In the topic tree, select the destination topic for all the items contained in the copied topic.
  4. Click the Topics button, and click Paste.

Editing topic properties

To view the properties for a topic:

  1. Select a topic from the topic tree
  2. Click Topics, and then click Properties. The following information is displayed:
    • The Title of the topic
    • The Description of the topic (512 characters maximum)
    • The author that created the topic
    • The date on which the topic was created
    • The date the topic was last modified
    • The date the topic was last exported
    • The language of the topic
    • The translation status of the topic

You can edit the topic title (50 characters maximum) and description (512 characters maximum). However, after changing the title of a topic, you may not be able to import the topic into Authoring if you have previously imported it. If you intend to export a topic from Authoring to Questionmark that has already been imported into Questionmark, it is recommended that you follow the following workflow to avoid any possible issues:

  1. Create your topic(s) in Authoring Manager.
  2. Import your topics into Authoring in Qpack form.
  3. Create questions in Authoring.
  4. Import the topic(s) with the created questions back into Questionmark in Qpack form.

You can change the topic language using the Language drop-down list. A topic's language can be changed until an XLIFF of the topic and its contents is downloaded. 

Adding questions

To add a question to a topic:

  1. Click the Questions tab to bring up the questions view.
  2. Select the topic that you wish to add a question to from the topic tree.
  3. Click New, and then select the question type you wish to create.
  4. Follow the steps on the question creation page to create the question.

Editing questions

To edit an existing question, locate it within a topic and click the question's description. The question editor will open.

Editing questions does not affect published assessments. In order to update an assessment after questions have been edited, the assessment must be republished. For information about publishing assessments, refer to Publishing assessments.

Deleting questions

To delete one or more questions in a topic:

  1. Select the question you want to delete by ticking the checkbox to the left of the question(s).
  2. Click Delete.
  3. Enter a comment for auditing purposes. This is required.
  4. Confirm that you want to delete the selected question by clicking OK or Cancel.

Copying an existing question

To copy one or more questions:

  1. Locate the topic that contains the question(s) you want to copy.
  2. Select the question(s) you want to copy by ticking the checkbox to the left of the question(s).
  3. Click Copy, and then select Copy.
  4. Select the topic to which you want to paste the copied question(s).
  5. Click Copy, and then select Paste.

If you paste questions that already exist in a topic into the same topic, the copies will have "Copy (1) of" inserted into the question description before the original question description.

Viewing question information

The number of questions contained within a topic is displayed in the Questions tab.

Use the items per page drop-down list to specify how many questions to display per page (the options are 10, 20, 50, 100, 500, or 20). If there are more questions than can displayed on one page, use first, previous, next, and last buttons to navigate between pages.

The following information can be displayed in the question grid:

  • Order is the current order of questions in the topic. Clicking Order will reverse the order of the questions in the topic.
  • Description is the question wording. If edited, the new question wording will appear.
  • Type is the question type of the question.
  • Created on is the date on which the question was created.
  • Modified on is the date on which the question was modified.
  • Modified by is the author who last edited the question.
  • Revisions is the number of revisions that have been made to the question.
  • Score is the maximum score a participant can receive for answering the question correctly.
  • Status is the status of the question.
  • Created by is the name of the author who created the question.
  • Question ID is the ID number of the question.
  • Original reference is the original reference for the question.
  • Review status is the review status of the question...
  • Copyright holder is the name of the person who holds the copyright for the question.

Additional information

Selecting one or more questions in the question grid allows a user to select the More option, which provides more additional information about one or more questions. The following options are presented:

  • Revision history will take you to the revision history for the selected question.
  • Download QML allows you to download the QML for the selected question.
  • Used by shows in which assessments the selected questions are being used. 
    • If the selected question are being used by an assessment, the following information about the assessment(s) they're being used in will be shown:
      • The name of the assessment folder that contains the assessment.
      • The title of the assessment.
      • The date and time the assessment was last published.
  • View stimulus will display the stimulus of the selected question.
  • Update metatags allows you to update the metatags assigned to one or more questions.
  • Update status allows you to update the delivery status of one or more questions.
  • Question translations allows you to view the translation status of the selected question(s).

Importing Qpacks

It is possible to import topics and questions contained in a Qpack into Authoring, where certain topics and questions can be edited. The Qpack being imported can contain:

  • Topics
  • Subtopics
  • Questions

If you are importing a Qpack that contains subtopic(s), a unique topic will be created for each subtopic.​

The maximum size for a Qpack that can be imported is 100 MB.

To import a Qpack that only contains questions, but no topics:

  1. Select the topic to which you want to import the questions contained within the Qpack.
  2. Click Topics, and then click Import Qpack.
  3. Click Upload file, and then click Browse.
  4. Navigate to where you have saved the Qpack you want to import and select it. The Qpack may be stored in a folder on your computer or a network storage device.
  5. Click Open, and click OK to verify the Qpack.
  6. Enter the Title for the topic where you want to place the questions.
  7. Enter a Description for the topic.
  8. Click Import to import the questions from the Qpack (you can cancel the import at any time by clicking Cancel).

To import a Qpack that contains topics and subtopics:​

  1. Select the topic to which you desire to import the contents of the Qpack.
  2. Click Topics, and then click Import Qpack.
  3. Click Upload file, and then click Browse.
  4. Navigate to where you have saved the Qpack you want to import and select it. The Qpack may be stored in a folder on your computer or a network storage device.
  5. Click Open, and then click OK to verify the Qpack. Once the Qpack is verified, the title of the topic(s) that will store the questions will be shown. The number of questions in the Qpack that can be successfully imported is also displayed.
  6. If you are importing a topic that has been imported before, you have the option to Update existing topics and content contained within or Import items as new content.
    • To update existing topic(s), select the Update existing topic option. If you have imported the Qpack several times to different topics, a drop-down list of these topics is shown where you can select which topic you want to update by selecting it from the drop-down list.
    • To import items as new content, select the Import items as new content option. This strips the Qpack ID from the content and removes any reference to the original Qpack. If this option is selected, you will not be able to update content via Qpacks in the future.
  7. If a duplicate topic name exists at the location to which you desire to import the contents of the Qpack, you must enter a unique name for the new topic that will contain the content.
  8. Click Import to import the contents of the Qpack (you can cancel the import at any time by clicking Cancel)​.

Importing questions

It is possible to import questions into Authoring. Any imported questions are placed in their own topic. Questions can be imported in the following formats:

Question format

Description

LXR* Test 6.1 Merge (.LXRMerge, .mrg)

LXR Test 6.1 Merge files are a group of questions created in LXR* Test. LXR* Test is an application from Logic eXtension Resources®. LXR Merge files will have the extensions .LXRMerge or .mrg.

Blackboard* 6.x, 8.x and 9.x pools (.zip)

Blackboard zip files are compressed files exported from a Blackboard Learning Management System. These Blackboard files will have the extension .zip.

Blackboard Upload (.txt)

Blackboard text files are a series of questions exported to a simple text file from a Blackboard Learning Management System. These Blackboard files will have the extension .txt.

Questionmark Live CSV (.csv)

The Questionmark Live CSV format is a format specifically created for Authoring. It allows users to quickly create questions in Excel or other text tool that is in the format of a CSV file. The CSV file can then be imported. The Questionmark Live CSV file should have the extension .csv. For more information about .csv files, refer to more information, please refer to What is the file format for CSV import?

Moodle (.xml)

Moodle XML files are a group of questions created using the Moodle Learning Management System. Any questions created in Moodle can be exported as an XML file and imported in to Questionmark Live. Moodle XML files should have the extension .xml.

QML (.qml)

Questionmark QML is Question Markup Language (QML) is a platform-independent open standard that describes questions for use in assessments. QML files use the extension .qml.

Only Authoring-supported question types will be imported; all other question types will be ignored. The Authoring file uploader automatically filters for the supported file types listed above, and only supported file types will be presented in the file selection window. Also note that all files of the supported file types will be presented, even if they don't contain data understood by Authoring. For example, because the Moodle XML file type is .xml, all .xml files will be presented, as the file uploader cannot distinguish between .xml files created by Moodle and .xml files created by other applications.

If you're importing LXRMoodle, or Blackboard questions that include non-text content (such as images or videos), these questions will be imported, but the non-text content will be filtered out and will have to be reinserted once these questions have been imported.

To import questions:

  1. Select the topic that you wish to which you want to import questions.
  2. Click Topics, and then click Import 3rd party questions. The "Import 3rd party questions" page opens.
  3. Click Upload file, and then click Browse.
  4. Navigate to where you have saved the associated file you want to import. The file may be stored in a folder on your computer or a network storage device.
  5. Once you have located the file, select it and click Open.
  6. Once the file has been uploaded to Authoring, enter a Title and Description for the new topic. The number of questions that will be imported is displayed below the description.
  7. Click OK (you can cancel the import at any time by clicking Cancel).

When a user without the Manage item bank permission (under V6 Authoring) attempts to import QML that contains a topic to which they do not have access:

  • a message now appears explaining that the content will be imported to new topic,
  • and the user must provide a name for the new topic.

Import an XLIFF

To import an XLIFF file containing translations:

  1. Right-click the topic for which you want to import an XLIFF, and select Import XLIFF. The Import XLIFF screen loads.
  2. Click Upload file. The Import XLIFF dialog opens.
  3. Click Browse.
  4. Navigate to the location of the XLIFF file and select it.
  5. Click Open. The XLIFF file is imported.
  6. Click OK.
  7. Follow steps 2 through 6 to import another set of translations, or click Import to finish the import process.

Once an XLIFF has been imported, the status of the translation automatically changes to Translated.

For more information about translation statuses, please refer to Topic translations.

Viewing the status of translations

To view the status of translations:

  1. Right-click the desired topic from the topic tree.
  2. Select Topic translations to view topic translations, or select Question translations to view translations of questions in the topic.

For information about the Translations page, please refer to Topic translations.

Printing topics for review

To print a topic for review:

  1. Select the topic that you want to print for review. 
  2. Click Topics, and then select Print for review.
  3. Select the format for the question numbering. The choices are:
    • 1,2,3
    • a,b,c
    • A,B,C
    • i,ii,iii
    • I,II,III
  4. Select the format for choice numbering. The choices are:
    • 1,2,3
    • a,b,c
    • A,B,C
    • i,ii,iii
    • I,II,III
  5. Select the format for option numbering. The choice are:
    • 1,2,3
    • a,b,c
    • A,B,C
    • i,ii,iii
    • I,II,III
  6. Select Show selected choices to highlight the the most correct (highest scored) choice in each question.
    • This option applies only to Multiple Choice, Yes/No, and True/False questions and may increase print for review generation time.
  7. Select Show topic path to show the topic path.
  8. Click Export.

Exporting a topic as a Qpack

A user must have the ​Create Qpacks for items permission in order to export content as a Qpack.

To export a topic as a Qpack:​

  1. Select from the topic tree the topic (and all content contained within the topic) that you want to export as a Qpack.
  2. Click Topics, and the click Download Qpack.
  3. Specify the location to which you want to save the Qpack, and click OK. The Qpack will be saved to the location specified.​

Exporting content as QML

A user must have the Download QML permission in order to export content as QML.

Both topics and questions can be exported as QML. 

Exporting topics as QML

A topic must contain at least one question before it can be exported as QML.

To export a topic as QML:

  1. Select from the topic tree the topic (and all content contained within the topic) that you want to export as QML.
  2. Click Topics, and the click Download QML.
  3. Specify the location to which you want to save the QML file, and click OK. The QML file will be saved to the location specified.​

Exporting questions as QML

To export one or more questions as QML:

  1. Select from the question grid the questions that you want to export as QML. 
  2. Click More, and the click Download QML.
  3. Specify the location to which you want to save the QML file, and click OK. The QML file will be saved to the location specified.​

It is important to note that QML does not include resources used in questions. In order to export content with resources, export content in a Qpack via the Export as Qpack option.

Exporting content for translation

To export content for translation:

  1. Right-click the topic, and select Download XLIFF. The Download XLIFF dialog opens. The topic source language is listed.
  2. Select a target language from the Target language drop-down list.
  3. Select one of the following options:
    • All text includes all text whether or not it has previously been translated.
    • Only text not previously translated includes only text not previously translated.
  4. Selecting Include subtopics includes in the XLIFF subtopics and items contained within.
  5. Click OK to download the XLIFF, saving it to the desired location.

The file created will include the language code for the target language in the filename, e.g., Math topics it-IT. Only one XLIFF can be downloaded at a time. 

Once an XLIFF of a topic has been downloaded, the topic translation status automatically changes to Awaiting translation.

For information about viewing the translation status of topics, please refer to Topic translations.

Trying out a question

To try out a question:

  1. ​Locate the topic that contains the question you want to try out, and select it.
  2. Click Try out.
    • If a question has been translated, select the desired language in which to try out the question, and then click OK.

A new tab opens where you can try out the question. If you have a pop-up blocker configured on your browser, you'll be prompted with the message "Click here if a new window did not open automatically for tryout" in order to try out the question.

Batch updating metatags and item statuses

In order to batch update metatags and the item status for questions, a user must have the Batch update item metatags and Batch update item status permissions. Without these permissions, a user will not have access to these options. For more information about these permissions, please refer to:

Batch updating metatags

To update the metatag(s) for a number of questions at once:

  1. Locate and select the questions in a topic for which you want to update the metatag(s).
  2. Click Update, and select Update metatags. The "Update question metatags" dialog opens.
  3. In this dialog, you have a number of options.
    • To add metatags, select Add selected metatags and then select the metatags you want to add to the selected questions.
    • To remove existing metatags and add new metatags, select Remove existing metatags and add selected metatags. This will automatically remove the all existing metatags from the selected questions and allow you to select new metatags you want to add to the selected questions in their place.
    • To remove all existing metatags from the selected questions, select Remove existing metatags.
  4. Click Update.

Batch updating the status of questions

To update the status for a number of questions at once:

  1. Locate and select the questions in a topic for which you want to update the status.
  2. Click Update, and select Update status
  3. Select the desired question status (Normal, Retired, Incomplete, Experimental, or Beta).
  4. Click Update.

Batch updating question choice shuffling options

To update the question choice option shuffling option for a number of questions at once:

  1. Locate and select the questions in a topic for which you want to update the question choice shuffling option.
  2. Click Update, and select Update shuffling
  3. Select the desired question choice shuffling option from the Shuffling option drop-down menu (No shuffling, All, All but last choice, or All but last two choices).
  4. Click Update.

Searching for items

You can use the search function to find specific questions and assessments.

Searching for questions

  1. Select Question from the search drop-down list.
  2. Enter a phrase to search for in the Search criteria field.
  3. Filter results by the following fields:
    • the question's description,
    • the question's status,
    • the question's maximum score,
    • the author of the question,
    • the date on which the question was created,
    • the date on which the question was last modified,
    • the question's copyright holder,
    • the question's review status,
    • ​​the question's stimulus,
    • the question's ID,
    • the question's choices,
    • the question's outcomes,
    • the metatag assigned to the question,
    • the metatag value assigned to the question,
    • and the original reference for the question.
  4. Click Search. All topic folders will be searched and the results will be shown on a new page.

Searching for assessments

  1. Select Assessment from the search drop-down list.
  2. Enter a phrase to search for in the Search criteria field.
  3. Filter results by the following fields:
    • the assessment's title,
    • the assessment's ID,
    • the author who created the assessment,
    • the date on which the assessment was created,
    • the author who last modified the assessment,
    • the date on which the assessment was last modified,
    • the assessment type,
    • the date on which the assessment was last exported,
    • and the date on which the assessment was last published.
  4. Click Search. All assessment folders will be searched and the results will be shown on a new page.

Printing search results

A user must have the Print for review permission to be able to print search results.

  1. After searching for a term, click the Print for review button on the Item search screen.
  2. Select the format for the question numbering. The choices are:
    • 1,2,3
    • a,b,c
    • A,B,C
    • i,ii,iii
    • I,II,III
  3. Select the format for choice numbering. The choices are:
    • 1,2,3
    • a,b,c
    • A,B,C
    • i,ii,iii
    • I,II,III
  4. Select the format for option numbering. The choice are:
    • 1,2,3
    • a,b,c
    • A,B,C
    • i,ii,iii
    • I,II,III
  5. Click Export.

Creating a topic outco​me

To create a topic outcome:

  1. Click the Outcomes tab to bring up the outcomes view.
  2. Click New. The topic outcomes page opens.
  3. Follow the steps on the topic outcomes page to create the topic outcome​.​ For more information on creating a topic outcome, please refer to Topic outcomes.

Editing a topic outcome

To edit a topic outcome, locate it within a topic and click the topic outcome's title. The topic outcomes editor will open.

Deleting a topic outcome

To delete one or more topic outcomes in a topic:

  1. Select the outcome you want to delete by ticking the checkbox to the left of the outcome(s).
  2. Click Delete.
  3. Enter a comment for auditing purposes. This is required.
  4. Confirm that you want to delete the selected outcome by clicking OK, or click Cancel to​ abort the deletion.

Viewing topic outcome information

Use the items per page drop-down list to specify how many topic outcomes to display per page (the options are 510, or 20). If you have more topic outcomes than can displayed on one page, use first, previous, next, and last buttons to navigate between pages.

The following information is displayed:

  • The title of the topic outcome range (50 characters maximum)
  • The minimum score of the topic outcome range
  • The maximum score of the topic outcome range