Handshake richtet für jede Hochschule einen isolierten Speicherort in einem dafür bestimmtenAmazon S3-Bucket ein, damit Sie Ihre Studierende-Dateien übertragen können.

1. Die Hochschule lädt Daten in den S3-Bucket von Handshake mit dem spezifischen Verzeichnis ihrer Hochschule hoch.
2. Das Importer-Tool von Handshake wird Ihre Studierende-Daten analysieren und Feedback oder erforderliche Formatierungsänderungen per E-Mail oder auf der Benutzeroberfläche (UI) zur Verfügung stellen.
3. Das Importer-Tool von Handshake wird Ihre Studierende-Daten in Handshake hochladen und es wird entweder Ihre bestehenden Studierende-Daten aktualisieren oder die neuen Studenten erstellen, die importiert wurden.

WICHTIGE HINWEISE:

• Sie haben nur Schreibberechtigungen für den Ordner Ihrer Hochschule.
• Diese S3-Verzeichnisse sind Write-Only, so dass alle Versuche, Inhalte zu erhalten/aufzulisten (GET/LIST) zur Fehlermeldung „Zugriff verweigert“ führen werden.
• 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 benötigt LIST-Zugriff auf S3 Buckets und kann daher nicht verwendet werden.
• Im Vereinigten Königreich, muss die Region auf eu-central-1 eingestellt sein, damit Ihre Dateiübertragung funktioniert.
  • Hinweis: Bei bestehenden Konten, die vor dem 01/07/2023 für die automatische Ausführung konfiguriert wurden, kann die Region weiterhin auf: eu-west-2 eingestellt werden.

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

Wenn Sie Python bereits haben, können Sie das CLI mit den folgenden Anweisungen installieren (siehe hier für weitere Installationsdetails, basierend auf Ihrem Betriebssystem):

Pip-Installation --Upgrade --Benutzer AWSCLI

Wenn Sie Python nicht haben, können Sie es mit dem gebündelten 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 das AWS CLI zu verwenden, finden Sie alternative Optionen hier.

Bitte kontaktieren Sie das technische Support-Team von Handshake hier, um die Anmeldedaten für das Hochladen von Daten auf Handshake zu erhalten. Sofern Sie keine anderen Anweisungen vom Handshake-Team erhalten, sollten Sie im Vereinigten Königreich „eu-central-1“ als Ihre 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! Beachten Sie, dass Sie eine E-Mail erhalten haben sollten, in der der genaue Pfad für den Upload Ihrer Datei angegeben wird (wenn Sie diese nicht erhalten haben, 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. Dies wird die Datei an das Importer-Konto Ihrer Hochschule senden und sie wird auf etwaige Datei-/Formatierungsfehler geprüft, aber nicht bearbeitet.

1. Melden Sie sich beim Importer an und überprüfen Sie, ob Ihre Datei akzeptiert wurde und alle Analysen 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 bearbeitet werden kann.

Das Skript, das Sie verwenden, lädt die Datei nicht erfolgreich auf Ihren S3-Bucket hoch.
Behebung: Überprüfen Sie den Pfad Ihres Skripts und stellen Sie sicher, dass es erfolgreich zurückkehrt wird und Ihnen den Pfad des hochgeladenen Objekt 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 Analysen bestanden hat, wenden Sie sich bitte an unser technisches Support-Team mit der zugehörigen Importer-Job-URL, damit wir sie bearbeiten und auf Fehlern überprüfen können. Bei einem erfolgreichen Upload werden wir Autorun für Ihre Hochschule aktivieren!

Nachdem wir Autorun für Ihre AWS-Uploads aktiviert haben, empfehlen wir, Cron zu verwenden, um einen wiederkehrenden Upload zu planen. Hier sind 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 Ihren Upload (abhängig von dem Workflow / den 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-Einreichung Fehlermeldungen erhalten, können Sie die CLI-Fehler-Anleitung von Amazon verwenden, um die Fehlerursache und die zugehörige Lösung zu finden. Wenn Sie Hilfe bei dieser Fehlerbehebung benötigen, wenden Sie sich bitte an den Support, um Hilfe zu erhalten.