Consulta i connettori supportati per Application Integration.
Trigger di Salesforce
L'attivatore Salesforce ti consente di ascoltare Change Data Capture (CDC) o Eventi di Enterprise Messaging Platform. Con questo attivatore, puoi avviare l'integrazione in base a uno qualsiasi degli eventi CDC (Crea, Aggiorna, eliminazione o annullamento eliminazione) o gli eventi piattaforma nell'istanza Salesforce.
Per ulteriori informazioni, vedi i tutorial seguenti:
- Per utilizzare Application Integration al fine di automatizzare il flusso dei processi aziendali del routing e dell'assegnazione di una richiesta di assistenza di un cliente Salesforce, consulta il tutorial Automatizzare le assegnazioni del routing delle richieste Salesforce.
- Per utilizzare l'integrazione delle applicazioni 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 nell'ordine BigQuery.
- Per utilizzare l'attivatore 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 illustra i passaggi necessari per connettere e configurare un'istanza Salesforce da utilizzare. Change Data Capture (CDC) o Eventi Platform per trasferire flussi di modifiche ad Application Integration in modo pub/sub. Completare i seguenti passaggi prima di configurare qualsiasi interfaccia utente per Salesforce un'attività o un trigger in Application Integration:
- Configurare un utente di integrazione
- Configurare un set di autorizzazioni
- Configurare un token di sicurezza
- Creare un'app collegata
Configura un utente di integrazione
Per configurare un utente di integrazione:
- Accedi all'istanza Salesforce con le credenziali di
sysadmin
. - Fai clic sull'icona a forma di ingranaggio e seleziona Configurazione, come mostrato nell'immagine di seguito:
- Fai clic su Utenti > Utenti dal menu Amministrazione.
- Dal riquadro Utenti, seleziona il pulsante Nuovo utente.
- Nella finestra di dialogo User Edit (Modifica utente), inserisci i seguenti dettagli:
- Nome: nome dell'utente di integrazione.
- Cognome: cognome dell'utente di integrazione.
- Indirizzo email: l'indirizzo email dell'utente di integrazione. Idealmente, dovrebbe essere un indirizzo email di gruppo.
- Nome utente: il nome utente conforme alle convenzioni di denominazione a livello di organizzazione.
Se stai creando un nuovo utente di integrazione, utilizza il formato seguente:
EMAIL.SALESFORCE_ORG_NAME.SANDBOX_NAME
Se disponi già di un utente con integrazione, verifica che il nome utente sia stato inserito qui.
- Ruolo: seleziona un'opzione dal menu a discesa.
- Licenza utente: inserisci
Salesforce
oppure, se utilizzi un'organizzazione di prova, inserisciSalesforce Platform
. - Profilo: seleziona dal menu a discesa il profilo di autorizzazioni per gli utenti integrati.
Ti consigliamo di assegnare un profilo senza autorizzazioni per proteggere l'utente di integrazione Accesso a Salesforce da utilizzo non autorizzato.
- Fai clic su Salva.
- Per aggiornare la password per il 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 la procedura di reimpostazione della password dall'account email. Prendi nota della nuova password, perché ti servirà in un secondo momento.
Configura un set di autorizzazioni
Se hai già accesso a un insieme di autorizzazioni appropriato per un utente di integrazione, puoi saltare questo passaggio passaggio e vai a Configurare un token di sicurezza. In caso contrario, segui questi passaggi per configurare un set di autorizzazioni per l'utente di integrazione e l'oggetto Salesforce.
Per configurare un set 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.
È richiesta anche l'autorizzazione Utente solo API, ma non può essere attivata fino a quando non viene fornito il token di sicurezza richiesto viene reimpostato. Questa autorizzazione verrà aggiunta in un passaggio successivo.
- (Facoltativo) Scorri e seleziona Modifica tutti i dati e Visualizza tutti i dati, se applicabile. Queste autorizzazioni non sono necessarie, ma possono essere utili se vuoi concedere automaticamente all'utente di integrazione l'accesso ai nuovi oggetti. I nostri suggerimenti abilitando 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 del set di autorizzazioni per tornare alla pagina di configurazione principale del Set di autorizzazioni.
- Seleziona Impostazioni oggetto dalla sezione App del riquadro Set di autorizzazioni.
- Scorri verso il basso e seleziona gli oggetti Salesforce che richiedono un insieme di autorizzazioni. In questo esempio viene utilizzato l'oggetto Opportunity.
- Fai clic sul pulsante Modifica nella pagina dei dettagli dell'oggetto.
- Seleziona le caselle di controllo per i tipi di record tipi è obbligatorio selezionarli. Se non sai quali tipi di record sono richiesti, selezionali tutti.
- Seleziona le caselle di controllo in corrispondenza delle Autorizzazioni degli oggetti da abilitare. Ti consigliamo le opzioni Leggi e Visualizza tutto.
- Concedi l'accesso in lettura o l'accesso in modifica a ciascun campo dell'oggetto selezionando il corrispondente casella di controllo.
- Scorri fino in cima alla pagina e fai clic su Salva.
Configura 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 direttamente a Creare 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 e poi su Impostazioni.
- Dal menu Settings (Impostazioni), seleziona Reset My Security Token (Reimposta il token di sicurezza) per aprire il riquadro Reset Security Token (Reimposta token di sicurezza).
- Fai clic sul pulsante Reimposta token di sicurezza.
- Cerca nell'account email associato all'utente di integrazione un'email contenente il nuovo token di sicurezza. Prendi nota del nuovo token di sicurezza, perché ti servirà in un passaggio successivo.
- (Facoltativo) Attiva l'autorizzazione Solo utente API in Autorizzazioni di sistema per il tuo insieme di autorizzazioni, come descritto in Configurare un insieme di autorizzazioni sopra.
Creare un'app collegata
Per configurare un'app collegata è necessaria l'autorizzazione di amministrazione di sistema. Se al momento hai eseguito
l'accesso come utente di integrazione, assicurati di uscire e di accedere di nuovo come sysadmin
.
Per configurare un'app collegata:
- Fai clic sull'icona a forma di ingranaggio, quindi seleziona Configurazione.
- Nel menu Configurazione, cerca e seleziona App Manager, come mostrato nell'immagine di seguito:
- Fai clic su Nuova app collegata.
- Nel riquadro di configurazione, fornisci i seguenti dettagli:
- Nome app collegata: inserisci un nome per l'app collegata.
- Nome API: inserisci il nome dell'API.
- Email di contatto: inserisci un indirizzo email per l'app collegata, possibilmente un alias email di gruppo.
- API (Abilita impostazioni OAuth): seleziona Abilita impostazioni OAuth. Quindi, imposta quanto segue:
- (Facoltativo) URL di callback: questo campo è obbligatorio solo se vuoi che un servizio esterno esegua la convalida.
Se scegli di effettuare 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)
- (Facoltativo) URL di callback: questo campo è obbligatorio solo se vuoi che un servizio esterno esegua la convalida.
Se scegli di effettuare un callback, assicurati di includere il prefisso
- Fai clic su Salva.
- Fai clic su Continua. Devi eseguire nuovamente l'autorizzazione con un codice di verifica inviato al tuo indirizzo email.
- Dopo la verifica del codice, nella pagina successiva verranno visualizzati un consumer secret e una consumer key. Prendi nota di questi valori, perché verranno utilizzate durante la configurazione del modulo di autenticazione per Application Integration.
- Fai clic sul pulsante Gestisci.
- Quando ti trovi nella pagina Dettagli app collegata, fai clic sul pulsante Modifica norme.
- Nella sezione Criteri OAuth, modifica il valore del menu a discesa Utenti consentiti. in Gli utenti approvati dall'amministratore sono pre-autorizzati.
- Fai clic su Salva.
- Scorri fino alla sezione Profili e Set di autorizzazioni della pagina per selezionare il profilo o Set di autorizzazioni che vuoi applicare all'app collegata.
- Seleziona il profilo o il set di autorizzazioni che preferisci.
- Fai clic su Salva.
Passaggi prerequisiti per utilizzare gli eventi CDC
Prima di configurare il trigger di Application Integration per utilizzare gli eventi CDC, assicurati di aggiungi 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 Modifica acquisizione dati.
- Nella pagina di configurazione Change Data Capture, individua l'oggetto Salesforce da utilizzare nella Nella colonna Entità disponibili, trascinala 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 l'utilizzo di eventi della piattaforma, completa quanto segue in Salesforce:
- Crea un evento piattaforma
- Aggiorna le autorizzazioni per l'evento della piattaforma
Crea un evento piattaforma
Per creare un evento della piattaforma, segui questi passaggi:
- Accedi all'istanza Salesforce con le credenziali di
sysadmin
. - Fai clic sull'icona a forma di ingranaggio e seleziona Configurazione.
- Nel riquadro di navigazione, cerca Piattaforma e poi fai clic su Eventi piattaforma.
- Nella pagina Eventi 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 il flusso di eventi se una condizione non è soddisfatta.
- Pubblica immediatamente: attiva immediatamente l'evento, senza attendere alcuna convalida.
- (Facoltativo) Stato deployment: seleziona Deployment eseguito se l'evento è pronto per il deployment.
Dopo aver creato i campi personalizzati, nella pagina Eventi piattaforma, nota il valore del valore-chiave Nome API. Il nome dell'oggetto termina con _e, il che significa che l'oggetto Oggetto Evento della piattaforma. Per un oggetto CDC, il nome dell'oggetto termina con _c.
Aggiorna le autorizzazioni per l'evento della piattaforma
Le autorizzazioni impostate devono essere aggiornate per consentire all'utente di integrazione di accedere all'evento della piattaforma appena creato.
Per aggiornare le autorizzazioni, svolgi i seguenti 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 oggetti, abilita le autorizzazioni Lettura e Creazione.
- Fai clic su Salva.
Aggiungi un trigger Salesforce
Per aggiungere un attivatore Salesforce a un'integrazione nuova o esistente:- Nella console Google Cloud, vai alla pagina Application Integration.
- Nel menu di navigazione, fai clic su Integrations (Integrazioni).
Viene visualizzata la pagina Integrazioni, in cui sono elencate 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 dell'integrazione nella barra degli strumenti dell'integrazione.
- Fai clic su Crea.
L'integrazione viene aperta nell'editor dell'integrazione.
- Nella barra di navigazione dell'editor dell'integrazione, 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 gli attivatori disponibili.
- Fai clic e posiziona l'elemento Trigger Salesforce nel designer.
Configura il trigger di Salesforce
Per configurare il trigger di Salesforce, segui questi passaggi:
- Fai clic su Trigger Salesforce nell'editor di integrazione per visualizzare il riquadro di configurazione dell'attivatore.
- Seleziona un'istanza Salesforce dall'elenco a discesa Configurazione istanza Salesforce.
Se non disponi di un'istanza Salesforce, creane una nuova. Per ulteriori informazioni, vedi Crea una nuova istanza Salesforce.
- Seleziona un canale Salesforce dal menu a discesa Configurazione canale Salesforce.
Se non disponi di un canale Salesforce, creane uno nuovo. Per ulteriori informazioni, vedi Crea un nuovo canale Salesforce.
- Se hai scelto CDC come tipo di evento, seleziona uno dei
le seguenti operazioni:
Create
Update
Delete
Undelete
Il trigger viene eseguito solo se si verifica l'operazione specifica o un intervallo.
L'attivatore 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, segui questi passaggi:
- Nelle proprietà modificabili dell'attivatore, fai clic su Seleziona un account Salesforce. configurazione dell'istanza > + Aggiungi una nuova configurazione istanza Salesforce.
- Nella finestra di dialogo Aggiungi la configurazione dell'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
. La seguente immagine mostra il dominio Salesforce: - Profilo di autenticazione: seleziona un profilo di autenticazione.
Se non hai un profilo di autenticazione, creane uno nuovo del Tipo di autenticazione Credenziali della password del proprietario della risorsa OAuth 2.0. Per informazioni sui campi, vedi Credenziali della password del proprietario della risorsa 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 collegata.
- Segreto: inserisci il segreto utente che hai annotato durante la configurazione di un'app collegata.
- Password: inserisci la password utente nel formato
USER_PASSWORDSECURITY_TOKEN
. Sostituisci quanto segue:USER_PASSWORD
: la password utente di Salesforce.SECURITY_TOKEN
: il token di sicurezza 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.
Nell'immagine seguente sono mostrati i campi necessari 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 un account Salesforce. configurazione del canale > + Aggiungi una nuova configurazione del canale Salesforce.
- Nella finestra di dialogo Aggiungi la configurazione del canale Salesforce, inserisci il nome dell'oggetto.
per la proprietà Nome oggetto Salesforce.
Per l'elenco degli oggetti di Salesforce, vedi Oggetti standard in Salesforce. Se hai dubbi sul nome dell'oggetto, contatta l'amministratore Salesforce.
- Fai clic su Aggiungi.
Variabili di output
La risposta dell'attivatore Salesforce è disponibile nelle variabili di output.
Le variabili di output per un evento CDC sono descritte nella seguente tabella:
Variabile | Tipo di dati | Descrizione |
SalesforceTriggerCdcPayload | JSON | Dettagli dell'evento di modifica. |
SalesforceTriggerEvent | JSON | Contiene replayId dell'evento. |
SalesforceTriggerSchema | Stringa | Schema dell'attivatore. |
SalesforceTriggerCdcSnapshot | JSON | Snapshot dell'oggetto dopo l'evento di modifica. Questo campo è disponibile solo per le operazioni Update e Create . |
SalesforceTriggerCdcRecordId | Stringa | Contiene il valore recordId del record aggiornato o aggiunto. Il recordId è un
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
. Il file JSON
contiene oggetti record aggiornati.
Best practice
L'utilizzo dell'attivatore Salesforce è consigliato nei casi in cui vuoi usare le notifiche Salesforce per attivare le integrazioni senza scrivere codice personalizzato per pubblicare gli eventi Salesforce. Qualsiasi modifica di piccola entità ai campi nella richiesta Salesforce attiverà un evento CDC di Salesforce, che attiverà un'integrazione, che può generare un notevole rumore. Valuta la possibilità di utilizzare i filtri degli eventi di modifica per filtrare solo gli eventi CDC richiesti che attivano l'integrazione. L'utilizzo della funzionalità Modifica filtri eventi può contribuire a ridurre il rumore di integrazione e garantire la conformità con le limitazioni della tua licenza.
Allo stesso modo, consigliamo di annullare la pubblicazione di qualsiasi integrazione utilizzando questo attivatore quando l'integrazione non è più necessaria. Fino a quando non viene ritirata o eliminata, l'integrazione continuerà a monitorare gli eventi CDC e della piattaforma Salesforce.
Considerazioni
Prima di utilizzare l'attivatore Salesforce per eseguire l'integrazione, tieni presente quanto segue:
- Salesforce invia in genere un massimo di 100.000 eventi CDC e Platform al giorno. Consulta il tuo Salesforce amministratore di comprendere le limitazioni della tua licenza prima di scegliere gli eventi CDC per l'attivatore di integrazione.
- Se stai pianificando caricamenti collettivi su Salesforce, valuta la possibilità di mettere in pausa la CDC per ridurre il rumore di integrazione e garantire la conformità con le limitazioni della tua licenza.
- La dimensione massima dei messaggi di evento che Salesforce può pubblicare è 1 MB. Per ulteriori informazioni, consulta Modificare le allocazioni di acquisizione dei dati.
- 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
L'attivatore Salesforce dipende dalla strategia Salesforce
prodotto. Poiché questa dipendenza è esterna ad Application Integration, lo strumento Application Integration
I Termini e condizioni dell'Accordo sul livello del servizio (SLA, Service Level Agreement) sono applicabili solo quando il
Il trigger Salesforce avvia correttamente l'esecuzione di un'integrazione active
.
Prezzi
L'attivatore Cloud Pub/Sub e l'attivatore Salesforce non richiedono la creazione di un connettore. Tuttavia, se utilizzi l'attività Connettori per connetterti a Pub/Sub o Salesforce, ti verrà addebitato l'utilizzo del connettore. Per informazioni sui prezzi, vedi 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 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.