En CSV-gateway er en metode for å automatisere importen av CSV-filer til Canvas. Filer overføres ved hjelp av Secure File Transfer Protocol (SFTP). CSV-gatewayen kan være spesielt nyttig hvis SIS-systemet ditt ikke har en direkte API-integrasjonstilkobling til Canvas.
Hvis du er interessert i å sette opp en CSV-gateway/SFTP for datalevering eller karaktereksport, kan du kontakte din Instructure Customer Success Manager (CSM).
Det du bør vite
- CSV-filer må være i samsvar med retningslinjene for Canvas CSV-format. Mer informasjon om Canvas CSV-formatering finner du ivår guide.
- Standard CSV-regler gjelder:
- Den første raden tolkes som overskriften og er obligatorisk.
- All tekst i filen må være UTF-8-kodet
- Alle tidsstempler skal være formatert i henhold til ISO 8601. Alle tidsstempler har UTC som standard med mindre tidssoneforskyvning er angitt.
- Importer skjer ikke i sanntid. Synkroniseringsjobber er planlagte. Hyppigheten vil avhenge av datasettet ditt og kan diskuteres nærmere med din Instructure-konsulent. De vanligste planlagte synkroniseringene er én eller to ganger daglig.
- Et valgfrittKaraktereksportrapportkan planlegges til å plasseres i gatewayen én gang daglig.
- EnForskjelligKatalogen kan konfigureres på forespørsel. Differensiert import vil se etter endringer i de leverte filene og iverksette tiltak for eventuelle poster som mangler. Hvis du er interessert i å få dette konfigurert, kan din Instructure-konsulent gi deg ytterligere informasjon om konfigurasjonen.
- Etter at SFTP-en er konfigurert og synkronisert med produksjon, må klienten kontakte kundestøtte for feilsøking og/eller eventuelle endringer i SFTP-konfigurasjonen.
Hvordan kommer jeg i gang?
Først må klienten bestemme hvem som skal være vert for SFTP-serveren. Det finnes to alternativer for å være vert for SFTP-serveren.
- Instructure kan være vert for serveren
- Klienten er vert for SFTP-server
Klienten er ansvarlig for å bygge CSV-filene for dataene sine, i samsvar med Canvas CSV-spesifikasjoner, og levere disse filene til SFTP-serveren. Instructure vil deretter behandle de plasserte filene basert på planlagte jobber.
CSV-gatewayen vil i utgangspunktet bli koblet til klientens Canvas Beta-instans for innledende testing. Tilkoblingen vil ikke bli byttet til klientens Canvas Production-instans før klienten gir skriftlig bekreftelse på at testingen er fullført til sin Instructure-konsulent.
Instructure-hostet server
Hvis Instructure er vert for SFTP-serveren, må klienten generere et SSH-nøkkelpar. Den offentlige nøkkelen sendes til Instructure-konsulenten din.
Den private nøkkelen skal ikke deles. Hvis den private nøkkelen deles, vil Instructure be om at et nytt nøkkelpar genereres.
Når du genererer SSH-nøkkelparet, må du huske på følgende:
- Instructure krever en minimum bitlengde på 2048 på nøkkelen.
- Offentlige nøkler har vanligvis en av følgende filtypene: .pub, .pem
- Noen nøkkelformater vil ha den private nøkkelen sammen med den offentlige nøkkelen. Send oss bare den offentlige nøkkelen, ellers må nøkkelparet genereres på nytt.
Etter at den offentlige nøkkelen er delt med Instructure-konsulenten og lastet opp til SFTP-serveren, vil klienten få følgende informasjon:
- Server
- Havn
- Brukernavn
- Katalog
- Synkroniseringsplan
Klientbasert server
Hvis klienten velger å være vert for SFTP-serveren, må Instructure få tilkoblingsinformasjonen.
Ikke send denne informasjonen i en e-post.
Din Instructure-konsulent vil gi deg en sikker lenke for å laste opp en .txt-fil med følgende informasjon:
- Server
- Havn
- Brukernavn
- Autentisering
- Mappe/katalog
I tillegg til å gi din Instructure-konsulent den forespurte informasjonen, kan det hende klienten må legge til Instructures IP-adresser på en tillatelsesliste. Din Instructure-konsulent vil gi deg den forespurte informasjonen. Ytterligere konfigurasjon/justeringer kan være nødvendig på klientens hostede server hvis Instructure ikke kan koble til den eksterne SFTP-serveren.