En CSV-gateway är en metod för att automatisera importen av CSV-filer till Canvas. Filer överförs med hjälp av Secure File Transfer Protocol (SFTP). CSV-gatewayen kan vara särskilt användbar om ditt SIS inte har en direkt API-integrationsanslutning till Canvas.
Om du är intresserad av att konfigurera en CSV Gateway/SFTP för datahantering eller betygsexport, vänligen kontakta din Instructure Customer Success Manager (CSM).
Vad du bör veta
- CSV-filer måste vara anpassade till Canvas CSV-formatriktlinjer. Mer information om Canvas CSV-formatering finns ivår guide.
- Standardregler för CSV gäller:
- Den första raden tolkas som rubrik och är obligatorisk.
- All text i filen måste vara UTF-8-kodad
- Alla tidsstämplar ska vara formaterade enligt ISO 8601. Alla tidsstämplar har UTC som standard om inte tidszonsförskjutning anges.
- Importer sker inte i realtid. Synkroniseringsjobb är schemalagda. Frekvensen beror på din datamängd och kan diskuteras mer med din Instructure-konsult. De vanligaste schemalagda synkroniseringarna sker en eller två gånger dagligen.
- Ett valfrittRapport om betygsexportkan schemaläggas att placeras i gatewayen en gång dagligen.
- EnOlikaKatalogen kan konfigureras på begäran. Differensimporter letar efter ändringar i de levererade filerna och vidtar åtgärder för eventuella poster som saknas. Om du är intresserad av att få detta konfigurerat kan din Instructure-konsult ge ytterligare information vid konfigurationen.
- När SFTP har konfigurerats och synkroniserats med produktion måste klienten kontakta supporten för felsökning och/eller eventuella konfigurationsändringar av SFTP.
Hur kommer jag igång?
Först måste klienten bestämma vem som ska vara värd för SFTP-servern. Det finns två alternativ för att vara värd för SFTP-servern.
- Instructure kan vara värd för servern
- Klienten är värd för SFTP-servern
Klienten ansvarar för att skapa CSV-filer för sina data i enlighet med Canvas CSV-specifikationer och leverera dessa filer till SFTP-servern. Instructure bearbetar sedan de placerade filerna baserat på schemalagda jobb.
CSV-gatewayen kommer initialt att anslutas till klientens Canvas Beta-instans för initial testning. Anslutningen kommer inte att växlas till klientens Canvas Production-instans förrän klienten skriftligen bekräftar att testningen är avslutad till sin Instructure-konsult.
Instructure-hostad server
Om Instructure är värd för SFTP-servern måste klienten generera ett SSH-nyckelpar. Den offentliga nyckeln skickas till din Instructure-konsult.
Den privata nyckeln ska inte delas. Om den privata nyckeln delas kommer Instructure att begära att ett nytt nyckelpar genereras.
Tänk på följande när du genererar SSH-nyckelparet:
- Instructure kräver en minsta bitlängd på 2048 på nyckeln.
- Publika nycklar har vanligtvis ett av följande filändelser: .pub, .pem
- Vissa nyckelformat har den privata nyckeln tillsammans med den publika nyckeln, skicka bara den publika nyckeln till oss, annars måste nyckelparet genereras på nytt.
Efter att den publika nyckeln har delats med Instructure-konsulten och laddats upp till SFTP-servern kommer klienten att få följande information:
- Server
- Hamn
- Användarnamn
- Katalog
- Synkroniseringsschema
Klienthostad server
Om klienten väljer att vara värd för SFTP-servern måste Instructure få anslutningsinformationen.
Skicka inte denna information i ett e-postmeddelande.
Din Instructure-konsult kommer att förse dig med en säker länk för att ladda upp en .txt-fil med följande information:
- Server
- Hamn
- Användarnamn
- Autentisering
- Mapp/katalog
Förutom att förse din Instructure-konsult med den begärda informationen kan klienten behöva lägga till Instructures IP-adresser i en godkännandelista. Din Instructure-konsult kommer att förse dig med den begärda informationen. Ytterligare konfiguration/justeringar kan behövas på klientens värdbaserade server om Instructure inte kan ansluta till den fjärranslutna SFTP-servern.