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

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

    Utilisez des paramètres prédéfinis de composant 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. Elles sont basées 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 sur 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 de pages et la maintenance pour les auteurs de pages.

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

    • Gestion des données complexes et de la 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 .Zurich
    Figure 1. Paramètre prédéfini appliqué à un composant
    En-tête : propriétés du composant 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 qui ont des paramètres prédéfinis 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.

    Cochez la case Paramètres prédéfinis disponibles pour afficher les composants avec des paramètres prédéfinis dans la boîte à outils.

    Sélectionner un composant prédéfini

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

    Avant de commencer

    Rôle requis : admin

    Procédure

    1. Accédez à la Tous > 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 Générateur d’IU, consultez Créer une page dans Générateur d’IU.
    4. Ouvrez la boîte à outils.
    5. Cochez la case Paramètres prédéfinis disponibles .
    6. Sélectionnez le composant que vous souhaitez ajouter à votre page.
      Ouvrir la boîte à outils affichant les composants avec des paramètres prédéfinis.
    7. Le composant se configure automatiquement avec le paramètre prédéfini par défaut.
      Le composant prédéfini par défaut s’affiche dans la liste déroulante des paramètres prédéfinis.
    8. 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 le paramètre prédéfini actuel.
      1. Sélectionnez un nouveau composant prédéfini dans le panneau de configuration.
      2. Sélectionnez Appliquer 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.
    9. Cliquez sur Enregistrer.

    Remplacer un composant prédéfini

    Remplacez un composant prédéfini pour saisir 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 du composant à 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éinitialisez les valeurs du 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.