Ein CSV-Gateway automatisiert den Import von CSV-Dateien in Canvas. Die Dateiübertragung erfolgt über das Secure File Transfer Protocol (SFTP). Das CSV-Gateway ist besonders hilfreich, wenn Ihr Studierendeninformationssystem (SIS) keine direkte API-Integration mit Canvas bietet.
Wenn Sie Interesse an der Einrichtung eines CSV-Gateways/SFTP für die Datenbereitstellung oder den Export von Noten haben, wenden Sie sich bitte an Ihren Instructure Customer Success Manager (CSM).
Was Sie wissen sollten
- CSV-Dateien müssen den Canvas-CSV-Formatrichtlinien entsprechen. Weitere Informationen zur Canvas-CSV-Formatierung finden Sie unter unser LeitfadenDie
- Es gelten die Standardregeln für CSV-Dateien:
- Die erste Zeile wird als Überschrift interpretiert und ist obligatorisch.
- Der gesamte Text in der Datei muss UTF-8-kodiert sein.
- Alle Zeitstempel sollten im ISO-8601-Format vorliegen. Standardmäßig werden alle Zeitstempel in UTC angezeigt, sofern keine Zeitzonenabweichung angegeben ist.
- Importe erfolgen nicht in Echtzeit. Synchronisierungsaufträge werden geplant. Die Häufigkeit hängt von Ihrem Datensatz ab und kann mit Ihrem Instructure-Berater genauer besprochen werden. Üblicherweise werden Synchronisierungen ein- bis zweimal täglich durchgeführt.
- Eine optionaleNotenexportberichtkann so geplant werden, dass es einmal täglich im Gateway platziert wird.
- A DifferenzierungDas Verzeichnis kann auf Anfrage konfiguriert werden. Beim Vergleichsimport werden die gelieferten Dateien auf Änderungen geprüft und fehlende Datensätze entsprechend angepasst. Wenn Sie diese Konfiguration wünschen, kann Ihnen Ihr Instructure-Berater weitere Informationen dazu geben.
- Nachdem der SFTP-Server konfiguriert und mit der Produktionsumgebung synchronisiert wurde, muss sich der Kunde an den Support wenden, um Probleme zu beheben und/oder Konfigurationsänderungen am SFTP-Server vorzunehmen.
Wie fange ich an?
Zunächst muss der Kunde festlegen, wer den SFTP-Server hosten soll. Es gibt zwei Möglichkeiten für das Hosting des SFTP-Servers.
- Instructure kann den Server hosten.
- Client hostet SFTP-Server
Der Kunde ist verantwortlich für die Erstellung der CSV-Dateien seiner Daten gemäß den Canvas-CSV-Spezifikationen und die Übermittlung dieser Dateien an den SFTP-Server. Instructure verarbeitet die hochgeladenen Dateien anschließend anhand geplanter Aufträge.
Das CSV-Gateway wird zunächst für erste Tests mit der Canvas-Beta-Instanz des Kunden verbunden. Die Verbindung wird erst dann auf die Canvas-Produktionsinstanz des Kunden umgeschaltet, wenn der Kunde seinem Instructure-Berater schriftlich die Beendigung der Tests bestätigt hat.
Instructure-gehosteter Server
Wenn Instructure den SFTP-Server hostet, muss der Kunde ein SSH-Schlüsselpaar generieren. Der öffentliche Schlüssel wird an Ihren Instructure-Berater gesendet.
Der private Schlüssel darf nicht weitergegeben werden. Sollte dies dennoch geschehen, fordert Instructure die Generierung eines neuen Schlüsselpaares an.
Bitte beachten Sie bei der Generierung des SSH-Schlüsselpaares Folgendes:
- Instructure benötigt eine minimale Bitlänge von 2048 am Schlüssel.
- Öffentliche Schlüssel haben typischerweise eine der folgenden Dateiendungen: .pub, .pem
- Bei manchen Schlüsselformaten ist der private Schlüssel zusammen mit dem öffentlichen Schlüssel enthalten. Senden Sie uns bitte nur den öffentlichen Schlüssel, da das Schlüsselpaar sonst neu generiert werden muss.
Nachdem der öffentliche Schlüssel dem Instructure-Berater mitgeteilt und auf den SFTP-Server hochgeladen wurde, erhält der Kunde folgende Informationen:
- Server
- Hafen
- Benutzername
- Verzeichnis
- Synchronisierungszeitplan
Clientseitig gehosteter Server
Wenn der Kunde den SFTP-Server selbst hosten möchte, muss Instructure die Verbindungsinformationen mitgeteilt werden.
Senden Sie diese Informationen nicht per E-Mail.
Ihr Instructure-Berater stellt Ihnen einen sicheren Link zum Hochladen einer .txt-Datei mit folgenden Informationen zur Verfügung:
- Server
- Hafen
- Benutzername
- Authentifizierung
- Ordner/Verzeichnis
Zusätzlich zu den von Ihnen angeforderten Informationen muss der Kunde möglicherweise die IP-Adressen von Instructure zu einer Zulassungsliste hinzufügen. Ihr Instructure-Berater wird Ihnen die benötigten Informationen zur Verfügung stellen. Sollte Instructure keine Verbindung zum Remote-SFTP-Server herstellen können, sind möglicherweise weitere Konfigurationen/Anpassungen auf dem Server des Kunden erforderlich.