Handshake configure un emplacement isolé pour chaque école dans un compartiment Amazon S3 désigné dans lequel vous pouvez transférer vos fichiers de données étudiant.

1. L'Université télécharge des données dans le compartiment S3 de Handshake avec le répertoire spécifique de leur école
2. L'outil d'importation de Handshake analysera vos données étudiant et fournira tout feedback ou les modifications de formatage requises par e-mail ou dans l'interface utilisateur.
3. L'outil d'importation de Handshake téléchargera vos données étudiant dans Handshake et mettra à jour vos données étudiant existantes ou créera les nouveaux étudiants importé.

REMARQUES IMPORTANTES :

• Vous disposez uniquement des autorisations d' écriture pour le dossier de votre école.
• Ces répertoires S3 sont en écriture seule, donc toute tentative de GET/LIST du contenu entraînera les 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 LIST requis. WinSCP nécessite un accès LIST à S3 Buckets et ne peut donc pas être utilisé.
• En Europe, la région doit être définie sur eu-central-1 pour que votre transfert de fichiers fonctionne.
  • Remarque : les comptes existants configurés pour 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 il s'agit du meilleur outil pour interagir avec AWS S3 pour vos téléchargements étudiants. Si vous ne pouvez pas utiliser cet outil, veuillez en informer notre équipe support.

Si vous disposez déjà de Python, vous pouvez installer la CLI en suivant les instructions suivantes (voir ici pour plus de détails d'installation, en fonction de votre système d'exploitation) :

Pip Installer -- Mise à niveau -- Utilisateur AWSCLI

Si vous n'avez pas Python, vous pouvez l'installer à l'aide du programme d'installation fourni 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 Python et que vous ne pouvez pas l'installer pour utiliser l'AWS CLI, d'autres options peuvent être trouvées ici.

Veuillez contacter l'équipe de support technique de Handshake ici pour recevoir les identifiants AWS permettant de télécharger des données vers Handshake. Sauf indication contraire de la part de l'équipe Handshake, en Europe, vous devez 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 ! Notez que vous devriez avoir reçu un courriel vous indiquant le chemin AWS S3 exact vers lequel 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 importateur de votre école et il sera analysé pour détecter toute erreur de fichier/formatage, mais ne sera pas traité.

1. Connectez-vous à l'importateur et vérifiez que votre fichier a été accepté et a réussi toutes les vérifications de l'analyseur.

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
Correctif : vérifiez à nouveau que le fichier que vous essayez de télécharger peut être téléchargé manuellement vers l'importateur et traité avec succès.

Le script que vous exécutez ne parvient pas à télécharger le fichier dans votre compartiment S3
Correctif : vérifiez à nouveau le chemin de votre script et assurez-vous qu'il revient avec succès et vous renvoie 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 réussi toutes les vérifications de l'analyseur, veuillez contacter notre équipe support technique avec l'URL de l'importateur emploi associée afin que nous puissions le traiter et vérifier les erreurs. En attendant un téléchargement réussi, nous activerons l'exécution automatique 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 les instructions sur la configuration de cron (pour Linux), ainsi que pour le planificateur de tâches Windows (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 des erreurs CLI de Amazonpour dépanner la source de l'erreur et sa résolution associée. Si vous avez besoin d'aide pour ce dépannage, veuillez contacter le support pour obtenir de l'aide.