Créer un jeu de variables et l'ajouter à un élément

Créez un jeu de variables et ajoutez-le à plusieurs éléments de catalogue et guides de commande pour le réutiliser.

Avant de commencer

Rôle requis : catalog_admin, admin, catalog_editor ou catalog_manager

Pourquoi et quand exécuter cette tâche

• Les jeux de variables d’un élément de catalogue ne peuvent pas avoir le même nom interne.
• Dans un élément de catalogue, le nom d’une variable ne peut pas être identique au titre ou au nom interne d’un jeu de variables.
  Remarque :

  Cette condition s’applique également lorsqu’une variable ne fait pas partie du jeu de variables.
• Tous les scripts clients de catalogue ou scripts de politique d’interface utilisateur de catalogue doivent faire référence au nom interne d’un jeu de variables et pas à son nom ou titre.

Procédure

1. Accédez à la Tout > Catalogue de services > Variables de catalogue > Jeux de variables.
2. Cliquez sur Nouveau.
   La page Création d’un jeu de variables s'affiche.
3. Sélectionnez l’une des options suivantes.

   Option	Description
   Jeu de variables d'une seule ligne	Crée un jeu de variables avec des variables qui sont regroupées. Le champ Type est défini sur Ligne unique.
   Jeu de variables de plusieurs lignes	Crée un jeu de variables de plusieurs lignes qui capture des données de variables dans une mise en page de grille. Le champ Type est défini sur Plusieurs lignes.

4. Renseignez les détails.

   Champ	Description
   Titre	Titre d'un jeu de variables. Apparaît si la case Titre d’affichage est cochée.
   Nom interne	Nom du jeu de variables pour une utilisation interne. Par exemple, pour accéder au jeu de variables pour le serveur frontal (via l'API g_form) et le scripting côté serveur.
   Ordre	Numéro de commande pour le jeu de variables.
   Type	Type du jeu de variables. Les choix possibles sont : Ligne unique ; Plusieurs lignes.
   Application	Applications pouvant utiliser ce jeu de variables.
   Titre d’affichage	Si ce champ est sélectionné, un titre et un en-tête extensible sont ajoutés à droite du jeu de variables. Remarque : lorsqu'un utilisateur demande l'élément, toutes les variables Case à cocher sont regroupées sous le titre par défaut Options. Pour utiliser un titre personnalisé, insérez une variable de type Étiquette, avec une valeur Commande qui la place directement au-dessus des variables Case à cocher.
   Attributs de jeu de variables	Attributs pour configurer le jeu de variables de plusieurs lignes. Utilisez l'attribut max_rows pour définir une limite au nombre de lignes que vous pouvez ajouter à un jeu de variables de plusieurs lignes. Par exemple, spécifiez max_rows=1 comme valeur du champ.
   Mise en page	Affichage de la mise en page. Définissez cette propriété sur Élargi sur 1 colonne, Élargi sur 2 colonnes, en alternant les côtés ou Élargi sur 2 colonnes, d'un côté puis de l'autre.
   Description	Description du jeu de variables.

5. Cliquez avec le bouton droit et sélectionnez Enregistrer.
6. Créez les variables à utiliser dans le jeu.
   1. Dans la liste connexe Variables, cliquez sur Nouveau.
   2. Suivez les étapes pour créer des variables.
      Remarque :

      pour un jeu de variables de plusieurs lignes :

      • Les variables incluses sont affichées sous forme de colonnes d'une table.
      • L'ordre des colonnes est celui des variables définies dans le jeu de variables.
7. Pour créer une règle de recherche de données de catalogue associée, procédez comme suit.
   1. Dans la liste connexe Définitions de recherche de données de catalogue, cliquez sur Nouveau.
   2. Dans le formulaire Définitions de recherche de données de catalogue, renseignez les champs.
      Pour en savoir plus sur la création d’une règle de recherche de données, reportez-vous à la section Créer une définition de recherche de catalogue.
8. Cliquez sur Envoyer.

Ajouter un jeu de variables à un élément de catalogue ou à un guide de commande

Catalogue de services vous permet d'ajouter un jeu de variables à un ou plusieurs éléments de catalogue ou guides de commande.

Avant de commencer

Rôle requis : catalog_admin, admin, catalog_editor ou catalog_manager

Procédure

1. Ouvrez un élément de catalogue ou un guide de commande.

   Option	Chemin de navigation
   Élément de catalogue	Catalogue de services > Définition du catalogue > Gérer les éléments
   Guide de commande	Catalogue de services > Définition du catalogue > Guides de commande

2. Dans la liste connexe Jeux de variables, cliquez sur Modifier.

   Vous pouvez configurer le formulaire pour ajouter la liste connexe Jeux de variables.

3. Sélectionnez et ajoutez un jeu de variables.
   Remarque :

   si la case Variables en cascade est cochée pour un guide de commande, des données de jeu de variables de plusieurs lignes devraient être en cascade sur les éléments inclus.
4. Cliquez sur Enregistrer.
5. Cliquez sur Essayer.
   Remarque :

   pour un jeu de variables de plusieurs lignes :

   • Les variables associées sont affichées sous forme de colonnes d'une table sur un élément de catalogue ou un créateur d'enregistrement. Chaque ligne correspond à un ensemble de données pour toutes les variables du jeu de variables.
   • L'ordre des colonnes est celui des variables définies dans le jeu de variables.
6. Facultatif : Modifiez un jeu de variable de plusieurs lignes.
   1. Pour ajouter une ligne, cliquez sur Ajouter dans le jeu de variables, spécifiez les différentes informations dans la fenêtre Ajouter une ligne et cliquez sur Ajouter.
      Remarque :

      • Vous pouvez ajouter un maximum de 50 lignes.
      • À moins que des valeurs par défaut ne soient fournies pour les variables ou que des scripts onLoad soient utilisés pour pré-remplir les données, vous devez ajouter des données de variables pour chaque ligne.
   2. Pour modifier une ligne, cliquez sur l'icône Modifier une ligne dans la colonne Actions, spécifiez les différentes informations dans la fenêtre Modifier la ligne et cliquez sur Enregistrer.
      Remarque :

      lorsque vous ajoutez ou modifiez une ligne existante, toutes les politiques d'interface utilisateur et tous les scripts clients de catalogue associés au jeu de variables de plusieurs lignes doivent être respectés.
   3. Pour supprimer une ligne, cliquez sur l'icône Supprimer une ligne dans la colonne Actions et cliquez sur Supprimer dans la fenêtre de confirmation.
   4. Pour supprimer toutes les lignes de la table, cliquez sur Supprimer tout dans le jeu de variables et cliquez sur Supprimer dans la fenêtre de confirmation.