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 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 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:
  • 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 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:

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

  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 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
Grade 1
Grade 2
Grade 3
Grade 4

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:

  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 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:
  • 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"?>
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

  1. 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

    UID
    STANDARD_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.
          
       

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

    UID

    CODE

    UID

    UID
    STANDARD_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.

  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"?>

       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

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

    CODE
    set>
    UID
    range>
    CODE

    UID

    UID
    STANDARD_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.
          
       

  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").
    document>
    UID

    CODE
    set>
    UID
    range>
    CODE

    UID

    UID
    STANDARD_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

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

    UID

    UID
    STANDARD_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.
          
       

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

    UID

    UID
    STANDARD_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.