Connecteur vers Salesforce

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
Informations d'identification du client, en utilisant uniquement un identifiant et un secret du client

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.

Authentification OAuth L'authentification supplémentaire nécessite l'utilisation d'une application connectée à Salesforce. Pour créer cette application dans Salesforce, configurez l'application et définissez les paramètres requis suivants :

Pour Callback URL, entrez un des éléments suivants qui correspond à votre 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
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.

Sous Administrative Permissions, sélectionnez API Enabled.
Pour permettre au connecteur d'exécuter une commande, l'utilisateur doit disposer au minimum de l'autorisation Read sur les données correspondantes.
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 des informations d'identification du client nécessite l'utilisation d'une application connectée à Salesforce. Pour créer cette application dans Salesforce, configure l'application à l'aide du flux d'informations d'identification du 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.

À partir du Générateur de chaînes, cliquez sur Connexions compare_arrows, puis sur Créer en haut à droite.
Sous Connector Connection, sélectionnez Salesforce et le CloudRunner par défaut.
Sous Informations de base, entrez un nom et une description uniques pour aider à identifier le connecteur.

Sous Properties, entrez l'instance Salesforce ou le domaine personnalisé auquel se 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`.

Pour le type d'authentification, sélectionnez Salesforce OAuth.
Saisissez l'ID, le secret et l'étendue du client sous Authentication, puis cliquez sur Connect.
Remarque : Lorsque la connexion à Salesforce aboutit, les jetons de rafraîchissement et les jetons d'accès sont automatiquement renseignés. 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.
Sélectionnez les environnements à utiliser avec la connexion et cliquez sur enregistrer.
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.

À partir du Générateur de chaînes, cliquez sur Connexions compare_arrows, puis sur Créer en haut à droite.
Sous Connector Connection, sélectionnez Salesforce et le CloudRunner par défaut.
Sous Informations de base, entrez un nom et une description uniques pour aider à identifier le connecteur.

Sous Properties, entrez l'instance Salesforce ou le domaine personnalisé auquel se 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`.

Pour le type d'authentification, sélectionnez Basic Auth.
Sous Authentication, saisissez le nom d'utilisateur, le mot de passe et le jeton de sécurité de l'utilisateur d'intégration.
Note : Toutes les données d'identification sensibles sont automatiquement cryptées et stockées avec un cryptage Advanced Encryption Standard (AES)-256.
Sélectionnez les environnements à utiliser avec la connexion et cliquez sur enregistrer.
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.

À partir du Générateur de chaînes, cliquez sur Connexions compare_arrows, puis sur Créer en haut à droite.
Sous Connector Connection, sélectionnez Salesforce et le CloudRunner par défaut.
Sous Informations de base, entrez un nom et une description uniques pour aider à identifier le connecteur.

Sous Properties, entrez l'instance Salesforce ou le domaine personnalisé auquel se 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`.

Pour le type d'authentification, sélectionnez Client Credentials.
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.
Sélectionnez les environnements à utiliser avec la connexion et cliquez sur enregistrer.
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érifier que l'URL de rappel est :
  - 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
- 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 :

À partir de Chains, cliquez sur Connections compare_arrows, sélectionnez le connecteur et cliquez sur Edit.
Sous OAuth, cliquez sur Reset.
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.

Support

Communauté

Portail de support Workiva