Centro assistenza di Workiva

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 client, utilizzando solo un ID client e un codice 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.

L'autenticazione OAuth richiede inoltre l'uso di un'app collegata a Salesforce. Per crearla in Salesforce, , configurare l'app e impostare le seguenti impostazioni obbligatorie:

• Per l'URL di callback di " " (), inserisci uno dei seguenti valori corrispondente al tuo AppSpot:
  • Stati Uniti, America Centrale, America del Sud: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • APAC: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • Canada: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • EMEA: https://h.eu.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), selezionare “ API Enabled” (API di abilitata).
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 con credenziali del client

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

L'autenticazione tramite credenziali del cliente richiede l'uso di un'app collegata a Salesforce. Per crearla in Salesforce, configurare l'app utilizzando il flusso di 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 Chain Builder, clicca su compare_arrows Connections nella barra laterale sinistra, quindi su compare_arrows Create 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. Nella sezione "Proprietà" ( ), inserisci l'istanza di Salesforce o il dominio personalizzato a cui desideri collegarti:

   Proprietà	Informazioni
   Istanza	Inserisci l'istanza Salesforce a cui connetterti. Se la tua organizzazione utilizza un dominio Salesforce personalizzato, lascia questo campo vuoto. 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, la chiave segreta e l'ambito nella sezione " " (Autenticazione), quindi fai clic su " " (Connetti).
   

   Nota: Quando la connessione a Salesforce va a buon fine, il token di aggiornamento del connettore e il token di accesso vengono compilati automaticamente. 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 verificare 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 Chain Builder, clicca su compare_arrows Connections nella barra laterale sinistra, quindi su compare_arrows Create 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. Nella sezione "Proprietà" ( ), inserisci l'istanza di Salesforce o il dominio personalizzato a cui desideri collegarti:

   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.

   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 verificare 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 Chain Builder, clicca su compare_arrows Connections nella barra laterale sinistra, quindi su compare_arrows Create 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. Nella sezione "Proprietà" ( ), inserisci l'istanza di Salesforce o il dominio personalizzato a cui desideri collegarti:

   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 che precedono salesforce.com —ad esempio 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.

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 corretto:
  • Per gli Stati Uniti, l'America Centrale e il Sudamerica: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  • Per l'area APAC: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
  • Per il Canada: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
  • Per l'area EMEA: https://h.eu.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 Chain Builder, clicca su compare_arrows Connections nella barra laterale sinistra, quindi clicca su Modifica (icona a forma di matita) per la connessione.
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.