Para importar metas a Blackboard Learn, se pueden utilizar una serie de archivos XML. Cree un archivo XML para cada conjunto de metas, comprima juntos los archivos XML en un archivo zip y cargue el paquete.

Don't use the native "compress" function on a Mac to create a ZIP file to import your goals. En su lugar, utilice el comando compress del terminal.

Un archivo XML no debe contener más de un conjunto de metas. Dentro de ese conjunto de metas se puede tener un número ilimitado de categorías y metas.

Each file contains this information:

  1. Información sobre el conjunto de metas.
  2. Información sobre la categoría. Deberá duplicar y editar este código por cada categoría del conjunto de metas. Copie este código y péguelo en una línea anterior a la línea </standard_document> situada al final del archivo.
  3. Información sobre la meta. Deberá duplicar y editar este código por cada meta de la categoría. Copie este código y péguelo en una línea anterior a la línea </standard> situada cerca del final del archivo.

Cargar archivos

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 menu and select Import Goal Set. Blackboard Learn procesará todos los archivos a la vez.


Plantilla XML de un conjunto de metas, incluidas categorías y metas

<?xml version="1.0" encoding="UTF-8"?>
<!-- Define a goal set -->
<!-- Create a separate XML file for each goal set -->
<standard_document year="ENTER RELEVANT YEAR HERE" revision_date="ENTER REVISION DATE AND TIME HERE" uid="ENTER DOCUMENT ID HERE. Do not uses spaces."
   uid_provider="ENTER 2 CHARACTER PROVIDER CODE HERE" status="ENTER A, I, or R" editable="ENTER TRUE OR FALSE">
   
   <!-- Define the organization that is the source for this goal set -->
   <organization org_code="ENTER A SOURCE CODE HERE (UP TO 256 CHARACTERS)" country_code="US">
      ENTER FULL TEXT OF GOAL SOURCE HERE.
   </organization>
   
   <!-- Define the name of the goal set -->
   <subject code="ENTER ID FOR GOAL SET HERE. Do not use spaces.">
      ENTER GOAL SET NAME HERE</subject>
   
   <!-- Define the goal set type -->
   <document_set uid="ENTER ID FOR GOAL SET TYPE HERE. Do not use spaces.">
      ENTER FULL TEXT OF GOAL SET TYPE HERE</document_set>
   
   <!-- Define the categories -->
   <!-- Create one <grade_range&gt; element and one <standard&gt; element for each category -->
   <grade_range lo="ENTER LOWEST POSITION IN CATEGORY LIST" hi="ENTER HIGHEST POSITION IN CATEGORY LIST"
      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"/>
      
      <!-- Define the Goals -->
      <!-- Create one <item&gt; element for each goal in the category -->
      <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="ENTER Y OR N"
         stem="ENTER ANY LEADING TEXT FOR THE GOAL HERE OR LEAVE BLANK" doc_num="ENTER THE ID OF THE GOAL HERE OR LEAVE BLANK">
         <statement>ENTER THE FULL TEXT OF THE GOAL STATEMENT HERE</statement>
      </item>
   </standard>
   
</standard_document>

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="PHYS101" uid_provider="PS" status="A" editable="true">
   <organization org_code="BB" country_code="US">Blackboard College</organization>
   <subject code="PHYSLAB01">Physics Lab Goals</subject>
   <document_set uid="INTRO">Introductory Goals</document_set>
   
   <grade_range lo="1" hi="1" code="MEASURE">The Measurement Category</grade_range>
   <standard uid="1">
      <title>Measurement</title>
      <grade_range_ref code="MEASURE"/>
      <item uid="001" parent_uid="" label="Instrumentation Type" linkable="Y" stem="The student will:" doc_num="MEASURE_001">
         <statement>learn how to use a micrometer</statement>
      </item>
      <item uid="002" parent_uid="001" label="Instrumentation Type" linkable="N" stem="The student will:" doc_num="MEASURE_002">
         <statement>understand the uncertainty in measurements</statement>
      </item>
   </standard>
   
   <grade_range lo="2" hi="2" code="NOTEBOOK">The Lab Notebook Category</grade_range>
   <standard uid="2">
      <title>Lab Notebooks</title>
      <grade_range_ref code="NOTEBOOK"/>
      <item uid="003" parent_uid="" label="Documentation Type" linkable="Y" stem="The student will:" doc_num="NOTE_001">
         <statement>record lab results in detail</statement>
      </item>
   </standard>
</standard_document>

Otros ejemplos

You can find other examples of XML files by logging in to Behind the Blackboard and going to Article Number 13668, "Blackboard Learn and CE/Vista Standards Documents."


Descripciones de elementos/atributos

Edite los atributos y los valores relevantes en la plantilla.

Elemento/AtributoDescripción
standard_documentEl elemento <standard_document> describe las propiedades del conjunto de metas. Debe haber un solo elemento <standard_document> en el archivo.
yearEl año con el formato AAAA. Por jemplo, "2013".
revision_dateLa fecha y la hora de revisión con el formato AAAA-MM-DD HH:MM:SS. Por ejemplo, "2013-12-20 13:40:00".
uidEl ID de documento. No debe usar más de 37 caracteres. Don't use spaces.
uid_providerUn identificador de dos caracteres para el proveedor del conjunto de metas. Por ejemplo, "PS".
statusEl valor del estado de un único carácter. Este elemento es opcional. If it is present, it must be one of these:
  • A (Activo): La meta definida está disponible para todos los cursos.
  • I - (Inactive) The goal set isn't available for any courses.
  • R (Restringido): La meta definida solo está visible para los cursos asociados explícitamente con la categoría. (To associate a course with a category, use the menu next to the category and choose Associate to Courses.)

El valor se sobrescribe con la elección del botón Estado de la interfaz de usuario al importar el archivo XML.

editable"Verdadero" o "falso". Este elemento es opcional. Si es verdadero (true), la meta definida se puede editar en la interfaz de usuario. Si es falso, no se puede editar (excepto para definir que los elementos sean activos, inactivos o restringidos).
organizationEl elemento <organization> describe la organización que es el origen de la meta. Debe haber un solo elemento <organization> en el archivo.

Sustituya el texto del marcador de posición "INTRODUZCA EL TEXTO COMPLETO DEL ORIGEN DE LAS METAS AQUÍ". Por ejemplo, sustitúyalo por "Blackboard College".

org_codeUn identificador del origen. Puede tener un máximo de 256 caracteres. Por ejemplo, "BB".
country_codeEl identificador de dos caracteres del país del origen. Por ejemplo, "US".
subjectEl elemento <subject> especifica el nombre del conjunto de metas. Debe haber un solo elemento <subject> en el archivo.

Sustituya el texto del marcador de posición "INTRODUZCA EL NOMBRE DEL CONJUNTO DE METAS AQUÍ". Por ejemplo, sustitúyalo por "Metas del laboratorio de física".

This name is shown in the UI in these places:

  1. In the Goal Set column on the Goals screen.
  2. En el campo Nombre del conjunto de la pantalla Editar conjunto de metas.
  3. In the Goal Set Name column on the Content screen.
  4. En la columna Conjunto de metas y la lista desplegable Conjunto de metas de la pantalla Descubrir metas.
codeUn identificador para el conjunto de metas. No debe usar más de cinco caracteres. Don't use spaces.
document_setEl elemento <document_set> describe el tipo del conjunto de metas. Debe haber un solo elemento <document_set> en el archivo.

Sustituya el texto del marcador de posición "INTRODUZCA EL TEXTO COMPLETO DEL TIPO DE CONJUNTO DE METAS AQUÍ". No debe usar más de 101 caracteres. Por ejemplo, sustitúyalo por "Metas introductorias".

This text is shown in the UI in these places:

  1. En el campo Tipo de conjunto de la pantalla Editar conjunto de metas.
  2. En la lista desplegable Tipo de conjunto de metas de la pantalla Descubrir metas.
uidUn identificador para el tipo de conjunto de metas. Don't use spaces.
grade_rangeEl elemento <grade_range> describe una categoría. Debe haber uno o más elementos <grade_range> en el archivo. La cantidad de elementos <grade_range> debe coincidir con la cantidad de elementos <standard>.

Sustituya el texto del marcador de posición "INTRODUZCA EL TEXTO COMPLETO DEL NOMBRE DE LA CATEGORÍA AQUÍ". No debe usar más de 101 caracteres.

This text isn't shown in the UI.

lo, hiLos especificadores para la posición más baja y la más alta de esta categoría deben aparecer en la lista.

En general, se utilizan para sobrescribir la alfabetización predeterminada de categorías. Por ejemplo, estas líneas colocan la categoría "Guardería" en la primera posición de la lista:

<grade_range lo="1" hi="1" code="K">Kindergarten</grade_range>
<grade_range lo="2" hi="2" code="1">Grade 1</grade_range>
<grade_range lo="3" hi="3" code="2">Grade 2</grade_range>
<grade_range lo="4" hi="4" code="3">Grade 3</grade_range>
<grade_range lo="5" hi="5" code="4">Grade 4</grade_range>

codeUn identificador de la categoría. Don't use spaces.

Debe coincidir con un atributo code en uno de los elementos <grade_range_ref>. Se utiliza para vincular el elemento <grade_range> con el elemento <grade_range_ref>.

standardEl elemento <standard> describe el conjunto de metas de una categoría.

Debe haber uno o más elementos <standard> en el archivo. La cantidad de elementos <standard> debe coincidir con la cantidad de elementos <grade_range>.

uidUn identificador para las metas. Por ejemplo, "001". Cada <standard> debe tener una ID única.

This identifier is shown in the UI in the Unique ID field on the Edit Goal screen.

titleEl título de la categoría. Por ejemplo, "Medición". En el archivo, debe haber un solo elemento <title> en cada elemento <standard>.

This title is shown in the UI in these places:

  1. In the Category column on the Goals screen.
  2. In the Category column on the Content screen.
  3. In the Category expandable list on the Discover Goals screen.
grade_range_refEl elemento <grade_range_ref> vincula el conjunto de metas con la categoría. En el archivo, debe haber un solo elemento <grade_range_ref> dentro de cada elemento <standard>.
codeIntroduzca el atributo code del elemento <grade_range> para la categoría correspondiente.
itemEl elemento <item> describe una meta. En el archivo, debe haber uno o más elementos <item> dentro de cada elemento <standard>.
uidUn identificador único para la meta. No debe usar más de 257 caracteres.
parent_uidEl ID de la meta principal. Si no existe ninguna meta principal, elimine el texto del marcador de posición y deje el atributo en blanco.
labelEl tipo de meta. Por ejemplo, "Tipo de instrumentación". Este texto se muestra en la interfaz de usuario, en la lista desplegable Tipo de meta de la pantalla Descubrir metas.
linkableOne of these:
  • Y: No se restringirá la meta.
  • N: Se restringirá la meta.

Las metas restringidas solo son visibles para los cursos explícitamente asociados con la categoría. En la pantalla Metas, estas metas tienen un icono de flecha junto a ellas para mostrar que se pueden abrir en una nueva ventana. Para asociar un curso con una categoría, abra el menú de una categoría y elija Asociar con cursos.

stemEl texto de inicio para la meta. Por ejemplo, "El estudiante": Si no existe ningún texto de inicio, elimine el texto del marcador de posición y deje el atributo en blanco.

This text is shown in the UI in these places:

  1. In the Goals column on the Goals screen.
  2. In the Goal column on the Discover Goals screen.
doc_numEl identificador de la meta. Por ejemplo, "MEASURE_001". No debe usar más de 101 caracteres. Si no desea que aparezca el ID de la meta, elimine el texto del marcador de posición y deje el atributo en blanco.

This text is shown in the UI in these places:

  1. En la columna Metas de la pantalla Metas.
  2. In the Goal ID field on the Edit Goal screen.
  3. In the ID column on the Content screen.
  4. In the Goal list on the Discover Goals screen.

Esquema

El siguiente es un esquema XML para estos archivos XML:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <!-- ================================== -->
    <!-- Documento estándar -->
    <xs:element name="standard_document">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="organization"/>
                <xs:element ref="subject"/>
                <xs:element ref="document_set"/>
                <xs:element ref="grade_range" maxOccurs="unbounded"/>
                <xs:element ref="standard" maxOccurs="unbounded"/>
            </xs:sequence>
            <xs:attribute name="year" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value="\d\d\d\d"/>
                        <!-- Por ejemplo, "2014" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="uid_provider" use="required">
                <xs:simpleType>
                    <xs:restriction base="ST_two-character_code">
                        <!-- Por ejemplo, "PS" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="uid" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value="\S{1,37}"/>
                        <!-- Por ejemplo, "PHYS101" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="status" use="optional">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="A"/>
                        <xs:enumeration value="I"/>
                        <xs:enumeration value="R"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="revision_date" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value="\d\d\d\d-\d\d-\d\d \d\d:\d\d:\d\d"/>
                        <!-- Por ejemplo, "2014-01-30 09:15:00" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="editable" use="optional">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="true"/>
                        <xs:enumeration value="false"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Organización -->
    <xs:element name="organization">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_non_blank_string">
                    <xs:attribute name="org_code" type="ST_256-character_code" use="required"/>
                    <xs:attribute name="country_code" type="ST_two-character_code" use="required"/>
                </xs:extension>
                <!-- Por ejemplo, "Blackboard College" -->
                <!-- Por ejemplo, "BB" -->
                <!-- Por ejemplo, "US" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Materia -->
    <xs:element name="subject">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_non_blank_string">
                    <xs:attribute name="code" use="required">
                        <xs:simpleType>
                            <xs:restriction base="xs:string">
                                <xs:pattern value="\S{1,5}"/>
                                <!-- Por ejemplo, "LAB01" -->
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:extension>
                <!-- Por ejemplo, "Metas del laboratorio de física" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Conjunto de documentos -->
    <!-- Por ejemplo, "BB" -->
        
       <!-- Por ejemplo, "US" -->      
       </xs:simpleContent>          </xs:complexType>
    </xs:element>      <!-- ================================== -->      <!-- Materia -->      <xs:element name="subject">
        <xs:complexType>         <xs:simpleContent>
                <xs:extension base="ST_non_blank_string">
                
   <xs:attribute name="code" use="required">          
        
    <xs:simpleType>
    
    
   
        
   <xs:restriction base="xs:string">          
                 <xs:extension base="ST_1_to_101_characters">
                    <xs:attribute name="lo" type="xs:integer" use="required"/>
                    <xs:attribute name="hi" type="xs:integer" use="required"/>
                    <xs:attribute name="code" type="ST_string_with_no_spaces" use="required"/>
                </xs:extension>
                <!-- Por ejemplo, "La categoría de medición" -->
                <!-- Por ejemplo, "1" -->
                <!-- Por ejemplo, "1" -->
                <!-- Por ejemplo, "COMPUTADORA PORTÁTIL" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Standard -->
    <xs:element name="standard">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="title"/>
                <xs:element ref="grade_range_ref"/>
                <xs:element ref="item" maxOccurs="unbounded"/>
            </xs:sequence>
            <xs:attribute name="uid" type="ST_non_blank_string" use="required"/>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Título -->
    <xs:element name="title" type="ST_non_blank_string"/>
    <!-- Por ejemplo, "Computadoras portátiles del laboratorio" -->
    <!-- ================================== -->
    <!-- Ref. del rango de calificaciones -->
    <xs:element name="grade_range_ref">
        <xs:complexType>
            <xs:attribute name="code" type="ST_string_with_no_spaces" use="required"/>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Elemento -->
    <xs:element name="item">
        <xs:complexType>
            <xs:sequence>
                <xs:element ref="statement"/>
            </xs:sequence>
            <xs:attribute name="uid" type="ST_goal_uid" use="required"/>
            <xs:attribute name="stem" type="xs:string" use="required"/>
            <xs:attribute name="parent_uid" type="ST_parent_goal_uid" use="required"/>
            <xs:attribute name="linkable" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:enumeration value="N"/>
                        <xs:enumeration value="Y"/>
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="label" type="ST__string" use="required"/>
            <xs:attribute name="doc_num" use="required">
                <xs:simpleType>
                    <xs:restriction base="xs:string">
                        <xs:pattern value=".{0,101}"/>
                        <!-- De 0 a 101 caracteres -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <!-- Por ejemplo, "El alumno:" o en blanco -->
            <!-- Por ejemplo, "Tipo de instrumentación" -->
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Declaración -->
    <xs:element name="statement" type="ST_non_blank_string"/>
    <!-- Por ejemplo, "comprender la incertidumbre de las mediciones" -->
    <!-- ================================== -->
    <!-- Tipos de datos simples -->
    <!-- ================================== -->
    <!-- Cadena sin espacios -->
    <xs:simpleType name="ST_string_with_no_spaces">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S+"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- Código de dos caracteres -->
    <xs:simpleType name="ST_two-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S\S"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- Código de 256 caracteres -->
    <xs:simpleType name="ST_256-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S{1,256}"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- UID de metas -->
    <xs:simpleType name="ST_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,257}"/>
            <!-- De 1 a 257 caracteres -->
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="ST_parent_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,257}"/>
            <!-- De 0 a 257 caracteres -->
        </xs:restriction>
    </xs:simpleType>
    <!-- No más de 101 caracteres -->
    <xs:simpleType name="ST_1_to_101_characters">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,101}"/>
            <!-- De 1 a 101 caracteres -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Cadena no en blanco -->
    <xs:simpleType name="ST_non_blank_string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,}"/>
            <!-- Al menos 1 carácter -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Posible cadena en blanco -->
    <xs:simpleType name="ST__string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,}"/>
            <!-- Puede estar vacía-->
        </xs:restriction>
    </xs:simpleType>
    <!-- ================================== -->
</xs:schema>


Cómo afectan estos archivos a la interfaz del usuario

En los diagramas siguientes se muestra cómo aparecen los elementos del archivo XML en la interfaz de usuario.

Las imágenes solo están disponibles en inglés.

La pantalla Metas

En este diagrama se muestra cómo se asigna el archivo XML a los elementos de la pantalla Metas.

La pantalla Editar meta

En este diagrama se muestra cómo se asigna el archivo XML a los elementos de la pantalla Editar meta. This screen appears if you open the menu to the right of a goal on the Goals screen and choose Edit Goal. The Edit Goal command isn't available if the editable attribute in the <standard_document> element is set to "false".

La pantalla Editar conjunto de metas

En este diagrama se muestra cómo se asigna el archivo XML a los elementos de la pantalla Editar conjunto de metas. This screen appears if you open the menu to the right of a goal set on the Goals screen and choose Edit.) The Set Name and Set Type files fields aren't editable if the editable attribute in the <standard_document> element is set to "false".)

La pantalla Contenido

En este diagrama se muestra cómo se asigna el archivo XML a los elementos de la pantalla Contenido.

La pantalla Descubrir metas

En este diagrama se muestra cómo se asigna el archivo XML a los elementos de la pantalla Descubrir metas. This screen appears when you choose Add Alignments on the Content screen.


Eliminar elementos

No puede eliminar elementos mediante la carga de archivos nuevos. Para hacerlo, utilice la interfaz de usuario.


Añadir y sustituir elementos

La manera más sencilla de añadir o sustituir elementos es eliminar los existentes (mediante la interfaz de usuario) y después cargar una archivo que contenga la información actualizada.

Si necesita añadir o sustituir elementos sin usar la interfaz de usuario, en las secciones siguientes se describe el proceso.

La jerarquía de UID

  • El conjunto de UID para cada meta (es decir, el conjunto de UID para <standard_document>, <document_set>, <standard> y <item>) debe ser uno solo para todos los archivos.
  • Estas UID forman una jerarquía:
    • <standard_document>
    • <document_set>
    • <standard>
    • <item>

La UID del elemento <standard> también interactúa con el atributo code del elemento <grade_range>, según se describe a continuación.

Adición de elementos nuevos

You can add new items, or replace old items, by keeping the items higher in the hierarchy the same and using different UIDs for items that are lower in the hierarchy.

Ejemplo

  1. Suponga que carga un archivo con los siguientes atributos. Esto creará un conjunto de metas, una categoría y una meta.
    <standard_
    document>

    UID
    <document_set>
    UID
    <grade_range>
    CODE
    <standard>
    UID
    <item>
    UID
    STANDARD_DOC_1DOCS_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1span>">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

  2. Si después carga un archivo con los atributos siguientes, esto creará una categoría y una meta nuevas.
    <standard_
    document>

    UID
    <document_set>
    UID
    <grade_range>
    CODE
    <standard>
    UID
    <item>
    UID
    STANDARD_DOC_1DOCS_SET_1CATEGORY_ASTANDARD_AITEM_A

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_A">Category A</grade_range>
       <standard uid="STANDARD_A">
          <title>Category A</title>
          <grade_range_ref code="CATEGORY_A"/>
          <item uid="ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

    Si cambia la UID del elemento <standard>, también deberá cambiar el atributo code del elemento <grade_range>. Si solo cambia la UID del elemento <standard>, se producirá un error en la importación.

  3. Si, a continuación, carga un archivo con los mismos atributos pero con contenido distinto, se actualizará el enunciado de la meta.

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_A">Category A</grade_range>
       <standard uid="STANDARD_A">
          <title>Category A</title>
          <grade_range_ref code="CATEGORY_A"/>
          <item uid="ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the new goal.</statement>
          </item>
       </standard>
    </standard_document>

Cambiar los nombres

Si carga la información con el mismo conjunto de UID pero con atributos code distintos, se cambiará el nombre de los elementos.

Ejemplo

  1. Suponga que carga un archivo con los siguientes atributos. Esto creará un conjunto de metas, una categoría y una meta.
    <standard_
    document>

    UID
    <subject>
    CODE
    <document_
    set>

    UID
    <grade_
    range>

    CODE
    <standard>
    UID
    <item>
    UID
    STANDARD_DOC_1SUBJECT_1DOCS_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

  2. Si, a continuación, carga un archivo con los atributos siguientes, se cambiará el nombre del conjunto de metas (de "Conjunto de metas 1" a "Conjunto de metas B").
    <standard_
    document>

    UID
    <subject>
    CODE
    <document_
    set>

    UID
    <grade_
    range>

    CODE
    <standard>
    UID
    <item>
    UID
    STANDARD_DOC_1SUBJECT_BDOCS_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_B">Goal Set B</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

Este procedimiento también funciona para cambiar el nombre del atributo code del elemento <grade_range>.

Añadir o cambiar elementos de las posiciones altas de la jerarquía

You will receive an error, and the file will not be uploaded if the UIDs for elements that are lower in the hierarchy have already been used but with different UIDs for elements higher in the hierarchy.

Ejemplo

  1. Suponga que carga un archivo con los siguientes atributos. Esto creará un conjunto de metas, una categoría y una meta.
    <standard_
    document>

    UID
    <document_
    set>

    UID
    <grade_
    range>

    CODE
    <standard>
    UID
    <item>
    UID
    STANDARD_DOC_1DOC_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

  2. Si después intenta cargar un archivo con los atributos siguientes, se producirá un error en la carga.
    <standard_
    document>

    UID
    <document_
    set>

    UID
    <grade_
    range>

    CODE
    <standard>
    UID
    <item>
    UID
    STANDARD_DOC_CDOC_SET_1CATEGORY_1STANDARD_1ITEM_1

    <?xml version="1.0" encoding="UTF-8"?>
    <standard_document year="2013" revision_date="2013-12-20 13:40:00" uid="STANDARD_DOC_C" uid_provider="PS" status="A" editable="true">
       <organization org_code="BB" country_code="US">Blackboard College</organization>
       <subject code="SUBJECT_1">Goal Set 1</subject>
       <document_set uid="DOC_SET_1">Goal Set Type 1</document_set>
       <grade_range lo="1" hi="1" code="CATEGORY_1">Category 1</grade_range>
       <standard uid="STANDARD_1">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>
          </item>
       </standard>
    </standard_document>

Si desea añadir o cambiar elementos de las posiciones altas de la jerarquía, debe utilizar UID distintas para los elementos de las posiciones bajas de la jerarquía.