En CSV Gateway er en metode til at automatisere importen af CSV-filer til Canvas. Filer overføres ved hjælp af Secure File Transfer Protocol (SFTP). CSV Gateway kan være særligt nyttig, hvis dit SIS ikke har en direkte API-integrationsforbindelse til Canvas.
Hvis du er interesseret i at oprette en CSV Gateway/SFTP til datalevering eller eksport af karakterer, bedes du kontakte din Instructure Customer Success Manager (CSM).
Hvad du bør vide
- CSV-filer skal være justeret i henhold til retningslinjerne for Canvas CSV-format. Du kan finde flere oplysninger om Canvas CSV-formatering ivores guide.
- Standard CSV-regler gælder:
- Den første række fortolkes som overskriften og er obligatorisk.
- Al tekst i filen skal være UTF-8-kodet
- Alle tidsstempler skal være formateret i ISO 8601. Alle tidsstempler er som standard indstillet til UTC, medmindre tidszoneforskydning er angivet.
- Importer sker ikke i realtid. Synkroniseringsjob er planlagt. Hyppigheden afhænger af dit datasæt og kan drøftes nærmere med din Instructure-konsulent. De mest almindelige planlagte synkroniseringer er en eller to gange dagligt.
- En valgfriRapport om eksport af karaktererkan planlægges til at blive placeret i gatewayen én gang dagligt.
- EnForskelligMappen kan konfigureres efter anmodning. Differenserede importer vil søge efter ændringer i de leverede filer og reagere på eventuelle manglende poster. Hvis du er interesseret i at få dette konfigureret, kan din Instructure-konsulent give dig yderligere oplysninger om konfigurationen.
- Når SFTP'en er konfigureret og synkroniseret med produktion, skal klienten kontakte support for fejlfinding og/eller ændringer i SFTP'ens konfiguration.
Hvordan kommer jeg i gang?
Først skal klienten bestemme, hvem der skal være vært for SFTP-serveren. Der er to muligheder for at være vært for SFTP-serveren.
- Instructure kan være vært for serveren
- Klienten er vært for SFTP-serveren
Klienten er ansvarlig for at oprette CSV-filer til deres data, der er afstemt med Canvas CSV-specifikationer, og levere disse filer til SFTP-serveren. Instructure behandler derefter de placerede filer baseret på planlagte job.
CSV-gatewayen vil i første omgang blive forbundet til klientens Canvas Beta-instans til indledende testning. Forbindelsen vil ikke blive skiftet til klientens Canvas Production-instans, før klienten giver skriftlig bekræftelse på at afslutte testningen til sin Instructure-konsulent.
Instructure-hostet server
Hvis Instructure hoster SFTP-serveren, skal klienten generere et SSH-nøglepar. Den offentlige nøgle sendes til din Instructure-konsulent.
Den private nøgle bør ikke deles. Hvis den private nøgle deles, vil Instructure anmode om, at et nyt nøglepar genereres.
Når du genererer SSH-nøgleparret, skal du være opmærksom på følgende:
- Instructure kræver en minimumsbitlængde på 2048 på nøglen
- Offentlige nøgler har typisk en af følgende filtypenavne: .pub, .pem
- Nogle nøgleformater vil have den private nøgle sammen med den offentlige nøgle. Send os kun den offentlige nøgle, ellers skal nøgleparret genereres igen.
Når den offentlige nøgle er blevet delt med Instructure-konsulenten og uploadet til SFTP-serveren, vil klienten modtage følgende oplysninger:
- Server
- Havn
- Brugernavn
- Vejviser
- Synkroniseringsplan
Klienthostet server
Hvis klienten vælger at hoste SFTP-serveren, skal Instructure have forbindelsesoplysningerne.
Send ikke disse oplysninger i en e-mail.
Din Instructure-konsulent vil give dig et sikkert link til at uploade en .txt-fil med følgende oplysninger:
- Server
- Havn
- Brugernavn
- Godkendelse
- Mappe/Katalog
Udover at give din Instructure-konsulent de ønskede oplysninger, kan klienten være nødt til at tilføje Instructures IP-adresser til en tilladelsesliste. Din Instructure-konsulent vil give dig de ønskede oplysninger. Yderligere konfiguration/justeringer kan være nødvendige på klientens hostede server, hvis Instructure ikke kan oprette forbindelse til den eksterne SFTP-server.