|
Les types de fichiers classiques ne pourront plus être utilisés à partir de janvier 2021. Vous pouvez transférer vos fichiers classiques ou télécharger un PDF. En savoir plus

Portail de support Workiva

Connecteur vers Salesforce

Connecteur vers Salesforce

  • Dernière mise à jour le

Avec le connecteur Salesforce®, vous pouvez utiliser les commandes pour interagir avec Salesforce dans le cadre d'une chaîne. Par exemple, avec ce connecteur, vous pouvez :

  • Charger, extraire et supprimer des données dans Salesforce via SOQL et des opérations en masse
  • Créer et gérer des objets Salesforce
  • Mettre à jour et créer des enregistrements dans Salesforce

Le connecteur interagit avec toutes les versions de Salesforce Sales Cloud :

  • Les essentiels de Salesforce®
  • Salesforce Net Zero Cloud
  • Lightning® Professionnel
  • Lightning Enterprise
  • Lightning Unlimited
Note: Ce connecteur est construit par Workiva et se connecte à un système tiers. Bien que notre équipe d'assistance puisse vous aider à configurer ce connecteur dans votre espace de travail, nous ne sommes pas en mesure de dépanner ou d'aider à résoudre des problèmes qui proviennent de l'extérieur de la plateforme Workiva.

Exigences

Pour que le connecteur puisse être utilisé dans votre organisation, un administrateur de sécurité org doit d'abord l'activer.

Vous pouvez ensuite sécuriser votre connexion à Salesforce en utilisant l'une des méthodes suivantes :

  • Authentification Salesforce OAuth, à l'aide d'un identifiant client, d'un secret et d'un champ d'application
  • Authentification de base, à l'aide d'un nom d'utilisateur et d'un mot de passe
  • Identifiants client, en utilisant uniquement un identifiant client et une clé secrète
     

Authentification OAuth de Salesforce

Pour vous connecter à Workiva, vous aurez besoin de l'ID client et du secret de Salesforce, ainsi que de la portée OAuth de l'application connectée.

L'authentification OAuth nécessite en outre l'utilisation d'une application connectée à Salesforce. Pour la créer dans Salesforce, rendez-vous sur , installez l'application, puis configurez les paramètres obligatoires suivants :

  • Pour l'URL de rappel « » (), saisissez l'une des valeurs suivantes correspondant à votre AppSpot :
    • États-Unis, Amérique centrale, Amérique du 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
  • Sous Selected OAuth Scopes, incluez Perform requests on your behalf at any time (refresh_token, offline_access) et at least one other scope.
     

authentification de base|authentification de base

Pour vous connecter à Workiva, vous aurez besoin du nom d'utilisateur de l'utilisateur d'intégration , de son mot de passe et du jeton de sécurité de Salesforce.

L'authentification de base nécessite un utilisateur d'intégration disposant d'autorisations API, en plus des autorisations liées à toutes les tâches que le connecteur effectuera.

Remarque : Pour définir les autorisations de l'utilisateur d'intégration dans Salesforce, sélectionnez Administer, Manage Users, Profiles, et sélectionnez son profil.
  1. Sous « Autorisations administratives » ( ), sélectionnez « API de l'activée » ( API Enabled).
  2. Pour permettre au connecteur d'exécuter une commande, l'utilisateur doit disposer au minimum de l'autorisation Read sur les données correspondantes. 
  3. Pour effectuer des mises à jour en masse des objets Salesforce, l'utilisateur doit disposer des autorisations Edit pour l'objet.
     

Authentification du client

Pour vous connecter à Workiva, vous aurez besoin de l'ID client et du secret de Salesforce.

L'authentification par identifiants client nécessite l'utilisation d'une application connectée à Salesforce. Pour la créer dans Salesforce, , configurez l'application à l'aide du flux d'authentification par identifiants client .

 

Configurer le connecteur Salesforce pour l'authentification OAuth

L'authentification OAuth vous permet d'accéder à Salesforce à l'aide d'un identifiant et d'un secret client. Contrairement à la méthode de connexion par identifiant client, l'authentification OAuth comprend un jeton de rafraîchissement et nécessite un champ d'application.

Cette méthode est recommandée pour les commandes de longue durée qui risqueraient d'être interrompues par la méthode des informations d'identification du client.

  1. Depuis , dans la section « Chain Builder » (), cliquez sur compare_arrows « Connections » ( ) dans la barre latérale gauche, puis sur compare_arrows « Create » ( ) en haut à droite.
  2. Sous Connector Connection, sélectionnez Salesforce et le CloudRunner par défaut.
  3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier le connecteur.

  4. Sous « Propriétés d'» ( Properties), saisissez l'instance Salesforce ou le domaine personnalisé auquel vous souhaitez vous connecter :

    Propriété Détails
    Instance

    Saisissez l'instance Salesforce à laquelle vous souhaitez vous connecter. Si votre organisation utilise un domaine Salesforce personnalisé, ne remplissez pas ce champ.

    Remarque : Dans votre URL Salesforce, les caractères précédant salesforce.com- tels que na73- représentent l'instance.
    Domaine personnalisé

    Saisissez le domaine Salesforce personnalisé auquel se connecter, le cas échéant.

    Remarque : Pour afficher votre domaine personnalisé dans Salesforce, sélectionnez Company Settings, My Domain. Un domaine personnalisé se termine généralement par .my.salesforce.com.
  5. Pour le type d'authentification, sélectionnez Salesforce OAuth.

  6. Saisissez l'ID client, la clé secrète et la portée dans la section « Authentification » ( ), puis cliquez sur « Se connecter » ( ).
    2024-06-10_11-51-18.png

    Remarque : Une fois la connexion à Salesforce établie, le jeton d'actualisation et le jeton d'accès du connecteur s'affichent automatiquement. Si la connexion échoue, cliquez sur Stop et attendez de vous reconnecter.
    Note : Toutes les données d'identification sensibles sont automatiquement cryptées et stockées avec un cryptage AES-256.
  7. Sélectionnez les environnements à utiliser avec la connexion et cliquez sur enregistrer.
  8. Pour tester la connexion, créez et exécutez une chaîne avec la commande List Reports du connecteur et vérifiez qu'elle renvoie un résultat valide.

Configurer le connecteur Salesforce pour l'authentification de base

L'authentification de base vous permet de vous connecter à Salesforce en utilisant le nom d'utilisateur et le mot de passe d'un utilisateur d'intégration.

  1. Depuis , dans la section « Chain Builder » (), cliquez sur compare_arrows « Connections » ( ) dans la barre latérale gauche, puis sur compare_arrows « Create » ( ) en haut à droite.
  2. Sous Connector Connection, sélectionnez Salesforce et le CloudRunner par défaut.
  3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier le connecteur.

  4. Sous « Propriétés d'» ( Properties), saisissez l'instance Salesforce ou le domaine personnalisé auquel vous souhaitez vous connecter :

    Propriété Détails
    Instance

    Saisissez l'instance Salesforce à laquelle vous souhaitez vous connecter. Si votre organisation utilise un domaine Salesforce personnalisé, laissez le champ vide.

    Remarque : Dans votre URL Salesforce, les caractères précédant salesforce.com- tels que na73- représentent l'instance.
    Domaine personnalisé

    Saisissez le domaine Salesforce personnalisé auquel se connecter, le cas échéant.

    Remarque : Pour afficher votre domaine personnalisé dans Salesforce, sélectionnez Company Settings, My Domain. Un domaine personnalisé se termine généralement par .my.salesforce.com.
  5. Pour le type d'authentification, sélectionnez Basic Auth.

  6. Sous Authentication, saisissez le nom d'utilisateur, le mot de passe et le jeton de sécurité de l'utilisateur d'intégration.2024-06-10_11-41-07.png

    Note : toutes les informations d’identification sensibles sont automatiquement chiffrées et stockées avec un chiffrement Advanced Encryption Standard (AES)-256.
  7. Sélectionnez les environnements à utiliser avec la connexion et cliquez sur enregistrer.
  8. Pour tester la connexion, créez et exécutez une chaîne avec la commande List Reports du connecteur et vérifiez qu'elle renvoie un résultat valide.
     

Configurer le connecteur Salesforce pour les informations d'identification du client

L'authentification des informations d'identification du client vous permet d'accéder à Salesforce à l'aide d'un identifiant et d'un secret client. Cette méthode diffère de la méthode de connexion OAuth en ce sens qu'elle ne nécessite pas de champ d'application et que vous n'aurez pas besoin de vous authentifier dans Salesforce via le bouton Connect. 

Avertissement: Cette méthode d'authentification n'inclut pas de jeton de rafraîchissement. Pour cette raison, il n'est pas adapté aux commandes de longue durée et peut entraîner des dépassements de délai dans certaines chaînes.
  1. Depuis , dans la section « Chain Builder » (), cliquez sur compare_arrows « Connections » ( ) dans la barre latérale gauche, puis sur compare_arrows « Create » ( ) en haut à droite.
  2. Sous Connector Connection, sélectionnez Salesforce et le CloudRunner par défaut.
  3. Sous Informations de base, entrez un nom et une description uniques pour aider à identifier le connecteur.

  4. Sous « Propriétés d'» ( Properties), saisissez l'instance Salesforce ou le domaine personnalisé auquel vous souhaitez vous connecter :

    Propriété Détails
    Instance

    Saisissez l'instance Salesforce à laquelle vous souhaitez vous connecter. Si votre organisation utilise un domaine Salesforce personnalisé, laissez le champ vide.

    Remarque : Dans votre URL Salesforce, les caractères précédant « salesforce.com » — tels que « na73» — correspondent à l'instance.
    Domaine personnalisé

    Saisissez le domaine Salesforce personnalisé auquel se connecter, le cas échéant.

    Remarque : Pour afficher votre domaine personnalisé dans Salesforce, sélectionnez Company Settings, My Domain. Un domaine personnalisé se termine généralement par .my.salesforce.com.
  5. Pour le type d'authentification, sélectionnez Client Credentials.2024-06-10_12-32-47.png

  6. Sous Authentication, entrez l'ID et le secret du client.

    Note : Toutes les données d'identification sensibles sont automatiquement cryptées et stockées avec un cryptage AES-256.
  7. Sélectionnez les environnements à utiliser avec la connexion et cliquez sur enregistrer.
  8. Pour tester la connexion, créez et exécutez une chaîne avec la commande List Reports du connecteur et vérifiez qu'elle renvoie un résultat valide.

Dépannage

Si la connexion à Salesforce échoue, vous pouvez vérifier plusieurs paramètres de configuration, en fonction du type d'authentification.

 

Authentification OAuth2

Si la connexion à l'application Salesforce connectée échoue lorsque vous cliquez pour la première fois sur Connect, cliquez sur Stop, et attendez de vous reconnecter. Si la connexion continue d'échouer avec l'authentification OAuth2 :

  • Vérifiez que l'instance Salesforce ou le domaine personnalisé est correct pour le connecteur.
  • Vérifiez l'ID client et le secret de l'application connectée à Salesforce utilisée par le connecteur.
  • Dans l'application connectée de Salesforce :
    • Vérifiez que l'URL de rappel est correcte :
    • Pour les États-Unis, l'Amérique centrale et l'Amérique du Sud : https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
    • Pour la région APAC : https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
    • Pour le Canada : https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
    • Pour la région EMEA : https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
    • Assurez-vous que les champs d'application OAuth sélectionnés incluent Effectuer des demandes en votre nom à tout moment (refresh_token, offline_access) et au moins un autre champ d'application.

Si le connecteur perd sa connexion à l'application Salesforce :

  1. Depuis Chain Builder, cliquez sur compare_arrows Connections dans la barre latérale gauche, puis cliquez sur Edit (icône en forme de crayon) pour la connexion.
  2. Sous OAuth, cliquez sur Reset.
  3. Pour permettre au connecteur de se connecter à Salesforce, cliquez sur Allow.
     

authentification de base|authentification de base

Si la connexion échoue avec l'authentification de base :

  • Vérifier les informations d'identification et le jeton de sécurité de l'utilisateur de l'intégration. Pour demander un nouveau jeton de sécurité dans Salesforce, connectez-vous en tant qu'utilisateur de l'intégration et sélectionnez Paramètres, Mes informations personnelles, puis cliquez sur Réinitialiser le jeton de sécurité.
  • Vérifiez que l'instance Salesforce ou le domaine personnalisé est correct pour le connecteur.
  • Assurez-vous que l'utilisateur de l'intégration dispose des autorisations API Enabled, en plus des autorisations liées à toutes les tâches effectuées par le connecteur.
     

Authentification du client

Si la connexion échoue lors de l'authentification du client :

  • Vérifiez que l'instance Salesforce ou le domaine personnalisé est correct pour le connecteur.
  • Vérifiez l'ID client et le secret de l'application connectée à Salesforce utilisée par le connecteur.
Avec le connecteur Salesforce®, vous pouvez utiliser les commandes pour interagir avec Salesforce dans le cadre d'une...