Une passerelle CSV permet d'automatiser l'importation de fichiers CSV dans Canvas. Les fichiers sont transférés via le protocole SFTP (Secure File Transfer Protocol). La passerelle CSV s'avère particulièrement utile si votre système d'information scolaire (SIS) ne dispose pas d'une connexion API directe avec Canvas.
Si vous souhaitez configurer une passerelle CSV/SFTP pour l'approvisionnement en données ou l'exportation de notes, veuillez contacter votre responsable de la réussite client (CSM) chez Instructure.
Ce que vous devez savoir
- Les fichiers CSV doivent être conformes aux directives de formatage CSV de Canvas. Vous trouverez plus d'informations sur le formatage CSV de Canvas dans notre guide.
- Les règles standard du format CSV s'appliquent :
- La première ligne est interprétée comme l'en-tête et est obligatoire.
- Tout le texte contenu dans le fichier doit être encodé en UTF-8.
- Tous les horodatages doivent être au format ISO 8601. Par défaut, tous les horodatages sont en UTC, sauf indication contraire.
- Les importations ne sont pas effectuées en temps réel. Les tâches de synchronisation sont planifiées. Leur fréquence dépend de votre ensemble de données et peut être discutée plus en détail avec votre consultant Instructure. La plupart des synchronisations planifiées ont lieu une ou deux fois par jour.
- Une option Rapport d'exportation de notespeut être programmé pour être placé dans la passerelle une fois par jour.
- UN DifférentLe répertoire peut être configuré sur demande. Les importations avec comparaison analyseront les fichiers livrés et traiteront les enregistrements manquants. Si vous souhaitez configurer cette fonctionnalité, votre consultant Instructure vous fournira des informations complémentaires.
- Une fois le serveur SFTP configuré et synchronisé en production, le client devra contacter le support technique pour le dépannage et/ou toute modification de la configuration du serveur SFTP.
Comment commencer ?
Tout d'abord, le client doit déterminer qui hébergera le serveur SFTP. Deux options d'hébergement sont possibles.
- Instructure peut héberger le serveur
- Le client héberge le serveur SFTP
Il incombe au client de créer les fichiers CSV de ses données conformément aux spécifications CSV de Canvas et de les transférer sur le serveur SFTP. Instructure traitera ensuite ces fichiers selon les tâches planifiées.
La passerelle CSV sera initialement connectée à l'instance Canvas Beta du client pour les tests initiaux. La connexion ne sera basculée vers l'instance Canvas de production du client qu'après confirmation écrite de la fin des tests par ce dernier à son consultant Instructure.
Serveur hébergé par Instructure
Si Instructure héberge le serveur SFTP, le client devra générer une paire de clés SSH. La clé publique sera envoyée à votre consultant Instructure.
La clé privée ne doit pas être partagée. Si elle l'est, Instructure demandera la génération d'une nouvelle paire de clés.
Lors de la génération de la paire de clés SSH, veuillez tenir compte des points suivants :
- Instructure exige une longueur minimale de 2048 bits pour la clé
- Les clés publiques ont généralement l'une des extensions suivantes : .pub, .pem
- Certains formats de clés contiennent la clé privée et la clé publique. Veuillez nous envoyer uniquement la clé publique, sinon la paire de clés devra être régénérée.
Une fois la clé publique partagée avec le consultant Instructure et téléchargée sur le serveur SFTP, le client recevra les informations suivantes :
- Serveur
- Port
- Nom d'utilisateur
- Annuaire
- Planification de la synchronisation
Serveur hébergé par le client
Si le client choisit d'héberger le serveur SFTP, Instructure devra recevoir les informations de connexion.
Veuillez ne pas envoyer ces informations par courriel.
Votre consultant Instructure vous fournira un lien sécurisé pour télécharger un fichier .txt contenant les informations suivantes :
- Serveur
- Port
- Nom d'utilisateur
- Authentification
- Dossier/Répertoire
Outre la communication des informations demandées à votre consultant Instructure, il se peut que vous deviez ajouter les adresses IP d'Instructure à une liste blanche. Votre consultant Instructure vous fournira les informations nécessaires. Si Instructure ne parvient pas à se connecter au serveur SFTP distant, une configuration ou des ajustements supplémentaires peuvent être nécessaires sur le serveur hébergé du client.