Skip to main content
Blackboard Help

Create Courses With Batch Files

Batch files are delimited files that allow you to create or copy as many as 500 courses at one time. To learn more about creating batch files, see Batch File Guidelines for Courses.

Create courses in batch

  1. On the Administrator Panel in the Courses section, select Courses.
  2. Point to Create Course and select Batch from the list.
  3. On the Batch Create Courses page, select the File Location field or select Browse.
  4. In the File Upload window, navigate to the batch file and select Open.
  5. Select the file Delimiter Type that the batch file uses. If you select Automatic, Blackboard Learn analyzes the batch file and determines the delimiter based on the frequency of the character in the file.
  6. Select Submit.

Copy courses in batch

To better serve your integration needs, the new SIS Framework provides an improved interface for managing and processing Snapshot based data. While current command-line based snapshots will continue to work with legacy data objects, the Snapshot command line tool and the Snapshot XML data format are deprecated in Blackboard Learn 9.1 Service Pack 8 and will receive only maintenance fixes. Additionally, the Snapshot command line tools will be removed in the Learn SaaS deployment.

You can copy multiple courses at once with a batch file and the Snapshot command-line tool.

The batch copy performs an exact copy of each source course. An exact copy includes user enrollments along with course information and materials.

You can create new courses with the batch copy, or you can copy course information and content into an existing course. If the destination course already exists, the batch copy updates the course information but does not overwrite any course content.

  1. Create the batch file. The batch copy file format does not follow the same rules as the batch file for creating a new course. Instead, the batch copy uses the Snapshot flat file format.
  2. Run the batch copy command in Snapshot from the Web/app server. The command syntax is as follows, where path_to_file is the full path to the copy batch file:

    Windows Syntax: C:\Blackboard\tools\admin\BatchCourseCopy.cmd path_to_file

    UNIX Syntax: /usr/local/blackboard/tools/admin/ path_to_file

    The exact path to the Blackboard Learn directory may be different based on where Blackboard Learn was installed.

    The command only processes a batch copy on the default virtual installation. To perform a batch copy on another virtual installation, use the COPYINTO Snapshot command.

Create the batch file

In the Snapshot format, the first row defines the attributes to copy and the subsequent rows provide the values for each attribute. The file must be a TXT file, and the delimiter used in the file must match the delimiter defined in the file. The default delimiter is the pipe (|).

Example: This example shows a batch copy file that will create three new courses.


HIST101a|HIST101a|Introduction to American History until 1865|HIST101
HIST102a|HIST102a|Introduction to American History from 1865|HIST102
HIST103a|HIST103a|Introduction to Central American History|HIST103

The EXTERNAL_COURSE_KEY is an attribute used for advanced data management. If the course was created through the Administrator Panel, the EXTERNAL_COURSE_KEY value is the same as the course ID.

The TEMPLATE_COURSE_KEY attribute defines the source course to copy. The COURSE_ID and COURSE_NAME attributes define the values for the new course.

Example: This example shows a batch copy file that will copy course information and user enrollments from one course into three courses that already exist.


HIST101a|HIST101 HIST102|HIST101 HIST103|HIST101

In this case, you do not use the course ID or course name attributes. The EXTERNAL_COURSE_KEY attribute defines the course ID of the destination course. The TEMPLATE_COURSE_KEY attribute defines the source course to copy.