Automatizza le opportunità di Salesforce in base all'ordine BigQuery

Questo tutorial descrive un caso d'uso su come utilizzare Application Integration per automatizzare un flusso di gestione degli ordini tra un'applicazione di gestione dei rapporti con i clienti (CRM) e un'applicazione di pianificazione delle risorse aziendali (ERP).

Panoramica

Le aziende utilizzano varie applicazioni CRM ed ERP per creare, elaborare, gestire e mantenere gli ordini di vendita. Ognuna di queste applicazioni viene gestita da organizzazioni o team diversi e il problema è garantire che l'ordine venga monitorato costantemente, fornendo al contempo aggiornamenti tempestivi ai clienti.

In questo tutorial imparerai a creare un'integrazione che utilizza un attivatore Salesforce per effettuare l'iscrizione a un nuovo evento di opportunità in Salesforce. Quando viene creata una nuova opportunità, l'integrazione recupererà ulteriori dettagli sull'opportunità, come l'ID account e il nome. Questi dettagli vengono controllati in una tabella BigQuery per creare e aggiornare l'opportunità con un numero di ordine di monitoraggio. Durante la convalida, se i dati dell'account non esistono in BigQuery, l'integrazione creerà automaticamente una nuova voce sia nella tabella BigQuery sia nell'istanza ServiceNow collegata utilizzando Integration Connectors.

Diagramma dell'ordine delle opportunità di Salesforce in BigQuery Diagramma dell'opportunità Salesforce all'ordine BigQuery

Obiettivi

Questo tutorial mostra come completare le attività seguenti nell'integrazione:

  • Configura il trigger Salesforce per richiamare l'integrazione.
  • Aggiungi e configura le attività dei connettori per le connessioni a Salesforce, BigQuery e ServiceNow.
  • Aggiungi e configura attività di mappatura dei dati per estrarre e mappare i dettagli delle opportunità.

Costi

In questo tutorial utilizzi i seguenti componenti fatturabili di Google Cloud:

Le istruzioni di questo tutorial sono progettate per mantenere l'utilizzo delle risorse entro i limiti del livello Always Free di Google Cloud.

Al termine delle attività descritte in questo documento, puoi evitare la fatturazione continua eliminando le risorse che hai creato. Per ulteriori informazioni, consulta la sezione Pulizia.

Prima di iniziare

  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.

prepara l'ambiente

Verificare la configurazione utente Salesforce

Questo tutorial presuppone che tu abbia un account sviluppatore Salesforce esistente con la configurazione utente e il set di autorizzazioni richiesti. Verifica che nel tuo account sia attivata l'opzione Change Data Capture (CDC). Per informazioni su come creare un nuovo account, vedi Configurare un utente di integrazione.

configura il set di dati e la tabella BigQuery

Per questo tutorial, devi configurare un set di dati BigQuery e creare due tabelle per archiviare i dettagli delle opportunità Salesforce e i dati dell'account ServiceNow.

Configura il set di dati BigQuery

Per configurare il set di dati BigQuery, segui questi passaggi:

  1. Vai alla pagina BigQuery nella console Google Cloud.

    Vai a BigQuery

  2. Fai clic sul riquadro di esplorazione e seleziona il progetto che stai utilizzando per questo tutorial.
  3. Espandi (Azioni) e seleziona Crea set di dati.
  4. Configura i seguenti dettagli nella pagina Crea set di dati:
    1. ID set di dati: inserisci Demo_order_dataset.
    2. Tipo di località > Regione: scegli la regione us-central1 (lowa).
  5. Fai clic su Crea set di dati.

    6. Il nuovo set di dati Demo_order_dataset dovrebbe essere visualizzato nel tuo progetto nel riquadro Explorer.

Configurare le tabelle BigQuery

Per creare le tabelle BigQuery:

  1. Nel riquadro Explorer, fai clic e apri il set di dati Demo_order_dataset creato.
  2. Per creare una tabella Ordini vuota in cui memorizzare i dettagli delle opportunità di Salesforce, svolgi i seguenti passaggi:
    1. Fai clic su Crea tabella.
    2. Nella sezione Destinazione, inserisci Orders come nome della tabella.
    3. Nella sezione Schema, fai clic su Modifica come testo e incolla la seguente definizione di schema JSON: 
      [
  {
    "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. Fai clic su Crea tabella.
  3. Per creare una tabella Account vuota in cui archiviare i dettagli dell'account Salesforce, segui questi passaggi:
    1. Fai clic su Crea tabella.
    2. Nella sezione Destinazione, inserisci Accounts come nome della tabella.
    3. Nella sezione Schema, fai clic su Modifica come testo e incolla la seguente definizione di schema JSON: 
      [
  {
    "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. Fai clic su Crea tabella.

    Le nuove tabelle Orders e Accounts dovrebbero ora essere visualizzate nel set di dati Demo_order_dataset nel riquadro Explorer.

Verifica l'istanza ServiceNow

Questo tutorial utilizza una PDI (Personal Developer Instance) di ServiceNow gratuita. Puoi utilizzare la tua istanza ServiceNow esistente o crearne una nuova. Verifica che l'istanza sia attiva e prendi nota dell'URL dell'istanza. Per ulteriori informazioni sul PDI, consulta la documentazione relativa al PDI di ServiceNow.

Configura connessioni

Per questo tutorial, devi configurare le seguenti connessioni in Connettori di integrazione:

Connessione a Salesforce
Configura una connessione Salesforce in Integration Connectors. Per informazioni sulla configurazione di un connettore Salesforce, consulta Connettore Salesforce.
Connessione BigQuery
Configura una connessione BigQuery in Integration Connectors per ottenere, aggiornare e convalidare i dettagli dell'ordine e dell'account nel set di dati Demo_order_dataset. Per informazioni sulla configurazione di un connettore BigQuery, consulta Connettore BigQuery.
Connessione ServiceNow
Configura una connessione ServiceNow in Integration Connectors utilizzando l'URL dell'istanza per creare e recuperare i dettagli dell'account in ServiceNow. Per informazioni sulla configurazione di un connettore ServiceNow, consulta Connettore ServiceNow.

Crea integrazione

Per creare una nuova integrazione:

  1. Nella console Google Cloud, vai alla pagina Application Integration.

    Vai ad Application Integration

  2. Nel menu di navigazione, fai clic su Integrations (Integrazioni). Viene visualizzata la pagina Integrations (Integrazioni).
  3. Fai clic su Crea integrazione e fornisci i seguenti dettagli nella pagina Crea integrazione:
    1. Nome integrazione: inserisci opportunity-to-order-integration.
    2. Descrizione: inserisci Demo integration created for tutorial.
    3. Regione:seleziona us-central1 dall'elenco delle regioni supportate.
    4. Fai clic su Crea per aprire l'editor delle integrazioni.

Configura trigger di integrazione

Dopo aver creato correttamente l'integrazione, puoi aggiungere e configurare un trigger di integrazione che richiama l'integrazione per un evento identificato.

Per questo tutorial, viene utilizzato un trigger Salesforce per richiamare l'integrazione per ogni nuova opportunità creata nell'istanza Salesforce. Per aggiungere e configurare un attivatore Salesforce nell'integrazione di opportunity-to-order-integration, segui questi passaggi:

  1. Nell'editor dell'integrazione, fai clic su Trigger per visualizzare un elenco di trigger disponibili.
  2. Fai clic sull'elemento Trigger Salesforce e posizionalo nell'editor dell'integrazione.
  3. Seleziona l'elemento Trigger Salesforce nel canvas di designer per aprire il riquadro di configurazione dell'attivatore Salesforce.
  4. Configura i seguenti campi in Input trigger:
    1. Tipo di evento: seleziona Change Data Capture (CDC) dall'elenco a discesa.
    2. Configurazione istanza Salesforce: fai clic sull'opzione + Aggiungi una nuova configurazione istanza Salesforce dall'elenco a discesa.

      Nella finestra di dialogo Aggiungi la configurazione dell'istanza Salesforce, segui questi passaggi:

      • Nome connessione istanza Salesforce: inserisci un nome per la connessione per l'istanza Salesforce. Ad esempio, test.
      • Dominio Salesforce: inserisci il nome del tuo dominio Salesforce. Puoi trovare queste informazioni nel tuo account Salesforce > Visualizza profilo.
      • Profilo di autenticazione: seleziona un profilo di autenticazione. Se non hai un profilo di autenticazione, creane uno nuovo. Per informazioni, vedi Creare un nuovo profilo di autenticazione.
      • Fai clic su Aggiungi.
    3. Configurazione del canale Salesforce: fai clic sull'opzione + Aggiungi nuova configurazione del canale Salesforce dall'elenco a discesa.

      Nella finestra di dialogo Aggiungi canale Salesforce, procedi nel seguente modo:

      • Nome oggetto Salesforce: inserisci Opportunity.
      • Fai clic su Aggiungi.
    4. Operazione: seleziona Crea dall'elenco a discesa

      5. Le modifiche alle proprietà vengono salvate automaticamente.

Mappa il payload dell'attivatore al connettore Salesforce

Quando l'integrazione viene richiamata utilizzando l'attivatore di Salesforce, devi estrarre l'ID opportunità e mapparlo a un connettore Salesforce per recuperare ulteriori dettagli dell'opportunità.

Connettiti all'account Salesforce

Per aggiungere e configurare un'attività Connettori in modo da recuperare i dettagli dell'opportunità utilizzando la connessione Salesforce, procedi nel seguente modo:

  1. Nell'editor dell'integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
  2. Fai clic e posiziona l'elemento Connectors nell'editor dell'integrazione.
  3. Seleziona l'elemento attività Connettori nella progettista per visualizzare l'attività Connettori di configurazione del deployment.
  4. Fai clic su e rinomina l'etichetta Connettori in Fetch Salesforce Data.
  5. Fai clic su Configura connettore.
  6. Nella pagina Editor attività Connectors, procedi nel seguente modo:
    1. In Seleziona connessione, scegli la regione us-central1.
    2. Seleziona la connessione Salesforce dall'elenco delle connessioni disponibili.
    3. Fai clic su Avanti.
    4. In Tipo, scegli Entità.
    5. In Imposta entità/azioni, seleziona Opportunità dall'elenco di entità disponibili, quindi seleziona Ottieni come Operazione.
    6. Fai clic su Fine per completare la configurazione della connessione e chiudere il riquadro.

Estrai e mappa l'ID opportunità

Un'attività di Mappatura dei dati viene utilizzata per mappare ed estrarre i dettagli dell'opportunità tra l'attivatore Salesforce e il connettore Salesforce.

Per aggiungere e configurare la mappatura dei dati nell'integrazione, segui questi passaggi:

  1. Nell'editor dell'integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
  2. Fai clic sull'elemento Mappatura dei dati e posizionalo nell'editor dell'integrazione.
  3. Seleziona l'elemento Mappatura dei dati nel designer per visualizzare il riquadro di configurazione dell'attività.
  4. Fai clic su e rinomina l'attività Mappatura dei dati in Map to opportunity ID.
  5. Fai clic su Apri editor di mappatura dei dati.

    L'editor di mappatura dei dati ti consente di mappare le variabili di input alle variabili di output desiderate, utilizzando le funzioni di trasformazione disponibili. L'output viene quindi disponibile come variabile per qualsiasi altra attività o attivatore di integrazione. Per ulteriori dettagli su di mappatura delle variabili, consulta Aggiungere una mappatura.

  6. Mappa la variabile di output SalesforceTriggerCdcRecordID dell'attivatore alla variabile di input del connettore generato automaticamente entityId(Fetch Salesforce Data).

    Al termine della mappatura, chiudi il riquadro. Eventuali modifiche verranno salvate automaticamente.

  7. Aggiungi una connessione perimetrale dall'attivatore Salesforce all'attività Mappa a ID opportunità.
  8. Aggiungi una connessione perimetrale dall'attività Mappa a ID opportunità al connettore Recupera dati Salesforce.

Convalida l'account Salesforce nella tabella BigQuery

Dopo aver recuperato tutti i dettagli dell'opportunità dal connettore Salesforce, devi estrarre e mappare l'ID account associato all'opportunità e convalidarne l'esistenza nella tabella BigQuery.

Connettiti alla tabella BigQuery

Per configurare un'attività Connettori che legga le tabelle Account BigQuery utilizzando la connessione BigQuery, segui questi passaggi:

  1. Nell'editor dell'integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
  2. Fai clic e posiziona l'elemento Connectors nell'editor dell'integrazione.
  3. Fai clic sull'elemento attività Connettori nella finestra di progettazione per visualizzare l'attività Connettori di configurazione del deployment.
  4. Fai clic su e rinomina i Connettori in Check account in BigQuery.
  5. Fai clic su Configura connettore.
  6. Nella pagina Editor attività Connectors, procedi nel seguente modo:
    1. In Seleziona connessione, scegli la regione us-central1.
    2. Seleziona la connessione BigQuery dall'elenco delle connessioni disponibili.
    3. Fai clic su Avanti.
    4. In Tipo, scegli Entità.
    5. In Imposta entità/azioni, seleziona account dall'elenco di entità disponibili, quindi seleziona Elenco come Operazione.
    6. Fai clic su Fine per completare la configurazione della connessione e chiudere il riquadro.
  7. Aggiungi una connessione di sbarramento dal connettore Recupero dei dati di Salesforce al connettore Controlla l'account in BigQuery.

Estrazione e convalida dell'ID account Salesforce

Per estrarre, mappare e convalidare l'ID account dell'opportunità:

  1. Nell'editor dell'integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
  2. Fai clic sull'elemento Mappatura dei dati e posizionalo nell'editor dell'integrazione.
  3. Fai clic sull'elemento Mappatura dei dati nel designer per visualizzare il riquadro di configurazione dell'attività.
  4. Fai clic su e rinomina l'attività Mappatura dei dati in Check account.
  5. Fai clic su Apri editor di mappatura dei dati.
  6. Fai clic su + Aggiungi nuova variabile e crea le seguenti variabili di output:
    Nome variabile di output Tipo di dati
    sf_account_id STRING
    sf_account_name STRING
    account_exists BOOLEAN
  7. Crea la seguente mappatura tra la variabile di payload del connettore Salesforce e la variabile locale:
    Input Output 
    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

    Al termine della mappatura, chiudi il riquadro. Eventuali modifiche verranno salvate automaticamente.

  8. Aggiungi una connessione perimetrale dal connettore Controlla account in BigQuery all'attività Controlla account.

Crea nuovo account BigQuery

Dopo aver convalidato l'account Salesforce in BigQuery e se l'account non esiste, procedi nel seguente modo per creare un nuovo account in BigQuery. Puoi utilizzare le stesse informazioni anche per creare un account in ServiceNow.

Aggiungi account a BigQuery

Per configurare un'attività Connettori che crei una nuova entità nella tabella Account BigQuery, segui questi passaggi:

  1. Nell'editor dell'integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
  2. Fai clic e posiziona l'elemento Connectors nell'editor dell'integrazione.
  3. Fai clic sull'elemento attività Connettori nella finestra di progettazione per visualizzare l'attività Connettori di configurazione del deployment.
  4. Fai clic su e rinomina Connettori in Create account in BigQuery.
  5. Fai clic su Configura connettore.
  6. Nella pagina Editor attività Connectors, procedi nel seguente modo:
    1. In Seleziona connessione, scegli la regione us-central1.
    2. Seleziona la connessione BigQuery dall'elenco delle connessioni disponibili.
    3. Fai clic su Avanti.
    4. In Tipo, scegli Entità.
    5. In Imposta entità/azioni, seleziona account dall'elenco di entità disponibili, quindi seleziona Crea come operazione.
    6. Fai clic su Fine per completare la configurazione della connessione e chiudere il riquadro.

Creare un nuovo account ServiceNow

Per configurare un'attività Connettori che aggiunge un nuovo account all'istanza ServiceNow:

  1. Nell'editor dell'integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
  2. Fai clic e posiziona l'elemento Connectors nell'editor dell'integrazione.
  3. Fai clic sull'elemento attività Connettori nella finestra di progettazione per visualizzare l'attività Connettori di configurazione del deployment.
  4. Fai clic su e rinomina i Connettori in Create account in ServiceNow.
  5. Fai clic su Configura connettore.
  6. Nella pagina Editor attività Connectors, procedi nel seguente modo:
    1. In Seleziona connessione, scegli la regione us-central1.
    2. Seleziona la connessione BigQuery dall'elenco delle connessioni disponibili.
    3. Fai clic su Avanti.
    4. In Tipo, scegli Entità.
    5. In Imposta entità/azioni, seleziona system_user dall'elenco di entità disponibili, quindi seleziona Crea come Operazione.
    6. Fai clic su Fine per completare la configurazione della connessione e chiudere il riquadro.

Trasforma e mappa i dettagli degli account

Per trasformare i dettagli dell'account e mapparli ai connettori BigQuery e ServiceNow, segui questi passaggi:

  1. Nell'editor dell'integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
  2. Fai clic sull'elemento Mappatura dei dati e posizionalo nell'editor dell'integrazione.
  3. Fai clic sull'elemento Mappatura dei dati nel designer per visualizzare il riquadro di configurazione dell'attività.
  4. Fai clic su e rinomina l'attività Mappatura dei dati in Mapping for Account Creation.
  5. Fai clic su Apri editor di mappatura dei dati.
  6. Fai clic su + Aggiungi nuova variabile e crea le seguenti variabili di input:
    Nome della variabile di input Tipo di dati
    new_BQaccount JSON
    new_SNaccount JSON
  7. Crea la seguente mappatura per mappare l'ID e il nome dell'account Salesforce alla tabella BigQuery:
    Input Output 
    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)

    Una volta completata la mappatura, chiudi il riquadro. Eventuali modifiche verranno salvate automaticamente.

  8. Aggiungi una connessione perimetrale dall'attività Mappatura per la creazione di account al connettore Crea account in BigQuery.
  9. Aggiungi una connessione perimetrale dall'attività Mappatura per la creazione di account al connettore Crea account in ServiceNow.

Creare un nuovo ordine in BigQuery

Per generare un numero d'ordine e aggiungerlo in BigQuery, segui questi passaggi.

Aggiungi ordine a BigQuery

Per configurare un'attività Connettori che crei una nuova entità nella tabella Orders di BigQuery, segui questi passaggi:

  1. Nell'editor dell'integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
  2. Fai clic e posiziona l'elemento Connectors nell'editor dell'integrazione.
  3. Fai clic sull'elemento attività Connettori nella finestra di progettazione per visualizzare l'attività Connettori di configurazione del deployment.
  4. Fai clic su e rinomina i Connettori in Create order in BigQuery.
  5. Fai clic su Configura connettore.
  6. Nella pagina Editor attività Connectors, procedi nel seguente modo:
    1. In Seleziona connessione, scegli la regione us-central1.
    2. Seleziona la connessione BigQuery dall'elenco delle connessioni disponibili.
    3. Fai clic su Avanti.
    4. In Tipo, scegli Entità.
    5. In Imposta entità/azioni, seleziona Ordini dall'elenco di entità disponibili, quindi seleziona Crea come Operazione.
    6. Fai clic su Fine per completare la configurazione della connessione e chiudere il riquadro.

Genera l'ordine e mappa su BigQuery

  1. Nell'editor dell'integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
  2. Fai clic sull'elemento Mappatura dei dati e posizionalo nell'editor dell'integrazione.
  3. Fai clic sull'elemento Mappatura dei dati nel designer per visualizzare il riquadro di configurazione dell'attività.
  4. Fai clic su e rinomina l'attività Mappatura dei dati in Mapping for Order Creation.
  5. Fai clic su Apri editor di mappatura dei dati.
  6. Fai clic su + Aggiungi nuova variabile e crea la seguente variabile:
    Nome variabile Tipo di dati
    order_number STRING
  7. Crea la mappatura seguente per generare un nuovo numero di ordine e mappa i dettagli dell'ordine al connettore BigQuery:
    Input Output 
    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)

    Una volta completata la mappatura, chiudi il riquadro. Eventuali modifiche verranno salvate automaticamente.

  8. Aggiungi una connessione perimetrale dal connettore Crea account in BigQuery all'attività Mappatura per la creazione di ordini.
  9. Aggiungi una connessione di sbarramento dal connettore Crea account in ServiceNow all'attività Mappatura per la creazione dell'ordine.
  10. Aggiungi una connessione perimetrale dall'attività Mappatura per la creazione di ordini al connettore Crea ordine in BigQuery.

Aggiorna opportunità Salesforce

Dopo aver generato il nuovo numero di ordine, aggiorna l'opportunità Salesforce di origine

Configurare il connettore Salesforce

Per configurare un'attività Connettori che aggiorni l'opportunità Salesforce esistente, segui questi passaggi:

  1. Nell'editor dell'integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
  2. Fai clic e posiziona l'elemento Connectors nell'editor dell'integrazione.
  3. Fai clic sull'elemento attività Connettori nella finestra di progettazione per visualizzare l'attività Connettori di configurazione del deployment.
  4. Fai clic su e rinomina i Connettori in Update Salesforce.
  5. Fai clic su Configura connettore.
  6. Nella pagina Editor attività dei connettori:
    1. In Seleziona connessione, scegli la regione us-central1.
    2. Seleziona la connessione Salesforce dall'elenco delle connessioni disponibili.
    3. Fai clic su Avanti.
    4. In Tipo, scegli Entità.
    5. In Imposta entità/azioni, seleziona Opportunità dall'elenco di entità disponibili, quindi seleziona Aggiornamento come Operazione.
    6. Fai clic su Fine per completare la configurazione della connessione e chiudere il riquadro.

Mappa il numero dell'ordine a Salesforce

  1. Nell'editor dell'integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
  2. Fai clic sull'elemento Mappatura dei dati e posizionalo nell'editor dell'integrazione.
  3. Fai clic sull'elemento Mappatura dei dati nel designer per visualizzare il riquadro di configurazione dell'attività.
  4. Fai clic su e rinomina l'attività Mappatura dei dati in Mapping to update opportunity.
  5. Fai clic su Apri editor di mappatura dei dati.
  6. Crea la seguente mappatura per aggiornare l'opportunità Salesforce:
    Input Output 
    "{}"
.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 )

    Una volta completata la mappatura, chiudi il riquadro. Eventuali modifiche verranno salvate automaticamente.

  7. Aggiungi una connessione perimetrale dal connettore Crea ordine in BigQuery all'attività Mappatura per aggiornare l'opportunità.
  8. Aggiungi una connessione perimetrale dall'attività Mappatura per aggiornare l'opportunità al connettore Aggiorna Salesforce.

Aggiungi condizione perimetrale

Una condizione perimetrale consente di specificare le condizioni che devono essere soddisfatte affinché il controllo di un'integrazione passi all'attività connessa dal perimetro. Ora che hai aggiunto e configurato le attività richieste, puoi aggiungere una condizione di bordo per definire il flusso dell'integrazione.

La seguente condizione di confine controlla il flusso dell'integrazione in base alla convalida dei dati dell'account:

  1. Aggiungi una connessione perimetrale dall'attività Controlla account all'attività Mappatura per la creazione di account con la seguente condizione perimetrale: 
      $account_exists$ = False
  2. Aggiungi un'altra connessione perimetrale dall'attività Controlla account all'attività Mappatura per la creazione di ordini con la seguente condizione perimetrale: 
      $account_exists$ = True

Esempio di flusso di integrazione

La figura seguente mostra un layout di esempio dell'integrazione creata utilizzando questo tutorial.

Immagine di esempio che mostra il flusso di integrazione Immagine di esempio che mostra il flusso di integrazione

Pubblica e testa l'integrazione

Per pubblicare l'integrazione, fai clic su Pubblica nella barra degli strumenti dell'editor delle integrazioni.

Una volta completata la pubblicazione dell'integrazione, puoi visualizzare e controllare i log di esecuzione dell'integrazione pubblicata. Per visualizzare i log, fai clic su immagine che mostra l'icona dei log di esecuzioneVisualizza i log di esecuzione per questa integrazione. Viene visualizzata la pagina Log di esecuzione.

Caso di test 1: verificare se è stato creato un numero d'ordine per un nuovo ID account

Testa l'integrazione accedendo all'istanza Salesforce e creando una nuova opportunità. Devi creare l'opportunità in un nuovo account o in un account che non esiste nella tabella BigQuery.

Per verificare l'esito positivo dell'integrazione:

  1. Vai alla pagina BigQuery.

    Vai a BigQuery

    • Apri la tabella Account e verifica l'inserimento del nuovo ID account opportunità.
    • Apri la tabella Ordini e verifica l'inserimento dei dettagli del nuovo ordine.
  2. Vai all'istanza di ServiceNow.
    • Verifica che all'istanza venga aggiunto un nuovo account contenente lo stesso ID account opportunità Salesforce.
  3. Apri Salesforce.
    • Verifica che l'opportunità sia aggiornata con il nuovo numero d'ordine.

Caso di test 2: verificare se è stato creato un numero d'ordine per un ID account esistente in BigQuery

Testa l'integrazione accedendo all'istanza Salesforce e creando una nuova opportunità. Devi creare l'opportunità in un account esistente che esista anche nella tabella BigQuery.

Per verificare l'esito positivo dell'integrazione:

  1. Vai alla pagina BigQuery.

    Vai a BigQuery

    • Apri la tabella Account e verifica che NON sia stato inserito un nuovo ID account.
    • Apri la tabella Ordini e verifica l'inserimento dei dettagli del nuovo ordine.
  2. Apri Salesforce.
    • Verifica che l'opportunità sia aggiornata con il nuovo numero d'ordine.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, annulla la pubblicazione dell'integrazione ed elimina le connessioni create in Integration Connectors.

  • Per annullare la pubblicazione di questa integrazione, fai clic su Annulla pubblicazione nella barra degli strumenti dell'editor dell'integrazione. Per saperne di più, consulta Eliminare le integrazioni.
  • Per informazioni su come eliminare una connessione, consulta Gestire i connettori.