Provisioning en masse des options de configuration

Pour créer ou modifier les options de configuration d’une option, vous pouvez télécharger un fichier de valeurs séparées par des virgules (CSV) contenant les options et les valeurs nouvelles et/ou modifiées. Entrez ou modifiez les valeurs et les options dans les colonnes appropriées pour chaque objet. Lors du téléchargement dans GAX, les options indiquées dans le fichier sont créées ou modifiées, conformément à l’action définie dans la colonne Action.

Vous pouvez également utiliser GAX pour télécharger (ou exporter) des informations pour les options sélectionnées. Si vous le souhaitez, vous pouvez utiliser ce téléchargement pour créer un modèle pour le chargement des données.

Cette fonctionnalité d’importation/exportation d’options de configuration n’est disponible que pour certains types d’objets.

Exportation des options

GAX vous permet d’exporter les options sélectionnées dans une feuille de calcul. Vous pouvez modifier la feuille de calcul selon les besoins, la sauvegarder dans un fichier .csv ou .cfg, et la télécharger de nouveau dans GAX. Ou bien, vous pouvez supprimer les données (mais pas les en-têtes de colonne) et utiliser ce modèle vide pour les chargements actuels et futurs d’options de configuration.

Pour exporter les options, procédez comme suit :

1. Dans le Configuration Manager, ouvrez l’onglet Options de l’objet à partir duquel vous souhaitez exporter des options.
2. Sélectionnez les sections et les options à exporter.
3. Cliquez sur Exporter dans le menu Plus situé au-dessus de la liste des options dans le coin droit.
4. Dans la boîte de dialogue Exporter des options, sélectionnez le format du fichier de sortie, soit CFG ou CSV et cliquez sur Exporter.
   Le fichier de sortie est créé et téléchargé dans votre navigateur, avec un nom au format de fichier
        <object type>_annex_<object DBID>.csv or cfg
   Par exemple :
        CfgPerson_annex_6378.cfg or CfgPerson_annex_6378.cfg

Chargement d’un fichier

Avant de charger des mises à jour en masse, vous devez entrer les données dans une feuille de calcul et sauvegarder cette dernière au format CSV. N’oubliez pas les recommandations suivantes :

• Si la plupart de vos mises à jour ajoutent de nouvelles options à l’objet, créez un modèle vide et indiquez les valeurs appropriées.
• Si vous effectuez principalement des modifications à des options existantes, exportez uniquement les options que vous modifiez et apportez les modifications souhaitées.

Pour télécharger les données dans GAX, procédez comme suit :

1. Dans Configuration Manager, ouvrez l’onglet Options de l’objet vers lequel vous souhaitez charger les options.
2. Cliquez sur Importer dans le menu Plus menu situé au-dessus de la liste des options dans le coin droit.
3. Dans la boîte de dialogue Importer des objets :
   1. Cliquez sur Choisir un fichier et sélectionnez le fichier .csv ou .cfg avec vos modifications.
   2. Sélectionnez Remplacer les options existantes si vous êtes sûr que votre fichier contient la valeur exacte et à jour de toutes les options existantes dans l’objet. Dans le cas contraire, laissez cette case décochée.
   3. Cliquez sur Télécharger.
4. Lorsque les enregistrements ont été traités, la boîte de dialogue Opération terminée s’affiche avec un résumé des résultats. Cliquez sur Fermer pour revenir à l’onglet Options.

Fichier source

GAX utilise des fichiers .csv (valeurs séparées par des virgules) et .cfg pour l’importation et l’exportation des options de configuration. Ces deux formats prennent en charge uniquement l’importation et l’exportation des options de type chaîne. Les autres types d’options de configuration sont ignorés et ne sont ni importés ni exportés. Toutes les chaînes de ce fichier doivent être codées au format UTF-8.

Important

Le contenu du fichier se rapporte à un seul objet.

Dans un fichier CSV source, chaque ligne représente une option de configuration unique. La même option ne peut apparaître qu’une seule fois dans le fichier source. Si la section d’options de configuration n’existe pas déjà dans la configuration de l’objet, celle-ci est créée. L’identifiant unique de l’option dans le cadre du fichier source est la combinaison des champs Section et Clé. Il existe trois colonnes dans le fichier—Une pour la section d’option de configuration, une pour le nom de l’option (Clé) et une pour la valeur de l’option, d’après les entrées de la première ligne du fichier—Section, Clé et Valeur. L’ordre des colonnes n’a pas d’importance. Une virgule est insérée après chaque entrée de colonne. Le fichier source contient les informations suivantes pour chaque option :

Nom	Type	Obligatoire	Description
Section	Chaîne	Oui	Nom du fichier de configuration.
Clé	Chaîne	Oui	Nom de l’option
Valeur	Chaîne	Non	Nouvelle valeur de l’option.

Dans un fichier CFG, chaque section et option apparaît sur une ligne distincte avec les noms de section entre crochets. Chaque section est suivie de la liste des options de cette section avec les valeurs appropriées, telles que :

[section_name1]
option-name1=option_value2
...
option_nameN=option_valueN

[section_name2]
option-nameN+1=option_valueN+1
...

Exemple

Les données suivantes doivent être téléchargées dans GAX pour ajouter deux nouvelles options à un objet Utilisateur existant :

Section	Clé	Valeur
gaxproperties	datemodified	1478163902397
htcc	roles	Agent

Le fichier CSV pour cet exemple pourrait se présenter comme suit :

Section,Key,Value
gaxproperties,datemodified,1478163902397
htcc,roles,Agent

Exportées à partir de GAX sous forme d’un fichier CFG, les mêmes informations seraient présentées comme suit :

[gaxproperties]
datemodified=1478163902397
[htcc]
roles=Agent