Skip to main content
pdf?stylesheet=default
Blackboard Help

LMSImport Switches for CE 4

The following table describes the available switches for the LMSImport command.

Switches
Switch Description
--file full path and name of the data file Required in all LMSImport commands.

The full path to and the name of the file (snapshot.xml) that contains the data exported from CE 4 in Step 2: Export All Data From CE 4.

--pkg_dir dir full path to packages Required in Step 5: Import CE 4 Courses Into Blackboard Learn.

The full path to the directory where the course content packages (*.zip and *.epk) were saved in Step 4: Export Course Content Packages From CE 4.

--ds DataSourceKey Available only for Enterprise License clients.

Optional in Step 3: Import CE 4 User Data Into Blackboard Learn, Step 5: Import CE 4 Courses Into Blackboard Learn, and Step 6: Import CE 4 Enrollments Into Blackboard Learn.

The data source key to be applied to the imported data. The data source key must already exist on the system to be used in the command. To learn more, see Data Source Keys.

--no_courses Required in Step 3: Import CE 4 User Data Into Blackboard Learn and Step 6: Import CE 4 Enrollments Into Blackboard Learn.

Do not import the available course shells.

--no_enrollments Required in Step 3: Import CE 4 User Data Into Blackboard Learn and Step 5: Import CE 4 Courses Into Blackboard Learn.

Do not import the available user enrollment data. This switch is superseded by the --no_users and --no_courses switches.

--no_users Required in Step 5: Import CE 4 Courses Into Blackboard Learn and Step 6: Import CE 4 Enrollments Into Blackboard Learn.

Do not import the available user records.

--no_content Optional. Import the course shells, but do not import the available content. This switch is superseded by the --no_courses switch. The --pkg_dir switch is not effective when used with this switch.
--no_xlist Optional in Step 5: Import CE 4 Courses Into Blackboard Learn.

Do not import the available cross-listed data. This switch is superseded by the --no_courses switch.

The import automatically copies parent content into the child courses. Both parent and child courses will contain only their direct enrollments.

--instr_only Optional in Step 6: Import CE 4 Enrollments Into Blackboard Learn.

Import only instructor enrollment data. This switch is superseded by the --no_enrollments switch.

--conflict_prefix prefix Optional in all LMSImport commands.

Resolve conflicting data names by attaching the included text string to the beginning of the imported data.

The prefix can contain only letters, numbers, and underscores. The prefix cannot contain spaces.

You can use only one conflict resolution switch in the command. If you use the --conflict_prefix switch, do not use the --conflict_suffix switch.

--conflict_suffix suffix Optional in all LMSImport commands.

Resolve conflicting data names by attaching the included text string to the end of the imported data.

The suffix can contain only letters, numbers, and underscores. The suffix cannot contain spaces.

You can use only one conflict resolution switch in the command. If you use the --conflict_suffix switch, do not use the --conflict_prefix switch.

--always Optional in all LMSImport commands when using either conflict resolution switch.

Always attach the conflict prefix or suffix to the imported data. 

This switch requires either the --conflict_prefix or --conflict_suffix switch.

--i course material type Optional in all LMSImport commands.

Available course material types: Alignments, Announcement, Assessment, Calendar, Collaboration, Content, Coursesetting, Coursetoc, Discussion, Glossary, Gradebook, Group, Notification_rule, Pool, Staffinformation, Survey, Task, Blog, Journal, Availability_rule. 

The course material types are not case sensitive and must be comma-delimited if more than one type is selected.