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 Enterprise Resource Planning (ERP).

Panoramica

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

In questo tutorial creerai un'integrazione che utilizza un trigger Salesforce per iscriverti a un nuovo evento opportunità in Salesforce. Quando viene creata una nuova opportunità, l'integrazione recupera 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 di ServiceNow collegata utilizzando Integration Connectors.

Obiettivi

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

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

Costi

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

• Integrazione delle applicazioni
• Integration Connectors
• BigQuery
• Secret Manager

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

Una volta completate le attività descritte in questo documento, puoi evitare la fatturazione continua eliminando le risorse che hai creato. Per ulteriori informazioni, consulta la pagina Pulizia.

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Attiva l'API BigQuery.

   Abilita l'API

5. Crea un account di servizio:

   1. Nella console Google Cloud, vai alla pagina Crea account di servizio.

      Vai a Crea account di servizio
   2. Seleziona il progetto.

   3. Nel campo Nome account di servizio, inserisci un nome. La console Google Cloud compila il campo ID account di servizio in base a questo nome.

      Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio, Service account for quickstart.

   4. Fai clic su Crea e continua.

   5. Concedi i seguenti ruoli all'account di servizio: 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).

      Per concedere un ruolo, trova l'elenco Seleziona un ruolo e selezionalo.

      Per concedere altri ruoli, fai clic su Aggiungi un altro ruolo e aggiungi ogni ruolo aggiuntivo.

      Nota: il campo Ruolo influisce sulle risorse a cui l'account di servizio può accedere nel progetto. Puoi revocare questi ruoli o concedere ruoli aggiuntivi in un secondo momento. In ambienti di produzione, non concedere i ruoli Proprietario, Editor o Visualizzatore. Concedi invece un ruolo predefinito o un ruolo personalizzato che soddisfi le tue esigenze.
   6. Fai clic su Continua.

   7. Fai clic su Fine per completare la creazione dell'account di servizio.

6. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

7. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

8. Attiva l'API BigQuery.

   Abilita l'API

9. Crea un account di servizio:

   1. Nella console Google Cloud, vai alla pagina Crea account di servizio.

      Vai a Crea account di servizio
   2. Seleziona il progetto.

   3. Nel campo Nome account di servizio, inserisci un nome. La console Google Cloud compila il campo ID account di servizio in base a questo nome.

      Nel campo Descrizione account di servizio, inserisci una descrizione. Ad esempio, Service account for quickstart.

   4. Fai clic su Crea e continua.

   5. Concedi i seguenti ruoli all'account di servizio: 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).

      Per concedere un ruolo, trova l'elenco Seleziona un ruolo e selezionalo.

      Per concedere altri ruoli, fai clic su Aggiungi un altro ruolo e aggiungi ogni ruolo aggiuntivo.

      Nota: il campo Ruolo influisce sulle risorse a cui l'account di servizio può accedere nel progetto. Puoi revocare questi ruoli o concedere ruoli aggiuntivi in un secondo momento. In ambienti di produzione, non concedere i ruoli Proprietario, Editor o Visualizzatore. Concedi invece un ruolo predefinito o un ruolo personalizzato che soddisfi le tue esigenze.
   6. Fai clic su Continua.

   7. Fai clic su Fine per completare la creazione dell'account di servizio.

Nota: tutte le altre API Google Cloud obbligatorie, come l'API Application Integration, l'API Secret Manager e l'API Connectors sono abilitate durante la configurazione di Application Integration. Per maggiori dettagli, vedi Configurare Application Integration.

prepara l'ambiente

Verifica la configurazione dell'utente Salesforce

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

Configura set di dati e tabella BigQuery

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

Configura set di dati BigQuery

Per configurare il set di dati BigQuery:

1. Vai alla pagina BigQuery nella console Google Cloud.

   Vai a BigQuery

2. Fai clic sul riquadro Explorer 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.

Il nuovo set di dati Demo_order_dataset dovrebbe ora apparire nel 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. Segui questi passaggi per creare una tabella Ordini vuota in cui archiviare i dettagli dell'opportunità Salesforce:
   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. Segui questi passaggi per creare una tabella Account vuota in cui archiviare i dettagli dell'account Salesforce:
   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 un'istanza di sviluppo personale (PDI) gratuita di ServiceNow. Puoi utilizzare l'istanza ServiceNow esistente o crearne una nuova. Verifica che l'istanza sia attiva e prendi nota del suo URL. Per ulteriori informazioni su PDI, consulta la documentazione su PDI di ServiceNow.

Configura connessioni

Per questo tutorial, devi configurare le seguenti connessioni in Integration Connectors:

Suggerimento: ti consigliamo di creare le seguenti connessioni nella regione us-central1(lowa).

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 di ordini e 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 l'articolo sul connettore ServiceNow.

Crea integrazione

Per creare una nuova integrazione, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni). Viene visualizzata la pagina Elenco delle integrazioni.
3. Fai clic su Crea integrazione e fornisci i seguenti dettagli nella pagina Crea integrazione:
   1. Integration name (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 di integrazione.

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 di integrazione, fai clic su Attivatori per visualizzare un elenco degli attivatori disponibili.
2. Fai clic sull'elemento attivatore Salesforce e posizionalo nell'editor di integrazione.
3. Seleziona l'elemento attivatore di Salesforce nel canvas del progettista per aprire il riquadro di configurazione dell'attivatore Salesforce.
4. Configura i seguenti campi in Input trigger:
   1. Tipo di evento: seleziona Modifica acquisizione dati (CDC) dall'elenco a discesa.
   2. Configurazione dell'istanza Salesforce: fai clic sull'opzione + Aggiungi nuova configurazione dell'istanza Salesforce dall'elenco a discesa.

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

      • Nome connessione istanza Salesforce: inserisci un nome di connessione per l'istanza Salesforce. Ad esempio, test.
      • Dominio Salesforce: inserisci il nome del dominio Salesforce. Puoi trovare queste informazioni nella pagina Account Salesforce > Visualizza profilo.
      • Profilo di autenticazione: seleziona un profilo di autenticazione. Se non hai un profilo di autenticazione, creane uno nuovo. Per ulteriori 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

   Le modifiche alle proprietà vengono salvate automaticamente.

Mappa il payload del trigger al connettore Salesforce

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

Connettersi all'account Salesforce

Segui questi passaggi per aggiungere e configurare un'attività Connettori in modo da recuperare i dettagli delle opportunità utilizzando la connessione Salesforce:

1. Nell'editor di integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
2. Fai clic sull'elemento Connettori e posizionalo nell'editor di integrazione.
3. Seleziona l'elemento dell'attività Connettori nel designer per visualizzare il riquadro di configurazione dell'attività Connettori.
4. Fai clic su e rinomina l'etichetta Connettori in Fetch Salesforce Data.
5. Fai clic su Configura connettore.
6. Esegui le seguenti operazioni nella pagina Editor attività connettori:
   1. In Seleziona connessione, scegli la regione us-central1.
   2. Seleziona la connessione Salesforce dall'elenco di connessioni disponibili.
   3. Tocca 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.

ID opportunità di estrazione e mappatura

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

Per aggiungere e configurare la mappatura dei dati nell'integrazione:

1. Nell'editor di integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
2. Fai clic sull'elemento Data Mapping e posizionalo nell'editor di integrazione.
3. Seleziona l'elemento Data Mapping nel designer per visualizzare il riquadro di configurazione delle 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 consente di mappare le variabili di input a quelle di output desiderate, utilizzando le funzioni di trasformazione disponibili. L'output è quindi disponibile come variabile per qualsiasi altro trigger o attività di integrazione. Per maggiori dettagli sulle variabili di mappatura, consulta Aggiungere una mappatura.

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

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

7. Aggiungi una connessione perimetrale dall'attivatore Salesforce all'attività Mappa all'ID opportunità.
8. Aggiungi una connessione perimetrale dall'attività Mappa all'ID opportunità al connettore Recupera i dati di 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.

Effettuare la connessione alla tabella BigQuery

Segui questi passaggi per configurare un'attività Connettori che legga le tabelle Account BigQuery utilizzando la connessione BigQuery:

1. Nell'editor di integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
2. Fai clic sull'elemento Connettori e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento dell'attività Connettori nel designer per visualizzare il riquadro di configurazione dell'attività Connettori.
4. Fai clic su e rinomina i connettori in Check account in BigQuery.
5. Fai clic su Configura connettore.
6. Esegui le seguenti operazioni nella pagina Editor attività connettori:
   1. In Seleziona connessione, scegli la regione us-central1.
   2. Seleziona la tua connessione BigQuery dall'elenco delle connessioni disponibili.
   3. Tocca Avanti.
   4. In Tipo, scegli Entità.
   5. In Imposta entità/azioni, seleziona account dall'elenco di entità disponibili e poi Elenco come Operazione.
   6. Fai clic su Fine per completare la configurazione della connessione e chiudere il riquadro.
7. Aggiungi una connessione perimetrale dal connettore Recupera i dati di Salesforce al connettore Controlla l'account in BigQuery.

Estrai e convalida l'ID account Salesforce

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

1. Nell'editor di integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
2. Fai clic sull'elemento Data Mapping e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento Mappatura dei dati nel designer per visualizzare il riquadro di configurazione delle 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 payload del connettore Salesforce e la variabile locale:

   di inupt	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

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

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

Crea un nuovo account BigQuery

Una volta convalidato l'account Salesforce in BigQuery e se l'account non esiste, segui questi passaggi per crearne uno nuovo in BigQuery. Utilizzi le stesse informazioni anche per creare un account in ServiceNow.

Aggiungi account a BigQuery

Segui questi passaggi per configurare un'attività Connettori che crei una nuova entità nella tabella Account BigQuery:

1. Nell'editor di integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
2. Fai clic sull'elemento Connettori e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento dell'attività Connettori nel designer per visualizzare il riquadro di configurazione dell'attività Connettori.
4. Fai clic su e rinomina i connettori in Create account in BigQuery.
5. Fai clic su Configura connettore.
6. Esegui le seguenti operazioni nella pagina Editor attività connettori:
   1. In Seleziona connessione, scegli la regione us-central1.
   2. Seleziona la tua connessione BigQuery dall'elenco delle connessioni disponibili.
   3. Tocca Avanti.
   4. In Tipo, scegli Entità.
   5. In Imposta entità/azioni, seleziona account dall'elenco di entità disponibili e poi seleziona Crea come Operazione.
   6. Fai clic su Fine per completare la configurazione della connessione e chiudere il riquadro.

Crea un nuovo account ServiceNow

Completa i seguenti passaggi per configurare un'attività Connettori che aggiunge un nuovo account all'istanza ServiceNow:

1. Nell'editor di integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
2. Fai clic sull'elemento Connettori e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento dell'attività Connettori nel designer per visualizzare il riquadro di configurazione dell'attività Connettori.
4. Fai clic su e rinomina i connettori in Create account in ServiceNow.
5. Fai clic su Configura connettore.
6. Esegui le seguenti operazioni nella pagina Editor attività connettori:
   1. In Seleziona connessione, scegli la regione us-central1.
   2. Seleziona la tua connessione BigQuery dall'elenco delle connessioni disponibili.
   3. Tocca Avanti.
   4. In Tipo, scegli Entità.
   5. In Imposta entità/azioni, seleziona system_user dall'elenco delle entità disponibili e poi seleziona Crea come Operazione.
   6. Fai clic su Fine per completare la configurazione della connessione e chiudere il riquadro.

Trasforma e mappa i dettagli dell'account

Per trasformare i dettagli dell'account e mapparli ai connettori BigQuery e ServiceNow:

1. Nell'editor di integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
2. Fai clic sull'elemento Data Mapping e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento Mappatura dei dati nel designer per visualizzare il riquadro di configurazione delle 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 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:

   di inupt	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. Le modifiche verranno salvate automaticamente.

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

Crea un nuovo ordine in BigQuery

Per generare un numero di ordine e aggiungerlo in BigQuery, procedi nel seguente modo:

Aggiungi un ordine a BigQuery

Segui questi passaggi per configurare un'attività Connettori che crei una nuova entità nella tabella Ordini di BigQuery:

1. Nell'editor di integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
2. Fai clic sull'elemento Connettori e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento dell'attività Connettori nel designer per visualizzare il riquadro di configurazione dell'attività Connettori.
4. Fai clic su e rinomina i connettori in Create order in BigQuery.
5. Fai clic su Configura connettore.
6. Esegui le seguenti operazioni nella pagina Editor attività connettori:
   1. In Seleziona connessione, scegli la regione us-central1.
   2. Seleziona la tua connessione BigQuery dall'elenco delle connessioni disponibili.
   3. Tocca 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 ordine e mappa su BigQuery

1. Nell'editor di integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
2. Fai clic sull'elemento Data Mapping e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento Mappatura dei dati nel designer per visualizzare il riquadro di configurazione delle 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 seguente mappatura per generare un nuovo numero d'ordine e mappare i dettagli dell'ordine al connettore BigQuery:

   di inupt	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. Le modifiche verranno salvate automaticamente.

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

Aggiorna opportunità Salesforce

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

Configurare il connettore Salesforce

Segui questi passaggi per configurare un'attività Connettori che aggiorni l'opportunità Salesforce esistente:

1. Nell'editor di integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
2. Fai clic sull'elemento Connettori e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento dell'attività Connettori nel designer per visualizzare il riquadro di configurazione dell'attività Connettori.
4. Fai clic su e rinomina i connettori in Update Salesforce.
5. Fai clic su Configura connettore.
6. Esegui le seguenti operazioni nella pagina Editor attività connettori:
   1. In Seleziona connessione, scegli la regione us-central1.
   2. Seleziona la connessione Salesforce dall'elenco di connessioni disponibili.
   3. Tocca Avanti.
   4. In Tipo, scegli Entità.
   5. In Imposta entità/azioni, seleziona Opportunità dall'elenco di entità disponibili, quindi seleziona Aggiorna 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 di integrazione, fai clic su Tasks per visualizzare un elenco di attività disponibili.
2. Fai clic sull'elemento Data Mapping e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento Mappatura dei dati nel designer per visualizzare il riquadro di configurazione delle 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:

   di inupt	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. Le modifiche verranno salvate automaticamente.

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

Aggiungi condizione bordo

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 perimetrale per definire il flusso dell'integrazione.

La seguente condizione perimetrale controlla il flusso dell'integrazione in base alla convalida delle informazioni dell'account:

1. Aggiungi una connessione perimetrale dall'attività Verificare l'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à Verificare l'account all'attività Mappatura per la creazione degli ordini con la seguente condizione:

     $account_exists$ = True

Esempio di flusso di integrazione

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

Pubblicare e testare l'integrazione

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

Una volta pubblicata l'integrazione, puoi visualizzare e controllare i log di esecuzione dell'integrazione pubblicata. Per visualizzare i log, fai clic su Visualizza i log di esecuzione per questa integrazione. Viene visualizzata la pagina Log di esecuzione.

Scenario 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 il successo dell'integrazione:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

   • Apri la tabella Account e controlla per confermare l'inserimento del nuovo ID account opportunità.
   • Apri la tabella Ordini e controlla per confermare l'inserimento dei nuovi dettagli dell'ordine.
2. Vai all'istanza di ServiceNow.
   • Seleziona questa opzione per verificare se all'istanza viene 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.

Scenario 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 esiste anche nella tabella BigQuery.

Per verificare il successo dell'integrazione:

1. Vai alla pagina BigQuery.

   Vai a BigQuery

   • Apri la tabella Account e controlla che NON sia inserito alcun nuovo ID account.
   • Apri la tabella Ordini e controlla per confermare l'inserimento dei nuovi dettagli dell'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 di integrazione. Per saperne di più, consulta Eliminare le integrazioni.
• Per informazioni su come eliminare una connessione, vedi Gestire i connettori.