Sélecteur d'enregistrements

Aperçu

Le composant Avonni Record Picker est un élément d'interface utilisateur préconstruit pour l'application Salesforce Dynamic Components. Il permet aux utilisateurs de rechercher. Ce composant est idéal pour les formulaires, les workflows ou les interfaces nécessitant une sélection rapide d'enregistrements.

Cas d'utilisation

• Formulaire de dossier : Sélectionnez un Account ou un Contact associé pour l'affectation du dossier.

• Page Opportunité : Choisissez un Account parent ou une Campagne pour le contexte.

• Formulaire d'objet personnalisé : Choisissez des enregistrements liés (par ex., Chef de projet pour un Project__c).

• Flux de service : Affectez des techniciens ou des actifs à partir de listes consultables.

• Gestion d'événements : Sélectionnez des lieux ou des sponsors à partir d'objets personnalisés.

• Saisie de données : Simplifiez le lien d'enregistrements dans les formulaires Dynamic Component.

---

Configuration

Propriétés de base

Celles-ci contrôlent la fonctionnalité principale et l'étiquetage.

Propriété	Type	Description	Exemple
Nom API	Texte	Identifiant unique pour l'instance.	RecordPicker
Étiquette	Texte	Étiquette affichée pour le champ de saisie.	"Sélectionner un contact"
Nom API de l'objet	Chaîne	Nom API de l'objet Salesforce à interroger (par ex., Account, Contact, Custom_Object__c).	Contact
Valeur	Liaison	Stocke l'ID de l'enregistrement sélectionné (accessible via $Component.RecordPicker.Value).	Lier à une variable pour utilisation
Aide au niveau du champ	Texte (Optionnel)	Texte d'aide affiché à côté de l'étiquette pour guider.	"Rechercher un contact."
Variante	Sélectionner	Style de l'étiquette : standard (au-dessus), étiquette-en-ligne (à côté), étiquette-masquée, étiquette-empilée (s'anime vers le haut).	standard
Espace réservé	Texte	Texte d'indice lorsque le champ est vide.	"Tapez pour rechercher..."
Requis	Booléen	Impose une sélection ; à utiliser avec la validation de formulaire.	Activé
Désactivé	Booléen	Empêche l'interaction avec le composant.	Désactivé

Afficher la section d'informations

Celles-ci configurent l'affichage des suggestions.

Propriété	Type	Description	Exemple
Champ principal	Chaîne	Champ affiché en premier dans les suggestions (par défaut le champ Name).	Nom
Champ supplémentaire	Tableau (Chaîne)	Champ supplémentaire unique pour les suggestions (tableau contenant un nom de champ API).	["Email"]

Section d'informations de recherche

Celles-ci contrôlent le comportement de recherche.

Propriété	Type	Description	Exemple
Mode	Sélectionner	Correspondance de recherche : Contient (correspond n'importe où), Commence par (correspond au début).	Contient
Champ principal	Chaîne	Champ principal pour les requêtes de recherche (Texte ou Formula-Text uniquement).	Nom
Champ supplémentaire	Chaîne	Un champ supplémentaire pour les requêtes de recherche (Texte ou Formula-Text uniquement).	Email

Astuce: Définissez le Mode sur « Contient » pour des recherches flexibles ; utilisez les champs Principal/Supplémentaire pour vous concentrer sur les données pertinentes. (Espace réservé pour capture d'écran : Record Picker avec suggestions.)

Onglet Interactions

Définir des actions lors de la sélection d'un enregistrement.

Propriété	Type	Description
Au changement	Paramètres	Déclencher lors de la sélection : Utilisez $Component.RecordPicker.Value (ID d'enregistrement) pour les actions (par ex., Mettre à jour l'enregistrement, Naviguer, Afficher un toast).

---

Exemples

Cet exemple configure le composant Avonni Record Picker dans l'application Dynamic Components pour afficher une liste de Contacts avec nom complet et e-mail sur une page Lightning, vers la page d'enregistrement du Contact sélectionné en utilisant la valeur générée par le composant.

1. Ajouter le Record Picker à une page Lightning :

   • Dans le Dynamic Components Builder, glissez le composant Avonni Record Picker sur une page Lightning (par ex., une page de vue de liste de Contacts).

   • Pourquoi cela ? Place le Record Picker sur la page où les utilisateurs peuvent interagir avec lui, comme dans une application Lightning personnalisée ou une page d'enregistrement.

2. Configurer Record Picker :

   • Dans le panneau Propriétés, configurez :

     • Nom API : ContactSelector

     • Étiquette : "Sélectionner un contact"

     • Nom API de l'objet : Contact

     • Espace réservé : "Rechercher des contacts..."

     • Champ principal : Name (affiche le nom complet)

     • Champ supplémentaire : ["Email"] (affiche l'e-mail à côté du nom)

     • Mode : Contient

   • Pourquoi cela ? Le Record Picker affiche une liste consultable de Contacts sur la page Lightning, affichant leur nom complet et leur e-mail, avec l'ID sélectionné disponible via $Component.ContactSelector.Value.

3. Définir l'interaction :

   • Dans l'onglet Interactions du Record Picker, configurez :

     • À la sélection d'un enregistrement :

       • Ajoutez une Naviguer action :

         • Cible : Naviguer vers la page d'enregistrement du Contact en utilisant /{$Component.ContactSelector.Value} (la valeur générée par le composant pour l'ID d'enregistrement sélectionné).

       • Pourquoi cela ? L'événement « À la sélection d'un enregistrement » se déclenche lorsqu'un Contact est choisi, naviguant vers la page d'enregistrement correspondante. L'attribut $Component.ContactSelector.Value renvoie l'ID de l'enregistrement (par ex., 003xxxxxxxxxxxx) de l'élément sélectionné, permettant la redirection correcte sans avoir besoin d'une variable séparée.

   • Remarque : L'attribut $Component.ContactSelector.Value sur le composant Record Picker renvoie dynamiquement l'ID de l'enregistrement de l'élément sélectionné, qui est utilisé directement dans l'URL de navigation.

Résultat : Les utilisateurs recherchent et sélectionnent un Contact sur la page Lightning, et l'interaction navigue vers la page d'enregistrement du Contact sélectionné en utilisant l'ID provenant de $Component.ContactSelector.Value.

---

Considérations clés

• Sélection d'objet : Assurez-vous que le Nom API de l'objet correspond à un objet Salesforce valide avec des champs consultables.

• Champs de recherche : Utilisez des champs Texte ou Formula-Text pour les champs Principal/Supplémentaire afin d'éviter les erreurs.

• Liaisons dynamiques : Liez la Valeur à une variable pour utilisation dans des flux ou des mises à jour ; utilisez {!Record.FieldApiName} pour des en-têtes contextuels sur les pages d'enregistrement.

• Champs obligatoires : Combinez Requis avec la validation de formulaire pour imposer des sélections.

• Performance : Testez avec de grands ensembles de données ; limitez les champs de recherche pour la vitesse.

• Accessibilité : Assurez des Étiquettes/Espaces réservés clairs ; testez la navigation au clavier pour les suggestions.

---

Dépannage des problèmes courants

• Aucune suggestion affichée : Vérifiez le Nom API de l'objet et les champs de recherche ; vérifiez les autorisations utilisateur.

• Recherche ne fonctionnant pas : Confirmez que le Mode et les champs Principal/Supplémentaire sont de type Texte ; testez avec des termes d'exemple.

• Valeur non capturée : Assurez-vous que la Valeur est liée à une variable ; vérifiez la configuration des interactions.

• Problèmes d'interface : Ajustez la Variante pour l'espace ; testez la visibilité de l'Espace réservé sur mobile.

• Requis non appliqué : Ajoutez une logique de validation dans Flow ; assurez-vous que Requis est Activé.

• Performance lente : Limitez les champs de recherche ; optimisez les requêtes sur l'objet.

---

Résumé

Le composant Avonni Record Picker simplifie la sélection d'enregistrements dans Salesforce Dynamic Components, avec des options de recherche et d'affichage flexibles. Il est parfait pour les formulaires et les workflows nécessitant des recherches rapides.