Formative Assessment Tools
Course Developer Guide
Formative Assessment Tools
Contents
Contents
DOCUMENT CHANGE HISTORY ......................................................................................................................... 4
UNDERSTANDING FORMATIVE ASSESSMENT TOOLS ........................................................................................ 5
Formative Assessment Tools platform requirements and setup ........................................................................ 5
General activity structure .................................................................................................................................... 5
Types of Formative Assessment Tools ................................................................................................................. 7
Graphic Multi-Select Interactive .......................................................................................................................... 7
About the Graphic Multi-Select Interactive tool .............................................................................................. 7
Graphic Multi-Select Interactive overview ....................................................................................................... 8
Best practices for developing a Graphic Multi-Select Interactive activity ..................................................... 11
General Data References for Graphic Multi-Select Interactive ...................................................................... 12
Additional Data References for Graphic Multi-Select Interactive .................................................................. 14
Image Hotspot ................................................................................................................................................... 17
About the Image Hotspot tool ....................................................................................................................... 17
Image Hotspot overview ................................................................................................................................ 18
Best practices for developing an Image Hotspot activity .............................................................................. 19
General Data References for Image Hotspot ................................................................................................. 21
Additional Data References for Image Hotspot ............................................................................................. 23
Inline Quiz .......................................................................................................................................................... 28
About the Inline Quiz tool .............................................................................................................................. 28
Inline Quiz overview ....................................................................................................................................... 28
Best practices for developing an Inline Quiz activity ..................................................................................... 29
General Data References for Inline Quiz ........................................................................................................ 31
Additional Data References for Inline Quiz .................................................................................................... 33
Matching and Categorization ............................................................................................................................ 38
About the Matching and Categorization tool ................................................................................................ 38
Matching and Categorization overview ......................................................................................................... 39
Best practices for developing a Matching or Categorization activity ............................................................ 43
General Data References for Matching and Categorization .......................................................................... 44
Additional Data References for Matching and Categorization ...................................................................... 45
© 2017 by D2L Corporation. All rights reserved.
2
Formative Assessment Tools
Contents
Sequencing Interactive ...................................................................................................................................... 48
About the Sequencing Interactive tool .......................................................................................................... 48
Sequencing Interactive overview ................................................................................................................... 48
Best practices for developing a Sequencing Interactive activity .................................................................... 51
General Data References for Sequencing Interactive .................................................................................... 52
Additional Data References for Sequencing Interactive ................................................................................ 54
USING FORMATIVE ASSESSMENT TOOLS ........................................................................................................ 56
Create an activity ............................................................................................................................................... 56
Add a Formative Assessment activity to Brightspace Learning Environment ................................................... 57
ABOUT D2L ..................................................................................................................................................... 58
© 2017 by D2L Corporation. All rights reserved.
3
Formative Assessment Tools
Document Change History
Document Change History
This version of the document replaces all previous versions. The following table describes the most recent changes to
this document.
Revision Date
Summary of Changes
February 2, 2017
Initial release.
© 2017 by D2L Corporation. All rights reserved.
4
Formative Assessment Tools
Understanding Formative Assessment Tools
Understanding Formative Assessment Tools
Formative Assessment Tools are useful for creating formative assessments (self assessments) for learners, as opposed
to summative assessments. Through a variety of activities, learners attain knowledge over the course of the assessment
period.
Formative Assessment Tools are can be used to create activities that teach high-level information that is less technical
in nature. Grades are not given for these activities, but feedback can be provided to move learners toward the correct
answers. Because grades aren't given, there is no upkeep required of instructors or course developers after they have
created the activities. Learners can attempt activities an unlimited number of times, while they are available, in order
to master the content.
Formative Assessment Tools platform requirements and
setup
Before you begin: Ensure that your administrator granted you the permissions to edit and manage the following tools:
 Manage Files
 Content
Formative Assessment Tools is compatible with browsers supported in Brightspace platform version 10.4 and later.
Formative Assessment Tools is currently only available in markets where U.S. English is the primary language used to
store and display data.
D2L recommends that you incorporate Formative Assessment activities into a course in an instance of Brightspace
Learning Environment. However, you can use Formative Assessment Tools apart from the Brightspace platform or any
other LMS, as long as they are hosted on a server.
You create Formative Assessment activities by configuring JSON files with your desired data values (see the Data
References topics in their respective tool sections), which are then referenced by an HTML index file. D2L recommends
you have a text editor available to modify the JSON files.
When complete, Formative Assessment activities are incorporated into the Content tool. You can add a Formative
Assessment activity into a module in the Content tool, or embed it into an existing topic in Content.
To get Formative Assessment Tools for your organization, contact your D2L Account Manager.
General activity structure
You can use each Formative Assessment Tool to create activities that have a similar structure. All activities can consist
of the following:
 Pre-activity page - this page is optional. It is useful for providing learners with more comprehensive instructions
and/or to set up a situation that prefaces the question or challenge presented in the activity. This page is
© 2017 by D2L Corporation. All rights reserved.
5
Formative Assessment Tools
Understanding Formative Assessment Tools
media-enabled so you can include text, videos, images, and links.
Figure 1: Sample pre-activity page including topic title, activity title, content area, and Start Activity button
 Main activity page(s) - depending on the activity type you choose, the main activity is presented on one or multiple
pages that learners must interact with and navigate through. This portion of the activity requires the most planning
and configuring to create, but with many options available, you can customize your activity to suit almost any
purpose. For examples of specific activity types, see the overview topics in their respective tool sections.
 Feedback page(s) - there are two types of feedback for you to choose from, and the type determines how the
feedback displays. For continuous feedback, results and feedback display on each page as the learner completes
that part of the activity and navigates through. For report (summative) feedback, results and feedback for the
whole activity display all at once on one page at the end of the activity. Depending on the activity type you choose,
and the amount of feedback you want to provide, there might be a more suitable feedback type. To find more
information, see the Best practices topics in their respective tool sections.
 Post-activity page - this page is optional. It is useful for providing learners with a summary of the activity,
reinforcing key learning points, or giving tips, hints, or reminders for moving forward. This page is particularly
effective as a follow-up to the continuous feedback option because it can provide learners with summary feedback
© 2017 by D2L Corporation. All rights reserved.
6
Formative Assessment Tools
Understanding Formative Assessment Tools
for the activity that they don't get while they're working their way through it. This page is media-enabled so you
can include text, videos, images, and links.
Figure 2: Sample post-activity page including topic title, activity title, content area, and Reset Activity button
Types of Formative Assessment Tools
Formative Assessment Tools include the following:
 Graphic Multi-Select Interactive (on page 7)
 Image Hotspot (on page 17)
 Inline Quiz (on page 28)
 Matching and Categorization (on page 38)
 Sequencing Interactive (on page 48)
Graphic Multi-Select Interactive
About the Graphic Mult i -Se le ct Int e ract i ve tool
The Graphic Multi-Select Interactive tool is useful for creating activities that challenge learners on descriptions of,
differences between, or similarities between multiple related items.
The Graphic Multi-Select Interactive presents a table with a series of items at the top of each column. Each row of the
table contains an item that applies or relates to one or more of the column items. The objective is to have the learner
© 2017 by D2L Corporation. All rights reserved.
7
Formative Assessment Tools
Understanding Formative Assessment Tools
determine which column items align with each row item. For example, you might ask learners to categorize various
dishes according to different dietary needs.
You'll use the Graphic Multi-Select Interactive most effectively when more than one column item is applicable or
related to each or several of the row items. If row items are applicable or related to only one column item, a Matching
Interactive is a more appropriate option for the activity.
Graphic Mult i -Se le ct Int e ract ive ove r vie w
You can set up a Graphic Multi-Select Interactive activity so that all row options display at one time on one page, or
only one row option displays on a page and learners must complete each one in sequence before moving on to the
next. The following screenshot shows an activity where all row options display on one page:
Figure 3: Graphic Multi-Select Interactive activity showing all row options together
© 2017 by D2L Corporation. All rights reserved.
8
Formative Assessment Tools
Understanding Formative Assessment Tools
You can set up a Graphic Multi-Select Interactive activity to provide continuous feedback or report feedback. For an
activity that displays only one row option at a time, you must use the continuous feedback option. For an activity that
displays all row options on one page, you must use the report feedback option. The summative feedback report
displays results and feedback. You can provide feedback for each selection, which displays for each incorrect response.
The following screenshot shows a summative feedback report where feedback is given for the row as a whole, instead
of for each selection in a row:
© 2017 by D2L Corporation. All rights reserved.
9
Formative Assessment Tools
Understanding Formative Assessment Tools
Figure 4: Graphic Multi-Select Interactive activity showing report feedback option
© 2017 by D2L Corporation. All rights reserved.
10
Formative Assessment Tools
Understanding Formative Assessment Tools
Best practi ces for de ve loping a Graphic Multi - Select Interactive acti vit y
To provide users with an optimal experience, D2L recommends the following when developing your Graphic
Multi-Select Interactive activity:
 While the number of items you can include in either the columns or the rows is not limited, restrict the number to
keep the content within one page in Brightspace Learning Environment; that is, use no more than 5 columns and
no more than 8 rows.
 For images used at the beginning of each row or column, select images with a suitable orientation and resolution
to fit your activity.
 If you include images only, or the accompanying text is not sufficiently explanatory, include alternate text.
 In general, the column items should include a list of things (people, places, activities, processes, etc.) and the row
items should include descriptions, essential traits, requirements, characteristics, etc.
© 2017 by D2L Corporation. All rights reserved.
11
Formative Assessment Tools
Understanding Formative Assessment Tools
General Data Re fe re nce s fo r Graphic Mult i - Select Interacti ve
Use the following data values when you modify the JSON file to create your activity. For more information, see Create
an activity (on page 56).
Data Value
Action
Type
"ActivityName"
Set a name for the activity
String
"QuestionDisplay"
Set how many questions the String
activity displays at one time
Available types are "single" and
“all”
"ProvideContinuous"
Provide continuous
feedback
Boolean
Includes correct/incorrect
indicators and #/# score
"ProvideQuestionReport"
Provide individual question
reports
Boolean
Only takes effect if
"QuestionDisplay" is set to
"single"
"ProvideEndReport"
Provide a final report for all
questions
Boolean
"VisualFeedback"
Set visual feedback during
continuous feedback
(correct or incorrect
graphics after submission)
Boolean
"AllowPrevious"
Allow previous questions to Boolean
be revisited
"Randomize"
Randomize the question
order
"Instructions"
Set designated
String
instructions/context for the
activity
"ShowQuestionFeedback"
Show question specific
Boolean
feedback after a question is
completed
© 2017 by D2L Corporation. All rights reserved.
Notes
Only takes effect if
“ProvideContinuous” is set to
"true"
Only takes effect if
“QuestionDisplay” is set to
“single”
Boolean
Takes effect if either
“ProvideQuestionReport” or
“ProvideEndReport” are set to
"true"
12
Formative Assessment Tools
Understanding Formative Assessment Tools
"NumberedQuestions"
Indicate if questions are
numbered or unnumbered
Boolean
To number questions, set the
value to "true"; to leave
questions unnumbered, set the
value to "false"
"SubmitAll"
Display a Submit All button
Boolean
Only takes effect when
“QuestionDisplay” is set to “all”
"PreActivityText"
Set text that appears before String
the activity
To omit, set the value to
"none"; to skip the pre-activity
page, set the value to “none”
for “PreActivityText” and
“PreActivityMedia”
"PreActivityMedia"
Add media that appears
before the activity
Array
To omit, set the value to
“none”; to skip the pre-activity
page, set the value to “none”
for “PreActivityText” and
“PreActivityMedia”; SEE MEDIA
OPTIONS (use separate object
for content piece)
"PostActivityText"
Set text that appears after
the activity
String
To omit, set the value to
“none”
"PostActivityMedia"
Add media that appears
after the activity
Array
To omit, set the value to
“none”; SEE MEDIA OPTIONS
(use separate object for
content piece)
"TableHeading"
Set a specific title for the
table
String
© 2017 by D2L Corporation. All rights reserved.
13
Formative Assessment Tools
Understanding Formative Assessment Tools
Additional Data R e fe re nce s for Graphic Multi - Select Interacti ve
Use the following data values and array data values when you modify the JSON file to create your activity. For more
information, see Create an activity (on page 56).
Question and Answer Options:
Data Value
Array Data Value
"Answers"
Action
Type
Specify the answers for Array
the activity (also the
headings for the first
row of the table)
"imgSrc"
Set the
source/location/url for
the image related to
the answer
String
"alt"
Enter the
text/description used
for the alt-attribute for
the answer's image
String
"text"
Enter the text for the
answer
String
"Questions"
Specify the questions
Array
for the activity (also the
headings for the first
column of the table)
Notes
Use a separate object
for each answer
Use a separate object
for each answer
"text"
Enter specific text for
each question
String
"questionFeedback"
Enter feedback text to
display for the
question, regardless of
the result
String
Only displayed if
“ShowQuestionFeedba
ck” is set to true; to
omit, set the value to
“none”
"answers"
Add information
associated with each
answer in relation to
the question
Array
Use a separate object
for each answer
© 2017 by D2L Corporation. All rights reserved.
14
Formative Assessment Tools
Understanding Formative Assessment Tools
"answers" > "check"
Specify how each
String
checkbox should be
answered to be correct
To indicate that the
checkbox must be
checked, set the value
to "true"; to indicate
that the checkbox must
not be checked, set the
value to "false"
"answers" >
"feedback"
Set unique media
feedback associated
with each checkbox
that is marked
incorrectly
Array
Use a separate object
for each content piece;
SEE MEDIA OPTIONS
Array Data Value
Action
Type
Notes
Set the type of content
piece
String
Available types: "link",
"image",
"YouTubeVideo", and
"text" (see below)
"link"
Embed external links
String
"link" > "src"
Set the url/source for
the link
String
"link" > "description" Add a description for
the link
String
"image"
Embed images
String
"image" > "src"
Set the
source/location/url for
the image
String
"image" >
"description"
Add the
text/description used
for the alt-attribute for
the image
String
Media Options:
Data Value
"type"
© 2017 by D2L Corporation. All rights reserved.
15
Formative Assessment Tools
Understanding Formative Assessment Tools
"image" >
"mediaLink"
Set the url/source you
want the image to link
to
String
Only use if you want
the image to be a link;
to omit, set the value
to "none"
"image" > "width"
Set a custom width for
the image (in pixels)
Number
Set the value to "none"
for a default width of
420 pixels
"image" > "height"
Set a custom height for Number
the image (in pixels)
Set the value to "none"
for a default height of
315 pixels.
"YouTubeVideo"
Embed YouTube videos String
"YouTubeVideo" >
"src"
Set the source/url of
the YouTube video
"YouTubeVideo" >
"altLink"
Set the url/source for
String
the alternative content
for the video
Use to provide an
accessible alternative
to a video, for example,
a transcript for a video
"YouTubeVideo" >
"width"
Set a custom width for
the video (in pixels)
Number
Set the value to "none"
for a default width of
420 pixels
"YouTubeVideo" >
"height"
Set a custom height for Number
the video (in pixels)
Set the value to "none"
for a default height of
315 pixels
"text"
Embed text
String
"text" > "content"
Enter the text to
display
String
© 2017 by D2L Corporation. All rights reserved.
String
16
Formative Assessment Tools
Understanding Formative Assessment Tools
Image Hotspot
About the Image Hot spot t ool
The Image Hotspot tool enables you to transform an image into an interactive assessment or a content exploration
activity. Learners can click areas of the image to reveal either a multiple choice question or some content such as text,
images, videos, or links.
An image with clickable regions is called a "scene". An Image Hotspot activity can include multiple scenes and each
scene can consist of as many clickable regions as you want.
Image Hotspot activities are great for error or issue identification. For example, learners in a Workplace Safety course
could be asked to investigate a scene containing several hazards and identify them. You could follow up by asking them
to explain why it is a hazard, what corrective actions should be taken, or present a multiple choice question asking
specifically what the hazard is. As another example, learners in a Math course could be presented with a problem's
incorrect steps and solution and be asked to identify where the mistakes were made.
You can create an activity based on categories by creating your own image that consists of multiple text boxes grouped
together. When the learner selects a category, they are presented with a question related to that category. You can
even create an interactive diagram. For example, if a piece of content consists of several small pieces, each with
associated details, such as forms, tables, charts, graphs, or diagrams, learners select different parts of the object and
are presented with the relevant content.
© 2017 by D2L Corporation. All rights reserved.
17
Formative Assessment Tools
Understanding Formative Assessment Tools
Image Hotspot ove rv ie w
You can set up an Image Hotspot activity so that each clickable region delivers content or a multiple choice question.
The following screenshot shows a scene where each clickable region delivers content:
Figure 5: Image Hotspot activity showing content delivery
For Image Hotspot activities that are set up to deliver content for each clickable region, feedback isn't necessary since
learners just read information without needing to respond. For Image Hotspot activities that are set up to pose a
multiple choice question for each clickable region, you can choose to provide feedback to learners after they answer
each question. The following screenshot shows an activity that poses multiple choice questions and provides feedback
after each question is answered:
© 2017 by D2L Corporation. All rights reserved.
18
Formative Assessment Tools
Understanding Formative Assessment Tools
Figure 6: Image Hotspot activity showing multiple choice question feedback option
Best practi ces for de ve loping an Imag e Hotspot acti vit y
To provide users with an optimal experience, D2L recommends the following when developing your Image Hotspot
activity:
 Consider accessible users before choosing to develop an Image Hotspot activity. Due to the nature of the activity,
the learning experience might not be as helpful for learners who are visually impaired. Users can navigate the
scene through keystrokes and screen readers, but the experience might be compromised. To assist visually
impaired learners, include alt text for each image that focuses on the visual cues within the image.
 For the scene in your Image Hotspot activity, select an image with a landscape orientation. Choose an image size
that renders well on the device you intend the activity to be viewed on. In general, a good size to aim for is 880px.
x 500px. Keep in mind that the activity is responsive and images scale down, but they do not scale up.
 To ensure that the multiple choice (MC) questions and content that displays when a user selects a clickable region
displays well, do the following:
 For MC questions, limit the question text to <100 words.
 For MC questions, limit the response option to <=4.
© 2017 by D2L Corporation. All rights reserved.
19
Formative Assessment Tools
Understanding Formative Assessment Tools
 For MC questions, limit the response options text to <25 words.
 For text-only content, limit the text to <200 words.
 For image/video-only content, limit the size of the image/video to <800px. x 500px.
 For text and image/video content, limit text to <100 words and the size of the image/video to <400px. x
250px.
© 2017 by D2L Corporation. All rights reserved.
20
Formative Assessment Tools
Understanding Formative Assessment Tools
General Data Re fe re nce s fo r Imag e Hot spot
Use the following data values when you modify the JSON file to create your activity. For more information, see Create
an activity (on page 56).
Data Value
Action
Type
"ActivityName"
Set a name for the activity
String
"HeadingLevel"
Set a heading level for the
activity name
Integer
"Randomize"
Randomize the order the
hotspot scenes appear
Boolean
"visible"
Indicate whether hotspots
have a visual overlay
Boolean
"ShowScenes"
Specify the number of
Integer
scenes you want the user to
complete
"visibleStyle"
Set the static style for the
visual overlays
Array
Only takes effect if "visible"
and "VisualStyle" are set to
"true"
"visibleStyle" > "colour"
Set the color of the visual
overlay
String
Enter a hex code (#)
"visibleStyle" > "opacity"
Set the transparency of the
visual overlay
String
Enter a percentage (%)
"visibleStyle" > "stroke"
Specify if the visual
indicator has a
stroke/outline
Boolean
"visibleStyle" >
"strokeColour"
Set the color of the visual
overlay's stroke
String
Enter a hex code (#)
"visibleStyle" >
"strokeWidth"
Set the width of the visual
overlay's stroke
Integer
Indicates the width in pixels
"highlight"
Set whether the hotspots
have a hover effect
Boolean
© 2017 by D2L Corporation. All rights reserved.
Notes
Max heading level is "3"
Hot spots can have a static
style and a hover color
21
Formative Assessment Tools
Understanding Formative Assessment Tools
"highlightStyle"
Set the style of the hover
effect
Array
Only takes effect if "highlight"
and "VisualStyle" are true
"highlightStyle" > "colour"
Set the color of the hover
effect
String
Enter a hex code (#)
"highlightStyle" > "opacity"
Set the transparency of the
hover effect
String
Enter a percentage (%)
"highlightStyle" > "stroke"
Specify if the hover effect
will have a stroke/outline
Boolean
"highlightStyle" >
"strokeColour"
Set the color of the hover
effect's stroke
String
Enter a hex code (#)
"highlightStyle" >
"strokeWidth"
Set the width of the hover
effect's stroke
Integer
Indicates the width in pixels
"PreActivityText"
Set text that appears before String
the activity
To omit, set the value to
"none"; to skip the pre-activity
page, set the value to “none”
for “PreActivityText” and
“PreActivityMedia”
"PreActivityMedia"
Add media that appears
before the activity
Array
To omit, set the value to
“none”; to skip the pre-activity
page, set the value to “none”
for “PreActivityText” and
“PreActivityMedia”; SEE MEDIA
OPTIONS (use separate object
for content piece)
"PostActivityText"
Set text that appears after
the activity
String
To omit, set the value to
“none”
"PostActivityMedia"
Add media that appears
after the activity
Array
To omit, set the value to
“none”; SEE MEDIA OPTIONS
(use separate object for
content piece)
© 2017 by D2L Corporation. All rights reserved.
22
Formative Assessment Tools
Understanding Formative Assessment Tools
Additional Data R e fe re nce s for Imag e Hot spot
Use the following data values and array data values when you modify the JSON file to create your activity. For more
information, see Create an activity (on page 56).
Scene Options:
Data Value
Array Data Value
Action
Type
Notes
Set options for the
scenes
Array
Use a separate object
for each scene
"SceneName"
Enter the name of the
scene to appear in the
title
String
"Instructions"
Provide instructions for String
the scene
"Background"
Set the background
image for the scene
"Scenes"
Object
"Background" > "src" Set the
source/location/url for
the background image
String
"Background" > "alt"
Add alternate text for
the background image
String
"Background" >
"imgWidth"
Specify the original
width of the
background image
Integer
Indicate width in pixels
"Background" >
"imgHeight"
Specify the original
height of the
background image
Integer
Indicates height in
pixels
"HotSpots"
Set the locations of the Array
hotspots
Use a separate object
for each hotspot; SEE
HOTSPOT OPTIONS
"HotSpotContent"
Specify the content for
each hotspot's pop-up
Use a separate object
for each hotspot; SEE
HOTSPOT CONTENT
OPTIONS
© 2017 by D2L Corporation. All rights reserved.
Array
23
Formative Assessment Tools
Understanding Formative Assessment Tools
Hotspot Options:
Data Value
Array Data Value
Action
Type
Notes
"id"
Enter the unique id of
the hotspot
String
This string must match
"key" in the
"HotSpotContent"
object it corresponds
with
"shapeType"
Specify the shape of
the hotspot
String
Available types are
"rectangle", "circle",
and "custom"
"rectangle" > "xPos"
Set the x-coordinate for Integer
the top left corner of
the hotspot
Indicate the position in
pixels relative to the
original size of the
image
"rectangle" > "yPos"
Set the y-coordinate for Integer
the top left corner of
the hotspot
Indicate the position in
pixels relative to the
original size of the
image
"rectangle" >
"shapeWidth"
Specify the width of the Integer
hotspot
Indicate the width in
pixels relative to the
original size of the
image
"rectangle" >
"shapeHeight"
Specify the height of
the hotspot
Indicate the height in
pixels relative to the
original size of the
image
"circle" > "xPos"
Set the x-coordinate for Integer
the center of the
hotspot
Indicate the position in
pixels relative to the
original size of the
image
"circle" > "yPos"
Set the y-coordinate for Integer
the center of the
hotspot
Indicate the position in
pixels relative to the
original size of the
image
© 2017 by D2L Corporation. All rights reserved.
Integer
24
Formative Assessment Tools
Understanding Formative Assessment Tools
"circle" > "radius"
Specify the radius of
the hotspot
"custom" > "coords"
Specify the coordinates String
for the hotspot
"desc"
Integer
Indicate the radius in
pixels relative to the
original size of the
image
Needs to be provided
by an outside Image
Mapper
Provide the description String
for the hotspot and
how it relates to the
background image
Hotspot Content Options:
Data Value
Array Data Value
Action
Type
Notes
"key"
Specify the unique key
for the hotspot's
content
String
Value must match "id"
in the "HotSpots"
object it corresponds
with
"activityType"
Specify the type of
String
content that appears in
the pop-up for the
hotspot
"assessment" >
"feedback"
Determine if feedback
is provided after
answer is submitted
Boolean
"assessment" >
"questionText"
Enter the text for the
multiple choice
questions
String
"assessment" >
"answers"
Specify the answers for Array
the multiple choice
questions
"assessment" >
"answers" >
"answerText"
Provide answer text
© 2017 by D2L Corporation. All rights reserved.
Value can be set to
"assessment" or
"presentation"
Use a separate object
for each answer
String
25
Formative Assessment Tools
Understanding Formative Assessment Tools
"assessment" >
Indicate if the answer is Boolean
"answers" > "correct" correct or not
Set the value to "true"
for a correct answer,
and "false" for an
incorrect answer
"assessment" >
"answers" >
"feedback"
Enter the feedback
provided when this
answer is chosen
String
Only takes effect if the
value for "feedback"
for this "assessment"
object is set to "true"
"presentation" >
"hotSpotMedia"
Determine the media
Array
elements that appear
in the hotspot's pop-up
Use a separate object
for content piece; SEE
MEDIA OPTIONS
"popUpName"
Set the title/heading
that will appear in the
pop-up for the hotspot
String
Action
Type
Notes
Set the type of content
piece
String
Available types: "link",
"image",
"YouTubeVideo", and
"text" (see below)
"link"
Embed external links
String
"link" > "src"
Set the url/source for
the link
String
"link" > "description" Add a description for
the link
String
"image"
Embed images
String
"image" > "src"
Set the
source/location/url for
the image
String
Media Options:
Data Value
Array Data Value
"type"
© 2017 by D2L Corporation. All rights reserved.
26
Formative Assessment Tools
Understanding Formative Assessment Tools
"image" >
"description"
Add the
text/description used
for the alt-attribute for
the image
String
"image" >
"mediaLink"
Set the url/source you
want the image to link
to
String
Only use if you want
the image to be a link;
to omit, set the value
to "none"
"image" > "width"
Set a custom width for
the image (in pixels)
Number
Set the value to "none"
for a default width of
420 pixels
"image" > "height"
Set a custom height for Number
the image (in pixels)
Set the value to "none"
for a default height of
315 pixels.
"YouTubeVideo"
Embed YouTube videos String
"YouTubeVideo" >
"src"
Set the source/url of
the YouTube video
"YouTubeVideo" >
"altLink"
Set the url/source for
String
the alternative content
for the video
Use to provide an
accessible alternative
to a video, for example,
a transcript for a video
"YouTubeVideo" >
"width"
Set a custom width for
the video (in pixels)
Number
Set the value to "none"
for a default width of
420 pixels
"YouTubeVideo" >
"height"
Set a custom height for Number
the video (in pixels)
Set the value to "none"
for a default height of
315 pixels
"text"
Embed text
String
"text" > "content"
Enter the text to
display
String
© 2017 by D2L Corporation. All rights reserved.
String
27
Formative Assessment Tools
Understanding Formative Assessment Tools
Inline Quiz
About the Inline Quiz t ool
The Inline Quiz tool enables instructors to give learners self-assessment opportunities in an activity that has a clean,
modern user interface and customizable features.
The activity can exist in the course as a regular topic or embedded within content. Question types include multiple
choice, all-that-apply, fill-in-the-blank, and arithmetic. Questions are posed one at a time, but can be presented in a
specified order or randomly. Instructors can also write feedback for questions that can be provided continuously (after
each question) or as a report at the end of the quiz.
In line Quiz overv ie w
You can design an Inline Quiz activity to have as many questions as you want, and to use any variety of question types
from those available. Some question types (all-that-apply and multiple choice) can include images, videos, and links in
both the question text and the question options. The following screenshot shows a multiple choice question that is the
second question of four in the activity:
Figure 7: Inline Quiz activity showing a multiple choice question
You can set up an Inline Quiz activity to provide continuous feedback or report feedback. However, continuous
feedback is generally better suited for this kind of activity. You can also force learners to answer questions again right
away if they get them wrong. The following screenshot shows the results and feedback for a fill-in-the-blank question:
© 2017 by D2L Corporation. All rights reserved.
28
Formative Assessment Tools
Understanding Formative Assessment Tools
Figure 8: Inline Quiz activity showing fill-in-the-blank question with continuous feedback option
Best practi ces for de ve loping an Inline Quiz acti vity
To provide users with an optimal experience, D2L recommends the following when developing your Inline Quiz activity:
 Fill-in-the-blank questions
Since the Inline Quiz tool automatically corrects learners' submissions, take extra care when you construct
fill-in-the-blank questions. Make the correct response definitive to avoid having learners think there are multiple
correct answers. In some cases, you might want to present two or more options for the learner directly after the
fill-in field. For example, "The wall separating the left and right sides of the human heart is called the
______________ (septum/ventricle)." Alternatively, you can provide a list of terms and phrases in the Hint section
of the question. To reduce wrong answers based on spelling, use the same list for all fill-in-the-blank hints.
Note: Fill-in-the-blank questions are not case sensitive.
 Arithmetic questions
Arithmetic questions in the Inline Quiz tool work differently than in Brightspace Learning Environment. The
numbers do not change and the correct answer is not calculated based on a formula. You can think of it as a
fill-in-the-blank question whose fill-in field is below the question text instead of embedded in the sentence, and
only numeric values can be entered.
 Feedback type
When you're deciding on whether feedback should be continuous or summative, consider the length of the quiz,
the complexity of the feedback, and the types of questions being asked. A feedback summary at the end of a
© 2017 by D2L Corporation. All rights reserved.
29
Formative Assessment Tools
Understanding Formative Assessment Tools
ten-question quiz that uses a lot of all-that-apply questions will not be easy for the learner to read and key
messages might be missed. Continuous feedback, in most cases, offers the most learner-friendly experience.
 Media use
You can integrate media (images, videos, and other types) into an Inline Quiz activity on the pre-activity and
post-activity pages, and in questions, hints, and feedback. However, do not overwhelm the quiz with too much
media; if you use it sparingly, it can create a more engaging learning experience.
 Approach to question structure
Consider structuring the question order so that questions build upon one another or are part of a bigger analysis,
rather than creating a quiz consisting of isolated questions. For more structured questioning, remove
randomization of the question sequence and ensure that any relevant information is included either in the
question text or in the hint.
 If you are creating questions that you also want available for use within the Quizzes tool in Brightspace Learning
Environment, format them according to the following:
 Use an asterisk (*) before the multiple choice options to indicate correct answers. If you indicate that there
are multiple correct answers, you should use the all-that-apply question type.
 Use a question mark (?) before content that you want to display in the question’s Hint.
 Use an at sign (@) before the question's feedback content.
 Use two at signs (@@) to denote feedback associated with the multiple choice or all-that-apply option
directly above it.
 If you use Microsoft Word to format your question text, do not let the auto-format apply to the questions'
and options' enumerations, for example, "1." or "a." Question numbers and option lettering should be
treated as text.
 For the Inline Quiz tool, many of the best practices associated with giving traditional tests apply, including:
 If more than one option is correct, use an all-that-apply question. Avoid using "All of the above" or "Options
A and B" as multiple choice options.
 All-that-apply questions should have at least one incorrect answer, that is, don't make all options in an
all-that-apply question as correct answers.
 Avoid questions that ask things like, "Which of the following is not a..." or, "All of these except one is an
example of...".
 Give learners clear instructions on how to answer all-that-apply and fill-in-the-blank questions. For
all-that-apply questions, state, “Select all that apply,” at the end of the question. For fill-in-the-blank
questions, tell your learners if you want them to use American spelling, put periods in acronyms, and so on.
Where feasible, give learners an example of how to format their response.
© 2017 by D2L Corporation. All rights reserved.
30
Formative Assessment Tools
Understanding Formative Assessment Tools
General Data Re fe re nce s fo r Inline Quiz
Use the following data values when you modify the JSON file to create your activity. For more information, see Create
an activity (on page 56).
Data Value
Action
Type
"QuizName"
Give the quiz a name to
appear in the title
String
"HeadingLevel"
Set the heading level for the Integer
activity name
"Instructions"
Provide instructions for the
whole activity
String
"feedBackType"
Set the type of feedback
String
"repeatOnComplete"
Specify whether the quiz
can be repeated upon
completion
Boolean
"forceCorrect"
Ensure learners answer
questions correctly before
proceeding
Boolean
Only available if the value for
"feedBackType" is set to
"continuous"
"allowNone"
Set if learners can proceed
while leaving a question
unanswered
Boolean
If the value is "true", an
unanswered question is
considered a wrong answer
"allowPrevious"
Specify whether a previous
question can be attempted
again before completion
Boolean
"randomize"
Set the order the questions
will appear
Boolean
"showHints"
Provide hints for questions
Boolean
© 2017 by D2L Corporation. All rights reserved.
Notes
The maximum heading level is
"3"
Either "continuous" or "report"
If value is "true", hint is defined
using "hintText" and/or
"hintMedia"; SEE MEDIA
OPTIONS
31
Formative Assessment Tools
Understanding Formative Assessment Tools
"allowPartial"
Allow partially correct
answers
Boolean
Used when a question has
multiple answers (either "Fill In
the Blank", "All That Apply", or
"Math") and a
"maxScoreValue" value greater
than "1"
"subtractWrong"
Set if wrong answers
subtract from score
Boolean
Applies to questions with
multiple answers
"showQuestions"
Set the number of
questions that appear
Integer
"preQuizText"
Enter the contents of the
String
text box that displays on the
pre-activity page
To omit, set the value to
"none"; to skip the pre-activity
page, set the value to "none"
for "preQuizText" and
"preQuizMedia"
"preQuizMedia"
Add media to the
pre-activity page
To omit, set the value to
"none"; to skip the pre-activity
page, set the value to "none"
for "preQuizText" and
"preQuizMedia"; SEE MEDIA
OPTIONS (use a separate
object for each content piece)
"postQuizText"
Enter the contents of the
String
text box that displays on the
post-activity page
To omit, set the value to
"none"
"postQuizMedia"
Add media to the
post-activity page
To omit, set the value to
"none"; SEE MEDIA OPTIONS
(use a separate object for each
content piece)
© 2017 by D2L Corporation. All rights reserved.
Array
Array
32
Formative Assessment Tools
Understanding Formative Assessment Tools
Additional Data R e fe re nce s for Inl ine Quiz
Use the following data values and array data values when you modify the JSON file to create your activity. For more
information, see Create an activity (on page 56).
Question and Answer Options:
Data Value
Array Data Value
Action
Type
Notes
Specify the questions
for the activity
Array
Use a separate object
for each question
"questionType"
Set the type of
question
String
Set value to "Multiple
Choice", "All That
Apply", "Fill In The
Blank", or "Math"
"maxScoreValue"
Set the max score for
the question
Integer
Use for #/# scores; the
value should not
exceed the number of
correct answers
"questionText"
Enter the text for the
question
String
When the value for
"questionType" is "Fill
In The Blank" or
"Math", indicate where
you want your blanks
to be using "BLANK"
and the numerical
order they appear; for
example, "My name is
Justin BLANK1, and this
is a BLANK2."
"hintText"
Enter the contents of
the text box in the
question's hint
String
To omit, set the value
to "none"
"hintMedia"
Add the media
elements that appear
in the question's hint
Array
To omit, set the value
to "none"; SEE MEDIA
OPTIONS (use a
separate object for
each content piece)
"Questions"
© 2017 by D2L Corporation. All rights reserved.
33
Formative Assessment Tools
Understanding Formative Assessment Tools
"answers"
Specify the answers
associated with the
current question
Array
"answers" >
"answerText"
When "questionType"
is "Multiple Choice" or
"All That Apply":
String
Use a separate object
for each answer
Enter the text for the
answer
"answers" >
"feedBack"
When "questionType"
is "Multiple Choice" or
"All That Apply":
String
To omit, set the value
to "none"
Integer
Use for indicating
correct value for a #/#
score; the score for all
the answers should not
exceed
"maxScoreValue" for
the associated question
String
Use as the comparison
to the text input; use
capital letters
String
To omit, set the value
to "none"
Add feedback
associated with the
answer
"answers" >
"scoreValue"
When "questionType"
is "Multiple Choice" or
"All That Apply":
Set the value
associated with the
answer
"answers" >
"answerText"
When "questionType"
is "Fill In The Blank":
Enter the text for the
answer
"answers" >
"feedBack"
When "questionType"
is "Fill In The Blank":
Add feedback
associated with the
answer
© 2017 by D2L Corporation. All rights reserved.
34
Formative Assessment Tools
Understanding Formative Assessment Tools
"answers" >
"scoreValue"
When "questionType"
is "Fill In The Blank":
Integer
Use for indicating
correct value for a #/#
score; the score for all
the answers should not
exceed
"maxScoreValue" for
the associated question
Array
Use a separate object
for each alternate
answer
String
Use as the comparison
to the text input; use
capital letters
String
To omit, set the value
to "none"
Integer
Use for #/# scores; the
score for all the
answers should not
exceed the
"maxScoreValue" for
the associated question
Integer
Use as the comparison
to the text input; use
only numbers or
negative numbers
Set the value
associated with the
answer
"answers" >
"altAnswers"
When "questionType"
is "Fill In The Blank":
Set the alternate
answers associated
with the current
question
"answers" >
"altAnswers" >
"answerText"
"questionType" is "Fill
In The Blank":
"answers" >
"altAnswers" >
"feedBack"
"questionType" is "Fill
In The Blank":
"answers" >
"altAnswers" >
"scoreValue"
"questionType" = "Fill
In The Blank":
"answers" >
"answerText"
"questionType" =
"Math":
Enter the text for the
alternate answer
Add feedback
associated with the
alternate answer
Set the value
associated with the
alternate answer
Set the number for the
answer
© 2017 by D2L Corporation. All rights reserved.
35
Formative Assessment Tools
Understanding Formative Assessment Tools
"answers" >
"feedBack"
"questionType" =
"Math":
String
To omit, set the value
to "none"
Integer
Use for indicating
correct value for a #/#
score; the score for all
the answers should not
exceed
"maxScoreValue" for
the associated question
Array
Use a separate object
for each alternate
answer
String
Use as the comparison
to the text input; use
capital letters
String
To omit, set the value
to "none"
Integer
Use for #/# scores; the
score for all the
answers should not
exceed the
"maxScoreValue" for
the associated question
Add feedback
associated with the
answer
"answers" >
"scoreValue"
"questionType" =
"Math":
Set the value
associated with the
answer
"answers" >
"altAnswers"
"questionType" =
"Math":
Set the alternate
answers associated
with the current
question
"answers" >
"altAnswers" >
"answerText"
"questionType" =
"Math":
"answers" >
"altAnswers" >
"feedBack"
"questionType" =
"Math":
"answers" >
"altAnswers" >
"scoreValue"
"questionType" =
"Math":
© 2017 by D2L Corporation. All rights reserved.
Enter the text for the
alternate answer
Add feedback for the
alternate answer
Set the value
associated with the
alternate answer
36
Formative Assessment Tools
Understanding Formative Assessment Tools
Media Options:
Data Value
Array Data Value
Action
Type
Notes
Set the type of content
piece
String
Available types: "link",
"image",
"YouTubeVideo", and
"text" (see below)
"link"
Embed external links
String
"link" > "src"
Set the url/source for
the link
String
"link" > "description" Add a description for
the link
String
"image"
Embed images
String
"image" > "src"
Set the
source/location/url for
the image
String
"image" >
"description"
Add the
text/description used
for the alt-attribute for
the image
String
"image" >
"mediaLink"
Set the url/source you
want the image to link
to
String
Only use if you want
the image to be a link;
to omit, set the value
to "none"
"image" > "width"
Set a custom width for
the image (in pixels)
Number
Set the value to "none"
for a default width of
420 pixels
"image" > "height"
Set a custom height for Number
the image (in pixels)
Set the value to "none"
for a default height of
315 pixels.
"YouTubeVideo"
Embed YouTube videos String
"type"
© 2017 by D2L Corporation. All rights reserved.
37
Formative Assessment Tools
Understanding Formative Assessment Tools
"YouTubeVideo" >
"src"
Set the source/url of
the YouTube video
String
"YouTubeVideo" >
"altLink"
Set the url/source for
String
the alternative content
for the video
Use to provide an
accessible alternative
to a video, for example,
a transcript for a video
"YouTubeVideo" >
"width"
Set a custom width for
the video (in pixels)
Number
Set the value to "none"
for a default width of
420 pixels
"YouTubeVideo" >
"height"
Set a custom height for Number
the video (in pixels)
Set the value to "none"
for a default height of
315 pixels
"text"
Embed text
String
"text" > "content"
Enter the text to
display
String
Matching and Categorization
About the Matching and Cat e g orizat ion t ool
The Matching and Categorization tool enables instructors to create engaging formative self assessments for learners.
Learners use their mouse or keyboard to move images and textboxes to their correct drop zones. You can also add
media to pre- and post-activity pages to make instruction even more unique and informative.
You can create two different kinds of activities with this formative assessment tool:
 Matching activity - has a one-to-one ratio between items and drop zones.
 Categorization activity - has multiple items that correspond to each drop zone. The number of items that belong in
each category displays in the category heading.
The Matching and Categorization tool works well for delivering and assessing lower order cognitive processes in
learners such as remembering and understanding facts. For example, you can ask learners to match key vocabulary
terms with their definitions even before they are formally taught. This can be an engaging way to introduce a lot of new
terminology in one activity.
You can test higher order cognitive processes through Matching and Categorization activities by increasing the
complexity of the content in your draggable items and anchor items. For example, you might ask learners to analyze
quotes from customer service representatives and categorize them as either good or poor customer service. You could
also ask learners in an English class to evaluate a sentence's punctuation and match it to the missing punctuation mark.
© 2017 by D2L Corporation. All rights reserved.
38
Formative Assessment Tools
Understanding Formative Assessment Tools
Matching and Cate g orization ove r vie w
You can design either a Matching or a Categorization activity using this tool. You can choose the arrangement of the
items and the drop zones for both activities, that is, they can be lined up beside one another, or the items on top and
drop zones side-by-side under them. The following screenshot shows a Matching activity with three items and three
drop zones arranged horizontally, with one item already moved into its corresponding drop zone:
Figure 9: Matching activity showing side-by-side arrangement of items and drop zones
The following screenshot shows a Categorization activity with eight items and two drop zones arranged horizontally,
with three items already moved into their corresponding drop zones:
© 2017 by D2L Corporation. All rights reserved.
39
Formative Assessment Tools
Understanding Formative Assessment Tools
Figure 10: Categorization activity showing side-by-side arrangement of items and drop zones
You can set up Matching and Categorization activities to provide continuous feedback or report feedback. If you choose
to provide report feedback, you can include different feedback messages for each response, whether correct or
incorrect. If you choose to provide continuous feedback, learners simply see if their match/categorization is correct or
incorrect with check marks and X's. The following screenshot shows the results and report feedback for a Matching
activity:
© 2017 by D2L Corporation. All rights reserved.
40
Formative Assessment Tools
Understanding Formative Assessment Tools
Figure 11: Matching activity showing report feedback option
The following screenshot shows the results and report feedback for a Categorization activity:
© 2017 by D2L Corporation. All rights reserved.
41
Formative Assessment Tools
Understanding Formative Assessment Tools
Figure 12: Categorization activity showing report feedback option
© 2017 by D2L Corporation. All rights reserved.
42
Formative Assessment Tools
Understanding Formative Assessment Tools
Best practi ces for de ve loping a Mat ching or Categorizat ion activ ity
To provide users with an optimal experience, D2L recommends the following when developing your Matching or
Categorization activity:
 Although the number of draggable items or drop zones is not limited, you should restrict the number so that all the
content fits within the screen. Use nine draggable items or less. Use 3 drop zones or less for categorization
activities, and 9 items or less for matching activities.
Note: If you use images for these items/zones, you might want to restrict these numbers further.
 Select images with an appropriate resolution. Images resize to fit the space of the drop zones by scaling down but
they do not scale up.
 In general, avoid using only images to identify the items because the images might become too small for learners
to be able to see clearly.
 If you only include images, or the accompanying text is not sufficiently explanatory, use alternate text.
 This tool is best applied when there are clear distinctions in the content. Matching and Categorization activities do
not apply well to opinion-based content, or items that might align with two or more categories or matches. The
Graphic Multi-Select Interactive tool is better suited for these applications.
 Determine how much feedback you want to provide to determine whether to use continuous or report feedback:
 Continuous: checkmarks and X's show which answers are correct and incorrect.
 Report: the report screen provides an opportunity to deliver more text feedback, and it can be different for
correct and incorrect answers.
© 2017 by D2L Corporation. All rights reserved.
43
Formative Assessment Tools
Understanding Formative Assessment Tools
General Data Re fe re nce s fo r Mat ching and Categorizat ion
Use the following data values when you modify the JSON file to create your activity. For more information, see Create
an activity (on page 56).
Data Value
Action
Type
"ActivityName"
Set a name for the activity
to appear in the title
String
"Instructions"
Provide instructions for the
whole activity
String
"HeadingLevel"
Set the heading level for the Integer
activity name
The maximum heading level is
"3"
"ActivityType"
Indicate the type of activity
String
Either "match" or "sort"
"FeedbackType"
Set the type of feedback
String
Either "continuous" or "report"
"HighlightEffect"
Set whether draggable
items have a hover/focus
effect
Boolean
"QuestionColumns"
Set how many columns the
draggable items are
distributed between
Integer
"HorizontalAlignment"
Set the activity orientation
Boolean
"Randomize"
Randomize the order the
draggable items appear
Boolean
"DefaultColor"
Set the default color of all
draggable items
String
Given as a hex code (#)
"DefaultHighlightColor"
Set the default highlight
colour for all draggable
items
String
Given as a hex code (#)
"DefaultSelectColor"
Set the default selected
colour for all draggable
items
String
Given as a hex code (#)
© 2017 by D2L Corporation. All rights reserved.
Notes
For horizontal alignment, set
the value to "true"; for vertical
alignment, set the value to
"false"
44
Formative Assessment Tools
Understanding Formative Assessment Tools
"PreActivityText"
Set text that appears before String
the activity
To omit, set the value to
“none”; to skip the pre-activity
page, set the value to “none”
for “PreActivityText” and
“PreActivityMedia”
"PreActivityMedia"
Add media that appears
before the activity
Array
To omit, set the value to
“none”; to skip the pre-activity
page, set the value to “none”
for “PreActivityText” and
“PreActivityMedia”; SEE MEDIA
OPTIONS (use a separate
object for content piece)
"PostActivityText"
Set text that appears after
the activity
String
To omit, set the value to
“none”
"PostActivityMedia"
Add media that appears
after the activity
Array
To omit, set the value to
“none”; SEE MEDIA OPTIONS
(use a separate object for
content piece)
Additional Data R e fe re nce s for Mat ching and Categorization
Use the following data values and array data values when you modify the JSON file to create your activity. For more
information, see Create an activity (on page 56).
Question and Answer Options:
Data Value
Array Data Value
Action
Type
Notes
Add the drop zones
Array
Use a separate object
for each drop zone
"key"
Set the unique key (id)
of the drop zone
String
Value must match
"answer" in the
"QuestionNodes"
object it corresponds
with
"title"
Add the text/title for
the drop zone
String
"AnswerNodes"
© 2017 by D2L Corporation. All rights reserved.
45
Formative Assessment Tools
Understanding Formative Assessment Tools
"color"
Set the color of the
drop zone
String
The value of "default"
provides hex code
#00A1AF; otherwise,
enter a hex code (#)
"src"
Set the
source/location/url for
the drop zone's
background image
String
Only use if you want
the image to be a link;
to omit, set the value
to "none"
Add the draggable
items
Array
Use a separate object
for each draggable item
"question"
Enter the text that
appears on the
draggable item
String
If "type" is set to
"image", set the value
to "none"
"answer"
Set the answer for the
draggable item
String
Value must match
"key" in the
"AnswerNodes" object
it corresponds with
"type"
Specify the type of
draggable item
String
Either "text" or "image"
"color"
Set the color of the
draggable item
String
Set the value to
"default" to use hex
code provided in
"DefaultColor";
otherwise, enter a hex
code (#)
"src"
Set the
source/location/url for
the draggable item's
image
String
If "type" is set to "text",
set the value to "none"
"alt"
Enter the alternate text String
for the image
If "type" is set to "text",
set the value to "none"
"correct"
Enter the feedback text String
that displays if this
draggable item was
placed correctly
Only used when
"FeedbackType" is set
to "report"; to omit, set
the value to "none"
"QuestionNodes"
© 2017 by D2L Corporation. All rights reserved.
46
Formative Assessment Tools
Understanding Formative Assessment Tools
"wrong"
Enter the feedback text String
that displays if this
draggable item was
placed incorrectly
Only used when
"FeedbackType" is set
to "report"; to omit, set
the value to "none"
Array Data Value
Action
Type
Notes
Set the type of content
piece
String
Available types: "link",
"image",
"YouTubeVideo", and
"text" (see below)
"link"
Embed external links
String
"link" > "src"
Set the url/source for
the link
String
"link" > "description" Add a description for
the link
String
"image"
Embed images
String
"image" > "src"
Set the
source/location/url for
the image
String
"image" >
"description"
Add the
text/description used
for the alt-attribute for
the image
String
"image" >
"mediaLink"
Set the url/source you
want the image to link
to
String
Only use if you want
the image to be a link;
to omit, set the value
to "none"
"image" > "width"
Set a custom width for
the image (in pixels)
Number
Set the value to "none"
for a default width of
420 pixels
Media Options:
Data Value
"type"
© 2017 by D2L Corporation. All rights reserved.
47
Formative Assessment Tools
Understanding Formative Assessment Tools
"image" > "height"
Set a custom height for Number
the image (in pixels)
Set the value to "none"
for a default height of
315 pixels.
"YouTubeVideo"
Embed YouTube videos String
"YouTubeVideo" >
"src"
Set the source/url of
the YouTube video
"YouTubeVideo" >
"altLink"
Set the url/source for
String
the alternative content
for the video
Use to provide an
accessible alternative
to a video, for example,
a transcript for a video
"YouTubeVideo" >
"width"
Set a custom width for
the video (in pixels)
Number
Set the value to "none"
for a default width of
420 pixels
"YouTubeVideo" >
"height"
Set a custom height for Number
the video (in pixels)
Set the value to "none"
for a default height of
315 pixels
"text"
Embed text
String
"text" > "content"
Enter the text to
display
String
String
Sequencing Interactive
About the Sequencing Int e ract ive t ool
The Sequencing Interactive tool enables instructors to give learners self-assessment opportunities in an activity that has
a clean, modern user interface and customizable features. The activity can exist in the course as a regular topic page or
embedded within content.
Learners use their mouse or keyboard to rearrange the order of a series of items by dragging them to align with anchor
items to indicate a position within the sequence. The titles on the anchor items are customizable, so this activity does
not need to be limited to content that follows a "Step 1, Step 2" structure. Since the activity is dynamic and the tiles
displace to the next anchor if an item is dropped in its place, this activity type can be applied to prioritization, ranking,
and even processes.
Se quencing Inte ract ive ove rv ie w
You can set up your Sequencing activity to provide continuous feedback or report feedback. Continuous feedback is
indicated by green or red bars on the bottom of the tiles, and report feedback shows results and feedback for all items
© 2017 by D2L Corporation. All rights reserved.
48
Formative Assessment Tools
Understanding Formative Assessment Tools
on one page. The following screenshot shows an activity with five items to sequence and continuous feedback
indicators:
Figure 13: Sequencing activity showing continuous feedback option
© 2017 by D2L Corporation. All rights reserved.
49
Formative Assessment Tools
Understanding Formative Assessment Tools
The following screenshot shows report feedback for a Sequencing activity:
Figure 14: Sequencing activity with report feedback option
© 2017 by D2L Corporation. All rights reserved.
50
Formative Assessment Tools
Understanding Formative Assessment Tools
Best practi ces for de ve loping a Se quencing Interacti ve acti vit y
To provide users with an optimal experience, D2L recommends the following when developing your Sequencing
Interactive activity:
 If possible, use horizontal sequencing and limit the number of items in the sequence to six so that all of your
content fits on the page.
 You can use text, image, or text and image for the items learners drag into sequence. If you use images, make them
highly effective. If you include images only, or the accompanying text is not sufficiently explanatory, include
alternate text.
 Remember that images for draggable items scale down but do not scale up. Portrait orientation images work
better than landscape images for activities with more than four steps.
 Determine how much feedback you want to provide to determine whether to use continuous or report feedback:
 Continuous: colour-coded feedback shows which answers are correct and incorrect.
 Report: the report screen provides an opportunity to deliver more text feedback, and it can be different for
correct and incorrect answers.
© 2017 by D2L Corporation. All rights reserved.
51
Formative Assessment Tools
Understanding Formative Assessment Tools
General Data Re fe re nce s fo r Se qu e ncing Interacti ve
Use the following data values when you modify the JSON file to create your activity. For more information, see Create
an activity (on page 56).
Data Value
Action
Type
"ActivityName"
Set a name for the activity
to appear in the title
String
"HeadingLevel"
Set the heading level for the Integer
activity name
"Instructions"
Provide instructions for the
whole activity
"layoutStyle"
Determine the layout of the String
activity
Set the value to "horizontal" or
"vertical"
"placeholderTitleStyle"
Set the style of the
placeholder titles
Set the value to "rectangle" or
"arrow"
"correctOrder"
Set the correct sequence of Array
sort items
"sortOrder"
Set the starting order of
sort items
Array or String Use the "id" values from
"sortItems" objects as the array
elements; set the value to
"random" to randomize the
sort items
"showSortTitle"
Determine if text displays
on an image sort item
Boolean
"sortItemsType"
Set the type of sort items
String
Set the value to "image" or
"text"
"sortItems"
Set the sort items for the
activity
Array
SEE SORT ITEM OPTIONS; use a
separate object for content
piece
© 2017 by D2L Corporation. All rights reserved.
Notes
The maximum heading level is
"3"
String
String
Use the "id" values from
"sortItems" objects as the array
elements
52
Formative Assessment Tools
Understanding Formative Assessment Tools
"PreActivityText"
Set text that appears before String
the activity
To omit, set the value to
"none"; to skip the pre-activity
page, set the value to “none”
for “PreActivityText” and
“PreActivityMedia”
"PreActivityMedia"
Add media that appears
before the activity
Array
To omit, set the value to
“none”; to skip the pre-activity
page, set the value to “none”
for “PreActivityText” and
“PreActivityMedia”; SEE MEDIA
OPTIONS (use a separate
object for content piece)
"PostActivityText"
Set text that appears after
the activity
String
To omit, set the value to
“none”
"PostActivityMedia"
Add media that appears
after the activity
Array
To omit, set the value to
“none”; SEE MEDIA OPTIONS
(use a separate object for
content piece)
© 2017 by D2L Corporation. All rights reserved.
53
Formative Assessment Tools
Understanding Formative Assessment Tools
Additional Data R e fe re nce s for Se que ncing Interacti ve
Use the following data values and array data values when you modify the JSON file to create your activity. For more
information, see Create an activity (on page 56).
Sort Item Options:
Data Value
Array Data Value
Action
Type
"correctOrder"
"id"
Set the unique id of the String
sort item
"imageSrc"
Set the file path to the
image in the sort item
"altText"
Enter the alternate text String
for the image in the
sort item
"text"
Enter the text in the
sort item
"placeHolderText"
Enter the text that
String
displays in the sort item
"correctFeedback
"
Add feedback that
String
displays if the sort item
is placed correctly
"incorrectFeedbac
k"
Add feedback that
String
appears if the sort item
is placed incorrectly
Notes
String
String
Media Options:
Data Value
Array Data Value
"type"
"link"
© 2017 by D2L Corporation. All rights reserved.
Action
Type
Notes
Set the type of content
piece
String
Available types: "link",
"image",
"YouTubeVideo", and
"text" (see below)
Embed external links
String
54
Formative Assessment Tools
Understanding Formative Assessment Tools
"link" > "src"
Set the url/source for
the link
String
"link" > "description" Add a description for
the link
String
"image"
Embed images
String
"image" > "src"
Set the
source/location/url for
the image
String
"image" >
"description"
Add the
text/description used
for the alt-attribute for
the image
String
"image" >
"mediaLink"
Set the url/source you
want the image to link
to
String
Only use if you want
the image to be a link;
to omit, set the value
to "none"
"image" > "width"
Set a custom width for
the image (in pixels)
Number
Set the value to "none"
for a default width of
420 pixels
"image" > "height"
Set a custom height for Number
the image (in pixels)
Set the value to "none"
for a default height of
315 pixels
"YouTubeVideo"
Embed YouTube videos String
"YouTubeVideo" >
"src"
Set the source/url of
the YouTube video
"YouTubeVideo" >
"altLink"
Set the url/source for
String
the alternative content
for the video
Use to provide an
accessible alternative
to a video, for example,
a transcript for a video
"YouTubeVideo" >
"width"
Set a custom width for
the video (in pixels)
Set the value to "none"
for a default width of
420 pixels
© 2017 by D2L Corporation. All rights reserved.
String
Number
55
Formative Assessment Tools
Using Formative Assessment Tools
"YouTubeVideo" >
"height"
Set a custom height for Number
the video (in pixels)
"text"
Embed text
String
"text" > "content"
Enter the text to
display
String
Set the value to "none"
for a default height of
315 pixels
Using Formative Assessment Tools
Create an activity
Before you begin the steps to create your activity, D2L recommends you fill in the blank design template you received
with your deployment package as an outline.
1.
Unzip the zipped folder of all the Formative Assessment Tools files you received from your deployment and save it
to your local drive.
2.
Open the folder for the type of Formative Assessment activity you want to create, for example, 'Matching'.
3.
Open the folder called ‘data’.
4.
In the data folder, you’ll see at least one JSON file, for example, matching-data.json. This is the default activity data
file.
5.
To create your own activity, first make a copy of the data file and give it a unique name.
6.
Modify the copy of the file to design your own activity. Refer to the design template you filled out to guide you,
and see the Data References topics in their respective tool sections for the specific values you can set.
7.
After you've input all of your desired values, save the file.
8.
Navigate up to the activity type folder level, for example, 'Matching' and notice the HTML index file(s) present.
9.
Open the HTML file and ensure it is pointing to the correct JSON file. After you have entered the correct JSON file
name, save the file.
Note: If you want to have multiple activities of the same type in the same course in Brightspace Learning
Environment, duplicate the index file for as many activities as you have, and ensure that each is pointing to a
unique JSON file.
© 2017 by D2L Corporation. All rights reserved.
56
Formative Assessment Tools
Using Formative Assessment Tools
Add a Formative Assessment activity to Brightspace Learning
Environment
1.
Zip the folder for the Formative Assessment activity type that you created, for example, zip the 'Matching' folder if
you created a Matching activity.
2.
In your instance of Brightspace Learning Environment, in the course you want to add the activity to, access Manage
Files.
3.
Open the folder you want your Formative Assessment activity file(s) to reside in, then click
4.
In the Upload dialog window, browse to the ZIP file, or drag and drop the ZIP file into the designated area.
5.
Click Save.
6.
From the context menu of the ZIP file you just added, select Unzip, and then OK.
7.
To incorporate your Formative Assessment activity into the Content tool, from the Manage Files page, click
Content.
8.
To add your activity as a topic in a module:
Upload.
1. From the Table of Contents, select the module you want to add the activity to.
2. From the Upload/Create button, select
Add from Manage Files.
3. Select the unzipped folder of the activity type you want to add.
4. Select the check box of the HTML index file corresponding to the data file you modified to create your activity.
5. Click Add.
6. Click the topic you just added to view your activity.
9.
Alternatively, to embed your activity into a topic:
1. Within your existing content topic, edit the HTML source (either with the
using a code editor).
HTML Source Editor, or locally
2. Add an IFrame to your HTML page.
3. Ensure the source attribute for the IFrame matches the path to the activity's HTML index file.
4. Style the IFrame accordingly.
5. Save your changes and overwrite your original content, as required.
10. If you want to change the title of the topic, click the title and edit the text. D2L recommends naming the topic by
the type of activity and its specific name, for example, "Matching - Types of Leadership".
© 2017 by D2L Corporation. All rights reserved.
57
Formative Assessment Tools
About D2L
About D2L
A global leader in EdTech, D2L is the creator of Brightspace, the world’s first integrated learning platform.
The company partners with thought-leading organizations to improve learning through data-driven technology that
helps deliver a personalized experience to every learner, regardless of geography or ability. D2L’s open and extensible
platform is used by more than 1,100 clients and almost 15 million individual learners in higher education, K–12,
healthcare, government, and the enterprise sector—including Fortune 1000 companies.
The company has operations in the United States, Canada, Europe, Australia, Brazil, and Singapore.
www.brightspace.com (http://www.brightspace.com) | www.D2L.com (http://www.d2l.com)
Contact Us
Phone:
1.519.772.0325 (Worldwide)
Toll Free:
1.888.772.0325 (North America)
0.808.234.4235 (United Kingdom and Europe)
0.800.452.069 (New Zealand)
1.800.656.210 (Australia)
0.800.891.4507 (Brazil)
Fax:
1.519.772.0324
Email:
[email protected]
Twitter:
@Brightspace
Web:
www.brightspace.com
(http://www.brightspace.com) | www.D2L.com
(http://www.d2l.com)
© 2017 D2L Corporation.
The D2L family of companies includes D2L Corporation, D2L Ltd, D2L Australia Pty Ltd, D2L Europe Ltd, D2L Asia Pte Ltd, and D2L Brasil Soluções de
Tecnologia para Educação Ltda.
Brightspace, D2L, and other marks ("D2L marks") are trademarks of D2L Corporation, registered in the U.S. and other countries. Please visit
d2l.com/trademarks for a list of other D2L marks.
Microsoft is a registered trademark of Microsoft Corporation in the United States and/or other countries.
© 2017 by D2L Corporation. All rights reserved.
58