Automatiser la conversion d'une opportunité Salesforce en commande BigQuery

Ce tutoriel décrit un cas d'utilisation illustrant comment utiliser l'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 de l'entreprise (ERP).

Présentation

Les entreprises utilisent diverses applications de CRM et d'ERP pour créer, traiter, gérer et mettre à jour les commandes de vente. Chacune de ces applications est gérée par différentes équipes ou organisations. Il est donc difficile de s'assurer que la commande est constamment suivie tout en fournissant des informations à jour aux clients.

Dans ce tutoriel, vous allez créer une intégration qui utilise un déclencheur Salesforce pour vous abonner à un é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 du compte n'existent pas dans BigQuery, l'intégration crée automatiquement une entrée dans la table BigQuery et dans l'instance ServiceNow associée à l'aide des Integration Connectors.

Diagramme de conversion d'une opportunité Salesforce en commande BigQuery Diagramme de conversion d'une opportunité Salesforce en commande BigQuery

Objectifs

Ce tutoriel vous explique comment effectuer les tâches suivantes dans votre intégration:

  • Configurez le déclencheur Salesforce pour appeler votre intégration.
  • Ajoutez et configurez des tâches de connecteur pour les connexions Salesforce, BigQuery et ServiceNow.
  • Ajoutez et configurez des tâches de mappage des données pour extraire et mapper les informations sur les 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 du niveau Always Free gratuit 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

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the BigQuery API.

    Enable the API

  5. Create a service account:

    1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
    2. Select your project.

    3. 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.

    4. Click Create and continue.

    5. 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.

    6. Click Continue.

    7. Click Done to finish creating the service account.

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  7. Make sure that billing is enabled for your Google Cloud project.

  8. Enable the BigQuery API.

    Enable the API

  9. Create a service account:

    1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
    2. Select your project.

    3. 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.

    4. Click Create and continue.

    5. 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.

    6. Click Continue.

    7. 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 des données modifiées (CDC) est activée dans votre compte. Pour savoir comment créer un compte, consultez Configurer un utilisateur d'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 informations sur 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:

  1. Accédez à la page BigQuery de la console Google Cloud.

    Accéder à BigQuery

  2. Cliquez sur le panneau Explorer, puis sélectionnez le projet que vous utilisez pour ce tutoriel.
  3. Développez (Actions), puis sélectionnez Créer un ensemble de données.
  4. Configurez les détails suivants sur la page Créer un ensemble de données :
    1. ID de l'ensemble de données:saisissez Demo_order_dataset.
    2. Type d'emplacement > Région:sélectionnez la région us-central1 (lowa).
  5. Cliquez sur Créer un ensemble de données.

    6. Le nouveau jeu de données Demo_order_dataset devrait désormais s'afficher dans votre projet, dans le panneau Explorer.

Configurer des tables BigQuery

Pour créer les tables BigQuery, procédez comme suit:

  1. Dans le panneau Explorer, cliquez sur l'ensemble de données Demo_order_dataset créé, puis ouvrez-le.
  2. Pour créer une table Orders (Commandes) vide afin de stocker les informations sur les opportunités Salesforce, procédez comme suit :
    1. Cliquez sur  Créer une table.
    2. Dans la section Destination, saisissez Orders comme nom de la table.
    3. Dans la section Schéma, cliquez sur 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"
  }
]
    4. Cliquez sur Créer une table.
  3. Pour créer une table Accounts (Comptes) vide afin de stocker les informations du compte Salesforce, procédez comme suit :
    1. Cliquez sur  Créer une table.
    2. Dans la section Destination, saisissez Accounts comme nom de la table.
    3. Dans la section Schéma, cliquez sur 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"
  }
]
    4. Cliquez sur Créer une table.

    Les nouvelles tables Orders et Accounts devraient désormais s'afficher dans votre ensemble de données Demo_order_dataset dans le panneau Explorer.

Vérifier l'instance ServiceNow

Ce tutoriel utilise une instance de développeur personnelle (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 la PDI, consultez la documentation sur la PDI ServiceNow.

Configurer les connexions

Pour ce tutoriel, vous devez configurer les connexions suivantes dans Connecteurs d'intégration:

Connexion Salesforce
Configurez une connexion Salesforce dans les Integration Connectors. Pour en savoir plus sur la configuration d'un connecteur Salesforce, consultez Connecteur Salesforce.
Connexion BigQuery
Configurez une connexion BigQuery dans les Integration Connectors pour obtenir, mettre à jour et valider les informations sur les commandes et les comptes dans l'ensemble de données Demo_order_dataset. Pour en savoir plus sur la configuration d'un connecteur BigQuery, consultez Connecteur BigQuery.
Connexion ServiceNow
Configurez une connexion ServiceNow dans les Integration Connectors à l'aide de l'URL de votre instance pour créer et récupérer les informations de votre compte dans ServiceNow. Pour en savoir plus sur la configuration d'un connecteur ServiceNow, consultez la section Connecteur ServiceNow.

Créer une intégration

Pour créer une intégration, procédez comme suit :

  1. Dans la console Google Cloud, accédez à la page Application Integration.

    Accéder à Application Integration

  2. Dans le menu de navigation, cliquez sur Intégrations. La page Integrations s'affiche.
  3. Cliquez sur  Créer une intégration, puis fournissez les informations suivantes sur la page Créer une intégration :
    1. Nom de l'intégration:saisissez opportunity-to-order-integration.
    2. Description:saisissez Demo integration created for tutorial.
    3. Région:sélectionnez us-central1 dans la liste des régions compatibles.
    4. Cliquez sur Créer pour ouvrir l'éditeur d'intégrations.

Configurer le déclencheur d'intégration

Une fois l'intégration créée, vous pouvez ajouter et configurer un déclencheur d'intégration qui l'appelle pour un événement identifié.

Pour ce tutoriel, un déclencheur Salesforce est utilisé pour appeler l'intégration pour chaque nouvelle 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:

  1. Dans l'éditeur d'intégrations, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
  2. Cliquez sur l'élément Déclencheur Salesforce et placez-le dans l'éditeur d'intégrations.
  3. Sélectionnez l'élément Déclencheur Salesforce sur le canevas de l'éditeur pour ouvrir le volet de configuration du déclencheur Salesforce.
  4. Configurez les champs suivants sous Entrée du déclencheur :
    1. Type d'événement : sélectionnez Capture des données modifiées (CDC) dans la liste déroulante.
    2. 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 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. 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.
    3. 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 Ajouter un canal Salesforce, procédez comme suit:

      • Nom de l'objet Salesforce : saisissez Opportunity.
      • Cliquez sur Ajouter.
    4. Opération: sélectionnez Créer dans la liste déroulante.

      5. Les modifications que vous avez apportées aux propriétés sont enregistrées automatiquement.

Mappage de 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 sur un connecteur Salesforce pour récupérer 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 informations sur l'opportunité à l'aide de la connexion Salesforce, procédez comme suit:

  1. Dans l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches disponibles.
  2. Cliquez sur l'élément Connecteurs et placez-le dans l'éditeur d'intégrations.
  3. Sélectionnez l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche Connecteurs.
  4. Cliquez sur  et renommez le libellé Connecteurs en Fetch Salesforce Data.
  5. Cliquez sur Configurer le connecteur.
  6. Procédez comme suit sur la page Éditeur de tâches Connectors :
    1. Sous Sélectionner une connexion, choisissez la région us-central1.
    2. Sélectionnez votre connexion Salesforce dans la liste des connexions disponibles.
    3. Cliquez sur Suivant.
    4. Sous Type, sélectionnez Entités.
    5. Sous Définir les entités/actions, sélectionnez Opportunité dans la liste des entités disponibles, puis Obtenir comme opération.
    6. Cliquez sur Terminé pour terminer la configuration de la connexion et fermer le volet.

Extraire et mapper l'ID d'opportunité

Une tâche Mappage de données permet de mapper et d'extraire les informations sur l'opportunité entre ce déclencheur Salesforce et le connecteur Salesforce.

Pour ajouter et configurer le mappage des données dans votre intégration, procédez comme suit:

  1. Dans l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches disponibles.
  2. Cliquez sur l'élément Mappage de données et placez-le dans l'éditeur d'intégrations.
  3. Sélectionnez l'élément Mappage de données dans le concepteur pour afficher le volet de configuration de la tâche.
  4. Cliquez sur  et renommez la tâche Mappage de données en Map to opportunity ID.
  5. 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 les variables de mappage, consultez la section Ajouter un mappage.

  6. Mappez la variable de sortie du déclencheur (SalesforceTriggerCdcRecordID) à la variable d'entrée du connecteur (entityId(Fetch Salesforce Data)) générée automatiquement.

    Une fois le mappage terminé, fermez le volet. Toutes les modifications seront enregistrées automatiquement.

  7. Ajoutez une connexion de périphérie du déclencheur Salesforce à la tâche Mapper à l'ID d'opportunité.
  8. Ajoutez une connexion de périphérie de la tâche Mappeur d'ID d'opportunité au connecteur Récupérer les données Salesforce.

Valider le compte Salesforce dans une table BigQuery

Une fois que vous avez récupéré tous les détails de l'opportunité à partir du connecteur Salesforce, vous extrayez et mappez l'ID de compte associé à l'opportunité, puis validez son existence dans votre table BigQuery.

Se connecter à la table BigQuery

Pour configurer une tâche Connecteurs qui lit les tables Comptes BigQuery à l'aide de la connexion BigQuery, procédez comme suit:

  1. Dans l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches disponibles.
  2. Cliquez sur l'élément Connecteurs et placez-le dans l'éditeur d'intégrations.
  3. Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche Connecteurs.
  4. Cliquez sur et renommez les connecteurs en Check account in BigQuery.
  5. Cliquez sur Configurer le connecteur.
  6. Procédez comme suit sur la page Éditeur de tâches Connectors :
    1. Sous Sélectionner une connexion, choisissez la région us-central1.
    2. Sélectionnez votre connexion BigQuery dans la liste des connexions disponibles.
    3. Cliquez sur Suivant.
    4. Sous Type, sélectionnez Entités.
    5. Sous Définir les entités/actions, sélectionnez comptes dans la liste des entités disponibles, puis sélectionnez List (Liste) comme opération.
    6. Cliquez sur Terminé pour terminer la configuration de la connexion et fermer le volet.
  7. Ajoutez une connexion périphérique du connecteur Récupérer les données Salesforce au connecteur 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:

  1. Dans l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches disponibles.
  2. Cliquez sur l'élément Mappage de données et placez-le dans l'éditeur d'intégrations.
  3. Cliquez sur l'élément Mappage de données dans le concepteur pour afficher le volet de configuration de la tâche.
  4. Cliquez sur  et renommez la tâche Mappage de données en Check account.
  5. Cliquez sur Ouvrir l'éditeur de mappage de données.
  6. 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
  7. 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.

  8. Ajoutez une connexion de bord du 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 utiliserez également les mêmes 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 Comptes de BigQuery:

  1. Dans l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches disponibles.
  2. Cliquez sur l'élément Connecteurs et placez-le dans l'éditeur d'intégrations.
  3. Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche Connecteurs.
  4. Cliquez sur et remplacez le nom des connecteurs par Create account in BigQuery.
  5. Cliquez sur Configurer le connecteur.
  6. Procédez comme suit sur la page Éditeur de tâches Connectors :
    1. Sous Sélectionner une connexion, choisissez la région us-central1.
    2. Sélectionnez votre connexion BigQuery dans la liste des connexions disponibles.
    3. Cliquez sur Suivant.
    4. Sous Type, sélectionnez Entités.
    5. Sous Définir les entités/actions, sélectionnez comptes dans la liste des entités disponibles, puis sélectionnez Créer comme opération.
    6. Cliquez sur Terminé pour terminer la configuration de la connexion et fermer le volet.

Créer un compte ServiceNow

Pour configurer une tâche Connecteurs qui ajoute un compte à votre instance ServiceNow, procédez comme suit:

  1. Dans l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches disponibles.
  2. Cliquez sur l'élément Connecteurs et placez-le dans l'éditeur d'intégrations.
  3. Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche Connecteurs.
  4. Cliquez sur et remplacez le nom des connecteurs par Create account in ServiceNow.
  5. Cliquez sur Configurer le connecteur.
  6. Procédez comme suit sur la page Éditeur de tâches Connectors :
    1. Sous Sélectionner une connexion, choisissez la région us-central1.
    2. Sélectionnez votre connexion BigQuery dans la liste des connexions disponibles.
    3. Cliquez sur Suivant.
    4. Sous Type, sélectionnez Entités.
    5. Sous Définir les entités/actions, sélectionnez system_user dans la liste des entités disponibles, puis sélectionnez Créer comme opération.
    6. Cliquez sur Terminé pour terminer la configuration de la connexion et fermer le volet.

Transformer et mapper les informations du compte

Pour transformer les informations du compte et les mapper aux connecteurs BigQuery et ServiceNow, procédez comme suit:

  1. Dans l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches disponibles.
  2. Cliquez sur l'élément Mappage de données et placez-le dans l'éditeur d'intégrations.
  3. Cliquez sur l'élément Mappage de données dans le concepteur pour afficher le volet de configuration de la tâche.
  4. Cliquez sur  et renommez la tâche Mappage de données en Mapping for Account Creation.
  5. Cliquez sur Ouvrir l'éditeur de mappage de données.
  6. 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
  7. Créez la mise en correspondance suivante pour mapper l'ID et le nom du compte Salesforce sur 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.

  8. Ajoutez une connexion périphérique de la tâche Mappage pour la création de compte au connecteur Créer un compte dans BigQuery.
  9. Ajoutez une connexion périphérique de la tâche Mappage pour la création de compte au connecteur Créer un compte dans ServiceNow.

Créer une commande dans BigQuery

Pour générer un numéro de commande et l'ajouter dans BigQuery, procédez comme suit :

Ajouter un ordre à BigQuery

Procédez comme suit pour configurer une tâche Connecteurs qui crée une entité dans la table Orders (Commandes) de BigQuery:

  1. Dans l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches disponibles.
  2. Cliquez sur l'élément Connecteurs et placez-le dans l'éditeur d'intégrations.
  3. Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche Connecteurs.
  4. Cliquez sur et remplacez le nom des connecteurs par Create order in BigQuery.
  5. Cliquez sur Configurer le connecteur.
  6. Procédez comme suit sur la page Éditeur de tâches Connectors :
    1. Sous Sélectionner une connexion, choisissez la région us-central1.
    2. Sélectionnez votre connexion BigQuery dans la liste des connexions disponibles.
    3. Cliquez sur Suivant.
    4. Sous Type, sélectionnez Entités.
    5. Sous Définir les entités/actions, sélectionnez Commandes dans la liste des entités disponibles, puis Créer comme opération.
    6. Cliquez sur Terminé pour terminer la configuration de la connexion et fermer le volet.

Générer l'ordre et mapper vers BigQuery

  1. Dans l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches disponibles.
  2. Cliquez sur l'élément Mappage de données et placez-le dans l'éditeur d'intégrations.
  3. Cliquez sur l'élément Mappage de données dans le concepteur pour afficher le volet de configuration de la tâche.
  4. Cliquez sur  et renommez la tâche Mappage de données en Mapping for Order Creation.
  5. Cliquez sur Ouvrir l'éditeur de mappage de données.
  6. Cliquez sur + Ajouter une variable et créez la variable suivante:
    Nom de la variable Type de données
    order_number STRING
  7. Créez la mise en correspondance suivante pour générer un nouveau numéro de commande et mapper les détails de la commande sur 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.

  8. Ajoutez une connexion périphérique du connecteur Créer un compte dans BigQuery à la tâche Mappage pour la création de commandes.
  9. Ajoutez une connexion périphérique du connecteur Créer un compte dans ServiceNow à la tâche Mappage pour la création de commandes.
  10. Ajoutez une connexion de bord de la tâche Mappage pour la création d'une commande au connecteur Créer une commande dans BigQuery.

Mettre à jour une opportunité Salesforce

Une fois le nouveau numéro de commande généré, vous mettez à jour l'opportunité Salesforce source.

Configurer le connecteur Salesforce

Pour configurer une tâche Connectors qui met à jour l'opportunité Salesforce existante, procédez comme suit:

  1. Dans l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches disponibles.
  2. Cliquez sur l'élément Connecteurs et placez-le dans l'éditeur d'intégrations.
  3. Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour afficher le volet de configuration de la tâche Connecteurs.
  4. Cliquez sur et remplacez le nom des connecteurs par Update Salesforce.
  5. Cliquez sur Configurer le connecteur.
  6. Procédez comme suit sur la page Éditeur de tâches Connectors :
    1. Sous Sélectionner une connexion, choisissez la région us-central1.
    2. Sélectionnez votre connexion Salesforce dans la liste des connexions disponibles.
    3. Cliquez sur Suivant.
    4. Sous Type, sélectionnez Entités.
    5. Sous Définir les entités/actions, sélectionnez Opportunité dans la liste des entités disponibles, puis Mettre à jour comme Opération.
    6. Cliquez sur Terminé pour terminer la configuration de la connexion et fermer le volet.

Mappage du numéro de commande dans Salesforce

  1. Dans l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches disponibles.
  2. Cliquez sur l'élément Mappage de données et placez-le dans l'éditeur d'intégrations.
  3. Cliquez sur l'élément Mappage de données dans le concepteur pour afficher le volet de configuration de la tâche.
  4. Cliquez sur  et renommez la tâche Mappage de données en Mapping to update opportunity.
  5. Cliquez sur Ouvrir l'éditeur de mappage de données.
  6. 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.

  7. Ajoutez une connexion de bord du connecteur Créer une commande dans BigQuery à la tâche Mappage pour mettre à jour l'opportunité.
  8. Ajoutez une connexion de périphérie de la tâche Mappage pour mettre à jour l'opportunité au connecteur Mettre à jour Salesforce.

Ajouter une condition de périphérie

Une condition de périphérie vous permet de spécifier les conditions à remplir pour que le contrôle d'une intégration soit transmis à la tâche connectée par la périphérie. Maintenant que vous avez ajouté et configuré les tâches requises, vous pouvez ajouter une condition de bord pour définir le flux de l'intégration.

La condition de bord suivante contrôle le flux de l'intégration en fonction de la validation des informations du compte:

  1. Ajoutez une connexion périphérique de la tâche Vérifier le compte à la tâche Mappage pour la création de compte avec la condition périphérique suivante: 
      $account_exists$ = False
  2. Ajoutez une autre connexion périphérique de la tâche Vérifier le compte à la tâche Mappage pour la création de commandes avec la condition périphérique suivante: 
      $account_exists$ = True

Exemple de flux d'intégration

La figure suivante présente un exemple de mise en page de l'intégration créée à l'aide de ce tutoriel.

Exemple d'image montrant le flux d'intégration Exemple d'image montrant le flux d'intégration

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 image montrant l'icône des journaux d'exécutionAfficher les journaux d'exécution pour cette intégration. La page Journaux d'exécution s'affiche.

Cas de test 1: Vérifier si un numéro de commande est 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 :

  1. Accédez à la page BigQuery.

    Accéder à BigQuery

    • Ouvrez le tableau Comptes et vérifiez que l'ID du nouveau compte d'opportunité a bien été inséré.
    • Ouvrez le tableau Orders (Commandes) et vérifiez que les nouveaux détails de la commande ont été insérés.
  2. Accédez à votre instance ServiceNow.
    • Vérifiez si un nouveau compte est ajouté à votre instance contenant le même ID de compte d'opportunité Salesforce.
  3. Ouvrez Salesforce.
    • Vérifiez si l'opportunité est mise à jour avec le nouveau numéro de commande.

Cas de test 2: Vérifier si un numéro de commande est 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 figure également dans votre table BigQuery.

Pour vérifier si votre intégration a réussi, procédez comme suit :

  1. Accédez à la page BigQuery.

    Accéder à BigQuery

    • Ouvrez le tableau Comptes et vérifiez qu'aucun nouvel ID de compte n'est inséré.
    • Ouvrez le tableau Orders (Commandes) et vérifiez que les nouveaux détails de la commande ont été insérés.
  2. Ouvrez Salesforce.
    • Vérifiez si l'opportunité est 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 les 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 la section Supprimer des intégrations.
  • Pour savoir comment supprimer une connexion, consultez la section Gérer les connecteurs.