Admin Guide: iClicker Classic Integrate with D2L/Brightspace

Document created by Digital Support on May 22, 2017Last modified by Digital Support on Mar 30, 2018
Version 10Show Document
  • View in full screen mode

The Integrate for Desire2Learn folder includes all the files necessary to deploy and administer iClicker integrate for your institution’s Desire2Learn server. Integrate for D2L v2.6 is designed for use with iClicker 7.7 and higher. Downloads for both Windows and Macintosh are available at the iClicker website.

Note: If your school is part of D2L’s continuous delivery releases, please see the section on Continuous Delivery Setup.


Get started with pre-setup

Make sure your instructor role permissions in D2L are set to See Usernames.
  1. Log into D2L as admin.
  2. Select Settings gear icon in the upper right corner.
  3. Select Security > Roles and Permissions.
  4. Click on the Instructor Role > Edit Role Permissions.
  5. Under filter by tool, user information privacy, check to make sure See Username is checked under Course Offering.

Note: These steps may vary depending on your version of D2L.

Return to top.


Create the student registration LTI link

Open External Learning Tools

Click on the settings cog and choose External Learning Tools.

Create New Link

Under Manage External Learning Tool Links, click New Link.

Enter link info

Enter the following information on the Edit Link form:

Add custom parameters

Click Add custom parameters and enter the following:

Check all boxes under "Security Settings"

Make sure all checkboxes under Security Settings are checked. See the image below – if any of the ten Security Settings options pictured are not shown, please do the following:
  1. Save the current iClicker registration External Learning Tool settings to return to the Manage External Learning Tools list.
  2. Click on the “Settings” gear icon on the top right of the Manage External Learning Tools page.
  3. Scroll down to the Security Settings and check all options.
  4. Click Save and Close to return to the Manage External Learning Tools list.
  5. Click on your link in the list.
  6. Check all ten items under Security Settings.

Continue by clicking Add Org Units.

Select institution and all descendants

Click the checkbox next to your institution's name, check All descendants, and then click Insert.

Double-check security settings

Check to make sure all of the security boxes are still checked. Check any that are unchecked, then click Save and Close.

Review your link

Return to top.


Configure iClicker Integrate

The iClicker LMS Admin Set-up Utility is an application that generates configuration files for your instructors using iClicker Classic. These files help your instructors to easily synchronize iClicker’s integrated gradebook with D2L.

Download and launch the Admin Setup Utility

Launch the Admin wizard application by double-clicking either iclicker-lms-adminsetup.exe (Windows) or (Macintosh).

Note: To download this file please go to the iClicker Downloads page and then scroll down to the LMS Downloads for Administrators section and choose whether you are downloading for Windows or Mac.

Select Desire2Learn from the Select your LMS drop-down menu and click Next.

Enter info, then click "Finish"

  1. Enter the desired LMS Description.
  2. If you would like to allow instructors to save their login credentials, check the box marked Allow instructors to save their login credentials for automatic login. If this box is not checked, instructors must always follow the login process from within iClicker Classic.
  3. If you would like to give instructors the ability to upload zero scores as a numeric zero rather than a null value, check this option. Instructors may experience slower performance with this option enabled.
  4. Enter your D2L domain.
    • Note: This must match the URL entered in the iClicker External Learning Tool settings exactly.
  5. Be sure that you are logged in to D2L on your computer’s default web browser. Click Login in the Admin Setup Utility. Your default browser will open and may ask for permission to continue. Click OK or Yes if prompted to grant permission.
    • Rare: If you receive an error message and need to enter your App ID and Key, click Configure ID and Key. Enter your App ID and Key and click Save.
  6. Once your credentials are authenticated, you will see a message that your credentials are verified.
  7. Click Finish.
You will now see the file LMS_Wizard.xml present in your Admin Setup Utility folder.

Note: You may configure more than one LMS if desired. Simply run the Admin Wizard for the second LMS, keeping the LMS_Wizard.xml file in place (the same folder as the Admin Wizard). The resulting LMS_Wizard.xml file will be configured for the additional LMS. Please note each LMS Description must be unique (e.g., you cannot have two LMS Descriptions named “D2L”).

Return to top.


Continuous delivery setup

Skip this section if using D2L 10.4 or earlier.

D2L roster format changed in continuous delivery releases (v10.4 and above). In order to accommodate this change, you must alter the LMS_Wizard.xml file as follows.

Open the XML file in a text editor

Note: If you are using Mac, be sure to use an app like Text Wrangler, which can handle formatting of quotes. Windows users should use Notepad or Notepad++.

Alter values

Look for the following values:
  • D2LDisplayNameFirstIndex="0"
  • D2LDisplayNameLastIndex="1"
Change the value of FirstNameIndex to 1 and the value of LastNameIndex to 0. The end result should look like:
  • D2LDisplayNameFirstIndex=“1”
  • D2LDisplayNameLastIndex=“0”


Save the XML file and distribute it as shown in the next section.

Return to top.


Package and distribute the configured software

Place the configuration file, LMS_Wizard.xml, in the Resources sub-folder of the iClicker Classic application folder.

Download iClicker Classic

Download a fresh version of iClicker Classic for each OS you will make available to your faculty (Win/Mac/Linux).

Place configuration file in Resources folder

Place the configuration file generated from the LMS Admin Set-up Utility, LMS_Wizard.xml, in the Resources sub-folder of the iClicker Classic application folder. The same xml file works for all operating systems (Win/Mac/Linux).

Place instructor user guide in application folder

Add the instructor’s user guide for using D2L with iClicker Classic in the application folder. This user guide is included with the Admin Setup download and can also be downloaded separately from the User Guide section of the website.

Compress application folder

Compress the entire application folder and make this configured version of iClicker Classic available to your faculty to download.

Note: Faculty will need to enable the External Learning Tool link by creating a module in their course content page. They will click Add Activities, choose External Learning Tools, and choose the iClicker registration link you created. These steps are outlined in our iClicker 7.14 D2L Instructor Guide.

Contact us for additional support for Brightspace/D2L-related issues.