Saltar al contenido principal
pdf?stylesheet=default
Blackboard Help

Formato de datos del archivo de instantánea sin formato

Si ya conoce Instantánea heredada (las herramientas de instantáneas de la línea de comandos), verá que el tipo Archivo sin formato del marco de trabajo SIS no presenta cambios esenciales en el formato, salvo el añadido de los encabezados para los nuevos objetos de datos admitidos y el requisito de incluir unos campos que antes eran opcionales.

Se aplican las mismas reglas de orden para los archivos de instantánea sin formato y para Instantánea heredada: es decir, las fuentes no funcionarán a menos que se cumplan las dependencias. Por ejemplo, una fuente de afiliación no funcionará hasta que no se hayan procesado tanto la fuente del usuario como la fuente del curso que contienen los objetos relacionados con la afiliación, y un curso secundario no se podrá vincular a un curso principal hasta que no se cree el principal.  Esta lógica también se aplica a los períodos y los nodos.

Recuerde que el comportamiento del sistema al procesar los datos publicados en los extremos se puede configurar en la página de edición de la integración.

Puede consultar la descripción completa de las URL y sus funciones en Archivo de instantánea sin formato.

Clientes de ANGEL que se pasan a Learn

Entre los formatos de fuentes de datos de Learn y ANGEL hay algunas diferencias. Estas diferencias se destacan en la ruta de conocimiento de asignación de datos entre ANGEL y Learn.

Conjunto de caracteres aceptables para los datos de integración

El conjunto de caracteres inclusivo y seguro que se usa en los campos de datos principales es:

A-Z a-z 0-9 . ' , " : ! ? $ @ [ ] { }  - _

La contraseña y las claves externas también pueden contener:

% & # < > = \ + /

Los caracteres no permitidos en ningún campo son:

*

Muestras que incluyen campos con datos mínimos

Estas muestras contienen los datos mínimos requeridos para la fuente. Pueden derivarse objetos adicionales por cada fuente de la interfaz de usuario de los encabezados personalizados definidos en la configuración avanzada del archivo de instantánea sin formato del marco de trabajo SIS. La naturaleza requerida de un campo también se puede derivar de la interfaz de usuario Asignación de campos.  Al final de este documento, incluimos una lista completa con descripciones y ejemplos de los valores predeterminados y aceptables para cada objeto. Las URL completas usadas para su instalación se pueden detectar a través de la interfaz de usuario administrativo del marco de trabajo SIS, en Configuración HTTP. Para obtener más información, consulte Archivo de instantánea sin formato.

En los ejemplos siguientes se usa el carácter de barra vertical - '|' - como delimitador. Puede seleccionar el delimitador que quiera al configurar su implementación.

Encontrará muestras de uso de datos más complejas en Ejemplos de archivo de instantánea sin formato.

Usuarios

Tarea: crear o actualizar usuarios (personas)

URL: guardar o actualizar persona

Muestra:

external_person_key|user_id|passwd|firstname|lastname|system_role

testPerson1|aanderson_test|changeme|Alpha|Anderson|none

testPerson2|bbrown_test|changeme|Beta|Brown|none

testPerson3|ccharlie_test|changeme|Chi|Charlie|none

testPerson4|ddavis_test|changeme|Delta|Davis|none

testPerson5|eedwards_test|changeme|Epsilon|Edwards|none

Nota: Aunque el campo del correo electrónico no es obligatorio para crear un usuario, si no se rellena se limitan las capacidades del sistema, como el envío de notificaciones de cursos, etc. 
 

Tarea: eliminar o desactivar usuarios (personas)

URL: eliminar persona

Muestra:

external_person_key

testPerson1
 

Tarea: Fuente de rol de institución secundario de la persona

URL: guardar, actualizar o eliminar rol

Muestra:

external_person_key|role_id

testPerson1|ALUMNI

testPerson1|PROSPECTIVE_STUDENT

testPerson2|ALUMNI
 

Tarea: fuente de asociación de observador con persona

URL: guardar, actualizar o eliminar asociación

Muestra:

external_observer_key|external_user_key

testPerson6|testPerson1

Cursos

Tarea: crear o actualizar cursos nuevos

URL: guardar o actualizar curso

Muestra:

external_course_key|course_id|course_name

testCourse1|TEST_COURSE_1|Test Course 1

testCourse2|TEST_COURSE_2|Test Course 2

testCourse3|TEST_COURSE_3|Test Course 3
 

Tarea: eliminar o desactivar cursos nuevos

URL: eliminar curso

Muestra:

external_course_key

testCourse1

Organizaciones

Tarea: crear o actualizar organizaciones nuevas

URL: guardar o actualizar organizaciones

Muestra:

external_organization_key|organization_id|organization_name

testOrg1|TEST_ORG_1|Test Org 1

testOrg2|TEST_ORG_2|Test Org 2

testOrg3|TEST_ORG_3|Test Org 3
 

Tarea: desactivar organizaciones nuevas

URL: eliminar organizaciones

Muestra:

external_organization_key

testOrg1

Afiliaciones

Tarea: crear o actualizar afiliaciones de curso

URL: guardar o actualizar afiliaciones de curso

Muestra:

external_person_key|external_course_key|role

testPerson1|testCourse1|instructor

testPerson1|testCourse2|student

testPerson2|testCourse1|student

testPerson3|testCourse1|student

testPerson4|testCourse2|instructor

testPerson5|testCourse3|student
 

Tarea: desactivar afiliaciones de curso

URL: eliminar afiliación de curso

Muestra:

external_person_key|external_course_key

testPerson1|testCourse1
 

Tarea: crear o actualizar afiliaciones a organizaciones

URL: guardar o actualizar afiliación a organización

Muestra:

external_person_key|external_organization_key|role

testPerson1|testOrg1|instructor

testPerson1|testOrg2|student

testPerson2|testOrg1|student

testPerson3|testOrg1|student

testPerson4|testOrg2|instructor

testPerson5|testOrg3|student
 

Tarea: desactivar afiliaciones a organizaciones

URL: guardar o actualizar afiliación a organización

Muestra:

external_person_key|external_organization_key|role

testPerson1|testOrg1|instructor

Periodos

Tarea: crear o actualizar períodos

URL: guardar o actualizar período

Muestra:

external_term_key|name

testTerm1|Test Term 1
 

Tarea: desactivar un período

URL: URL para eliminar período

Muestra:

external_term_key

testTerm1

Nodos

Tarea: crear o actualizar nodos

URL: guardar o actualizar nodo

Muestra:

external_node_key|name

testNode1|Test Node 1

testNode2|Test Node 2
 

Tarea: desactivar períodos

URL: eliminar nodo

Muestra:

external_node_key

testNode1

Asociación de nodos

Tarea: crear, actualizar o desactivar un curso en una asociación de nodo

URL: guardar, actualizar o eliminar asociación de curso

Muestra:

external_association_key|external_course_key|external_node_key

testCourseAssociation1|testCourse1|testNode1

testCourseAssociation2|testCourse2|testNode2

Tarea: crear, actualizar o desactivar un usuario en una asociación de nodo

URL: guardar, actualizar o eliminar usuario

Muestra:

external_association_key|external_user_key|external_node_key

testUserAssociation1|testPerson1|testNode1

testUserAssociation2|testPerson2|testNode1

testUserAssociation3|testPerson1|testNode2
 

Tarea: crear, actualizar o desactivar una organización en una fuente de asociación de nodo

URL: guardar, actualizar o eliminar asociación de organización

Muestra:

external_association_key|external_organization_key|external_node_key

testOrgAssociation1|testOrg1|testNode1

testOrgAssociation2|testOrg2|testNode2

 

Compatibilidad con las categorías

Tarea: crear, actualizar o desactivar una fuente de categoría de curso

URL: guardar, actualizar o eliminar categoría de curso

Muestra:

external_category_key|title

testCourseCategory1|Course Category 1

testCourseCategory2|Course Category 2

 

Tarea: crear, actualizar o desactivar una fuente de categoría de organizaciones

URL: guardar, actualizar o eliminar categoría de organizaciones

Muestra:

external_category_key|title

testOrgCategory1|Org Category 1

testOrgCategory2|Org Category 2

 

Tarea: crear, actualizar o desactivar una fuente de afiliación de categoría de curso

URL: guardar, actualizar o eliminar afiliación de categoría de curso

Muestra:

external_course_key|external_category_key|available_ind

testCourse1|testCourseCategory1|Y

testCourse2|testCourseCategory2|Y

testCourse3|testCourseCategory1|Y

 

Tarea: crear, actualizar o desactivar una fuente de afiliación de categoría de organización

URL: guardar, actualizar o eliminar afiliación de categoría de organización

Muestra:

external_organization_key|external_category_key|available_ind

testOrg1|testOrgCategory1|Y

testOrg2|testOrgCategory2|Y

testOrg3|testOrgCategory1|Y

Compatibilidad entre cursos principales y secundarios

Añada el campo ‘master_course_key’ a una fuente de curso cuando quiera establecer una relación principal:secundario.

Nota: Tiene que crear cursos principales para poder asignar relaciones secundarias.                           
 

Tarea: crear una relación principal:secundario entre cursos

URL: guardar o actualizar curso

Muestra:

external_course_key|course_id|course_name|master_course_key

testCourse1|TEST_COURSE_1|Test Course 1|

testCourse2|TEST_COURSE_2|Test Course 2|testCourse1

testCourse3|TEST_COURSE_3|Test Course 3|testCourse1

testCourse4|TEST_COURSE_4|Test Course 4|

testCourse5|TEST_COURSE_5|Test Course 5|testCourse4

En este ejemplo, TEST_COURSE_2 y TEST_COURSE_3 son cursos secundarios del principal TEST_COURSE_1, mientras que TEST_COURSE_4 no está relacionado con este. También puede ejecutar una fuente de curso secundario al margen de una fuente de curso donde todos los cursos tendrían una entrada para la master_course_key apropiada. Use Guardar curso en esta operación para conservar los cursos guardados anteriormente.

Copia/Plantilla de curso

Añada el campo ‘template_course_key’ a la inclusión de fuente de curso cuando quiera que un curso nuevo se rellene con el contenido del curso "Principal". Por ejemplo: todos los cursos nuevos de matemáticas deberían contener, desde el principio, los materiales de un curso principal de matemáticas. 

 

external_course_key|course_id|course_name|master_course_key|template_course_key

testCourse1|TEST_COURSE_1|Test Course 1||test_course_template1

testCourse2|TEST_COURSE_2|Test Course 2|testCourse1|

testCourse3|TEST_COURSE_3|Test Course 3|testCourse1|

testCourse4|TEST_COURSE_4|Test Course 4||test_course_template1

Si quiere más información sobre las copias y las plantillas de cursos, lea Crear cursos mediante la copia de cursos anteriores.