Exporter ou importer la structure de l’organisation et les allocations de produits
S’applique à : Entreprise
Découvrez comment les administrateurs globaux peuvent rationaliser la gestion de l’organisation et des produits grâce aux fonctionnalités d’exportation et d’importation de Global Admin Console.
Accédez à l’onglet Organisations dans le Global Admin Console pour exporter ou importer la structure de l’organisation. Accédez à l’onglet Affectation de produit pour afficher les données d’affectation. Sélectionnez l’icône Plus d’options (⋮), puis choisissez Exporter ou Importer. Accédez ici à connexion au Global Admin Console.
Exporter la structure de l’organisation
En tant qu’administrateur global, vous pouvez exporter la hiérarchie de l’organisation. Vous pouvez télécharger une représentation JSON, CSV ou XLSX de l’ensemble de la hiérarchie de l’organisation ou d’un sous-ensemble de celle-ci. Vous pouvez ensuite utiliser ces données à des fins d’analyse ou de modification.
Le format d’exportation choisi a un impact sur la structure des données exportées :
- Format CSV : permet d’exporter un seul type de données à la fois. Lors de l’exportation de profils de produit au format CSV, les profils et les ressources sont combinés en un seul tableau. Il existe plusieurs entrées pour le profil de produit, une pour chaque ressource.
- Format XLSX : les résultats de chaque organisation sont affichés sur une feuille séparée. Les enregistrements sont connectés entre les différents types d’objets par un identifiant de référence. Dans certains cas, il peut y avoir plusieurs lignes pour un objet particulier (par exemple, des objets Ressource lorsqu’un ensemble de valeurs est associé à une ressource donnée).
- Format JSON : le plus flexible. Il peut tirer parti des relations structurelles entre les objets exportés (par exemple, les produits d’une organisation apparaissent directement dans l’élément d’organisation). Les mêmes champs sont exportés dans les trois formats, mais certaines valeurs sont redondantes au format JSON.
Étapes d’exportation
-
Connectez-vous à 🔗. Dans l’onglet Organisations, utilisez le sélecteur d’organisation pour sélectionner la hiérarchie d’organisations à exporter. Les données de toutes les organisations de la hiérarchie sont exportées.
-
Sélectionnez l’icône Plus d’options ⋮ et choisissez Exporter.
-
Dans la boîte de dialogue Exporter, sélectionnez les éléments à exporter et un format dans lequel exporter les données.
Boîte de dialogue d’exportation Admin Console
-
Sélectionnez Exporter. La génération du fichier d’exportation peut prendre plusieurs minutes. Une fois l’opération terminée, pour télécharger le rapport, accédez à > Insights > Export Reports.
Après avoir téléchargé le fichier, vous pouvez manipuler les données, puis les importer à nouveau. Les mises à jour importées apparaissent dans Global Admin Console comme si vous aviez modifié manuellement les données.
Importer la structure de l’organisation
En tant qu’administrateur global, vous pouvez importer des données potentiellement modifiées. Une fois chargées, les nouvelles données sont comparées aux données actuelles et toutes les modifications sont appliquées à la hiérarchie de l’organisation. Toutes les opérations d’import sont effectuées sur la copie mise à jour de la hiérarchie de l’organisation. Si vous avez des modifications en attente, les modifications importées viennent s’ajouter aux modifications en attente existantes dans la hiérarchie.
Étapes d’importation
- Connectez-vous à 🔗. Dans l’onglet Organisations, utilisez le sélecteur d’organisation pour sélectionner la hiérarchie d’organisations dans laquelle vous souhaitez effectuer l’importation.
- Sélectionnez l’icône Plus d’options ⋮ et sélectionnez Importer. Selon la taille et la complexité du fichier d’importation, le traitement peut prendre de quelques secondes à plusieurs minutes.
- Sélectionnez Sélectionner un fichier, puis choisissez un fichier JSON, CSV ou XLSX à charger. Pour les fichiers CSV, un seul détail d’organisation peut être importé à la fois et cela ne prend pas en charge l’importation de produits. Les modifications importées semblent avoir été modifiées manuellement.
- Sélectionnez Fermer.
- Sélectionnez Vérifier les modifications en attente. Sélectionnez ensuite Envoyer les modifications pour les exécuter. Avant d’exécuter les modifications, les actions en attente sont affichées de la même manière que lorsque des modifications sont effectuées manuellement dans le Global Admin Console.
Export et import de schémas
Lors de l’importation de données à l’aide d’un fichier CSV, les champs peuvent apparaître dans n’importe quel ordre, mais doivent toujours correspondre à leur ligne d’en-tête.
Lors de l’import de données, vous devez spécifier une opération pour chaque élément. L’opération peut être l’une des suivantes :
- Mise à jour : indique une modification.
- Créer : indique la création d’un objet (organisation, groupe d’utilisateurs ou administrateur, par exemple).
- Supprimer : indique la suppression d’un objet (par exemple, organisation, groupe d’utilisateurs ou administrateur).
Les enregistrements d’entrée sans champ d’opération ou vide sont ignorés.
Organisations
Conditions d’importation requises :
- Pour la mise à jour ou la suppression, orgId doit faire référence à une organisation existante dans votre hiérarchie.
- Si vous créez une organisation, vous pouvez laisser le champ orgId vide ou le définir sur un identifiant unique que vous pouvez créer (par exemple new-1 ou new-2). Ceci fournit un identifiant qui peut être utilisé pour faire référence à l’organisation à créer.
- Le code pays doit être valide.
- L’ID d’organisation pour l’opération Mise à jour et Suppression doit déjà être présent dans la hiérarchie de l’organisation.
- orgId marqué comme Supprimer ne doit pas être sélectionné en tant que parentOrgId pour les organisations avec une opération Mettre à jour ou Créer.
- Les organisations enfants au même niveau et du même parent ne doivent pas avoir les mêmes orgNames.
- Pour créer une organisation ou mettre à jour le nom d’une organisation, le nom de l’organisation ne doit pas correspondre au nom d’un enfant existant du même parent.
Administrateurs
Conditions d’importation requises :
- orgId, email, adminType et userType doivent contenir des valeurs valides.
- countryCode doit être valide.
- Si l’utilisateur existe déjà et est en cours de mise à jour, userType doit correspondre à l’utilisateur.
- Recherchez les adresses e-mail en double dans l’organisation.
Profils de produit
Les exportations et importations de profils de produit se composent de deux parties : les détails du profil de produit et un ensemble de ressources associées au profil de produit. Ces ressources identifient les services qui peuvent être configurés, généralement simplement pour les activer ou les désactiver.
- Les objets de ressource sont imbriqués dans le profil de produit au format JSON.
- Lors de l’utilisation de CSV ou XLSX avec des profils de produit, les profils et les ressources sont combinés en un seul tableau. Il y aura plusieurs entrées pour le profil de produit, une pour chaque ressource.
- Le champ sélectionné dans la ressource contrôle si le service est activé.
- Lors de l’importation de profils de produit, une opération Créer ou Mettre à jour doit être effectuée sur le profil de produit lui-même et sur tout objet de ressource à mettre à jour ou à créer.
Conditions d’importation requises :
-
productProfileId, licenseId et orgId doivent avoir des valeurs valides.
-
Lors de la création d’un profil de produit, productProfileName doit être un nom valide et ne doit pas dupliquer un autre nom de profil de produit ou nom de groupe d’utilisateurs dans la même organisation.
-
Le champ de quota doit avoir une valeur valide pour le type d’unité. Il est numérique ou illimité lorsque resourceType=QUOTA ou vide dans les autres cas.
-
Le champ de notification doit être « true » ou « false ».
-
Pour les importations CSV et XLSX, validez productProfileId ; toutes ses entrées doivent avoir les mêmes orgId, licenseId et productProfileName.
-
Validez le productProfileName en double dans le fichier d’entrée et l’organisation.
-
Les profils à mettre à jour et à supprimer doivent être présents dans l’organisation.
-
Les ressources à mettre à jour et à supprimer (désactiver) doivent être présentes dans le profil.
-
Pour que les profils soient créés, vérifiez les points suivants :
- L’orgId doit être une nouvelle organisation ou une organisation existante.
- L’ID de licence doit être un nouveau produit ou un produit existant.
- Validez les ressources pour le profil.
Ressources dans les profils de produit
Conditions d’importation requises :
- Le champ Opération des ressources est ignoré lorsque des opérations sont définies pour le profil de produits auquel elles appartiennent, à savoir Supprimer ou Créer.
- Aucune ressource ne doit être marquée pour suppression ; il s’agit d’une opération non valide.
- Pour que les profils de produit soient créés, le nombre de ressources doit correspondre au nombre de ressources du profil de produit source.
- Pour les ressources avec l’opération Mise à jour, la ressource doit être présente dans le profil de produit.
Groupes d’utilisateurs
Conditions d’importation requises :
-
orgId doit faire référence à une organisation existante ou en cours de création dans le même import.
-
userGroupId doit faire référence à un groupe existant pour la mise à jour ou la suppression, et peut être un ID que vous définissez pour de nouveaux groupes d’utilisateurs.
-
Pour la mise à jour ou la création, userGroupName ne doit pas être vide et ne doit pas dupliquer un autre nom de groupe d’utilisateurs ou de profil de produit dans la même organisation.
-
Assurez-vous que userGroupName n’est pas dupliqué dans le fichier d’entrée et dans l’organisation.
-
Les groupes d’utilisateurs à mettre à jour et à supprimer doivent être présents dans l’organisation.
-
Le profil à supprimer du groupe d’utilisateurs doit être présent dans le groupe d’utilisateurs . Les opérations de mise à jour ne peuvent pas être effectuées sur le profil d’un groupe d’utilisateurs.
-
Pour que des groupes d’utilisateurs soient créés, vérifiez les points suivants :
- L’orgId doit être une nouvelle organisation ou une organisation existante.
- L’ID de licence, le cas échéant, doit être un nouveau produit ou un produit existant.
- productProfileId doit être un nouveau profil de produit ou un profil de produit existant.
Domaines
Les informations sur les domaines fournissent des informations en lecture seule sur les domaines disponibles dans chaque organisation. Ces données ne sont pas modifiables.
Produits et ressources products-and-resources
Dans les fichiers XLSX, il existe deux feuilles : une pour les produits et une pour les ressources. Dans JSON, les objets de ressource sont imbriqués dans l’objet de produit.
Produits
Conditions d’importation requises :
- Pour créer, licenseId doit être un identifiant unique que vous créez.
- Pour la mise à jour, licenseId doit être l’identifiant d’un produit existant dans l’organisation spécifiée.
- orgId doit faire référence à une organisation existante ou en cours de création dans la même opération d’importation.
- Pour créer, sourceLicenseId doit faire référence à un produit existant ou à l’ID que vous avez défini pour un produit en cours de création au cours de la même opération d’importation.
- licenseId et sourceLicenseId ne doivent pas être identiques pour les produits avec l’opération Create.
- Validez les organisations de produits. L’organisation doit être nouvelle ou doit déjà être présente dans la hiérarchie de l’organisation.
- Pour les opérations Mise à jour et Suppression, le produit doit déjà être présent dans la hiérarchie de l’organisation.
- Le licenseId marqué comme Delete ne doit pas être utilisé comme sourceLicenseId des produits avec les opérations Create et Update.
- Pour les produits avec l’opération Create, vérifiez que le sourceLicenseId doit être présent dans l’organisation parent.
Ressources pour les produits
Les objets de ressource peuvent apparaître dans les produits et dans les profils de produit.
Conditions d’importation requises :
Le champ Opération des ressources est ignoré lorsque des opérations sont définies pour le produit auquel elles appartiennent, à savoir Supprimer ou Créer.
- Aucune ressource ne doit être marquée pour suppression ; il s’agit d’une opération non valide.
- Pour les produits à créer, le nombre de ressources doit correspondre au nombre de ressources du produit source.
- Pour les ressources avec l’opération Mise à jour, la ressource doit être présente dans le produit.
Importer et exporter des données d’allocation de produit
En tant qu’administrateur global, vous pouvez exporter les données d’attribution de produit sous la forme d’un fichier JSON ou CSV. Vous pouvez ensuite modifier ces données et les charger pour importer les modifications. Lorsque les données potentiellement modifiées sont chargées, les nouvelles données sont comparées aux données actuelles et toutes les modifications sont appliquées aux données d’attribution de produit. Vous pouvez ensuite vérifier et envoyer les modifications en attente pour qu’elles prennent effet.
Exporter le modèle d’allocation de produit
Pour exporter le modèle d’attribution de produit, procédez comme suit :
- Connectez-vous à 🔗 et accédez à l’onglet Attribution du produit.
- Sélectionnez l’icône Plus d’options ⋮, puis sélectionnez Exporter au format CSV ou Exporter au format JSON. Votre fichier est téléchargé. En savoir plus sur les formats d’exportation.
Importer le modèle d’allocation de produit
Vous pouvez exporter des données, les modifier, puis importer le fichier modifié. Pour importer le modèle d’allocation de produit, procédez comme suit :
- Connectez-vous à 🔗 et accédez à l’onglet Attribution du produit.
- Sélectionnez l’icône Plus d’options ⋮ et sélectionnez Importer.
- Sélectionnez un fichier JSON ou CSV à charger.
- Sélectionnez Vérifier les modifications en attente. Après avoir examiné les modifications, sélectionnez Envoyer les modifications pour les exécuter.
Formats d’exportation et d’importation pour l’affectation de produits
Les formats d’export et d’import sont les mêmes. Lors de l’importation au format CSV, les champs peuvent apparaître dans n’importe quel ordre, mais ils doivent correspondre à la ligne d’en-tête. Lors de l’importation au format JSON, les champs peuvent apparaître dans n’importe quel ordre.
Vous devez spécifier l’opération lors de l’import des données d’allocation de produit. L’opération peut être l’une des suivantes :
- Mise à jour : indique une modification (modification des valeurs grantedQuantity et allowOverAllocation).
- Créer : indique d’ajouter une ressource produit à l’organisation spécifiée.
- Supprimer : indique la suppression du produit.
Si aucune opération n’est fournie, aucune modification ne se produit lors de l’importation des données de cette ligne au format CSV ou de cet objet au format JSON.
Dans le fichier exporté, il existe une ligne ou un enregistrement pour chaque ressource de produit. Certains produits ont plus d’une ressource.
Si un produit comporte plusieurs ressources, les opérations de mise à jour peuvent s’appliquer à des ressources indépendantes, une opération de suppression supprime le produit, y compris toutes les ressources d’une organisation, et une opération de création nécessite un enregistrement pour chacune des ressources du fichier d’importation afin que la quantité appropriée de chacune d’elles puisse être spécifiée. Le champ allowOverAllocation est à l’échelle du produit et peu importe dans quelle ressource se trouve une mise à jour de ce champ.
Description des en-têtes
Exigences d’importation
Validation des données
-
Le champ opération doit comporter une opération valide.
-
Les données d’importation de produit doivent comporter des propriétés et des valeurs pour les champs obligatoires.
-
Les propriétés des données d’importation de produit doivent être du type correct.
-
Le champ Politique de produit (sur-affectation) ne doit pas être fourni pour différentes ressources.
-
Le champ grantedQuantity :
- Ne peut pas être modifié en illimité s’il n’est pas déjà illimité.
- Doit être un entier non négatif ou la valeur de chaîne illimitée.
Autorisation/validation accessible
- L’organisation associée aux données d’importation doit exister. Si vous effectuez une mise à jour, vérifiez que le produit et la ressource associés aux données d’importation existent réellement.
Ajouter la validation du produit
- SourceLicenseId doit exister.
- L’organisation associée au nouveau produit doit exister.
- Le produit en cours de création ne doit pas exister (produit avec le même ID de licence).
- Les ressources associées à un produit en cours de création doivent avoir un productId correspondant à ce produit.