Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Parameter

Value

BRIGHTSPACE_ALL_GRADES_DATA_SET_ID

The ID number of the Brightspace Data Hub All Grades Data Set

(See instructions: Retrieving Brightspace PluginId and DataSetId values) ObsoleteLeave blank

BRIGHTSPACE_API_NAME

CC_D2L

BRIGHTSPACE_API_VERSION

1.25

BRIGHTSPACE_APPLICATION_ID

The application ID created during register an app

BRIGHTSPACE_APPLICATION_KEY

The key created during register an app

BRIGHTSPACE_ASSIGNMENT_SUBMISSION_DETAILS_PULGIN

Obsolete - leave Leave blank

BRIGHTSPACE_ASSIGNMENT_SUBMISSIONS_PULGIN

Obsolete - leave Leave blank

BRIGHTSPACE_ASSIGNMENT_SUMMARY_PULGIN

Obsolete - leave Leave blank

BRIGHTSPACE_AUTO_QUEUE_ITEMS

If set to Y, the system will auto-queue course sections created prior to the number of days specified in BRIGHTSPACE_OFFERING_DAYS_ACTIVE_BEF_BEG. The course sections will then be created in Brightspace the number of days prior to the course start date specified in BRIGHTSPACE_OFFERING_DAYS_ACTIVE_BEF_BEGIN.

BRIGHTSPACE_BASE_URL

The login URL for Brightspace similar to https://<your-school-code>.brightspace.com

BRIGHTSPACE_COPY_CONTENT

Optional: Configure the connector so that when a Brightspace class is created, it will copy the course content from a master course. The master course in Brightspace must have a course code prefix starting with the value entered here. For example, the master courses in Brightspace start with Master_, enter "Master_" for this value.

BRIGHTSPACE_CREATE_UPDATE_USER

A "Y" indicates that the connection will create a Brighspace user account for a student or faculty if one is not found in Brightspace already. An "N" will direct the connection not to create a Brightspace account. Without an account, the individual will not be able to be associated with a class in Brightspace.

BRIGHTSPACE_CUTOVER_SEMESTER

The Campus Cafe semester code that represents the first semester for which to transfer information from Campus Cafe to Brightspace will occur. For example, 202110

BRIGHTSPACE_DAYS_ACTIVE_AFT_END

Number of days after course end date that enrollments remain active. Enter 0 as default.

BRIGHTSPACE_DAYS_ACTIVE_BEF_BEGIN

Number of days before course begin date that enrollments become active. Enter 0 as default.

BRIGHTSPACE_DAYS_ADJUST_OFFRG_BEGIN_DATE

Days to adjust offering begin date from CC course date. Enter 0 as default.

BRIGHTSPACE_DAYS_ADJUST_OFFRG_END_DATE

Days to adjust offering end date from CC course date. Enter 0 as default.

BRIGHTSPACE_DISCUSSION_POSTS_PULGIN

Obsolete - leave Leave blank

BRIGHTSPACE_EMAIL

An alert will be sent to this email if an error occurs.

BRIGHTSPACE_GRADE_OBJECTS_PULGIN

Obsolete - leave Leave blank

BRIGHTSPACE_IMPORT_APPLICATION_ID

Same as BRIGHTSPACE_APPLICATION_ID

BRIGHTSPACE_IMPORT_APPLICATION_KEY

Same as BRIGHTSPACE_APPLICATION_KEY

BRIGHTSPACE_IMPORT_BASE_URL

Same as BRIGHTSPACE_BASE_URL

BRIGHTSPACE_IMPORT_HOURS_TO_OVERWRITE_FINAL_GRADE

Enter 0 to prevent final grade changes. If set to zero (0), once a final course grade is imported from Brightspace, it will not be overridden by future imports from Brightspace (e.g. if an instructor assigns a final course grade of a B and then later changes it to an A, Campus Cafe will record the B.) Otherwise, enter the number of hours after the last day of the course that a new final grade will be accepted to replace an existing final grade.

BRIGHTSPACE_IMPORT_SEMESTER_MINIMUM

The Campus Cafe semester code that represents the first semester for which to transfer information from Campus Cafe to Brightspace will occur. For example, 202110

BRIGHTSPACE_IMPORT_USER_ID

The user id generated during the Register App phase

BRIGHTSPACE_IMPORT_USER_KEY

The user key generated during the Register App phase

BRIGHTSPACE_INSTRUCTOR_ADD_ONLY

Only add instructors, allows manually changing D2L inst role and adding inst not in CC. Enter N by default.

BRIGHTSPACE_INSTRUCTOR_ROLE

Brightspace role associated with instructors. Enter Instructor as default. Case sensitive

BRIGHTSPACE_LDA_GRADE_ITEM_NAME_PREFIX

Obsolete - leave Leave blank

BRIGHTSPACE_MAX_RETRY_ATTEMPTS

Number of times to try processing an entry. Enter 2 as default.

BRIGHTSPACE_OFFERING_DAYS_ACTIVE_BEF_BEGIN

Enter a number representing days. Course sections created in Campus Cafe, will be created in Brightspace this number of days or fewer prior to the course section start date.

BRIGHTSPACE_PARENT_ORG_D2LID

Enter the Brightspace numerical code of the institution's parent organization. Typically, this code is 6066.

BRIGHTSPACE_QUIZ_ATTEMPTS_PULGIN

The ID number of the Brightspace Data Hub Assignment Quiz Attempts Data Set

(See instructions: Retrieving Brightspace PluginId and DataSetId values)

BRIGHTSPACE_QUIZ_INCLUDE_COMPLETED_ONLY

Enter Y to import only completed quizzes as assignments in Campus Cafe. Enter a N to exclude them.

BRIGHTSPACE_REMOVE_FROM_QUEUE_DAYS

Number of days after processing entry should remain on queue. Enter 30 as default.

BRIGHTSPACE_RETRY_MINUTES

Number minutes to wait before reprocessing an entry. Enter 30 as default.

BRIGHTSPACE_SEND_USER_CREATION_EMAIL

Enter Y for Brightspace to send an email to a user created in Brightspace by the connector. The email contains the user's Brightspace account information.

BRIGHTSPACE_STUDENT_ROLE

Brightspace role associated with students. Enter Learner as default. Case sensitive. If using 4 student roles separate names by || (ex. a||b||c||d). The role meanings are defined by position (position meanings: a-default, b-hold, c-before course begin date, d-after course end date).

BRIGHTSPACE_TIMEZONE

Enter the time zone. US/Eastern; US/Central; US/Mountain or US/Pacific Case sensitive

BRIGHTSPACE_UPDATE_USER_EMAIL

A "Y" indicates that if an individual's email changes in Campus Cafe, the connection should also update the individual's email in Brightspace. An "N" indicates that updates to an individual's email address in Campus Cafe will not update in Brightspace.

BRIGHTSPACE_UPDATE_USERNAME

A "Y" indicates that the connection will replace the individual's Brightspace username with his or her Campus Cafe username if different. An "N" indicates that Campus Cafe will not attempt to change the individual's Brightspace username to match his or her Campus Cafe username. If your institution already has Brightspace in place and wishes to preserve existing Brightspace usernames, set this to "N."

BRIGHTSPACE_USER_ID

The user id generated during the Register App phase

BRIGHTSPACE_USER_KEY

The user key generated during the Register App phase

...

Contact Campus Cafe support to activate the connection.

...

set up the automatic processing job. This job will process items on the queue every 10 minutes.

Manually Sync Enrollment Data

By default, data transfer between Campus Cafe and Brightspace occurs in near real-time. To manually launch the connection complete the about every ten minutes. However, the queue may be manually processed at any time by following the steps below.

  1. Log in to Campus Cafe

  2. Navigate to Registrar > LMS Management

  3. The number next to Unprocessed Queue Entries Count indicates the number of enrollment items waiting to sync

  4. Click Click Select “Click Here to Manually Run Brightspace queue processor for 100 entriesentries”

  5. If necessary, click Click select “Click Here to Manually Run Brightspace queue processor for 100 entries entries” again to process the next 100 entries and repeat until nothing remains in queue

...

  1. Log in to Campus Cafe

  2. Navigate to Registrar > LMS Management

  3. Click Queue History Log

...

Final Course Grades Import

This function requires the Brightspace Data Hub module sold separately by D2L.For final course grades

Note

Students must have a value assigned in the Brightspace course final grade for the grade to be imported

...

to Campus Cafe

...

. Blank grades will be imported as 'F' grades.

All Canvas final grades must match values on the Quality Points table in Campus Cafe.

Custom Control Moodle 2-6 controls whether the sync will overwrite existing grades in Campus Cafe (not including I or W grades). 

The following options are available by navigating to Registrar > LMS Management 

  • Run Participation and Grade Import after Retrieving Latest Import Data: Clicking this will load Brightspace activities, graded items and final course grades from Brightspace into Campus Cafe. The assignments are visible by clicking the assignments icon on the student's enrollment history screen. The final course grades will be placed in the student's enrollment in Campus Cafe. The process also updates the last day of attendance in Campus Cafe.

  • Run Grade Import after Retrieving Latest Import Data: Clicking this will load only Brightspace graded items and final course grades from Brightspace into Campus Cafe. The process does not update the last day of attendance in Campus Cafe.

  • Run Participation and Grade Import using Files Manually Downloaded: Not in use. For use by Campus Cafe support only.

Exclude Course and its Enrollments from the Integration

A specific course may be excluded from the integration. The course will not be created in Brightspace and students not enrolled.

  1. In Campus Cafe navigate to the course section (Registrar > Course Finder > Magnifying glass next to course)

  2. Click the Codes tab

  3. Check the Exclude From LMS Integration box

  4. Click Save

Multiple Campus Cafe Course Sections Associated with Single Brightspace Offering

Your institution may combine students from multiple discrete Campus Cafe class sections, each with their own roster, meeting times, etc., into one Brightspace offering. This is often done so the instructor does not need to independently maintain the same academic content across multiple Brightspace offerings. 

Such classes require special handling.

...

In Brightspace, navigate to the Course and then Course Administration > Course Offering Information

Set the Course Offering code to something not used by any other Brightspace offering

...

 Set this to Y to permit overwriting of existing grades or N to prevent existing grades in Campus Cafe from being replaced by the grade import.

Final grade values from Brightspace must match values in the Campus Cafe Quality Points table in order to import.  Additionally, final grades in Brightspace must be released.

  1. Navigate to Registrar > LMS Management

  2. Click on Final Grade Synchronization at the bottom of the page (BRIGHTSPACE_IMPORT options must be configured in Web App Config for this option to appear)

  3. Select the Semester to Synchronize from the drop-down

  4. Optional: Enter the Course Number to import grades for a specific course

  5. Optional: Check the Report Only box to run the grade report in non-update mode.  This will generate the grades that will be imported in the Process Output Messages box, but will not update grades on the students' records.  

Warning

Before running this process in update mode, be sure all final grades have been posted and released in Brightspace.

Running the grade synchronization process with blank final grades will result in a grade of ‘F' posting to the student’s record in Campus Cafe.

Running the grade synchronization prior to releasing the grades in Brightspace will result in an error message and no grades will be imported.

  1. Click Synchronize to begin the process

  2. Click Refresh Job Output to view updates on the progress and which grades have been processed in the Process Output Messages box.

Exclude Course and Enrollments from the Integration

A specific course may be excluded from the integration. The course will not be created in Brightspace, and student enrollments will not be sent to Brightspace.

  1. In Campus Cafe navigate to the course section (Registrar > Course Finder > Magnifying glass next to course)

  2. Click the Codes tab

  3. In Check the Exclude from LMS Course Code Override box enter the SIS ID number you entered in BrightspaceRepeat steps 3-5 for each Campus Cafe sectionIntegration box

  4. Click Save

Brightspace Final Grade Synchronization (Manual Import Process)

Final Grades may also be imported via the LMS Management menu without differential files. This is completed by running the process manually using the Final Grade Synchronization option. This option can be found under Campus Cafe menu option: Registrar>LMS Management (the options only displays if you have made the BRIGHTSPACE_IMPORT_ configurations). It is located at the bottom of the page. 

Final grade values from Brightspace must match values in the Campus Cafe Quality Points table in order to import.  Additionally, final grades in Brightspace must be released.

...

Navigate to Registrar > LMS Management

...

Click on Final Grade Synchronization (Brightspace import options must be configured in Web App Config)

...

Select the Semester to Synchronize from the drop-down

...

Optional: Enter the Course Number to import grades for a specific course

...

Optional: Check the Report Only box to run the grade report in non-update mode.  This will generate the grades that will be imported in the Process Output Messages box, but will not update grades on the students' records.  

...

Click Synchronize to begin the process

...

Multiple Campus Cafe Course Sections Associated with Single Brightspace Offering

Your institution may combine students from multiple discrete Campus Cafe class sections, each with their own roster, meeting times, etc., into one Brightspace offering. This is often done so the instructor does not need to independently maintain the same academic content across multiple Brightspace offerings. 

Such classes require special handling.

  1. In Brightspace, navigate to the Course and then Course Administration > Course Offering Information

  2. Set the Course Offering code to something not used by any other Brightspace offering

    MultipleBrigtspaceCourses.pngImage Added
  3. In Campus Cafe navigate to the course section (Registrar > Course Finder > Magnifying glass next to course)

  4. Click the Codes tab

  5. In the LMS Course Code Override box enter the SIS ID number you entered in Brightspace

  6. Repeat steps 3-5 for each Campus Cafe section

  7. Click Save