If you want to enable users in your organization who do not have direct access to your file server to add course offerings to Copy Course Bulk, you can set up a course offering shell to provide access to the inbox and outbox folders through Brightspace. The course shell is an empty course that does not contain any content or materials. Enrolling users into the course shell enables them to gain access to the inbox and outbox folder.
|
Important: If you have set the d2l.Tools.CMS.CoursePathEnforced configuration variable to OFF, you can customize the course offering path. If you customize the course offering path, the bulk export folders must still be located under the organization’s \content\ directory. Refer to CMS configuration variables for more information.
|
Create a course shell
You can create a new and empty course shell using the courses tool. Refer to the Create a new course with the Courses tool section of the Manage courses and course templates with the Courses tool page for more information.
|
Important: When you create your new course offering shell, you must make note of the Course Offering Path. To make note of your course path, navigate to your newly created course shell, then click Course Admin > Course Offering Information. Locate the Course Offering Path and copy that file path. In Bulk Tool Configuration, you must configure the inbox and outbox paths as subfolders of this path. In Bulk Tool Configuration, you must configure the inbox and outbox paths as subfolders of this path. For example, if your course offering path is \content\enforced\138731-BCC then your inbox folder is \content\enforced\138731-BCC\Inbox and your outbox folder is \content\enforced\138731-BCC\Outbox\.
|
Create a course shell using a course template
You can also a course template as a course shell. You can use the Courses tool to create a new template. Refer to the Create a new course template with the Courses tool section of the Manage courses and course templates with the Courses tool page for more information.
|
Important: When you create your new course offering template shell, you must make note of the Course Offering Path. To make note of your course path, navigate to your newly created course shell, then click Course Admin > Course Offering Information. Locate the Course Offering Path and copy that file path. In Bulk Tool Configuration, you must configure the inbox and outbox paths as subfolders of this path. In Bulk Tool Configuration, you must configure the inbox and outbox paths as subfolders of this path. For example, if your course offering path is \content\enforced\138731-BCC then your inbox folder is \content\enforced\138731-BCC\Inbox and your outbox folder is \content\enforced\138731-BCC\Outbox\.
|
Create a new inbox and outbox folder using Manage Files
Once you have created either a new course shell, or course template shell, you can create new Inbox and Outbox folders based on the course shell file path.
To create a new inbox and outbox folder
- From your organization homepage, click Select a course... and choose the course shell you created.
- From your course navbar, click Course Admin.
- From the Course Administration page, click Manage Files.
- Click New Folder, and name the folder Inbox. Click Save.
- Click New Folder, and name the folder Outbox. Click Save.
Configure the inbox and outbox paths for Copy Course Bulk
Once you have created the required Inbox and Outbox folders in your course shell, you must set the paths to these folders in Copy Course Bulk.
To configure inbox and outbox paths
- From the Admin Tools menu, click Bulk Tool Configuration > Copy Course Bulk.
- In the Inbox Path section, click Change Path and then browse to the inbox path under the course offering path. For example,
/content/enforced/138731-BCC/Inbox.
- In the Outbox Path section, click Change Path and then browse to the outbox path under the course offering path. For example,
/content/enforced/138731-BCC/Outbox.
- Click Save.
Grant users Manage Files role permissions for your course shell
You can grant users Manage Files role permissions to access the course shell inbox location. Users can then upload a CSV file and zip file of exported courses to that inbox folder using Manage Courses.
To enroll users access in your course shell
- From the Admin Tools menu, click Roles and Permissions.
- Click the role that you want to grant permissions.
- In the Filter by Tool list, select Manage Files and then click Apply Filter.
- In the Course Offering section, select the See the File Listing, Upload Files, and Edit Files permissions, and then click Save and Close.
Access the View Copy Course History page
The View Copy Course History page displays the history of course copying events in Brightspace. You can filter the events by Source course, Destination course and by Date Range. The page displays all successful and unsuccessful course copy events according to the criteria selected. Users may also download the results of the query as a .txt file.
To access the View Corse Copy History page
- From the Admin Tools menu, click View Copy Course History.
Copy Course Bulk Workflow
The Copy Course Bulk workflow starts by processing each line in the CSV file and creating the corresponding course offering. The log file contains a block for each line in the CSV and indicates if the course was successfully created or if an error occurred when attempting to read the line.
Sample Log File for CCB
Copy Course Bulk generates logs only if an input file is processed.
Below is an example of a CCB log file showing the successful creation of a course offering. In this block, you can see that a new course offering with the Org Unit ID 54321 was successfully created.
INFO 2023-05-17 18:05:37 - Started processing files for organization with id '6606'.
INFO 2023-05-17 18:05:37 - Started processing file '[org: 6606; location: \\fs-LVU\LVU\web\content\LVU\BulkTools\CCB\Inbox\Sample CCB.csv]'
INFO 2023-05-17 18:05:37 - Started processing line with number '1' for ‘Sample CCB.csv' file.
INFO 2023-05-17 18:05:37 - Started parsing line: '12345,Grammar 1001,Grammar_1001, ENG_CT,Term_A'
INFO 2023-05-17 18:05:37 - Finished parsing line: '12345,Grammar 1001,Grammar_1001, ENG_CT,Term_A'
INFO 2023-05-17 18:05:37 - Try to create new course with offering code: Grammar_1001 and offering name: Grammar 1001
INFO 2023-05-17 18:05:38 - New course has been successfully created with course offering id: 54321
INFO 2023-05-17 18:05:38 - Try to create content path for course with id: 54321
INFO 2023-05-17 18:05:38 - Content path [org: 6606; location: \\fs-LVU\LVU\web\content\LVU\enforced\54321-Grammar_1001] has been successfully created for course with id: 54321
INFO 2023-05-17 18:05:38 - Finished processing line with number '1' for 'Sample CCB.csv' file.
INFO 2023-05-17 18:05:38 -
INFO 2023-05-17 18:05:38 - Finished processing file '[org: 6606; location: \\fs-LVU\LVU\web\content\LVU\BulkTools\CCB\Inbox\Sample CCB.csv]'
INFO 2023-05-17 18:05:38 - Finished processing files for organization with id '6606'.
Post-Processing Action
Once each line has been processed and the course offerings created, the next step is the creation of Copy Jobs to copy the content from the source course to the destination. The creation of the job does not indicate that the copy is complete but rather that the copy action has been placed in a queue for processing.
This example CCB log shows the post-processing portion of the bulk copy. This block of the log indicates that a copy job has been created and identifies the source and destination course.
INFO 2023-01-13 20:19:52 - Started post-processing files for organization with id '6606'.
INFO 2023-01-13 20:19:52 - Creating job to copy from 7009 to 7011
INFO 2023-01-13 20:19:52 - Job was successfully created, to see the results go to the Copy History for OrgUnitId 7011
Once all copy jobs have been created the CCB scheduled task will be complete but the action of copying the content to the new courses will continue to run in the background. You can view the status of the copy job in the Copy Course History page of the Admin Tools Menu or in the Copy Course Components History page of the specific course offering.