Configurer automatiquement les composants à l'aide de paramètres prédéfinis

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 3 minutes de lecture
  • Utilisez les paramètres prédéfinis des composants pour configurer automatiquement les composants sur les pages compatibles.

    Utilisez les paramètres prédéfinis des composants pour appliquer des valeurs de configuration prédéfinies et des mappages d’événements à des composants. Générateur d'IU Les modèles de page contiennent des contrôleurs que les paramètres prédéfinis utilisent pour définir les valeurs de configuration des composants.

    Les paramètres prédéfinis appliquent des configurations prédéfinies aux propriétés des composants et aux gestionnaires d’événements et ne sont disponibles que pour certains composants. Ils sont basés sur des cas d’utilisation courants pour les composants, tels que la configuration d’un composant de formulaire avec des champs qui sont généralement inclus dans une page d’enregistrement.

    L’application d’un paramètre prédéfini configure automatiquement les composants pour qu’ils fonctionnent immédiatement, simplifiant ainsi la création et la maintenance des pages pour les auteurs de pages.

    Les paramètres prédéfinis offrent les avantages suivants aux auteurs de page :

    • Gestion de données complexes et liaison d’événements pour les composants
    • Réduction du coût de possession et de maintenance grâce à la définition externe aux pages

    Dans le volet Configuration, vous pouvez choisir d’appliquer un paramètre prédéfini au composant sélectionné ou de le configurer manuellement. Les paramètres prédéfinis par défaut sont automatiquement appliqués aux composants lorsqu’une page est créée à partir d’un modèle ou que le contrôleur requis pour le paramètre prédéfini est déjà ajouté à la page. Toutes les propriétés ou tous les événements configurés par le paramètre prédéfini s’affichent en lecture seule lorsqu’un paramètre prédéfini est appliqué.

    Vous pouvez remplacer les valeurs configurées par un paramètre prédéfini, mais ce faisant, vous assumez la propriété de la configuration et de la maintenance du composant.

    Les sous-pages n’héritent pas des contrôleurs et ne peuvent pas utiliser de paramètres prédéfinis dans Yokohama.
    Figure 1. Paramètre prédéfini appliqué à un composant
    Propriétés du composant d’en-tête configurées par un paramètre prédéfini.

    Liaisons de données et d’événements

    Les paramètres prédéfinis peuvent inclure des liaisons vers :

    • Propriétés de sortie du contrôleur (@data)
    • Charges utiles de l’événement (@payload)
    • Contexte de la session (@context.session)
    • Formules complexes (transformations de clients)

    Les paramètres prédéfinis peuvent également inclure des mappages d’événements aux événements gérés par un contrôleur. Pour plus d'informations, consultez Gérer les actions dans les pages du générateur d’IU.

    Contrôleurs

    Les paramètres prédéfinis connectent les composants aux données et aux mappages d’événements à l’aide d’un contrôleur. Si le contrôleur requis par un paramètre prédéfini n’est pas déjà sur la page, le paramètre prédéfini vous invite à configurer les propriétés requises du contrôleur et ajoute le contrôleur. Une fois qu’un contrôleur est ajouté à une page, les composants dont des paramètres prédéfinis sont associés au contrôleur apparaissent en surbrillance dans la liste des composants. Pour plus d'informations, consultez Lier les données aux Générateur d'IU pages à l’aide de contrôleurs (fonctionnalité avancée).

    Figure 2. Composants avec paramètres prédéfinis
    Onglet Composants affichant les composants avec l’étiquette prédéfinie mise en surbrillance.

    Sélectionner un composant prédéfini

    Choisissez un paramètre prédéfini de composant lors de l’ajout d’un composant à votre page.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tout > Cadre de travail Now Experience > Générateur d'IU.
    2. Ouvrez une expérience pour y travailler ou créez une expérience en sélectionnant Créer > Expérience.
      Consultez la rubrique Configurer la façon dont les utilisateurs interagissent avec vos applications dans Générateur d'IU pour plus d’informations sur la création d’expériences.
    3. Créez ou ouvrez une page ou une variante de page.
      Pour plus d’informations sur la création d’une page dans le générateur d’IU, consultez Créer une page dans le générateur d’IU.
    4. Ouvrez la boîte à outils.
    5. Ajoutez un composant surligné en vert à votre page.

      Les composants surlignés en vert ont des paramètres prédéfinis disponibles.

      Ouvrez la bibliothèque de composants et faites glisser un composant surligné en vert sur votre page.
    6. Le composant se configure automatiquement avec le paramètre prédéfini par défaut.
      Le paramètre prédéfini du composant par défaut s’affiche dans la liste déroulante des paramètres prédéfinis.
    7. Facultatif : Sélectionnez un autre paramètre prédéfini dans la liste du panneau de configuration.
      Vous pouvez configurer un composant pour qu’il n’utilise pas de paramètre prédéfini en sélectionnant Supprimer.
      1. Sélectionnez Continuer pour remplacer le paramètre prédéfini existant.
      Sélectionnez un autre paramètre prédéfini ou aucun paramètre prédéfini dans la liste.
    8. Cliquez sur Enregistrer.

    Remplacer un paramètre prédéfini du composant

    Remplacez un composant prédéfini pour entrer vos propres valeurs personnalisées.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Sélectionnez un composant avec un paramètre prédéfini.
      Sélectionnez le composant que vous souhaitez remplacer dans l’arborescence de contenu.
    2. Recherchez la valeur de données que vous souhaitez remplacer dans le panneau de configuration.
    3. Cliquez sur l’icône de verrou dans le champ de données.
    4. Entrez la valeur de données dont vous souhaitez remplacer la valeur prédéfinie.
    5. Sélectionnez Enregistrer.
      Remplacez les valeurs de composant prédéfinies par des valeurs personnalisées.

    Résultats

    Le panneau de configuration affiche la valeur personnalisée dans le champ.

    Réinitialiser un composant

    Réinitialiser les paramètres prédéfinis des composants à leurs valeurs par défaut.

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Sélectionnez le composant que vous souhaitez réinitialiser dans l’arborescence de contenu.
      Sélectionnez le composant que vous souhaitez remplacer dans l’arborescence de contenu.
    2. Sélectionnez le nom du composant dans le panneau de configuration.
      Nom du composant dans le panneau de configuration.
    3. Cliquez sur Réinitialiser le composant.
      Réinitialiser les valeurs de composant avec l’option de réinitialisation du composant.
    4. Cliquez sur Réinitialiser.

    Résultats

    Le composant prédéfini se réinitialise aux valeurs par défaut.