Sysadmin - Course export setup - MBZ/IMCC

TABLE OF CONTENTS

• 1. Introduction
• 2. How to Export Courses
• 3. Export Formats
• 4. Resource Types for Export
• 5. App - setup
  • 5.1 Access Manage Apps
  • 5.2 Add Course Exporter Module
  • 5.3 Configure Deployment Scope (Hiearchy)
  • 5.4 Find app in library
  • 5.5 Select roles
  • 5.6 Optional : Change name of app on site
• 6. API - setup
• 7. Technical Details
• 8. Troubleshooting

NOTE: This feature will launch first in Germany and is scheduled to roll out globally at the start of August.

1. Introduction

This is a guide for sysadmin on how to setup the course export functionality.

The Course Export functionality allows you to export the structure and content of a course from itslearning. This feature is especially useful if you're working with multiple LMS platforms or need to transfer course content. The export tool is found on the course Settings page if it has been enabled by an administrator. 

2. How to Export Courses

The export includes all content found under Resources, but not the structure under Plans. Depending on the chosen export format, different resource types can be included, such as files, assignments, discussions, and tests.

3. Export Formats

There are two supported formats:

• Common Cartridge (IMSCC): A standard by 1EdTech, compatible with various LMS platforms. Only version 1.1 is supported.
• Moodle Backup (MBZ): Specific to Moodle. Optimized for Moodle 4.1, but should works with newer versions as well as these are typically backwards compatible.

Consult article on cartridge formats for more detailed information

4. Resource Types for Export

Compatibility depends on format capabilities; unsupported items will be omitted.

Common cartridge (IMSCC):

• This is a standard format developed by 1EdTech, version 1.1.
• It is supported by several Learning Management Systems (LMS).
• It includes the following resource types:
  • Folders
  • Files
  • Links
  • Notes
  • Pages
  • Discussions

Moodle Backup (MBZ)

• This is a format developed specifically for Moodle, optimized for version 4.1 or newer.
• It can only be used in Moodle.
• NB! Includes all the resource types supported by the Common Cartridge(IMSCC) format, and also:
  • Assignments
  • Surveys
  • Tasks
  • Tests

5. App - setup

5.1 Access Manage Apps

1. Navigate to Administration → Manage apps
2. This page allows centralized control of apps and role-based access

5.2 Add Course Exporter Module

To begin the configuration process:

1. Click Add module on the Manage Apps page

2. This initiates the setup workflow for deploying the Course Exporter

5.3 Configure Deployment Scope (Hiearchy)

Select where the Course Exporter should be available:

• Entire site: Deploys to all users
• Specific organizations: Restricts to selected schools/departments
• Individual organizational units: Limits access to specific units

Note: Deployment is hierarchical. Choosing a higher-level unit automatically includes all sub-units.

5.4 Find app in library

  Next, click "Browse app library" to select the module "Course export".

• In the app library, you can search or browse through available apps.
• Once you find the "Course export" app, click "Include this app" to select it.

5.5 Select roles

 As the final step, select the roles for which the course export needs to be available.

• Commonly this is Administrators and Teachers.
• You can check the boxes next to the appropriate roles.

5.6 Optional : Change name of app on site

You can change the display and set-up name of the tool:

The display name will be shown to teachers in a course

The set-up name will be visible on the "Manage apps" page

6. API - setup

The exporter requires Organization API access. 

Note that this is the same API as for import.

Steps:

1. Navigate to the Vendor access tab

2. Find the vendor Course import and export 

3. Click Permit and confirm

API access only needs to be set once per site.

The course export is now ready to be used by teachers and administrators

7. Technical Details

Security

• Access is restricted by role and organizational unit

• Student data is never exported

File types

• Supported formats: .mbz (Moodle backup) and .imscc (Common Cartridge)

8. Troubleshooting

Issue: API access configuration errors

Symptom:

• Error message when trying to export: "API connection failed"

Solution:

• Verify API permissions are enabled in Vendor Access.
• Ensure the service isn't experiencing downtime.

Issue: Role permission misalignments

Symptom:

• Users with correct roles cannot see the Course exporter

Solution:

• Check role configurations and ensure the tool is assigned to the appropriate roles.
• Users may need to refresh their session.

Issue: Organizational hierarchy changes

Symptom:

• Tool disappears for some users after organization changes

Solution:

• Re-deploy the tool to the updated organizational structure.
• Users in moved units may need reassignment.

For support, contact your itslearning administrator or support team. Be ready to provide:

• Course name and ID
• Export format used
• Any error messages or missing content notes