Canvas le permite crear manualmente usuarios, cuentas, períodos, cursos, secciones, inscripciones e inicios de sesión en grandes cantidades a través de la interfaz del Administrador.
Este documento hace referencia a la página API de Formato CSV de las importaciones del SIS donde se encuentra la mayoría de la información CSV. Cada archivo CSV es simbiótico con el otro y le dice a Canvas cómo administrar toda la información de la cuenta. Vea el diagrama de la relación del SIS.
Cada paso en esta lección proporciona archivos CSV de ejemplo con descripciones de cada campo requerido y opcional. También encontrará un enlace para descargar cada archivo si desea revisar el formato de manera más profunda. Descargue un paquete comprimido de todos los archivos de ejemplo. Si los enlaces CSV no se descargan, intente abrir el enlace en una nueva pestaña.
Debe practicar la importación de datos en su entorno de prueba de Canvas antes de importar cualquier contenido a su entorno de producción.
Formato de archivo CSV
Para subir datos en grandes cantidades a Canvas, debe crear uno o más archivos de texto CSV. Los archivos CSV pueden ser generados por muchos programas. Los Sistemas de Información Estudiantil (SIS) a menudo tienen un método para generar informes en formato CSV que pueden ser modificados de acuerdo al formato de Canvas. Si no sabe cómo guardar un archivo en formato CSV, consulte la documentación del programa que está utilizando para crear el archivo CSV (p. ej.: Excel).
Cuando se utiliza el formato de Instructure para importar archivos en la Página de importación del SIS, puede importar un archivo de texto CSV o comprimir varios archivos en un único archivo ZIP para los datos de importación en grandes cantidades. Si está cargando manualmente archivos por separado, debe cargar los archivos en el orden indicado en esta lección.
Formateado de campo CSV
La primera fila de su archivo CSV (encabezado) debe incluir el nombre completo del campo para cada archivo. El orden de las columnas no importa, pero tener las filas ordenadas correctamente es crucial para los archivos como accounts.csv.
Campos adheridos
De manera predeterminada, ciertos cambios realizados en la interfaz de usuario no se sobrescriben con las importaciones del SIS futuras; se dice que están "adheridos". Todos los campos adheridos están identificados en este documento. Puede anular estos campos configurando override_sis_stickiness en la API o marcando la casilla de verificación Anular los cambios UI (Override UI changes) en la página Importación de SIS.
Documentación de API
Los archivos CSV sólo incluyen una serie de campos específicos. Canvas contiene valores adicionales que están disponibles a través de cada API individual. Después de ejecutar los archivos CSV para su institución, la práctica estándar para la mayoría de las instituciones es subir todos los archivos CSV del SIS y luego usar API de Canvas para actualizar los atributos completos del curso y la cuenta. Para más información, vea la documentación de API de Canvas para usuarios, cuentas, términos, cursos, secciones, inscripciones y grupos. Las importaciones de SIS también pueden administrarse mediante el uso de la API de importaciones SIS.
Los usuarios son las personas que tienen cuentas de usuario dentro de una institución. Users.csv agrega personas al sistema como usuarios genéricos. El enrollments.csv asignará un rol (profesor, estudiante, etc.) a estos usuarios. Cuando una cuenta de usuario es eliminada, todas sus inscripciones también se eliminarán y no podrán iniciar sesión en su cuenta de Canvas. Si todavía desea que un usuario tenga acceso pero que no participe o si desea eliminar sólo los de un curso en particular, entonces debería dejar su cuenta de usuario como activos y cambiar su inscripción (en el enrollments.csv) a completado o eliminado, respectivamente.
Descargar un archivo users.csv con 10 cuentas de usuario de Canvas.
Campo obligatorio* | Campo adherido^
Canvas identifica a los usuarios según la dirección de correo electrónico. Cuando se agregan estudiantes a un curso, Canvas intenta resolver cualquier conflicto de la dirección de correo electrónico cuando el usuario primero inicia sesión en el curso.
Normalmente las direcciones de correo electrónico son exclusivas para cada estudiante. A veces varios estudiantes pueden compartir una dirección de correo electrónico única. Cuando agrega estudiantes a los cursos a través de la Importación del SIS, Canvas reconoce cuando una dirección de correo electrónico es asignada a más de un estudiante.
Una cuenta es una unidad de organización dentro de Canvas (por ejemplo, la cuenta del padre para una institución). Cada cuenta puede contener una jerarquía de subcuentas, como la creación de cuentas para colegios profesionales individuales dentro de una institución o las escuelas individuales dentro de un distrito. Las subcuentas también pueden contener múltiples subcuentas, como cuando un colegio profesional se subdivide en departamentos o programas o es subdivido en niveles o materias.
Descargar un archivo de ejemplo accounts.csv con las siguientes subcuentas:
Campo obligatorio* | Campo adherido^
Un término proporciona un conjunto predeterminado de fechas de inicio y término de cualquier curso asignado a ese término. Las fechas del término para cursos se pueden administrar manualmente a nivel de curso sin un archivo de importación. Sin embargo, adjuntar un term_id a muchos cursos diferentes asegura que todos los cursos en ese término comiencen/finalicen al mismo tiempo. Las fechas de término cargadas también le ayudarán a ordenar y organizar cursos al visualizar los datos y los informes en la interfaz del Administrador.
Descargar un archivo de ejemplo terms.csv con 10 términos.
Campo obligatorio* | Campo adherido^
Un curso es una presentación organizada sobre una materia particular. A veces un curso puede incluir una serie de cursos. Los cursos son colocados dentro de los términos para crear fechas de inicio y término predeterminadas. Sin embargo, si estas fechas incluyen fechas del curso específicas, estas fechas anularán las fechas de acceso estudiantil en el término, identificado por el term_id (si está incluido). El valor de adjuntar un term_id le permitirá ordenar y organizar los cursos visualizando datos e informes, en la Interfaz de Administración. Un term_id puede adjuntarse fácilmente a muchos cursos diferentes que se inician/finalizan al mismo tiempo. Si no vincula un curso a un término, entonces el curso estará vinculado al término llamado Término predeterminado.
Si su institución habilitó los Cursos de proyectos, puede usar un archivo courses.csv para añadir los cursos asociados a un curso de proyectos. Tenga en cuenta que el curso de proyectos debe crearse y habilitarse como curso de proyectos antes de poder añadir los cursos asociados.
Descargue una muestra de un archivo courses.csv con 10 cursos; estos se ubican dentro de sus subcuentas respectivas con un término específico.
Campo obligatorio* | Campo adherido^
Una sección subdivide a los estudiantes dentro de un curso. Las secciones múltiples pueden también cruzarse en un curso, sobre todo si todas las secciones del estudiante están aprendiendo el mismo material del curso. Las secciones múltiples pueden ser colocadas en un curso, pero una sección no puede contener varias secciones. Las secciones heredan las fechas del curso según lo establecido por el término. Sin embargo, si una sección incluye fechas específicas, estas fechas anularán las fechas de acceso del estudiante para el curso y las fechas de comienzo/ finalización del término.
Si intenta eliminar un curso y los usuarios están asociados a las secciones, debe incluir el parámetro section_id en la importación CSV, así como la sección de IDs del SIS.
Descargue una muestra de un archivo sections.csv con las siguientes secciones:
Este archivo supone que usted puede tener varias secciones dentro de un curso. Muchas instituciones importan secciones del curso como cursos independientes. Esto puede realizarse al (1) crear un curso de Canvas para cada sección en su courses.csv, luego (2) crear una sola sección en cada uno de estos cursos. Usted puede usar esencialmente los mismos datos para el curso y sección, e incluir la identificación de SIS que será la misma para course_id y section_id.
Campo obligatorio* | Campo adherido^
Una inscripción es un usuario que ha sido inscrito en un curso bajo un papel específico. Un enrollments.csv le permite asignar roles a los usuarios y colocarlos en los cursos apropiados. Cuando el estado de la inscripción de cualquier usuario está marcado como completado, se limita al acceso de sólo lectura para ese curso.
Descargar un archivo ejemplo de enrollments.csv con las siguientes inscripciones:
Campo obligatorio*
Las categorías de grupo le permiten organizar los grupos en Canvas. Un group_categories.csv le permite crear categorías de grupo a nivel de cuenta o de curso. En la interfaz de usuario, las categorías de grupo se llaman conjuntos de grupo.
Descargue una muestra de un archivo group_categories.csv con las siguientes categorías de grupo:
Campo obligatorio* | Campo adherido^
Un grupo puede utilizarse para proporcionar oportunidades de colaboración para los estudiantes, los instructores, los administradores u otros usuarios. Un groups.csv le permite crear grupos a nivel del curso y a nivel de la cuenta. Grupos cargados vía SIS pueden ser actualizados o eliminados vía SIS.
Descargue una muestra de un archivo groups.csv con los siguientes grupos:
Campo obligatorio* | Campo adherido^
Pertenecer a un grupo permite que los usuarios colaboren en actividades en Canvas. Un groups_membership.csv le permite agregar o quitar personas en grandes cantidades en un grupo que haya creado a través de groups.csv.
Descargue una muestra de groups_membership.csv con la siguiente membresía de grupos:
Campo obligatorio*
Hacer un listado en otros lugares le permite mover secciones a otro curso. Un archivo de xlist.csv le permite hacer un listado cruzado de las secciones en los cursos existentes y crear una jerarquía de sección.
Se espera que ya exista el ID de la sección y que ya se permitan referencias a otros ids del curso. Si se proporciona una id de sección en este archivo, se trasladará del curso existente a un nuevo id del curso, es decir, si se quita ese nuevo curso o el listado cruzado, la sección volverá a su id de curso anterior. Si xlist_course_id no hace referencia a un curso existente, será creado. Si desea proporcionar más información sobre el curso del listado cruzado, por favor hágalo en courses.csv.
Descargue una muestra de un archivo xlists.csv con los siguientes cursos y secciones:
Campo obligatorio*
El papel de observador puede ser usado para inscribir a los padres y vincularlos a un estudiante, permitiéndoles ver las calificaciones de los estudiantes y las interacciones del curso. Un user_observers.csv le permite inscribir y enlazar observadores a cada una de las inscripciones del estudiante designado.
Descargue un archivo de muestra de user_observers.csv con las siguientes inscripciones:
Campo obligatorio*
El archivo logins.csv le permite crear o actualizar las credenciales de inicio de sesión de los usuarios. Solo se pueden agregar inicios de sesión para los usuarios existentes. Los inicios de sesión se pueden eliminar utilizando users.csv.
Descargar un archivo logins.csv de muestra con tres inicios de sesión del usuario.
Campo obligatorio* | Campo adherido^
Notas:
Los administradores gestionan las configuraciones para una cuenta o subcuenta completa. Un archivo admins.csv le permite designar usuarios en Canvas como administradores de cuentas u otros roles de cuenta o subcuenta personalizados.
Descargue una muestra de un archivo admins.csv con los siguientes administradores:
Campo obligatorio*
Una identificación de SIS es un identificador único para un objeto en Canvas. Un archivo change_sis_id.csv le permite acumular las identificaciones de SIS para cuentas, términos, cursos, secciones, grupos o usuarios existentes.
Descargue una muestra de un archivo change_sis_id.csv con los siguientes cambios de ID de SIS:
Campo obligatorio*