If you want to enable users in your organization who do not have direct access to your file server to add course offerings to Bulk Course Create, you can set up a course offering shell to provide access to the inbox and outbox folders through Brightspace.
Enrolling users into the course shell enables them to gain access to the inbox and outbox folder.
You do this by creating a new course offering and then, in Bulk Tool Configuration, setting the Inbox Path and Outbox Path to subfolders of the course offering 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\.
Note: 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.
Create a Bulk Course Create course shell
- From the Admin Tools menu, click Course Management.
- On the Manage Courses page, click Create a New Course Offering or Template.
- If you already have a generic support or system template for course offerings that are used for purposes other than teaching, complete the following actions:
- Choose the Create a new course offering based on an existing template option.
- Select the template from the drop-down list or click Search for template to locate the template on a search page.
- Click Next.
- If you do not already have an appropriate template, complete the following actions:
- Choose the Create a new course template and a new course offering that has never been offered before option and then click Next.
- On the Enter Template Information page, enter a Course Template Name and Course Template Code. For example, enter “System” for both the name and code.
- Click the option New Department and fill in the Name and Code fields, or select a suitable department.
- Enter a Department Name and Department Code.
- Click Next.
- On the Enter Course Information page, enter the Course Offering Name and the Course Offering Code. For example, Bulk Course Create and BCC.
- Click Create.
- After the course is created, click Modify the new course offering.
- Make note of the Course Offering Path. In Bulk Tool Configuration, you configure the inbox and outbox paths as subfolders of this path.
- From the course selector, open the bulk course offering.
- In the Course Administration widget, click Manage Files.
- Create the inbox and outbox folders:
- Click New Folder, type Inbox as the folder name, and then click Save.
- Click New Folder, type Outbox as the folder name, and then click Save.
- Configure the inbox and outbox paths by completing the following actions:
- From the Admin Tools menu, click Bulk Tool Configuration > Bulk Course Create.
- 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 access to the course shell
The following permissions enable users to specify courses to create when the next scheduled task runs by uploading CSV files and zip files of exported courses to the inbox folder using the Manage Courses tool inside the course offering.
Note: Enrolling users into the course shell enables them to gain access to the inbox location.
- 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.
Create courses using the course offering
You must be enrolled in the course and have an Active status to see the BCC course offering in the course selector and Manage Files area.
- From the course selector, open the bulk course offering.
- In the Course Administration widget, click Manage Files.
- Click the Inbox folder.
- Click Upload and upload the CSV file listing the course offerings and the zip files containing the exported courses.
- After the scheduled task runs, confirm that the courses were created successfully. You will encounter an error if one or more course offerings are not created.
Sample Log File for BCC
Bulk Course Create generates logs only if an input file is processed.
Below is an example of a BBC 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 7331 was successfully created.
INFO 2023-01-18 16:00:05 - Started processing files for organization with id '6606'.
INFO 2023-01-18 16:00:05 - Started processing file '[org: 6606; location: \\fs-LVU\LVU\web\content\LVU\BulkTools\BCC\Inbox\Sample BCC.csv]'
INFO 2023-01-18 16:00:05 - Started processing line with number '1' for 'Sample BCC.csv' file.
INFO 2023-01-18 16:00:05 - Started parsing line: 'ENG101,English 101,term_a,ENG_CT,ENG_CT,ENG_DEPT,\content\BulkTools\BCC\Course Packages\English 101.zip'
INFO 2023-01-18 16:00:05 - Finished parsing line 'ENG101,English 101,term_a,ENG_CT,ENG_CT,ENG_DEPT,\content\BulkTools\BCC\Course Packages\English 101.zip'
INFO 2023-01-18 16:00:05 - Started validating Course Create settings for OrgId: 6606
WARN 2023-01-18 16:00:06 - Course Package Path should not use \, virtual paths should use / instead.
INFO 2023-01-18 16:00:06 - Finished validating Course Create settings for OrgId: 6606
INFO 2023-01-18 16:00:06 - Initiate bulk course creation operation...
INFO 2023-01-18 16:00:06 - The template code ENG_CT with template name ENG_CT exists in the database. Proceeding to link to template id 7330
INFO 2023-01-18 16:00:06 - Try to create new course with offering code: ENG101 and offering name: English 101
INFO 2023-01-18 16:00:06 - New course has been successfully created with course offering id: 7331
INFO 2023-01-18 16:00:06 - Try to create content path for course with id: 7331
INFO 2023-01-18 16:00:06 - Content path [org: 6606; location: \\fs-LVU\LVU\web\content\LVU\enforced\7331-ENG101] has been successfully created for course with id: 7331
INFO 2023-01-18 16:00:06 - Try to import package for course with id: 7331
INFO 2023-01-18 16:00:46 - Importing package for course with id: 7331 has been successfully completed
INFO 2023-01-18 16:00:46 - Finished processing line with number '1' for 'Sample BCC.csv' file.
INFO 2023-01-18 16:00:46 -
INFO 2023-01-18 16:00:46 - Finished processing file '[org: 6606; location: \\fs-LVU\LVU\web\content\LVU\BulkTools\BCC\Inbox\Sample BCC.csv]'
INFO 2023-01-18 16:00:46 - Finished processing files for organization with id '6606'