Formato de datos de archivo plano de instantánea

Si está familiarizado con las instantáneas anteriores (las herramientas de instantáneas de la línea de comandos), verá que el tipo de archivo sin formato del marco de trabajo SIS no presenta cambios esenciales en el formato, salvo la adición de los encabezados para los nuevos objetos de datos compatibles 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.

Clientes ANGEL que se cambian a Blackboard

Existen diferencias entre los formatos de fuente de datos Blackboard y ANGEL. Estas diferencias se mencionan en la ruta de conocimiento de mapeo de datos de ANGEL a BLACKBOARD.

Conjunto de caracteres aceptables para los datos de la integración

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

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

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

% & # < > = \ + /

Ejemplos que utilizan campos de 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.

Para obtener ejemplos de uso de datos más complejos, consulte Ejemplos de archivos planos de instantáneas.

Usuarios

Tarea: Crear/actualizar usuarios (personas)

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

Tarea: Eliminar/deshabilitar usuarios (Personas)

URL: Eliminación de persona

Muestra:

external_person_key

testPerson1

Tarea: Fuente de roles de institución secundaria de persona

URL: Almacén de roles/Actualizar/Eliminar

Muestra:

external_person_key|role_id

testPerson1|ALUMNI

testPerson1|PROSPECTIVE_STUDENT

testPerson2|ALUMNI

Tarea: Fuente de asociación de persona a observador

URL: Almacén de asociaciones/Actualizar/Eliminar

Muestra:

external_observer_key|external_user_key

testPerson6|testPerson1

Cursos

Tarea: Crear/Actualizar nuevos Cursos

URL: Tienda o actualización del 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: Determinar la vista de curso nuevo

URL: Tienda o actualización del curso

Muestra:

external_course_key|course_id|course_name|course_experience

testCourse1|TEST_COURSE_1|Test Course 1|Original

testCourse2|TEST_COURSE_2|Test Course 2|Ultra

testCourse3|TEST_COURSE_3|Test Course 3|Instructor choice

Los valores admitidos son: Original, Ultra o Elección del profesor. Estos valores son solo de inserción, y no se pueden actualizar a través del marco de trabajo SIS.

Tarea: Eliminar/deshabilitar nuevos cursos

URL: Eliminación de cursos

Muestra:

external_course_key

cursoDePrueba1

Agregue el campo template_course_key a la inclusión del archivo de fuente del curso cuando quiera que un curso nuevo se complete 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.

Organizaciones

Tarea: Crear/Actualizar nuevas Organizaciones

URL: Organizaciones Almacenar o actualizar

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: Deshabilitar nuevas organizaciones

URL: Eliminar organizaciones

Muestra:

external_organization_key

testOrg1

Membresías

Tarea: Crear/actualizar membresías de cursos

URL: Tienda o actualización de membresía del 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: Deshabilitar las membresías del curso

URL: Eliminación de membresía del curso

Muestra:

external_person_key|external_course_key

testPerson1|testCourse1

Tarea: Crear/actualizar membresías de organización

URL: Tienda de pertenencia a la organización o actualizació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: Deshabilitar membresías de organización

URL: Tienda de pertenencia a la organización o actualización

Muestra:

external_person_key|external_organization_key|role

testPerson1|testOrg1|instructor

Períodos

Tarea: Crear/actualizar términos

URL: Almacén de términos o actualización

Muestra:

external_term_key|name

testTerm1|Test Term 1

Tarea: Deshabilitar un término

URL: URL de eliminación de términos

Muestra:

external_term_key

testTerm1

Nodos

Tarea: Crear/actualizar nodos

URL: Almacén de nodos o actualización

Muestra:

external_node_key|name

testNode1|Test Node 1

testNode2|Test Node 2

Tarea: Deshabilitar términos

URL: Eliminación de nodo

Muestra:

external_node_key

testNode1

Asociación de nodos

Tarea: Crear/Actualizar/deshabilitar la asociación de curso a nodo

URL: Almacén de asociación de cursos / Actualizar / eliminar

Muestra:

external_association_key|external_course_key|external_node_key

testCourseAssociation1|testCourse1|testNode1

testCourseAssociation2|testCourse2|testNode2

Tarea: Crear/Actualizar/Deshabilitar la asociación de usuario a nodo

URL: Almacén de asociación de usuarios/Actualizar/Eliminar

Muestra:

external_association_key|external_user_key|external_node_key

testUserAssociation1|testPerson1|testNode1

testUserAssociation2|testPerson2|testNode1

testUserAssociation3|testPerson1|testNode2

Tarea: Crear/Actualizar/deshabilitar la organización en la fuente de asociación de nodos

URL: Almacén de asociación de la organización / Actualizar / Eliminar

Muestra:

external_association_key|external_organization_key|external_node_key

testOrgAssociation1|testOrg1|testNode1

testOrgAssociation2|testOrg2|testNode2

Compatibilidad con las categorías

Tarea: Crear/Actualizar/Deshabilitar el feed de categorías de cursos

URL: Categoría del curso Almacenar/Actualizar/Eliminar

Muestra:

external_category_key|title

testCourseCategory1|Course Category 1

testCourseCategory2|Course Category 2

Tarea: Crear/Actualizar/Deshabilitar Feed de Categorías de Organizaciones

URL: Organizaciones Categoría Almacenar/Actualizar/Eliminar

Muestra:

external_category_key|title

testOrgCategory1|Categoría de organización 1

testOrgCategory2|Categoría de organización 2

Tarea: Crear/Actualizar/Deshabilitar la Fuente de Membresía de Categoría de Curso

URL: Categoría del curso Membresía Almacenar/Actualizar/Eliminar

Muestra:

external_course_key|external_category_key|available_ind

testCourse1|testCourseCategory1|Y

testCourse2|testCourseCategory2|Y

testCourse3|testCourseCategory1|Y

Tarea: Crear/Actualizar/Deshabilitar Fuente de pertenencia a categoría de organización

URL: Categoría de organización Almacén de pertenencia/Actualizar/Eliminar

Muestra:

external_organization_key|external_category_key|available_ind

testOrg1|testOrgCategory1|Y

testOrg2|testOrgCategory2|Y

testOrg3|testOrgCategory1|Y

Manutención de los padres y los hijos

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

Tarea: Crear una relación padre-hijo entre cursos

URL: Tienda de cursos/Actualizar

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 del curso

Agregue el campo "template_course_key" a la inclusión de la fuente del curso cuando quiera que un curso nuevo se rellene con el contenido del curso principal. Por ejemplo: todos los nuevos cursos de matemáticas deben contener inicialmente los materiales de un curso maestro de matemáticas.

Muestra:

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

Aprende más