Un gateway CSV è un metodo per automatizzare l'importazione di file CSV in Canvas. I file vengono trasferiti utilizzando il protocollo SFTP (Secure File Transfer Protocol). Il gateway CSV può essere particolarmente utile se il tuo sistema informativo scolastico (SIS) non dispone di un'integrazione API diretta con Canvas.
Se sei interessato a configurare un gateway CSV/SFTP per la condivisione dei dati o l'esportazione dei voti, contatta il tuo Customer Success Manager (CSM) di Instructure.
Cosa dovresti sapere
- I file CSV devono essere conformi alle linee guida del formato CSV di Canvas. Ulteriori informazioni sulla formattazione CSV di Canvas sono disponibili inla nostra guida.
- Si applicano le regole standard del formato CSV:
- La prima riga viene interpretata come intestazione ed è obbligatoria.
- Tutto il testo all'interno del file deve essere codificato in UTF-8.
- Tutti i timestamp devono essere formattati secondo lo standard ISO 8601. Tutti i timestamp sono impostati di default su UTC, a meno che non venga specificato un offset di fuso orario.
- Le importazioni non avvengono in tempo reale. Le sincronizzazioni sono programmate. La frequenza dipenderà dal set di dati e può essere discussa in dettaglio con il tuo consulente Instructure. Le sincronizzazioni programmate più comuni avvengono una o due volte al giorno.
- Un'opzioneRapporto di esportazione dei gradipuò essere programmato per essere posizionato nel gateway una volta al giorno.
- UN DifferenzaLa directory può essere configurata su richiesta. Le importazioni differenziali cercheranno le modifiche nei file consegnati e interverranno su eventuali record mancanti. Se sei interessato a configurare questa funzionalità, il tuo consulente Instructure potrà fornirti ulteriori informazioni al momento della configurazione.
- Una volta configurato e sincronizzato SFTP con l'ambiente di produzione, il cliente dovrà contattare l'assistenza per la risoluzione dei problemi e/o per qualsiasi modifica alla configurazione di SFTP.
Come posso iniziare?
Innanzitutto, il cliente deve stabilire chi ospiterà il server SFTP. Esistono due opzioni per l'hosting del server SFTP.
- Instructure può ospitare il server
- Il client ospita il server SFTP
Il cliente è responsabile della creazione dei file CSV contenenti i propri dati, conformi alle specifiche CSV di Canvas, e del loro invio al server SFTP. Instructure elaborerà quindi i file inviati in base a processi programmati.
Il gateway CSV verrà inizialmente connesso all'istanza Canvas Beta del cliente per i test iniziali. La connessione non verrà trasferita all'istanza Canvas di produzione del cliente finché quest'ultimo non fornirà una conferma scritta al proprio consulente Instructure per la conclusione dei test.
Server ospitato da Instructure
Se Instructure ospita il server SFTP, il cliente dovrà generare una coppia di chiavi SSH. La chiave pubblica verrà inviata al vostro consulente Instructure.
La chiave privata non deve essere condivisa. In caso di condivisione, Instructure richiederà la generazione di una nuova coppia di chiavi.
Quando generate la coppia di chiavi SSH, tenete presente quanto segue:
- Instructure richiede una lunghezza minima in bit di 2048 sulla chiave
- Le chiavi pubbliche in genere hanno una delle seguenti estensioni: .pub, .pem
- Alcuni formati di chiave includono sia la chiave privata che quella pubblica; in tal caso, inviateci solo la chiave pubblica, altrimenti sarà necessario rigenerare la coppia di chiavi.
Dopo che la chiave pubblica sarà stata condivisa con il consulente Instructure e caricata sul server SFTP, al cliente verranno fornite le seguenti informazioni:
- Server
- Porta
- Nome utente
- Elenco
- Programma di sincronizzazione
Server ospitato dal cliente
Se il cliente sceglie di ospitare il server SFTP, Instructure dovrà ricevere le informazioni di connessione.
Non inviare queste informazioni tramite e-mail.
Il tuo consulente Instructure ti fornirà un link sicuro per caricare un file .txt contenente le seguenti informazioni:
- Server
- Porta
- Nome utente
- Autenticazione
- Cartella/Directory
Oltre a fornire al proprio consulente Instructure le informazioni richieste, il cliente potrebbe dover aggiungere gli indirizzi IP di Instructure a una lista di indirizzi consentiti. Il consulente Instructure fornirà le informazioni necessarie. Potrebbero essere necessarie ulteriori configurazioni/modifiche sul server ospitato dal cliente qualora Instructure non riesca a connettersi al server SFTP remoto.