Automatisation de la livraison de données avec des flux déclenchés par l'activation
Connectez automatiquement les activations Data 360 à des systèmes externes en utilisant les connecteurs MuleSoft pour l'intégration de flux ou une action d'appel externe HTTP.
Éditions requises
| Afficher les éditions prises en charge. |
| Autorisations utilisateur requises | |
|---|---|
| Pour créer, modifier, enregistrer, supprimer et activer un flux déclenché par l'activation | Administrateur hérité de Data Cloud Marketing OU Gestionnaire d'activation de Data Cloud OU Architecte Data Cloud OU Spécialiste de l'activation de Data Cloud OU Gérer le flux OU Toutes ces autorisations :
|
Vous pouvez vous connecter à un système de destination externe en utilisant des flux déclenchés par l'activation de deux façons :
- Connecteurs MuleSoft : Les connecteurs MuleSoft sont disponibles dans Flow Builder. Lors de la configuration d'une action dans votre flux, vous pouvez sélectionner parmi les connecteurs ci-dessous. Pour afficher les actions prises en charge, consultez Connecteurs tiers.
- Services externes (appel externe HTTP) : Vous pouvez vous connecter via un appel externe HTTP, qui utilise les capacités existantes de la plate-forme Salesforce, notamment les Services externes et les identifiants nommés. Avant de créer le flux, configurez un identifiant nommé en utilisant la capacité de la plate-forme à configurer les points de terminaison d'API et les détails d'authentification pour le système externe. Lors de l'ajout d'une action à votre flux, sélectionnez l'option Créer un appel externe HTTP, puis sélectionnez l'identifiant nommé que vous avez précédemment configuré. Pour plus d'informations sur la création et la gestion de services externes, consultez Inscription d'un service externe.
Pour créer un flux déclenché par l'activation, vous devez créer une activation pour un segment ou créer une activation pour un objet modèle de données par lot dans Data 360. Les flux déclenchés par l'activation prennent en charge uniquement le type de cible d'activation Data 360.
Les flux déclenchés par l'activation prennent en charge les méthodes d'authentification suivantes lors de la connexion à d'autres destinations basées sur l'API :
- OAuth 2.0
- Flux Code d'autorisation : recommandé pour les applications dans lesquelles l'interaction de l'utilisateur se fait via un navigateur Web.
- Flux Identifiants client : recommandé pour les interactions serveur à serveur sans l'intervention de l'utilisateur. Les poignées de main entre Salesforce et le système externe cible pour l'obtention et l'actualisation de jetons doivent être conformes aux normes pour pouvoir utiliser les Identifiants clients.
- Authentification de base : l'utilisateur fournit un nom d'utilisateur et un mot de passe.
- Clés d'API : accès API en fournissant une clé unique dans la requête HTTP.
Pour plus d'informations sur l'authentification, consultez Considérations relatives aux flux déclenchés par l'activation.
- Création du flux
Créez un flux déclenché par l'activation. - Dépannage et affichage des métriques de flux et des rapports
Configurez votre organisation pour afficher les métriques et les rapports sur les flux déclenchés par l'activation afin de pouvoir surveiller et dépanner les exécutions de flux. - Considérations relatives aux flux déclenchés par l'activation
Consultez plus de considérations sur les flux déclenchés par l'activation.
Voir également :
Création du flux
Créez un flux déclenché par l'activation.
- Accédez à l'onglet Flux dans l'application Automatisation, puis cliquez sur Nouveau.
- Recherchez et sélectionnez Flux déclenché par l'activation.
-
Dans la Bibliothèque d'activation, sélectionnez l'activation Data 360 qui déclenche le flux.
Les flux déclenchés par l'activation prennent en charge uniquement les activations créées avec Data 360 comme type de cible d'activation. Bien que la liste des activations disponibles dans Flow Builder puisse afficher des activations avec d'autres types de cible tels que Marketing, la sélection d'une activation qui n'est pas du type cible Data 360 entraîne une erreur lorsque vous essayez d'enregistrer le flux. Vous devez savoir à l'avance que l'activation que vous sélectionnez est de type cible Data 360.
- Dans l'élément Démarrer, vous pouvez également configurer des règles de sortie et des conditions de rentrée. Les règles de sortie terminent un flux s'il remplit certaines conditions. Les règles de sortie sont utiles dans les situations où la situation d'un utilisateur change au fil du temps. Les conditions de rentrée déterminent si un utilisateur est éligible pour rentrer dans le même flux.
-
Cliquez sur
, puis sélectionnez Action ou un autre élément.
- Pour utiliser un connecteur MuleSoft, sélectionnez Action, puis le groupe d'actions Connecteur dans le panneau Actions. Sélectionnez un connecteur, puis configurez les détails de connexion ou sélectionnez une connexion existante. Pour Services externes,
- Pour utiliser un service externe, sélectionnez Action, puis cliquez sur Créer un appel externe dans le panneau Actions. Consultez Configuration d'une action Appel externe HTTP.
-
Pour utiliser une activation d'API, ajoutez un élément Activation Envoyer à Data 360. Vous pouvez ajouter plusieurs éléments Activation Envoyer à Data 360 à un flux.
- Pour utiliser les fonctionnalités de Marketing Cloud, vous pouvez utiliser des éléments tels que Envoyer au parcours, Envoyer un SMS ou Envoyer un e-mail. Consultez Éléments de Flow Builder pour les flux marketing.
- Pour obtenir, créer, mettre à jour ou supprimer un enregistrement Salesforce, vous pouvez utiliser les éléments standard Obtenir, Créer, Mettre à jour ou Supprimer des enregistrements.
-
Spécifiez une action et mappez les champs requis par le système externe avec les données disponibles à partir des données d'activation déclenchantes.
Vous pouvez mapper des données d'activation jusqu'à 5 niveaux de profondeur pour des attributs associés.
- Pour utiliser des attributs associés aux données d'activation, vous devez d'abord transformer les attributs associés en type pris en charge, par exemple une classe ou un objet Apex. Par exemple, si votre service externe nécessite une classe Apex, utilisez un élément Transformer ou Attribution pour créer un mappage Apex.
- Pour identifier le type Apex requis pour l'action, créez une ressource. Dans la fenêtre Nouvelle ressource, copiez la valeur existante dans le champ Classe Apex. Après avoir copié la valeur, annulez ou fermez la fenêtre.
- Ajoutez un élément Transformer avant l'élément Action.
- Dans l'élément Transformer, sélectionnez $ActivationData comme source de données, puis Apex-Defined pour le type de données cible. Collez la valeur Classe Apex dans le champ Classe Apex. Cliquez sur Créer.
- Configurez le reste du flux.
- Activez le flux.
Dépannage et affichage des métriques de flux et des rapports
Configurez votre organisation pour afficher les métriques et les rapports sur les flux déclenchés par l'activation afin de pouvoir surveiller et dépanner les exécutions de flux.
Si vous rencontrez un comportement inattendu :
- Vérifiez le statut de publication du segment utilisé pour créer l'activation Data 360.
- Si le statut de publication du segment est Réussi, vérifiez le nombre de segments et le nombre d'activations correspondant dans le tableau « Historique de publication » de l'interface utilisateur du segment dans Data 360 ou dans le tableau « Historique d'activation » de l'interface utilisateur d'activation de Data 360.
- Si le statut de publication du segment et du nombre d'activations est Réussi, l'activation correspondante doit déclencher le flux déclenché par l'activation.
- Lorsqu'une activation déclenche un flux déclenché par l'activation, mais avant la fin de l'exécution du flux, nous créons un enregistrement d'occurrence de version du flux. Pendant l'exécution du flux, l'enregistrement d'occurrence de version du flux suit les entrées, les sorties et les erreurs d'une version de flux spécifique.
- Lorsque vous visualisez un flux déclenché par l'activation dans Flow Builder, vous pouvez sélectionner des éléments individuels dans la zone de dessin et afficher les métriques de cet élément.
Pour afficher les détails de vos exécutions de flux, vous pouvez également créer un rapport Exécution d'élément de flux. Les flux déclenchés par l'activation nécessitent de déployer des flux de données pour les objets modèle de données FlowRun et FlowElementRun. Ces flux de données activent la consignation de l'historique d'exécution de flux. L'historique d'exécution de flux peut être interrogé et peut vous aider à comprendre les détails de vos exécutions de flux, et à dépanner les problèmes éventuels.
- Installez le package Salesforce Data Cloud - Flow Integration pour tous les utilisateurs.
- Dans l'application Data 360, sélectionnez l'onglet Flux de données, puis cliquez sur Nouveau.
- Dans la fenêtre Nouveau flux de données, sélectionnez Kits de données et packages installés, puis cliquez sur Suivant.
- Sélectionner Data Cloud Flow dans la liste Kits de données
- Cochez la case en regard de Flow_Ingestion pour sélectionner tous les flux de données, puis cliquez sur Suivant.
- Pour Nom du connecteur, sélectionnez Nouveau connecteur.
- Saisissez le nom du connecteur Flow Run Ingestion, puis cliquez sur Enregistrer.
- Cliquez sur Suivant pour suivre les étapes jusqu'au déploiement du flux de données, puis cliquez sur Déployer.
- Déployez ensuite les flux Enregistrement de flux. Dans Configuration, saisissez Ensembles d'autorisations dans la case Recherche rapide, puis sélectionnez-les.
- Cliquez sur l'ensemble d'autorisations Data Cloud Salesforce Connector.
- Dans la section Applications, cliquez sur Autorisations d'application.
- Dans la section Flux et orchestration de flux, sélectionnez Afficher les flux, puis cliquez sur Enregistrer et confirmer.
- Dans l'application Data 360, sélectionnez l'onglet Flux de données, puis cliquez sur Nouveau.
- Dans la fenêtre Nouveau flux de données, sélectionnez Salesforce CRM, puis cliquez sur Suivant.
- Dans la section Paquets personnalisés, sélectionnez Flux, puis cliquez sur Suivant.
- Cliquez sur Suivant pour suivre les étapes jusqu'au déploiement du flux de données, puis cliquez sur Déployer.
- Pour créer un rapport, dans l'application Data 360, accédez à l'onglet Rapports, puis cliquez sur Nouveau rapport.
- Dans la catégorie Data Cloud, sélectionnez Élément de flux avec Exécution d'élément de flux, puis cliquez sur Démarrer le rapport.
-
Sous l'onglet Plan, ajoutez les colonnes suivantes :
- Élément de flux : Info - Nom
- Élément de flux : Info - Version du flux
- Élément de flux : Info - Motif de l'erreur
- Élément de flux : Info - Description de l'erreur
- Exécution d'élément de flux : Info - DateHeure planifiée
- Exécution d'élément de flux : Info - DateHeure de fin
- Sous l'onglet Filtres, ajoutez un filtre vide avec l'opérateur égal à pour Version du flux.
- Cliquez sur Enregistrer.
- Pour récupérer l'ID de version du flux requis pour le filtre de rapport, sélectionnez le flux déclenché par l'activation dans l'application Lightning Automation.
- Sous l'onglet Associé, sélectionnez la version du flux appropriée.
-
Dans la barre d'adresse de votre navigateur, copiez l'ID de version du flux. L'ID commence par
10v. - Dans le rapport que vous avez créé précédemment, collez l'ID de version du flux dans le filtre, puis cliquez sur Appliquer.
Considérations relatives aux flux déclenchés par l'activation
Consultez plus de considérations sur les flux déclenchés par l'activation.
Considérations relatives aux limites tarifaires
La limite en taux des flux déclenchés par l'activation dépend de votre licence. Les limites de taux sont mesurées en actions par heure. Les actions sont définies par l'exécution d'un parcours unique d'un flux, y compris le démarrage et la reprise du flux. Les flux reprennent après avoir attendu qu'un événement se produise, par exemple une durée d'élément d'attente expirant ou la réception d'un événement d'engagement.
Par exemple, un flux sans élément Attente est exécuté en une seule action. Un flux avec un élément Attente est exécuté en deux actions, la première action incluant tout jusqu'à l'élément Attente, et la deuxième action incluant tout après la reprise du flux.
En plus de la limite en actions par heure, une limite en simultanéité détermine le nombre d'exécutions de flux par heure. Généralement, la limite totale en simultanéité est répartie équitablement entre tous les flux en cours d'exécution.
| Limite en exécution | Fils concurrents |
|---|---|
| 150 000 actions par heure | 2 |
| Starter : 1 000 000 d'actions par heure | 14 |
| Marketing Cloud, Data 360 : 15 000 000 d'actions par heure | 210 |
Utilisez la (actions per hour * time to execute in seconds) / 3600 = required
concurrency per hour de formule pour déterminer si votre flux dépasse la limite en simultanéité requise pour maximiser ses actions par heure.
Par exemple, une organisation provisionnée avec 15 millions d'actions par heure a un flux avec une seule action dont l'exécution prend en moyenne 40 millisecondes. (15,000,000 * 0.04) /
3600 = 167. Comme 167 est inférieur à la limite de 210 en simultanéité, le flux peut exécuter 15 millions d'actions par heure.
Si un autre flux a une seule action, mais que son exécution prend en moyenne 150 millisecondes en raison d'une action de service externe, utilisez la (15,000,000 * 0.15) / 3600 =
625 de formule. Comme 625 est supérieur à la limite en simultanéité de 210, le flux peut exécuter environ 5 millions d'actions par heure s'il utilise les 210 threads.
Le dernier facteur limitant est le taux d'erreur du flux. Les taux d'erreur ne prennent en compte que les erreurs réessayables. Les éléments de flux qui échouent plus de 2,5 % du temps déclenchent une limitation de taux supplémentaire. La limite en simultanéité est ajustée jusqu'à ce que les taux d'erreur restent constamment inférieurs à 2,5 %. Ces ajustements aident à protéger les services en aval, notamment les services externes. Les taux d'erreur sont probablement le facteur limitant le plus fréquent qui affecte la capacité d'un flux à exécuter ses actions maximales par heure.
Les flux qui nécessitent des réponses en temps réel, tels que les soumissions de formulaire, les inscriptions par SMS, les SMS bidirectionnels et les e-mails de transaction prioritaires, ont une allocation supplémentaire de 50 % par rapport à la limite en simultanéité. Par exemple, si vous avez une limite en simultanéité de 210, les flux qui nécessitent des réponses en temps réel peuvent accéder à 105 requêtes simultanées supplémentaires (210 * 1,5 = 315).
Considérations relatives à l'authentification
Les flux déclenchés par l'activation prennent en charge deux flux d'authentification OAuth 2.0.
- Flux Code d'autorisation
- But : Principalement utilisé pour les applications dans lesquelles l'interaction de l'utilisateur via un navigateur Web est attendue ou requise.
- Procédé:
- L'utilisateur est redirigé vers le serveur d'autorisation de l'application externe pour authentifier et autoriser l'application.
- Une fois l'autorisation réussie, un code d'autorisation est renvoyé à Salesforce via un URI de redirection.
- L'application échange ce code d'autorisation contre un jeton d'accès, que Salesforce actualise en cas de besoin.
- Use Case: Convient le mieux aux applications Web et aux applications nécessitant une sécurité élevée, en particulier dans les cas qui nécessitent un accès Par utilisateur.
- Références :
- Spécification du flux Code d'autorisation OAuth 2.0
- Exemple d'identifiant nommé : Flux de navigateur OAuth 2.0 avec un principal nommé
- Exemple d'identifiant nommé : Flux de navigateur OAuth 2.0 avec un principal par utilisateur
- Création ou modification d'un identifiant externe OAuth avec le flux Navigateur
- Flux Identifiants client
- But : Convient aux interactions serveur à serveur dans lesquelles aucun utilisateur n'est impliqué.
- Procédé:
- L'application cliente envoie une requête directement au point de terminaison de jeton de l'application externe, y compris son ID client et son secret client.
- L'application externe renvoie un jeton d'accès qui peut être utilisé pour authentifier les requêtes d'API.
- Use Case: Idéal pour les services back-end ou les applications qui accèdent à des ressources en leur nom propre plutôt qu'en celui d'un utilisateur.
- Références :
- Considérations : Pour pouvoir utiliser les Identifiants clients, les poignées de main entre Salesforce et le système externe cible pour obtenir et actualiser des jetons doivent être conformes aux normes. Certains fournisseurs qui n'affichent pas de comportements conformes aux normes ne sont pas pris en charge.
Les flux déclenchés par l'activation prennent en charge des formes d'authentification supplémentaires :
- Authentification de base
- But : Une méthode simple pour la communication client-serveur.
- Procédé:
- Le client envoie des requêtes HTTP avec le nom d'utilisateur et le mot de passe codés en base64 dans l'en-tête de la requête.
- Le serveur décode et vérifie les identifiants avant d'accorder l'accès.
- Considérations relatives à la sécurité : L'authentification de base doit être utilisée avec précaution et toujours sur HTTPS pour crypter les identifiants et s'assurer qu'ils ne sont pas exposés pendant la transmission.
- Références :
- Clés d'API
- But : Active un accès API simple en incorporant une clé unique à la requête HTTP.
- Procédé:
- Salesforce inclut la clé d'API dans les requêtes HTTP (généralement dans un en-tête) pour l'authentification au service.
- Le serveur valide la clé d'API avant de traiter la requête.
- Use Case: Pratique pour intégrer des systèmes où la facilité d'utilisation est prioritaire par rapport aux exigences de sécurité complexes.
- Références :
- Il n'existe aucune norme ou spécification de l'industrie pour les clés d'API. Examinez attentivement la documentation de l'application externe afin de déterminer son niveau d'adéquation avec ce que Salesforce prend en charge.
- Utilisation de clés d'API dans des en-têtes personnalisés avec des identifiants nommés
Autres considérations
Vous ne pouvez pas empaqueter des métadonnées Data 360, par exemple des activations, dans le même package que des métadonnées non Data 360. Pour empaqueter une activation Data 360 avec un flux, utilisez deux packages.
