Instructor Usage

About

The Instructor Usage data export shows how many faculty members actively use Brightspace Learning Environment and what tools they are using.

Available Filters

Filter

Description

Attributes

Parent OrgunitId

The organization unit ID of the parent course offering.

 

InstructorRoleIds

A comma-separated list that indicates which roles to include in the data export. Enter an asterisk (*) to skip this parameter and to include all roles in the data export.

 

IncludeInactiveUsers

This filter specifies whether or not to include users that have been flagged as inactive. When set to true, all users appear in the data export even if they are inactive. Otherwise, only active users are included. Enter an asterisk (*) to skip this parameter. This excludes inactive users (as with false).

true or false

IncludeInactiveCourses

This filter specifies whether or not to include courses that have been flagged as inactive. When set to true, all courses appear in the data export even if they are inactive. Otherwise, only active courses are included. Enter an asterisk (*) to skip this parameter. This excludes inactive courses (as with false).

true or false

StartDate

The start date of the data export. This filter constrains the result set based on the last date the instructor accessed the course.

yyyy-mm-dd

EndDate

The end date of the data export. This filter constrains the result set based on the last date the instructor accesses the course.

yyyy-mm-dd

DaysBack

This filter determines the start date of the data export. If an end date was also provided, this parameter determines how many days before the end date to set the start date of the export.

Integer

Returned Fields

Field Name

Description

Can be Null?

Multiple Values Supported?

If Multiple Values Supported - Delimiter

 

Username

The user's username.

N

N

 

First Name

The user's first name.

N

N

 

Last Name

The user's last name.

N

N

 

OrgDefinedID

The user's organization defined ID (often the learner identifier from an SIS system).

Y

N

 

User ID

Unique identifier for the user within Brightspace Learning Environment.

N

N

 

Role Name

The user's role at the specific course offering.

N

N

 

Role Id

The user's role ID at the specific course offering.

N

N

 

Course Offering Name

The name of the course offering.

N

N

 

Course Offering Code

This is often the course identifier from an SIS system.

Y

N

 

Course Offering Id

Unique identifier for the course offering within Brightspace Learning Environment.

N

N

 

Course Section Id

Unique identifier for the course section within Brightspace Learning Environment.

Y

N

{null}

Course Section Code

The client-defined code for the course section.

Y

N

{null}

Course Section Name

The name of the course section.

Y

N

{null}

Number of Content Topics

The number of content topics in the course offering.

N

N

 

Number of Content Topics Visited

The number of content topics this user has visited in this course offering.

N

N

 

Last Access to Course Offering Content

The last date / time this user last accessed content within this course offering.

Y

N

 

Number of Dropboxes

The number of assignments in this course offering.

N

N

 

Number of Dropbox Submissions Commented On

The number of assignment submissions this user has commented on in this course offering.

N

N

 

Number of Grade Items

The number of grade items in this course offering.

N

N

 

Number of Graded Grade Items

The number of grade items this user has graded in this course offering.

N

N

 

Last Modification of a Grade Item

The last date / time a grade item in this course was modified by this user.

Y

N

 

Number of Discussion Posts

The number of discussion posts in this course offering.

N

N

 

Number of Discussion Posts Authored

The number of discussion posts this user has authored in this course offering.

N

N

 

Last Discussion Post Date

The date / time this user last posted a discussion in this course

Y

N

 

Last Access to Course Offering

The last time this user accessed this course offering (in UTC format).

Y

N

 

Number of Logins to the System

The number of times this user accessed Brightspace Learning Environment.

N

N

 

Last Sent Mail Date

The date the instructor last sent an email from within the course offering.

Y

N

 

Sample output file

Data export instructor usage output file

Sample request file

<request>

<report>InstructorUsageExport</report>

<filename>InstructorUsageExport_%d_%t.csv</filename>

<courses>

<parent orgunitid="6606" />

</courses>

<parameter>

<name>InstructorRoleIds</name>

<value> </value>

</parameter>

<parameter>

<name>IncludeInactiveUsers</name>

<value>false</value>

</parameter>

<parameter>

<name>IncludeInactiveCourses</name>

<value>false</value>

</parameter>

</request>