Saltar al contenido principal
pdf?stylesheet=default
Blackboard Help

Importar metas

Importar metas

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.

No use la función nativa "comprimir" en un Mac para crear un archivo ZIP para importar sus metas. 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.

Cada archivo contiene:

  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.

Cómo cargar archivos

En el Panel del administrador, en la sección Herramientas y utilidades, seleccione Metas. En la página Metas, mueva el puntero del ratón sobre Añadir conjunto de metas para acceder a la lista desplegable y seleccione Importar conjunto de metas. 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> element and one <standard> 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> 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">Metas del laboratorio de física</subject>
   <document_set uid="INTRO">Metas introductorias</document_set>
   
   <grade_range lo="1" hi="1" code="MEASURE">Categoría Medición</grade_range>
   <standard uid="1">
      <title>Medición</title>
      <grade_range_ref code="MEASURE"/>
      <item uid="001" parent_uid="" label="Tipo de instrumentación" linkable="Y" stem="El alumno:" doc_num="MEASURE_001">
         <statement>aprenderá a utilizar un micrómetro</statement>
      </item>
      <item uid="002" parent_uid="001" label="Tipo de instrumentación" linkable="N" stem="El alumno:" doc_num="MEASURE_002">
         <statement>comprenderá la incertidumbre de las mediciones</statement>
      </item>
   </standard>
   
   <grade_range lo="2" hi="2" code="NOTEBOOK">Categoría Notas de laboratorio</grade_range>
   <standard uid="2">
      <title>Notas de laboratorio</title>
      <grade_range_ref code="NOTEBOOK"/>
      <item uid="003" parent_uid="" label="Tipo de documentación" linkable="Y" stem="El ALUMNO:" doc_num="NOTE_001">
         <statement>registrará el detalle de los resultados de laboratorio</statement>
      </item>
   </standard>
</standard_document>

Otros ejemplos

Puede obtener otros ejemplos de archivos XML si inicia sesión en Behind the Blackboard y accede al número de artículo 13668, "Documentos de normas de Blackboard Learn y CE/Vista".

Descripción 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 ejemplo: "2103".

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. No utilice espacios.

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. Si está presente, debe ser uno de los siguientes:

  • A (Activo): La meta definida está disponible para todos los cursos.
  • I (Inactivo): La meta definida no está disponible para ningún curso.
  • R (Restringido): La meta definida solo está visible para los cursos asociados explícitamente con la categoría. (Para asociar un curso con una categoría, utilice el menú contextual corchete único situado junto a la categoría y elija Asociar con cursos).

 

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

editable

Puede ser "true" o "false". Este elemento es opcional.

Si es verdadero (true), la meta definida se puede editar en la interfaz de usuario. Si es falso (false), 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.

Sustituya el texto de marcador “ENTER FULL TEXT OF GOAL SOURCE HERE". Por ejemplo, sustitúyalo por “Blackboard College".

Debe haber un solo elemento <organization> en el archivo.

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.

Sustituya el texto del marcador de posición “ENTER GOAL SET NAME HERE". Por ejemplo, sustitúyalo por "Metas del laboratorio de física".

Este nombre se muestra en la interfaz de usuario en los siguientes lugares:

  1. En la columna Conjunto de metas de la pantalla Metas.
  2. En el campo Nombre del conjunto de la pantalla Editar conjunto de metas.
  3. En la columna Nombre del conjunto de metas de la pantalla Contenido.
  4. En la columna Conjunto de metas y la lista desplegable Conjunto de metas de la pantalla Descubrir metas.

Vea Cómo afectan estos archivos a la interfaz de usuario.

Debe haber un solo elemento <subject> en el archivo.

code

Un identificador para el conjunto de metas. No debe usar más de cinco caracteres. No utilice espacios.

document_set

El elemento <document_set> describe el tipo de conjunto de metas.

Sustituya el texto de marcador "ENTER FULL TEXT OF GOAL SET TYPE HERE". No debe usar más de 101 caracteres. Por ejemplo, sustitúyalo por "Metas introductorias".

Este texto se muestra en la interfaz de usuario en los siguientes lugares:

  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.

Vea Cómo afectan estos archivos a la interfaz de usuario.

Debe haber un solo elemento <document_set> en el archivo.

uid

Un identificador para el tipo de conjunto de metas. No utilice espacios.
grade_range

El elemento <grade_range> describe una categoría.

Sustituya el texto de marcador “ENTER FULL TEXT OF CATEGORY NAME HERE”. No debe usar más de 101 caracteres.

Este texto no se muestra en la interfaz de usuario.

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

lo, high

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">Guardería</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>
<grade_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. No utilice espacios.

Nota: Debe coincidir con un atributo code de uno de los elementos <grade_range_ref>. Esto se utiliza para enlazar 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 varios 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.

Este identificador se muestra en el campo ID único de la interfaz de usuario, en la pantalla Editar meta. Vea Cómo afectan estos archivos a la interfaz de usuario.

title

El título de la categoría. Por ejemplo, "Medición".

Este título se muestra en la interfaz de usuario en los siguientes lugares:

  1. En la columna Categoría de la pantalla Metas.
  2. En la columna Categoría de la pantalla Contenido.
  3. En la lista desplegable Categoría de la pantalla Descubrir metas.

Vea Cómo afectan estos archivos a la interfaz de usuario.

Debe haber un solo elemento <title> en cada elemento <standard> del archivo.

grade_range_ref

El elemento <grade_range_ref> enlaza el conjunto de metas con la categoría.

Debe haber un solo elemento <grade_range_ref> dentro de cada elemento <standard> del archivo.

code

Introduzca el atributo code del elemento <grade_range> para la categoría correspondiente.

item

El elemento <item> describe una meta.

Debe haber uno o varios elementos <item> dentro de cada elemento <standard> del archivo.

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. Vea Cómo afectan estos archivos a la interfaz de usuario.

linkable

Seleccione una de las siguientes funciones:

  • 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, tienen este icono al lado: icono de meta restringida. (Para asociar un curso con una categoría, haga clic en el menú contextual corchete único situado junto a la categoría y elija Asociar con cursos).

stem

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

Este texto se muestra en la interfaz de usuario en los siguientes lugares:

  1. En la columna Metas en la pantalla Metas.
  2. En la columna Meta de la pantalla Descubrir metas.

Vea Cómo afectan estos archivos a la interfaz de usuario.

doc_num

El identificador de la meta. No debe usar más de 101 caracteres. Por ejemplo, "MEASURE_001". Si no desea que aparezca el ID de la meta, elimine el texto del marcador de posición y deje el atributo en blanco.

Este texto se muestra en la interfaz de usuario en los siguientes lugares:

  1. En la columna Metas en la pantalla Metas.
  2. En el campo ID de meta de la pantalla Editar metas.
  3. En la columna ID de la pantalla Contenido.
  4. En la lista Meta de la pantalla Descubrir metas.

Vea Cómo afectan estos archivos a la interfaz de usuario.

   

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">
    <!-- ================================== -->
    <!-- Standard Document  -->
    <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"/>
                        <!-- For example, "2014" -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <xs:attribute name="uid_provider" use="required">
                <xs:simpleType>
                    <xs:restriction base="ST_two-character_code">
                        <!-- For example, "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}"/>
                        <!-- For example, "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"/>
                        <!-- For example, "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>
    <!-- ================================== -->
    <!-- Organization -->
    <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>
                <!-- For example, "Blackboard College" -->
                <!-- For example, "BB" -->
                <!-- For example, "US" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Subject -->
    <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}"/>
                                <!-- For example, "LAB01" -->
                            </xs:restriction>
                        </xs:simpleType>
                    </xs:attribute>
                </xs:extension>
                <!-- For example, "Physics Lab Goals" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Document Set -->
    <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>
                <!-- For example, "Introductory Goals" -->
                <!-- For example, "INTRO" -->
            </xs:simpleContent>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Grade Range -->
    <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>
                <!-- For example, "The Measurement Category" -->
                <!-- For example, "1" -->
                <!-- For example, "1" -->
                <!-- For example, "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>
    <!-- ================================== -->
    <!-- Title -->
    <xs:element name="title" type="ST_non_blank_string"/>
    <!-- For example, "Lab Notebooks" -->
    <!-- ================================== -->
    <!-- Grade Range Ref -->
    <xs:element name="grade_range_ref">
        <xs:complexType>
            <xs:attribute name="code" type="ST_string_with_no_spaces" use="required"/>
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Item -->
    <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}"/>
                        <!-- 0 to 101 characters -->
                    </xs:restriction>
                </xs:simpleType>
            </xs:attribute>
            <!-- For example, "The student will:" or blank -->
            <!-- For example, "Instrumentation Type" -->
        </xs:complexType>
    </xs:element>
    <!-- ================================== -->
    <!-- Statement -->
    <xs:element name="statement" type="ST_non_blank_string"/>
    <!-- For example, "understand the uncertainty in measurements" -->
    <!-- ================================== -->
    <!-- Simple Data Types -->
    <!-- ================================== -->
    <!-- String with no spaces -->
    <xs:simpleType name="ST_string_with_no_spaces">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S+"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- Two-character code -->
    <xs:simpleType name="ST_two-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S\S"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- 256-character code -->
    <xs:simpleType name="ST_256-character_code">
        <xs:restriction base="xs:string">
            <xs:pattern value="\S{1,256}"/>
        </xs:restriction>
    </xs:simpleType>
    <!-- Goal UIDs -->
    <xs:simpleType name="ST_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,257}"/>
            <!-- 1 to 257 characters -->
        </xs:restriction>
    </xs:simpleType>
    <xs:simpleType name="ST_parent_goal_uid">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,257}"/>
            <!-- 0 to 257 characters -->
        </xs:restriction>
    </xs:simpleType>
    <!-- No more than 101 characters -->
    <xs:simpleType name="ST_1_to_101_characters">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,101}"/>
            <!-- 1 to 101 characters -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Non-blank string -->
    <xs:simpleType name="ST_non_blank_string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{1,}"/>
            <!-- At least 1 character -->
        </xs:restriction>
    </xs:simpleType>
    <!-- Possibly blank string -->
    <xs:simpleType name="ST__string">
        <xs:restriction base="xs:string">
            <xs:pattern value=".{0,}"/>
            <!-- Can be empty-->
        </xs:restriction>
    </xs:simpleType>
    <!-- ================================== -->
</xs:schema>

Cómo afectan estos archivos a la interfaz de 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.

UI_relationships_C.Goals.new.png

La pantalla Editar meta

En este diagrama se muestra cómo se asigna el archivo XML a los elementos de la pantalla Editar meta. (Esta es la pantalla que aparece si hace clic en el menú contextual icon.single_chevron.png  situado a la derecha de una meta en la pantalla Metas y elige Editar meta. El comando Editar meta no está disponible si el atributo editable del elemento <standard_document> está establecido en "false").

UI_relationships_D.Edit_Goals.new.png

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 es la pantalla que verá si hace clic en el menú contextual icon.single_chevron.png  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 "false").

UI_relationships_E.Edit_Goal_Set.new.png

La pantalla Contenido

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

UI_relationships_A.Content.new.png

La pantalla Descubrir metas

En este diagrama se muestra cómo se asigna el archivo XML a los elementos de la pantalla Descubrir metas. (Esta es la pantalla que ve al elegir Añadir alineaciones en la pantalla Contenido).

UI_relationships_B.Discover_Goals.new.png

Eliminación de elementos

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

Adición y sustitución de 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 (en otras palabras, el conjunto de UID 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>

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

Adición de elementos nuevos

Para añadir elementos nuevos, o sustituir los antiguos, mantenga los elementos que están más arriba en la jerarquía iguales y utilice UID distintas para los elementos que están en posiciones inferiores de la jerarquía.

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

    test1.png
  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</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>

    Se han creado una categoría y una meta nuevas

    Si cambia la UID del elemento <standard>, también debe cambiar el atributo code del elemento <grade_range>. Si solo cambia la UID del elemento <standard>, la importación fallará.

  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>

    La meta se ha revisado

Cambio de 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>

    El escenario inicial
  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="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>

    Se ha cambiado el nombre del conjunto de metas.

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

Adición o cambio de elementos en posiciones altas de la jerarquía

Se producirá un error y el archivo no se cargará si las UID de los elementos de las posiciones inferiores de la jerarquía ya se han utilizado, pero con UID distintas para los elementos de las posiciones altas de la jerarquía.

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</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, la carga fallará.
    <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</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.