Consulta i connettori supportati per Application Integration.
Trigger Salesforce
Il trigger Salesforce ti consente di ascoltare gli eventi Change Data Capture (CDC) o Enterprise Messaging Platform. Con questo trigger, puoi avviare l'integrazione in base a uno qualsiasi degli eventi CDC (Create, Update, Delete o Undelete) o agli eventi della piattaforma nella tua istanza Salesforce.
Per ulteriori informazioni, consulta i seguenti tutorial:
- Per utilizzare Application Integration per automatizzare il flusso del processo aziendale di routing e assegnazione di una richiesta di assistenza clienti Salesforce, consulta il tutorial Automatizzare le assegnazioni di routing delle richieste di assistenza Salesforce.
- Per 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), consulta il tutorial Automatizzare l'opportunità Salesforce per l'ordine BigQuery.
- Per utilizzare il trigger Salesforce per richiamare un'integrazione in Application Integration per un evento Change Data Capture (CDC) di Salesforce, consulta il tutorial Richiamare un'integrazione per un evento Change Data Capture (CDC) di Salesforce.
Prima di iniziare
Questa sezione descrive i passaggi necessari per connettere e configurare un'istanza Salesforce per utilizzare Change Data Capture (CDC) o eventi della piattaforma per trasmettere in streaming le modifiche all'Application Integration in modalità Pub/Sub. Prima di configurare qualsiasi attività o trigger correlato a Salesforce in Application Integration, devi completare i seguenti passaggi:
- Configurare un utente di integrazione
- Configurare un set di autorizzazioni
- Configurare un token di sicurezza
- Creare un'app connessa
Configurare un utente di integrazione
Configura un utente di integrazione seguendo questi passaggi:
- Accedi alla tua istanza Salesforce con le tue credenziali
sysadmin
. - Fai clic sull'icona a forma di ingranaggio e poi seleziona Configurazione, come mostrato nell'immagine di seguito:
- Fai clic su Utenti > Utenti dal menu Amministrazione.
- Nel riquadro Utenti, seleziona il pulsante Nuovo utente.
- Nella finestra di dialogo Modifica utente, inserisci i seguenti dettagli:
- Nome: nome dell'utente dell'integrazione.
- Cognome: cognome dell'utente dell'integrazione.
- Indirizzo email: email dell'utente di integrazione. Idealmente, dovrebbe essere un'email di gruppo.
- Nome utente: nome utente conforme alle convenzioni di denominazione a livello di organizzazione.
Se stai creando un nuovo utente di integrazione, utilizza il seguente formato:
EMAIL.SALESFORCE_ORG_NAME.SANDBOX_NAME
Se hai un utente di integrazione esistente, verifica che il nome utente sia inserito qui.
- Ruolo: seleziona un'opzione dal menu a discesa.
- Licenza utente: inserisci
Salesforce
o, se utilizzi un'organizzazione di prova, inserisciSalesforce Platform
. - Profilo: seleziona il profilo delle autorizzazioni per gli utenti dell'integrazione dal menu a discesa.
Ti consigliamo di assegnare un profilo senza autorizzazioni per proteggere l'accesso Salesforce dell'utente di integrazione da utilizzi non autorizzati.
- Fai clic su Salva.
- Per aggiornare la password del nuovo utente di integrazione, segui questi passaggi:
- Fai clic sul pulsante Reimposta password nel riquadro Utenti. Viene inviata un'email di reimpostazione della password all'indirizzo email associato all'utente.
- Segui il flusso di reimpostazione della password dall'account email. Prendi nota della nuova password, perché ti servirà in un passaggio successivo.
Configurare un set di autorizzazioni
Se hai già accesso a un insieme di autorizzazioni appropriato per un utente di integrazione, puoi saltare questo passaggio e procedere alla configurazione di un token di sicurezza. In caso contrario, segui questi passaggi per configurare un insieme di autorizzazioni per l'utente di integrazione e l'oggetto Salesforce.
Per configurare un insieme di autorizzazioni per l'utente di integrazione:
- Nel menu Configurazione, fai clic su Utenti > Set di autorizzazioni.
- Nel riquadro Set di autorizzazioni, fai clic sul pulsante Nuovo.
- Nella finestra di dialogo Set di autorizzazioni, inserisci i seguenti dettagli:
- Etichetta: inserisci un nome per il set di autorizzazioni.
- Licenza: seleziona Salesforce dal menu a discesa Licenza.
- Fai clic su Salva.
- Nell'elenco delle opzioni di impostazione Sistema, scorri verso il basso e seleziona Autorizzazioni di sistema.
- Nella pagina Autorizzazioni di sistema, fai clic sul pulsante Modifica.
- Scorri verso il basso l'elenco delle autorizzazioni disponibili e seleziona la casella di controllo API abilitata.
È necessaria anche l'autorizzazione Utente solo API, che non può essere attivata finché non viene reimpostato il token di sicurezza richiesto. Questa autorizzazione viene aggiunta in un passaggio successivo.
- (Facoltativo) Scorri e seleziona Modifica tutti i dati e Visualizza tutti i dati, se applicabile. Queste autorizzazioni non sono obbligatorie, ma possono essere utili se vuoi concedere automaticamente all'utente di integrazione l'accesso a nuovi oggetti. Ti consigliamo di abilitare queste autorizzazioni solo per i test in una sandbox.
- Scorri fino in cima all'elenco delle autorizzazioni e fai clic su Salva.
- Conferma le impostazioni e fai clic su Salva.
Per configurare il set di autorizzazioni per l'oggetto Salesforce:
- Fai clic su Panoramica dell'insieme di autorizzazioni per tornare alla pagina di configurazione principale dell'insieme di autorizzazioni.
- Seleziona Impostazioni oggetto nella sezione App del riquadro Set di autorizzazioni.
- Scorri verso il basso e seleziona gli oggetti Salesforce che richiedono un insieme di autorizzazioni. Questo esempio utilizza l'oggetto Opportunità.
- Fai clic sul pulsante Modifica nella pagina dei dettagli dell'oggetto.
- Seleziona le caselle di controllo per i tipi di record. Se sai quali tipi di record sono richiesti, selezionali. Se non sai quali tipi di record sono necessari, selezionali tutti.
- Seleziona le caselle di controllo per attivare le autorizzazioni oggetto. Sono consigliati Lettura e Visualizza tutto.
- Concedi l'accesso in lettura o l'accesso in modifica per ogni campo dell'oggetto selezionando la casella di controllo corrispondente.
- Scorri fino in cima alla pagina e fai clic su Salva.
Configurare un token di sicurezza
Se in precedenza hai creato un token di sicurezza per l'utente di integrazione e hai reimpostato la password, viene inviata automaticamente un'email con un nuovo token di sicurezza. Puoi utilizzare il nuovo token e passare a Crea un'app collegata.
In caso contrario, segui questi passaggi per reimpostare il token di sicurezza per l'utente di integrazione:
- Accedi a Salesforce come utente di integrazione utilizzando il nome utente e la password impostati in un passaggio precedente.
- Nel menu principale, fai clic sull'immagine del profilo, quindi su Impostazioni.
- Dal menu Impostazioni, seleziona Reimposta il mio token di sicurezza per aprire il riquadro Reimposta token di sicurezza.
- Fai clic sul pulsante Reimposta token di sicurezza.
- Controlla l'account email associato all'utente di integrazione per un'email contenente il nuovo token di sicurezza. Prendi nota del nuovo token di sicurezza, perché ti servirà per un passaggio successivo.
- (Facoltativo) Attiva l'autorizzazione Solo utente API in Autorizzazioni di sistema per il set di autorizzazioni, come descritto in Configurare un set di autorizzazioni sopra.
Crea un'app connessa
Per configurare un'app connessa è necessaria l'autorizzazione di amministrazione del sistema. Se al momento hai eseguito l'accesso
come utenti di integrazione, assicurati di uscire e poi accedere di nuovo come sysadmin
.
Per configurare un'app connessa:
- Fai clic sull'icona a forma di ingranaggio e poi seleziona Configurazione.
- Dal menu Configurazione, cerca e seleziona App Manager, come mostrato nell'immagine di seguito:
- Fai clic su Nuova app connessa.
- Nel riquadro di configurazione, fornisci i seguenti dettagli:
- Nome app connessa: inserisci un nome per l'app connessa.
- Nome API: inserisci il nome dell'API.
- Email di contatto: inserisci un indirizzo email per l'app collegata, idealmente un alias email di gruppo.
- API (Enable OAuth Settings): seleziona Enable OAuth Settings (Attiva impostazioni OAuth). Poi, imposta quanto segue:
- URL di callback: questo campo è obbligatorio solo se vuoi che un servizio esterno riceva la risposta di autorizzazione OAuth (ad esempio codici o token di autorizzazione) ed esegua la convalida.
Se scegli di fornire un callback, assicurati di includere il prefisso
http(s)://
. - Ambiti OAuth selezionati: seleziona:
- Accedere ai tuoi dati e gestirli (API)
- Eseguire richieste per tuo conto in qualsiasi momento (refresh_token, offline_access)
- URL di callback: questo campo è obbligatorio solo se vuoi che un servizio esterno riceva la risposta di autorizzazione OAuth (ad esempio codici o token di autorizzazione) ed esegua la convalida.
Se scegli di fornire un callback, assicurati di includere il prefisso
- Fai clic su Salva.
- Fai clic su Continua. Devi autorizzare nuovamente l'accesso con un codice di verifica inviato al tuo indirizzo email.
- Dopo aver verificato correttamente il codice, nella pagina successiva vengono visualizzati un secret consumer e una chiave utente. Prendi nota di questi valori, in quanto verranno utilizzati durante la configurazione del modulo di autenticazione per l'Application Integrationi.
- Fai clic sul pulsante Gestisci.
- Nella pagina Dettagli app collegata, fai clic sul pulsante Modifica policy.
- Nella sezione OAuth Policies (Norme OAuth), modifica il valore nel menu a discesa Permitted Users (Utenti consentiti) in Admin approved users are pre-authorized (Gli utenti approvati dall'amministratore sono preautorizzati).
- Fai clic su Salva.
- Scorri fino alla sezione Profili e Set di autorizzazioni della pagina per selezionare il profilo o il set di autorizzazioni che vuoi applicare all'app connessa.
- Seleziona il profilo o il set di autorizzazioni che preferisci.
- Fai clic su Salva.
Passaggi preliminari per utilizzare gli eventi CDC
Prima di configurare il trigger di Application Integration per utilizzare gli eventi CDC, assicurati di aggiungere un oggetto configurato a CDC in Salesforce:
- Accedi a Salesforce come
sysadmin
. - Fai clic sull'icona a forma di ingranaggio e poi su Configurazione.
- Utilizzando il menu di navigazione a sinistra, cerca e seleziona Change Data Capture.
- Nella pagina di configurazione Acquisizione delle modifiche ai dati, individua l'oggetto Salesforce che vuoi utilizzare nella colonna Entità disponibili e trascinalo nella colonna Entità selezionate.
- Fai clic su Salva.
Passaggi preliminari per utilizzare gli eventi della piattaforma
Prima di configurare il trigger di Application Integration per utilizzare gli eventi della piattaforma, completa i seguenti passaggi in Salesforce:
- Creare un evento della piattaforma
- Aggiornare le autorizzazioni per l'evento della piattaforma
Creare un evento della piattaforma
Per creare un evento della piattaforma, segui questi passaggi:
- Accedi alla tua istanza Salesforce con le tue credenziali
sysadmin
. - Fai clic sull'icona a forma di ingranaggio e poi seleziona Configurazione.
- Nel riquadro di navigazione, cerca Piattaforma e poi fai clic su Eventi della piattaforma.
- Nella pagina Eventi della piattaforma, fai clic su Nuovo evento della piattaforma e imposta le seguenti proprietà:


- Etichetta
- Etichetta plurale
- Nome oggetto(questo campo viene compilato automaticamente)
- Comportamento di pubblicazione
Seleziona uno dei seguenti valori:
- Pubblica dopo il commit: ripristina lo streaming degli eventi se una condizione non viene soddisfatta.
- Pubblica immediatamente: attiva immediatamente l'evento, senza attendere alcuna convalida.
- Stato del deployment (facoltativo): seleziona Eseguito se l'evento è pronto per il deployment.


Dopo aver creato i campi personalizzati, nella pagina Eventi della piattaforma, nota il valore del campo Nome API. Il nome dell'oggetto termina con _e, il che significa che l'oggetto è un oggetto evento della piattaforma. Per un oggetto CDC, il nome dell'oggetto termina con _c.


Aggiornare le autorizzazioni per l'evento della piattaforma
Il set di autorizzazioni deve essere aggiornato per consentire all'utente di integrazione di accedere all'evento della piattaforma appena creato.
Per aggiornare le autorizzazioni, segui questi passaggi:
- Nel menu Configurazione, fai clic su Utenti > Set di autorizzazioni.
- Nella pagina Set di autorizzazioni, fai clic sull'autorizzazione creata in precedenza.
- Fai clic su Impostazioni oggetto > Plural Label of the Platform Event.
- Nella sezione Autorizzazioni oggetto, attiva le autorizzazioni Lettura e Crea.
- Fai clic su Salva.


Aggiungere un trigger Salesforce
Per aggiungere un trigger Salesforce a un'integrazione nuova o esistente, segui questi passaggi:- Nella console Google Cloud , vai alla pagina Application Integration.
- Nel menu di navigazione, fai clic su Integrazioni.
Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.
- Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.
Se stai creando una nuova integrazione:
- Inserisci un nome e una descrizione nel riquadro Crea integrazione.
- Seleziona una regione per l'integrazione.
- Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli dell'account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo integrazione nella barra degli strumenti dell'integrazione.
- Fai clic su Crea. L'integrazione appena creata si apre nell'editor integrazioni.
- Nella barra di navigazione dell'Editor integrazioni, fai clic su Attività per visualizzare l'elenco delle attività e dei connettori disponibili.
- Seleziona un'integrazione esistente o fai clic su Crea integrazione.
- Nell'editor dell'integrazione, fai clic su + Aggiungi un'attività/trigger > Trigger per visualizzare i trigger disponibili.
- Fai clic sull'elemento Trigger Salesforce e posizionalo nel designer.
Configurare il trigger Salesforce
Per configurare il trigger Salesforce:
- Fai clic su Trigger Salesforce nell'editor di integrazione per visualizzare il riquadro di configurazione del trigger.
- Seleziona un'istanza Salesforce dal menu a discesa Configurazione istanza Salesforce.
Se non hai un'istanza Salesforce, creane una nuova. Per ulteriori informazioni, consulta Creare una nuova istanza Salesforce.
- Seleziona un canale Salesforce dal menu a discesa Configurazione canale Salesforce.
Se non hai un canale Salesforce, creane uno nuovo. Per saperne di più, consulta Creare un nuovo canale Salesforce.
- Se hai scelto il tipo di evento CDC, seleziona una delle seguenti operazioni:
Create
Update
Delete
Undelete
L'attivatore viene eseguito solo se si verifica l'operazione specifica o l'operazione di intervallo.
Il trigger Salesforce può essere configurato per una sola operazione. Se vuoi eseguire il trigger per più operazioni, crea un trigger Salesforce per ogni operazione.
Crea una nuova istanza Salesforce
Per configurare una nuova istanza Salesforce:
- Nelle proprietà modificabili dell'attivatore, fai clic su Seleziona una configurazione dell'istanza Salesforce > + Aggiungi nuova configurazione dell'istanza Salesforce.
- Nella finestra di dialogo Aggiungi configurazione istanza Salesforce, imposta le seguenti proprietà:
- Nome connessione istanza Salesforce: inserisci un nome per l'istanza.
Dopo la configurazione, utilizzerai questo nome per fare riferimento all'istanza di Salesforce.
- Dominio Salesforce: inserisci un'autorità di servizio per l'istanza. Puoi trovare il dominio nel tuo account Salesforce. Ad esempio,
instance.my.salesforce.com
. L'immagine seguente mostra il dominio Salesforce: - Profilo di autenticazione: seleziona un profilo di autenticazione.
Se non hai un profilo di autenticazione, creane uno nuovo di tipo Credenziali della password del proprietario delle risorse OAuth 2.0. Per informazioni sui campi, vedi Credenziali della password del proprietario delle risorse OAuth 2.0. Per l'istanza Salesforce, inserisci i seguenti valori:
- ID client:inserisci la chiave utente che hai annotato quando hai configurato un'app connessa.
- Secret:inserisci il secret consumer che hai annotato quando hai configurato un'app connessa.
- Password:inserisci la password dell'utente nel formato
USER_PASSWORDSECURITY_TOKEN
. Sostituisci quanto segue:USER_PASSWORD
: la password dell'utente Salesforce.SECURITY_TOKEN
: il token di sicurezza che hai impostato per l'integrazione.
USER_PASSWORD
ètest-password
eSECURITY_TOKEN
è737K27NCa3O6
, la tua password saràtest-password737K27NCa3O6
.
- ID organizzazione Salesforce: inserisci l'ID organizzazione dell'istanza Salesforce. Puoi ottenere l'ID dall'amministratore Salesforce.
- Fai clic su Aggiungi.
La seguente immagine mostra i campi richiesti per creare un profilo di autenticazione:
Creare un nuovo canale Salesforce
Per configurare un nuovo canale Salesforce:
- Nelle proprietà modificabili dell'attivatore, fai clic su Seleziona una configurazione del canale Salesforce > + Aggiungi nuova configurazione del canale Salesforce.
- Nella finestra di dialogo Aggiungi configurazione canale Salesforce, inserisci il nome dell'oggetto
per la proprietà Nome oggetto Salesforce.
Per l'elenco degli oggetti Salesforce, consulta Oggetti standard in Salesforce. In caso di dubbi sul nome dell'oggetto, contatta l'amministratore Salesforce.
- Fai clic su Aggiungi.
Variabili di output
La risposta del trigger Salesforce è disponibile nelle variabili di output.
Le variabili di output per un evento CDC sono descritte nella tabella seguente:
Variabile | Tipo di dati | Descrizione |
SalesforceTriggerCdcPayload | JSON | Dettagli dell'evento di modifica. |
SalesforceTriggerEvent | JSON | Contiene replayId dell'evento. |
SalesforceTriggerSchema | Stringa | Schema del trigger. |
SalesforceTriggerCdcSnapshot | JSON | Snapshot dell'oggetto dopo l'evento di modifica. Questo campo è disponibile solo per le operazioni Update e Create . |
SalesforceTriggerCdcRecordId | Stringa | Contiene il recordId del record aggiornato o aggiunto. recordId è un
identificatore dell'oggetto Salesforce modificato. |
Le variabili di output per un evento Platform sono descritte nella tabella seguente:
Variabile | Tipo di dati | Descrizione |
SalesforceTriggerPEPayload | JSON | Dettagli dell'evento di modifica. |
SalesforceTriggerEvent | JSON | Contiene replayId dell'evento. |
SalesforceTriggerSchema | Stringa | Schema del trigger. |
CdcTriggerPayload
. La variabile JSON
contiene gli oggetti record aggiornati.
Best practice
L'utilizzo del trigger Salesforce è consigliato nei casi in cui vuoi utilizzare le notifiche Salesforce per attivare le integrazioni senza scrivere codice personalizzato per pubblicare gli eventi Salesforce. Qualsiasi piccola modifica al campo nella richiesta di assistenza Salesforce attiverà un evento CDC di Salesforce e quindi un'integrazione, che può generare un rumore significativo nell'integrazione. Valuta la possibilità di utilizzare Filtri eventi di modifica per filtrare solo gli eventi CDC richiesti che attivano l'integrazione. L'utilizzo dei filtri degli eventi di modifica può contribuire a ridurre il rumore dell'integrazione e garantire la conformità con le limitazioni della licenza.
Allo stesso modo, ti consigliamo di annullare la pubblicazione di qualsiasi integrazione che utilizza questo trigger quando non è più necessaria. Finché non viene annullata la pubblicazione o eliminata, l'integrazione continuerà a rilevare gli eventi CDC e della piattaforma Salesforce.
Considerazioni
Prima di utilizzare il trigger Salesforce per eseguire l'integrazione, considera quanto segue:
- Salesforce invia un massimo di 100.000 eventi CDC e della piattaforma al giorno. Se acquisti una maggiore capacità di eventi della piattaforma da Salesforce, puoi pubblicare oltre 10 milioni di eventi al giorno. Per saperne di più, consulta Allocazione degli eventi della piattaforma. Contatta l'amministratore di Salesforce per comprendere le limitazioni della licenza prima di scegliere gli eventi CDC per il trigger di integrazione.
- Se prevedi caricamenti collettivi su Salesforce, valuta la possibilità di mettere in pausa CDC per ridurre il rumore dell'integrazione e garantire la conformità con le limitazioni della licenza.
- La dimensione massima del messaggio evento che Salesforce può pubblicare è di 1 MB. Per ulteriori informazioni, consulta la sezione Allocazioni di Change Data Capture.
- Application Integration non supporta gli eventi CDC di Salesforce per le seguenti regioni:
asia-northeast1
asia-south1
australia-southeast1
europe-west2
europe-west3
europe-west6
northamerica-northeast1
southamerica-east1
us-east4
us-west2
Esclusioni SLA
Il trigger Salesforce dipende dal prodotto Salesforce. Poiché questa dipendenza è esterna ad Application Integration, i termini e le condizioni dell'accordo sul livello di servizio (SLA) di Application Integration sono applicabili solo quando il trigger Salesforce avvia correttamente l'esecuzione di un'integrazione active
.
Prezzi
Il trigger Cloud Pub/Sub e il trigger Salesforce non richiedono la creazione di un connettore. Tuttavia, se utilizzi l'attività Connettori per connetterti a Pub/Sub o Salesforce, ti viene addebitato l'utilizzo del connettore. Per informazioni sui prezzi, consulta Prezzi di Application Integration.
Quote e limiti
Per informazioni su quote e limiti, consulta Quote e limiti.
Passaggi successivi
- Scopri di più su tutte le attività e tutti gli attivatori.
- Scopri come testare e pubblicare un'integrazione.
- Scopri di più sulla gestione degli errori.
- Scopri di più sui log di esecuzione dell'integrazione.