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

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 du composant pour appliquer des valeurs de configuration prédéfinies et des mappages d’événements aux 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 des composants, tels que la configuration d’un composant de formulaire avec des champs 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 et la maintenance des pages pour les auteurs de pages.

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

• Gestion des 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 de pages externes

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 de contrôleurs et ne peuvent pas utiliser de paramètres prédéfinis dans Washington DC.

Figure 1. Paramètre prédéfini appliqué à un composant

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

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

• 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 sur les événements gérés par un contrôleur. Pour plus d'informations, consultez Gérer les actions dans les pages UI Builder (fonctionnalité avancée).

Contrôleurs

Les paramètres prédéfinis connectent les composants aux mappages de données et 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 sont mis en surbrillance dans la liste des composants. Pour plus d'informations, consultez Lier des données à des pages UI Builder à l’aide de contrôleurs (fonctionnalité avancée).

Figure 2. Composants avec des paramètres prédéfinis

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 dans laquelle travailler ou créez une expérience en sélectionnant + Créer.
   Consultez Configurer la façon dont les utilisateurs interagissent avec vos applications dans Générateur d'IU pour en savoir plus 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 UI Builder, consultez Créer une page dans UI Builder.
4. Ouvrez la boîte à outils.
5. Ajoutez un composant surligné en vert à votre page.

   Les composants mis en surbrillance en vert ont des paramètres prédéfinis disponibles.

   
6. Le composant se configure automatiquement avec le paramètre prédéfini par défaut.
   
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.
   
8. Cliquez sur Enregistrer.

Remplacer un composant prédéfini

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.
   
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 que vous souhaitez remplacer la valeur prédéfinie.
5. Sélectionnez Enregistrer.
   

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.
   
2. Sélectionnez le nom du composant dans le panneau de configuration.
   
3. Cliquez sur Réinitialiser le composant.
   
4. Cliquez sur Réinitialiser.

Résultats

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