Objets Salesforce

Résumé

Conditions préalables

Pour utiliser le connecteur Salesforce Objects, vous devez disposer d’un nom d’utilisateur et d’un mot de passe de compte Salesforce.

En outre, l’accès à l’API Salesforce doit être activé. Pour vérifier les paramètres d’accès, accédez à votre page Salesforce personnelle, ouvrez les paramètres de votre profil et recherchez et vérifiez que la case à cocher Api Activée est activée. Notez que les comptes d’évaluation Salesforce n’ont pas d’accès à l’API.

Fonctionnalités prises en charge

• Production
• Personnalisé
  • Domaines personnalisés
  • Redirections d’enregistrements CNAME
  • Colonnes de relation

Se connecter à Salesforce Objects à partir de Power Query Desktop

Pour vous connecter aux données Salesforce Objects :

1. Sélectionnez Salesforce Objects dans la liste des connecteurs de données spécifiques au produit, puis sélectionnez Se connecter. Pour plus d’informations, accédez à Où obtenir des données.

2. Dans Salesforce Objects, choisissez l’URL de production si vous utilisez l’URL de production Salesforce (https://www.salesforce.com) pour vous connecter.

   

   Vous pouvez également sélectionner Custom et entrer une URL personnalisée pour vous connecter. Cette URL personnalisée peut être un domaine personnalisé que vous avez créé dans Salesforce, tel que https://contoso.salesforce.com. Vous pouvez également utiliser la sélection d’URL personnalisée si vous utilisez votre propre enregistrement CNAME qui redirige vers Salesforce. Actuellement, les URL personnalisées ne prennent en charge que les domaines salesforce.com et cloudforce.com.

   Remarque

   Les URL Lightning ne sont pas prises en charge.

   Vous pouvez également sélectionner Inclure des colonnes de relation. Cette sélection modifie la requête en incluant des colonnes qui peuvent avoir des relations de clé étrangère avec d’autres tables. Si cette case n’est pas cochée, vous ne voyez pas ces colonnes.

   Une fois que vous avez sélectionné l’URL, sélectionnez OK pour continuer.

3. Sélectionnez Se connecter pour vous connecter à votre compte Salesforce.

   

   Une fois que vous êtes connecté, sélectionnez Connect.

4. Si vous vous connectez pour la première fois à l’aide d’une application spécifique, vous êtes invité à vérifier votre authenticité en entrant un code envoyé à votre adresse e-mail. Vous êtes alors invité à indiquer si vous souhaitez que l’application que vous êtes en train d'utiliser accède aux données. Par exemple, vous êtes invité à autoriser Power BI Desktop à accéder à vos données Salesforce. Sélectionnez Autoriser.

5. Dans la boîte de dialogue Navigateur , sélectionnez les objets Salesforce que vous souhaitez charger. Vous pouvez ensuite sélectionner Charger pour charger les données ou sélectionner Transformer des données pour transformer les données.

Se connecter à Salesforce Objects à partir de Power Query Online

Pour vous connecter aux données Salesforce Objects :

1. Sélectionnez des objets Salesforce dans la liste des connecteurs de données spécifiques au produit, puis sélectionnez Se connecter. Pour plus d’informations, accédez à Où obtenir des données.

2. Dans les objets Salesforce, choisissez l’URL que vous souhaitez utiliser pour vous connecter. Sélectionnez l’URL de production si vous utilisez l’URL de production Salesforce (https://www.salesforce.com) pour vous connecter.

   

   Remarque

   Actuellement, vous devrez peut-être sélectionner l’URL personnalisée , entrer https://www.salesforce.com dans la zone de texte, puis sélectionner Production pour vous connecter à vos données.

   Vous pouvez également sélectionner Custom et entrer une URL personnalisée pour vous connecter. Cette URL personnalisée peut être un domaine personnalisé que vous avez créé dans Salesforce, tel que https://contoso.salesforce.com. Vous pouvez également utiliser la sélection d’URL personnalisée si vous utilisez votre propre enregistrement CNAME qui redirige vers Salesforce.

   Vous pouvez également sélectionner Inclure des colonnes de relation. Cette sélection modifie la requête en incluant des colonnes qui peuvent avoir des relations de clé étrangère avec d’autres tables. Si cette case n’est pas cochée, vous ne voyez pas ces colonnes.

3. Si vous effectuez cette connexion pour la première fois, sélectionnez une passerelle de données locale, si nécessaire.

4. Sélectionnez Se connecter pour vous connecter à votre compte Salesforce. Une fois que vous êtes connecté, sélectionnez Suivant.

5. Dans la boîte de dialogue Navigateur , sélectionnez les objets Salesforce que vous souhaitez charger. Sélectionnez Ensuite Transformer des données pour transformer les données.

Spécification d’une version d’API Salesforce

Nous vous demandons de spécifier une version d’API Salesforce prise en charge pour utiliser le connecteur Salesforce. Pour ce faire, modifiez la requête à l’aide de l’éditeur avancé Power Query. Par exemple : Salesforce.Data("https://login.salesforce.com/", [ApiVersion=48]).

Si vous spécifiez une version que Salesforce ne prend pas en charge, vous rencontrez un message d’erreur indiquant que vous avez spécifié une ApiVersion non prise en charge.

Pour plus d’informations sur les versions et la prise en charge de l’API Salesforce, visitez le site web Salesforce.

Problèmes connus et limitations

• S’il y a des tables manquantes dans les résultats du connecteur Objets Salesforce, une cause peut être que l’ApiVersion doit être spécifiée ou mise à jour vers une version prise en charge par Salesforce. Pour spécifier ou mettre à jour l’ApiVersion, utilisez l’éditeur avancé et ajoutez explicitement le ApiVersion paramètre. Par exemple:

  Source = Salesforce.Data("https://login.salesforce.com/", [ApiVersion = 54.0])

  Salesforce déprécie régulièrement les versions d'API. Veillez donc à spécifier une version d'API supportée par Salesforce.

• Il existe une limite quant au nombre de champs qu’une requête peut contenir. La limite varie en fonction du type des colonnes, du nombre de colonnes calculées, et ainsi de suite. Lorsque vous recevez l’erreur Query is either selecting too many fields or the filter conditions are too complicated , cela signifie que votre requête dépasse la limite. Pour éviter cette erreur, utilisez l’option Sélectionner une requête avancée et spécifiez les champs dont vous avez vraiment besoin.

• Les paramètres de session Salesforce peuvent bloquer cette intégration. Vérifiez que le paramètre verrouiller les sessions sur l'adresse IP d'origine est désactivé.

• L’accès à l’API Salesforce doit être activé. Pour vérifier les paramètres d’accès, accédez aux paramètres de profil de l’utilisateur actuel et recherchez la case à cocher Activé pour l’API .

• Les comptes d’évaluation Salesforce n’ont pas d’accès à l’API.

• Les opérations « Créer un enregistrement » et « Mettre à jour l’enregistrement » ne prennent pas en charge les champs personnalisés de type Picklist (Multi-Select).

• Les URL Lightning ne sont pas prises en charge.

• Les URL personnalisées prennent uniquement en charge les domaines salesforce.com et cloudforce.com. L’utilisation d’autres domaines entraîne une erreur « Arguments non valides ».

• Salesforce limite le nombre de requêtes simultanées qu’un seul compte peut exécuter. Erreur 'INVALID_QUERY_LOCATOR' Il s’agit d’une limite Salesforce et peut être rencontrée lorsqu’il existe plusieurs requêtes simultanées sur Salesforce à l’aide du même compte. Cette limite inclut toutes les applications clientes (pas seulement le connecteur PowerQuery) à l’aide de l’API Salesforce. Pour réduire la probabilité de cette erreur :

  • Vérifiez que le nombre de requêtes Salesforce est conservé au minimum.
  • Utilisez les options disponibles (telles que les dataflows) pour mettre en scène les données à partir de Salesforce.
  • Vérifiez que les autres utilisations de l’API Salesforce avec le même compte ne sont pas planifiées simultanément.

Pour plus d’informations sur les limites d’API internes Salesforce, accédez à Salesforce Developer Limits and Allocations Quick Reference.