Was ist der Importer?
Der Importer wird sowohl intern bei Handshake als auch extern von unseren PartnerInnen verwendet, um Daten zu analysieren und in Handshake zu importieren.
Wie funktioniert der Importer?
Sie können sich den Importer als einen Vermittler zwischen einer CSV-Datei und Handshake vorstellen. Es wandelt eine CSV-Datei in JSON um, das in unsere API und in Handshake eingespeist wird.
Wie kann ich auf den Importer zugreifen?
Der Importer ist ein großartiges Tool, aber es ist etwas komplex und verarbeitet eine Menge sensibler Daten, daher bitten wir Sie, sich zunächst dieses Video in unserem Hilfe-Center anzusehen und den Anweisungen im Video zu folgen. Nachdem Sie fertig sind, kontaktieren Sie unser technisches Support-Team hier, um Zugang zum Importer zu erhalten.
Nachdem Sie Zugang zum Importer erhalten haben, werden Sie in der Lage sein, Daten von einer externen CSV-Datei in Handshake zu importieren! Dieser Artikel wird Ihnen einen Überblick darüber geben, wie Sie Ihre erste Datei hochladen können.
Führen Sie eine Datei mit dem Importer aus:
- Besuchen Sie https://importer.joinhandshake.co.uk/.
-
Klicken Sie auf „Neue CSV hochladen“ in der oberen rechten Ecke des lila Bandes:
-
Führen Sie die folgenden Schritte aus, um Ihre Datei hochzuladen:
- Wählen Sie die hochzuladende Datei, nachdem Sie sie korrekt formatiert und als UTF-8-kodierte CSV-Datei gespeichert haben (weitere Informationen dazu unten).
- Wählen Sie den richtigen Jobtyp für die Daten, die Sie hochladen (weitere Informationen dazu unten).
- Fügen Sie eine Beschreibung der Daten hinzu, die Sie importieren.
- Klicken Sie auf „Job speichern“.
4. Sie werden zu einer Seite weitergeleitet, während der Importer die Analyse Ihrer Datei abschließt.
5. Aktualisieren Sie die Seite so lange, bis der Status „Bereit zur Einreichung“ lautet:
6. Blättern Sie bis zum Ende der Seite, um die Vereinbarung zu lesen, bevor Sie die Datei ausführen. Klicken Sie nach dem Lesen auf das Kästchen neben „Ich stimme zu, dass diese Daten korrekt erscheinen und verstehe, dass dieser Import nicht gelöscht werden kann“. Klicken Sie auf „Job ausführen“.
7. Sie werden nun auf die Fortschrittsseite weitergeleitet, während der Importer Ihre Datei in Handshake verarbeitet:
8. Nachdem die Datei vollständig abgearbeitet wurde, klicken Sie auf „Download-Ergebnisse anzeigen“ in der oberen rechten Ecke.
9. Als nächstes klicken Sie auf „Fehlerhafte Zeilen als CSV herunterladen“, um die Datensätze, deren Verarbeitung fehlgeschlagen ist, und die zugehörigen Fehlermeldungen anzuzeigen. Weitere Informationen zur Lösung von Importer-Fehlern finden Sie hier.
Beantragung der Bearbeitung eines Jobs durch den Importer
Bei einigen Importer-Jobtypen muss das Importer-Team von Handshake den Datei-Upload überprüfen, bevor die Daten in das System eingespeist werden, um die Datenintegrität zu wahren und unvorhergesehene Probleme zu vermeiden. Beispiele hierfür sind Dateien von NutzerInnen, in denen Sie sensible Felder aktualisieren, oder wenn Sie versuchen, Beratungsgespräche zu importieren.
In diesen Fällen können Sie den Job nicht sofort ausführen (wie in den oben angegebenen Schritten beschrieben). Führen Sie stattdessen die Schritte 1-5 genau so aus. Nachdem der Importer die Analyse Ihrer Daten abgeschlossen hat (Schritt 6), klicken Sie nicht auf „Job ausführen“, sondern setzen ein Häkchen in das Zustimmungsfeld und klicken auf die blaue Schaltfläche mit der Aufschrift „Einreichung und Ausführung anfordern“
Ihr Importer-Job wird in eine Warteschlange gestellt, die das Handshake-Team vor der Ausführung der Datei überprüfen wird. Sie können damit rechnen, dass Ihre Datei innerhalb von 24 Stunden bearbeitet wird oder dass Sie eine Rückmeldung vom Handshake-Team erhalten.
Importer-Jobtypen
-
Studierende
- Importieren von Daten zu Studierenden
- Mit diesem Jobtyp werden alle Daten Ihrer Studierenden in Handshake hochgeladen und Konten für Ihre Studierenden eingerichtet. Dies ist ein entscheidender Schritt, um den Zugang für Studierende zu erleichtern und ihr Engagement auf der Plattform zu erhöhen.
-
Kontakte
- Importieren von Kontakten zu ArbeitgeberInnen
- Alle Kontakte, die eine ungültige E-Mail-Adresse und/oder E-Mail-Domäne haben, werden an Ihr Team zurückgeschickt. Sie können die Informationen der Kontakte aktualisieren und uns eine neue Datei schicken.
- Bei den Kontakten handelt es sich in der Regel um Kontakte zu ArbeitgeberInnen oder Alumni, die aus Ihrem früheren System stammen.
- Vor der Kontaktaufnahme mit ArbeitgeberInnen sollten Sie eine Liste mit Kontakten in Handshake hochladen, damit Sie sie per Massen-E-Mail einladen können, der Handshake-Plattform beizutreten.
- Kontakte werden vor dem Importieren verifiziert.
-
Termine
- Importieren von historischen Terminen
- Termine werden in der Regel kurz nach der Implementierung aus dem vorherigen System in Handshake importiert.
-
Beratungsgespräche
- Importieren von Beratungsgesprächen
- Beratungsgespräche werden zu einem frühen Zeitpunkt der Implementierung importiert, in der Regel wenn eine große Anzahl von Beratungsgesprächen vorhanden ist.
- Events
-
Notizen
- Importieren von Notizen
- Das Importieren von Notizen findet häufig statt, wenn eine Einrichtung die Implementierung durchläuft, um historische Informationen zu übernehmen. In anderen Fällen kann es vorkommen, dass ein Mitarbeiter / eine Mitarbeiterin seine/ihre Notizen über eine externe Quelle verfolgt und eine Möglichkeit benötigt, diese in großer Zahl in das System hochzuladen.
- Notizen können auf NutzerInnen (Studierende oder Career Services), Termine, Events oder Karrieremessen angewendet werden.
-
Labels (normal)
- Importieren von Labels
- Es kann für die Angabe von außerschulischen Aktivitäten, die Erteilung von Berechtigungen, die Verfolgung von Attributen für das Reporting, Fachgebiete und viele andere Gruppen von NutzerInnen verwendet werden.
- Labels werden im Allgemeinen zur Klassifizierung und zum Filtern von Untergruppen von Nutzern/Nutzerinnen (Studierende, Mitarbeitende oder Kontakte) verwendet.
- Sie können auch bei Terminen und Events verwendet werden, wenn die identifizierbare ID angegeben wird.
- Gebäude
- Importieren von Gebäuden
- Es wird der Regel nur vor oder während der Implementierung importiert
- Räume
- Importieren von Räumen
- Es wird der Regel nur vor oder während der Implementierung importiert
- Teilnehmer
- Importieren von TeilnehmerInnen in ein erstelltes Event oder eine Karrieremesse
- Manchmal werden die TeilnehmerInnen nicht direkt innerhalb von Handshake verfolgt. Wir können diese TeilnehmerInnen in ihre richtigen Events importieren.
- Wenn Ihr Team häufig TeilnehmerInnen importiert, empfehlen wir Ihnen, unser Support-Team zu kontaktieren, um den aktuellen Prozess zu überprüfen und zu besprechen, wie wir die Registrierungen und Check-ins innerhalb von Handshake durchführen können.
Neben dem manuellen Import Ihrer Daten durch CSV-Uploads über den Importer können Sie die Daten Ihrer Studierenden auch über AWS S3 übertragen. Der folgende Abschnitt wird diesen Arbeitsablauf eingehend durchlaufen.
Synchronisierung von Studierenden: Automatisieren Sie die Synchronisierung Ihrer Studierenden - Übertragung von Daten zu Studierenden über S3
Es gibt viele Möglichkeiten, mit S3 zu interagieren, um regelmäßig Daten hochzuladen. AWS S3 ist sehr flexibel und es gibt viele Clients, Tools und Dienste, die für die Interaktion mit den zahlreichen Funktionen geschrieben wurden.
In der Reihenfolge ihrer Beliebtheit sind dies die Methoden, die wir für das Hochladen von Daten in AWS S3 in Betracht ziehen:
- AWS CLI - Ein einfacher Python-basierter Client zum Hochladen von Daten (am einfachsten zu benutzen)
- S3 Bash - Eine einfache Upload-CLI, die nur lokale Unix-Tools wie curl / openssl für den Upload verwendet (am einfachsten zu installieren)
- REST API - Die zugrunde liegende API für AWS S3 (am flexibelsten)
Einige häufige AWS-Probleme
- Wenn es so aussieht, als ob Ihre Datei in AWS hochgeladen wird, aber NICHT in den Importer, dann überprüfen Sie, welche Zeichen Sie verwenden
- Die folgenden Zeichensätze sind im Allgemeinen für die Verwendung in Schlüsselnamen sicher: Alphanumerische Zeichen: 0-9 a-z A-Z Sonderzeichen: ! - _ . * ' ( )
- Weitere Informationen finden Sie hier