Objet de la page cible
Le Nom de l'API de l'objet cible est un paramètre fondamental pour votre composant dynamique Avonni. Il établit l'objet Salesforce principal avec lequel votre composant interagira (par ex., Compte, Contact, Opportunité, Mon_Objet_Personnalisé__c). Il fournit le contexte de données essentiel pour les opérations et l'affichage de votre composant.
Comment définir le nom de la page cible
Vous pouvez définir ou mettre à jour l'objet de la page cible pour votre composant dynamique de deux façons :
Lors de la création d'un nouveau composant dynamique :
Lorsque vous cliquez sur "Nouveau" depuis la page d'accueil de l'application Avonni Components pour créer un composant dynamique, la boîte de dialogue de configuration initiale inclura une option (souvent une liste déroulante) libellée "Objet de la page cible".
Avant de finaliser la création du composant, sélectionnez l'objet Salesforce souhaité dans cette liste. Cela définit le contexte initial de votre nouveau composant.
Pour les composants existants (via Paramètres) :
Ouvrez votre composant dynamique dans le Constructeur de composants.
Cliquez sur l' icône Paramètres (généralement une roue ⚙️ située dans le coin supérieur gauche du constructeur).
Dans le panneau des paramètres qui apparaît, localisez la Objet de la page cible propriété.
Sélectionnez ou changez l'objet Salesforce à partir de la liste déroulante.
N'oubliez pas de Enregistrer votre composant dynamique après avoir apporté des modifications ici.
Pourquoi le nom de la page cible est-il important ?
Définir correctement le Nom de l'API de l'objet cible débloque des fonctionnalités clés d'accès aux données :
Active l'onglet Champs: Une fois défini, l'onglet Champs dans la bibliothèque de composants (panneau de gauche) se remplit avec tous les champs disponibles de l'objet sélectionné. Vous pouvez ensuite glisser-déposer ces champs sur votre canevas, créant automatiquement des composants liés aux données.
Fournit les données de l'enregistrement courant (sur les pages d'enregistrement) : Ceci est crucial pour les composants placés sur les pages d'enregistrement. Lorsque le Nom de la page cible correspond à l'objet de la page d'enregistrement (par ex., vous le définissez sur
Compteet placez le composant sur une page Compte) :Le
La variable globale $Component.recorddevient automatiquement disponible, vous donnant un accès direct à toutes les données de champs de l'enregistrement courant consulté. Par exemple, vous pouvez afficher le nom de l'enregistrement en utilisant$Component.record.Name.
L'ID de l'enregistrement courant est également facilement accessible, généralement via
$Component.record.Idou en sélectionnantl'option @recordIddans le sélecteur de ressources.
Simplifie l'affichage des données liées : Connaître l'objet principal et avoir un accès facile à l'ID de l'enregistrement courant (via
$Component.record.Idoul'option @recordId) est essentiel pour configurer des requêtes ou des filtres afin d'afficher des listes de enregistrements liés (par ex., afficher tous les Contacts liés au Compte courant)
Quand utiliser le Nom de la page cible
Pages de détails d'enregistrement : Vous définirez presque toujours l'objet de la page cible lors de la création de composants conçus explicitement pour les pages d'enregistrement, car c'est le moyen principal d'accéder aux données de l'enregistrement courant.
Affichage de listes/données liées : Chaque fois que votre composant doit afficher ou interagir avec des données liées à un enregistrement spécifique consulté sur une page.
Composants contextuels : Tout composant dont le comportement ou les informations affichées doivent être contextualisés à un enregistrement spécifique.
Relations maître-détail : Lors de la création de relations de type maître-détail entre composants au sein de votre composant dynamique (par ex., une liste de Comptes pilotant une liste de Contacts liée), le contexte fourni par l'objet de la page cible pour l'enregistrement global de la page peut être un point de départ
Quand vous pourriez Ne Pas
en avoir besoin Composants autonomes (sans contexte d'enregistrement) :
Si votre composant est entièrement indépendant de tout enregistrement spécifique et n'a pas besoin d'accéder directement aux données d'enregistrement (par ex., une calculatrice générique, un panneau d'information statique, ou un composant sur une page d'application qui affiche des synthèses à l'échelle de l'organisation sans focalisation sur un enregistrement précis), vous n'aurez peut-être pas besoin de définir l'objet de la page cible. Dans ces cas, vous utiliserez généralement la source de données Avonni Query pour récupérer les données requises sans vous appuyer sur le contexte d'une page d'enregistrement. Utiliser uniquement des variables initialisées par d'autres moyens : Si toutes les données d'enregistrement dont votre composant a besoin sont explicitement transmises via des variables d'entrée(par ex., lorsqu'un composant est lancé dans une fenêtre modale ou un panneau et reçoit un ID d'enregistrement en entrée, qui remplit ensuite une variable d'enregistrement locale via une action "Au chargement Champs "), vous n'aurez pas strictement besoin de définir l'objet global de la page cible, bien que cela puisse encore aider à remplir le
pour faciliter la conception de la mise en page.
En substance La variable globale $Component.record Définissez l'objet de la page cible lorsque votre composant a besoin d'un accès direct aux données d'un enregistrement spécifique sur une page d'enregistrement. Cela débloque la variable
Mis à jour
Ce contenu vous a-t-il été utile ?