Una puerta de enlace CSV es un método para automatizar la importación de archivos CSV a Canvas. Los archivos se transfieren mediante el Protocolo de Transferencia Segura de Archivos (SFTP). La puerta de enlace CSV puede ser especialmente útil si su sistema de información estudiantil (SIS) no cuenta con una conexión API directa a Canvas.
Si le interesa configurar una puerta de enlace CSV/SFTP para el suministro de datos o la exportación de calificaciones, póngase en contacto con su gestor de éxito del cliente (CSM) de Instructure.
Lo que debes saber
- Los archivos CSV deben ajustarse a las directrices de formato CSV de Canvas. Puede encontrar más información sobre el formato CSV de Canvas ennuestro guía.
- Se aplican las reglas estándar de CSV:
- La primera fila se interpreta como encabezado y es obligatoria.
- Todo el texto del archivo debe estar codificado en UTF-8.
- Todas las marcas de tiempo deben tener formato ISO 8601. Por defecto, todas las marcas de tiempo están en UTC, a menos que se especifique un desplazamiento de zona horaria.
- Las importaciones no se realizan en tiempo real. Las tareas de sincronización están programadas. La frecuencia dependerá de su conjunto de datos y puede consultarse con su asesor de Instructure. Lo más habitual es que las sincronizaciones programadas se realicen una o dos veces al día.
- Una opciónInforme de exportación de calificacionesSe puede programar para que se coloque en la puerta de enlace una vez al día.
- A DiferenciasEl directorio se puede configurar a petición. Las importaciones con comparación de diferencias buscarán cambios en los archivos entregados y tomarán medidas sobre los registros que falten. Si le interesa configurar esta función, su consultor de Instructure le proporcionará información adicional al momento de la configuración.
- Una vez configurado y sincronizado el SFTP con el entorno de producción, el cliente deberá ponerse en contacto con el servicio de soporte para solucionar problemas o realizar cualquier cambio de configuración del SFTP.
¿Cómo puedo empezar?
En primer lugar, el cliente debe determinar quién alojará el servidor SFTP. Hay dos opciones para alojar el servidor SFTP.
- Instructure puede alojar el servidor.
- El cliente aloja el servidor SFTP
El cliente es responsable de crear los archivos CSV con sus datos, de acuerdo con las especificaciones de Canvas CSV, y de enviarlos al servidor SFTP. Instructure procesará los archivos según las tareas programadas.
La puerta de enlace CSV se conectará inicialmente a la instancia beta de Canvas del cliente para realizar las pruebas iniciales. La conexión no se cambiará a la instancia de producción de Canvas del cliente hasta que este proporcione una confirmación por escrito a su consultor de Instructure para dar por finalizadas las pruebas.
Servidor alojado por Instructure
Si Instructure aloja el servidor SFTP, el cliente deberá generar un par de claves SSH. La clave pública se enviará a su consultor de Instructure.
La clave privada no debe compartirse. Si se comparte, Instructure solicitará la generación de un nuevo par de claves.
Al generar el par de claves SSH, tenga en cuenta lo siguiente:
- Instructure requiere una longitud mínima de bits de 2048 en la clave.
- Las claves públicas suelen tener una de las siguientes extensiones: .pub, .pem
- Algunos formatos de clave incluyen la clave privada junto con la clave pública; envíenos solo la clave pública o será necesario regenerar el par de claves.
Una vez que la clave pública se haya compartido con el consultor de Instructure y se haya cargado en el servidor SFTP, el cliente recibirá la siguiente información:
- Servidor
- Puerto
- Nombre de usuario
- Directorio
- Horario de sincronización
Servidor alojado por el cliente
Si el cliente opta por alojar el servidor SFTP, deberá proporcionar a Instructure la información de conexión.
No envíe esta información por correo electrónico.
Su consultor de Instructure le proporcionará un enlace seguro para cargar un archivo .txt con la siguiente información:
- Servidor
- Puerto
- Nombre de usuario
- Autenticación
- Carpeta/Directorio
Además de proporcionar a su consultor de Instructure la información solicitada, es posible que el cliente deba agregar las direcciones IP de Instructure a una lista de permitidos. Su consultor de Instructure le facilitará dicha información. Si Instructure no puede conectarse al servidor SFTP remoto, podrían ser necesarios ajustes o configuraciones adicionales en el servidor del cliente.