Skip to main content
pdf?stylesheet=default
Blackboard Help

Courses File

The Courses file contains information about the courses and organizations at your institution. Include field names and values that correspond to customizations you made in the Properties file.

To Create the Courses File

  1. Follow Steps 1-3 as performed in the Users file creation process.
  2. Save the file and name it courses.csv.

Example:
course_id,external_course_key,course_name,available,start_date,end_date,course_type
1,course_1,Spanish,Y,2010-09-01,2010-12-09,course
2,org_1,Technology,Y,2008-01-01,2035-12-31,organization

Field Name

Description

Required

Accepted Value(s)

course_id

A unique course identifier. Each user sees this value when reviewing their Blackboard IM settings; it is used by Blackboard IM Administrators for searches and course identification purposes. It can be identical to its corresponding external_course_key value.

yes

Maximum of 255 characters

external_course_key

A unique, opaque course identifier that is not visible to users.
By default, this is set to its corresponding course_id value.

no

Maximum of 255 characters

course_name

The display name of the course in Blackboard IM.

yes

Maximum of 255 characters

available

Determines whether or not a course is available to users. Unavailable courses are synchronized so that they can be made available at any time.

By default, this is set to: Y.

no

Y, N
True, false
Yes, no
1 (true), 0 (false)

start_date

The starting date for a course with limited availability.

By default, this field is blank.

no

Any date that conforms to the date_format value in
the Properties file

end_date

The ending date for a course with limited availability.

By default, this field is blank.

no

Any date that conforms to the date_format value in
the Properties file

course_type

Allows you to make a distinction between courses and organizations at your institution; there is no functional difference in Blackboard IM.
By default, this is set to: course.

no

course, organization

course_description

A long description of the course; if the description contains multiple lines, insert the escape character at the end of each line.

no

Maximum of 4,000 characters