XML de instantánea
Configure la sintaxis XML de integración de SIS para la creación de cursos
El formato Blackboard es una versión del estándar IMS que se adapta explícitamente a objetos específicos de Blackboard. Este tema se ocupa de los aspectos de tal formato relativos a la creación de un curso mediante el elemento <group> y su asociación a un nodo de la jerarquía institucional.
En el formato Blackboard,
Los elementos de grupo se utilizan para representar dos tipos de objetos: cursos y nodos.
Los elementos de relación son el tejido conectivo del esquema Blackboard: vinculan nodos con nodos para formar la jerarquía de la institución y cursos con nodos para crear asociaciones de cursos.
Crear un elemento de grupo de cursos
A continuación se muestra un fragmento XML de un elemento <group> que describe un curso.
<!-- create a course -->
<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>Security In Computing</long>
<full>This course introduces basic concepts as well as some practical techniques for ensuring security.</full>
</description>
</group>Edite los atributos y los valores relevantes del código anterior con los detalles del curso.
Nota
También puede utilizar este código para crear un nodo.
Elemento/Atributo | Obligatorio | Descripción |
|---|---|---|
recstatus | No | Tipo de acción que se va a realizar en un objeto. Los números se utilizan para la independencia del idioma: 1 = Agregar, 2 = Actualizar y 3 = Eliminar. Si no se proporciona ningún atributo recstatus, la API se utilizará de forma predeterminada en 1 (Agregar) si el registro aún no existe o en 2 (Actualizar) si existe. |
sourcedid | Sí | Identificador único del objeto de grupo formado por un elemento de origen y un elemento de identificación. |
source | Sí | Identificador único del sistema que creó el objeto de grupo en primer lugar. |
id | Sí | Identificador único de nivel inferior para el objeto de grupo. Para un curso, identifica de forma exclusiva el curso, el período y demás dentro de la organización o el sistema de origen. Para un nodo, identifica de forma única el departamento, el instituto, etc., dentro de la organización o el sistema. |
grouptype | Sí | El tipo de grupo. |
scheme | Sí | Esquema de categorización de grupos en uso.
|
typevalue | Sí | Especifica lo que se va a agregar. Objeto que representa este grupo. El valor "typevalue" para Blackboard Enterprise debe ser uno de los siguientes:
El valor "typevalue" para Vista Enterprise debe ser uno de los siguientes:
|
descripción | Sí | Describe el curso o nodo. |
short | Sí | Para un curso, identifica la versión abreviada del título del curso. Para un nodo, identifica el nombre del nodo. Por ejemplo, Ingeniería. |
long | No | Identifica el título del curso. NOTA: Si no <long> se especifica ningún valor, el <short> valor se convierte en el título del curso. |
full | No | Identifica la descripción completa del curso o nodo. |
Asociar un curso a un nodo mediante un elemento de relación
Un elemento <relationship> siempre vive dentro de un elemento <group> y describe la relación de ese elemento con otros grupos. A continuación se muestra un fragmento XML de un elemento <relationship> 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>Security In Computing</long>
<full>This course introduces basic concepts as well as some practical techniques for ensuring security.</full>
</description>
<!-- primary association -->
<relationship relation="1">
<sourcedid>
<source>My Institution SIS</source>
<id>CompSciDept</id>
</sourcedid>
<label/>
</relationship>
<!-- secondary association -->
<relationship relation="1">
<sourcedid>
<source>My Institution SIS</source>
<id>EEDept</id>
</sourcedid>
<label/>
</relationship>
</group>Cuando un curso tiene varias asociaciones, el orden en que se especifican esas asociaciones es importante. La primera se considera la asociación primaria; todas las demás son secundarias. Cuando un curso tenga que determinar qué ajustes de herramienta de nodo respetar, buscará su asociación primaria.
Nota
Si el curso ya existe (por ejemplo, si se trata de una actualización de un curso existente), la directiva anterior eliminará cualquier asociación de nodos actual de un curso antes de crear las nuevas.
Edite los atributos y valores relevantes en el código anterior con los detalles de la asociación.
Elemento/Atributo | Obligatorio | Descripción |
|---|---|---|
relationship | No | Indica el nodo principal (contexto de aprendizaje) del curso o nodo que se va a agregar. NOTA: Esto anula la línea de comandos y la configuración predeterminada introducida en la interfaz de configuración de administración. |
relación | No | Califica el tipo de relación. Siempre debe ser un valor de 1. |
relación.fuentedid | Sí | ID de origen del nodo principal al que se debe asociar el curso o el nodo. |
label | Sí | Describe la relación. NOTA: Aunque este es un campo obligatorio, se puede usar una referencia de elemento vacía si no hay ningún valor para label como se ve en el ejemplo. |