|
A partire da gennaio 2021, i tipi di file classici non potranno più essere utilizzati. È possibile effettuare la transizione dei file classici o scaricare un PDF. Ulteriori informazioni

Centro assistenza di Workiva

Connettore per Salesforce

Connettore per Salesforce

  • Ultimo aggiornamento

Con il connettore Salesforce®, puoi utilizzare i comandi per interagire con Salesforce come parte di una catena. Ad esempio, con questo connettore puoi:

  • Caricare, estrarre e cancellare dati in Salesforce tramite SOQL e operazioni in blocco
  • Creare e gestire oggetti Salesforce
  • Aggiornare e creare record in Salesforce

Il connettore interagisce con tutte le versioni di Salesforce Sales Cloud:

  • Salesforce Essentials
  • Salesforce Net Zero Cloud
  • Lightning® Professional
  • Impresa Lightning
  • Lightning Unlimited
Nota: Questo connettore è stato realizzato da Workiva e si collega a un sistema di terze parti. Sebbene il nostro team di assistenza possa aiutare a configurare questo connettore all'interno del tuo spazio di lavoro, non siamo in grado di risolvere i problemi o di fornire assistenza in altro modo per qualsiasi problema che abbia origine al di fuori della piattaforma Workiva.

Requisiti

Per rendere il connettore disponibile all'uso nella tua organizzazione, un amministratore della sicurezza dell'organizzazione deve prima abilitarlo.

Puoi quindi proteggere la tua connessione a Salesforce utilizzando uno dei seguenti metodi:

  • Autenticazione Salesforce OAuth, utilizzando un ID cliente, un segreto e un campo di applicazione
  • Autenticazione di base, utilizzando un nome utente e una password
  • Credenziali del cliente, usando solo un ID cliente e un segreto

Autenticazione OAuth di Salesforce

Per connetterti a Workiva, avrai bisogno dell'ID del cliente e del segreto di Salesforce, nonché dell'ambito OAuth dell'app collegata.

Autenticazione OAuth Inoltre l'autenticazione richiede l'uso di un'applicazione collegata a Salesforce. Per creare questa in Salesforce, imposta l'app e configura le seguenti impostazioni:

  • Per Callback URL, inserisci una delle seguenti opzioni che corrisponda al tuo AppSpot:
    • PROD - https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
    • EMEA - https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
    • APAC - https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • Sotto Selected OAuth Scopes, include Eseguire richieste a tuo nome in qualsiasi momento (refresh_token, offline_access) e almeno un altro ambito.

Autenticazione di base

Per connetterti a Workiva, devi avere il nome utente dell'integrazione , la password e il token di sicurezza di Salesforce.

L'autenticazione di base richiede un utente dell'integrazione con permessi abilitati all'API, oltre ai permessi relativi alle attività che il connettore eseguirà.

Nota: Per impostare i permessi dell'utente dell'integrazione in Salesforce, seleziona Administer, Manage Users, Profiles, e seleziona il suo profilo.
  1. In Permessi amministrativi, seleziona API Enabled.
  2. Per consentire al connettore di eseguire un comando, l'utente deve avere almeno i permessi di Lettura dei dati correlati. 
  3. Per eseguire aggiornamenti massivi di oggetti Salesforce, l'utente ha bisogno dei permessi di Modifica dell'oggetto.

Autenticazione delle credenziali del cliente

Per connetterti a Workiva, avrai bisogno del client ID e del segreto di Salesforce.

L'autenticazione con le credenziali del cliente richiede l'uso di un'app collegata a Salesforce. Per creare questo in Salesforce, imposta l'app utilizzando il flusso delle credenziali del cliente.

Configurare il connettore Salesforce per l'autenticazione OAuth

L'autenticazione OAuth ti permette di accedere a Salesforce utilizzando un ID e un segreto del cliente. A differenza del metodo di login con credenziali client, l'autenticazione OAuth include un token di aggiornamento e richiede un ambito.

Questo metodo è consigliato per i comandi più lunghi che altrimenti andrebbero in timeout utilizzando il metodo delle credenziali del cliente.

  1. Da Builder catena, clicca su Connessioni compare_arrows e poi su Crea in alto a destra.
  2. In Connector Connection, seleziona Salesforce e il CloudRunner predefinito.
  3. In Informazioni di base, inserisci un nome e una descrizione unici per identificare il connettore.
  4. In Properties, inserisci l'istanza Salesforce o il dominio personalizzato a cui connetterti:
    Proprietà Informazioni
    Istanza Inserisci l'istanza Salesforce a cui connetterti. Se la tua organizzazione utilizza un dominio Salesforce personalizzato, lascia in bianco.
    Nota: Nell'URL di Salesforce, i caratteri prima di salesforce.com- come na73- rappresentano l'istanza.
    Dominio personalizzato Inserisci il dominio Salesforce personalizzato a cui connetterti, se utilizzato.
    Nota: Per visualizzare il tuo dominio personalizzato in Salesforce, seleziona Impostazioni dell'azienda, Il mio dominio. Un dominio personalizzato di solito termina con .my.salesforce.com.
  5. Per il Tipo di autenticazione, seleziona Salesforce OAuth.
  6. Inserisci l'ID cliente, il segreto e l'ambito in Autenticazione, poi clicca su Connetti.2024-06-10_11-51-18.png
    Nota: Quando la connessione a Salesforce va a buon fine, il Token di aggiornamento e il Token di accesso del connettore vengono automaticamente visualizzati. Se la connessione fallisce, clicca su Interrompi e attendi di connetterti di nuovo.
    Nota: Tutte le credenziali sensibili vengono automaticamente crittografate e memorizzate con crittografia AES-256.
  7. Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
  8. Per testare la connessione, crea ed esegui una catena con il comando List Reports del connettore e verifica che restituisca un output valido.

Configurare il connettore Salesforce per l'autenticazione di base

L'autenticazione di base ti permette di accedere a Salesforce utilizzando il nome utente e la password di un utente dell'integrazione.

  1. Da Builder catena, clicca su Connessioni compare_arrows e poi su Crea in alto a destra.
  2. In Connector Connection, seleziona Salesforce e il CloudRunner predefinito.
  3. In Informazioni di base, inserisci un nome e una descrizione unici per identificare il connettore.
  4. In Properties, inserisci l'istanza Salesforce o il dominio personalizzato a cui connetterti:
    Proprietà Informazioni
    Istanza Inserisci l'istanza Salesforce a cui connetterti. Se la tua organizzazione utilizza un dominio Salesforce personalizzato, lascia in bianco.
    Nota: Nell'URL di Salesforce, i caratteri prima di salesforce.com- come na73- rappresentano l'istanza.
    Dominio personalizzato Inserisci il dominio Salesforce personalizzato a cui connetterti, se utilizzato.
    Nota: Per visualizzare il tuo dominio personalizzato in Salesforce, seleziona Impostazioni dell'azienda, Il mio dominio. Un dominio personalizzato di solito termina con .my.salesforce.com.
  5. Per Tipo di autenticazione, seleziona Basic Auth.
  6. In Autenticazione, inserisci il nome utente, la password e il token di sicurezza dell'utente dell'integrazione.2024-06-10_11-41-07.png
    Nota: Tutte le credenziali sensibili vengono automaticamente crittografate e memorizzate con la crittografia Advanced Encryption Standard (AES)-256.
  7. Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
  8. Per testare la connessione, crea ed esegui una catena con il comando List Reports del connettore e verifica che restituisca un output valido.

Configurare il connettore Salesforce per le credenziali del cliente

L'autenticazione con credenziali del cliente ti permette di accedere a Salesforce utilizzando un ID e un segreto del cliente. Questo metodo si differenzia dal metodo di login OAuth perché non richiede un ambito e non è necessario autenticarsi in Salesforce attraverso il pulsante Connect. 

Avviso: Questo metodo di autenticazione non include un token di aggiornamento. Per questo motivo, non è adatto a comandi di lunga durata e può causare timeout in alcune catene.
  1. Da Builder catena, clicca su Connessioni compare_arrows e poi su Crea in alto a destra.
  2. In Connector Connection, seleziona Salesforce e il CloudRunner predefinito.
  3. In Informazioni di base, inserisci un nome e una descrizione unici per identificare il connettore.
  4. In Properties, inserisci l'istanza Salesforce o il dominio personalizzato a cui connetterti:
    Proprietà Informazioni
    Istanza Inserisci l'istanza Salesforce a cui connetterti. Se la tua organizzazione utilizza un dominio Salesforce personalizzato, lascia in bianco.
    Nota: Nell'URL di Salesforce, i caratteri prima di salesforce.com- come na73- rappresentano l'istanza.
    Dominio personalizzato Inserisci il dominio Salesforce personalizzato a cui connetterti, se utilizzato.
    Nota: Per visualizzare il tuo dominio personalizzato in Salesforce, seleziona Impostazioni dell'azienda, Il mio dominio. Un dominio personalizzato di solito termina con .my.salesforce.com.
  5. Per Tipo di autenticazione, seleziona Credenziali del cliente.2024-06-10_12-32-47.png
  6. In Autenticazione, inserisci l'ID e il segreto del cliente.
    Nota: Tutte le credenziali sensibili vengono automaticamente crittografate e memorizzate con crittografia AES-256.
  7. Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
  8. Per verificare la connessione, crea ed esegui una catena con il comando List Reports del connettore e verifica che restituisca un output valido.

Risoluzione dei problemi

Se la connessione a Salesforce fallisce, puoi verificare diverse impostazioni di configurazione, a seconda del tipo di autenticazione.

Autenticazione OAuth2

Se la connessione all'app collegata a Salesforce fallisce quando fai clic per la prima volta su Connetti, fai clic su Interrompi e attendi di connetterti di nuovo. Se la connessione continua a non funzionare utilizzando l'autenticazione OAuth2:

  • Verifica che l'istanza o il dominio personalizzato di Salesforce siano corretti per il connettore.
  • Verifica l'ID e il segreto del client dell'app collegata a Salesforce che il connettore utilizza.
  • Nell'app collegata a Salesforce:
    • Verifica che l'URL di callback sia:
      • PROD - https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
      • EMEA - https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
      • APAC - https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
    • Assicurati che gli ambiti OAuth selezionati includano Eseguire richieste a tuo nome in qualsiasi momento (refresh_token, offline_access) e almeno un altro ambito.

Se il connettore perde la connessione all'applicazione Salesforce:

  1. Da Chains, clicca su Connections compare_arrows, seleziona il connettore e clicca su Edit.
  2. Sotto OAuth, clicca su Reset.
  3. Per abilitare il connettore alla connessione a Salesforce, clicca su Consenti.

Autenticazione di base

Se la connessione non funziona con l'autenticazione di base:

  • Verifica le credenziali di accesso e il token di sicurezza dell'utente dell'integrazione. Per richiedere un nuovo token di sicurezza in Salesforce, accedi come utente dell'integrazione, seleziona Settings, My Personal Information e clicca su Reset security token.
  • Verifica che l'istanza o il dominio personalizzato di Salesforce siano corretti per il connettore.
  • Assicurati che l'utente dell'integrazione abbia i permessi API Enabled, oltre ai permessi relativi alle attività svolte dal connettore.

Autenticazione con credenziali del client

Se la connessione non riesce a utilizzare l'autenticazione tramite credenziali client:

  • Verifica che l'istanza o il dominio personalizzato di Salesforce siano corretti per il connettore.
  • Controlla l'ID e il segreto del client dell'app collegata a Salesforce che il connettore utilizza.
Questo articolo ti è stato utile?
Utenti che ritengono sia utile: 1 su 1
Con il connettore Salesforce®, puoi utilizzare i comandi per interagire con Salesforce come parte di una catena. Ad e...