Importer des utilisateurs à partir d'un fichier CSV

Lorsque vous importez des détails d'utilisateur dans BlackBerry AtHoc à l'aide d'un fichier CSV, les valeurs qui existent dans le fichier CSV écrasent toutes les valeurs existantes dans la base de données. Si le fichier contient des champs vides, les valeurs actuelles dans la base de données sont remplacées par des valeurs vides. Assurez-vous que tous les champs obligatoires sont remplis avant de télécharger le fichier.

Pour importer des utilisateurs à partir d'un fichier, le fichier doit être correctement formaté. Si vous ne savez pas comment formater le fichier, consultez Formater un fichier d'importation d'utilisateurs.

Pour importer des opérateurs à partir d'un fichier, consultez « Importer et exporter des opérateurs » dans le guide Rôles et autorisations d'opérateur BlackBerry AtHoc .

Si des utilisateurs en double (identifiés par leur nom d'utilisateur ou leur ID de mappage) se trouvent dans le fichier CSV, ils ne sont pas importés et l'un des messages d'erreur suivants s'affiche :

[Username]: <username> already exists in the payload

[Mapping ID]:<mapping id> already exists in the payload

Les utilisateurs uniques restants dans le fichier CSV sont importés.

Si un nom d'utilisateur contient un espace ou l'un des caractères suivants, l'utilisateur n'est pas importé et un message d'erreur s'affiche :

[ ] : ; | = , + * ? < >

Si le nom d'utilisateur contient des espaces de début ou de fin, les espaces sont ignorés et supprimés lors du processus d'importation. Une fois les espaces supprimés, l'utilisateur est importé.

Vous pouvez importer des utilisateurs dans une organisation de super entreprise, une organisation d'entreprise ou une sous-organisation.

  1. Dans la barre de navigation, cliquez sur Utilisateurs > Utilisateurs.
  2. Sur l'écran Utilisateurs, cliquez sur Plus d'actions > Importer > Utilisateurs.
  3. Facultativement, cliquez sur Télécharger un fichier CSV modèle pour télécharger un fichier CSV vierge à utiliser comme modèle pour votre fichier d'importation d'utilisateurs. Enregistrez le fichier sur votre ordinateur et remplissez les informations d'utilisateur appropriées.

    L'utilisation du modèle garantit que toutes les colonnes d'attributs obligatoires sont incluses dans le fichier d'importation.

  4. Cliquez sur Parcourir .
  5. Accédez à l'emplacement du fichier d'importation d'utilisateurs sur votre ordinateur.
  6. Ouvrez le fichier pour saisir ou modifier les données utilisateur.
    Remarque : Microsoft Excel masque certains caractères de la vue. Si vous modifiez le fichier dans Microsoft Excel, il se peut qu'il formate vos entrées avec des caractères supplémentaires. Le format incorrect peut entraîner l'échec de l'opération d'importation. Si vous utilisez autre chose qu'un éditeur de texte pour modifier le fichier CSV, ouvrez le fichier dans un éditeur de texte tel que Microsoft Notepad, vérifiez la syntaxe pour détecter les problèmes, puis enregistrez le fichier modifié sous forme de fichier .txt. Modifiez le nom du fichier pour changer l'extension de .txt à CSV. Cette méthode préserve le formatage dans le fichier texte.
  7. Assurez-vous que les colonnes comportant plusieurs valeurs ont le format correct pour être importées correctement.
    • L'entrée entière doit être entourée de guillemets doubles. Cette règle est vraie même si une liste de sélection à choix multiples ne comporte qu'une seule entrée.
    • Utilisez une virgule pour séparer chaque valeur. N'incluez pas d'espaces avant ou après la virgule.
      • Exemple : Deux noms de colonnes, séparés par une virgule (aucun espace avant ou après la virgule). POSITIONS est une colonne de liste de sélection à choix multiples : USERNAME,POSITIONS
      • Exemple : Une colonne d'attribut de liste de sélection à choix multiples avec plusieurs entrées : Cadiz,"ESH Team Tech Supv,FMT Coordinator,SITE 300,Exercise Call Out,Field Monitoring Team,Coordinator DOC"
      • Exemple : Un attribut de liste de sélection à choix multiples avec une seule entrée : East,"LEDO"
    • Une entrée peut contenir un espace. Par exemple : Field Monitoring Team
  8. Vérifiez que les colonnes comportant plusieurs valeurs ont le format correct pour être importées correctement.
    • Utilisez une virgule pour séparer chaque valeur. N'incluez pas d'espaces avant ou après la virgule.
    • Si vous importez des restrictions de base d'utilisateurs, vous devez entourer chaque valeur de guillemets doubles ("").
  9. Facultativement, assurez-vous que tous les attributs de géolocalisation dans le fichier CSV sont dans le format d'adresse de chaîne correct, "Latitude,Longitude" ou Point(long,lat). Par exemple :
    • 311 Fairchild Drive, Mountain View, CA
    • "37.538226,-122.32726"
    • POINT(-122.32726,37.538226)
  10. (Facultatif, pour les organisations de super entreprise ou d'entreprise avec l'unicité de l'utilisateur activée.) Si vous souhaitez empêcher les utilisateurs d'être déplacés entre les organisations après les avoir importés, incluez la colonne Empêcher le déplacement de l'utilisateur et saisissez Yes pour tous les utilisateurs.
  11. Après avoir saisi vos données, enregistrez et fermez le fichier.
  12. Cliquez sur le nom du fichier, puis cliquez sur Ouvrir pour télécharger le fichier dans le système.

    Le nom du fichier apparaît dans le champ Fichier CSV d'utilisateur sur l'écran Importer un fichier d'utilisateurs. Chacune des colonnes du fichier d'importation est répertoriée dans la section Sélectionner les colonnes à importer.

  13. Facultativement, sélectionnez Importation partielle d'utilisateurs activée pour permettre l'importation partielle de données d'utilisateur. Lorsque cette option est sélectionnée, si une entrée d'utilisateur contient une valeur non valide, le reste des données de l'utilisateur est tout de même importé.
    Remarque : Même si vous ne sélectionnez pas cette option, l'importation partielle d'utilisateurs est toujours appliquée lors de l'importation d'attributs de géolocalisation qui utilisent une adresse physique.
  14. Sélectionnez les colonnes de données que vous souhaitez importer ou cliquez sur Tout sélectionner.
  15. Examinez la liste Colonnes qui ne peuvent pas être importées pour vous assurer qu'elle ne contient pas de données importantes que vous devez pouvoir afficher dans BlackBerry AtHoc. Si la liste contient des colonnes d'informations importantes, contactez le support client BlackBerry AtHoc pour obtenir de l'aide.
  16. Cliquez sur Importer .

La fenêtre Importation d'utilisateurs s'ouvre. L'importation s'effectue par lots de 5 000 utilisateurs.

Pendant que l'importation est en cours, un bouton Arrêter l'importation apparaît sur la fenêtre Importation d'utilisateurs. Cliquer sur ce bouton arrête immédiatement le processus d'importation et empêche l'importation du prochain lot d'utilisateurs à partir du fichier. Cependant, les enregistrements qui ont déjà été ajoutés ne sont pas supprimés et les enregistrements qui ont été mis à jour ne sont pas restaurés à leurs valeurs précédentes.

Lorsque l'importation est terminée, un écran de résumé de l'importation affiche les informations suivantes :

  • Nombre total d'utilisateurs dans le fichier d'importation
  • Nombre total d'utilisateurs qui ont été traités
  • Nombre d'utilisateurs qui ont été traités avec succès
  • Nombre d'utilisateurs qui ont été partiellement traités
  • Nombre d'utilisateurs dont le traitement a échoué
  • Nom d'utilisateur de la personne qui a importé le fichier
  • Heure de début et de fin du processus d'importation de fichier

Pour importer et exporter des opérateurs, consultez « Importer et exporter des opérateurs » dans le guide Rôles et autorisations d'opérateur BlackBerry AtHoc .

Conseil : Cliquez sur Télécharger le journal sur l'écran Détails de l'importation : Importation terminée pour télécharger un fichier CSV contenant des informations sur l'état de synchronisation de l'importation de l'opérateur.