¿Cómo formateo los archivos de texto CSV para subir datos del SIS a una cuenta de Canvas?

Canvas le permite importar archivos CSV para 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.

Archivos de ejemplo

Cada paso en esta lección proporciona detalles sobre los archivos CSV de ejemplo y descripciones de cada campo requerido y opcional. Cada paso también incluye un enlace para descargar un archivo CSV de ejemplo. Los archivos de ejemplo contienen todos los campos requeridos y también pueden tener campos opcionales. Además, puede descargar 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 solo 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.

users.csv users.csv

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 archivo 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 solo 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^

  • user_id*: Es un valor único usado para identificar a alguien con una cuenta en Canvas. Este valor no debe cambiar para el usuario y debe ser único entre todos los usuarios. En la interfaz de usuario, esto se llama ID del SIS y puede estar compuesto por cualquier combinación de caracteres. Puede encontrar este ID del SIS visitando cualquier cuenta de usuario y luego revisando en su Información de inicio de sesión (Login Information).
  • integration_id: Este es un identificador único secundario útil para integraciones más complejas del SIS. Este identificador no debe cambiar para el usuario y debe ser único en el mundo
  • login_id*^: Este es el nombre de usuario que se utilizará para iniciar sesión en Canvas. Si tiene un servicio de autenticación configurado (como LDAP), por lo general, coincidirá con su nombre de usuario en el sistema remoto. Login_id puede contener letras, números o los siguientes caracteres de símbolo:  - _ = + . @
  • password:  Si la cuenta está configurada para usar LDAP o un protocolo SSO, entonces esto no es necesario. De lo contrario, esto es la contraseña para el 'login_id' anterior. Esta contraseña debe tener al menos 8 caracteres.
  • ssha_password: En lugar de una contraseña de texto sin formato, puede pasar una contraseña previamente hash mediante el esquema de generación de contraseña SSHA en este campo. Si bien es mejor que pasar una contraseña de texto sin formato, debe pedir a los usuarios que cambien su contraseña después de iniciar sesión por primera vez. Aprenda a generar contraseñas SSHA.
  • authentication_provider_id: Este es el proveedor de autenticación con el que la información de inicio de sesión está asociada. La información de inicio de sesión asociada con un proveedor específico solo puede ser utilizada con ese proveedor. Los proveedores heredados (LDAP, CAS, SAML) buscarán información de inicio de sesión asociada con ellos o información de inicio de sesión sin ninguna asociación. Los nuevos proveedores solo buscarán información de inicio de sesión explícitamente asociada con ellos. Esto puede ser la ID del proveedor en números enteros o el tipo de proveedor (en cuyo caso encontrará al primer proveedor que coincida).  
  • first_name^:  Es el nombre (primer nombre) del usuario. Si está presente, se utiliza para construir full_name o sortable_name.
  • last_name^:  Es el apellido del usuario. Si está presente, se utiliza para construir full_name o sortable_name.
  • full_name^: Es el primer nombre y apellidos del usuario. Omitir first_name y last_name si se proporciona.
  • sortable_name^: Esta es la opción clasificable del nombre en Canvas. Generalmente, se obtiene del nombre del usuario, pero se puede modificar para requisitos particulares.
  • short_name^: Este es el nombre en pantalla del usuario que, por lo general, se obtiene del nombre del usuario pero se puede personalizar.
  • email:  Esta es la dirección de correo electrónico asignada por institución y también se marcará como la dirección de correo electrónico predeterminada para esta cuenta de usuario. Esta dirección de correo electrónico debe proporcionarse incluso si es la misma que el login_id del usuario.
  • pronouns: Si los pronombres personales están habilitados, se trata de los pronombres personales que se muestran después del nombre del usuario en Canvas. En el campo de pronombres se aceptan todos los pronombres, incluso si no se los creó en la página Configuraciones de la cuenta.
  • declared_user_type: Este tipo de usuario declarado puede ser administrativo, observador, personal, estudiante, student_other o profesor. Puede ingresar "<delete>" para eliminar el tipo de usuario declarado del usuario.
  • canvas_password_notification: El valor predeterminado es falso. Cuando es verdadero, se notifica al usuario la configuración de la contraseña si authentication_provider_id es Canvas. Si su institución no tiene una integración Canvas-SIS, este campo es obligatorio para notificar a los nuevos usuarios sobre sus cuentas creadas.
  • home_account: Si se establece home_account como verdadero, se creará un nuevo usuario en la cuenta de destino para la importación de SIS y se fusionará con otro usuario existente de otra cuenta dentro del consorcio con un integration_id coincidente. Se ignorará a menos que la cuenta de destino esté asociada a un consorcio de fusión automática.
  • status*^:  Es donde usted puede agregar o eliminar un usuario de Canvas. Marque como activo para agregar un usuario, como suspendido para suspender un usuario o como eliminado para quitar un usuario existente.

Conflictos de la dirección de correo electrónico

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.

  • Si un nuevo ID del SIS está asociado con una dirección de correo electrónico ya asignada a un ID existente del SIS, Canvas envía un correo electrónico a la dirección de correo electrónico.
  • Cuando los usuarios son agregados a una cuenta a través de la Importación del SIS, no recibirán una notificación por correo electrónico a menos que el sistema detecte un usuario duplicado. Sin embargo, si un usuario es añadido o inscrito manualmente, recibirá un correo electrónico notificándole que ha sido agregado o inscrito en un curso nuevo. El estudiante que comparte una dirección de correo electrónico recibirá una notificación diciendo que la dirección de correo electrónico ya está en uso y que debe crear una nueva cuenta en Canvas. Este proceso también puede ser usado al agregar un usuario a una matrícula de curso.

accounts.csv

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:

  • 3 subcuentas dentro de su cuenta principal/raíz. (Artes y Humanidades, Negocios, Matemáticas y Ciencias)
  • 4 subcuentas dentro de la subcuenta de su negocio. (Contabilidad, Informática, Economía y Marketing)
  • 3 subcuentas dentro la subcuenta de Matemáticas y Ciencias. (Biología, Física y Estadística)
  • 1 subcuenta dentro de la subcuenta de Artes y Humanidades. (Artes Visuales)
  • 2 subcuentas dentro de la subcuenta de Artes visuales. (Fotografía y Medios Digitales)

Campo obligatorio* | Campo adherido^

  • account_id*:  Es un identificador único utilizado para crear una subcuenta. El archivo courses.csv le permitirá asignar cursos a una id de cuenta en particular. Este identificador único no debe ser cambiado para la cuenta y debe ser universalmente único a través de todas las cuentas. En la interfaz de usuario de Canvas, esto se llama ID del SIS y puede modificarse en Configuraciones para cada subcuenta respectiva.
  • parent_account_id*^: Este identificador indica que una subcuenta debe estar anidada bajo esta cuenta padre. Si este campo está en blanco, entonces la subcuenta se pueden anidar bajo su cuenta principal o raíz. Tenga en cuenta que incluso si todos los valores están en blanco, la columna debe incluirse para distinguir el archivo de la importación de un grupo.
  • name*^:  Es el nombre de la subcuenta.
  • status*: Es cómo puede crear o eliminar una subcuenta. Marque como activo para agregar una subcuenta o eliminado para eliminar una subcuenta existente.
  • integration_id: Este es un identificador único secundario útil para integraciones más complejas del SIS. Este identificador no debe cambiar para la cuenta y debe ser único universalmente.

terms.csv

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^

  • term_id*:  Es un identificador único para el término. El archivo courses.csv le permitirá hacer referencia a este term_id para que sus cursos comiencen y finalicen automáticamente. Este identificador no debe cambiar para el término y debe ser único universalmente a través de todos los términos. En la interfaz de usuario, esto se llama identificación de SIS.
  • nombre*^:  Es el nombre de su término. Idee una buena convención de nomenclatura para que le sirva para hacer referencia a sus términos fácilmente.  Existen muchas herramientas de administrador que permiten la búsqueda o consulta de datos por el nombre del término.
  • status*:  Es cómo se puede crear o eliminar un término. Marque activo para agregar un término o eliminado para eliminar un término existente.
  • start_date^:  Es la fecha en que comienza el período. Debe expresarse en el formato ISO 8601: AAAA-MM-DDTHH:MM:SS (la T puede reemplazarse por un espacio, como se ve en la captura de pantalla de ejemplo.) Por ejemplo, 26 de agosto de 2013 a las 5:00 p. m. EST se escribiría 2013-08-26T17:00-5:00.
  • end_date^:  Es la fecha en que el término finaliza. Debe expresarse en el formato ISO 8601: AAAA-MM-DDT HH:MM:SS (la T puede reemplazarse por un espacio, como se ve en la captura de pantalla de ejemplo). De forma predeterminada, el acceso de los usuarios se corta a la medianoche en la fecha final indicada, lo que significa que el día anterior es el último día completo en el que los usuarios tienen acceso al término. El mejor método es establecer su fecha de finalización el día después de que el término finaliza.
  • integration_id: Este es un identificador único secundario útil para integraciones más complejas del SIS. Este identificador no debe cambiar para el término y debe ser único universalmente.
  • date_override_enrollment_type: Esto le permite fijar o eliminar fechas de inicio y finalización para tipos de inscripción específicos dentro de un período existente. Cuando se fija, todas las columnas salvo term_id, status, start_date y end_date se ignoran para la fila. Si el estado es activo, las fechas del período solo se aplicarán a las inscripciones del tipo dado. Si el estado es eliminado, las fechas fijadas actualmente serán eliminadas para el tipo de inscripción dado. El tipo de inscripción puede fijarse en StudentEnrollment, TeacherEnrollment, TaEnrollment o DesignerEnrollment.

courses.csv

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^

  • course_id*:  Es un identificador único utilizado para diferenciar cursos dentro de Canvas. Este identificador no debe cambiar para el curso y debe ser único universalmente a través de todos los cursos. En la interfaz de usuario, esto se llama identificación de SIS.
  • short_name*^:  Es un nombre corto para el curso. En la interfaz de usuario de Canvas, esto se llama el Código del curso (Course Code) o Código de referencia (Reference Code).
  • long_name*^:  Es un largo nombre (completo) para el curso. (Puede ser el mismo que el nombre corto, pero si ambos están disponibles, proporcionará una mejor experiencia para el usuario al brindar ambos).
  • account_id^:  Este es el identificador único de ID de cuenta SIS (de accounts.csv) que le indica al curso bajo qué subcuenta residirá. Si account_id no está especificado para un nuevo curso, entonces este curso se adjuntará a su cuenta principal o raíz. La identificación de SIS se puede encontrar en la configuración de la subcuenta.
  • term_id^:  Es el identificador único término (a partir de terms.csv) que le indica el curso cuándo comenzar y cuándo concluir. Si asocia una term_id a un curso, no necesita introducir una start-date o end-date.
  • estado*^:  Este es el estado del curso, también conocido como workflow_state. Este campo le permite crear, eliminar, concluir o publicar un curso. Marcar como activo para agregar un curso, eliminado para eliminar un curso existente, completado para concluir un curso existente o publicado para publicar un curso existente.
  • integration_id: Este es un identificador único secundario útil para integraciones más complejas del SIS. Este identificador no debe cambiar para el curso y debe ser único universalmente.
  • start_date^:  Es la fecha en que comienza el curso. Debe expresarse en el formato ISO 8601: AAAA-MM-DDTHH:MM:SS (la T puede reemplazarse por un espacio).
  • end_date^:  Es la fecha en que el término finaliza. Debe expresarse en el formato ISO 8601: AAAA-MM-DDT HH:MM:SS (la T puede reemplazarse por un espacio). De forma predeterminada, el acceso de los usuarios se corta a la medianoche en la fecha final indicada, lo que significa que el día anterior es el último día completo en el que los usuarios tienen acceso al término. El mejor método es establecer su fecha de finalización el día después de que el término finaliza.
  • course_format: Este es el formato del curso. El formato puede ser en línea, on_campus, o aprendizaje semipresencial.
  • blueprint_course_id: Esta es la identificación del curso de proyectos al cual desea añadir un curso asociado. Para eliminar el enlace del curso de proyectos, puede ingresar "disociar" en lugar de la identificación. En la interfaz de usuario, es la identificación del SIS del curso de proyectos.
  • homeroom_course: Esto se utiliza para designar cursos en aulas para las cuentas de primaria de Canvas. Se requiere que las configuraciones de Canvas para primaria (Canvas for Elementary) estén activadas.

sections.csv

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 ID del SIS.

Descargue una muestra de un archivo sections.csv con las siguientes secciones:

  • 4 secciones en el curso ACCT300: Contabilidad de costos
  • 4 secciones en el curso ACCT310: Gestión contable
  • 2 secciones en el curso BIO101: Introducción a la biología

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^

  • section_id*:  Es un identificador único utilizado para crear secciones dentro de un curso. Este identificador no debe cambiar para la sección y debe ser único universalmente. En la interfaz de usuario, esto se llama identificación de SIS.
  • course_id*^:  Es el identificador único del curso donde la sección será añadida o eliminada (agregado en courses.csv).
  • nombre*^:  Es el nombre de la sección. Las secciones se ordenan alfabéticamente por nombre.
  • status*:  Es como se puede crear o eliminar una sección dentro de un curso. Marque como activo para crear una sección o eliminado para eliminar una sección existente.
  • integration_id: Este es un identificador único secundario útil para integraciones más complejas del SIS. Este identificador no debe cambiar para la sección y debe ser único universalmente.
  • start_date^:  Es la fecha en que comienza la sección. Debe expresarse en el formato ISO 8601: AAAA-MM-DDT HH:MM:SS (la T puede reemplazarse por un espacio).
  • end_date^:  Es la fecha en que el término finaliza. Debe expresarse en el formato ISO 8601: AAAA-MM-DDT HH:MM:SS (la T puede reemplazarse por un espacio). De forma predeterminada, el acceso de los usuarios se corta a la medianoche en la fecha final indicada, lo que significa que el día anterior es el último día completo en el que los usuarios tienen acceso al término. El mejor método es establecer su fecha de finalización el día después de que el término finaliza.

enrollments.csv

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 solo lectura para ese curso.

Nota: Los archivos CSV de inscripción en SIS que incluyen los valores start_date y end_date anulan las fechas de los trimestres, cursos y secciones.

Descargar un archivo ejemplo de enrollments.csv con las siguientes inscripciones:

  • 1 usuario como profesor en el curso ACCT300: Contabilidad de costos
  • 1 usuario como profesor auxiliar en el curso ACCT300: Contabilidad de costos
  • 1 usuario como diseñador en el curso de ACCT300: Contabilidad de costos
  • 3 usuarios como estudiantes en la sección 1 del curso ACCT300: Contabilidad de costos
  • 3 usuarios como estudiantes en la sección 2 del curso ACCT300: Contabilidad de costos
  • 1 usuario como observador de un estudiante en la sección 1 del curso ACCT300: Contabilidad de costos

Campo obligatorio* | Campo adherido^

  • course_id*:  (Se requiere si falta section_id) Es un identificador único para el curso donde se inscribirá el usuario (agregado en courses.csv). Si se inscribe a los estudiantes en el curso en lugar de una sección específica, ingrese el course_id en este campo. De lo contrario, déjelo en blanco.
  • root_account: Este es el dominio de la cuenta para buscar el usuario.
  • start_date^: Es la fecha de inicio de la inscripción. Para que start_date se aplique, también se debe completar end_date. Debe expresarse en el formato ISO 8601: YYYY-MM-DDTHH:MM:SSZ.
  • end_date^: Es la fecha de finalización de la inscripción. Para que end_date se aplique, también se debe completar start_date. Debe expresarse en el formato ISO 8601: YYYY-MM-DDTHH:MM:SSZ.
  • user_id*:  Es el identificador único del usuario que se inscribirá en los cursos señalados (agregados en user.csv). Si user_integration_id está presente, este campo será ignorado.
  • user_integration_id*: (Se requiere si falta user_id) Es el identificador único secundario del usuario (agregado en users.csv como integration_id).
  • role*:  Este es el papel que se le asignará a un usuario para el curso señalado. Se inscribe a un usuario para tener cualquiera de los siguientes roles: profesor, diseñador, maestro asistente, estudiante, observador o un papel personalizado que usted definirá.  Cada rol tiene un conjunto de permisos que los administradores pueden personalizar en el nivel de cuenta o subcuenta principal/raíz.
  • role_id*: (Se requiere si falta el rol) Es el identificador único para el rol en el que se agregará al usuario como parte de una inscripción.
  • section_id*:  (Se requiere si falta course_id) Es el identificador único para la sección en la que el usuario estará inscrito (agregado en sections.csv). Si inscribe a los estudiantes en una sección específica de un curso, ponga aquí la section_id de la sección. De lo contrario, deje este campo en blanco. Si no se especifica la section_id, se utilizará la sección predeterminada para el curso. Si no existe una sección de forma predeterminada, se creará automáticamente sin identificación de SIS.
  • status*: Es cómo se inscribe, concluye, desactiva (hace inactiva) o elimina una inscripción en un curso. Marque como activo para inscribir a un usuario en un curso, completado para concluir con la inscripción de un usuario en un curso, inactivo para desactivar el usuario en el curso y eliminado para borrar a un usuario de un curso. Cuando está en un estado "inactivo", un estudiante se agregará a la lista del curso para profesores, pero no podrá ver o participar en el curso hasta que la inscripción sea activada.  
  • associated_user_id:  (Solo para el rol de observador) Es el identificador único del usuario cuya información (incluidas calificaciones) el observador será capaz de ver. El observador debe estar inscrito en el mismo curso/sección que el usuario que quiere observar. Este campo se omitirá para cualquier rol que no sea observador.
  • limit_section_privileges: Así se designa la inscripción que le permitirá al usuario ver e interactuar con los usuarios inscritos en la sección proporcionada por course_section_id. El valor predeterminado de este campo es falso. Limitar a los estudiantes a interactuar por sección solo afecta las categorías de Colaboraciones (Collaborations), Chat, Personas (People) y Conversaciones (Conversations). Cuando se inscribe a profesores y a profesores auxiliares, las limitaciones de sección les permiten calificar a los estudiantes en sus mismas secciones. Los Temas de foro (Discussion Topics) y las Páginas (Pages) no se ven afectadas por las limitaciones de sección, y solo los estudiantes pueden verlos. Estas áreas de función podrían restringirse al crear contenido en los grupos de curso.
  • notify: Así se elige enviar una notificación a los usuarios inscritos en un curso.

Nota: El campo root_account se recomienda al identificar a los usuarios en una cuenta de confianza.

group_categories.csv

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:

  • Grupos de administradores
  • Grupos de diseñadores
  • Grupos de proyecto de historial

Campo obligatorio* | Campo adherido^

  • group_category_id: Es el identificador utilizado para hacer referencia a la categoría de grupo. El identificador no debe cambiar para la categoría de grupo y debe ser único universalmente.
  • account_id: Es el identificador que acopla la categoría de grupo a una cuenta (agregada en cuentas.csv). Si no se especifican la cuenta o el curso, el grupo se unirá a la cuenta principal.
  • course_id: Es el identificador que acopla la categoría de grupo a un curso (agregado en courses.csv). Si no se especifican la cuenta o el curso, el grupo se unirá a la cuenta principal.
  • category_name*^: Es el nombre de la categoría de grupo.
  • status*: Es el estado de la categoría de grupo. Marque como activa (active) para marcar la categoría de grupo o eliminada (deleted) para quitar la categoría de grupo.

groups.csv

Un grupo puede utilizarse para proporcionar oportunidades de colaboración para los estudiantes, los profesores, 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:

  • Administradores
  • Maestros de matemáticas
  • Diseñadores

Campo obligatorio* | Campo adherido^

  • group_id*: Es el identificador único utilizado para hacer referencia a su grupo. No debe cambiar para el grupo y debe ser único en general.
  • group_category_id: Es el identificador de la categoría de grupo (agregada en group_categories.csv) en la cual usted está agregando un grupo. Si no se especifica la categoría de grupo, el grupo se colocará en la categoría de grupo predeterminada para la cuenta o el curso definidos. Si no se especifican la cuenta o el curso, el grupo se colocará en la categoría de grupo predeterminada para la cuenta principal.
  • account_id: Es el identificador que acopla el grupo a una cuenta (agregada en cuentas.csv). Si no se especifica, el grupo se unirá a la cuenta principal.
  • course_id: Es el identificador que acopla el grupo a un curso (agregado en courses.csv). Si no se especifican la cuenta o el curso, el grupo se unirá a la cuenta principal.
  • nombre*^: Es el nombre del grupo.
  • status*: Este es el estado del grupo. Marque como disponible para establecer que el grupo está abierto para membresía o eliminado para eliminar el grupo.

groups_membership.csv

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:

  • 1 usuario aceptado en el grupo de administradores
  • 1 usuario aceptado en el grupo de maestros de matemáticas
  • 1 usuario eliminado en el grupo de maestros de matemáticas

Campos requeridos *

  • group_id*: Es el identificador único utilizado para hacer referencia a su grupo (agregado en groups.csv).
  • user_id*: Es el identificador único del usuario que desea agregar al grupo (agregado en users.csv).
  • status*: Este es el estado de los usuarios en el grupo. Marque como aceptado para agregar a un usuario en un grupo o eliminado para quitar un usuario de un grupo.

xlists.csv

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 ID 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:

  • 4 secciones activas en el curso de ACCT300 - Contabilidad de costos listado también en el curso ACCT310 - Gestión contable.

Campos requeridos *

  • xlist_course_id*: Es el identificador del nuevo curso (agregado en courses.csv).
  • section_id*: Es el identificador de la sección (agregado en sections.csv).
  • status*: Este es el estado de la sección. Marque como activa para marcar la sección activa o eliminada para quitar la sección.

user_observers.csv

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:

  • 2 observadores activos
  • 1 observador eliminado

Campos requeridos *

  • observer_id*: Es el identificador único del observador (agregado como user_id en users.csv).
  • student_id*: Es el identificador único del estudiante (agregado como user_id en users.csv).
  • status*: Este es el estado del observador. Márquelo como activo (active) para inscribir al observador en cada inscripción del estudiante o eliminado (deleted) para quitar todas las inscripciones del observador.

logins.csv

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 ejemplo con tres inicios de sesión del usuario.

Campo obligatorio* | Campo adherido^

  • user_id*: Este es el identificador único del usuario (al que se hace referencia en enrollments.csv). Este valor no debe cambiar para el usuario y debe ser único entre todos los usuarios. Se lo llama Identificación de SIS en la interfaz de usuario de Canvas.
  • integration_id: Este es un identificador único secundario que es útil para integraciones complejas del SIS. Este valor no debe cambiar para el usuario y debe ser único entre todos los usuarios. Este campo debe dejarse en blanco cuando se fusionen los usuarios con Identificaciones de integración que coincidan.
  • login_id*: Este es el nombre que el usuario utilizará para iniciar sesión en Canvas. Para los servicios de autenticación configurados, como LDAP, este será el nombre de usuario del sistema remoto.
  • password: Esta es la contraseña que el usuario utilizará para iniciar sesión en Canvas. Este campo no debe completarse para las cuentas configuradas para LDAP o SSO.
  • ssha_password: Esta es una contraseña generada con un esquema de generación de SSHA antes de hash.
  • authentication_provider_id: Este es el proveedor de autenticación con el que se asocia el inicio de sesión.
  • existing_user_id^: Esta es la Identificación de SIS del usuario, tal como aparece en users.csv.
  • existing_integration_id^: Esta es la Identificación de integración del usuario, tal como aparece en users.csv.
  • existing_canvas_user_id^: Esta es la Identificación de Canvas del usuario.
  • root_account: Esta es la cuenta de dominio del usuario.
  • email: Esta es la dirección de correo electrónico del usuario.

Notas:

  • Se necesita un existing_user_id, existing_integration_id o existing_canvas_user_id para importar correctamente el archivo logins.csv.
  • El campo root_account es obligatorio cuando se identifica a los usuarios en una cuenta de confianza (por ejemplo, cuando se realiza una enumeración cruzada de los usuarios en cuentas dentro de una cuenta de confianza).

admins.csv

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 un archivo de muestra admins.csv con los siguientes administradores:

  • 2 administradores de cuenta activos
  • 1 administrador de cuenta eliminado
  • 2 roles de cuenta personalizados activos

Campos requeridos *

  • user_id*: Es la identificación única del usuario que desea designar como administrador (agregado en users.csv).
  • account_id*: Es el identificador único de la cuenta en la cual prefiere que resida el administrador (agregado en accounts.csv). Si esta columna queda en blanco, el usuario residirá en la cuenta principal. Esta columna siempre es obligatoria, incluso si el valor está en blanco.  
  • role_id*: (requerido si falta el role) Esta es la ID del rol, ya sea la ID predeterminada o una ID personalizada definida por la cuenta.
  • role*: (requerido si falta role_id) Este es el nombre del rol, ya sea el rol de administrador de la cuenta o un rol personalizado definido por la cuenta. Si va a agregar a un administrador de la cuenta, formatee el campo para que diga “AccountAdmin”. Si va a agregar un rol personalizado, formatee el campo exactamente como aparece en la interfaz de usuario de Canvas.
  • status*: Es el estado del administrador. Marque como activo para crear un administrador activo o eliminado para eliminar un administrador.
  • root_account: Este es el dominio de la cuenta para buscar el usuario.

change_sis_id.csv

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 un archivo de muestra change_sis_id.csv con los siguientes cambios de identificación de SIS:

  • 1 cambio de identificación de SIS del usuario
  • 1 cambio de identificación de SIS del curso
  • 1 cambio de identificación de SIS del término

Campos requeridos *

  • old_id*: Es la identificación de SIS actual del objeto.
  • new_id*: Es la identificación de SIS deseada del objeto. La nueva identificación de SIS debe ser única para el tipo de objeto y la cuenta principal.
  • type*: Es el tipo de objeto. El tipo puede ser cuenta, término, curso, sección, grupo o usuario.