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:
- Información sobre el conjunto de metas.
- 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.
- 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> 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">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:
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:
|
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:
|
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. 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, 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">Kindergarten</grade_range> |
code | Un 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>. |
standard | El 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>. |
uid | Un 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. |
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:
|
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> dentro de cada elemento <standard>. |
code | Introduzca 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:
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:
|
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:
|
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
- 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>
UIDSTANDARD_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> - 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>
UIDSTANDARD_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>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.
- 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
- 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>
UIDSTANDARD_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> - 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>
UIDSTANDARD_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>
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
- 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>
UIDSTANDARD_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> - 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>
UIDSTANDARD_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.