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.

Para obtener una descripción completa de las URL y sus funciones, consulte 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 la 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:

% & # < > = \ + /

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 archivos de instantánea sin formato.

Usuarios

Tarea: crear o actualizar usuarios (personas)

URL: guardar o actualizar personas

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

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 deshabilitar usuarios (personas)

URL: eliminar personas

Muestra:

external_person_key
testPerson1

Tarea: fuente de rol institucional secundario de la persona

URL: guardar, actualizar o eliminar roles

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 cursos

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

URL: guardar o actualizar cursos

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

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

Tarea: eliminar o deshabilitar cursos nuevos

URL: eliminar cursos

Muestra:

external_course_key
testCourse1

Agregue el campo template_course_key al archivo de fuente del curso cuando quiera que se complete un curso nuevo 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 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: deshabilitar organizaciones nuevas

URL: eliminar organizaciones

Muestra:

external_organization_key
testOrg1

Afiliaciones

Tarea: crear o actualizar afiliaciones a cursos

URL: guardar o actualizar afiliaciones a cursos

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 afiliaciones a cursos

URL: eliminar afiliación al 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: deshabilitar 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íodos

Muestra:

external_term_key|name
testTerm1|Test Term 1

Tarea: deshabilitar un período

URL: URL para eliminar período

Muestra:

external_term_key
testTerm1

Nodos

Tarea: crear o actualizar nodos

URL: guardar o actualizar nodos

Muestra:

external_node_key|name
testNode1|Test Node 1
testNode2|Test Node 2

Tarea: deshabilitar períodos

URL: eliminar nodo

Muestra:

external_node_key
testNode1

Asociaciones de nodos

Tarea: crear, actualizar o deshabilitar una asociación de curso y 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 asociación de usuario

Muestra:

external_association_key|external_user_key|external_node_key
testUserAssociation1|testPerson1|testNode1
testUserAssociation2|testPerson2|testNode1
testUserAssociation3|testPerson1|testNode2+

Tarea: crear, actualizar o deshabilitar una fuente de asociación de organización y 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 deshabilitar 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 deshabilitar 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 los cursos principales y secundarios

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

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 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 cursos nuevos de matemáticas deberían contener, desde el principio, los materiales deun curso principal 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

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

Más información

Descripciones del encabezado del archivo de instantánea sin formato