Canvas le permite importar archivos CSV para crear manualmente en masa usuarios, cuentas, períodos, cursos, secciones, inscripciones e inicios de sesión a través de la interfaz de administración.
Este documento hace referencia a la página de la API de formato CSV de importación de SIS , donde se encuentra la mayor parte de la información CSV. Cada archivo CSV interactúa con los demás e indica a Canvas cómo administrar la información de la cuenta. Consulte el diagrama de relaciones de SIS .
Archivos de muestra
Cada paso de esta lección proporciona detalles sobre los archivos CSV y descripciones de cada campo obligatorio y opcional. Cada paso también incluye un enlace para descargar un archivo CSV de muestra. Los archivos de muestra contienen todos los campos obligatorios y pueden contener campos opcionales. Además, puede descargar un archivo comprimido con todos los archivos de muestra . 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 cargar datos en masa en Canvas, debe crear uno o más archivos de texto CSV. Muchos programas pueden generar archivos CSV. Los Sistemas de Información Estudiantil (SIS) suelen tener un método para generar informes en formato CSV que se puede modificar para que se ajusten al formato que requiere Canvas. Si no sabe cómo guardar un archivo en formato CSV, consulte la documentación del programa que esté utilizando para crear su archivo CSV (por ejemplo, Excel).
Al usar el formato Instructure para importar archivos en la página Importar SIS , puede importar un archivo de texto CSV individual o comprimir varios archivos en un solo archivo ZIP para importar datos en bloque. Si carga archivos individuales manualmente, debe hacerlo en el orden que se muestra en esta lección.
Formato de campo CSV
La primera fila de su archivo CSV (encabezado) debe incluir el nombre completo del campo de cada archivo. El orden de las columnas es irrelevante, pero es crucial que las filas estén ordenadas correctamente para archivos como accounts.csv.
Campos pegajosos
De forma predeterminada, ciertos cambios realizados en la interfaz de usuario no se sobrescriben en futuras importaciones de SIS y se especifican como persistentes. Todos los campos persistentes se identifican en este documento. Puede sobrescribir estos campos configurando override_sis_stickiness en la API o marcando la casilla "Anular cambios de la interfaz de usuario" en la página de importación de SIS .
Documentación de la API
Los archivos CSV solo incluyen un conjunto específico de campos. Canvas contiene valores adicionales disponibles a través de cada API. Tras ejecutar los archivos CSV para su institución, la práctica habitual en la mayoría de las instituciones es cargar todos los archivos CSV del SIS y luego usar la API de Canvas para actualizar todos los atributos de la cuenta y el curso. Para obtener más información, consulte la documentación de la API de Canvas para Usuarios, Cuentas, Periodos, Cursos, Secciones, Inscripciones y Grupos. Las importaciones del SIS también se pueden gestionar mediante la API de Importaciones del SIS .
Nota: La fila de encabezado de sus archivos CSV define qué campos de datos procesará Canvas. Si bien las guías de importación de SIS enumeran todos los campos compatibles, su CSV solo debe incluir las columnas que está actualizando. Si falta un campo compatible en su archivo, puede agregar manualmente el encabezado a la primera fila.
usuarios.csv
Los usuarios son las personas que tienen cuentas dentro de una institución. El archivo users.csv agrega usuarios al sistema como usuarios genéricos. El archivo enrollments.csv les asigna un rol (profesor, estudiante, etc.). Al eliminar una cuenta de usuario, también se eliminan todas sus inscripciones y no podrán iniciar sesión en su cuenta de Canvas. Si desea que el usuario pueda iniciar sesión, pero no participar, o si solo desea eliminarlo de un curso en particular, debe mantener su cuenta como activa y cambiar su inscripción (en el archivo enrollments.csv) a "completada" o "eliminada" , respectivamente.
Descargue un archivo users.csv de muestra con 10 cuentas de usuario de Canvas.
Campo obligatorio*| Campo pegajoso^
- id de usuario*Este es un valor único que se utiliza para identificar a cualquier persona con una cuenta en Canvas. Este valor no debe cambiar para el usuario y debe ser único para todos los usuarios. En la interfaz de usuario, se denomina ID de SIS y puede estar compuesto por cualquier combinación de caracteres. Puede encontrar este ID de SIS visitando cualquier cuenta de usuario y consultando su información de inicio de sesión.
- Integration_id: Este es un identificador único secundario útil para integraciones SIS más complejas. Este identificador no debe cambiar para el usuario y debe ser único a nivel global.
- ID de inicio de sesión*^:
- Contraseña: Si la cuenta está configurada para usar LDAP o un protocolo SSO, no es necesaria. De lo contrario, esta es la contraseña para el "login_id" mencionado anteriormente. Esta contraseña debe tener al menos 8 caracteres.
- ssha_password: En lugar de una contraseña de texto plano, puede pasar una contraseña precodificada mediante el esquema de generación de contraseñas SSHA en este campo. Aunque es mejor que pasar una contraseña de texto plano, se recomienda a los usuarios que cambien su contraseña después de iniciar sesión por primera vez.
- authentication_provider_id: Este es el proveedor de autenticación al que está asociado el inicio de sesión. Los inicios de sesión asociados a un proveedor específico solo se pueden usar con ese proveedor. Los proveedores antiguos (LDAP, CAS, SAML) buscarán inicios de sesión asociados a ellos o no asociados. Los nuevos proveedores solo buscarán inicios de sesión asociados explícitamente a ellos. Puede ser el ID entero del proveedor o el tipo de proveedor (en cuyo caso, encontrará el primer proveedor coincidente).
- first_name^: Este es el nombre del usuario. Si está presente, se utiliza para construir el nombre completo o el nombre ordenable.
- last_name^: Apellido del usuario. Si está presente, se utiliza para construir el nombre completo o el nombre ordenable.
- full_name^: Este es el nombre y apellido del usuario. Omita first_name y last_name si se proporcionan.
- sortable_name^ : esta es la opción de nombre ordenable en Canvas, generalmente se infiere del nombre del usuario, pero se puede personalizar.
- short_name^: Este es el nombre para mostrar del usuario, generalmente se infiere del nombre del usuario, pero se puede personalizar.
- Correo electrónico: Esta es la dirección de correo electrónico asignada por la 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 coincide con el login_id del usuario.
- Pronombres^: Si los pronombres personales están habilitados, estos son los que se muestran después del nombre del usuario en Canvas. El campo "Pronombres" acepta todos los pronombres, incluso si no se crearon en la página Configuración de la cuenta.
- tipo_de_usuario_declarado: Este tipo de usuario declarado puede ser administrativo, observador, personal, estudiante, estudiante_otro o profesor. Se puede pasar "<delete>" para eliminar el tipo de usuario declarado del usuario.
- canvas_password_notification: El valor predeterminado es "false". Si es "true", se notifica al usuario la configuración de la contraseña si el valor de authentication_provider_id es canvas. Si su institución no cuenta con una integración con Canvas SIS, este campo es obligatorio para notificar a los nuevos usuarios sobre sus cuentas creadas.
- home_account: Al establecer home_account como verdadero, se creará un nuevo usuario en la cuenta de destino para la importación del SIS y se fusionará otro usuario existente de otra cuenta dentro del consorcio con un ID de integración coincidente. Se ignorará a menos que la cuenta de destino esté asociada a un consorcio de fusión automática.
- estado*^:Aquí puedes agregar o eliminar un usuario de Canvas. Marcar como activo para agregar un usuario, suspendido para suspenderlo o eliminado para eliminarlo.
Nota: No es necesario que los archivos CSV contengan todos los campos posibles. Para garantizar una importación correcta, el archivo debe incluir todos los encabezados obligatorios , pero los encabezados opcionales (como integration_id o authentication_provider_id) solo deben incluirse si se proporcionan datos para esos campos específicos.
Conflictos de direcciones de correo electrónico
Canvas identifica a los usuarios por su dirección de correo electrónico. Al añadir estudiantes a un curso, Canvas intenta solucionar cualquier conflicto de direcciones de correo electrónico cuando el usuario inicia sesión por primera vez.
Normalmente, las direcciones de correo electrónico son únicas para cada estudiante. En ocasiones, varios estudiantes pueden compartir una misma dirección. Al añadir estudiantes a cursos mediante la importación de SIS, Canvas reconoce cuando una dirección de correo electrónico está asignada a más de un estudiante.
- Si un nuevo ID de SIS está asociado con una dirección de correo electrónico ya asignada a un ID de SIS existente, Canvas envía un correo electrónico a la dirección de correo electrónico.
- Al añadir usuarios a una cuenta mediante la importación de 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 se añade o inscribe manualmente, recibirá un correo electrónico notificándole que se ha añadido o inscrito en un nuevo curso. El estudiante que comparta una dirección de correo electrónico recibirá una notificación indicando que esta ya está en uso y se le invitará a crear una nueva cuenta en Canvas. Este proceso también puede aplicarse al añadir un usuario a la inscripción de un curso.
cuentas.csv
Una cuenta es una unidad organizativa dentro de Canvas (por ejemplo, la cuenta principal de una institución). Cada cuenta puede contener una jerarquía de subcuentas, como la creación de cuentas para universidades individuales dentro de una institución o para escuelas individuales dentro de un distrito. Las subcuentas también pueden contener varias subcuentas, como cuando una universidad se subdivide en departamentos o programas, o una escuela se subdivide en grados o asignaturas.
Descargue un archivo accounts.csv de muestra con las siguientes subcuentas:
- 3 subcuentas dentro de tu cuenta principal (Artes y Humanidades, Negocios, Matemáticas y Ciencias).
- 4 subcuentas dentro de tu subcuenta de Negocios (Contabilidad, Informática, Economía y Marketing).
- 3 subcuentas dentro de tu subcuenta de Matemáticas y Ciencias (Biología, Física y Estadística).
- 1 subcuenta dentro de tu subcuenta de Artes y Humanidades (Artes Visuales).
- 2 subcuentas dentro de tu subcuenta de Artes Visuales (Fotografía y Medios Digitales).
Campo obligatorio*| Campo pegajoso^
- ID de cuenta*:Este es un identificador único que se utiliza para crear una subcuenta. El archivo courses.csv le permitirá asignar cursos a un ID de cuenta específico. Este identificador único no debe cambiar para la cuenta y debe ser único a nivel global en todas las cuentas. En la interfaz de Canvas, se denomina ID de SIS y se puede modificar en la configuración de cada subcuenta.
- id_de_cuenta_principal*^: Este identificador indica que una subcuenta debe anidarse debajo de esta cuenta principal. Si este campo está en blanco, la subcuenta se anidará debajo de su cuenta raíz o principal. Tenga en cuenta que, incluso si todos los valores están en blanco, la columna debe incluirse para diferenciar el archivo de una importación de grupo.
- nombre*^ : Este es el nombre de la subcuenta.
- estado*:Así es como puedes crear o eliminar una subcuenta. Marca como activa para añadir una subcuenta o como eliminada para eliminar una subcuenta existente.
- Integration_id: Este es un identificador único secundario útil para integraciones SIS más complejas. Este identificador no debe cambiar para la cuenta y debe ser único a nivel global.
términos.csv
Un trimestre proporciona un conjunto predeterminado de fechas de inicio y fin para cualquier curso asignado a ese trimestre. Las fechas de los cursos se pueden gestionar manualmente a nivel de curso sin un archivo de importación. Sin embargo, asociar un term_id a varios cursos diferentes garantiza que todos los cursos de ese trimestre comiencen y terminen a la misma hora. Las fechas de los trimestres cargados también le ayudarán a ordenar y organizar los cursos al consultar datos e informes en la interfaz de administración.
Descargue un archivo terms.csv de muestra con 10 términos.
Campo obligatorio*| Campo pegajoso^
- id_del_término*: Este es un identificador único para el trimestre. El archivo courses.csv le permitirá referenciar este term_id para que sus cursos sepan cuándo comenzar y cuándo terminar. Este identificador no debe cambiar durante el trimestre y debe ser único a nivel global para todos los trimestres. En la interfaz de usuario, se denomina ID del SIS.
- nombre*^: Este es el nombre de tu término. Crea una buena nomenclatura que te ayude a referenciar fácilmente tus términos. Existen muchas herramientas de administración que te permiten buscar o consultar datos por el nombre del término.
- estado*: Así es como puedes crear o eliminar un término. Marcar como activo para añadir un término o eliminar para eliminar uno existente.
- start_date^: Esta es la fecha de inicio del trimestre. El formato debe ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ (La T puede reemplazarse por un espacio, como se muestra en la captura de pantalla de ejemplo). Por ejemplo, el 26 de agosto de 2013 a las 17:00 EST se escribiría 2013-08-26T17:00-5:00
- end_date^: Esta es la fecha de finalización del trimestre. El formato debe ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ (La "T" puede sustituirse por un espacio, como se muestra en la captura de pantalla de ejemplo). De forma predeterminada, el acceso de los usuarios se interrumpe a la medianoche de la fecha de finalización indicada, lo que significa que el día anterior es el último día completo en que los usuarios tienen acceso al trimestre. Se recomienda establecer la fecha de finalización al día siguiente de la finalización del trimestre.
- Integration_id: Este es un identificador único secundario útil para integraciones SIS más complejas. Este identificador no debe cambiar durante el período y debe ser único a nivel global.
- date_override_enrollment_type: Permite establecer o eliminar las fechas de inicio y fin de un tipo de matrícula específico dentro de un trimestre. Al establecer esta opción, se ignoran todas las columnas, excepto term_id, status, start_date y end_date, para la fila. Si el estado es activo, las fechas del trimestre se aplicarán solo a las inscripciones de ese tipo. Si el estado es eliminado, se eliminarán las fechas establecidas para ese tipo de matrícula. El tipo de matrícula puede ser StudentEnrollment, TeacherEnrollment, TaEnrollment o DesignerEnrollment.
cursos.csv
Un curso es una presentación organizada sobre un tema específico. En ocasiones, un curso puede incluir una serie de cursos. Los cursos se organizan dentro de los trimestres para crear fechas de inicio y fin predeterminadas. Sin embargo, si un curso incluye fechas específicas, estas anularán las fechas de acceso de los estudiantes en el trimestre, identificadas por el term_id (si se incluye). La ventaja de adjuntar un term_id es que podrá ordenar y organizar los cursos al consultar datos e informes en la interfaz de administración. Un term_id se puede adjuntar fácilmente a varios cursos que comienzan y terminan simultáneamente. Si no vincula un curso a un trimestre, este se vinculará al trimestre denominado "Trimestre predeterminado".
Si su institución ha habilitado los Cursos Blueprint, puede usar un archivo courses.csv para agregar cursos asociados a un curso Blueprint. Tenga en cuenta que el curso Blueprint debe crearse y habilitarse como tal antes de poder agregar cursos asociados.
Descargue un archivo de muestra de cursos.csv con 10 cursos; estos residen dentro de sus respectivas subcuentas en un período específico.
Campo obligatorio*| Campo pegajoso^
- id_del_curso*:Este es un identificador único que se utiliza para diferenciar los cursos dentro de Canvas. Este identificador no debe cambiar para el curso y debe ser único a nivel global en todos los cursos . En la interfaz de usuario, se denomina ID de SIS.
- nombre corto*^: Este es el nombre corto del curso. En la interfaz de Canvas, también se denomina Código del Curso o Código de Referencia .
- nombre_largo*^: Este es el nombre completo del curso. (Puede ser el mismo que el nombre corto, pero si ambos están disponibles, la experiencia del usuario será mejor).
- account_id^: Este es el identificador único de la cuenta SIS (del archivo accounts.csv) que indica al curso en qué subcuenta residirá. Si no se especifica un account_id para un curso nuevo, este se vinculará a su cuenta principal. El ID SIS se encuentra en la configuración de la subcuenta.
- term_id^: Este es el identificador único del término (del archivo terms.csv) que indica al curso cuándo comenzar y cuándo terminar. Si asocia un term_id a un curso, no necesita introducir una fecha de inicio ni una fecha de finalización.
- estado*^: Este es el estado del curso, también conocido como workflow_state. Este campo permite crear, eliminar, concluir o publicar un curso. Marcar como activo para añadir un curso, eliminado para eliminar uno existente, completado para concluirlo o publicado para publicar un curso nuevo o existente.
- Integration_id: Este es un identificador único secundario útil para integraciones SIS más complejas. Este identificador no debe cambiar para el curso y debe ser único a nivel global.
- start_date^: Esta es la fecha de inicio del curso. El formato debe ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ (La "T" puede sustituirse por un espacio).
- end_date^: Esta es la fecha de finalización del curso. El formato debe ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ (La "T" puede sustituirse por un espacio). De forma predeterminada, el acceso de los usuarios se interrumpe a la medianoche de la fecha de finalización indicada, lo que significa que el día anterior es el último día completo en que los usuarios tienen acceso al curso. Se recomienda establecer la fecha de finalización al día siguiente de la finalización del curso.
- course_format : Este es el formato del curso. Puede ser en línea , presencial o semipresencial .
- blueprint_course_id : Este es el ID del curso del plan al que desea agregar un curso asociado. Para eliminar el enlace del curso del plan, puede usar "dissociate" en lugar del ID. En la interfaz de usuario, este es el ID SIS del curso del plan.
- homeroom_course: Se utiliza para designar cursos de aula para cuentas de Canvas para Primaria. Requiere que la configuración de Canvas para Primaria esté habilitada.
secciones.csv
Una sección subdivide a los estudiantes dentro de un curso. Varias secciones también pueden agruparse en un mismo curso, especialmente si todas las secciones de estudiantes estudian el mismo material. Se pueden incluir varias secciones en un mismo curso, pero una sección no puede contener varias secciones. Las secciones heredan las fechas del curso establecidas por el trimestre. Sin embargo, si una sección incluye fechas específicas, estas prevalecerán sobre las fechas de acceso de los estudiantes al curso y las fechas de inicio y/o fin del trimestre.
Si está intentando eliminar un curso y los usuarios están asociados con secciones, deberá incluir el parámetro section_id en la importación CSV, así como los ID SIS de las secciones.
Descargue un archivo sections.csv de muestra con las siguientes secciones:
- 4 secciones en el curso ACCT300 - Contabilidad de costos
- 4 secciones en el curso ACCT310 - Contabilidad Gerencial
- 2 secciones en el curso BIO101 - Introducción a la Biología
Este archivo asume que puede tener varias secciones dentro de un mismo curso. Muchas instituciones importan las secciones de los cursos como cursos independientes. Esto se puede lograr (1) creando un curso de Canvas para cada sección en su archivo courses.csv y (2) creando una sola sección en cada uno de estos cursos. Puede usar prácticamente los mismos datos para el curso y la sección, incluyendo el ID de SIS, que será el mismo para course_id y section_id.
Campo obligatorio*| Campo pegajoso^
- id_de_sección*:Este es un identificador único que se utiliza para crear secciones dentro de un curso. Este identificador no debe cambiar para la sección y debe ser único a nivel global. En la interfaz de usuario, se denomina ID del SIS.
- id_del_curso*^: Este es el identificador único del curso donde se agregará o eliminará la sección (agregada en courses.csv).
- nombre*^: Este es el nombre de la sección. Las secciones están ordenadas alfabéticamente por nombre.
- estado*:Así es como puedes crear o eliminar una sección dentro de un curso. Marca como activa para crear una sección o como eliminada para eliminar una existente.
- Integration_id: Este es un identificador único secundario útil para integraciones SIS más complejas. Este identificador no debe cambiar para la sección y debe ser único globalmente.
- start_date^: Esta es la fecha de inicio de la sección. El formato debe ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ (La "T" puede sustituirse por un espacio).
- end_date^: Esta es la fecha de finalización de la sección. El formato debe ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ (La "T" puede sustituirse por un espacio). De forma predeterminada, el acceso de los usuarios se interrumpe a la medianoche de la fecha de finalización indicada, lo que significa que el día anterior es el último día completo en que los usuarios tienen acceso a la sección. Se recomienda establecer la fecha de finalización al día siguiente de la finalización de la sección.
Nota: Al importar archivos CSV de secciones, los valores integration_id existentes se conservan si la columna integration_id no está incluida en el archivo de importación. Para eliminar un integration_id , debe anularse explícitamente mediante el archivo change_sis_id.csv .
inscripciones.csv
Una inscripción es un usuario inscrito en un curso con un rol específico. Un archivo enrollments.csv permite asignar roles a los usuarios y asignarlos a los cursos correspondientes. Cuando la inscripción de un usuario se marca como completada, se le limita el acceso a solo lectura para ese curso.
Nota: Los archivos CSV de inscripción del SIS que incluyen valores de fecha de inicio y fecha de finalización anulan las fechas del período, las fechas del curso y las fechas de la sección.
Descargue un archivo enrollments.csv de muestra con las siguientes inscripciones:
- 1 usuario como docente en el curso ACCT300 – Contabilidad de Costos
- 1 usuario como asistente en el curso ACCT300 - Contabilidad de Costos
- 1 usuario como diseñador en el curso 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 pegajoso^
- course_id*: (Obligatorio si falta el section_id) Este es un identificador único del curso en el que se inscribirá el usuario (se añade al archivo courses.csv). Si se inscribe a los estudiantes en el curso en lugar de en una sección específica, introduzca el course_id en este campo. De lo contrario, déjelo en blanco.
- root_account : este es el dominio de la cuenta donde se buscará el usuario.
- start_date^: Esta es la fecha de inicio de la inscripción. Para que la start_date tenga efecto, también debe completarse la end_date. El formato debe ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ.
- end_date^: Esta es la fecha de finalización de la inscripción. Para que la fecha de finalización surta efecto, también debe completarse la fecha de inicio. El formato debe ser ISO 8601 : AAAA-MM-DDTHH:MM:SSZ.
- id_usuario*:Este es el identificador único del usuario que se inscribirá en los cursos designados (añadido en users.csv). Si el user_integration_id está presente, este campo se ignorará.
- user_integration_id*: (Obligatorio si falta el user_id)Este es el identificador único secundario del usuario (agregado en users.csv como integration_id).
- role*:Este es el rol que se le asignará a un usuario para el curso designado. Puede inscribir a un usuario con cualquiera de los siguientes roles: profesor, diseñador, asistente de cátedra, estudiante, observador o un rol personalizado que usted defina. Cada rol tiene un conjunto de permisos que los administradores pueden personalizar en la cuenta principal o en la subcuenta.
- role_id*: (Obligatorio si falta el rol)Este es el identificador único para el rol en el que se agregará el usuario como parte de una inscripción.
- id_de_sección*:(Obligatorio si falta el course_id) Este es el identificador único de la sección en la que se inscribirá el usuario (añadido en sections.csv). Si se inscribe a los estudiantes en una sección específica de un curso, introduzca aquí el section_id de la sección. De lo contrario, deje este campo en blanco. Si no se especifica el section_id, se utilizará la sección predeterminada del curso. Si no existe una sección predeterminada, se creará una automáticamente sin un ID de SIS.
- estado*: Así es como se inscribe, finaliza, desactiva (inactiva) o elimina una inscripción en un curso. Marcar como activo para inscribir a un usuario en un curso, "Completado" para concluir la inscripción, " Inactivo " para desactivarlo y " Eliminado " para eliminarlo. En estado "Inactivo", el estudiante aparecerá en la lista de instructores del curso, pero no podrá verlo ni participar hasta que se active la inscripción.
- associated_user_id: (Solo para rol de observador) Este es el identificador único del usuario cuya información (incluidas las calificaciones) podrá ver el observador. El observador debe estar inscrito en el mismo curso/sección que el usuario que desea que observe. Este campo se ignorará para cualquier rol que no sea el de observador.
- limit_section_privileges: Esta es la forma de indicar que la inscripción permitirá al usuario ver e interactuar únicamente con los usuarios inscritos en la sección especificada en course_section_id. Este campo tiene el valor predeterminado "false". Limitar la interacción de los estudiantes por sección solo afecta a Colaboraciones, Chat, Personas y Conversaciones. Al inscribir a instructores y asistentes de clase, las limitaciones de sección permiten que estos usuarios califiquen a los estudiantes de su(s) misma(s) sección(es). Los temas de discusión y las páginas no se ven afectados por las limitaciones de sección y cualquier estudiante puede verlos. Estas áreas de funciones podrían restringirse creando contenido en los grupos del curso.
- Notificar: Así es como eliges enviar una notificación a los usuarios inscritos cuando están inscritos en un curso.
Nota: Se recomienda el campo root_account para identificar usuarios en una cuenta confiable .
categorías_de_grupo.csv
Las categorías de grupo permiten organizar grupos en Canvas. Un archivo group_categories.csv permite crear categorías de grupo a nivel de cuenta o curso. En la interfaz de usuario, las categorías de grupo se denominan conjuntos de grupos.
Descargue un archivo group_categories.csv de muestra con las siguientes categorías de grupo:
- Grupos de administración
- Grupos de diseñadores
- Grupos de proyectos de historia
Campo obligatorio*| Campo pegajoso^
- id_de_categoría_de_grupo:Este es el identificador utilizado para referenciar la categoría del grupo. El identificador no debe cambiar para la categoría del grupo y debe ser único a nivel global.
- account_id: Este es el identificador que asocia la categoría de grupo a una cuenta (añadido en accounts.csv). Si no se especifica ninguna cuenta ni curso, el grupo se asociará a la cuenta raíz.
- course_id: Este es el identificador que asocia la categoría de grupo a un curso (añadido en courses.csv). Si no se especifica ningún curso ni cuenta, el grupo se asociará a la cuenta raíz.
- nombre_de_categoría*^ : Este es el nombre de la categoría del grupo.
- estado*:Este es el estado de la categoría de grupo. Marque como activa para crear la categoría de grupo o como eliminada para eliminarla.
grupos.csv
Un grupo puede usarse para brindar oportunidades de colaboración a estudiantes, instructores, administradores u otros usuarios. Un archivo groups.csv permite crear grupos a nivel de curso y de cuenta . Los grupos subidos mediante el SIS solo se pueden actualizar o eliminar mediante el SIS.
Descargue un archivo groups.csv de muestra con los siguientes grupos:
- Administradores
- Profesores de matemáticas
- Diseñadores
Campo obligatorio*| Campo pegajoso^
- id_de_grupo*:Este es el identificador único que se utiliza para referenciar a su grupo. No debe cambiar para el grupo y debe ser único a nivel global.
- group_category_id: Este es el identificador de la categoría de grupo (añadida en group_categories.csv) a la que se está añadiendo un grupo. Si no se especifica ninguna categoría de grupo, el grupo se colocará en la categoría predeterminada de la cuenta o curso definidos. Si no se especifica ninguna cuenta o curso, el grupo se colocará en la categoría predeterminada de la cuenta raíz.
- account_id: Este es el identificador que vincula el grupo a una cuenta (añadido en accounts.csv). Si no se especifica ninguno, el grupo se vinculará a la cuenta raíz.
- course_id: Este es el identificador que vincula el grupo a un curso (añadido en courses.csv). Si no se especifica ningún curso ni cuenta, el grupo se vinculará a la cuenta raíz.
- nombre*^: Este es el nombre del grupo.
- estado*:Este es el estado del grupo. Marcar como disponible para permitir la membresía o como eliminado para eliminarlo.
grupos_membresía.csv
La membresía en un grupo permite a los usuarios colaborar en actividades en Canvas. Un archivo groups_membership.csv permite añadir o eliminar personas de forma masiva a un grupo creado mediante groups.csv.
Descargue un archivo de muestra groups_membership.csv con las siguientes membresías de grupo:
- 1 usuario aceptado en el grupo Administradores
- 1 usuario aceptado en el grupo Profesores de Matemáticas
- 1 usuario eliminado en el grupo Profesores de Matemáticas
Campo obligatorio*
- id_de_grupo*:Este es el identificador único utilizado para hacer referencia a su grupo (agregado en groups.csv).
- id_usuario*:Este es el identificador único del usuario que desea agregar al grupo (agregado en users.csv).
- estado*:Este es el estado de los usuarios del grupo. Marcar como aceptado para agregar un usuario al grupo o como eliminado para eliminarlo.
xlists.csv
La inclusión cruzada de secciones permite trasladarlas a otro curso. Un archivo xlist.csv permite incluir secciones en cursos existentes y crear una jerarquía de secciones.
Se espera que los ID de sección ya existan y que hagan referencia a otros ID de curso. Si se proporciona un ID de sección en este archivo, se moverá de su ID de curso existente a uno nuevo. De esta manera, si se elimina este nuevo curso o se elimina la referencia cruzada, la sección volverá a su ID de curso anterior. Si xlist_course_id no hace referencia a un curso existente, se creará. Si desea proporcionar más información sobre el curso referenciado cruzadamente, hágalo en courses.csv.
Descargue un archivo xlists.csv de muestra con los siguientes cursos y secciones:
- 4 secciones activas del curso ACCT300 - Contabilidad de costos incluidas en el curso ACCT310 - Contabilidad gerencial
Campo obligatorio*
- xlist_id_del_curso*:Este es el identificador del nuevo curso (agregado en courses.csv).
- id_de_sección*:Este es el identificador de la sección (agregado en sections.csv).
- estado*:Este es el estado de la sección. Marcar como activa para activarla o eliminarla para eliminarla.
usuario_observadores.csv
El rol de observador permite inscribir a padres y vincularlos a un estudiante, permitiéndoles ver sus calificaciones e interacciones en el curso. Un archivo user_observers.csv permite inscribir y vincular observadores a cada una de las inscripciones del estudiante designado.
Descargue un archivo user_observers.csv de muestra con las siguientes inscripciones:
- 2 observadores activos
- 1 observador eliminado
Campo obligatorio*
- id_del_observador*:Este es el identificador único del observador (agregado como user_id en users.csv).
- ID de estudiante*:Este es el identificador único del estudiante (agregado como user_id en users.csv).
- estado*:Este es el estado del observador. Marque como activo para inscribirlo en cada inscripción del estudiante o como eliminado para eliminar todas las inscripciones del observador.
inicios de sesión.csv
El archivo logins.csv permite crear o actualizar las credenciales de inicio de sesión de los usuarios. Solo se pueden añadir inicios de sesión a usuarios existentes. Se pueden eliminar mediante users.csv.
Descargue un archivo logins.csv de muestra con tres inicios de sesión de usuario.
Campo obligatorio*| Campo pegajoso^
- id_usuario*:Este es el identificador único del usuario (referenciado en enrollments.csv). Este valor no debe cambiar para el usuario y debe ser único para todos los usuarios. Se denomina ID de SIS en la interfaz de usuario de Canvas.
- integration_id: Este es un identificador único secundario útil para integraciones complejas de SIS. Este valor no debe cambiar para el usuario y debe ser único para todos los usuarios. Este campo debe dejarse en blanco al fusionar usuarios con IDs de integración coincidentes.
- ID de inicio de sesión*:Este es el nombre que el usuario usaría para iniciar sesión en Canvas. Para servicios de autenticación configurados, como LDAP, este será el nombre de usuario del sistema remoto.
- Contraseña: Esta es la contraseña que el usuario usará para iniciar sesión en Canvas. Este campo no debe completarse en cuentas configuradas con LDAP o SSO.
- ssha_password: Esta es una contraseña generada con un esquema de generación SSHA pre-hash.
- authentication_provider_id: este es el proveedor de autenticación con el que está asociado el inicio de sesión.
- existing_user_id^: Este es el ID SIS del usuario, tal como se encuentra en users.csv.
- existing_integration_id^: Este es el ID de integración del usuario, tal como se encuentra en users.csv.
- existing_canvas_user_id^: Este es el ID de Canvas del usuario.
- root_account: Esta es la cuenta de dominio del usuario.
- correo electrónico: esta es la dirección de correo electrónico del usuario.
Notas:
- existing_user_id, existing_integration_id o existing_canvas_user_id*: (necesario para una importación exitosa de logins.csv)
- root_account*: (obligatorio al identificar usuarios en unacuenta de confianzapor ejemplo, al incluir en listas cruzadas usuarios de distintas cuentas dentro de una cuenta de confianza).
- estado*: (obligatorio al realizar una importación SIS usando logins.csv)
administradores.csv
Los administradores gestionan la configuración de una cuenta completa o una subcuenta. Un archivo admins.csv permite designar usuarios en Canvas como administradores de cuenta u otros roles personalizados para la cuenta o subcuenta.
Descargue un archivo admins.csv de muestra con los siguientes administradores:
- 2 administradores de cuentas activos
- 1 cuenta de administrador eliminada
- 2 roles de cuenta personalizados activos
Campo obligatorio*
- id_usuario*: Este es el ID único del usuario que desea designar como administrador (agregado en users.csv).
- ID de cuenta*: Este es el identificador único de la cuenta donde desea que resida el administrador (añadido en accounts.csv). Si esta columna se deja en blanco, el usuario residirá en la cuenta raíz. Esta columna siempre es obligatoria, incluso si el valor está en blanco.
- role_id*: (obligatorio si falta el rol)Este es el ID del rol, ya sea el ID predeterminado o un ID personalizado definido por la cuenta.
- rol*: (obligatorio si falta el role_id)Este es el nombre del rol, ya sea el rol predeterminado de administrador de cuenta o un rol personalizado definido por la cuenta. Si agrega un administrador de cuenta, formatee el campo como "AccountAdmin". Si agrega un rol personalizado, formatee el campo exactamente como aparece en la interfaz de usuario de Canvas.
- estado*: Este es el estado del administrador. Marcar como activo para crear un administrador activo o como eliminado para eliminarlo.
- root_account: Este es el dominio de la cuenta para buscar el usuario.
cambio_sis_id.csv
Un ID de SIS es un identificador único para un objeto en Canvas. Un archivo change_sis_id.csv permite cambiar de forma masiva los ID de SIS de cuentas, períodos, cursos, secciones, grupos o usuarios existentes.
Descargue un archivo change_sis_id.csv de muestra con los siguientes cambios de ID de SIS:
- 1 cambio de ID de SIS de usuario
- 1 cambio de ID de SIS del curso
- Cambio de ID de SIS de 1 término
Campo obligatorio*
- id_antiguo*: Este es el ID SIS actual del objeto.
- nuevo_id*: Este es el ID de SIS deseado para el objeto. El nuevo ID de SIS debe ser único para el tipo de objeto y la cuenta raíz.
- tipo*: Este es el tipo de objeto. Puede ser cuenta, trimestre, curso, sección, grupo o usuario.