Handshake richtet für jede Hochschule einen isolierten Speicherort in einem bestimmten Amazon S3 Bucket ein, in den Sie Ihre Studierende übertragen können.

1. Hochschule lädt Daten in den S3-Bucket von Handshake mit dem spezifischen Verzeichnis ihrer Hochschule hoch
2. Das Importer-Tool von Handshake analysiert Ihre Studierenden und stellt Feedback oder erforderliche Formatierungsänderungen per E-Mail oder in der Benutzeroberfläche bereit
3. Das Importer-Tool von Handshake lädt Ihre Studierenden in Handshake hoch und aktualisiert entweder Ihre vorhandenen Studierenden oder erstellt die neuen importierten Studierenden

WICHTIGE NOTIZEN:

• Sie haben nur Schreibrechte für den Ordner Ihrer Hochschule.
• Diese S3-Verzeichnisse sind schreibgeschützt, sodass alle Versuche, Inhalte abzurufen/aufzulisten, zu der Fehlermeldung „Zugriff verweigert“ führen.
• Wir unterstützen alle Standardmethoden für das Hochladen auf AWS S3, die PUT-Zugriff benötigen.
• Wir unterstützen FTP/SFTP aufgrund des erforderlichen LIST-Zugriffs nicht. WinSCP erfordert LIST-Zugriff auf S3 Buckets und kann daher nicht verwendet werden.
• In Europa muss die Region auf eu-central-1 eingestellt sein, damit Ihre Dateiübertragung funktioniert.
  • Hinweis: Bei vorhandenen Konten, die die automatische Ausführung vor 01.07.2023 konfiguriert haben, kann die Region weiterhin auf eu-west-2festgelegt werden.

Wir empfehlen die Verwendung des CLI-Tools von Amazon, da dies das beste Tool für die Interaktion mit AWS S3 für Ihre Studierenden-Uploads ist. Wenn Sie dieses Tool nicht verwenden können, informieren Sie bitte unser Support-Team.

Wenn Sie bereits über Python verfügen, können Sie die CLI mithilfe der folgenden Anweisungen installieren (weitere Installationsdetails finden Sie hier, basierend auf Ihrem Betriebssystem):

Pip-Installation --Upgrade --Benutzer AWSCLI

Wenn Sie Python nicht haben, können Sie es mit dem mitgelieferten Installationsprogramm hier installieren.

curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"
unzip awscli-bundle.zip
# mit sudo 
sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

# ohne sudo (angenommen, dass ~/bin in Ihrem PATH ist)
./awscli-bundle/install -b ~/bin/aws

Wenn Sie Python nicht haben und es nicht installieren können, um die AWS CLI zu verwenden, finden Sie hier alternative Optionen.

Bitte wenden Sie sich hier an das technische Support-Team von Handshake, um die AWS-Anmeldeinformationen zum Hochladen von Daten auf Handshake zu erhalten. Sofern vom Handshake-Team nicht anders angegeben, sollten Sie in Europa „eu-central-1“ als Region verwenden.

Führen Sie als nächstes Folgendes aus und geben Sie Ihren AWS-Zugangsschlüssel und Ihren geheimen Schlüssel ein:

aws konfigurieren
AWS-Zugangsschlüssel ID [****************JRTA]:
AWS Geheimer Zugangsschlüssel [****************RZ7O]:
Standardname-Region [EU-Central-1]:
Standardausgabeformat [None]:

Jetzt sind Sie bereit, Ihre Datei auf Handshake hochzuladen! Hinweis, dass Sie eine E-Mail mit dem genauen AWS S3 Path zum Hochladen Ihrer Datei erhalten haben sollten (falls nicht, wenden Sie sich bitte an das Support-Team).

Upload Syntax:

AWS S3 CP [/path/your_local_file] s3://handshake-importer-uploads/[your folder]/[yyyymmdd]_users.csv

Beispiel Upload und Antwort

AWS S3 CP 20140410_users.csv s3://handshake-importer-uploads/importer-production-hudson_university/20140410_users.csv

Upload: auf s3://handshake-importer-uploads/importer-production-hudson_university/20140410_users.csv

Die AWS S3 API antwortet mit der Dokument-ID, wenn die Datei erfolgreich übertragen wurde, andernfalls mit einer Fehlermeldung. Sie können auch den Exit-Code des Befehls überprüfen, um festzustellen, ob er erfolgreich war.

Wenn Sie einen Test-Upload senden möchten, senden Sie einfach eine Datei, die „Test“ im Dateinamen enthält. Dadurch wird die Datei an das Importer-Konto Ihrer Hochschule geschickt und auf Datei-/Formatierungsfehler untersucht, aber nicht verarbeitet.

1. Loggen Sie sich in den Importer ein und überprüfen Sie, ob Ihre Datei akzeptiert wurde und alle Analyse Prüfungen bestanden hat.

Hier sind einige häufige Probleme, die möglicherweise aufgetreten sind, wenn Sie die Datei nicht sehen:

Die Datei ist keine tatsächliche CSV-Datei
Behebung: Vergewissern Sie sich, dass die Datei, die Sie hochzuladen versuchen, manuell in den Importer hochgeladen und erfolgreich verarbeitet werden kann.

Das Skript, das Sie ausführen, lädt die Datei nicht erfolgreich in Ihren S3-Bucket hoch.
Behebung: Überprüfen Sie Ihren Skriptpfad und stellen Sie sicher, dass er erfolgreich zurückkehrt und Ihnen den Pfad des hochgeladenen Objekts zurückgibt.

2. Stellen Sie sicher, dass die hochgeladenen Daten alle Analysen bestehen. Wenn dies nicht der Fall ist, müssen Sie Anpassungen an Ihrem Extrakt-Skript vornehmen, bevor wir Autorun für Sie einschalten können.
   
   
3. Wenn Ihre Datei alle Analyse Prüfungen bestanden hat, wenden Sie sich bitte mit der zugehörigen URL des Importer-Jobs an unser technisches Support-Team, damit wir diese verarbeiten und auf Fehler überprüfen können. Nach erfolgreichem Upload aktivieren wir die Autorun-Funktion für Ihre Hochschule!

Nachdem wir Autorun für Ihre AWS-Uploads aktiviert haben, empfehlen wir, Cron zu verwenden, um einen wiederkehrenden Upload zu planen. Hier finden Sie Anweisungen zum Einrichten von cron (für Linux) sowie für den Windows Task Scheduler (wenn Sie keinen Linux-Server für diese Uploads verwenden).

Wählen Sie ein wöchentliches, monatliches oder halbjährliches Datum für den Upload (abhängig von den Arbeitsabläufen/Bedürfnissen Ihrer Hochschule). Im Allgemeinen ist das Format:

 +---------------- Minute (0 — 59)
 |  +------------- Stunde (0 — 23)
 |  |  +---------- Tag des Monats (1 — 31)
 |  |  |  +------- Monat (1 — 12)
 |  |  |  |  +---- Wochentag (0 — 6) (Sonntag=0 oder 7)
 |  |  |  |  |
 *  *  *  *  *  Befehl, der ausgeführt werden soll

Beispiel:

5 8 * * Sat AWS S3 CP users.CSV s3://handshake-importer-uploads/importer-production-hudson_university/`date +"%Y-%m-%d"`_users.csv  >/dev/null 2>&1

Fehlerbehebung bei AWS-Fehlern

Wenn Sie während Ihrer AWS-Anmeldung Fehlermeldungen erhalten, können Sie in Amazons CLI-Fehlerleitfaden nachsehen, um die Fehlerquelle und die zugehörige Lösung zu finden. Wenn Sie Hilfe bei der Fehlersuche benötigen, wenden Sie sich bitte an den Support.