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