m (1 révision importée)
m (1 révision importée)
 
(3 révisions intermédiaires par 2 utilisateurs non affichées)
Ligne 1 : Ligne 1 :
−
=Bulk Provisioning of Configuration Options=
+
=Provisioning en masse des options de configuration=
−
To create or modify the configuration options for an option, you can upload a [[BulkOpt#csv|comma-separated value (CSV) file]] containing new and/or changed options and values. You enter or modify options and values in the appropriate columns object. When uploaded to GAX, the options listed in the file are created or modified, based on the action to be taken as indicated in the Action column.
+
{{#anc:Bulk Provisioning of Configuration Options}}
 +
Pour créer ou modifier les options de configuration d’une option, vous pouvez télécharger un [[BulkOpt#csv|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.
  
−
You can also use GAX to download (or export) information for selected options. If you want, you can use this download to create a "template" for the data upload.  
+
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.  
  
−
This import/export of configuration options functionality is available for all object types.
+
Cette fonctionnalité d’importation/exportation d’options de configuration n’est disponible que pour certains types d’objets.
  
 
{{AnchorDiv|export}}
 
{{AnchorDiv|export}}
−
==Exporting Options==
+
{{#anc:Exporting Options}}
−
GAX allows you to export selected options into a spreadsheet. You can modify the spreadsheet as required, save it as a '''.csv''' or '''.cfg''' file, and [[BulkOpt#upload|upload]] it back into GAX.  Or, you can remove the data (but not the column headers) from it, and use this "empty" template for present and future uploads of configuration options.
+
==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 [[BulkOpt#upload|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.
  
−
To export options, do the following:
+
Pour exporter les options, procédez comme suit :
 
<ol>
 
<ol>
−
<li> In Configuration Manager, open the Options tab of the object from which you want to export options.</li>
+
<li> Dans le Configuration Manager, ouvrez l’onglet Options de l’objet à partir duquel vous souhaitez exporter des options.</li>
−
<li> Select the sections and options to be exported.</li>
+
<li> Sélectionnez les sections et les options à exporter.</li>
−
<li> Click '''Export''' in the '''More''' menu located above the option list in the right corner.</li>
+
<li> Cliquez sur '''Exporter''' dans le menu '''Plus''' situé au-dessus de la liste des options dans le coin droit.</li>
−
<li> In the '''Export Options''' dialog box, select the format of the output file, either CFG or CSV, and click '''Export'''.<br/>
+
<li> 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'''.<br/>
−
The output file is created and downloaded to your browser, with a filename in the format<br/>
+
Le fichier de sortie est créé et téléchargé dans votre navigateur, avec un nom au format de fichier<br/>
 
&nbsp;&nbsp;&nbsp;&nbsp; '''<object type>_annex_<object DBID>.csv or cfg'''<br/>
 
&nbsp;&nbsp;&nbsp;&nbsp; '''<object type>_annex_<object DBID>.csv or cfg'''<br/>
−
For example:<br/>
+
Par exemple :<br/>
 
&nbsp;&nbsp;&nbsp;&nbsp; '''CfgPerson_annex_6378.cfg''' or '''CfgPerson_annex_6378.cfg'''
 
&nbsp;&nbsp;&nbsp;&nbsp; '''CfgPerson_annex_6378.cfg''' or '''CfgPerson_annex_6378.cfg'''
 
</li>
 
</li>
Ligne 25 : Ligne 27 :
 
{{AnchorDiv|upload}}
 
{{AnchorDiv|upload}}
  
−
==Uploading a File==
+
{{#anc:Uploading a File}}
−
Before uploading bulk updates, you must enter the data into a spreadsheet and save it as a CSV file. Keep in mind the following recommendations:
+
==Chargement d’un fichier==
−
* If most of your updates are adding new options to the object, create an empty template and fill in the appropriate values.  
+
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 :
−
* If you are primarily making changes to existing options, [[BulkOpt#export|export]] only the options that you are changing, and make the changes.
+
* 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, [[BulkOpt#export|exportez]] uniquement les options que vous modifiez et apportez les modifications souhaitées.
  
−
To upload the data into GAX, do the following:   
+
Pour télécharger les données dans GAX, procédez comme suit :   
 
<ol>
 
<ol>
−
<li> In Configuration Manager, open the '''Options''' tab of the object into which you want to upload the options.</li>
+
<li> Dans Configuration Manager, ouvrez l’onglet '''Options''' de l’objet vers lequel vous souhaitez charger les options.</li>
−
<li> Click '''Import''' in the '''More''' menu located above the option list in the right corner.</li>
+
<li> Cliquez sur '''Importer''' dans le menu '''Plus''' menu situé au-dessus de la liste des options dans le coin droit.</li>
−
<li> In the '''Import Objects''' dialog box:
+
<li> Dans la boîte de dialogue '''Importer des objets''' :
 
<ol type=a>
 
<ol type=a>
−
<li> Click '''Choose File''' and select the .csv or .cfg file with your changes.</li>
+
<li> Cliquez sur '''Choisir un fichier''' et sélectionnez le fichier .csv ou .cfg avec vos modifications.</li>
−
<li> Select '''Overwrite existing options''' if you are sure that your file contains the accurate and most up-to-date current value for any options that may already exist in the object. Otherwise, leave it blank.</li>
+
<li> 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.</li>
−
<li>Click '''Upload'''.</li>  
+
<li>Cliquez sur '''Télécharger'''.</li>  
 
</ol></li>
 
</ol></li>
−
<li>When the records have been processed, the '''Operation Concluded''' dialog box is displayed, showing a summary of the results. Click '''Close''' to return to the '''Options''' tab.</li>
+
<li>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'''.</li>
 
</ol>
 
</ol>
  
 
{{AnchorDiv|csv}}
 
{{AnchorDiv|csv}}
−
==Source File==
+
{{#anc:Source File}}
−
GAX uses '''.csv''' (comma separated value) and '''.cfg''' files for the import and export of configuration options. Both formats support only the import and export of string options. Other types of configuration options are ignored and not imported or exported. All strings in this file must be encoded in UTF-8.
+
==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.
  
−
{{NoteFormat|The contents of the file relates to only one object.}}
+
{{NoteFormat|Le contenu du fichier se rapporte à un seul objet.}}
  
 
<tabber>
 
<tabber>
−
CSV Files=
+
Fichiers CSV=
−
In a CSV source file, each line represents a single configuration option. The same option can appear in the source file only once. If the configuration options section does not already exist in the object's configuration, it is created. The unique identifier of the option in the scope of the source file is the combination of the <tt>Section </tt> and <tt>Key</tt> fields.
+
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 <tt>Section </tt> et <tt>Clé</tt>.
  
−
There are three columns in the file&mdash;one each for the configuration option section, the name of the option (Key), and the option value, named by the entries in the first row of the file&mdash;Section, Key, and Value. The order of the columns is not important. A comma is inserted after each column entry.
+
Il existe trois colonnes dans le fichier&mdash;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&mdash;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.
  
−
The source file contains the following information for each option:
+
Le fichier source contient les informations suivantes pour chaque option :
 
{|
 
{|
−
! '''Name'''
+
! '''Nom'''
 
! '''Type'''
 
! '''Type'''
−
! '''Mandatory'''
+
! '''Obligatoire'''
 
! '''Description'''
 
! '''Description'''
 
|-
 
|-
 
| Section
 
| Section
−
| String
+
| Chaîne
−
| Yes
+
| Oui
−
| The name of the configuration file.
+
| Nom du fichier de configuration.
 
|-
 
|-
−
| Key
+
| Clé
−
| String
+
| Chaîne
−
| Yes
+
| Oui
−
| The name of the option
+
| Nom de l’option
 
|-
 
|-
−
| Value
+
| Valeur
−
| String
+
| Chaîne
−
| No
+
| Non
−
| The new value of the option.
+
| Nouvelle valeur de l’option.
 
|}
 
|}
  
 
|-|
 
|-|
−
CFG Files=
+
Fichiers CFG=
−
In a CFG file, each section and option appears on a separate line, with section names in square brackets. Each section is followed by a list of options in that section, with the appropriate values, such as:
+
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 :
 
<source lang="text">
 
<source lang="text">
 
[section_name1]
 
[section_name1]
Ligne 94 : Ligne 98 :
  
 
{{AnchorDiv|eg}}
 
{{AnchorDiv|eg}}
−
===Example===
+
{{#anc:Example}}
−
The following data is to be uploaded to GAX to add two new options for an existing User object:
+
===Exemple===
 +
Les données suivantes doivent être téléchargées dans GAX pour ajouter deux nouvelles options à un objet Utilisateur existant :
 
{|
 
{|
 
! Section
 
! Section
−
! Key
+
! Clé
−
! Value
+
! Valeur
 
|-
 
|-
 
| gaxproperties
 
| gaxproperties
Ligne 110 : Ligne 115 :
 
|}
 
|}
  
−
The CSV file for this would look like this:
+
Le fichier CSV pour cet exemple pourrait se présenter comme suit :
 
<source lang="text">
 
<source lang="text">
 
Section,Key,Value
 
Section,Key,Value
Ligne 117 : Ligne 122 :
 
</source>
 
</source>
  
−
Exported from GAX as a CFG file, the same information would look like this:
+
Exportées à partir de GAX sous forme d’un fichier CFG, les mêmes informations seraient présentées comme suit :
 
<source lang="text">
 
<source lang="text">
 
[gaxproperties]
 
[gaxproperties]

Version actuelle datée du août 24, 2019 à 00:59

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
La dernière modification de cette page a été faite le août 24, 2019 à 00:59.
Comments or questions about this documentation? Contact us for support!