Import de groupes

Importez des groupes à l'aide d'un fichier de valeurs séparées par des virgules (CSV).

Avant de commencer :
Afin de pouvoir importer des groupes, créez un fichier CSV correctement formaté pour le processus d'import. Afin de créer et de préparer un fichier pour import, procédez comme suit :
  1. Utilisez ces exemples de fichier comme point de départ.

  2. Extrayez le fichier compressé, puis ouvrez le fichier Groups.csv.

  3. Facultatif. Pour vous familiariser avec le processus d'import, envisagez d'importer uniquement les données de démonstration. Vous pouvez ensuite supprimer les données de démonstration non souhaitées avant de commencer à importer des données actives.
  4. Examinez les données de démonstration du fichier Groups.csv, puis supprimez-en.

  5. Créez un fichier d'import à l'aide du fichier Groups.csv. Le fichier Groups.csv est un fichier texte simple au format tabulaire (lignes et colonnes). La première ligne du fichier définit les colonnes (champs) de la table. Au minimum, le fichier doit comporter exactement les en-têtes de colonne suivants :
    • Nom d'affichage

    • Description

    • Utilisateurs membres

    Conseil

    Assurez-vous que les champs de ces colonnes sont uniques. Vérifiez également que les noms utilisateur de la colonne Utilisateurs membres existent déjà dans le domaine d'identité.
    Pour chaque compte, créez une ligne et entrez des données dans chaque colonne (champ). Chaque ligne correspond à un enregistrement.
    Important

    Les données fournies dans le fichier CSV doivent répondre aux exigences suivantes :
    • Les ID des utilisateurs dans le fichier doivent contenir au moins trois caractères. Les noms des groupes doivent contenir au moins cinq caractères.
    • Les numéros de téléphone des utilisateurs à importer doivent répondre aux exigences de la spécification RFC 3966.
    • Le nombre maximal de lignes dans le fichier d'import des groupes ne doit pas dépasser 100 000 et la taille du fichier d'import ne doit pas dépasser 52 Mo.

    Pour créer un fichier CSV, vous pouvez utiliser une application de feuille de calcul standard, telle que Microsoft Excel ou Google Sheets, ou un éditeur de texte, tel que le bloc-notes ou le pavé TextPad.

  6. Enregistrez votre fichier au format UTF-8. L'enregistrement du fichier au format UTF-8 fait en sorte que les caractères non anglais s'affichent correctement.
    1. Ouvrez le fichier CSV avec un éditeur de texte, tel que le bloc-notes.
    2. Enregistrez le fichier avec l'encodage UTF-8.
    Remarque

    Si vous n'enregistrez pas le fichier au format CSV avec l'encodage UTF-8, l'import échoue.
Pour importer des groupes, procédez comme suit :
  1. Ouvrez le menu de navigation et cliquez sur Identité et sécurité. Sous Identité, cliquez sur Domaines. Cliquez sur le nom du domaine d'identité dans lequel vous souhaitez travailler. Vous devrez peut-être modifier le compartiment pour trouver le domaine souhaité. Cliquez ensuite sur Groupes.
  2. Dans le menu Actions supplémentaires, sélectionnez Importer les groupes.
  3. Dans la fenêtre Importer les groupes, glissez-déplacez le fichier ou cliquez sur Sélectionner un élément pour rechercher le fichier.
  4. Cliquez sur Importer.
    En cas d'échec de l'import d'un groupe, assurez-vous que ce groupe n'existe pas déjà et que les valeurs requises sont fournies. Si le domaine d'identité ne peut pas importer un groupe, il évalue le groupe suivant dans le fichier CSV.
  5. Une fois le travail terminé, vérifiez les résultats.
    • Si le travail peut être traité immédiatement, une boîte de dialogue apparaît avec l'ID du travail et un lien pour le travail d'import. Cliquez sur le lien et examinez les détails sur la page Tâches.
    • Si le travail ne peut pas être traité immédiatement, un message contenant un ID de programmation apparaît. Copiez cet ID de programmation et utilisez-le pour rechercher le travail sur la page Travaux. Le travail apparaît à la fin du traitement.
    Conseil

    Un ID de travail est affecté à chaque fichier importé ou exporté, à des fins d'audit.
  6. Si nécessaire, accédez à la page Jobs, localisez et ouvrez le travail à visualiser.
    La page Détails de travail indique le nombre de groupes importés, le nombre de groupes dont l'import a réussi et le nombre de groupes qui ne peuvent pas être importés en raison d'une erreur système. Pour chaque groupe dont l'importé a réussi, cette page indique également le nombre d'utilisateurs affectés au groupe.
Reportez-vous à Export des erreurs de travail pour télécharger un fichier CSV des erreurs sur votre ordinateur local.