Skip to main content

Importing a QTI package

Bring content made in another system into the bank, and fix what does not validate.

For authors

AIB imports IMS content packages: zip files holding an imsmanifest.xml and the QTI documents and media it lists. QTI 3.0 is the main format; QTI 2.1 and 2.2 content can also be imported and is shown and scored, but cannot be edited.

Invalid content is never imported. AIB checks every file first, then lets you choose what to bring in.

Before you start

Try your package on the Package Validator first if you are not sure it is valid. It shows the same findings the import does, without storing anything.

1. Upload

  1. Open Import (on the home page, or the button on Resources).
  2. Choose the Tenant to import into.
  3. Choose one or more .zip files and press Import.

Each package gets a card that follows it through Validating, Importing and Complete. You can leave the page: Import History shows the same cards later.

2. Decide

A package with no problems imports straight away. Otherwise the card stops at Needs decision and shows its Findings: each file, and what is wrong with it. Then, under What should be imported?:

  • Repair imsmanifest.xml before importing: AIB offers fixes for a manifest that misses files or lists files that are not there. Tick the repairs you accept.
  • Hold the items that need correction: items whose only problem is that they do not match the QTI schema can be held, so you can fix them in the editor afterwards.

Press Import valid content to go ahead, or Abort import to import nothing.

A test or section that uses an item which is held or refused is refused too, because it would otherwise refer to something the bank does not have.

3. After the import

The card lists every resource imported, with its new place in the bank. Imported content appears on the Resources page at once.

Correcting held items

Held items are listed under Held for correction. Press Correct to open one in the editor, fix the problems that Check lists, and Save. Once it validates, it is imported into the bank.

Warning: A test refused because of a held item is not imported when you correct the item. Import the package again once its items are in the bank.

Importing the same thing again

Importing an item whose identifier is already in the bank adds a new version of it; the Resources page shows the newest. Earlier versions are kept.