Desire2Learn Organization Management Environment (DOME) v8.3

Administration Guide Third edition: November 14, 2008

Desire2Learn Organization Management Environment (DOME) v8.3.1

© 2008 by Desire2Learn, Inc. All rights reserved

© 2008 by Desire2Learn, Inc. All rights reserved.

305 King Street West, Suite 200 Kitchener, Ontario N2G 1B9 Canada

www.Desire2Learn.com

Please send feedback on Desire2Learn documentation to: [email protected].

http://www.desire2learn.com/

mailto:[email protected]

© 2008 by Desire2Learn, Inc. All rights reserved iii

Contents

About this guide .................................................................................................................... 6

Audience ................................................................................................................................... 6

Related guides ......................................................................................................................... 6

What is the DOME? ............................................................................................................... 7

Accessing the DOME ............................................................................................................ 9

Key terms and concepts .......................................................................................................... 9

Setting up DOME permissions ............................................................................................... 10

Managing configuration variables .................................................................................... 11

Types of configuration variables ........................................................................................... 11

Org (Organization) .................................................................................................... 11

Org Unit ..................................................................................................................... 12

User .......................................................................................................................... 13

User–Org Unit ........................................................................................................... 13

Session ..................................................................................................................... 14

Role–Org Unit ........................................................................................................... 14

Summary .................................................................................................................. 14

Finding configuration variables ............................................................................................. 15

Folders and prefixes ................................................................................................ 15

How variables are organized ................................................................................... 15

Editing configuration variables .............................................................................................. 16

Variables in ALL_CAPS ............................................................................................. 16

All other variables .................................................................................................... 17

The Org Unit Type Editor: setting up your organization hierarchy .................................. 19

Standard org unit types ......................................................................................................... 19

The role of standard types in the organization structure ...................................... 19

Are they required? ................................................................................................... 20

Child org units ........................................................................................................................ 20

Sample organization hierarchy .............................................................................................. 21

© 2008 by Desire2Learn, Inc. All rights reserved iv

Creating a new org unit type .................................................................................................. 21

Editing an existing org unit type ............................................................................................ 23

Changing your org unit type icons ......................................................................................... 23

Deleting an existing org unit type .......................................................................................... 24

The Org Unit Editor: managing org units .......................................................................... 25

Viewing org units: options ...................................................................................................... 25

Searching for org units........................................................................................................... 25

Deleting org units ................................................................................................................... 26

The Org Unit Recycler (restoring org units) ............................................................. 26

Modifying org unit properties ................................................................................................ 26

Management Quick Links: configuring the learning environment directly from the DOME ...................................................................................................................................... 27

Managing parent/child org units ........................................................................................... 28

Editing multiple child org units ................................................................................ 28

Adding a child org unit ............................................................................................. 29

Removing a child from a parent org unit (orphaning a child) ................................ 29

Moving child org units manually ............................................................................. 30

Moving child org units automatically (using the clipboard) ................................... 30

Changing org unit colors ........................................................................................................ 30

Org unit utilities ...................................................................................................................... 31

Scan for org units without children ......................................................................... 31

Scan for orphaned org units .................................................................................... 32

Managing Form Elements ................................................................................................. 33

Modifying forms ...................................................................................................................... 34

Managing organization tools ............................................................................................ 35

Adding tools ............................................................................................................................ 35

Removing tools ....................................................................................................................... 35

Setting a tool’s default state ................................................................................................. 35

Renaming tools ...................................................................................................................... 36

© 2008 by Desire2Learn, Inc. All rights reserved v

Configuration variables in 8.3.1 ....................................................................................... 37

Appendix A: Addenda ......................................................................................................... 68

8.3.1 MR1 .............................................................................................................................. 68

Appendix B: Revision History ............................................................................................ 69

Index ................................................................................................................................... 70

DOME v.8.3.1 Administration Guide About this guide

© 2008 by Desire2Learn, Inc. All rights reserved 6

About this guide

This guide contains information about setting up and configuring the Desire2Learn Platform using the DOME tool.

Audience This guide is intended for anyone involved in administering the Desire2Learn Organization Management Environment (DOME).

Important Access to features in the Desire2Learn Learning Environment is dependent on your permissions. You may not have sufficient permissions to access all of the features described in this guide.

Related guides Desire2Learn documentation is available in the Documentation Library on the Desire2Learn Community website: http://community.desire2learn.com. (Enrollment in the Desire2Learn Community is required to access this site. Information about enrollment can be found on the Community login page.)

DOME v.8.3.1 Administration Guide What is the DOME?


What is the DOME?

The Desire2Learn Organization Management Environment, or DOME, is a control panel that allows you to manage your organizational structure and system configurations.

Configuration Variables

Configuration Variables help you to define how you want Desire2Learn to operate. They let you specify—among many other things—where Desire2Learn should look for 3rd party software, how various tools are configured, and what preferences users should have.

The Configuration Variable Browser has a folder/subfolder structure for browsing the multiple configuration variables used to operate and configure Desire2Learn.

The effect of a variable depends on its scope. Variables can be specific to all organizations in an instance, all Org Units in an organization, an individual Org Unit, or a user. (See Types of configuration variables, p. 11, for complete information.)

Org Unit Properties

Org Unit properties contain information about Org Units at a high level, including:

• Org Unit Name.

• Org Unit Code – must be created FIRST in the DOME (before SIS integration) and must be unique for departments and courses if you are integrated with SIS/UIS.

• Org Unit Path.

• Any children/parents of the Org Unit.

In the Org Unit Editor, you can:

• Edit Org Unit properties.

• Edit tools associated with an Org Unit.

• Enroll/unenroll users from an Org Unit.

• View/edit Org Unit homepages and navbars.

• Move Org Units around in the organizational structure.

• Delete Org Units.

• Change the colors used on an Org Unit homepage.

DOME v.8.3.1 Administration Guide What is the DOME?


Org Unit Utilities In addition to modifying Org Unit properties, in the DOME you can:

• Search for Org Units based on the Org Unit type.

• Restore deleted Org Units to their original place in the org structure.

• Search for Org Units that have no children (useful for finding unused course templates).

• Search for Org Units that have no parents (useful for finding Org Units that cannot be found anywhere else in the system).

Org Unit Type Editor

The Org Unit Type Editor allows you modify different types of organizational units within a larger organization (e.g. department, course template). Here you can set up your organization hierarchy. For example, your organization may use Schools in place of Departments, and each school might be grouped into a College.

Form Elements

Form Elements allow you to manipulate fields that you want to customize and enable or disable from user view.

Refer to the section Managing Form Elements, p. 33, for detailed descriptions and definitions.

DOME v.8.3.1 Administration Guide Accessing the DOME


Accessing the DOME

The DOME utilizes much of the same organizational principles as Windows Explorer. It is hierarchy-based, and operates on the root/sub-folder organization principle.

You can access the DOME by clicking the DOME link in the My Admin Tools widget on your My Home page.

The main DOME page displays a list of top level links that you can use to navigate through the DOME’s folder structure. Depending on your permissions you may not see all of the links.

DOME folder structure

Key terms and concepts The following table explains the terms used to describe functions or areas in the DOME.

DOME structure

Term/Concept Description

Org Unit Type Org Unit types are different types of organizational units within an organization (e.g. department, course template).

There are five default Org Unit Types: Semester, Course Template, Course Offering, Group, and Section.

Organizational Unit (Org Unit) Organizational units define the structure of an institution. Each Org Unit is an instance of a particular Org Unit Type (e.g. ‘Fall 2006’ and ‘Winter 2007’ could both be semesters—different org units, but the same org unit type).

Parent Org Unit The top-level or “parent” Org Unit that is a level above another Org Unit. A parent can have many children. For example, a course template Org Unit can be the parent of many child course offerings.

DOME v.8.3.1 Administration Guide Accessing the DOME


Term/Concept Description

Child Org Unit Sub-levels of an Org Unit. Some children can have several parents. For example, a course offering is the child of a Course Template as well as a Semester.

Orphaned Org Unit An org unit not attached to any parent. (E.g. a course offering that was separated from its associated course template, perhaps because the template was deleted.)

Config The short term for configuration.

Navbar The short term for navigation bar, which refers to the menu across the top of your website.

The navigation bar contains links to all areas of the site and is completely customizable, including layout, colours, logos, link text, etc.

Homepage This is the page that a user sees first when they enter an Org Unit.

Setting up DOME permissions You must have the applicable permissions to the DOME (defined using the Roles and Permissions tool) to view the DOME-applicable functions via the Desire2Learn interface.

Refer to the Roles and Permissions Guide for complete details about all permissions. DOME user security permissions can be found in the Roles and Permissions tool accessible from the My Admin Tools widget on your My Home Page.

Note Access to the applicable permissions is generally limited to high-level site administration. Please contact your Desire2Learn Account Manager if you require access to (but currently cannot see or modify) specific DOME variables.

DOME v.8.3.1 Administration Guide Managing configuration variables


Managing configuration variables

The Config Variable Browser allows you to view and modify configuration settings for your organization, including organization-wide settings, settings for individual org units, and settings for users.

Note Depending on your permissions, some configuration variables may be read-only, while others may not be visible at all. Specifying which variables are read-only and which are visible can only be done by high-level administration. If you require additional access, contact site administration or your Desire2Learn Account Manager.

Types of configuration variables There are a number of different types of configuration variables. The scope of a variable’s effect (the org units and users affected) and the way the variable is edited through the DOME are determined by its type. A variable’s type is listed with its other properties in the right pane when it is selected.

Variable Type field highlighted in a Variable Properties list

This section describes each of the seven variable types, including an explanation of what will happen when each type of variable is edited through the DOME.

Org (Organization) Org variables are settings that apply to the entire organization. When an Org setting is changed, it immediately affects all users and all org units in the organization.

For example, the setting d2l.Tools.Content.HasComments is an Org variable that controls whether users can add comments when editing content modules and topics. If



this setting is disabled, it will immediately affect all org units and all users—no one will be able to add comments to any module or topic anywhere in the organization.

Org Unit With Org Unit variables, each org unit can have its own value or setting for each variable (for example, “Anthropology 101” and “English 101” could have different settings). When updating an Org Unit variable in the DOME, you first select the org unit you want to apply the value to and then specify the value. The new setting is applied to that org unit immediately, and will not affect any other org units.

The only exception to this is the value for the organization—this value applies to the organization itself (as an individual org unit) and also serves as the default for all other org units that have not specified their own value. When the value for the organization is changed, all other org units using the default value are affected immediately.

When viewing an Org Unit variable, the current value for each org unit is displayed in the Values table. Org units using the default value are not displayed. (When the value for the organization is edited, the new value will be applied to all org units not listed in the Values table.)

In many cases, Org Unit settings can be modified through an interface within each org unit, so that users can modify these values without requiring access to the DOME.

For example, the variable d2l.Tools.Competencies.Users.ActVisible is an Org Unit variable that determines whether competency activities are displayed to users on the Competency Results page. This value can be different for different org units; activities might be visible to users taking a course in one course offering, but not in another. When a user modifies this value through the Settings page, the org unit where the value has been modified is added to the Values table for the variable in the DOME, along with the specified value.

Org Unit Variable with a list of Org Units that have been modified from the default settings



User User variables store the values for settings specific to each user in your organization. In most cases, users are able to change their own settings through the interface.

Unlike Org Unit variables, the values for individual users are not displayed in the DOME, nor are you able to change the settings for individual users through the DOME. With User variables, the only thing you can do through the DOME is change the value for the organization, which is applied to new users created after the setting is changed and existing users who have not yet accessed the associated functionality.

Variable Properties for updating the Organization association for new users

For example, the variable d2l.Tools.Discuss.ShowPreviewPane is a User variable for the Discussions tool that controls whether discussion messages are displayed in a preview pane or a pop-up window. By changing the value of this variable for the organization, you can control whether the preview pane is displayed for new users and users who have not yet accessed the Discussions tool. Users can change this setting through the Display Options dialog in the message list.

User–Org Unit User–Org Unit variables store the values for personal settings users can specify on an org-unit by org-unit basis (i.e. users can specify a different value in each org unit).

In the DOME, these variables work just like User variables in that you cannot see or modify settings for individual users, and setting the value for the organization changes the option for new users and users who have not yet accessed the associated functionality (for all org units).

For example, the variable d2l.Tools.Grades.GradesList.ShowFinalGradeAtStart controls whether topic descriptions are displayed in the message list. Users can change this setting for each org unit through the Discussions Settings page. Changing this setting for the organization through the DOME controls whether users see descriptions when they first access the tool.

System variables are settings that apply to all organizations on the same instance. These are global configuration settings for the Learning Environment. Most organizations only allow high-level site administration to edit system variables. Lower-level users should not be able to see these variables, or should see read-only copies.



Session Session variables store temporary information about a user’s current actions; their values expire when the user logs out of the system. While these variables appear in the DOME, they cannot be updated, nor can you see individual values for specific users.

Role–Org Unit Role–Org Unit variables apply to specific user roles. These variables are configured by selecting a role and then setting the value for that role. The value is immediately applied to all users enrolled in the organization in that role.

For example, the variable d2l.Tools.Mail.StorageSpace is a Role–Org Unit variable that controls the maximum space available for saved email messages. This value can be set for each role, so that you can provide different amounts of storage space to different roles in your organization.

Summary The following table summarizes information about the different config variable types.

Config variable types

Type Values are set for Users affected by changes

Org units affected by changes

Org Organization All All

OrgUnit Individual org units All *Select org unit only

User Organization New users (not yet created) and existing users who have not yet accessed the associated functionality

All

User – OrgUnit

Organization New users (not yet created) and existing users who have not yet accessed the associated functionality

All

System System All All

Session n/a n/a n/a

Role – OrgUnit

Individual roles All users enrolled in the organization in the selected role

All

* When the value for the organization is changed, all org units using the value (i.e. ones without their own settings) are also affected.



Finding configuration variables Configuration Variables are organized into folders and subfolders and are accessible through the tree structure in the left pane of the DOME, beneath the Config Variable Browser node. Folders are indicated by the Files icon, while variables are indicated by the Variable icon.

When you expand the Config Variable Browser (by clicking the plus sign beside it), two nodes appear:

• All Variables Beneath this node you will find all configuration variables organized into their respective folders and subfolders.

• By Type Beneath this node you will find four more nodes corresponding to the four most common types of variables: Session, User, Org Unit, and Organization. Each node acts as a kind of filter displaying only variables of the corresponding type. For example, beneath the User node, you will find all User variables organized into their folders and sub-folders.

Note Session, User–OrgUnit, and Role–OrgUnit variables are not accessible by type.

When you select a variable, its properties and values are displayed in the right pane.

Folders and prefixes In Desire2Learn, the folders and subfolders in which a variable appears are encompassed into the variable’s name as a series of prefixes separated by periods. For example, the variable pictured below, “Attachments,” is accessible through Folders > Mail. The full name for this variable is therefore d2l.Folders.Mail.Attachments.

Folder path to d2l.Folders.Mail.Attachments

The prefix “d2l” is added to all variables. All other prefixes represent the path to the variable, the location where the variable is located.

(Variables listed in ALL_CAPS have no prefixes in their official names. For example, the variable CLASSLIST_HAS_EMAIL appears under d2l.Tools.Classlist, even thought its official name has no prefixes. This is a legacy issue that stems from the way these variables are handled in the architecture.)

How variables are organized Configuration variables are organized into a number of different top-level folders. Each of these folders contains variables that are functionally related in some way, as described in the following table.



Organization of configuration variables

Variable found in Do this

3rd Party Specify locations and parameters for 3rd party products Desire2Learn depends on.

Auth Control external (custom) authentication mechanisms (e.g. LDAP).

Folders Specify the location of the folder where email attachments are stored.

Languages Allow users to specify the language used across Org Units in Desire2Learn.

Preferences Define preferences for newly created users in Desire2Learn.

Security Allow you to restrict access to course offerings based on date restrictions and choose whether to display a message to users when they are locked out of their course enrolment due to date restrictions.

Settings Control miscellaneous system-wide settings.

Tools Control settings and configurable options for each tool in Desire2Learn (e.g. Grades, Quizzes, Metadata).

Editing configuration variables

Variables in ALL_CAPS Some Org variables appear in ALL_CAPS (e.g. COMPILE_FOR_PRINTING in d2l.Settings, CLASSLIST_HAS_EMAIL in d2l.Tools.Classlist). These variables are edited in a different way from the other variables in the DOME.

To Edit an ALL_CAPS Variable

1 Select the variable in the left pane.

2 Click the Edit button in the top-right corner of the right pane.

Org variable in old ALL_CAPS format

3 In the Default Value field, specify the new value.

4 Click the Save button in the top-right corner.



All other variables For most config variables (where their names do not appear in ALL_CAPS), values are modified by adding the relevant entity to the Values table and modifying its value. If the entity is already listed in the values table, you can change its value directly within the table.

The relevant entities for each type of variable are listed in the following table.

Entity values for each variable type

Variable type Entity values are set for

Org Organization

OrgUnit Individual org units (when the organization is added, its value applies to the organization as an individual org unit and also serves as the default for all other org units without their own values)

User/User-OrgUnit Organization (value serves as the option for new users not yet created and existing users who have not yet accessed the associated functionality)

Role-OrgUnit Individual user roles

Site/Session Cannot be modified by site administration

To edit a variable

1 Select the variable in the left pane.

2 If the relevant entity (organization, org unit, or user role) is already listed in the Values table, specify the new value in the Value column and click Save Values.

3 Otherwise, click Add Value at the bottom of the Values table.

4 If prompted, indicate the relevant entity (either by entering an org unit’s ID or Code, or by selecting a role) and click Next.

5 Specify the value in the Value field.

6 Click Save.



Add Value and Save Values options highlighted for Variable Properties

To restore default values

1 Select the checkboxes next to the applicable entities in the Values table.

2 Click Remove Selected Values.

When you restore the default value for an entity, the entity is removed from the Value table.

DOME v.8.3.1 Administration Guide The Org Unit Type Editor: setting up your organization hierarchy


The Org Unit Type Editor: setting up your organization hierarchy

The Org Unit Type editor is a central location from where you can manage Org Unit types. When working with Org Unit types, it is recommended to try and keep the organizational structure as simple as possible. Complicated organizational structures generally result in a need for extensive maintenance without the benefit of added functionality.

To access the Org Unit Type Editor from the main DOME page, click Org Unit Type Editor in the left tree view.

From this page you can:

• View the properties of each existing Org Unit type.

• Create new Org Unit types.

• Delete existing Org Unit types.

Standard org unit types There are two standard types of org units in Desire2Learn: Department and Semester. Each org unit type in your organization can be classified as the department-type, semester-type, or neither.

By default, the Learning Environment includes an org unit type called “Semester” and another called “Department.” You can change the names of these types or delete them and replace them with alternate types (which amounts to the same thing).

The standard type is set using the Standard Org Unit Type field when editing an org unit type. (When creating a new org unit type, this field is called Org Unit is standard.) For example, if you have a custom org unit type called Session that you want to use as the semester-type in your organization, you would set the Standard Org Unit Type to “Semester.”

Caution Do not set two different org unit types to “semester” or “department” at the same time. One org unit type should be set to the standard type “semester,” another to “department.” All other types should be set to “other.”

The role of standard types in the organization structure In the Learning Environment organization hierarchy, the department-type is the org unit type immediately above course templates; all course templates are attached to a department (i.e. an org unit whose standard type is set to “department”). Course



offerings are then attached to course templates, so that a course offering’s department is determined by the template it belongs to.

Course offerings are also attached to semesters (org units whose standard type is set to “semester”) while course templates are not. This means that different course offerings attached to the same course template can each belong to a different semester.

Are they required? You aren’t required to have an org unit type set as a semester or department. For example, if your organization uses open-ended course offerings that continue for years with new user enrolling whenever they like, then you may have no use for a semester-type.

But be aware of the following:

• If you’re using SIS Integration, the mapping process assumes that course offerings are associated with semesters and that course templates are associated with departments. If your SIS has something corresponding to semesters or departments, you will probably need to have these types in the Learning Environment as well. See the Holding Tank Features Guide and the Holding Tank Course Mapping Interface and FAQs reference guide for more information, or talk to you Desire2Learn Integration Specialist.

• If your My Courses widget has been configured to group course offerings by department or semester, the system will use the org units of the corresponding standard-type to group course offerings. If no org unit type has been set to “department” or “semester,” course offerings will not be grouped.

• When an org unit type is flagged as “semester,” org units of that type will be listed in the Semester field when creating new course offerings or editing existing ones. (This field is controlled by the Semester form element in CreateCourse and CourseOfferingInfo. The name of the field will be updated to match the name of the org unit type flagged as the “semester” standard type.)

• When an org unit type is flagged as “department,” org units of that type will be listed in the Department field when creating or editing a course template, and when editing a course offering. (This field is controlled by the Department form element in CreateCourse and CourseOfferingInfo. The name of the field will be updated to match the name of the org unit type flagged as the “department” standard type.)

Child org units • Any Org Unit can either be a child or a parent Org Unit.

• The system enforces lineage: an instance of an Org Unit Type cannot be the child of another instance of the same Org Unit Type (e.g. a department cannot reside below another department in the hierarchy).



Sample organization hierarchy

Sample Organization Hierarchy

The Sample Organization Hierarchy diagram shows how the basic org unit types are arranged into a hierarchy. Custom org unit types are normally inserted between Departments and the Organization. For example, Departments might be grouped into Faculties, Faculties into Colleges, and Colleges attached directly to the Organization.

Creating a new org unit type The main goal when creating Org Unit types is to understand how your organization is structured so that you can set up your org structure in the DOME to allow for easy on-going maintenance.

It is important to have a clear understanding of how you would like your organization to be set up prior to creating Org Unit types. Please consult with your Desire2Learn Account Manager for assistance and direction.

Important



• Two instances of the same Org Unit Type (e.g. department, etc) cannot reside in the same org hierarchy.

• You must create a unique Org Unit Code for all departments and semesters.

• Course templates need to be above course offerings.

• Groups need to be below course offerings.

For example, if your organization is divided into the following type of hierarchy:

• Colleges

• Faculties

• Departments

It may not be necessary to create an Org Unit type for each level of the hierarchy, unless specific, individual homepages for each level are required. In the example above, you may not need to create a College or Faculty org unit type—it might be sufficient simply to have departments. Keep in mind the following points when deciding which levels of your hierarchy to create in the DOME:

• Reports can be generated that aggregate data on all Org Units of the same Org Unit type. For example: for each department, a report could be generated that shows how many courses are using the Chat tool.

• Users can be enrolled in a cascading role in any org unit, automatically enrolling them in all of the org unit’s descendents.

• Homepages can be set up for any org unit type. For example, you may want users to be able to access a homepage for the College of Arts & Sciences.

To create a new Org Unit Type from the main DOME page

1 Click Org Unit Type Editor from the left-hand tree view.

2 Click Create New Org Unit Type.

3 Type a Name for the new Org Unit type.

4 Type a Display Name (the name that will appear in the left tree view).

5 Type a value for the Sort Order if you want to change the order of Org Unit types displayed in the Desire2Learn interface.

6 Type a Description for the Org Unit type, if applicable.

7 In the Org Unit is standard field, select Other, Semester, or Department, depending on the type of Org Unit you want to create.

Note Your organization should have one (and only one) org unit type flagged as “semester,” and one (and only one) flagged as “department.” All other org unit types should be set to “other.” See Standard org unit types, p. 19, for a complete explanation of these options.

8 Click Create.



The new Org Unit type displays as a link in the table on the Org Unit Type Editor page.

Editing an existing org unit type Making changes to an Org Unit type will affect all Org Units of that type. For example, when you make changes to the “Department” Org Unit type it affects all associated departmental Org Units.

To edit Org Unit type properties from the My Home/DOME/Org Unit Type Editor page

1 Select the name of the Org Unit type you wish to edit.

2 Click Edit in the top right corner of the Org Unit Type Properties page.

3 Make any applicable changes to the Org Unit Type properties. Refer to the topic Creating a new org unit type, p. 21 for details about each field.

4 Click Save.

Changing your org unit type icons To change the icon associated with a current Org Unit type

1 Click the desired Org Unit in the left tree view under the Org Unit Type Editor node.

2 Click the Change Icon button on the Org Unit Type Properties page.

Change Icon button on the Org Unit Type Properties page

3 Select a new icon from the pop-up window, and click Save.

Org Unit Type icons



Deleting an existing org unit type Click the Delete icon next an Org Unit Type on the Org Unit Type Editor page to delete it.

Notes

• If there are still Org Units of the type you are trying to delete, the following message will display: “The Org Unit Type that you attempted to delete could not be removed. There are Org Units of that type currently in the system, and they must be removed before the Org Unit Type can be deleted.”

• Some org unit types cannot be deleted, namely Course Template, Course Offering, Group and Section.

DOME v.8.3.1 Administration Guide The Org Unit Editor: managing org units


The Org Unit Editor: managing org units

Viewing org units: options There are three ways to access individual org units.

By Hierarchy Expand this node to view the organizational structure from the top down. Most editing and management of the org structure is performed using the hierarchy.

• Ordered by hierarchy of the Organizational Units.

• Shows the Organizational Unit type (e.g. course offering).

• Click the next to an Org Unit to display any children associated with that Org Unit.

By Type Expand this node to show all instances of the selected type.

• Shows the Organizational Unit type (e.g. course offering, department).

• Click the next to an Org Unit Type to show all instances of that Org Unit Type.

Search All Org Units This allows the user to find an Org Unit based on search criteria entered. The Org Unit name and the Org Unit code are searched. Users can restrict their search to a particular Org Unit type.

Options for viewing Org Units

Searching for org units You can search for a specific Org Unit from the Org Unit Editor by selecting the Search All Org Units link.

To find an org unit

1 Enter part of the org unit’s name or code in the Search String field.

2 If you want to restrict your search to a particular org unit type, select the type from the Org Unit Type to Search drop-down list.

3 Click Search.



The results display as links in the results table. Click the applicable link to go to the associated Org Unit properties page.

Deleting org units The DOME allows you to delete Org Units created in error. The Org Unit Recycler (restoring Org Units) works together with the Delete option as a built in security measure, whereby Org Unit properties are stored until you choose to delete them permanently.

To delete Org Units in the DOME

1 Select the Org Unit you want to delete and click the Delete button.

Note Child Org Units must be detached before you can delete an Org Unit. See Removing a child from a parent org unit (orphaning a child), p. 29.

2 Click the OK button if you would like to officially delete the Org Unit, or click Cancel.

The deleted Org Unit must be deleted from the Org Unit Recycler to be permanently deleted from the organization.

The Org Unit Recycler (restoring org units)

To restore deleted Org Units from the DOME

1 Click Org Unit Recycler from the left tree view.

2 Check the box beside the Org Unit you want to restore.

3 Click Restore Org Unit.

The Org Unit is restored to its original place in the Org Unit hierarchy.

Modifying org unit properties Once you select an Org Unit, you can edit the Org Unit properties, including:

• Name The name of the Org Unit.

• Org Unit Id The Org Unit ID as it appears in the web address (the parameter passed to each page inside the org unit). (Read-only.)

• Org Unit Type The type of Org Unit (e.g. department, semester, etc). (Read-only.)

• Org Unit Code Depending on your type of implementation, this code can just be informational, or is required for integration with external information systems (SIS/UIS).



Important If your organization is integrated with a SIS, you must create a unique Org Unit Code for each org unit.

• Org Unit Path This defines the location in the /content/ directory that the user will be taken to when visiting the Manage Files area for the org unit. This must be specified in order to view the ‘Manage Files’ link.

To change current Org Unit properties

1 Select the applicable Org Unit from the tree view in the left pane.

2 Click the Edit button to change the Org Unit type properties.

3 Make the applicable changes to the Name, Org Unit code (apply another existing code, or create a new one) and Org Unit Path, and click Save.

Management Quick Links: configuring the learning environment directly from the DOME

Management Quick Links is an area in the DOME where you can update specific information about users and courses without having to enter the Desire2Learn interface directly.

Different links display depending on the type of org unit you select.

The Management Quick Links page for a course offering

Quick Link descriptions

Quick Link Description

Navbars The navbar options for this Organizational Unit.

Tools Control which tools are accessible in this Org Unit; change the display names of available tools.

View all parent Org Units

View all of the org unit’s immediate parents.

Registration Manage enrollment in this Org Unit. (For applicable course offerings, manage Self Registration.)

Content Access the Content Manager for this Org Unit (edit course content).

Homepages Edit the Homepage for this Org Unit.

Components Access the Import/Export/Copy page for this org unit.



Quick Link Description

Org unit homepage Links directly to the Org Unit Homepage.

Files Takes you directly to the Manage Files page for this course (requires a path to be defined for the Org Unit).

Managing parent/child org units The Org Unit Editor allows you to manage the children of parent Org Units, including:

• Edit Multiple Org Units

• Orphan Children

• View all parent Org Units

Child Org Units section of the Org Unit Editor

Editing multiple child org units You can edit the Org Unit Name and Org Unit Code of multiple child org units simultaneously:

1 Select the checkbox next to each org unit you want to edit.

2 Click Edit Selected Children.

3 From here you can change the existing Org Unit Name or Org Unit Code.

Important If you are using SIS integration, the Org Unit Code must be unique and created in the DOME first. For more information, see the Holding Tank Features Guide.

4 Click Save.



Edit Multiple Org Units page

Adding a child org unit Note Only Department and Semester org units (or their equivalents) and custom org unit types (e.g. Faculty, Area) can be created in this way. You cannot create course offerings, templates, groups, or sections.

To add a child to the current Org Unit

1 Click the Add Child Org Unit link.

2 Do one of the following:

a) Add an existing Org Unit as the child by selecting Existing Org Unit and clicking Next.

b) Enter the Org Unit Id or Org Unit Code for an existing org unit, then click Next.

OR

a) Create a new Org Unit by choosing New Org Unit and clicking Next.

b) Select the applicable Org Unit Type from the drop-down list.

c) Enter an Org Unit Name that reflects the child Org Unit Type (e.g. College Name, Department name, Course Offering name, etc.).

d) Enter an Org Unit Path (the location where all org-related files and variables will be stored).

e) Click Next.

3 Click Next to complete the process of adding the new child Org Unit.

Removing a child from a parent org unit (orphaning a child) Removing a child org unit breaks the link between the current org unit and the selected one; it does not delete the child org unit.

To remove children from the current Org Unit

1 Check the checkboxes beside the child Org Units that you would like to remove.

2 Click Remove Selected Children.



Moving child org units manually You may wish to assign a new parent Org Unit to a child if you find that certain courses are under the wrong template or the incorrect semester.

To assign a child to a new parent Org Unit from the main Org Unit Type Editor page

1 Click Assign a new parent beside the name of the child Org Unit you want to re-assign.

OR

To re-assign multiple children together, select the checkboxes next to each child and click Move Selected Children at the bottom of the list.

2 Type the Org Unit ID or Org Unit Code of the parent to which you want to move the child Org Unit.

3 Click Next.

Moving child org units automatically (using the clipboard)

To move child Org Units without having to type in the Code or ID of the new parent, you can use the clipboard

1 Check the checkboxes beside the child Org Units that you would like to move to the clipboard.

2 Click Move Selected to Clipboard.

3 Navigate to the new Org Unit and click the Move copied children that appears at the top of the page.

Click Clear Clipboard to remove the child Org Units from the clipboard.

Changing org unit colors Org Unit Colors determine the color of widgets within an Org Unit.

• Colors should match (or compliment) your organization’s color scheme.

• Dark and light tables have white text (so choose Dark and Light colors against which white text will be legible).

• Soft is used as the background of tabs, which have black text.

Note Colors that are applied across the Org Unit can be changed for Course Offerings from the Course Offering Information page. (The Course Colors field must be enabled on the Course Offering Info form).

To change the Org Unit colors

1 Click the Edit button in the top right corner.



2 Click the applicable Dark, Light or Soft color box.

3 Pick a color using the Color Picker dialog that appears.

4 Click Set.

5 Click the Save button in the top right corner.

Color Picker

Org unit utilities Using Org Unit Utilities, you can scan for the following types of Org Units in the DOME:

• Org Units without children (e.g. a course template with no associated course offerings).

• Orphan Org Units (e.g. a course offering that is not associated with a course template).

Scan for org units without children This utility searches for Org Units that have no associated children. Sometimes during setup of your Desire2Learn site, unnecessary departments or course templates get created that require cleanup; this utility helps you find those Org Units so you can delete them, if applicable.

To scan for org units with no children

1 In the tree view, select Org Unit Editor > Org Unit Utilities > Scan for no children.

2 On the ‘Scan for no children’ page, select the type of org unit to scan for (e.g. Course Templates, Semesters, etc.).

A list of the org units of the selected type that have no children is displayed.

Org Unit Color options



Scan for orphaned org units This utility finds Org Units without associated parents. Org Units returned from this Utility are not be visible in the ‘Hierarchy’ view of the Org Unit Editor.

Org Units returned using this search are typically ones that have been removed from their only parent Org Unit. Orphaned Org Units can be re-introduced into the org structure from this page.

To scan for orphaned org units

1 In the tree view, select Org Unit Editor > Org Unit Utilities > Scan for orphans.

2 On the ‘Scan for orphans’ page, select the type of org unit to scan for (e.g. Course Offerings, Departments).

A list of the org units of the selected type that are not attached to any parent is displayed.

DOME v.8.3.1 Administration Guide Managing Form Elements


Managing Form Elements

Form elements are used to define fields that will be visible or hidden from the user. Depending on the security settings defined in your organization, only specific forms will be editable.

From the main DOME interface, select the beside Form Elements in the left tree view.

The following table describes each form element and its associated tool.

Form elements

Form Used where or when? Description

BatchCourseCreate Batch Course Create Specifies the fields expected in the CSV import file in batch course create.

BulkUserImport Bulk User Management Specifies the fields expected in the CSV import file in bulk user management.

CourseOfferingInfo The Course Offering Information page in the Course Admin Tools area.

Fields used to edit a course offering’s properties.

CourseTemplateInfo The Course Template Information page accessed through Manage Courses by clicking the name of a template.

Fields used to edit a course template’s properties.

CreateCourse When creating a new course offering or template.

A combination of the fields that appear when creating a course offering or template through Manage Courses.

CreateUser When creating a new user. A combination of the fields that appear when creating a new user.

ECommerceProduct Manage Ecommerce The fields displayed in the Edit Product page through Manage Ecommerce.

ForgotPassword Normally found on the login page.

Information a user must know to get their password.

Manual Token Create (Group)

Registration Used to manually create tokens for a group.

Manual Token Create (Individual)

Registration Used to manually create tokens for an individual

DOME v.8.3.1 Administration Guide Managing Form Elements


Form Used where or when? Description

NewCourse Participant

When creating and adding a new user from the Classlist or from the Registration page.

Information entered when creating a new user and adding them to a course offering.

Registration External registration Used to externally register users.

RegistrationExport Used with our self-registration tool

Used to allow users to choose the registration fields to be included in a registration export.

SIS Tank Convert Offerings

Mapping Tool Maps data from SIS (holding tank) to Desire2Learn courses and groups. See the Holding Tank Features Guide for more information about the integration process and the mapping tool.

Token Registration Token registration Used to register users and get an enrolment token.

UserContactInfo Manage Users A user’s contact info.

UserImport Classlist/Import Users Used to determine the formatting of the user information import tool.

UserProfile Classlist/User Profile Used for the user profiles tool.

Modifying forms There are two ways to modify a form; you can modify the entire form at once, or you can modify an individual field on the form.

When modifying the entire form, you can quickly select which fields are displayed and you can visually change the order of fields using Up and Down arrows. However, you cannot specify which fields are required.

When modifying an individual field, you can specify both whether the field is displayed and whether it is required (whether a user must enter data into the field or make a selection to save the form). You can also enter a Sort Order number to control the order in which it will appear.

To modify a form or a field

1 Select the form or field you want to edit.

2 Click the Edit button in the top right corner of the right pane.

3 Make the applicable changes.

4 Click Save.

DOME v.8.3.1 Administration Guide Managing organization tools


Managing organization tools

Tools are the components used within an org unit, like quizzes, content, discussions, chat, gradebook, etc. From the Manage Org Tools section of the DOME you can control which tools are available in your organization and whether they are enabled by default.

To access the Tools page

In the DOME, click Manage Org Tools in the navigation pane at the left.

Adding tools Adding tools through the DOME Tools page makes them available for use throughout your organization. For example, if you add the Checklists tool, users can use checklists in their course offerings. (To actually use a tool within an org unit, the tool also needs to be enabled and added to the org unit’s navigation bar or homepage.)

To add a tool to your organization

1 In the DOME, click Manage Org Tools in the left pane.

2 Click Add Tools on the action bar.

3 Select the tools you want to add.

4 Click Add Selected.

Removing tools Removing a tool makes it unavailable in your organization. For example, if you remove the Chat tool, users cannot create chats in their course offerings.

To remove tools from your organization


2 Select the tools you want to remove.

3 Click the Remove Tool icon at the top or bottom of the list.

Setting a tool’s default state You can specify whether tools are active (on) or inactive (off) by default. In this way you can specify the standard configuration of course offerings by turning frequently used tools

DOME v.8.3.1 Administration Guide Managing organization tools


on, while turning rarely used tools off. Tools you don’t want your users to use should be removed.

Turning a tool on does not by itself make the tool available to users enrolled in an org unit; the tool must also be added to the navigation bar and/or homepage (depending on the tool), and users must have adequate permission to access the tool. You can use the default tool state in conjunction with navigation bar and homepage templates and permissions to configure the standard setup for org units in your organization.

Note Setting the default state for a tool is different from setting its state for the Organization as an org unit. You can disable the FAQ tool by default but still enable it for the Organization to make it available from My Home. (To change a tool’s state for the Organization as an org unit, select the Organization from the Org Unit Editor section

of the DOME and click Tools.)

To change a tool’s default state


2 Select the tools whose default state you want to change.

3 Click the Set default state to Active or Set default state to Inactive icon at the top or bottom of the list.

Renaming tools Renaming a tool changes the wording used in the interface wherever the tool is represented. By renaming a tool you can use the terminology most familiar to users at your institution.

You rename a tool by changing its name for the Organization. The name used for the Organization becomes the default name for all other org units. Users can override this name within individual org units if they have permission to manage tools for that org unit.

To rename a tool

1 In the DOME, expand Org Unit Editor in the left pane.

2 Expand By Hierarchy.

3 Click the name of your organization.

4 In the Management Quick Links section in the right pane, click Tools.

5 Type the new name in the Display Name column beside the tool.

6 Click Save.

DOME v.8.3.1 Administration Guide Configuration variables in 8.3.1


Configuration variables in 8.3.1

Variable Type Default Value Description

d2l.3rdParty.Respondus.HasLockDownBrowser Org off Determines whether the organization has a license for Respondus Lockdown Browser. If this option is selected, users administering a quiz can force users to use Respondus Lockdown Browser when taking a quiz or viewing their quiz results.

d2l.3rdParty.Respondus.LockDownBrowserDownloadURL Org Stores the URL users need to download Respondus Lockdown Browser. The URL is displayed to users trying to write or view a protected quiz without the browser.

d2l.Auth.LDAP.appId Org D2L LDAP application domain userid

d2l.Auth.LDAP.appOu Org ou=apps,o=wisc.edu LDAP variable describing the Organization of the app id

d2l.Auth.LDAP.appPassword Org ******* LDAP application domain password

d2l.Auth.LDAP.attributes Org ADSPath,cn LDAP attributes variables

d2l.Auth.LDAP.CommonPostUserNameAttribute Org Post UserName attribute that should be applied to all users with their authenticated usernames.

d2l.Auth.LDAP.CommonPreUserNameAttribute Org Pre UserName attribute that should be applied to all users with their authenticated usernames.

d2l.Auth.LDAP.filter Org objectclass=* LDAP variable describing the filter on which to search

d2l.Auth.LDAP.ldapServer Org Atlas LDAP server name

d2l.Auth.LDAP.LdapSserver Org Atlas LDAP server name

d2l.Auth.LDAP.ou Org dc=com;dc=d2l;ou=People

LDAP variable describing the Organization on which to search




d2l.Auth.LDAP.provider Org LDAP ADSI provider type (LDAP, LDAPS)

d2l.Auth.LDAP.RetrieveUserAttribute Org

d2l.Auth.LDAP.scope Org base LDAP scope variables

d2l.Auth.LDAP.SearchIdAttribute Org Optional Attribute used to search for users with

d2l.Auth.LDAP.UseFilterSearch Org off Use the filter variable to define ldap search

d2l.Auth.LDAP.UserIdAttribute Org uid Tells LDAP which field is the Userid in this implementation

d2l.Auth.LDAP.UseSecondaryServerOnFailure Org off Use LDAP2 Variables if LDAP variables fail for some reason

d2l.Auth.LDAP.UseSSL Org 1 Use SSL

d2l.Auth.LDAP2.AppId Org LDAP application domain userid

d2l.Auth.LDAP2.AppOu Org LDAP variable describing the Organization of the app id

d2l.Auth.LDAP2.AppPassword Org ******* LDAP application domain password

d2l.Auth.LDAP2.Attributes Org LDAP attributes variables

d2l.Auth.LDAP2.CommonPostUserNameAttribute Org Post UserName attribute that should be applied to all users with their authenticated usernames.

d2l.Auth.LDAP2.CommonPreUserNameAttribute Org Pre UserName attribute that should be applied to all users with their authenticated usernames.

d2l.Auth.LDAP2.Filter Org LDAP variable describing the filter on which to search

d2l.Auth.LDAP2.LdapServer Org LDAP server name

d2l.Auth.LDAP2.LdapSserver Org LDAP server name

d2l.Auth.LDAP2.Ou Org LDAP variable describing the Organization on which to search

d2l.Auth.LDAP2.Provider Org ADSI provider type (LDAP, LDAPS)




d2l.Auth.LDAP2.RetrieveUserAttribute Org

d2l.Auth.LDAP2.Scope Org LDAP scope variables

d2l.Auth.LDAP2.SearchIdAttribute Org Optional Attribute used to search for users with

d2l.Auth.LDAP2.UseFilterSearch Org off Use the filter variable to define ldap

d2l.Auth.LDAP2.UserIdAttribute Org Tells LDAP which field is the Userid in this implementation

d2l.Auth.LDAP2.UseSSL Org Use SSL

d2l.Folders.Mail.Attachments System \\fileserv\upload\_mail\

The folder in which user mail attachments are stored.

d2l.Languages.CultureId OrgUnit The org's default culture

d2l.Languages.ForceCulture OrgUnit off When on, always use the culture as defined in d2l.Languages.CultureId, regardless of the user preference.

d2l.Languages.ForceImageSet OrgUnit off When on, always show the image set as defined in d2l.Languages.ImageSetId, regardless of the user preference.

d2l.Languages.ImageSetId OrgUnit 1 Org's image set

d2l.Languages.LanguageId OrgUnit 1 Org unit's language.

d2l.Preferences.CultureId User User's culture

d2l.Preferences.FirstDayOfWeek User 0 The first day of the week, with 0 as Sunday and 6 as Saturday.

d2l.Preferences.FontFace User Verdana The default setting for the 'font face' preference. Controls the font used throughout the Learning Environment. Users can change this setting from My Preferences.




d2l.Preferences.FontSize User 11 The default setting for the 'font size' preference. Controls the size in pixels of the selected font face. Users can change this setting from My Preferences.

d2l.Preferences.HomepageId User 100 User's homepage

d2l.Preferences.ImageSetId User User's image set

d2l.Preferences.LanguageId User 13 Allows users to select a preferred language to view the Learning Environment in. This preference is overwritten for org units that have 'Force Language' turned On.

d2l.Preferences.Notifiers User on Whether the email and pager notifiers are active

d2l.Preferences.ShowOnlineStatus User on The default setting for whether a user's online status is visible. When turned off, users appear as offline even when they are logged in.

d2l.Preferences.System.CDROMDriveLetter User E Default setting for user's CD-ROM drive letter.

d2l.Preferences.System.ConnectionSpeed User 56K - Low Speed Default setting for user's connection speed.

d2l.Preferences.System.OperatingSystemId User Windows Default setting for user's operating system.

d2l.Region.Force24Hours Org off When on all times will show up as 24 hour times rather than am/pm.

d2l.Region.ServerTimezone System Canada/Eastern Server Timezone

d2l.Region.Timezone Org Canada/Eastern Timezone




d2l.Security.BypassDateCheck Org off Controls whether courses with start/end dates are displayed in the My Courses widget outside their date range (i.e. before or after their start and end dates). Only applicable to roles without the 'Access Past/Future Courses' setting.

When turned on, users will be able to see upcoming courses and previous course offerings they are enrolled in. They will not be able to access these course offerings (the names will not appear as links to the course homepage, as is the case for current course offerings).

Security.HasOrgUnitDateRestrictions must be enabled.

d2l.Security.HasOrgUnitDateRestrictions Org on Controls whether org unit start/end date restrictions are enforced. When enabled, roles without the 'Access Past/Future Courses' setting will not be able to access date-restricted course offerings outside their date range.

d2l.SessionTimeout Org 180 Determines the length of time (in minutes) before a user's session expires during periods of inactivity.

d2l.Settings.HasCourseSelectionDropdowns Org on Controls whether the Create Course and Copy Course Components pages display drop-down lists of available course offerings and templates. When disabled, users select course offerings and templates through a search dialog.

d2l.Settings.HasD2LEmail Org off Specifies whether the organization uses internal Desire2Learn email.

When enabled, the system uses users' internal addresses in various places throughout the Learning Environment when displaying user addresses or providing links to email users.

Also enables the New Email notifier in the navigation bar.




d2l.Settings.HasInformationPrivacy Org off Enables information privacy for the organization. When enabled, administrative users can't impersonate other users even if they have access to non-directory information.

d2l.Settings.OrgHasSSLEnabled Org off Whether or not the org has SSL enabled for the site.

d2l.Settings.PortalOnlySSL Org off Whether or not only portal has ssl enabled for the site

d2l.Tools.AttendanceRegisters.MaxDataRecords OrgUnit 2000 Limits the number of users per page based on the maximum number of sessions and symbols that can be viewed on the attendance data page

d2l.Tools.Blog.AllowExternalViewing Org on Entries in the blog tool are available to outside viewing

d2l.Tools.Blog.AllowRSSPublishing Org on RSS feed publishing of blogs is on

d2l.Tools.Blog.User.AllowComments User off Allow comments by default

d2l.Tools.Blog.User.MakeEntriesPublic User off Make blog entries public

d2l.Tools.Blog.User.RemoveBlogWatchDays User 0 Remove entries from blog watch after n days

d2l.Tools.Chat.Alias User {user name} The users alias in chats.

d2l.Tools.Chat.AliasBold User off Whether or not the users alias is bold.

d2l.Tools.Chat.AliasColor User 000000 The color of the users alias in chats.

d2l.Tools.Chat.AliasItalic User off Whether or not the users alias is in italics.

d2l.Tools.Chat.EnterSound User off Determines whether entering a chat creates a sound.

d2l.Tools.Chat.IncomingSound User off Determines whether incoming chat messages create a sound.

d2l.Tools.Chat.LeaveSound User off Determines whether leaving a chat creates a sound.

d2l.Tools.Chat.ManualRefresh User off Whether or not the user has selected to manually refresh.

d2l.Tools.Chat.MessageOrder User 1 The order of incoming messages into the message box.




d2l.Tools.Classlist.DisplayEmail OrgUnit off Determines if the email column should be shown in the Classlist

d2l.Tools.Classlist.DisplayInactiveUsers OrgUnit off Displays user that are not currently active

d2l.Tools.Classlist.DisplayOrgId OrgUnit on Determines if the Org Defined ID column should be shown in the Classlist.

d2l.Tools.Classlist.DisplayUsername OrgUnit off Determines if the username column should be shown in the Classlist

d2l.Tools.CMS.AddParticipant.EnrollOrgUnitTypeId Org None When set to an org unit type, whenever a user is enrolled in an org unit with this type as an ancestor, they will automatically be enrolled in the ancestor org unit of this type as well, in the same role.

Accepted Values: Any org unit type (semester, department, course template, etc.)

d2l.Tools.CMS.AddParticipantAction Session 1 Whether user is enrolling or creating users

d2l.Tools.CMS.CoursePathEnforced Org off Determines whether a course path is enforced by the system or defined by the user for newly created courses. When enabled, the 'Course Path' field will not be displayed when creating new course offerings or course templates and the system will automatically assign a unique content path.

d2l.Tools.CMS.CreateDepartments Org on Determines whether the 'create department' button is displayed on the 'Course Info' form (when creating a new course template).Also requires that the 'Department' field be enabled in the form elements for 'Course Info'.

d2l.Tools.CMS.MaxSelfRegistrations OrgUnit 250 The maximum number of users that can self-register in a course offering. Can also be set from Edit Course > Registration > Restrictions.




d2l.Tools.CMS.SubjectToApprovalMessage OrgUnit Enrollment in {org unit name} is subject to approval before you can access this <org unit type name>.

The onscreen message displayed to users who self-register for a course that requires approval.

d2l.Tools.Competencies.Settings.AutomaticReeval Org on Controls whether re-evaluation occurs automatically whenever changes are made to a competency. If disabled, re-evaluations must be initiated manually by users.

d2l.Tools.Competencies.Settings.MaxRubricLevels Org 25 Specifies the maximum number of levels a rubric can have.

d2l.Tools.Competencies.Settings.ShowVersionNumber Org off Turns versioning on or off. If enabled, whenever a competency definition is changed, the system will create a new version and save the previous one. Also a version number will be displayed for each competency and the setting "Ready for Versioning" will appear on the Edit Competency page.

d2l.Tools.Competencies.Settings.UseAdvancedView User off Determines if users will see the Advanced View interface by default when working with competencies. Only applies to users who have permission to see the advanced view.

Users who have the associated permissions can change this setting on the Settings page of the Competencies tool.

d2l.Tools.Competencies.Settings.UseStatus Org on Turns Status on or off. If enabled, all competencies will have a Status property which will control who can see the competency (based on status permissions), whether it can be edited, and whether users can complete it.

d2l.Tools.Competencies.Users.ActVisible OrgUnit on Controls whether activities are displayed in the user's view. Can also be set from Competencies > Settings.




d2l.Tools.Competencies.Users.CompetencyVisible OrgUnit on Controls whether competencies are displayed in the user's view. (If disabled, users may still be able to see activities and learning objectives, each controlled by separate variables; this variable only hides the top-level competency elements.)

Can also be set from Competencies > Settings.

d2l.Tools.Competencies.Users.LOsVisible OrgUnit on Controls whether learning objectives are displayed in the user's view.Can also be set from Competencies > Settings.

d2l.Tools.Content.HasComments Org on Determines if the 'Comments' tab is available when editing content modules and topics.

d2l.Tools.Content.HasConditions Org on whether content has release conditions

d2l.Tools.Content.HasDiscussions Org on Determines if content modules and topics can be associated with discussion topics. If turned off, the Discussion Topic field will not be displayed when editing content modules and topics.

d2l.Tools.Content.HasQuickLinks Org on Determines if content has QuickLinks

d2l.Tools.Content.HasRatings Org on Whether content can be rated

d2l.Tools.Discuss.AutoMarkRead Org on Controls whether a message is automatically marked as read when a user opens it in the Grid Style message list.

d2l.Tools.Discuss.MultiSelectMessages Org on Controls whether checkboxes are displayed beside messages in the Grid Style message list, enabling users to perform actions on multiple messages.

d2l.Tools.Discuss.RateMessages OrgUnit off Controls whether messages can be rated. Can also be set on the Discussions Settings page within the org unit.

d2l.Tools.Discuss.SaveDrafts Org off Controls whether users can save messages as drafts to edit and post later.




d2l.Tools.Discuss.ShowSharedForums OrgUnit on Controls whether shared forums are displayed in the org unit's discussions list. Users with permission to hide shared forums can change this setting on the org unit's Discussions Settings page.

d2l.Tools.Discuss.ShowTopicDescriptions OrgUnit on Controls whether topic descriptions are displayed in the message list. Users with permission can change this setting on the org unit's Discussions Settings page.

d2l.Tools.Discuss.User.AssessDisplayPercentage User on Controls whether users' scores, displayed as a percentage value, are shown by default on the Assess Topic page. Users can change this setting in the Display Options dialog accessible from the Assess Topic page.

d2l.Tools.Discuss.User.AssessDisplayScoreValue User on Controls whether users' scores are shown by default on the Assess Topic page. Users can change this setting in the Display Options dialog accessible from the Assess Topic page.

d2l.Tools.Discuss.User.AssessDisplayUserId User off Controls whether User IDs are displayed by default on the Assess Topic page. Users can change this setting in the Display Options dialog accessible from the Assess Topic page.

d2l.Tools.Discuss.User.LimitSubjectChars User off Controls whether to limit the length of messages' subjects by default when they are displayed in the Grid Style message list. Users can change this setting on the Discussions Settings page.

If you enable this setting, the number of characters displayed is determined by SubjectCharsToDisplay.

d2l.Tools.Discuss.User.MessageListStyle User Grid The default message list style. Users can change this setting on the Discussions Settings page.

d2l.Tools.Discuss.User.MessageListView User Threaded The default message list view. Users can change this setting on the Discussions Settings page.




d2l.Tools.Discuss.User.ReplyWithText User on Controls whether the original message text is automatically included in a Reply by default. Users can change this setting on the Discussions Settings page.

d2l.Tools.Discuss.User.ShowAuthorRole User off Whether or not the message author's role is displayed in the Message List

d2l.Tools.Discuss.User.ShowDeletedMessages User off Controls whether deleted messages are displayed in the message list by default for users with permission to see deleted messages. Users can change this setting on the Discussions Settings page.

d2l.Tools.Discuss.User.ShowMessageId User off Controls whether message IDs are displayed by default. Users can change this setting on the Discussions Settings page.

d2l.Tools.Discuss.User.ShowMessageSearch User off Controls whether the search field is displayed by default in the message list. Users can show and hide the search field using a link at the top of the message list.

d2l.Tools.Discuss.User.ShowOrgDefinedId User off Controls whether authors' Org Defined IDs are displayed by default. Users with permission to see IDs can change this setting on the Discussions Settings page.

d2l.Tools.Discuss.User.ShowPreviewPane User on Controls whether messages are displayed by default in a preview pane beneath the message list or in a pop-up window. Only affects the Grid Style message list. Users can change this setting on the Discussions Settings page.

d2l.Tools.Discuss.User.ShowTopicsPane User off Controls whether the list of forums and topics is displayed by default on the left side of the message list. Users can change this setting on the Discussions Settings page.

d2l.Tools.Discuss.User.SubjectCharsToDisplay User 50 Specifies the default number of characters to display for each message's subject in the Grid Style message list. Only applicable if LimitSubjectChar is turned on.Users can change this setting on the Discussions Settings page.




d2l.Tools.Dropbox.FilenameFormatGroup OrgUnit {GroupName} - {firstName} {lastName} - {submissionDate} - {filename}

Determines the name of the zip folder created when group dropbox submissions are downloaded.Accepted Replace Strings: {GroupName}, {firstName}, {lastName}, {submissionDate}, {filename}

d2l.Tools.Dropbox.FilenameFormatUser OrgUnit {firstName} {lastName} - {submissionDate} - {filename}

Determines the name of the zip folder created when individual dropbox submissions are downloaded.Accepted Replace Strings: {filename}, {username}, {firstName}, {lastName}, {OrgDefinedId}, {submissionDate}

d2l.Tools.Dropbox.MaxFileSize Org 0 Maximum filesize (in Kb) for a single dropbox submission.Accepted Values: A numeric value. 0 = no limit..

d2l.Tools.Dropbox.MaxTotalFileSize Org 0 Maximum filesize (in Kb) for a dropbox folder.Accepted Values: A numeric value. 0 = no limit.

d2l.Tools.Ecommerce.eSelectPlusOrderIDPrefix Org Determines the prefix of Order IDs when Order IDs are passed to Moneris eSelectPlus

d2l.Tools.ePortfolio.AllowAssessmentDefault User on The variable corresponds to the checkbox "Allow assessments on reflections, artifacts, collections and presentations by default". When this variable is set to "On" when a new reflection, artifact, collection or presentation is created the allow assessments on the item is checked by default.

d2l.Tools.ePortfolio.AllowCommentDefault User on The variable corresponds to the checkbox "Allow comments on reflections, artifacts, collections and presentations by default". When this variable is set to "On" when a new reflection, artifact, collection or presentation is created the allow comments on the item is checked by default.

d2l.Tools.ePortfolio.AllowCompetenciesArtifacts Org on Whether or not competencies artifacts can be created.




d2l.Tools.ePortfolio.AllowDropboxArtifacts Org on Whether or not dropbox artifacts can be created.

d2l.Tools.ePortfolio.AllowExportForDropboxDefault Org on Whether or not dropbox folders are set to allow ePortfolio artifacts by default.

d2l.Tools.ePortfolio.AllowExportForQuizDefault Org on Whether or not quizzes are set to allow ePortfolio artifacts by default.

d2l.Tools.ePortfolio.AllowGradesArtifacts Org on Whether or not grades artifacts can be created.

d2l.Tools.ePortfolio.AllowQuizArtifacts Org on Whether or not quiz artifacts can be created.

d2l.Tools.ePortfolio.AuthenticatedPresentations Session Determines what theme will be used by default. The variable is set on the Themes screen.

d2l.Tools.ePortfolio.CreateCompetencyArtifacts OrgUnit on Whether or not users are allowed to create grades artifacts for the course.

d2l.Tools.ePortfolio.CreateGradesArtifacts OrgUnit on Whether or not users are allowed to create grades artifacts for the course.

d2l.Tools.ePortfolio.DefaultTheme Org off Determines what theme will be used by default. The variable is set on the Themes screen.

d2l.Tools.ePortfolio.EditedByOthersDisplayed User on Determines if the "Items Recently Edited By Others" area is shown on a user's dashboard. This variable corresponds to the display checkbox for "Items Recently Edited By Others" on the Settings page.

d2l.Tools.ePortfolio.EditedbyOthersNumItems User 5 Determines the number of items recently edited by others to show. This variable corresponds to the dropdown for number of items for the "Items Recently Edited By Others" area on the Settings page.

d2l.Tools.ePortfolio.EditedByOthersSortOrder User 5 Determines the sort order for the "Items Recently Edited By Others" area. This variable corresponds to the dropdown for sort order for the "Items Recently Edited By Others" area on the Settings page.




d2l.Tools.ePortfolio.ExternalInviteExpiry Org 3 Determines the duration in days that an invite sent to an external user will expire.

d2l.Tools.ePortfolio.InvitesThroughEmail User on This variable corresponds to the "Email invitation" checkbox. When this variable is set to "On" any invites sent to a user will be received via email.

d2l.Tools.ePortfolio.MaxStorageSpace Role-OrgUnit

0 Maximum filesize (in Kb) per user ePortfolio (incl. artifacts, collections, reflections, presentations, etc.). A value of '0' means that no limit is defined. Only integer values are accepted.

d2l.Tools.ePortfolio.MyReflectionsDisplayed User off Determines if the "My Reflections" area is shown on a user's dashboard. This variable corresponds to the display checkbox for "My Reflections" on the Settings page.

d2l.Tools.ePortfolio.MyReflectionsNumItems User 5 Determines the number of my reflections to show. This variable corresponds to the dropdown for number of items for the "My Reflections" area on the Settings page.

d2l.Tools.ePortfolio.MyReflectionsSortOrder User 4 Determines the sort order for the "My Reflections" area. This variable corresponds to the dropdown for sort order for the "My Reflections" area on the Settings page.

d2l.Tools.ePortfolio.PublicPresentationAccess Org on Determines if the Public Access section on the External User tab within the Permission section of Presentations appears.

d2l.Tools.ePortfolio.RecentCommentsDisplayed User on Determines if the "Recent Comments Added" area is shown on a user's dashboard. This variable corresponds to the display checkbox for "Recent Comments Added" on the Settings page.

d2l.Tools.ePortfolio.RecentCommentsNumItems User 5 Determines the number of recent comments to show. This variable corresponds to the dropdown for number of items for the "Recent Comments Added" area on the Settings page.




d2l.Tools.ePortfolio.RecentCommentsSortOrder User 1 Determines the sort order for the "Recent Comments Added" area. This variable corresponds to the dropdown for sort order for the "Recent Comments Added" area on the Settings page.

d2l.Tools.ePortfolio.RecentInvitesDisplayed User on Determines if the "Recent Invites from Others" area is shown on a user's dashboard. This variable corresponds to the display checkbox for "Recent Invites from Others" on the Settings page.

d2l.Tools.ePortfolio.RecentInvitesNumItems User 5 Determines the number of recent invites to show. This variable corresponds to the dropdown for number of items for the "Recent Invites from Others" area on the Settings page.

d2l.Tools.ePortfolio.RecentInvitesSortOrder User 2 Determines the sort order for the "Recent Invites from Others" area. This variable corresponds to the dropdown for sort order for the "Recent Invites from Others" area on the Settings page.

d2l.Tools.ePortfolio.RecentlyModObjectsDisplayed User on Determines if the "Recently Modified Items" area is shown on a user's dashboard. This variable corresponds to the display checkbox for "Recently Modified Items" on the Settings page.

d2l.Tools.ePortfolio.RecentlyModObjectsNumItems User 5 Determines the number of recently modified items to show. This variable corresponds to the dropdown for number of items for the "Recently Modified Items" area on the Settings page.

d2l.Tools.ePortfolio.RecentlyModObjectsSortOrder User 3 Determines the sort order for the "Recently Modified Items" area. This variable corresponds to the dropdown for sort order for the "Recently Modified Items" area on the Settings page.

d2l.Tools.ePortfolio.StartPage User 0 This variable corresponds to the default start page option.




d2l.Tools.FileUpload.FileUploadMessage Org Are all images being uploaded (if any) obtained with proper patient consent?

Confirmation message displayed to users when uploading a file.

d2l.Tools.FileUpload.FileUploadWarning Org You must first obtain proper patient consent, download the consent form from your course homepage before proceeding with this file upload.

Message displayed to users who answer "No" to the confirmation message when uploading a file.

d2l.Tools.FileUpload.hasFileUploadConfirm Org off Controls whether a confirmation message is displayed to users when uploading a file. When enabled, users must answer "Yes" each time they want to upload.

d2l.Tools.Grades.AutoUpdateFinalGrade OrgUnit off Determines whether final grades are kept up to date automatically. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.ControlDecimalPlaces OrgUnit 2 Determines how many decimal places are displayed to users in the grade book by default. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.DefaultGradesArea User-OrgUnit

Enter Determines which Grades page displays when users enter the Grades tool. Can also be set from the Grades Settings area. Accepted Values: Enter, Manage, Settings, Schemes, Wizard

d2l.Tools.Grades.FinalGrade.AdjFinalCanExceed OrgUnit off Determines if the adjusted final grade can exceed 100%.Can also be set from the Edit Adjusted Final Grade page.

d2l.Tools.Grades.FinalGrade.CalcFinalCanExceed OrgUnit off Determines if the calculated final grade can exceed 100%.Can also be set from the Edit Calculated Final Grade page.




d2l.Tools.Grades.FinalGrade.GradeSchemeId OrgUnit None Determines the grade scheme applied to a course. Can also be set from the Grades Setup Wizard. Accepted Values: An existing grade scheme

d2l.Tools.Grades.FinalGrade.ReleaseAdjustedGrade OrgUnit on Determines whether the adjusted final grade or calculated final grade is released. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.GradeSchemeId OrgUnit Percentage Grade Scheme id that this Org Unit uses

d2l.Tools.Grades.GradesList.MaxRecords OrgUnit 4000 Limits the number of users per page based on the maximum number of grade items that can be viewed on a page

d2l.Tools.Grades.GradesList.MaxSpreadsheetRecords OrgUnit 200 Limits the number of users displayed on a single page in spreadsheet view.

d2l.Tools.Grades.GradesList.NumbCharsToDisplay User-OrgUnit

15 The number of characters to show for Text grade items in the grade book. Can also be set from the Grades Settings area.

d2l.Tools.Grades.GradesList.RepeatColumns User-OrgUnit

5 The number of columns to display before user details is repeated in the grade book. Can also be set from the Grades Settings area.

d2l.Tools.Grades.GradesList.RepeatRows User-OrgUnit

10 The number of rows before the grade category and item headers is repeated in the grade book. Can also be set from the Grades Settings area.

d2l.Tools.Grades.GradesList.ShowAdjFinalAtStart User-OrgUnit

off Determines whether the adjusted final grade column should appear at the beginning of the grade book. Can also be set from the Grades Settings area.

d2l.Tools.Grades.GradesList.ShowCalcFinalAtStart User-OrgUnit

off Determines whether the calculated final grade column should appear at the beginning of the grade book. Can also be set from the Grades Settings area.




d2l.Tools.Grades.GradesList.ShowEmail User-OrgUnit

off Determines whether users' email addresses are listed in the grade book. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.GradesList.ShowGradeScheme User-OrgUnit

on Determines whether users' grade scheme achievements for grade items are displayed in the grade book. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.GradesList.ShowOrgDefinedId User-OrgUnit

off Determines whether Org Defined IDs are listed in the grade book. Can also be set from the Grades Settings area. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.GradesList.ShowPointsGrade User-OrgUnit

off Determines whether Org Defined IDs are listed in the grade book. Can also be set from the Grades Settings area. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.GradesList.ShowUserName User-OrgUnit

off Determines whether usernames are listed in the grade book. Can also be set from the Grades Settings area.

d2l.Tools.Grades.GradesList.ShowWeightedGrade User-OrgUnit

off Determines whether weighted grades on grade items are listed in the grade book. Can also be set from the Grades Settings area.

d2l.Tools.Grades.GradesList.SpreadsheetView Org off Determines whether the Spreadsheet View of the Participant List is the default view. Can also be set from the Grades Settings area.

d2l.Tools.Grades.GradingSystem OrgUnit Points Determines the grading system used to calculate grades. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.HasAdjustedFinalGrade OrgUnit on Determines whether an OrgUnit can release an adjusted final grade to participants. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.Import.NumRecordsPerImportStep OrgUnit 10 Number of records imported in each batch




d2l.Tools.Grades.IncludeEmptyGradesInFinal OrgUnit on Determines whether ungraded items count as 0s in the final grade, or if the ungraded items are dropped from the final grade calculation. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.MaxRecordProcessingCount Org 20 Determines the number of records that are processed at one time when grades are recalculated.

d2l.Tools.Grades.MyGrades.ControlDecimalPlaces OrgUnit 2 Determines the number of decimal places to display to participants for grade items. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.MyGrades.NumbCharsToDisplay OrgUnit 15 Determines the number of characters to display to participants for Text grade items. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.MyGrades.ShowFinalAverage OrgUnit off Determine whether the class average for the final grade is displayed to the users. Can also be set from the Edit Final Grade page.

d2l.Tools.Grades.MyGrades.ShowFinalDistribution OrgUnit off Determines whether the distribution of grades for the final grade is displayed to the users. Can also be set from the Edit Final Grade page.

d2l.Tools.Grades.MyGrades.ShowFinalGradeFormula OrgUnit off Determines whether the final grade calculation formula used to calculate users' grades is released to users. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.MyGrades.ShowGradeColours OrgUnit off Determines whether the colors associated with a grade scheme displays to users. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.MyGrades.ShowGradeScheme OrgUnit off Determines whether a user's grade scheme achievement on a grade item or final grade displays to that user. Can also be set from the Grades Settings area or Grades Setup Wizard.




d2l.Tools.Grades.MyGrades.ShowPoints OrgUnit on Determines whether the points grade a user achieved on a grade item displays to that user. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.MyGrades.ShowWeighted OrgUnit on Determines whether the weighted grade a user achieved on a grade item displays to that user. Can also be set from the Grades Settings area or Grades Setup Wizard.

d2l.Tools.Grades.SetupWizard Org on Determines whether the Grades Setup Wizard is available.

d2l.Tools.Grades.ShowFormulaGradeItemType Org off Determines whether Formula grade items can be created in the grade book.

d2l.Tools.Grades.ShowFormulaSystemOption Org off Determines whether the Formula grading system can be used to evaluate users.

d2l.Tools.Groups.UseGroupCode Org on Determines whether groups have a Group Code.

d2l.Tools.Groups.UseSectionCode Org on Determines whether sections have a Section Code.

d2l.Tools.HoldingTank.Grades.ExportMessage OrgUnit Send Course Grades to Student Information System for your REVIEW and final approval.

Text displayed in grade book as instructions of where the export to sis is sending the data.

d2l.Tools.HoldingTank.Grades.PostExportURL Org If set, this defines a URL to forward the user to after successfully exporting grades to SiS. You can specify {orgunitid} if you need to include the OrgUnitId in the URL. For example: http://foo.bar.com?id={orgunitid}

d2l.Tools.HoldingTank.Log.DaysToKeep Org 7 Days of log entries to keep Clear log button is selected.

d2l.Tools.Homepages.MaxCourses Org 25 The threshold for the My Courses widget

d2l.Tools.Homepages.MyCoursesIsCollapsible Org off Default value of allow groupings to be collapsible for the My Courses widget




d2l.Tools.Homepages.XLastAccessed Org 10 The number of last accessed courses to display on the administrative view of the widget

d2l.Tools.IntelligentAgents.PreferredRunHour System 10 The preferred hour of day to evaluate all Intelligent Agents (24 hour)

d2l.Tools.Languages.ForceLanguage OrgUnit off Forces users to use the default language set for the course. They cannot use their preferred language set in My Preferences.

d2l.Tools.Locker.EnablePubliclySharedLockerFiles Org off Controls whether locker files can be made public (shared with other users).

d2l.Tools.Locker.GroupLockerMaximumTotalFilesize OrgUnit 5000 Maximum filesize (in kilobytes) for all items in a group locker. Accepted Values: A numeric value. 0 = no limit.

d2l.Tools.Locker.MaximumFilesize Role-OrgUnit

0 Maximum filesize (in Kb) for a single locker item. Accepted Values: A numeric value. 0 = no limit.

d2l.Tools.Locker.MaximumTotalFilesize Role-OrgUnit

1000 Maximum filesize (in Kb) for all items in a single locker.Accepted Values: A numeric value. 0 = no limit.

d2l.Tools.Login.InformUserOnLockout Org off Controls whether a message is displayed to users when they try to log in to an account that has been locked out.

d2l.Tools.Login.LocalPrivateKey Org ******* Shared secret key for single sign-on

d2l.Tools.Login.LockoutPeriod Org 1 Time, in minutes, that a user's account is locked out after five consecutive failed login attempts.

d2l.Tools.LOR.AllowExternalAvailabilityEdit Org off Allows users to edit the external availability property.

d2l.Tools.LOR.AllowHarvest Org off If turned on, this variable allows LORs in the organization to be opened up for other utilities to harvest metadata from.

d2l.Tools.LOR.ExternalAvailability Org off Allows the ORG to set a default for learning objects as public or not.

d2l.Tools.LOR.Harvesting.HarvestInterval System 1 Interval harvesting service would run, in minutes.




d2l.Tools.LOR.Harvesting.HarvestMaxRecords System 1000 Maximum records to harvest per repository for a given session.

d2l.Tools.LOR.Harvesting.HarvestTimeout System 60 Time to timeout a harvest in seconds.

d2l.Tools.LOR.Harvesting.ImportInterval System 1 Interval the harvest importing service would run, in minutes.

d2l.Tools.LOR.Harvesting.ImportMaxRecords System 1000 Maximum records to import per repository for a given session.

d2l.Tools.LOR.HarvestProvider.AdminEmail Org Email used by the LOR interoperability protocols.

d2l.Tools.LOR.HarvestProvider.ThrottlingWindow Org 600 A fixed value, in seconds, to deny repeated requests to the provider from the same IP address to the same LOR.

d2l.Tools.LOR.PerformAdvancedSearch Org on Allow for advanced searching

d2l.Tools.LOR.PerformFederatedSearch Org off If turned on, this variable allows users of the LOR to perform federated searches on available federated repositories and partner collections.

d2l.Tools.LOR.PerformHarvest Org off If turned on, this variable allows users of the LOR to perform harvesting searches on available metadata repositories and partner collections.

d2l.Tools.LOR.Search.LastTimeIndexed System The time that the index was last updated by the indexing service

d2l.Tools.LOR.Search.SeeSettings Org on Allow settings to be accessed in the LOR.

d2l.Tools.LOR.SearchResults.ResultsPerPage User 10 The number set for this variable will determine the maximum number of Learning Objects displayed per page on the LOR search results page(s).

d2l.Tools.LOR.SearchResults.ShowCreated User on When this variable is turned On, the date the Learning Objects were created will be displayed in the LOR search results.




d2l.Tools.LOR.SearchResults.ShowDescription User on When this variable is turned On, the Metadata description for the Learning Objects will be displayed in the LOR search results.

d2l.Tools.LOR.SearchResults.ShowIdentifier User on When this variable is turned on, the Identifier field will be displayed if available in the LOR search results.

d2l.Tools.LOR.SearchResults.ShowKeyWords User on When this variable is turned On, the Metadata keywords for the Learning Objects will be displayed in the LOR search results.

d2l.Tools.LOR.SearchResults.ShowLOR User on When this variable is turned On, the LOR name where the Learning Object is located will be displayed in the LOR search results.

d2l.Tools.LOR.SearchResults.ShowRating User off When this variable is turned On, the rating given to the Learning Objects, in LOR Reviews, will be displayed in the LOR search results.

d2l.Tools.LOR.SearchResults.ShowStatus User off When this variable is turned On, the status of the Learning Objects will be displayed in the LOR search results.

d2l.Tools.LOR.SearchResults.ShowType User on When this variable is turned On, the Learning Object type (example: course, simulation, etc.) will be displayed in the LOR search results.

d2l.Tools.LOR.SeeFiles Org off Users are able to see a list of files that make up a learning object or asset in the LOR.

d2l.Tools.LOR.SeeReviews Org on If turned on, this variable allows users to see the reviews tab in LOR View Details.

d2l.Tools.Mail.Client.IMAP.CanEditServer Org off Allows users to specify the IMAP server to connect to for outside email. This is a read-only variable.

d2l.Tools.Mail.Client.IMAP.Server Role-OrgUnit

The mail server used for users enrolled in the organization in this role. A valid server name.




d2l.Tools.Mail.Client.MailboxSorting User The field the mailbox is sorted on by default. This is a read-only variable.

d2l.Tools.Mail.D2LMailDomain Org ucourses.com

d2l.Tools.Mail.DomainExceptionsforSendReceive Org When this variable has a value, each user of the email tool will be able to send messages to any email domains or addresses provided here, provided they have permission to send messages and that a valid SMTP server is setup.

d2l.Tools.Mail.FilterByDefaultValue Org All messages This variable controls what the Filter By dropdown is defaulted to when accessing the email tool. The selection 'Current Course Offering' defaults the Filter By dropdown to a course offering when the email tool is accessed from a course offering.

d2l.Tools.Mail.PostmasterAddress System [email protected]

The email address for the postmaster of the mail server. This is a read-only variable.

d2l.Tools.Mail.PostmasterName System postmaster The display name for the postmaster of the mail server. This is a read-only variable.

d2l.Tools.Mail.SaveEmail System on Whether received email is saved to a backup folder. This is a read-only variable.

d2l.Tools.Mail.SendUndeliverableMessagesToSender Org on When this configuration is enabled, a message is generated on undeliverable messages that is sent to the message's original sender from the postmaster address.

d2l.Tools.Mail.ShowPreviewPane User 1 Whether the preview pane is displayed by default in the message list and contacts list. Users can override this value in Email > Settings.

d2l.Tools.Mail.Signature User email signature




d2l.Tools.Mail.StorageSpace Role-OrgUnit

0 The maximum space (in kilobytes) that can be used for messages saved in email folders for users enrolled in the organization in the specified role. '0' means unlimited. This is a read-only variable.

d2l.Tools.Mail.UndeliverableMessage System The following recipients did not receive the attached message: {recipients}

Reply sent for undeliverable messages. (E.g. if a user sends a message to an invalid address, this reply will be sent back to inform them that their message could not be delivered.)This is a read-only variable.

d2l.Tools.Mail.UseReplyToInFromAddress Org off This variable, when enabled, will populate the 'From' address with the same field as the 'Reply To' address.

d2l.Tools.Mail.UserSettings.AllowFilterOnGroups User 1 Controls whether users see groups and sections listed by default in the "Filter By" drop-down when viewing email messages and contacts. Users can change this setting on the Email Settings page.

d2l.Tools.Mail.UserSettings.CCExternalEmailOnSend User off Copy on all sent messages

d2l.Tools.Mail.UserSettings.ForwardEmailAction User Mark read Forward received e-mail, and mark message action

d2l.Tools.Mail.UserSettings.ForwardToEmailAddress User Forward received e-mail to this external address

d2l.Tools.Mail.UserSettings.ForwardToExternal User off Forward received e-mails to an external address

d2l.Tools.Mail.UserSettings.MarkReadWhenPreviewed User off Default setting for whether messages are marked as read when viewed in the preview pane. Only applicable if ShowPreviewPane is enabled. Users can override this setting from Email > Settings.

d2l.Tools.Mail.UserSettings.ReplyToAddress User 'Reply to' Address

d2l.Tools.Mail.UserSettings.ReplyWithHistory User off Default setting for whether the text from the original message will be included in replies. Users can override this setting from Email > Settings.

d2l.Tools.Mail.UserSettings.SaveCopyOnSend User on Save a copy of the e-mail message to sent folder




d2l.Tools.Mail.UserSettings.ShowAuditorsInContacts User off Show auditors in the address book

d2l.Tools.Mail.UserSettings.ShowExternalEmail User on Show external e-mail address in address book

d2l.Tools.Mail.UserSettings.ShowFolderPane User on Controls whether the folder pane is displayed by default in the Message List and Address Book. Users can change this setting through Email > Settings.

d2l.Tools.Mail.UserSettings.ShowInternalEmail User on Show internal e-mail addresses in address book

d2l.Tools.ManageFiles.RootName OrgUnit Path Used to override the name of the root folder in the Manage Files screen. By default, the org unit's name is used. This is a read-only variable

d2l.Tools.Metadata.Settings.ExpandFirstCategory User on Shows the first category expanded by default. This is only applicable if 'IsEditorExpanded' and 'IsAdvancedMode' are disabled.

Users can change this in My Preferences.

d2l.Tools.Metadata.Settings.IsAdvancedMode User on Controls whether users see Advanced Mode by default.Users can change this in My Preferences.

d2l.Tools.Metadata.Settings.IsEditorExpanded User on Controls whether users see the editor expanded by default. This is only applicable if 'IsAdvancedMode' is disabled.Users can change this in My Preferences.

d2l.Tools.Metadata.Settings.IsListView User on Controls whether users see the List View by default. Users can change this in Metadata Administration.

d2l.Tools.Mojo.IsFormatNickName OrgUnit off Determines whether nicknames are formatted in chat messages.

d2l.Tools.QC.DefaultEnumeration OrgUnit no enumeration Default enumeration style used when creating new questions or importing questions. This is a read-only variable

Accepted Values: (1, 2, 3, 4,…); (i, ii, iii, iv, v,…); (I, II, III, IV, V,…); (a, b, c, d, e, f,…); (A, B, C, D, E, …); no enumeration




d2l.Tools.QC.LongAnswer.AllowHtmlResponse OrgUnit on Enables the ability to allow participants to use the HTML Editor when composing responses to Long Answer style questions.

When turned on, the 'Allow HTML Editor to be used for responses' check box appears when creating/editing a Long Answer question.

d2l.Tools.Quizzes.ShowDataOnResultsPages Org on Controls whether the Results page shows any data if no search has been performed. When turned off, no data is displayed until a search is performed. (Disabling this setting can help prevent performance delays when the page is first loaded.)

d2l.Tools.Quizzes.ShowQuizHomeLink OrgUnit on Displays the 'Quizzes Home' link to users on the tool menu in the Quizzes tool.

d2l.Tools.Quizzing.DisablePagerAccess OrgUnit on Determines whether the option to disable pager access during an active quiz attempt is available. When set to 'On', there is a check box under Edit Quiz > Properties > Optional Advanced Properties that allows user to disable pager access for a particular quiz.

d2l.Tools.Quizzing.ShowSpellCheckInAttempts OrgUnit on Determines whether the spell checker is displayed for users when taking a quiz.

d2l.Tools.Quizzing.ViewType OrgUnit By Availability The view type for the Quiz List page. Can also be set from the Quiz List page by selecting an option from the View drop-down list.

d2l.Tools.Schedule.DisplayAllUpcoming Org on Widget display option: to display upcoming events.

d2l.Tools.Schedule.DisplayGroupEvents Org 1 Widget display option: display org unit events [br] Values: [br] 1 – All Org Unit events [br] 2 – Current Org Unit [br] 3 – Org Unit events not displayed

d2l.Tools.Schedule.DisplayOptions.DisplayGroupSect User 2 Schedule display option to show Group/Section events when on




d2l.Tools.Schedule.DisplayOptions.DisplayOrg User on Schedule display option to show ORG events when on

d2l.Tools.Schedule.DisplayOptions.DisplayOrgUnit User 1 Schedule display option to display org unit events Values: 1 – All Org Unit events 2 – Current Org Unit 3 – Org Unit events not displayed

d2l.Tools.Schedule.DisplayOptions.DisplayPersonal User on Schedule display option to show personal events when on.

d2l.Tools.Schedule.DisplayOrgEvents Org on Widget display option: display org events

d2l.Tools.Schedule.DisplayOrgUnitEvents Org 1 Widget display option: display org unit events.

Values:

1 – All Org Unit events

2 – Current Org Unit

3 – Org Unit events not displayed

d2l.Tools.Schedule.DisplayPersonalEvents Org on Widget display option: display personal events

d2l.Tools.Schedule.DisplayTomorrow Org off Widget display option: to display today's events as the primary events or today and tomorrow's events as the primary events.

d2l.Tools.Schedule.DisplayUpcoming Org 5 Widget display option: specifies # of days' upcoming events to display.

d2l.Tools.Schedule.HasLocation OrgUnit off Enables the Location field in the Schedule tool (users can enter locations for events).

d2l.Tools.Schedule.OrgUnitEventColour OrgUnit #FFBB66 The color used for org unit events in the calendar.Accepted Values: Any valid HEX color (preceded by the '#' character)

d2l.Tools.Schedule.PersonalEventColour OrgUnit #3366FF The color used for personal events in the calendar.Accepted Values: Any valid HEX color (preceded by the '#' character)

d2l.Tools.Schedule.Settings.CurrentDate Session Specifies date the user is currently viewing in the schedule views




d2l.Tools.Schedule.Settings.CurrentView User day Specifies view ( day, week, month ) the user is currently viewing in the schedule tool

d2l.Tools.Schedule.Settings.FeedURL User URL used to publish the user schedule

d2l.Tools.Schedule.Settings.IntervalPeriod User ’08:00’, ’17:00’ Specifies the start and end time for the interval period displayed on the Schedule day view.

D2l.Tools.Schedule.Settings.PrivateEventsInRSS User off When set, users private events are included in the RSS feed.

d2l.Tools.Schedule.Settings.Publish User off User setting to allow others to view the user's schedule via RSS feed.

d2l.Tools.Schedule.Settings.ScheduleAccess User 1 Sets the allowed access by others to the user's schedule: 1- do not allow 2- allow everyone 3- only users in my courses

d2l.Tools.Schedule.Settings.Show24HourDay User off Displays the day in 1 hour intervals for all 24 hours when on. When off, displays 1 hour intervals for time specified.

d2l.Tools.Schedule.Settings.Show5dayWeek User off Display week Monday through Friday instead of entire week when on.

d2l.Tools.Schedule.UseDailyGrid OrgUnit off When turned on, the Day view of the calendar is displayed as a grid.

d2l.Tools.Schedule.UseMonthGrid OrgUnit off When turned on, the Month view of the calendar is displayed as a grid.

d2l.Tools.Schedule.UseWeeklyGrid OrgUnit off When turned on, the Week view of the calendar is displayed as a grid.

d2l.Tools.Security.User.RecentToolId User Most Recent Tool Id of the Role Permissions Page

d2l.Tools.Spellcheck.DictionaryLanguage OrgUnit Language used by the spell checker. This setting should not be modified without assistance from an Implementation Specialist.




d2l.Tools.SurveyResults.ShowDataOnResultsPages Org on When this variable is turned off, the page will contain no data until a search is performed. This setting can help to prevent performance delays when the page is first loaded.

d2l.Tools.Surveys.HasBranchingTool OrgUnit off Determines whether the 'Branching Wizard' button is displayed on the Layout/Questions tab of surveys, which allows users to control which questions are presented to survey participants based on previous responses.

d2l.Tools.Surveys.HasConfirmSubmission Org on Controls whether users see a warning page when submitting a survey containing unanswered questions.

When disabled, survey participants can submit a survey with unanswered questions without receiving a warning. When enabled, participants see a warning page that lists and provides links to the survey questions they have not answered.

d2l.Tools.Surveys.HasInviteParticipants OrgUnit off Determines whether the 'Invite Participants' button is displayed on the Survey Properties page.

d2l.Tools.Surveys.UseSignedComments Org off Makes the 'Allow signed comments' checkbox available when creating or editing Long Answer questions. (Selecting this checkbox will in turn display another checkbox 'I give permission for my name to be released with the comments entered above' to survey participants completing the question.)

d2l.Tools.Surveys.ViewType OrgUnit 1 The view type for the Survey List page. Can also be set from the Survey List page by selecting an option from the View drop-down list.

Accepted Values: 0 (by category), 1 (by availability)

d2l.Tools.UserManagement.OrgHasAuditors Org off Enables auditor access, allowing auditors to be associated with existing users. When turned on, the Add Auditor link is displayed on the Edit User page.




d2l.Tools.WYSIWYG.AllowHTMLSourceEditing Role-OrgUnit

off Whether or not HTML source can be directly edited in the WYSIWYG and RichEdit controls.



Appendix A: Addenda

8.3.1 MR1


d2l.Tools.HoldingTank.Grades.PostExportURL Org If set, this defines a URL to forward the user to after successfully exporting grades to SiS. You can specify {orgunitid} if you need to include the OrgUnitId in the URL. For example: http://foo.bar.com?id={orgunitid}

DOME v.8.3 Administration Guide Appendix B: Revision History Appendix A: Addenda


Appendix B: Revision History

Edition Notes

Second (Nov. 4, 2008) Removed config variable d2l.Tools.Classlist.DisplayAddParticipants that was no longer used by the system.

Third (Nov. 14, 2008) Added config variable d2l.Tools.HoldingTank.Grades.PostExportURL to addendum for 8.3.1 MR1

DOME v.8.3 Administration Guide Index Appendix A: Addenda


Index

C child org units, 19

add, 28

edit, 27

manage, 27

moving org units automatically, 29

moving org units manually, 29

remove a child from a parent org unit, 28

configuration variables, 16

all caps, 15

edit, 16

editing, 15

finding, 14

folders and prefixes, 14

full listing, 36

manage, 10

org unit, 11

organization, 10

organizing, 14

restore defaults, 17

role – org unit, 13

session, 13

summary, 13

types, 10

user – org unit, 12

users, 12

D dome

about, 5

access, 8


form elements, 7

key terms, 8

org unit properties, 6

org unit type editor, 7

org unit utilities, 7

what is the dome, 6

F form elements

manage, 32

forms

modify, 33

M manage


manage quicklinks

configure from the dome, 26

O org unit

changing icons, 22

create, 20

delete, 23

edit, 22

org unit editor

delete, 25

manage org units, 24

modify properties, 25

recycle, 25

search, 24

viewing options, 24

org unit type editor

setting up organization hierarchy, 18

standard org unit types, 18

org units

changing colors, 29

scan for orphaned units, 31

scan units without children, 30

utilities, 30

organization tools

add tools, 34

manage, 34

remove tools, 34

renaming tools, 35

setting defaults, 34

P parent org units

manage, 27

permissions

setting permissions, 9

DOME v.8.3 Administration Guide Index Appendix A: Addenda


S standard org unit types

information, 19

role, 18

Documents

Desire2Learn Organization Management Environment (DOME) v8.3