Handshake met en place un emplacement distinct pour chaque école dans un panier Amazon S3 désigné pour que vous puissiez transférer vos fichiers de données étudiant(e).

1. L’Université télécharge des données sur le panier S3 de Handshake avec le dossier spécifique de l'école
2. L'outil importer de Handshake analysera vos données de l'étudiant(e) et fournira tout feedback ou modification de mise en forme requise par e-mail ou dans l’interface utilisateur
3. L’outil importer de Handshake téléchargera vos données de l'étudiant(e) dans Handshake et il mettra à jour vos données de l'étudiant(e) existantes ou créera le nouveaux étudiants importés.

Notes importantes :

• Vous n’avez que des autorisations d’ écriture pour le dossier de votre école.
• Ces répertoires S3 sont uniquement en écriture, donc toute tentative d’obtention/liste de contenu entraînera des erreurs « Accès refusé ».
• Nous prenons en charge toutes les méthodes standard de téléchargement sur AWS S3 qui nécessitent l’accès.
• Nous ne prenons pas en charge FTP/SFTP en raison de l’accès à la liste requise. Winscp nécessite un accès à la liste aux S3 Buckets et ne peut donc pas être utilisé.
• Au Royaume-Uni, la région doit être définie sur eu-central-1 pour que votre transfert de fichier fonctionne.
  • Note : Les comptes existants qui ont configuré l’exécution automatique avant le 01/07/2023, la région peut toujours être définie sur : eu-west-2.

Nous vous recommandons d’utiliser l’outil CLI de Amazon, car c’est le meilleur outil pour interagir avec AWS S3 pour vos téléchargements de étudiant(e). Si vous ne pouvez pas utiliser cet outil, veuillez en informer notre équipe d’assistance.

Si vous avez déjà Python, vous pouvez installer le CLI en utilisant les instructions suivantes (voir ici pour plus d'informations sur l’installation, en fonction de votre système d’exploitation) :

Pip Installer -- Mise à niveau -- Utilisateur AWSCLI

Si vous n’avez pas de Python, vous pouvez l’installer en utilisant l’installation groupée ici.

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

# Sans sudo (suppose que ~/lbin est dans votre chemin d'accès)
./awscli-bundle/install -b ~/bin/AWS

Si vous n’avez pas de Python et ne pouvez pas l’installer pour utiliser AWS CLI, d’autres options peuvent être trouvées ici.

Veuillez contacter l’équipe d’assistance technique de Handshake ici pour recevoir les informations d’identification AWS pour télécharger des données sur Handshake. Sauf si l’équipe Handshake l’a indiqué, au Royaume-Uni, vous devriez utiliser « eu-central-1 » comme région.

Ensuite, exécutez ce qui suit et entrez votre clé d’accès AWS et votre clé secrète :

Configurer AWS
Identifiant de clé d’accès AWS [* * * * * * * * * * * * * * * * JRTA] :
Clé d’accès secret AWS [* * * * * * * * * * * * * * * RZ7O] :
Nom de la région par défaut [UE-CENTRAL-1] :
Format de sortie par défaut [aucun] :

Maintenant, vous êtes prêt à télécharger votre fichier sur Handshake ! Note sur laquelle vous devriez avoir reçu un e-mail vous donnant le chemin exact d’AWS S3 pour télécharger votre fichier (si ce n’est pas le cas, veuillez contacter l’ équipe d’assistance).

Télécharger la synchronisation :

AWS S3 CP [/path/your _ local _ file] S3 ://Handshake-Importer-Téléchargements/[Votre dossier]/[yyyymmdd] _ USERs.CSV

Exemple de téléchargement et de réponse

AWS S3 CP 20140410_users.csv S3 ://Handshake-Importer-Téléchargements/Importer-production-Hudson _ Université/20140410 _ Users.CSV

Téléchargez : sur S3 ://Handshake-Importer-Téléchargements/Importer-production-Hudson _ Université/20140410 _ Users.CSV

L’API AWS S3 répondra avec l’identifiant du document si le fichier a été transféré avec succès, sinon il répondra avec une erreur. Vous pouvez également vérifier le code de sortie de la commande pour déterminer s’il a réussi.

Si vous souhaitez envoyer un téléchargement test, envoyez simplement un fichier qui comprend « test » dans le nom du fichier. Cela enverra le fichier au compte importer de votre école et il sera analysé pour toute erreur de fichier/formatage, mais ne sera pas traité.

1. Connectez-vous à l'importer et vérifiez que votre fichier a été accepté et a passé toutes les vérifications d’analyse.

Voici quelques problèmes courants que vous avez pu rencontrer si vous ne voyez pas le fichier :

Le fichier n’est pas un vrai CSV
Corriger : Vérifiez que le fichier que vous essayez de télécharger peut être téléchargé manuellement sur le importer et traité avec succès

Le script que vous utilisez ne télécharge pas avec succès le fichier sur votre panier S3
Corriger : Vérifiez votre chemin de script et assurez-vous qu’il revient avec succès et vous donne le chemin de l’objet téléchargé

2. Assurez-vous que les données téléchargées passent tous les analyseurs, si ce n’est pas le cas, vous devrez apporter des modifications à votre script d’extrait avant que nous puissions activer l’exécution automatique pour vous.
   
   
3. Si votre fichier a passé toutes les vérifications d’analyse, veuillez contacter notre équipe d’assistance technique avec l’URL du importer emploi associée afin que nous puissions le traiter et vérifier les erreurs. En attendant un téléchargement réussi, nous activerons automatiquement pour votre école !

Une fois que nous aurons activé le Run automatique pour vos téléchargements de AWS, nous vous recommandons d’utiliser Cron pour planifier un téléchargement récurrent. Voici des instructions sur la mise en place de Cron (pour Linux), ainsi que pour Windows Task Scheduler (si vous n’utilisez pas de serveur Linux pour ces téléchargements).

Choisissez une date hebdomadaire, mensuelle ou semestrielle pour effectuer votre téléchargement (en fonction du flux de travail/des besoins de votre école). En général, le format est :

 + ---------------- minute (0 — 59)
 | + ------------- heure (0 — 23)
 | | + ---------- jour du mois (1 — 31)
 | | | + ------- Mois (1 — 12)
 | | | | + ---- jour de la semaine (0 — 6) (dimanche = 0 ou 7)
 |  |  |  |  |
 * * * * * Commande à exécuter

Exemple :

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

Dépannage des erreurs AWS

 Si vous recevez des messages d’erreur lors de votre soumission AWS, vous pouvez vous référer au guide d’erreur CLI de Amazon pour résoudre la source d’erreur et sa résolution associée. Si vous avez besoin d’aide avec ce dépannage, veuillez contacter l’ assistance pour obtenir de l’aide.