Saltar al contenido principal
pdf?stylesheet=default
Blackboard Help

Configuración de la sintaxis XML de integración SIS para la creación de cursos

El formato de Blackboard Learn es una variante del estándar de IMS que se dirige explícitamente a los objetos específicos de Blackboard. Este tema se ocupa de los aspectos de este formato que pertenecen a la creación de un curso con el elemento <grupo> y asociándolo con un nodo en la jerarquía institucional.

En el formato de Blackboard Learn,

  • los elementos de grupo se utilizan para representar dos tipos de objetos: cursos y nodos.
  • Los elementos de relación son el tejido conector del esquema de Blackboard: vinculan los nodos entre sí para formar la jerarquía institucional y los cursos a los nodos para crear las asociaciones de cursos.

Creación de un elemento del grupo de cursos

A continuación encontrará un fragmento de XML de un elemento de <grupo> que describe un curso.

<!-- crear un curso -->
<group recstatus="1">
  <sourcedid>
    <source>My Institution SIS</source>
   <id>0390COMPSCI697CSec1-1164</id>
  </sourcedid>
  <grouptype>
    <scheme>Blackboard</scheme>
    <typevalue level = "20"/>
  </grouptype>
  <datasource>My Institution SIS</datasource>
  <description>
    <short>Comp697</short>
    <long>Seguridad en la informática</long>
    full>Este curso presenta los conceptos básicos, así como algunas técnicas prácticas para garantizar la seguridad.</full>
  </description>
</group>

Edite los atributos y los valores pertinentes en el código anterior con la información del curso.

Nota:  También puede utilizar este código para crear un nodo.

Detalles del curso
Elemento/Atributo Obligatorio Descripción
recstatus No Tipo de acción a realizar en un objeto. Se utilizan números para lograr la independencia frente al idioma: 1 = Añadir, 2 = Actualizar y 3 = Eliminar.

Si no se proporciona ningún atributo recstatus, el API se establecerá de forma predeterminada a 1 (Añadir) si el registro no existe ya o 2 (Actualizar) si el registro existe.

sourcedid Identificador único del objeto del grupo que consiste en un elemento de origen y en un ID de elemento.
origen Identificador único del sistema que ha creado el objeto de grupo en primer lugar.
id Identificador único de nivel inferior para el objeto del grupo.

Para un curso, identifica de forma única el curso específico, el período, etc. dentro de la organización o el sistema de origen. Para un nodo que identifica de forma única el departamento, la escuela y demás, dentro de la organización o del sistema.

grouptype El tipo de grupo.
scheme El esquema de categorización del grupo que se está utilizando.
  • Blackboard Enterprise utiliza <scheme>Blackboard</scheme>.
  • Vista Enterprise utiliza <scheme>LEARNING_CONTEXT_V1</scheme>.
typevalue Especifica qué se añade. El objeto que representa este grupo. El typevalue de Blackboard Enterprise debería ser uno de los siguientes:
  • 10 – Esto representa un nodo en la jerarquía institucional.
  • 20 – Esto representa un curso de Blackboard Learn.

El typevalue de Vista Enterprise debería ser uno de los siguientes:

  • 25 – Esto representa una división.
  • 30 – Esto representa un grupo.
  • 60 – Esto representa un período.
  • 80 – Esto representa un curso.
  • 90 – Esto representa una sección.
descripción Describe el curso o el nodo.
short En un curso, identifica la versión abreviada del título del curso. En un nodo, identifica el nombre del nodo. Por ejemplo, Ingeniería.
long No Identifica el título del curso.

Nota:  Si no se ha especificado ningún valor para <long>, el valor <short> se convierte en el título del curso.

full No Identifica la descripción completa del curso o del nodo.

Asociación de un curso a un nodo mediante un elemento de relación

Un elemento de <relación> siempre se encuentra dentro de un elemento de <grupo> y describe la relación del elemento con los demás grupos. A continuación encontrará un fragmento de XML de un elemento de <relación> que describe la asociación del curso a un nodo.

<group recstatus="1">
  <sourcedid>
    <source>My Institution SIS</source>
    <id>0390COMPSCI697CSec1-1164</id>
  </sourcedid>
  <grouptype>
    <scheme>Blackboard</scheme>
    <typevalue level = "20"/>
  </grouptype>
  <datasource>My Institution SIS</datasource>
  <description>
    <short>Comp697</short>
    <long>Seguridad en la informática</long>
    <full>Este curso presenta los conceptos básicos así como algunas técnicas prácticas para garantizar la seguridad.</full>
  </description>

<!-- asociación principal -->
  <relationship relation="1">
  <sourcedid>
    <source>My Institution SIS</source>
    <id>CompSciDept</id>
  </sourcedid>
  <label/>
  </relationship>

<!-- asociación secundaria -->
  <relationship relation="1">
  <sourcedid>
    <source>My Institution SIS</source>
    <id>EEDept</id>
  </sourcedid>
  <label/>
  </relationship>
</group>

Cuando un curso cuenta con múltiples asociaciones, el orden en el que se especifican dichas asociaciones importa. La primera se considera como la asociación principal, las demás son secundarias. Cuando un curso tiene que determinar qué ajustes de la herramienta del nodo sigue, tendrá en cuenta la asociación principal.

Si el curso ya existe (por ejemplo, si es una actualización de un curso existente), la directiva anterior borrará cualquier asociación de nodo actual del curso antes de crear las nuevas.

Edite los atributos y los valores pertinentes en el código anterior con la información de la asociación.

Detalles de la asociación
Elemento/Atributo Obligatorio Descripción
relationship No Indica que el nodo principal (contexto de aprendizaje) del curso o nodo que se añade.

Esto invalida la línea de comando y los ajustes predeterminados introducidos en la interfaz de ajustes de administración.

relation No Califica el tipo de relación. Siempre debería ser un valor de 1.
relationship.
sourcedid
sourcedid del nodo principal del curso o el nodo con el que debería asociarse.
label Describe la relación.

A pesar de que este campo es obligatorio, se puede utilizar una referencia con el elemento vacío si no existe ningún valor para label como se observa en el ejemplo.