Skip to main content
pdf?stylesheet=default
Blackboard Help

Importing Goals Using XML Files

You can use a series of XML files to import goals to Blackboard Learn. Create an XML file for each goal set, zip the XML files together, and upload the package.

Do not use the native "compress" function on a Mac to create a ZIP file to import your goals. Use the "Terminal" function instead.

On the Administrator Panel, in the Tools and Utilities section, select Goals. On the Goals page, move your mouse pointer over Add Goal Set to access the drop-down list and select Import Goal Set. Blackboard Learn will process all files at once.

An XML file must not contain more than one goal set. You can have unlimited categories and goals within that goal set.

Image illustrating associated text

  1. Goal set information.
  2. Category information. You must duplicate and edit this code for each category in the goal set. Copy this code and paste it on a line before the </standard_document> line at the end of the file.
  3. Goal information. You must duplicate and edit this code for each goal in the category. Copy this code and paste it on a line before the </standard> line near the end of the file.

XML Fragment of a Goal Set, Including Categories and Goals

<?xml version="1.0" encoding="UTF-8"?>

<standard_document year="ENTER RELEVANT YEAR HERE" revision_date="ENTER REVISION DATE & TIME HERE" uid="ENTER DOCUMENT ID HERE (do not use spaces)" uid_provider="ENTER 2 CHARACTER PROVIDER CODE HERE" status="SELECT A SINGLE STATUS VALUE - A (Active) I (Inactive) R (Reserved)" editable="true">

<organization org_code="ENTER TWO CHARACTER SOURCE CODE HERE" country_code="US">ENTER FULL TEXT OF GOAL SOURCE HERE (example "Monument University")

</organization>

<subject code="ENTER ID FOR DOCUMENT NAME HERE (do not use spaces)">ENTER FULL TEXT OF DOCUMENT NAME HERE</subject>

<document_set uid="ENTER ID FOR SET TYPE HERE (do not use spaces)">ENTER FULL TEXT OF SET TYPE HERE</document_set>

<grade_range lo="1" hi="2" code="ENTER ID FOR CATEGORY HERE (do not use spaces)">ENTER FULL TEXT OF CATEGORY NAME HERE</grade_range>

<standard uid="ENTER ID FOR CATEGORY HERE (do not use spaces)">

<title>ENTER FULL TEXT OF CATEGORY NAME HERE</title>

<grade_range_ref code="ENTER CATEGORY ID HERE"/>

<item uid="ENTER UNIQUE ID OF GOAL HERE (do not use spaces)" parent_uid="ENTER ID OF PARENT GOAL HERE OR LEAVE BLANK" label="ENTER FULL TEXT OF GOAL TYPE HERE"

linkable="Y" stem="ENTER ANY LEADING TEXT FOR THE GOAL HERE (example: The student will be able to:) OR LEAVE BLANK" doc_num="ENTER THE UI FACING ID OF THE GOAL HERE OR LEAVE BLANK">

<statement>ENTER THE FULL TEXT OF THE GOAL STATEMENT HERE</statement>

</item>

</standard>

</standard_document>

Element/Attribute Descriptions

Edit the relevant attributes and values in the preceding code with the details of each level.

Code examples
Element/Attribute Description
standard_document

This describes the Goal Set properties.

year Type the relevant year using the “YYYY” format.
revision_date Type the revision date and time using the “YYYY-MM-DD HH:MM:SS” format.
uid

Type the Document ID using no more than 37 characters. Do not use spaces.

uid_provider Type two characters for the provider code.
status

Type a single character status value of one of the following:

  • A - (Active) Users can view and select the goals.
  • I - (Inactive) Users cannot view the goals.
  • R - (Restricted) Users can view the goals.
editable

Type an editable value of "true" or "false."

organization This describes the Organization Source.
org_code Type two characters to represent the Organization Source code.
country_code

Type two characters to represent the Source country.

Replace the “ENTER FULL TEXT OF GOAL SOURCE HERE" placeholder text. For example, replace with “Monument University." Type the name of the Source.

subject This describes the Goal Set Name.
code

Type the Goal Set Name ID using no more than five characters. Do not use spaces.

Replace the “ENTER FULL TEXT OF DOCUMENT NAME HERE” placeholder text. Type the Goal Set Name.

document_set This describes the Goal Set Type.
uid Type the Goal Set Type ID. Do not use spaces. Replace the “ENTER FULL TEXT OF SET TYPE HERE” placement holder text. Type the Goal Set Type.
grade_range This describes a Category.
code Type the Category ID. Do not use spaces. Replace the “ENTER FULL TEXT OF CATEGORY NAME HERE” placement holder text. Type the Category Name using no more than 101 characters.
standard This describes a goal, including the Category information it is associated with.
uid Type the Category ID used in <grade_range code>.
title Type the Category Name used in <grade_range code>.
item This describes a goal.
uid Type the unique ID of the goal using no more than 257 characters.
parent_uid Type the ID of the parent goal. If no parent goal exists, delete the placement holder text.
label Type the Goal Name.
linkable

Type a single character status value of one of the following:

  • A - (Active) Users can view and select the goals.
  • I - (Inactive) Users cannot view the goals.
  • R - (Restricted) Users can view the goals.
stem Type leading text, for example, “The student will be able to.” If no leading text exists, delete the placement holder text.
doc_num Type the Goal ID as it will appear in the user interface using no more than 101 characters. If you do not want a Goal ID to appear, delete the placement holder text.
statement Type the goal description or statement.