Configuration d’un flux simple

Objectifs de formation

Une fois cette unité terminée, vous pourrez : 

• Configurer un flux simple
• Configurer une planification et un filtre pour votre flux
• Vérifier dans la configuration de Salesforce qu’AppFlow est connecté

Les sections suivantes vous guideront dans la configuration d’un flux simple entre AWS et Salesforce. Étant donné qu’il s’agit d’un service payant et que les données dont vous disposez peuvent varier, nous ne vous demanderons pas de configurer un flux dans une organisation Trailhead Playground ou de développement. Nous vous présentons essentiellement ces étapes afin que vous disposiez de consignes pour réaliser l’intégration. Elles vous familiariseront également avec le processus afin que vous puissiez configurer l’automatisation et faire circuler les données dans différentes directions ultérieurement.

Examinons d’abord le cas d’utilisation d’un flux simple : il s’agit d’un flux qui envoie des données depuis Salesforce vers AWS selon une planification définie. La réalisation de ce processus débute dans AWS Management Console.

Accès à AppFlow et attribution d’un nom à votre flux

Pour configurer votre intégration AppFlow, vous devez utiliser AWS Management Console.

1. Connectez-vous à AWS et saisissez AWS Management Console.
2. Saisissez AppFlow dans le champ Find Services (Rechercher des services), puis cliquez sur Amazon AppFlow.
3. Cliquez sur Create flow (Créer un flux).
4. Dans la section Flow details (Détails du flux), nommez le flux et saisissez une description.
   Dans cet exemple, le nom du flux est « SalesforceToAmazonS3Demo » (1) et la description est « Copy opportunity records from Salesforce into an Amazon S3 bucket » (Copier les enregistrements d’opportunité issus de Salesforce dans un compartiment Amazon S3). (2) Il vaut mieux être clair et concis afin que vos collègues sachent exactement quelle est la fonction du flux.
5. Cliquez ensuite sur Suivant.

Connexion de Salesforce

1. Sélectionnez Salesforce dans la liste déroulante Source name (Nom de la source).
2. Choisissez une connexion Salesforce dans la liste déroulante. Si aucune connexion n’existe, sélectionnez soit Create new connection (Créer une connexion), soit Create new connection with AWS PrivateLink (Créer une connexion avec AWS PrivateLink) si vous utilisez la connexion privée Salesforce.
3. Cliquez sur Se connecter.
4. Dans la fenêtre contextuelle, choisissez votre organisation de production ou votre organisation sandbox.
5. Saisissez un nom dans le champ Connection name (Nom de la connexion). Dans cet exemple, Production est sélectionné et le nom de la connexion est « MySalesforceProdConnection ».
6. Cliquez sur Continuer.
7. Vous êtes dirigé vers une page d’autorisation Salesforce. En fonction de vos paramètres dans Salesforce, les cas de figure suivants peuvent se présenter :
   1. Vous devrez peut-être seulement autoriser l’accès. Dans ce cas, vérifiez que vous vous connectez sous le bon nom d’utilisateur Salesforce, puis cliquez sur Allow (Autoriser).
   2. Si vous êtes invité à saisir vos identifiants Salesforce, saisissez les identifiants corrects, puis connectez-vous et cliquez sur Allow (Autoriser).
8. Ensuite, vous devez choisir si vous souhaitez récupérer des Salesforce Objects (objets Salesforce) spécifiques ou si vous souhaitez vous abonner à des Salesforce Events (événements Salesforce) (Capture des données de modification et événements de plate-forme) au sein de Amazon S3. Vous pouvez faire votre choix parmi tous les objets, y compris les objets personnalisés.
9. Dans la destination, sélectionnez Amazon S3.
10. Dans la liste déroulante, choisissez un compartiment S3 appartenant à la même région AWS que celle dans laquelle vous créez ce flux. Si vous n’avez pas de compartiment S3, cliquez ici pour connaître les étapes permettant d’en créer un.
11.   Sous Additional Settings (Paramètres supplémentaires), vous pouvez également choisir des paramètres avancés pour configurer différents formats de données, tels que JSON, CSV ou Parquet, ainsi que la dénomination des fichiers et les préférences d’agrégation.

Configuration de votre flux

Ensuite, vous devez choisir à quel moment doit s’exécuter le flux. L’option on-demand (à la demande) vous permet d’exécuter le flux dès que vous enregistrez votre configuration. L’autre option consiste à planifier votre flux. Dans cet exemple, Run flow on schedule (Exécuter le flux selon une planification) (1) est sélectionné. Le flux est configuré pour se répéter toutes les minutes (2) et pour transférer uniquement les nouvelles données (3). 

Vous pouvez choisir parmi différents champs de date Salesforce, tels que Create Date (Date de création) ou Last Modified Date (Date de dernière modification) pour identifier les modifications.

Après avoir configuré le flux comme vous le souhaitez, cliquez sur Next (Suivant).

Mappage des champs

Il est temps de mapper les champs entre Salesforce et Amazon S3. AppFlow vous permet de mapper les champs manuellement (1) ou de charger des fichiers CSV contenant des champs mappés.  

Dans la section Map data fields (Mapper les champs de données), sélectionnez les champs de l’objet Salesforce que vous souhaitez transférer. Vous pouvez également choisir de mapper tous les champs en un seul clic. Dans cet exemple (2), les champs suivants sont sélectionnés.

• ID de compte
• Deleted (Supprimé)
• Master Record ID (ID d’enregistrement principal)
• Type de compte
• Parent Account ID (ID de compte parent)
• Billing Street (Facturation - Rue)

Au cours de cette étape, vous pouvez également ajouter une formule aux champs : vous pouvez ainsi masquer des caractères ou tronquer des champs. Vous avez également la possibilité de combiner deux champs pour créer un champ de destination. 

Cliquez sur Next (Suivant) lorsque vous êtes prêt à continuer.

Validations

Dans la section Validations (Validations), vous pouvez ajouter des validations spécifiques par champ pour entraîner la réalisation d’actions précises. Par exemple, vous pouvez sélectionner le champ Account Type (Type de compte) et appliquer une condition telle que « si le type de compte est absent ou nul, ignorer cet enregistrement ». La configuration des validations est facultative.

Filtrage de vos données

Ensuite, vous avez la possibilité de filtrer les données. Par exemple, avec le champ Created Date (Date de création), vous pouvez filtrer les enregistrements créés avant ou après une date donnée. 

Cliquez sur Next (Suivant) lorsque vous êtes prêt à continuer.

Vérification de votre flux

La dernière étape consiste à vérifier et à créer votre flux. Vérifiez la configuration du flux et cliquez sur Create flow (Créer un flux). Voilà ! Votre flux est prêt à s’exécuter. 

Cliquez sur Activate Flow (Activer le flux) si vous configurez le flux pour qu’il s’exécute selon la planification définie ou cliquez sur Run Flow (Exécuter le flux) si vous configurez le flux pour qu’il s’exécute à la demande. 

Vérification de la bonne connexion de votre flux

De retour dans Salesforce, vérifiez si AppFlow est connecté.

1. Vous connecter à Salesforce
2. Cliquez sur et sélectionnez Configurer.
3. Saisissez application connectée dans Recherche rapide et sélectionnez Gérer les applications connectées.
4. Vérifiez que Application de connexion incorporée Amazon AppFlow figure dans votre liste d’applications connectées. Une fois l’étape d’authentification terminée, cette application connectée a été automatiquement activée dans Salesforce.

Procédons à une dernière vérification :

1. Saisissez application connectée dans la zone Recherche rapide si ce n’est pas déjà fait, puis sélectionnez Utilisation d’applications connectées OAuth.
2. L’application de connexion incorporée AppFlow doit être répertoriée et Le jeton d’actualisation est valide jusqu’à sa révocation doit figurer sous Gérer les stratégies des applications. Si nécessaire, vous pouvez modifier la stratégie pour que cela soit le cas.