Saltar al contenido principal
pdf?stylesheet=default
Blackboard Help

Archivos de fuentes SIS

Los datos que se introducen en Blackboard Learn para, por ejemplo, crear usuarios, cursos o actualizar registros, existen en un "archivo de fuentes". Los archivos de fuentes de instantánea pueden ser archivos sin formato delimitados por caracteres o archivos XML que cumplan los estándares de IMS. Blackboard se adhiere a los estándares de codificación XML de la comunidad global, que normalmente utiliza UTF–8. En este tema se repasa en detalle el formato de archivos de instantánea sin formato y se incluye un enlace para obtener más información sobre los estándares de IMS en relación con los archivos XML. Para obtener una lista completa de encabezados de archivos de fuentes y tipos de objeto, consulte Tipos de objetos y encabezados de archivos de fuentes SIS.

En la versión 9.1 de Blackboard Learn, SP9, cualquier operación de fuentes de integración SIS que cree o edite un objeto (cualquier operación de fuentes SIS que no sea de eliminación) debería "activar" los objetos (cursos, usuarios y demás) de las fuentes, a menos que la fuente indique específicamente que el objeto debería "desactivarse".

Para aceptar información multibyte, los archivos deben estar en formato Unicode. Todos los archivos con formato Unicode deben incluir la Marca de Orden Bytes (BOM, Byte Order Mark). Si esta marca no se especifica, el sistema lo lee como ISO-8859-1. Los formatos compatibles son los siguientes:

  • UTF-8
  • UTF-16LE
  • UTF-16BE
  • ISO -8859-1

ASCII también es un formato compatible, ya que es un subconjunto de ISO-8859-1.

Delimitadores y caracteres de espacio

La información en este tema solo es aplicable en las fuentes de línea de comandos. La actualización del archivo de propiedades no afecta a nada en la interfaz de usuario de la integración SIS en Blackboard Learn.

Para que los datos procedentes de un archivo de fuentes se analicen correctamente, la instantánea necesita saber dónde finalizan los datos de cada campo. Un carácter que no aparece a menudo en los datos se selecciona normalmente como el "delimitador" (el carácter que separa un campo de otro dentro de una fila). El carácter de barra vertical ( | ) es el delimitador predeterminado en el archivo de propiedades.

De vez en cuando, el delimitador puede aparecer en los datos. A menos que el sistema sepa que esta aparición concreta del delimitador forma parte de los datos y que no denota la división de un campo, el archivo de fuentes dará error o contendrá errores. Para indicar al sistema que un determinado delimitador forma parte del conjunto de datos, habrá que marcarlo como carácter de escape.

Para marcar un delimitador, se define un carácter de escape en el archivo de propiedades. El carácter ( / ) es el carácter de escape predeterminado.

Cómo cambiar el delimitador

Para cambiar el carácter delimitador predeterminado, edite el archivo de propiedades. Cualquier carácter SQL puede ser usado como delimitador. Busque la línea del archivo de propiedades que indica:

# delimiter used for parsing snapshot files
data.delimiter=|

Cambie el carácter de la derecha del signo igual ( = ) por el carácter que desee. Si este carácter aparece en un campo de datos, deberá marcarse como carácter de escape en cada campo en el que aparezca. Por este motivo, seleccionar un carácter que pueda aparecer habitualmente en los campos de datos.

Cómo cambiar el carácter de escape

Para cambiar el carácter de escape predeterminado, edite el archivo de propiedades. Busque la línea del archivo de propiedades que indica:

# Determines character used to escape delimiter
escape.character=/

Cambie el carácter de la derecha del signo igual ( = ) por el carácter que desee. Este carácter precederá a cualquier carácter de delimitador que aparezca en los campos de datos. Por ejemplo, si el guión ( - ) se ha configurado como delimitador, cada vez que aparezca un guión en un campo de datos habría que marcarlo como carácter de escape colocando el carácter ( / ) antes de él.

Ejemplo:

En el ejemplo a continuación el apellido es Smith-Jones, por lo que el guión del apellido debe marcarse con el carácter de escape:

EXTERNAL_PERSON_KEY-USER_ID-SYSTEM_ROLE-FIRSTNAME-LASTNAME-EMAIL-INSTITUTION_ROLE
2000-jsmithjones100-none-John-Smith/...ng.com-Student

Formato de archivo de instantánea sin formato del archivo de fuentes

El archivo de instantánea de fuentes puede ser un archivo "sin formato", que es otro término para definir un archivo de texto delimitado. Un archivo de fuentes puede incluir información sobre cualquiera de las 10 entidades que se transfieren a Blackboard Learn. Un archivo de fuentes consta de una fila de encabezado que identifica a cada una de las columnas o campos, seguida de una o más filas de registros de datos.

Fila de encabezado

La fila de encabezado de un archivo de fuentes contiene nombres de campos, es decir, los nombres exactos de los campos incluidos en el archivo. Estos nombres se enumeran en las tablas de los temas de archivos de fuentes, empezando por  Elementos de fuentes de categorías. Los campos de encabezado están delimitados con el mismo carácter que los registros de datos.

Los campos pueden aparecer en la fila de encabezado en cualquier orden, pero no se pueden incluir los campos que Blackboard Learn no reconozca. De lo contrario, el archivo producirá un error o contendrá errores.

Nota:  Los archivos de fuentes de instantánea funcionan en entornos de sistema operativo de derecha a izquierda y viceversa. El orden de los campos del encabezado no es importante, solo lo es que coincida con el orden de las filas de datos. El delimitador de archivos de fuentes de instantánea utilizado en entornos de derecha a izquierda debe ser una tabulación. La barra vertical ( | ) usada habitualmente puede provocar que algunos campos inviertan el orden, desalineando así la fila de encabezado y las filas de datos.

Todos los tipos de archivo de fuentes tienen un número mínimo de campos obligatorios que deben estar identificados en la fila de encabezado.

Los campos obligatorios mínimos de un archivo de fuentes de usuario son:

  • EXTERNAL_PERSON_KEY
  • USER_ID
  • SYSTEM_ROLE
  • FIRSTNAME
  • LASTNAME
  • EMAIL
  • INSTITUTION_ROLE

Los campos obligatorios mínimos de un archivo de introducción de curso u organización son:

  • COURSE_ID
  • EXTERNAL_COURSE_KEY
  • COURSE_NAME

Los campos obligatorios mínimos de un archivo de introducción de inscripciones o alumnos son:

  • EXTERNAL_COURSE_KEY
  • EXTERNAL_PERSON_KEY
  • ROLE

Fila de encabezado para un archivo de fuentes de usuario

EXTERNAL_PERSON_KEY|USER_ID|SYSTEM_ROLE|FIRSTNAME|LASTNAME|EMAIL|INSTITUTION_ROLE

Filas de datos

Después de la fila de encabezado se añaden los registros de datos, uno por línea, al archivo de fuentes. Los registros se separan por un retorno de carro, un salto de línea, o la combinación de ambos. El separador de registros no se puede configurar.

Algunos elementos del archivo de fuentes tienen conjuntos de constantes de cadenas para sus posibles valores. Por ejemplo, el atributo Institution_Role indica caracteres codificados en la base de datos.

Durante la operación no se modifica la información no facilitada (que se deja en blanco) para los campos incluidos en el encabezado. Excepciones:

  1. Si el campo de contraseña es nulo, la ID del usuario se establecerá como contraseña. Para borrar un campo, introduzca un único espacio.
  2. Para borrar el campo de correo electrónico, introduzca un único símbolo @, ya que es obligatorio. Si el campo de dirección de correo electrónico se deja en blanco, aparecerá el error siguiente: "(!)El valor especificado no es válido: Correo electrónico. Revisar documentación".

Todos los campos del archivo de fuentes que no se encuentren en los temas del archivo de fuentes, empezando por  Elementos de fuentes de categorías, serán ignorados.

Los datos incluidos en cada registro deben ser acordes a los valores aceptables para Blackboard Learn. Para ver los valores aceptables en cada campo, consulte los temas sobre el archivo de fuentes, empezando por  Elementos de fuentes de categorías.

Nota:  El delimitador de todos los archivos de fuentes de instantánea utilizado en entornos de derecha a izquierda debe ser una tabulación. La barra vertical ( | ) usada habitualmente puede provocar que algunos campos inviertan el orden. El orden de los campo de datos en las filas de datos debe coincidir con el orden de los campos en la fila de encabezado. Asimismo, todos los datos que se introduzcan con orientación combinada (es decir, que se incluya en el mismo archivo texto formateado de izquierda a derecha y texto formateado de derecha a izquierda), provocarán que la operación dé error o que los datos contengan errores.

Ejemplo: Las filas de datos en un archivo delimitado de fuentes de usuario

EXTERNAL_PERSON_KEY|USER_ID|SYSTEM_ROLE|FIRSTNAME|LASTNAME|EMAIL|INSTITUTION_ROLE
2000|jsmith001|none|John|Smith1|jsmi...university.edu|Student
2001|kthomas001|none|Kyle|Thomas2|kt...university.edu|Student
2002|ttsai001|none|Tevis|Tsai|ttsai...university.edu|Student
2003|lgonzales001|none|Lois|Gonzales...university.edu|Student
2004|mmacneil001|none|Megan|MacNeil|...university.edu|Student
2005|mmacneil002|none|Mark|MacNeil|m...university.edu|Student
2006|ddishez001|none|Dan|Dishez|ddis...university.edu|Student
2007|rrondelle001|none|Ronda|Rondell...university.edu|Student
2008|jsmith002|none|John|Smith2|jsmi...university.edu|Student

Archivo de eliminación de registros

Un archivo de "eliminación de registros" será el formato de archivo utilizado para borrar datos no deseados de Blackboard Learn, y puede englobar información sobre cualquiera de las diez entidades que se van a transferir a la base de datos de Blackboard. El archivo solo necesita incluir determinados campos clave para eliminar registros de datos de Blackboard Learn. Si desea ver una lista de los campos obligatorios para cada tipo de entidad, consulte los temas sobre el archivo de fuentes, empezando por Elementos de fuentes de categorías. El formato del archivo de eliminación de registros es el siguiente:

Encabezado: Nombres de archivo. Son los nombres exactos de los campos incluidos en el archivo.

Ejemplo: (Afiliación)

EXTERNAL_COURSE_KEY|EXTERNAL_PERSON_KEY
Math101.1.Fall1999|1074202|course_builder
History176.6.Spring2000|324-765-0098|Instructor
Chem401.1.Fall1999|uberk1278|Student

Datos no válidos

Los datos con formato incorrecto se gestionan del modo siguiente:

  • Las cadenas que excedan la longitud máxima especificada para la columna se truncarán. Las claves de origen de datos que excedan la longitud máxima especificada para la columna provocarán un error en el registro.
  • Los tipos de datos que no se puedan convertir (por ejemplo, fechas), se ignorarán. Se tratarán como un espacio o como no presentes.
  • Los encabezados de columna no válidos se ignorarán.

Nota:  Los elementos no compatibles del archivo de fuentes no provocarán un error del archivo, sino que se ignorarán para conservar la compatibilidad retrógrada con anteriores generadores de archivos de fuentes.

Formato de archivo de instantánea XML del archivo de fuentes

En comparación con un archivo de fuentes sin formato, el archivo de instantánea XML ha incrementado su flexibilidad en tanto que los archivos XML pueden procesar un tipo de datos a la vez, o combinar varios tipos de datos para procesarlos al mismo tiempo. A pesar de que Blackboard Learn no efectúa una validación frente al diccionario de datos XML definido en la sección   Tablas de formato de datos para archivos XML, el código debe tener un formato correcto, lo que significa que cada etiqueta anidada debe cerrarse correctamente.

La herramienta Instantánea procesará los archivos XML compatibles con IMS, versión 1.01. Si desea información sobre los estándares de IMS en relación a archivos XML, consulte la siguiente página del sitio de IMS: http://www.imsproject.org/enterprise/enbind03.html

Como las entidades del archivo XML están escritas, no existen requisitos específicos para separar las entidades en archivos de fuentes independientes. No obstante, se ignoran los atributos de acción y origen de datos especificados en el estándar de IMS. Durante el procesamiento del formato XML de IMS, la herramienta Instantánea de Blackboard Learn exige la misma lógica y flujo de trabajo que los usados con un archivo sin formato.

Etiquetas de plantillas XML

La información siguiente hace referencia a etiquetas específicas en la plantilla XML:

  • Etiquetas de extensión: estas etiquetas no son compatibles con las especificaciones de IMS; solo son compatibles con Blackboard Learn. Debido a que el proyecto IMS las adopta, Blackboard las incluirá por etapas en la definición XML adecuada.
  • Categorías y afiliaciones a categorías: no son tipos de datos IMS y no son admitidos por IMS; son compatibles con Blackboard Learn.

Los consejos siguientes son útiles para solucionar problemas de archivos XML de instantánea:

  • Si un usuario no se crea en un archivo XML, su afiliación tampoco podrá llevarse a cabo. Muchos de los aspectos del archivo XML están relacionados. Por tanto, si un área falla, puede hacer que el resto fallen también.
  • Blackboard recomienda usar un visor de XML para ver el archivo .invalid (registro de errores). En caso de que se produzca un error, debería consultarse este archivo.

Ejemplo de archivo de fuentes XML

Por ejemplo para un archivo de fuentes XML, consulte Tablas de formato de datos para archivos XML.