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:
- 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 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 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"?>
uid_provider="ESCRIBA EL CÓDIGO DE PROVEEDOR DE 2 CARACTERES AQUÍ" status="ESCRIBA A, I o R" editable="ESCRIBA TRUE O FALSE">
ESCRIBA EL TEXTO COMPLETO DEL ORIGEN DE LAS METAS AQUÍ.
ESCRIBA EL NOMBRE DEL CONJUNTO DE METAS AQUÍ
ESCRIBA EL TEXTO COMPLETO DEL TIPO DE CONJUNTO DE METAS AQUÍ
code="INDIQUE EL ID DE LA CATEGORÍA AQUÍ. No utilice espacios".>ESCRIBA EL TEXTO COMPLETO DEL NOMBRE DE LA CATEGORÍA AQUÍ
ESCRIBA EL TEXTO COMPLETO DEL NOMBRE DE LA CATEGORÍA AQUÍ
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">
ESCRIBA EL TEXTO COMPLETO DEL ENUNCIADO DE LA META AQUÍ
Ejemplo
<?xml version="1.0" encoding="UTF-8"?>
Blackboard College
Physics Lab Goals
Introductory Goals
The Measurement Category
Measurement
learn how to use a micrometer
understand the uncertainty in measurements
The Lab Notebook Category
Lab Notebooks
record lab results in detail
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 describe las propiedades del conjunto de metas. Debe haber un solo elemento 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 describe la organización que es el origen de la meta. Debe haber un solo elemento 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 especifica el nombre del conjunto de metas. Debe haber un solo elemento 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 describe el tipo del conjunto de metas. Debe haber un solo elemento 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 describe una categoría. Debe haber uno o más elementos en el archivo. El número de elementos debe coincidir con el número de elementos . 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: Kindergarten |
| code | Un identificador de la categoría. Don't use spaces. Debe coincidir con un atributo code de uno de los elementos . Se utiliza para vincular el elemento con el elemento . |
| standard | El elemento describe el conjunto de metas de una categoría. Debe haber uno o más elementos en el archivo. El número de elementos debe coincidir con el número de elementos . |
| uid | Un identificador para las metas. Por ejemplo, "001". Cada 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 en cada elemento . This title is shown in the UI in these places:
|
| grade_range_ref | El elemento vincula el conjunto de metas con la categoría. En el archivo, debe haber un solo elemento en cada elemento . |
| code | Ingrese el atributo code del elemento para la categoría correspondiente. |
| item | El elemento describe una meta. En el archivo, debe haber uno o más elementos dentro de cada elemento . |
| 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"?>
http://www.w3.org/2001/XMLSchema">
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 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 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 , , e ) debe ser único en todos los archivos.
- Estas UID forman una jerarquía:
El UID del elemento también interactúa con el atributo code del elemento , 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
- Suponga que carga un archivo con los siguientes atributos. Esto creará un conjunto de metas, una categoría y una meta.
document>
UID
UID
CODE
UID
UIDSTANDARD_DOC_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
">Goal Set 1
DOC_SET_1">Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
- Si después carga un archivo con los atributos siguientes, esto creará una categoría y una meta nuevas.
document>
UID
UID
CODE
UID
UIDSTANDARD_DOC_1 DOCS_SET_1 CATEGORY_A STANDARD_A ITEM_A <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
Goal Set 1
DOC_SET_1">Goal Set Type 1
CATEGORY_A">Category A
STANDARD_A">
Category A
ITEM_A" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
Si cambia el UID del elemento , también debe modificar el atributo code del elemento . Si solo cambia el UID del elemento , 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"?>
Blackboard College
Goal Set 1
Goal Set Type 1
Category A
Category A
This is the new goal.
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.
document>
UID
CODEset>
UIDrange>
CODE
UID
UIDSTANDARD_DOC_1 SUBJECT_1 DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
SUBJECT_1">Goal Set 1
Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
- 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").
document>
UID
CODEset>
UIDrange>
CODE
UID
UIDSTANDARD_DOC_1 SUBJECT_B DOCS_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
SUBJECT_B">Goal Set B
DOC_SET_1">Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
Este procedimiento también funciona para cambiar el nombre del atributo code del elemento .
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
- Suponga que carga un archivo con los siguientes atributos. Esto creará un conjunto de metas, una categoría y una meta.
document>
UIDset>
UIDrange>
CODE
UID
UIDSTANDARD_DOC_1 DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_1" uid_provider="PS" status="A" editable="true">
Blackboard College
Goal Set 1
DOC_SET_1">Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
- Si después intenta cargar un archivo con los atributos siguientes, se producirá un error en la carga.
document>
UIDset>
UIDrange>
CODE
UID
UIDSTANDARD_DOC_C DOC_SET_1 CATEGORY_1 STANDARD_1 ITEM_1 <?xml version="1.0" encoding="UTF-8"?>
STANDARD_DOC_C" uid_provider="PS" status="A" editable="true">
Blackboard College
Goal Set 1
DOC_SET_1">Goal Set Type 1
CATEGORY_1">Category 1
STANDARD_1">
Category 1
ITEM_1" parent_uid="" label="" linkable="Y" stem="" doc_num="DOC_NUM_1">
This is the goal.
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.
