Champs

Le package Avonni Dynamic Components offre un moyen puissant d'afficher et d'interagir avec les données Salesforce directement sur vos pages d'application et d'enregistrement. Pour accéder aux champs de données dans votre composant dynamique, utilisez l'onglet Champs avec soit le Nom API de l'objet cible paramètre ou un Variable d'enregistrement du type d'objet approprié.

Aperçu

L'onglet Champs vous permet d'ajouter facilement des champs Salesforce à vos composants, créant des éléments liés aux données sans écrire de code. Vous pouvez :

• Afficher les données d'enregistrement : Afficher les valeurs des champs d'un enregistrement Salesforce spécifique.

• Permettre la saisie/modification des données : Les utilisateurs peuvent saisir ou modifier les valeurs des champs.

• Déclencher des actions : Utiliser les données d'enregistrement dans des interactions (par exemple, transmettre un ID d'enregistrement à un Flux).

Emplacement du panneau Champs

Comment cela fonctionne : accès aux champs

L'onglet Champs offre un moyen pratique d'ajouter des composants liés aux données à votre canevas. Pour remplir l'onglet Champs, vous avez deux options :

Option 1 : Nom API de l'objet cible (pour les pages d'enregistrement et l'accès général à l'objet)

1. Cliquez sur l'icône Paramètres (en haut à gauche du Créateur de composants).

2. Définissez le Nom API de l'objet cible sur le nom API de l'objet Salesforce avec lequel vous souhaitez travailler (par exemple, Account, Contact, My_Custom_Object__c). Ceci est typiquement l'objet de la page d'enregistrement sur laquelle vous placerez le composant.

3. Ouvrez la Bibliothèque de composants (panneau de gauche) et cliquez sur l'onglet Champs Vous verrez maintenant une liste de champs de l'objet sélectionné.

4. Lorsque vous faites glisser des champs à partir d'ici, le composant créé est automatiquement lié à la variable spéciale $Component.record pré-remplie avec les données de l'enregistrement courant.

Option 2 : Variable d'enregistrement (pour des enregistrements spécifiques ou une logique personnalisée)

1. Créez une variable d'enregistrement : Dans le panneau Ressources créez une nouvelle ressource Variable et définissez son Type de données sur Enregistrement. Choisissez l'objet Salesforce approprié pour le type d'enregistrement.

2. Remplir la variable d'enregistrement : Vous utiliserez généralement une interaction "Au chargement" avec une action "Récupérer des enregistrements" pour obtenir et stocker un enregistrement spécifique dans votre Variable d'enregistrement. (Voir la documentation "Interaction Au chargement" pour les détails..

3. Ouvrez la Bibliothèque de composants (panneau de gauche) et cliquez sur l'onglet Champs onglet. Vous devriez voir une liste de champs correspondant au type d'objet de la Variable d'enregistrement.

4. Lorsque vous faites glisser des champs, le composant créé est lié à votre Variable d'enregistrement.

Le $Component.record ressource Variable

Lorsque vous définissez le Nom API de l'objet cible, Avonni Dynamic Components met automatiquement à disposition une variable spéciale : $Component.record.

• Sur les pages d'enregistrement : Si votre composant dynamique est placé sur une page d'enregistrement, $Component.record contiendra les données pour le enregistrement courant. Par exemple, $Component.record.Name le nom du compte serait stocké sur une page d'enregistrement de compte.

• Pas sur les pages d'enregistrement : Si votre composant n'est pas sur une page d'enregistrement (par exemple, sur une page d'application), $Component.record peut être vide ou indéfini. Dans ces cas, vous utiliserez souvent une source de données de requête pour récupérer des données puis travailler avec ces données au lieu de $Component.record.

Enregistrement ou suppression des données de champ : utilisation des interactions

Lorsque vous faites glisser des champs sur votre canevas de composant dynamique à l'aide de l'onglet Champs ils sont généralement liés aux données (soit à la $Component.record variable globale sur une page d'enregistrement ou à une ressource Variable d'enregistrement spécifique). Cela permet aux utilisateurs de voir et, si configuré, de modifier les données directement dans ces composants (comme des champs de saisie de texte, des listes de sélection, etc.).

Informations importantes

Modifier un champ sur le canevas n'enregistre pas automatiquement ce changement dans Salesforce. Vous devez configurer des interactions séparées pour effectuer des actions telles que enregistrer des mises à jour, créer de nouveaux enregistrements ou supprimer des enregistrements en fonction des données affichées ou saisies dans ces champs. Ces interactions sont le plus souvent déclenchées en cliquant sur un composant Avonni Button de bouton Avonni.

Interactions clés pour les opérations sur les enregistrements

Voici les interactions principales que vous utiliserez pour rendre vos champs actionnables :

• Mettre à jour à partir d'une Variable d'enregistrement:

  • Cas d'utilisation : Utilisez ceci lorsque vous avez chargé des données dans une Variable d'enregistrement spécifique (en utilisant une "Au chargement" > action "Récupérer des enregistrements", ou en liant divers champs de saisie à ses champs) et que vous souhaitez enregistrer les modifications de cette variable dans l'enregistrement Salesforce correspondant.

  • Comment : Ajoutez ceci à l'événement "Au clic" d'un bouton "Enregistrer" ou "Mettre à jour", en vous assurant de sélectionner la Variable d'enregistrement correcte dans la configuration de l'interaction.

• Créer à partir d'une Variable d'enregistrement:

  • Cas d'utilisation : Utilisez ceci pour créer un nouvel enregistrement Salesforce en utilisant les données que les utilisateurs ont saisies dans des champs de saisie liés à une Variable d'enregistrement spécifique (souvent utilisé dans des formulaires personnalisés).

  • Comment : Ajoutez ceci à l'événement "Au clic" d'un bouton "Créer", "Soumettre" ou "Enregistrer nouveau", en sélectionnant la Variable d'enregistrement contenant les données du nouvel enregistrement.

• Upsert à partir d'une Variable d'enregistrement:

  • Cas d'utilisation : Combine la logique de création et de mise à jour. Il mettra à jour un enregistrement existant si un ID est présent dans la Variable d'enregistrement ou en créera un nouveau sinon.

  • Comment : Configurez de manière similaire à Créer/Mettre à jour, en le liant à la Variable d'enregistrement pertinente.

• Supprimer à partir d'une Variable d'enregistrement:

  • Cas d'utilisation : Supprime l'enregistrement Salesforce dont l'ID se trouve dans la Variable d'enregistrement spécifiée.

  • Comment : Ajoutez ceci à l'événement "Au clic" d'un bouton "Supprimer". Il est crucialment recommandé d'utiliser une interaction "Ouvrir confirmation" avant cette action pour demander la confirmation à l'utilisateur, afin d'éviter les suppressions accidentelles. Vous devez sélectionner la Variable d'enregistrement contenant l'ID de l'enregistrement à supprimer.

Exemple : afficher et modifier le nom du compte

1. Définir l'objet cible : Dans les paramètres de votre composant dynamique, définissez le Nom de la page cible sur Account.

2. Faire glisser le champ : Ouvrez la Champs onglet dans la Bibliothèque de composants. Trouvez le Nom champ (sous Account) et faites-le glisser sur le canevas. Avonni créera probablement un Champ de saisie de texte de bouton Avonni.

3. Ajouter un bouton : Faites glisser un Bouton composant sur le canevas. Étiquetez-le "Enregistrer".

4. Ajouter une interaction "Au clic" au bouton :

   • Sélectionnez le bouton.

   • Allez au panneau Interactions.

   • Ajoutez une interaction "Au clic".

   • Type d'action : Choisissez Mettre à jour à partir d'une Variable d'enregistrement et sélectionnez la variable d'enregistrement correspondante.

Maintenant, lorsque vous placez ce composant dynamique sur une page d'enregistrement de compte :

• Le champ de saisie affichera le nom du compte courant (parce qu'il est lié à $Component.record.Name).

• L'utilisateur peut modifier le nom dans le champ de saisie.

• Cliquer sur le bouton "Enregistrer" déclenchera le flux pour enregistrer les modifications.

Principaux avantages

• Développement rapide : Créer rapidement des composants liés aux données sans écrire de code.

• Configuration visuelle : L'interface glisser-déposer et la création automatique de composants rendent le processus intuitif.

• Cohérence des données : Garantit que vos composants affichent toujours les données correctes de l'enregistrement courant.

En résumé

L'onglet Champs affiche les champs d'objet et les objets standard disponibles en fonction du Nom API de l'objet cible défini. Vous pouvez faire glisser et déposer ces champs pour permettre aux utilisateurs de visualiser, modifier et créer des enregistrements.