Consulta i connettori supportati per Application Integration.

Trigger Salesforce

L'attivatore 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 degli eventi CDC (Create, Update, Delete o Undelete) o agli eventi della piattaforma nella tua istanza Salesforce.

Per ulteriori informazioni, consulta i seguenti tutorial:

Prima di iniziare

Questa sezione illustra i passaggi necessari per connettere e configurare un'istanza Salesforce in modo da utilizzare gli eventi Change Data Capture (CDC) o Platform per trasmettere le modifiche all'integrazione dell'applicazione in modo Pub/Sub. Prima di configurare qualsiasi attività o trigger correlato a Salesforce in Integrazione applicazioni, devi completare i seguenti passaggi:

Configurare un utente di integrazione

Configura un utente di integrazione seguendo questi passaggi:

  1. Accedi all'istanza Salesforce con le tue credenziali sysadmin.
  2. Fai clic sull'icona a forma di ingranaggio e seleziona Configurazione, come mostrato nell'immagine seguente: immagine che mostra la pagina di configurazioneimmagine che mostra la pagina di configurazione
  3. Fai clic su Utenti > Utenti nel menu Amministrazione.
  4. Nel riquadro Utenti, seleziona il pulsante Nuovo utente.
  5. Nella finestra di dialogo Modifica utente, compila i seguenti dettagli:
    1. Nome: il nome dell'utente dell'integrazione.
    2. Cognome: cognome dell'utente di integrazione.
    3. Indirizzo email: indirizzo email dell'utente di integrazione. L'ideale sarebbe un'email di gruppo.
    4. Nome utente: nome utente conforme a qualsiasi convenzione 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 già un utente di integrazione, verifica che il nome utente sia inserito qui.

    5. Ruolo: seleziona un'opzione dal menu a discesa.
    6. Licenza utente: inserisci Salesforce o, se utilizzi un'organizzazione di prova, Salesforce Platform.
    7. Profilo: seleziona il profilo delle autorizzazioni per gli utenti di integrazione dal menu a discesa.

      Ti consigliamo di assegnare un profilo senza autorizzazioni per proteggere l'accesso di integrazione Salesforce da utilizzi non autorizzati.

    8. Fai clic su Salva.
  6. Per aggiornare la password del nuovo utente di integrazione:
    1. Fai clic sul pulsante Reimposta password nel riquadro Utenti. Viene inviata un'email di reimpostazione della password all'indirizzo email associato all'utente.
    2. 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 andare a Configurare 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:

  1. Nel menu Configurazione, fai clic su Utenti > Set di autorizzazioni.
  2. Nel riquadro Set di autorizzazioni, fai clic sul pulsante Nuovo.
  3. 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.
  4. Nell'elenco delle opzioni di impostazione Sistema, scorri verso il basso e seleziona Autorizzazioni di sistema.
  5. Nella pagina Autorizzazioni di sistema, fai clic sul pulsante Modifica.
  6. Scorri verso il basso nell'elenco delle autorizzazioni disponibili e seleziona la casella di controllo API abilitata.

    È richiesta anche l'autorizzazione Utente solo API, ma non può essere attivata finché il token di sicurezza richiesto non viene reimpostato. Questa autorizzazione viene aggiunta in un passaggio successivo.

  7. (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 ai nuovi oggetti. Ti consigliamo di attivare queste autorizzazioni solo per i test in una sandbox.
  8. Scorri fino in cima all'elenco delle autorizzazioni e fai clic su Salva.
  9. Conferma le impostazioni e fai clic su Salva.

Per configurare il set di autorizzazioni per l'oggetto Salesforce:

  1. Fai clic su Panoramica dell'insieme di autorizzazioni per tornare alla pagina di configurazione principale dell'insieme di autorizzazioni.
  2. Seleziona Impostazioni oggetto dalla sezione App del riquadro Set di autorizzazioni.
  3. Scorri verso il basso e seleziona gli oggetti Salesforce che richiedono un insieme di autorizzazioni. Questo esempio utilizza l'oggetto Opportunity.
  4. Fai clic sul pulsante Modifica nella pagina dei dettagli dell'oggetto.
  5. Seleziona le caselle di controllo per i tipi di record. Se conosci i tipi di record obbligatori, selezionali. Se non sai quali tipi di record sono richiesti, selezionali tutti.
  6. Seleziona le caselle di controllo per le Autorizzazioni oggetto da attivare. Consigliamo di utilizzare le opzioni Leggi e Visualizza tutto.
  7. Concedi accesso in lettura o accesso in modifica per ogni campo dell'oggetto selezionando la corrispondente casella di controllo.
  8. Scorri fino in cima alla pagina e fai clic su Salva.

Configurare un token di sicurezza

Se hai già 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 Creare un'app collegata.

In caso contrario, segui i passaggi riportati di seguito per reimpostare il token di sicurezza per l'utente di integrazione:

  1. Accedi a Salesforce come utente di integrazione utilizzando il nome utente e la password impostati in un passaggio precedente.
  2. Nel menu principale, fai clic sull'immagine del profilo, quindi su Impostazioni.
  3. Nel menu Impostazioni, seleziona Reimposta il mio token di sicurezza per aprire il riquadro Reimposta token di sicurezza.
  4. Fai clic sul pulsante Reimposta token di sicurezza.
  5. Controlla l'account email associato all'utente di integrazione per verificare la presenza di un'email contenente il nuovo token di sicurezza. Prendi nota del nuovo token di sicurezza, perché ti servirà in un passaggio successivo.
  6. (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 connessa è 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:

  1. Fai clic sull'icona a forma di ingranaggio e seleziona Impostazione.
  2. Nel menu Configurazione, cerca e seleziona Gestore app, come mostrato nell'immagine seguente: immagine che mostra la pagina di configurazioneimmagine che mostra la pagina di configurazione
  3. Fai clic su Nuova app collegata.
  4. 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'email per l'app collegata, preferibilmente un alias email di gruppo.
    • API (Attiva impostazioni OAuth): seleziona Attiva impostazioni OAuth. Poi imposta quanto segue:
      1. (Facoltativo) URL di callback: è obbligatorio solo se vuoi che la convalida venga eseguita da un servizio esterno. Se scegli di fornire un numero di richiamata, assicurati di includere il prefisso http(s)://.
      2. Ambiti OAuth selezionati: seleziona:
        • Accedere ai tuoi dati e gestirli (API)
        • Eseguire richieste per tuo conto in qualsiasi momento (refresh_token, offline_access)
  5. Fai clic su Salva.
  6. Fai clic su Continua. Devi eseguire nuovamente l'autorizzazione con un codice di verifica inviato al tuo indirizzo email.
  7. Dopo aver verificato il codice, nella pagina successiva vengono visualizzati un segreto cliente e una chiave cliente. Prendi nota di questi valori, poiché verranno utilizzati durante la configurazione del Modulo di autenticazione per l'integrazione dell'applicazione.
  8. Fai clic sul pulsante Gestisci.
  9. Nella pagina Dettagli app collegata, fai clic sul pulsante Modifica criteri.
  10. Nella sezione Criteri OAuth, modifica il valore nel menu a discesa Utenti consentiti impostandolo su Gli utenti approvati dall'amministratore sono preautorizzati.
  11. Fai clic su Salva.
  12. Scorri fino alla sezione Profili e Set di autorizzazioni della pagina per selezionare il profilo o il set di autorizzazioni da applicare all'app collegata.
  13. Seleziona il profilo o il set di autorizzazioni che preferisci.
  14. Fai clic su Salva.

Passaggi preliminari per utilizzare gli eventi CDC

Prima di configurare l'attivatore di integrazione dell'applicazione per utilizzare gli eventi CDC, assicurati di aggiungere un oggetto configurato al CDC in Salesforce:

  1. Accedi a Salesforce come sysadmin.
  2. Fai clic sull'icona a forma di ingranaggio e poi su Configurazione.
  3. Utilizzando il riquadro di navigazione a sinistra, cerca e seleziona Modifica acquisizione dati.
  4. Nella pagina di configurazione Modifica acquisizione dati, individua l'oggetto Salesforce che vuoi utilizzare nella colonna Entità disponibili e trascinalo nella colonna Entità selezionate.
  5. Fai clic su Salva.

Passaggi preliminari per utilizzare gli eventi della piattaforma

Prima di configurare l'attivatore di integrazione dell'applicazione per utilizzare gli eventi della piattaforma, completa i seguenti passaggi in Salesforce:

  • Creare un evento della piattaforma
  • Aggiorna le autorizzazioni per l'evento della piattaforma

Creare un evento della piattaforma

Per creare un evento della piattaforma:

  1. Accedi all'istanza Salesforce con le tue credenziali sysadmin.
  2. Fai clic sull'icona a forma di ingranaggio e seleziona Impostazione.
  3. Nel riquadro di navigazione, cerca Piattaforma e poi fai clic su Eventi della piattaforma.
    4. immagine che mostra un nuovo evento della piattaformaimmagine che mostra un nuovo evento della piattaforma
  4. Nella pagina Eventi della piattaforma, fai clic su Nuovo evento della piattaforma e imposta le seguenti proprietà:
  • Etichetta
  • Etichetta plurale
  • Nome dell'oggetto(questo campo viene compilato automaticamente)
  • Comportamento di pubblicazione Seleziona uno dei seguenti valori:
    • Pubblica dopo commit: ripristina lo streaming di eventi se non è soddisfatta una condizione.
    • Pubblica immediatamente: attiva immediatamente l'evento, senza attendere alcuna convalida.
    Per ulteriori informazioni sul comportamento di pubblicazione, consulta Eventi della piattaforma e transazioni.
  • Stato di implementazione (facoltativo): seleziona Implementato se l'evento è pronto per l'implementazione.
  • Fai clic su Salva.
    • immagine che mostra l'impostazione delle etichette e il comportamento di pubblicazione per un evento della piattaformaimmagine che mostra l'impostazione delle etichette e il comportamento di pubblicazione per un evento della piattaforma
  • Creare campi personalizzati. Per creare i campi personalizzati, fai clic su Nuovo nella sezione Campi personalizzati e relazioni e seleziona il tipo di campo personalizzato. Puoi creare tutti i campi personalizzati necessari.

    • 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 si tratta di un oggetto Evento della piattaforma. Per un oggetto CDC, il nome dell'oggetto termina con _c.

    immagine che mostra i dettagli di un evento della piattaforma salvatoimmagine che mostra i dettagli di un evento della piattaforma salvato

    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:

    1. Nel menu Configurazione, fai clic su Utenti > Set di autorizzazioni.
    2. Nella pagina Set di autorizzazioni, fai clic sull'autorizzazione creata in precedenza.
    3. Fai clic su Impostazioni oggetto > Plural Label of the Platform Event.
    4. Nella sezione Autorizzazioni oggetto, attiva le autorizzazioni Lettura e Creazione.
    5. Fai clic su Salva.
      6. immagine che mostra le autorizzazioni di un evento della piattaformaimmagine che mostra le autorizzazioni di un evento della piattaforma

    Aggiungi un attivatore Salesforce

    Per aggiungere un attivatore Salesforce a un'integrazione nuova o esistente, segui questi passaggi:
    1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

      Vai ad Application Integration

    2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

      Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

    3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

      Se stai creando una nuova integrazione:

      1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
      2. Seleziona una regione per l'integrazione.
      3. 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 di integrazione.
      4. Fai clic su Crea.

      Viene visualizzata l'integrazione nell'editor di integrazione.

    4. Nella barra di navigazione dell'editor di integrazione, fai clic su Attività per visualizzare l'elenco di attività e connettori disponibili.
    5. Seleziona un'integrazione esistente o fai clic su Crea integrazione.
    6. Nell'editor dell'integrazione, fai clic su + Aggiungi un'attività/trigger > Trigger per visualizzare gli attivatori disponibili.
    7. Fai clic e posiziona l'elemento Trigger Salesforce nel designer.

    Configurare l'attivatore Salesforce

    Per configurare l'attivatore Salesforce, svolgi i seguenti passaggi:

    1. Fai clic su Trigger Salesforce nell'editor di integrazione per visualizzare il riquadro di configurazione dell'attivatore.
    2. Seleziona un'istanza Salesforce dal menu a discesa Configurazione istanza Salesforce.

      Se non hai un'istanza Salesforce, creane una nuova. Per saperne di più, consulta Creare una nuova istanza Salesforce.

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

    4. 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 o l'operazione con intervallo specifica.

      L'attivatore Salesforce può essere configurato per una sola operazione. Se vuoi eseguire l'attivatore per più operazioni, crea un attivatore Salesforce per ogni operazione.

    Crea una nuova istanza Salesforce

    Per configurare una nuova istanza Salesforce:

    1. Nelle proprietà modificabili dell'attivatore, fai clic su Seleziona una configurazione dell'istanza Salesforce > + Aggiungi nuova configurazione dell'istanza Salesforce.
    2. 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 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:

        Ottenere il dominio Salesforce in un'istanza Salesforce Ottenere il dominio Salesforce in un'istanza 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 delle risorse OAuth 2.0. Per informazioni sui campi, consulta 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 collegata.
        • Segreto:inserisci il secret consumer che hai annotato quando hai configurato un'app collegata.
        • Password:inserisci la password dell'utente con il formato USER_PASSWORDSECURITY_TOKEN. Sostituisci quanto segue: Ad esempio, se USER_PASSWORD è test-password e SECURITY_TOKEN è 737K27NCa3O6, la password sarà test-password737K27NCa3O6.

        • La seguente immagine mostra i campi necessari per creare un profilo di autenticazione:

        Credenziali della password del proprietario delle risorse OAuth 2.0 Credenziali della password del proprietario delle risorse OAuth 2.0

      • ID organizzazione Salesforce: inserisci l'ID organizzazione dell'istanza Salesforce. Puoi ottenere l'ID dall'amministratore Salesforce.
    3. Fai clic su Aggiungi.

    Creare un nuovo canale Salesforce

    Per configurare un nuovo canale Salesforce:

    1. Nelle proprietà modificabili dell'attivatore, fai clic su Seleziona una configurazione del canale Salesforce > + Aggiungi nuova configurazione del canale Salesforce.
    2. Nella finestra di dialogo Aggiungi configurazione del canale Salesforce, inserisci il nome dell'oggetto per la proprietà Nome dell'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.

    3. 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 tabella seguente:

    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 Istantanea 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 dell'attivatore.
    Il parametro di output per questo trigger è la variabile JSON CdcTriggerPayload. La variabile JSON contiene oggetti record aggiornati.

    Best practice

    L'utilizzo dell'attivatore Salesforce è consigliato nei casi in cui vuoi utilizzare le notifiche di Salesforce per attivare le integrazioni senza scrivere codice personalizzato per pubblicare gli eventi Salesforce. Qualsiasi piccola modifica di un campo nella richiesta Salesforce attiverà un evento CDC di Salesforce e, di conseguenza, un'integrazione, il che può comportare un significativo rumore dell'integrazione. Valuta la possibilità di utilizzare i filtri degli 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à alle limitazioni della licenza.

    Analogamente, ti consigliamo di annullare la pubblicazione di qualsiasi integrazione che utilizza questo attivatore quando 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 un massimo di 100.000 eventi CDC e della piattaforma al giorno. Se acquisti più capacità di eventi della piattaforma da Salesforce, puoi pubblicare oltre 10 milioni di eventi al giorno. Per ulteriori informazioni, consulta Allocazione degli eventi della piattaforma. Contatta l'amministratore di Salesforce per conoscere le limitazioni della licenza prima di scegliere gli eventi CDC per l'attivatore dell'integrazione.
    • Se prevedi di caricare in blocco i dati in Salesforce, ti consigliamo di mettere in pausa la funzionalità CDC per ridurre i problemi di integrazione e garantire la conformità alle limitazioni della licenza.
    • La dimensione massima del messaggio evento che Salesforce può pubblicare è 1 MB. Per ulteriori informazioni, consulta Modificare le allocazioni di acquisizione dei dati.
    • L'integrazione delle applicazioni 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 dal prodotto Salesforce. Poiché questa dipendenza è esterna all'integrazione delle applicazioni, i termini e le condizioni dello Accordo sul livello del servizio (SLA) per l'integrazione delle applicazioni sono applicabili solo quando l'attivatore 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, consulta Prezzi di Application Integration.

    Quote e limiti

    Per informazioni su quote e limiti, consulta Quote e limiti.

    Passaggi successivi