Ouvrir une action rapide

Aperçu

L'interaction « Ouvrir une action rapide » vous permet de lancer les actions rapides Salesforce directement depuis un composant dynamique Avonni. Cela offre un moyen fluide de déclencher des actions rapides standard ou personnalisées sans obliger les utilisateurs à naviguer vers les pages de détail des enregistrements, permettant des flux de travail rationalisés et une saisie des données plus rapide.


Configuration

L'interaction « Ouvrir une action rapide » relie une action utilisateur (comme cliquer sur un bouton) à une action rapide Salesforce. Une fois configurée, elle ouvre la fenêtre modale de l'action rapide, pré-remplit éventuellement les champs du formulaire et transmet le contexte tel que les identifiants d'enregistrements.

Ajoutez cette interaction à n'importe quel composant Avonni pris en charge via le panneau de propriétés du composant sous « Interactions ». Sélectionnez « Ouvrir une action rapide » comme type d'interaction.

Nom de la cible

C'est ici que vous sélectionnez quelle action de votre composant déclenchera l'action rapide. Lorsque vous ajoutez des actions aux composants (comme des actions d'en-tête sur un tableau de données ou des actions de ligne), elles deviennent disponibles dans ce menu déroulant.

Comment ça fonctionne

  • Tout d'abord, vous créez une action sur votre composant (par ex., une « Envoyer un e-mail » en tant qu'action de ligne sur un tableau de données)

  • Le nom de cette action apparaît ensuite comme option dans le menu déroulant Nom de la cible

  • Sélectionnez l'action que vous souhaitez connecter à cette interaction d'action rapide

Exemple : Si vous avez ajouté une action de ligne appelée « Envoyer un e-mail » à votre tableau de données, vous sélectionneriez « Envoyer un e-mail » dans le menu déroulant Nom de la cible pour lier cette action à l'action rapide.

Entité source

Ceci spécifie le contexte d'objet pour votre action rapide :

  • Pour les actions rapides spécifiques à un objet : Saisissez le nom API de l'objet standard ou personnalisé (par ex., Contact, Compte, Opportunité, Custom_Object__c)

  • Pour les actions rapides globales : Laissez ce champ vide

Pourquoi c'est important : Les actions rapides spécifiques à un objet sont liées à un objet particulier et apparaissent dans le menu d'actions de cet objet. Les actions rapides globales fonctionnent dans l'ensemble de l'organisation et ne sont liées à aucun objet spécifique.

Nom API de l'action rapide

Il s'agit du nom API de l'action rapide que vous souhaitez lancer. Le format dépend de son caractère spécifique à un objet ou global :

Pour les actions rapides spécifiques à un objet : Incluez le nom API de l'objet suivi d'un point (.) avant le nom API de l'action rapide.

Format : ObjectAPIName.QuickActionAPIName

Exemples :

  • Contact.SendEmail - Action Envoyer un e-mail sur l'objet Contact

  • Account.LogACall - Action Consigner un appel sur l'objet Compte

  • Opportunity.NewTask - Action Créer une tâche sur l'objet Opportunité

  • Custom_Object__c.Custom_Action__c - Action personnalisée sur un objet personnalisé

Pour les actions rapides globales : Utilisez uniquement le nom API de l'action rapide (sans préfixe d'objet).

Exemples :

  • NewContact - Action globale pour créer un contact

  • NewTask - Action globale pour créer une tâche

  • LogACall - Action globale pour consigner un appel

  • SendEmail - Action globale pour envoyer un e-mail

Comment trouver le nom API :

  • Allez dans Configuration → Gestionnaire d'objets → [Votre objet] → Boutons, liens et actions

  • Ou Configuration → Actions globales (pour les actions globales)

  • Trouvez votre action et notez son nom API

ID d'enregistrement (Facultatif)

Ceci spécifie avec quel enregistrement l'action rapide doit être associée ou utilisé comme contexte. Saisissez une référence à un champ ou une variable contenant l'ID de l'enregistrement.

Utilisations courantes :

  • record:Id - L'enregistrement actuel consulté (si sur une page d'enregistrement)

  • {!Datatable1.selectedRowsKeyValue} - L'enregistrement sélectionné depuis un tableau de données

  • {!variableName} - Une variable contenant un ID d'enregistrement

Quand utiliser l'ID d'enregistrement :

  • Lorsque l'action rapide doit savoir sur quel enregistrement elle agit

  • Pour des actions comme « Envoyer un e-mail » qui nécessitent un enregistrement associé

  • Pour créer des enregistrements associés (par ex., créer une tâche liée à un compte)

Valeurs préremplies (Facultatif)

Cela vous permet de remplir automatiquement des champs du formulaire de l'action rapide avant son ouverture, faisant gagner du temps aux utilisateurs et garantissant la cohérence des données.

Pour chaque valeur préremplie :

  • Nom API du champ : Le nom API du champ dans l'action rapide que vous souhaitez pré-remplir (par ex., Objet, Statut, Priorité)

  • Valeur : Ce que vous souhaitez remplir - cela peut être :

    • Une valeur statique (par ex., « Appel de suivi »)

    • Une valeur dynamique depuis votre composant (par ex., {!accountName.value})

    • Une variable de ressource (par ex., {!selectedStatus})

Exemples d'utilisations :

  • Pré-remplir le champ Objet d'une tâche avec « Suivi : » + nom du compte

  • Définir le Statut d'un nouveau dossier à « Nouveau »

  • Remplir le champ Lié à avec l'ID du compte courant

  • Par défaut, définir la Priorité sur « Élevée » pour les actions urgentes


Dépannage

L'action rapide ne s'ouvre pas

  • Vérifiez que le nom API de l'action rapide est correct (sensible à la casse)

  • Vérifiez que l'action rapide existe et est active dans votre organisation

  • Assurez-vous d'utiliser le format correct (Objet.Action pour les actions spécifiques à un objet, juste Action pour les globales)

  • Vérifiez que l'utilisateur a les autorisations pour accéder à l'action rapide

Erreur « Action rapide introuvable »

  • Vérifiez à nouveau le nom API dans la Configuration

  • Assurez-vous d'avoir inclus le nom de l'objet pour les actions spécifiques à un objet (par ex., Contact.SendEmail)

  • Pour les actions globales, assurez-vous de ne pas avoir inclus de préfixe d'objet

L'ID d'enregistrement ne se transmet pas correctement

  • Vérifiez que le nom API de votre tableau de données correspond à celui utilisé dans la formule

  • Vérifiez qu'une ligne est effectivement sélectionnée dans le tableau

  • Utilisez l'attribut correct (.selectedRowsKeyValue pour la sélection unique)

Les valeurs préremplies n'apparaissent pas

  • Vérifiez que les noms API des champs correspondent exactement aux noms des champs de l'action rapide

  • Vérifiez que les champs sont bien inclus dans la mise en page de l'action rapide

  • Assurez-vous que vos expressions de valeur sont valides et retournent le type de données correct

L'utilisateur voit une erreur lors de la soumission de l'action rapide

  • Il s'agit généralement d'une erreur de validation Salesforce, et non d'un problème de configuration

  • Vérifiez les règles de validation Salesforce et les champs obligatoires

  • Assurez-vous que les valeurs préremplies respectent les exigences des champs


Besoin de plus d'aide ?

Si vous avez des questions sur l'implémentation des interactions d'action rapide pour votre cas d'utilisation spécifique, ou si vous rencontrez des problèmes de configuration des actions rapides, n'hésitez pas à nous contacter. Nous sommes là pour vous aider à créer des flux de travail rationalisés avec les composants Avonni

Mis à jour

Ce contenu vous a-t-il été utile ?