Exécution d'opérations groupées

Vous pouvez ajouter, mettre à jour ou supprimer des capteurs en masse en important un fichier CSV, au lieu d’une addition, mise à jour ou suppression unitaire. Le fichier CSV ne doit pas dépasser 50K lignes dans TPE SaaS, 20K dans TPE auto-hébergé, et 20 Mo.

Assurez-vous que votre fichier CSV a le bon format avant d'effectuer la tâche. Un fichier d'exemple est téléchargeable depuis l'interface utilisateur.

Dans le panneau de gauche, sélectionnez Capteurs, puis cliquez sur OPÉRATIONS EN MASSE dans le coin supérieur droit de la page.
Vous pouvez également développer OPÉRATIONS EN MASSE et sélectionner Ajouter, mettre à jour et supprimer des capteurs à partir d'un fichier CSV.
Préparez votre fichier d'import .csv, guidé par le FICHIER D'EXEMPLE téléchargeable depuis l'interface utilisateur. Pour en savoir plus sur la façon de construire votre fichier .csv, voir À propos du fichier d'import.

note
Vous devrez renseigner l’ID du modèle de capteur pour chaque capteur importé. Utilisez le fichier LISTE DES MODÈLES téléchargeable pour obtenir la correspondance entre chaque modèle et son ThingPark Model ID.
Pour les capteurs LoRaWAN®, seuls les modèles de capteur compatibles avec la liste des bandes ISM activées sont renvoyés.
Optionnel : Si vous ne souhaitez pas importer les clés de vos capteurs LoRaWAN® en clair, vous pouvez importer des clés chiffrées RSA en appliquant les étapes suivantes, en tirant parti de la cryptographie asymétrique :
1. Dans l'interface utilisateur, cliquez sur la clé publique pour télécharger la clé publique RSA que vous devez utiliser pour chiffrer les clés de vos capteurs. Le fichier téléchargé inclut la clé publique au format JWK (JSON Web Key).
2. Convertissez le format JWK en format PEM. Dénommons la clé résultante pubkey.pem.
  
  astuce
  Pour effectuer cette conversion, vous pouvez utiliser un convertisseur en ligne tel que https://8gwifi.org/jwkconvertfunctions.jsp
3. En utilisant pubkey.pem, chiffrez les clés de vos capteurs, par exemple avec OpenSSL, puis convertissez-les au format base64.
  astuce
  À titre d'exemple, pour chiffrer un AppKey hexadécimal, vous pouvez utiliser les commandes OpenSSL suivantes dans un terminal shell :
  xxd -r -p AppKey.hex > AppKey.bin openssl pkeyutl -encrypt -in AppKey.bin -out encryptedAppKey.bin -pubin -inkey pubkey.pem -pkeyopt rsa_padding_mode:pkcs1 base64 encryptedAppKey.bin > encryptedAppKey.b64
4. Ajoutez vos clés chiffrées, au format base64, à votre fichier CSV et remplissez la colonne X de ce fichier CSV avec l'ID de clé fourni par le champ kid du fichier JWK téléchargé à l'étape 1 ci-dessus.
Lorsque votre fichier CSV est prêt, cliquez sur pour le téléverser.
Cliquez sur IMPORTER.

-> L’intégralité du fichier CSV est analysée pour vérifier sa cohérence : pour chaque ligne, le nombre de colonnes et le contenu de chaque colonne sont vérifiés. Si au moins une erreur est détectée à ce stade, le fichier CSV n’est pas traité et l’importation en masse échoue immédiatement. Sinon, le traitement du fichier CSV est démarré.

Des notifications contextuelles colorées (« toasters ») s’affichent à l’écran pour vous informer de la progression. La progression suit cette séquence :
- L’importation est en attente (gris), puis en cours de progression (vert foncé).
- Lorsque l’importation est terminée, une notification s’affiche dans la barre supérieure indiquant le résultat. Elle peut être l’une des suivantes :
  - L’importation en masse a réussi : l’intégralité du fichier a été traitée avec succès.
  - L’importation en masse a réussi avec des erreurs : le fichier a été partiellement traité avec succès, certaines lignes n’ayant pas été traitées en raison d’erreurs.
  - L’importation en masse a échoué : le fichier n’a pas été importé avec succès, aucun capteur n’ayant été traité avec succès.
Depuis le coin supérieur droit de l'interface utilisateur, cliquez sur pour accéder à la liste Notifications. Pour en savoir plus, voir À propos des notifications de capteurs.

astuce
Le résumé de chaque notification d’importation de capteur contient le nom du fichier CSV importé. Pour vous aider à identifier et à suivre plus facilement les sessions d’importation, nous vous recommandons d’importer des fichiers CSV avec des noms de fichier distincts. La réutilisation du même nom de fichier peut rendre plus difficile la détermination de la notification correspondant à chaque importation.
Si l'importation en masse n'a pas réussi, analysez et corrigez les erreurs dans le fichier .CSV puis réimportez le fichier.

note
L’ajout d’un capteur correspondant à un DevEUI existant déjà et appartenant au même abonné ne déclenche pas d’erreur et est comptabilisé dans le compteur "Already existing".
Après une importation en masse réussie, accédez à la liste de capteurs pour afficher tous les capteurs importés.