Educators

A reference guide for Educators using Connect at TAFE Queensland.

Managing unit components

About copying unit components between org units

The copy components utility lets you copy quizzes, content, grade items, discussion forums, Assignments folders, and nearly every other type of component from another unit offering or a unit offering’s parent template. Copying components saves you from having to recreate your unit's resources and can significantly reduce the amount of work required to create or re-offer a unit.

Note: This tool is currently only available in the Assembler and Admin roles.

You can use the copy components feature to:

To copy components between unit offerings, you must be enrolled in both offerings. You also need to be enrolled in and have access to the parent template to copy components from the parent into a unit offering.

The following table addresses some common concerns around copying unit components between org units:

Concern

Answer

Overwriting and duplicating content

The only components you might overwrite are unit files. Unit files are overwritten if one of the files being copied has the same name as an existing file. No other components are overwritten.

For example, if you have three checklists in your current unit offering, and copy two checklists from another offering, you will now have a total of five checklists in the current offering. This is true even if the components are identical. If you are copying components from the same source multiple times, be careful not to copy the same items more than once or you will create duplicates.

User privacy might be compromised when copying unit components

User data is not copied. For example, if you copy the discussions component, only the forums and topics are copied, not the posts inside the topics. Similarly, if you copy Assignments folders or quizzes, user submissions and quiz attempts are not copied.

Links and associations between components

eLearinng recommends that you copy all components between units to ensure you maintain all desired associations, and then delete any undesired material in the new unit.

If you are copying linked or associated components, you must copy all of the related components at the same time. For example, if a discussion topic has release conditions based on the results of a quiz, you must copy all three components—discussions, quizzes, and release conditions—at the same time. Similarly, if you have a quiz that is associated with a grade item, be sure to copy both the quiz and the grade item at the same time. As long as the associated components are copied together, links between them are retained.

To copy release conditions, you must select the Release Conditions component.

Special considerations when copying unit components

When you are copying unit components, ensure that you have considered the following implications or associated tasks.

Component

Notes

Content

Does not include files or content display settings; you must select these as separate components. Be sure to copy all unit files used in the unit as well as the content topics or only the content topic structure is copied.

Checklist

Due dates for checklist items are not changed when you copy them.

Groups

The new unit does not automatically enroll groups. You must enroll users yourself.

Navbars

If you have modified the names of any tools, you must also copy the tool names.

Release Conditions

Only release conditions that reference or are attached to other components are copied at the same time as the component. For example, if a quiz has a release condition that refers to a content topic, the release note is only copied if both the quiz and the content topic are copied at the same time. If you copy release conditions without selecting any other component, there is no action.

Copy unit components

In order to mitigate the risk that large units may result in timeout failures for users, the Copy Unit components job functions as an asynchronous job. You can view the progress of the copying job by clicking View History link.

  1. In the unit offering that you want to copy components into, on the navbar, click Unit Admin > The import export copy icon Import/Export/Copy Components.
  2. Do one of the following:
    • Select Copy Components from another Org Unit. Click Search for offering and locate the unit offering containing the components you want to copy. Click Add Selected.
    • Select Copy Components from Parent Template to copy components from the unit template the current unit offering belongs to.
  1. Do one of the following:
    • To copy all unit components, click Copy All Components. eLearning Services recommends that you copy all components between units to ensure you maintain all desired associations, and then delete any undesired material in the new unit.
  1. To specify the components you want to copy, click Select Components. Select your components. To see details for unit components, click the Show the current unit components link, then click the The preview icon View Detail icon beside a component to see existing items. For those unit components that provide the option to Include associated files, D2L recommends leaving the option turned on. Click Continue > Finish.
    Do one of the following:
    • To copy another package, click Copy Another Package.
    • To see the results of your copy, click View Content.

Notes: 

About importing unit components from a file

You can import components created in other learning management systems, provided by content vendors, or created in a content creation program (like Respondus). To import components, you must have a file containing the components in a format supported by the Import tool.

Import unit components

  1. In the unit offering containing the components you want to copy, on the navbar, click Unit Admin > The import export copy icon Import/Export/Copy Components.
  2. On the Import/Export/Copy Components page, select Import Components.
  3. Click Start.
  4. Select the file you want to import.
  5. Choose whether to Import All Components or Select Components and then follow the prompts.

If you import unit components with names that already exist in the unit, or you import multiple components with the same name, duplicate names appear; they are not overwritten. For example, if your unit contains a discussion topic called Exam Review and you import a unit package that contains a discussion topic called Exam Review, your unit will contain two topics called Exam Review.

Unit Import Compatibility

The following table provides a list of learning management systems (LMS) and content providers that you can import unit content from. It is recommended that you work with your administrator when importing content from another LMS.

Component

IMS CP

QTI

Blackboard 6.0

1.1.2

1.2.1

Blackboard 6.1.5/6.2/6.3

1.1.3

1.2.1

Blackboard 7

1.1.3

1.2.1

Blackboard 8

1.1.2

1.2.1

Blackboard 9

1.1.2

1.2.1

Common Cartridge® 1.0

1.1.3

1.2.1

Common Cartridge 1.1

1.2

1.2.1

Common Cartridge 1.2

1.2

1.2.1

Common Cartridge 1.3 (and ThinCC1.3)

1.2

1.2.1

Desire2Learn 8.x

1.1.3

1.2.1

Respondus 2.0

N/A

1.2.1

Respondus 3.x

N/A

1.2.1

SCORM® 1.2

1.1.2

N/A

SCORM 1.3 (2004)

1.1.3

N/A

WebCT® CMU 1.x

1.1.2

1.2.1

WebCT CMU 2.0

1.1.3

1.2.1


You can convert packages into importable D2L-formatted packages using separate conversion tools. Work with your administrator to discuss converting and importing from the following systems:

Troubleshooting: Course Conversion

The following errors might be encountered during course conversion into D2L format. Try these troubleshooting steps first, and if they don't work, contact support for a more in-depth investigation of the issue.

Error: Package was not recognized

A package may be not recognized if:

Package Failed to Unzip

Symptoms

When importing a course package, you encounter the message: "The package was not recognized". The processing logs indicate "Unpackaging uploaded file" followed by "Unsupported file format". If the package was successfully unzipped, the processing logs would indicate "Successfully unpackaged file" instead.

The processing logs also indicate that the final status of the issue was "NoConversion". You can access the processing logs directly on the error page in Unit Import by clicking on "View Processing Logs".

Cause

The following are common causes of this error: 

Resolution

If you are using an archive file, to verify your course package can be extracted, try to unzip the package locally first. Try the following steps to resolve the problem:

  1. Use the built-in operating system extraction program and try to unzip the file on your computer.

    If you successfully unzipped the package on your local computer, re-zip the file using your local operating system zip program or the program you were using. Retry the course import with the newly zipped package.
  2. Unzip the package and examine the folders structure to ensure that the imsmanifest.xml file is at the root level. If the imsmanifest.xml file is not at the root level move the file to this location and re-zip the package and retry the course import.
     
  3. Use WinRAR (http://www.rarlab.com/) to unzip the file on your computer.

    Your package may contain file paths longer than 128 characters. In this case, most extraction programs on Windows will fail. WinRAR will still extract the files, but will warn that files exceeding the maximum path length were truncated. Once the extraction is complete, it is recommended that these paths are truncated manually or removed. Then re-zip the files and retry the course import.
     
  4. Re-export your course package from the original source.

    If neither of the previous troubleshooting steps worked and the extraction still fails, your course package is likely damaged. Re-export the course package from the original LMS and retry the course import with a newly exported package.
Error: Package was not converted

This error commonly arises due to issues within the course package itself:

Typically in these cases, it is recommended to review the processing logs and inspect the specific complaint. Then explore the contents of your package to verify that the information is corrected. You can also try to re-export the package from the original source.

Invalid HTML

Symptoms

When importing a course package, you encounter the message "The package was not converted". The processing logs may indicate that an invalid or unexpected character has been encountered.

The processing logs also indicate that the final status of the issue was "ProcessingFailed". To access the processing logs directly on the error page in Unit Import, click View Processing Logs.

Cause

Invalid XML can often cause conversions to fail. Sometimes the error directly names the exact file that is causing the problem. If it is not explicitly stated, try the main imsmanifest.xml file. If the manifest is improperly formed, serious issues may occur.

Resolution

To verify that an XML file is valid:

  1. Open the file in Internet Explorer. If the XML is valid, it should render correctly; if not, the page will remain blank or report an error.
  2. Use an online XML validator like: http://www.xmlvalidation.com/
  3. If the XML is invalid, correct the XML, re-zip the package and retry importing your course package.
  4. the XML is valid, the issue with your package is likely in the structure of the package (for example, missing key files). In this case, re-export the package from the original source and retry importing your course package.
Error: Conversion Service is Temporarily Unavailable

If the Conversion Service is not available, it may relate to temporary issues that are being monitored by D2L support and will be resolved shortly. However, if you repeatedly see this error message, it may be worth verifying that the Conversion Service URL is properly configured. This can only be done via eLearning Services contacting our D2L support representative.

About exporting unit components

You can export components from your unit offering to a file. This allows you to reuse these components in another learning management system, including another Brightspace Learning Environment, or to store the components and then re-import them into another unit offering or template at a later date.

Components are exported to an IMSCP-compliant zip file, a standard file format based on the IMS Content Packaging specification. This means you should be able to reuse these components in any learning management system that supports this format.

You can export unit components from the organisation level, except for files in the organisation or shared files areas.

The following table addresses some common concerns around exporting unit components:

Concern

Answer

User privacy might be compromised when exporting unit components

User data is not copied. For example, if you copy the discussions component, only the forums and topics are copied, not the posts inside the topics. Similarly, if you copy assignment submissions folders or quizzes, user submissions and quiz attempts are not copied.

Links and associations between components

Associations between components will not be exported (for example, release conditions). The IMS Content Packaging specification, which the format for export files is based on, does not support these associations.

Export unit components

  1. In the unit offering containing the components you want to copy, on the navbar, click Unit Admin > The import export copy icon Import/Export/Copy Components.
  2. Select Export Components > Start.
  3. In the Select Components to Export section, select the check box for any components you want to export. To export only certain items from a component, choose Select individual items to import.
  4. Click Continue.
  5. If you chose Select individual items to export for any component in the previous step, the Select Items page appears. This page lists all of the items and any sub-items contained in the current component. Otherwise, the Confirm Components to Export page appears. To view sub-items, click the + Expand icon next to an item. Select the individual items and sub-items you want to export and click Next. When you have finished selecting individual items from components, the Confirm Components to Export page appears.
  6. Click Continue.
  7. When the export process ends, click Finish.
  8. Click the Click here to download the export Zip package link. If you do not download the file from this screen, it is lost. You cannot download it later.

What unit components can be exported?