Importar metas

Para importar metas a Blackboard Learn, se puede 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"?>
<!-- Defina un conjunto de metas -->
<!-- Cree un archivo XML independiente para cada conjunto de metas -->
<standard_document year="INDIQUE EL AÑO PERTINENTE AQUÍ" revision_date="ESCRIBA LA FECHA Y LA HORA DE REVISIÓN AQUÍ" uid="INDIQUE EL ID DEL DOCUMENTO AQUÍ. No utilice espacios".
   uid_provider="ESCRIBA EL CÓDIGO DE PROVEEDOR DE 2 CARACTERES AQUÍ" status="ESCRIBA A, I o R" editable="ESCRIBA TRUE O FALSE">
   
   <!-- Defina la organización origen de este conjunto de metas -->
   <organization org_code="ESCRIBA EL CÓDIGO FUENTE AQUÍ (HASTA 256 CARACTERES)" country_code="US">
      ESCRIBA EL TEXTO COMPLETO DEL ORIGEN DE LAS METAS AQUÍ.
   </organization>
   
   <!-- Defina el nombre del conjunto de metas -->
   <subject code="INDIQUE EL ID DEL CONJUNTO DE METAS AQUÍ. No utilice espacios".>
      ESCRIBA EL NOMBRE DEL CONJUNTO DE METAS AQUÍ</subject>
   
   <!-- Defina el tipo de conjunto de metas -->
   <document_set uid="INDIQUE EL ID DEL TIPO DE CONJUNTO DE METAS AQUÍ. No utilice espacios".>
      ESCRIBA EL TEXTO COMPLETO DEL TIPO DE CONJUNTO DE METAS AQUÍ</document_set>
   
   <!-- Defina las categorías -->
   <!-- Cree un elemento <grade_range>y un elemento    <grade_range lo="INDIQUE LA POSICIÓN MÁS BAJA DE LA LISTA DE CATEGORÍAS" hi="INDIQUE LA POSICIÓN MÁS ALTA DE LA LISTA DE CATEGORÍAS"
      code="INDIQUE EL ID DE LA CATEGORÍA AQUÍ. No utilice espacios".>ESCRIBA EL TEXTO COMPLETO DEL NOMBRE DE LA CATEGORÍA AQUÍ</grade_range>
   <standard uid="INDIQUE EL ID DE LA CATEGORÍA AQUÍ. No utilice espacios".>
      <title>ESCRIBA EL TEXTO COMPLETO DEL NOMBRE DE LA CATEGORÍA AQUÍ</title>
      <grade_range_ref code="INDIQUE EL ID DE LA CATEGORÍA AQUÍ"/>
      
      <!-- Defina las metas -->
      <!-- Cree un elemento <item>para cada meta de la categoría -->
      <item uid="INDIQUE EL ID ÚNICO DE LA META AQUÍ. No utilice espacios. "parent_uid="INDIQUE EL ID DE LA META PRINCIPAL AQUÍ O DEJE EL VALOR EN BLANCO" label="ESCRIBA EL TEXTO COMPLETO DEL TIPO DE METAS AQUÍ" linkable="ESCRIBA Y o N"
         stem="ESCRIBA EL TEXTO DE INICIO DE LA META AQUÍ O DEJE EL VALOR EN BLANCO" doc_num="INDIQUE EL ID DE LA META AQUÍ O DEJE EL VALOR EN BLANCO">
         <statement>ESCRIBA EL TEXTO COMPLETO DEL ENUNCIADO DE LA META AQUÍ</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/Atributo Descripción
standard_document El elemento <standard_document> describe las propiedades del conjunto de metas. Debe haber un solo elemento <standard_document> en el archivo.
year El año con el formato AAAA. Por jemplo, "2013".
revision_date La fecha y la hora de revisión con el formato AAAA-MM-DD HH:MM:SS. Por ejemplo, "2013-12-20 13:40:00".
uid El ID de documento. No debe usar más de 37 caracteres. Don't use spaces.
uid_provider Un identificador de dos caracteres para el proveedor del conjunto de metas. Por ejemplo, "PS".
status El 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).
organization El 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_code Un identificador del origen. Puede tener un máximo de 256 caracteres. Por ejemplo, "BB".
country_code El identificador de dos caracteres del país del origen. Por ejemplo, "US".
subject El 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.
code Un identificador para el conjunto de metas. No debe usar más de cinco caracteres. Don't use spaces.
document_set El 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.
uid Un identificador para el tipo de conjunto de metas. Don't use spaces.
grade_range El elemento <grade_range> describe una categoría. Debe haber uno o más elementos <grade_range> en el archivo. El número de elementos <grade_range> debe coincidir con el número 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, hi Los 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"> Jardín de infancia</grade_range>
<grade_range lo="2" hi="2" code="1"> Calificación 1</grade_range>
<grade_range lo="3" hi="3" code="2"> Calificación 2</grade_range>
<olagrade_range lo="4" hi="4" code="3"> Calificación 3</grade_range>
<grade_range lo="5" hi="5" code="4"> Calificación 4</grade_range>

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

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

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

Debe haber uno o más elementos <standard> en el archivo. El número de elementos <standard> debe coincidir con el número de elementos <grade_range>.

uid Un identificador para las metas. Por ejemplo, "001". Cada <standard> debe tener un ID único.

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

title El 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_ref El elemento <grade_range_ref> vincula el conjunto de metas con la categoría. En el archivo, debe haber un solo elemento <grade_range_ref> en cada elemento <standard>.
code Ingrese el atributo code del elemento <grade_range> para la categoría correspondiente.
item El elemento <item> describe una meta. En el archivo, debe haber uno o más elementos <item> dentro de cada elemento <standard>.
uid Un identificador único para la meta. No debe usar más de 257 caracteres.
parent_uid El 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.
label El 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.
linkable One 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.

stem El 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_num El 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. En la lista Meta de la pantalla Descubrir metas.

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, "Physics Lab Goals" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Conjunto de documentos -->
    <xs:element name="document_set">
        <xs:complexType>
            <xs:simpleContent>
                <xs:extension base="ST_1_to_101_characters">
                    <xs:attribute name="uid" type="ST_string_with_no_spaces" use="required"/>
                </xs:extension>
                <!-- Por ejemplo, "Introductory Goals" -->
                <!-- Por ejemplo, "INTRO" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Rango de calificaciones -->
    <xs:element name="grade_range">
        <xs:complexType>
            <xs:simpleContent>
                <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, "The Measurement Category" -->
                <!-- Por ejemplo, "1" -->
                <!-- Por ejemplo, "1" -->
                <!-- Por ejemplo, "NOTEBOOK" -->
            </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, "Lab Notebooks" -->
    <!-- ================================== -->
    <!-- Referencia de 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, "The student will:" or blank -->
            <!-- Por ejemplo, "Instrumentation Type" -->
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Enunciado-->
    <xs:element name="statement" type="ST_non_blank_string"/>
    <!-- Por ejemplo, "understand the uncertainty in measurements" -->
    <!-- ================================== -->
    <!-- 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 meta -->
    <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 que no puede quedar 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>
    <!-- Cadena posiblemente 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. El comando Editar meta no está disponible si el atributo editable del elemento <standard_document> está establecido en "falso".

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. Esta pantalla aparece si abre el menú situado a la derecha de un conjunto de metas en la pantalla Metas y elige Editar. Los campos Nombre del conjunto y Tipo de conjunto no se pueden editar si el atributo editable del elemento <standard_document> está establecido en "falso".

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, para <standard_document>, <document_set>, <standard> e <item>) debe ser único en todos los archivos.
  • Estas UID forman una jerarquía:
    • <standard_document>
    • <document_set>
    • <standard>
    • <item>

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

Adición de elementos nuevos

Para agregar elementos nuevos, o sustituir los antiguos, no modifique los elementos que se encuentran más arriba en la jerarquía y utilice UID distintos para los elementos que están en posiciones inferiores.

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_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_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</organizationgt;
       <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 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_1 DOCS_SET_1 CATEGORY_A STANDARD_A ITEM_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</organizationgt;
       <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 1</grade_range>
       <standard uid="STANDARD_A">
          <title>Category 1</title>
          <grade_range_ref code="CATEGORY_1"/>
          <item uid="ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
             <statement>This is the goal.</statement>This is the goal.</item>
          </standard>
       </standard_
    document>

    Si cambia el UID del elemento <standard>, también debe modificar el atributo code del elemento <grade_range>. Si solo cambia el 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_1 SUBJECT_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_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_1 SUBJECT_B DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1

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

    SUBJECT_BGoal Set B
    DOC_SET_1
    CATEGORY_1
    STANDARD_1


    ITEM_1
             
       > </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

Si ya se utilizaron los UID de los elementos de las posiciones inferiores en la jerarquía pero con UID distintos para los elementos que se encuentran en las posiciones más altas, se producirá un error y no se cargará el archivo.

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_1 DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_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</organizationgt;
       <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_C DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_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</organizationgt;
       <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.