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. 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. 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. 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 Bulk Course Create
Once you have created the required Inbox and Outbox folders in your course shell, you must set the paths to these folders in Bulk Course Create.
To configure inbox and outbox paths
- 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 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.
Use Bulk Course Create to upload and create courses from your course shell
Once you have the appropriate role permissions to Manage Files for your course shell, you can upload a CSV file and zip file with the course offerings and exported courses which is then used to create new courses in bulk.
|
Important: You must be enrolled in your course offering shell and have an Active status to see the Bulk Course Crete course offering shell in the course selector and Manage Files area.
|
To upload a CSV and zip file to bulk create courses
- 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 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'