Ce tutoriel décrit un cas d'utilisation expliquant comment utiliser Application Integration pour automatiser un flux de gestion des commandes entre une application de gestion de la relation client (CRM) et une application de planification des ressources d'entreprise (ERP).
Présentation
Les entreprises utilisent diverses applications CRM et ERP pour créer, traiter, gérer et maintenir les commandes client. Chacune de ces applications est gérée par différentes équipes ou organisations, et s'assurer que la commande est constamment suivie tout en fournissant des informations rapides aux clients est un défi.
Dans ce tutoriel, vous allez créer une intégration qui utilise un déclencheur Salesforce pour s'abonner à un nouvel événement d'opportunité dans Salesforce. Lorsqu'une opportunité est créée, l'intégration récupère des informations supplémentaires sur l'opportunité, telles que l'ID et le nom du compte. Ces informations sont vérifiées dans une table BigQuery pour créer et mettre à jour l'opportunité avec un numéro de commande de suivi. Lors de la validation, si les informations de compte n'existent pas dans BigQuery, l'intégration crée automatiquement une entrée dans la table BigQuery et l'instance ServiceNow associée à l'aide de Integration Connectors.
Objectifs
Ce tutoriel vous explique comment effectuer les tâches suivantes dans votre intégration:
- Configurez un déclencheur Salesforce pour appeler votre intégration.
- Ajoutez et configurez des tâches de connecteurs pour les connexions Salesforce, BigQuery et ServiceNow.
- Ajoutez et configurez des tâches de mappage de données pour extraire et mapper les détails des opportunités.
Coûts
Dans ce tutoriel, vous utilisez les composants facturables suivants de Google Cloud:
Les instructions de ce tutoriel sont conçues pour que votre utilisation des ressources respecte les limites définies pour la Always Free gratuite de Google Cloud.
Une fois que vous avez terminé les tâches décrites dans ce document, vous pouvez éviter de continuer à payer des frais en supprimant les ressources que vous avez créées. Pour en savoir plus, consultez la section Effectuer un nettoyage.
Avant de commencer
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
Activez l'API BigQuery
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the following roles to the service account: BigQuery Data Editor (
roles/bigquery.dataEditor
), BigQuery Read Session User (roles/bigquery.readSessionUser
), Secret Manager Viewer (roles/secretmanager.viewer
), Secret Manager Secret Accessor (roles/secretmanager
).To grant a role, find the Select a role list, then select the role.
To grant additional roles, click
Add another role and add each additional role. - Click Continue.
-
Click Done to finish creating the service account.
-
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Vérifiez que la facturation est activée pour votre projet Google Cloud.
-
Activez l'API BigQuery
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the following roles to the service account: BigQuery Data Editor (
roles/bigquery.dataEditor
), BigQuery Read Session User (roles/bigquery.readSessionUser
), Secret Manager Viewer (roles/secretmanager.viewer
), Secret Manager Secret Accessor (roles/secretmanager
).To grant a role, find the Select a role list, then select the role.
To grant additional roles, click
Add another role and add each additional role. - Click Continue.
-
Click Done to finish creating the service account.
-
Préparer votre environnement
Vérifier la configuration des utilisateurs Salesforce
Dans ce tutoriel, nous partons du principe que vous disposez déjà d'un compte de développeur Salesforce avec les paramètres d'autorisation et de configuration utilisateur requis. Vérifiez que la capture de données modifiées (CDC) est activée sur votre compte. Pour en savoir plus sur la création d'un compte, consultez Configurer un utilisateur de l'intégration.
Configurer un ensemble de données et une table BigQuery
Pour ce tutoriel, vous devez configurer un ensemble de données BigQuery et créer deux tables pour stocker les détails de l'opportunité Salesforce et les informations du compte ServiceNow.
Configurer un ensemble de données BigQuery
Pour configurer l'ensemble de données BigQuery, procédez comme suit:
- Accédez à la page BigQuery de la console Google Cloud.
- Cliquez sur le panneau Explorateur, puis sélectionnez le projet que vous utilisez pour ce tutoriel.
- Développez (Actions), puis sélectionnez Créer un ensemble de données.
- Configurez les informations suivantes sur la page Créer un ensemble de données :
- ID de l'ensemble de données:saisissez
Demo_order_dataset
. - Type d'emplacement > Région:sélectionnez la région
us-central1 (lowa)
.
- ID de l'ensemble de données:saisissez
- Cliquez sur Créer un ensemble de données.
Le nouvel ensemble de données Demo_order_dataset
devrait maintenant apparaître dans le panneau Explorateur de votre projet.
Configurer des tables BigQuery
Pour créer les tables BigQuery, procédez comme suit:
- Dans le panneau Explorateur, cliquez sur l'ensemble de données
Demo_order_dataset
que vous avez créé et ouvrez-le. - Procédez comme suit pour créer une table Orders vide afin de stocker les détails de l'opportunité Salesforce :
- Cliquez sur Créer une table.
- Dans la section Destination, saisissez
Orders
comme nom de table. - Dans la section Schema (Schéma), cliquez sur Edit as text (Modifier sous forme de texte) et collez la définition de schéma JSON suivante:
[ { "name": "order_number", "type": "STRING", "mode": "NULLABLE", "description": "Salesforce order number" }, { "name": "order_status", "type": "STRING", "mode": "NULLABLE", "description": "Sale order status" }, { "name": "tracking_number", "type": "INTEGER", "mode": "NULLABLE", "description": "Salesforce tracking number" } ]
- Cliquez sur Créer la table.
- Pour créer une table Accounts vide dans laquelle stocker les détails du compte Salesforce, procédez comme suit :
- Cliquez sur Créer une table.
- Dans la section Destination, saisissez
Accounts
comme nom de table. - Dans la section Schema (Schéma), cliquez sur Edit as text (Modifier sous forme de texte) et collez la définition de schéma JSON suivante:
[ { "name": "account_id", "type": "STRING", "mode": "NULLABLE", "description": "Account ID for the opportunity" }, { "name": "name", "type": "STRING", "mode": "NULLABLE", "description": "Account name for the opportunity" } ]
- Cliquez sur Créer la table.
Les nouvelles tables
Orders
etAccounts
devraient maintenant apparaître dans l'ensemble de données Demo_order_dataset du panneau Explorateur.
Vérifier l'instance ServiceNow
Ce tutoriel utilise une instance de développeur personnel (PDI) gratuite ServiceNow. Vous pouvez utiliser votre instance ServiceNow existante ou en créer une. Vérifiez que votre instance est active et notez son URL. Pour en savoir plus sur les PDI, consultez la documentation sur les PDI de ServiceNow.
Configurer les connexions
Pour ce tutoriel, vous devez configurer les connexions suivantes dans Integration Connectors:
- Connexion à Salesforce
- Configurez une connexion Salesforce dans Integration Connectors. Pour en savoir plus sur la configuration d'un connecteur Salesforce, consultez l'article Connecteur Salesforce.
- Connexion à BigQuery
- Configurez une connexion BigQuery dans Integration Connectors pour obtenir, mettre à jour et valider les détails des commandes et des comptes dans l'ensemble de données Demo_order_dataset. Pour en savoir plus sur la configuration d'un connecteur BigQuery, consultez l'article Connecteur BigQuery.
- Connexion ServiceNow
- Configurez une connexion ServiceNow dans Integration Connectors à l'aide de l'URL de votre instance pour créer et récupérer les détails du compte dans ServiceNow. Pour en savoir plus sur la configuration d'un connecteur ServiceNow, consultez l'article Connecteur ServiceNow.
Créer une intégration
Pour créer une intégration, procédez comme suit :
- Dans la console Google Cloud, accédez à la page Application Integration.
- Dans le menu de navigation, cliquez sur Integrations (Intégrations). La page Liste des intégrations s'affiche.
- Cliquez sur
- Integration name (Nom de l'intégration) : saisissez
opportunity-to-order-integration
. - Description:saisissez
Demo integration created for tutorial
. - Région:sélectionnez
us-central1
dans la liste des régions disponibles. - Cliquez sur Créer pour ouvrir l'éditeur d'intégration.
Créer une intégration et fournissez les informations suivantes sur la page Créer une intégration :
- Integration name (Nom de l'intégration) : saisissez
Configurer un déclencheur d'intégration
Une fois votre intégration créée, vous pouvez ajouter et configurer un déclencheur d'intégration qui appelle l'intégration pour un événement identifié.
Dans ce tutoriel, un déclencheur Salesforce est utilisé afin d'appeler l'intégration pour chaque opportunité créée dans l'instance Salesforce. Pour ajouter et configurer un déclencheur Salesforce dans votre intégration opportunity-to-order-integration
, procédez comme suit:
- Dans l'éditeur d'intégrations, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
- Cliquez sur l'élément Déclencheur Salesforce et placez-le dans l'éditeur d'intégrations.
- Sélectionnez l'élément Déclencheur Salesforce dans le canevas du concepteur pour ouvrir le volet de configuration du déclencheur Salesforce.
- Configurez les champs suivants sous Entrée du déclencheur :
- Type d'événement : sélectionnez Capture des données modifiées (CDC) dans la liste déroulante.
- Configuration de l'instance Salesforce : cliquez sur l'option + Ajouter une configuration d'instance Salesforce dans la liste déroulante.
Dans la boîte de dialogue Add Salesforce instance configuration (Ajouter une configuration d'instance Salesforce), procédez comme suit:
- Nom de connexion de l'instance Salesforce : saisissez un nom de connexion pour l'instance Salesforce. Par exemple,
test
. - Domaine Salesforce : saisissez le nom de votre domaine Salesforce. Vous trouverez ces informations sur la page Compte Salesforce > Afficher le profil.
- Profil d'authentification : sélectionnez un profil d'authentification. Si vous ne possédez pas de profil d'authentification, créez-en un. Pour en savoir plus, consultez la page Créer un profil d'authentification.
- Cliquez sur Ajouter.
- Nom de connexion de l'instance Salesforce : saisissez un nom de connexion pour l'instance Salesforce. Par exemple,
- Configuration du canal Salesforce : cliquez sur l'option + Ajouter une configuration de canal Salesforce dans la liste déroulante.
Dans la boîte de dialogue Add Salesforce channel (Ajouter un canal Salesforce), procédez comme suit:
- Nom de l'objet Salesforce : saisissez
Opportunity
. - Cliquez sur Ajouter.
- Nom de l'objet Salesforce : saisissez
- Opération: sélectionnez Créer dans la liste déroulante.
Les modifications que vous avez apportées aux propriétés sont enregistrées automatiquement.
Mapper la charge utile du déclencheur sur le connecteur Salesforce
Lorsque l'intégration est appelée à l'aide du déclencheur Salesforce, vous extrayez l'ID de l'opportunité et le mappez à un connecteur Salesforce afin d'obtenir des informations supplémentaires sur l'opportunité.
Se connecter au compte Salesforce
Pour ajouter et configurer une tâche Connecteurs afin de récupérer les détails de l'opportunité à l'aide de la connexion Salesforce, procédez comme suit:
- Dans l'éditeur d'intégrations, cliquez sur Tasks (Tâches) pour afficher la liste des tâches disponibles.
- Cliquez sur l'élément Connecteurs et placez-le dans l'éditeur d'intégrations.
- Sélectionnez l'élément de tâche Connecteurs sur le concepteur pour afficher le volet de configuration de la tâche Connecteurs.
- Cliquez sur
Fetch Salesforce Data
.
, puis remplacez le nom du libellé Connecteurs par - Cliquez sur Configurer le connecteur.
- Procédez comme suit sur la page Éditeur de tâches de connecteurs :
- Sous Sélectionner une connexion, choisissez la région
us-central1
. - Sélectionnez votre connexion Salesforce dans la liste des connexions disponibles.
- Cliquez sur Suivant.
- Sous Type, sélectionnez Entités.
- Sous Définir les entités/actions, sélectionnez Opportunité dans la liste des entités disponibles, puis sélectionnez Obtenir pour Opération.
- Cliquez sur Terminé pour terminer la configuration de la connexion et fermer le volet.
- Sous Sélectionner une connexion, choisissez la région
Extraire et mapper l'ID d'opportunité
Une tâche de mappage de données permet de mapper et d'extraire les détails des opportunités entre ce déclencheur Salesforce et le connecteur Salesforce.
Pour ajouter et configurer le mappage de données dans votre intégration, procédez comme suit:
- Dans l'éditeur d'intégrations, cliquez sur Tasks (Tâches) pour afficher la liste des tâches disponibles.
- Cliquez sur l'élément Mappage de données et placez-le dans l'éditeur d'intégrations.
- Sélectionnez l'élément Mappage de données dans le concepteur pour afficher le volet de configuration des tâches.
- Cliquez sur
Map to opportunity ID
.
et renommez la tâche Mappage de données - Cliquez sur Ouvrir l'éditeur de mappage de données.
L'éditeur de mappage de données vous permet de mapper les variables d'entrée avec les variables de sortie souhaitées à l'aide des fonctions de transformation disponibles. Le résultat est ensuite disponible en tant que variable pour toute autre tâche ou tout autre déclencheur d'intégration. Pour en savoir plus sur le mappage des variables, consultez Ajouter un mappage.
- Mappez la variable de sortie du déclencheur (
SalesforceTriggerCdcRecordID
) avec la variable d'entrée du connecteur généré automatiquement (entityId(Fetch Salesforce Data)
).Une fois le mappage terminé, fermez le volet. Toutes les modifications seront enregistrées automatiquement.
- Ajoutez une connexion en périphérie à partir du déclencheur Salesforce vers la tâche Mapper sur l'ID d'opportunité.
- Ajoutez une connexion en périphérie au connecteur Extraire les données Salesforce de la tâche Mapper avec l'ID de l'opportunité.
Valider le compte Salesforce dans la table BigQuery
Une fois que vous avez récupéré toutes les informations sur l'opportunité à partir du connecteur Salesforce, vous devez extraire et mapper l'ID de compte associé à l'opportunité, puis valider son existence dans votre table BigQuery.
Se connecter à la table BigQuery
Procédez comme suit pour configurer une tâche Connecteurs qui lit les tables Accounts BigQuery à l'aide de la connexion BigQuery:
- Dans l'éditeur d'intégrations, cliquez sur Tasks (Tâches) pour afficher la liste des tâches disponibles.
- Cliquez sur l'élément Connecteurs et placez-le dans l'éditeur d'intégrations.
- Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche Connecteurs.
- Cliquez sur
Check account in BigQuery
.
, puis renommez les connecteurs - Cliquez sur Configurer le connecteur.
- Procédez comme suit sur la page Éditeur de tâches de connecteurs :
- Sous Sélectionner une connexion, choisissez la région
us-central1
. - Sélectionnez votre connexion BigQuery dans la liste des connexions disponibles.
- Cliquez sur Suivant.
- Sous Type, sélectionnez Entités.
- Sous Définir les entités/actions, sélectionnez comptes dans la liste des entités disponibles, puis sélectionnez Liste pour Opération.
- Cliquez sur Terminé pour terminer la configuration de la connexion et fermer le volet.
- Sous Sélectionner une connexion, choisissez la région
- Ajoutez une connexion en périphérie depuis le connecteur Fetch Salesforce Data au connecteur Check account in BigQuery (Vérifier le compte dans BigQuery).
Extraire et valider l'ID de compte Salesforce
Pour extraire, mapper et valider l'ID de compte de l'opportunité, procédez comme suit:
- Dans l'éditeur d'intégrations, cliquez sur Tasks (Tâches) pour afficher la liste des tâches disponibles.
- Cliquez sur l'élément Mappage de données et placez-le dans l'éditeur d'intégrations.
- Cliquez sur l'élément Mappage de données dans le concepteur pour afficher le volet de configuration des tâches.
- Cliquez sur
Check account
.
et renommez la tâche Mappage de données - Cliquez sur Ouvrir l'éditeur de mappage de données.
- Cliquez sur + Ajouter une variable et créez les variables de sortie suivantes :
Nom des variables de sortie Type de données sf_account_id
STRING
sf_account_name
STRING
account_exists
BOOLEAN
- Créez le mappage suivant entre la variable de charge utile du connecteur Salesforce et la variable locale:
Entrée Sortie connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("AccountId")
sf_account_id
connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("Name")
sf_account_name
connectorOutputPayload (Check account in BigQuery) .FILTER(~obj1 -> ~obj1 .GET_PROPERTY("account_id") .TO_STRING() .EQUALS(sf_account_id) ) .SIZE() .EQUALS("1")
account_exists
Une fois le mappage terminé, fermez le volet. Toutes les modifications seront enregistrées automatiquement.
- Ajoutez une connexion périphérique depuis le connecteur Vérifier le compte dans BigQuery à la tâche Vérifier le compte.
Créer un compte BigQuery
Une fois que vous avez validé le compte Salesforce dans BigQuery, et si le compte n'existe pas, procédez comme suit pour en créer un dans BigQuery. Vous pouvez également utiliser ces informations pour créer un compte dans ServiceNow.
Ajouter un compte à BigQuery
Procédez comme suit pour configurer une tâche Connecteurs qui crée une entité dans la table Accounts de BigQuery:
- Dans l'éditeur d'intégrations, cliquez sur Tasks (Tâches) pour afficher la liste des tâches disponibles.
- Cliquez sur l'élément Connecteurs et placez-le dans l'éditeur d'intégrations.
- Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche Connecteurs.
- Cliquez sur
Create account in BigQuery
.
, puis renommez les connecteurs - Cliquez sur Configurer le connecteur.
- Procédez comme suit sur la page Éditeur de tâches de connecteurs :
- Sous Sélectionner une connexion, choisissez la région
us-central1
. - Sélectionnez votre connexion BigQuery dans la liste des connexions disponibles.
- Cliquez sur Suivant.
- Sous Type, sélectionnez Entités.
- Sous Définir les entités/actions, sélectionnez comptes dans la liste des entités disponibles, puis sélectionnez Créer pour Opération.
- Cliquez sur Terminé pour terminer la configuration de la connexion et fermer le volet.
- Sous Sélectionner une connexion, choisissez la région
Créer un compte ServiceNow
Procédez comme suit pour configurer une tâche Connecteurs qui ajoute un nouveau compte à votre instance ServiceNow:
- Dans l'éditeur d'intégrations, cliquez sur Tasks (Tâches) pour afficher la liste des tâches disponibles.
- Cliquez sur l'élément Connecteurs et placez-le dans l'éditeur d'intégrations.
- Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche Connecteurs.
- Cliquez sur
Create account in ServiceNow
.
, puis renommez les connecteurs - Cliquez sur Configurer le connecteur.
- Procédez comme suit sur la page Éditeur de tâches de connecteurs :
- Sous Sélectionner une connexion, choisissez la région
us-central1
. - Sélectionnez votre connexion BigQuery dans la liste des connexions disponibles.
- Cliquez sur Suivant.
- Sous Type, sélectionnez Entités.
- Sous Définir les entités/actions, sélectionnez system_user dans la liste des entités disponibles, puis sélectionnez Créer pour Opération.
- Cliquez sur Terminé pour terminer la configuration de la connexion et fermer le volet.
- Sous Sélectionner une connexion, choisissez la région
Transformer et mapper les détails du compte
Pour transformer les détails du compte et les mapper aux connecteurs BigQuery et ServiceNow, procédez comme suit:
- Dans l'éditeur d'intégrations, cliquez sur Tasks (Tâches) pour afficher la liste des tâches disponibles.
- Cliquez sur l'élément Mappage de données et placez-le dans l'éditeur d'intégrations.
- Cliquez sur l'élément Mappage de données dans le concepteur pour afficher le volet de configuration des tâches.
- Cliquez sur
Mapping for Account Creation
.
et renommez la tâche Mappage de données - Cliquez sur Ouvrir l'éditeur de mappage de données.
- Cliquez sur + Ajouter une variable et créez les variables d'entrée suivantes:
Nom de la variable d'entrée Type de données new_BQaccount
JSON
new_SNaccount
JSON
- Créez le mappage suivant pour mapper l'ID et le nom du compte Salesforce avec la table BigQuery:
Entrée Sortie new_BQaccount .SET_PROPERTY( sf_account_id, "account_id" ) .SET_PROPERTY( sf_account_name, "name" )
connectorInputPayload (Create account in BigQuery)
new_SNaccount .SET_PROPERTY( sf_account_id, "sys_id" ) .SET_PROPERTY( sf_account_name, "first_name" )
connectorInputPayload (Create account in ServiceNow)
Une fois le mappage terminé, fermez le volet. Toutes les modifications seront enregistrées automatiquement.
- Ajoutez une connexion en périphérie en passant de la tâche Mappage pour la création de compte au connecteur Créer un compte dans BigQuery.
- Ajoutez une connexion en périphérie depuis la tâche Mappage pour la création de compte vers le connecteur Créer un compte dans ServiceNow.
Créer une commande dans BigQuery
Procédez comme suit pour générer un numéro de commande et l'ajouter dans BigQuery.
Ajouter une commande à BigQuery
Procédez comme suit pour configurer une tâche Connecteurs qui crée une entité dans la table Orders de BigQuery:
- Dans l'éditeur d'intégrations, cliquez sur Tasks (Tâches) pour afficher la liste des tâches disponibles.
- Cliquez sur l'élément Connecteurs et placez-le dans l'éditeur d'intégrations.
- Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche Connecteurs.
- Cliquez sur
Create order in BigQuery
.
, puis renommez les connecteurs - Cliquez sur Configurer le connecteur.
- Procédez comme suit sur la page Éditeur de tâches de connecteurs :
- Sous Sélectionner une connexion, choisissez la région
us-central1
. - Sélectionnez votre connexion BigQuery dans la liste des connexions disponibles.
- Cliquez sur Suivant.
- Sous Type, sélectionnez Entités.
- Sous Définir les entités/actions, sélectionnez Commandes dans la liste des entités disponibles, puis sélectionnez Créer pour Opération.
- Cliquez sur Terminé pour terminer la configuration de la connexion et fermer le volet.
- Sous Sélectionner une connexion, choisissez la région
Générer une commande et la mapper à BigQuery
- Dans l'éditeur d'intégrations, cliquez sur Tasks (Tâches) pour afficher la liste des tâches disponibles.
- Cliquez sur l'élément Mappage de données et placez-le dans l'éditeur d'intégrations.
- Cliquez sur l'élément Mappage de données dans le concepteur pour afficher le volet de configuration des tâches.
- Cliquez sur
Mapping for Order Creation
.
et renommez la tâche Mappage de données - Cliquez sur Ouvrir l'éditeur de mappage de données.
- Cliquez sur + Ajouter une variable et créez la variable suivante:
Nom de la variable Type de données order_number
STRING
- Créez le mappage suivant pour générer un nouveau numéro de commande et mapper les détails de la commande avec le connecteur BigQuery:
Entrée Sortie GENERATE_UUID() .SPLIT("-") .GET("0")
new_order_number
"{}" .TO_JSON() .SET_PROPERTY( connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("DeliveryInstallationStatus__c") , "order_status" ) .SET_PROPERTY( connectorOutputPayload ( Fetch Salesforce Data) .GET_PROPERTY("TrackingNumber__c") , "tracking_number" ) .SET_PROPERTY( new_order_number , "order_number" )
connectorInputPayload (Create Order in BigQuery)
Une fois le mappage terminé, fermez le volet. Toutes les modifications seront enregistrées automatiquement.
- Ajoutez une connexion périphérique depuis le connecteur Créer un compte dans BigQuery à la tâche Mappage pour la création de commandes.
- Ajoutez une connexion en périphérie à partir du connecteur Créer un compte dans ServiceNow à la tâche Mappage pour la création de commandes.
- Ajoutez une connexion périphérique depuis la tâche Mappage pour la création de commandes dans le connecteur Créer une commande dans BigQuery.
Mettre à jour l'opportunité Salesforce
Après avoir généré le nouveau numéro de commande, vous mettez à jour l'opportunité Salesforce source.
Configurer le connecteur Salesforce
Procédez comme suit pour configurer une tâche Connecteurs qui met à jour l'opportunité Salesforce existante:
- Dans l'éditeur d'intégrations, cliquez sur Tasks (Tâches) pour afficher la liste des tâches disponibles.
- Cliquez sur l'élément Connecteurs et placez-le dans l'éditeur d'intégrations.
- Cliquez sur l'élément de tâche Connecteurs sur le concepteur pour afficher le volet de configuration de la tâche Connecteurs.
- Cliquez sur
Update Salesforce
.
, puis renommez les connecteurs - Cliquez sur Configurer le connecteur.
- Procédez comme suit sur la page Éditeur de tâches de connecteurs :
- Sous Sélectionner une connexion, choisissez la région
us-central1
. - Sélectionnez votre connexion Salesforce dans la liste des connexions disponibles.
- Cliquez sur Suivant.
- Sous Type, sélectionnez Entités.
- Sous Définir les entités/actions, sélectionnez Opportunité dans la liste des entités disponibles, puis sélectionnez Mettre à jour pour Opération.
- Cliquez sur Terminé pour terminer la configuration de la connexion et fermer le volet.
- Sous Sélectionner une connexion, choisissez la région
Mapper le numéro de commande avec Salesforce
- Dans l'éditeur d'intégrations, cliquez sur Tasks (Tâches) pour afficher la liste des tâches disponibles.
- Cliquez sur l'élément Mappage de données et placez-le dans l'éditeur d'intégrations.
- Cliquez sur l'élément Mappage de données dans le concepteur pour afficher le volet de configuration des tâches.
- Cliquez sur
Mapping to update opportunity
.
et renommez la tâche Mappage de données - Cliquez sur Ouvrir l'éditeur de mappage de données.
- Créez le mappage suivant pour mettre à jour l'opportunité Salesforce:
Entrée Sortie "{}" .TO_JSON() .SET_PROPERTY( new_order_number , "OrderNumber__c" )
connectorInputPayload (Update Salesforce)
entityId ( Fetch Salesforce Data)
entityId (Update Salesforce )
"'" .CONCAT(entityId ( Fetch Salesforce Data)) .CONCAT("'")
filterClause (Update Salesforce )
Une fois le mappage terminé, fermez le volet. Toutes les modifications seront enregistrées automatiquement.
- Ajoutez une connexion en périphérie à partir du connecteur Créer une commande dans BigQuery à la tâche Mappage pour mettre à jour l'opportunité.
- Ajoutez une connexion en périphérie au connecteur Update Salesforce depuis la tâche Mappage pour mettre à jour l'opportunité.
Ajouter une condition de périphérie
Une condition de périphérie vous permet de spécifier les conditions devant être remplies pour que le contrôle d'une intégration soit transmis à la tâche connectée par le périphérique. Maintenant que vous avez ajouté et configuré les tâches requises, vous pouvez ajouter une condition Edge pour définir le flux de l'intégration.
La condition périphérique suivante contrôle le flux de l'intégration en fonction de la validation des informations du compte:
- Ajoutez une connexion périphérique depuis la tâche Vérifier le compte à la tâche Mappage pour la création de compte avec la condition de périphérie suivante:
$account_exists$ = False
- Ajoutez une autre connexion de périphérie depuis la tâche Vérifier le compte à la tâche Mapping for Order Creation (Mappage pour la création de commandes) avec la condition de périphérie suivante:
$account_exists$ = True
Exemple de flux d'intégration
La figure suivante montre un exemple de mise en page de l'intégration créée à l'aide de ce tutoriel.
Publier et tester l'intégration
Pour publier l'intégration, cliquez sur Publier dans la barre d'outils de l'éditeur d'intégrations.
Une fois l'intégration publiée, vous pouvez afficher et inspecter les journaux d'exécution qui s'y rapportent. Pour afficher les journaux, cliquez sur Afficher les journaux d'exécution pour cette intégration. La page Journaux d'exécution s'affiche.
Scénario de test 1: Vérifier si un numéro de commande a été créé pour un nouvel ID de compte
Testez l'intégration en vous connectant à l'instance Salesforce et en créant une opportunité. Vous devez créer l'opportunité dans un nouveau compte ou dans un compte qui n'existe pas dans votre table BigQuery.
Pour vérifier si votre intégration a réussi, procédez comme suit :
- Accédez à la page BigQuery.
- Ouvrez le tableau Accounts et vérifiez que le nouvel ID de compte d'opportunité a été inséré.
- Ouvrez le tableau Campagnes et vérifiez que les détails de la nouvelle campagne ont bien été insérés.
- Accédez à votre instance ServiceNow.
- Cochez cette case pour confirmer qu'un nouveau compte contenant le même ID de compte d'opportunité Salesforce a été ajouté à votre instance.
- Ouvrez Salesforce.
- Vérifiez si l'opportunité a été mise à jour avec le nouveau numéro de commande.
Scénario de test 2: Vérifier si un numéro de commande a été créé pour un ID de compte existant dans BigQuery
Testez l'intégration en vous connectant à l'instance Salesforce et en créant une opportunité. Vous devez créer l'opportunité dans un compte existant qui existe également dans votre table BigQuery.
Pour vérifier si votre intégration a réussi, procédez comme suit :
- Accédez à la page BigQuery.
- Ouvrez le tableau Accounts et vérifiez qu'AUCUN nouvel ID de compte n'est inséré.
- Ouvrez le tableau Campagnes et vérifiez que les détails de la nouvelle campagne ont bien été insérés.
- Ouvrez Salesforce.
- Vérifiez si l'opportunité a été mise à jour avec le nouveau numéro de commande.
Effectuer un nettoyage
Pour éviter que les ressources utilisées dans ce tutoriel soient facturées sur votre compte Google Cloud, annulez la publication de l'intégration et supprimez les connexions créées dans Integration Connectors.
- Pour annuler la publication de cette intégration, cliquez sur Annuler la publication dans la barre d'outils de l'éditeur d'intégrations. Pour en savoir plus, consultez Supprimer des intégrations.
- Pour savoir comment supprimer une connexion, consultez Gérer les connecteurs.