Salesforce

Ce connecteur est disponible dans les produits et régions suivants :

Service	classe	Régions
Copilot Studio	Premium	Toutes les régions Power Automate , à l’exception des éléments suivants :      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)
Applications logiques	Norme	Toutes les régions Logic Apps , à l’exception des suivantes :      - Us Department of Defense (DoD)
Power Apps	Premium	Toutes les régions Power Apps , à l’exception des suivantes :      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)
Power Automate	Premium	Toutes les régions Power Automate , à l’exception des éléments suivants :      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)

Métadonnées du connecteur
Éditeur	Microsoft

Pour utiliser cette intégration, vous devez accéder à un compte Salesforce avec l’accès à l’API activé. Pour voir quelles éditions Salesforce ont accès à l’API, consultez l’article Salesforce. Pour établir une connexion, sélectionnez Se connecter. Vous serez invité à fournir votre connexion Salesforce, suivez le reste des écrans pour créer une connexion. La version d’API par défaut actuellement utilisée par le connecteur est v58.0.

Vous êtes maintenant prêt à commencer à utiliser cette intégration.

Problèmes connus et limitations

1. 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, etc. Lorsque vous recevez une erreur « Requête sélectionne trop de champs ou que les conditions de filtre sont trop compliquées », cela signifie que votre requête dépasse la limite. Pour éviter cela, utilisez l’option avancée « Sélectionner une requête » et spécifiez les champs dont vous avez vraiment besoin.
2. Les paramètres de session Salesforce peuvent bloquer cette intégration. Vérifiez que le paramètre « Verrouiller les sessions sur l’adresse IP à partir de laquelle elles proviennent » est désactivée.
3. 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 « API Activée ».
4. Les comptes d’évaluation Salesforce n’ont pas d’accès à l’API et ne peuvent donc pas être utilisés.
5. Les champs personnalisés de type « Picklist (Multi-Select) » ne sont pas pris en charge par les actions Créer un enregistrement et Mettre à jour (V3) ( y compris leurs versions dépréciées respectives).
6. La création d’une connexion à l’aide de la connexion Salesforce « Domaine personnalisé » n’est pas prise en charge.
7. L’utilisation de champs nullables dans Order By le paramètre doit être évitée, car cela peut entraîner une erreur d’exécution dans les opérations suivantes : Obtenir des enregistrements, Lorsqu’un enregistrement est créé, lorsqu’un enregistrement est créé ou modifié.
8. Lorsqu’un enregistrement est modifié , le déclencheur ne peut détecter que la modification d’enregistrement de l’objet standard, mais ne peut pas détecter la modification de pièce jointe de l’objet standard.
9. Les déclencheurs et actions suivants n’ont pas pu fonctionner correctement sur une table personnalisée sans colonne « ID » : lorsqu’un enregistrement est crééou modifié, obtenir un enregistrement, créer un enregistrement, mettre à jour l’enregistrement (V3) et Supprimer un enregistrement.
10. Lorsqu’un enregistrement est créé ou modifié, le déclencheur retourne à la fois des éléments nouveaux et modifiés. Pour vérifier si un élément retourné est nouveau ou modifié, comparez ses valeurs de champ « CreatedDate » et « LastModifiedDate ». Sur les nouveaux éléments, ces valeurs sont censées être égales. À cet égard, les deux champs sont obligatoires pour les éléments pour lesquels ce déclencheur est appliqué.
11. Les objets complexes (objets avec objets imbriqués, voir l’exemple ci-dessous) ne sont pas pris en charge par Créer un enregistrement et mettre à jour un enregistrement (V3) ( y compris leurs versions déconseillées respectives). Pour contourner cette limitation, les structures d’objets plats doivent être utilisées.
12. Exécutez une requête SOQL et obtenez des actions d’enregistrement basées sur l’API « Requête ». Par conséquent, tous les enregistrements ne peuvent pas être retournés en raison des limitations de l’API (par exemple, les éléments supprimés).
13. Si vous rencontrez un problème lié à la définition de la valeur par défaut des données à l’aide de l’enregistrement de mise à jour (V3), cela est dû à l’en-tête « sforce-auto-assign » défini sur true. Pour contourner ce problème, il est recommandé d’utiliser Envoyer une action de requête HTTP et de définir la valeur d’en-tête personnalisée « sforce-auto-assign : false »
14. Le connecteur Salesforce dispose d’une gestion spéciale de l’authentification toutefois en raison d’une limitation sur le back-end Salesforce, les jetons expirent s’ils ne sont pas utilisés pendant une longue période et les utilisateurs peuvent rencontrer une erreur « Bad_OAuth_Token/Session expirée ou non valide ». Reconnectez-vous avec vos informations d’identification.
    • Cette limitation est désormais traitée, mais une nouvelle connexion doit être créée pour une utilisation. La connexion préexistante fonctionne toujours, mais le problème ci-dessus peut être rencontré.

Exemple d’objet complexe qui n’est pas pris en charge, car il a un objet imbriqué avec MerchandiseExtID__c champ :

{
    "Name" : "LineItemCreatedViaExtID",
    "Merchandise__r" :
    {
        "MerchandiseExtID__c" : 123
    }
}

Exemple de l’objet complexe ci-dessus réécrit en tant qu’objet plat pris en charge :

{
    "Name" : "LineItemCreatedViaExtID",
    "MerchandiseExtID__c" : 123
}

Chargement de pièces jointes

L’API Salesforce prend en charge le chargement de pièces jointes pour les objets suivants : « Account », « Asset », « Campaign », « Case », « Contact », « Contract », « Custom objects », « EmailMessage », « EmailMessage », « Event », « Lead », « Opportunity », « Product2 », « Solution », « Task ». Pour charger le fichier de pièce jointe, utilisez l’action Créer un enregistrement et reportez-vous à la page de documentation Salesforce sur les champs et paramètres requis.

Fonctions et opérations délégables Power Apps pour Salesforce

Ces opérations Power Apps, pour un type de données donné, peuvent être déléguées à Salesforce pour le traitement (plutôt que de traiter localement dans Power Apps).

Fonctions de niveau supérieur

	Délégable
Moyen	Non
Filter	Oui
LookUp	Oui
Max	Non
Min	Non
Rechercher	Oui
Trier	Oui
SortByColumns	Oui
Somme	Non

Prédicats de filtre et de recherche

	Salesforce
Non	Oui
IsBlank	Non
TrimEnds	Non
NbCar	Non
+, -	Non
<, <=, =, <>, >>, =	Oui
Et (&&), ou (|), pas ( !)	Oui
in	Oui
StartsWith	Non

Connecteur en profondeur

Pour plus d’informations sur le connecteur, consultez la section détaillée.

Limites générales

Nom	Valeur
Nombre maximal de demandes traitées par le connecteur simultanément	50

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Connexion avec l’URI de connexion Salesforce personnalisé	Connexion avec l’URI de connexion Salesforce personnalisé	Us Government (GCC) uniquement	Partageable
Connexion avec un compte Salesforce	Indiquez les informations d’identification Salesforce pour vous connecter.	Toutes les régions	Partageable
Valeur par défaut [DÉCONSEILLÉE]	Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.	Toutes les régions	Impossible à partager

Connexion avec l’URI de connexion Salesforce personnalisé

ID d’authentification : CustomLoginURIAuth

Applicable : US Government (GCC) uniquement

Connexion avec l’URI de connexion Salesforce personnalisé

Il s’agit d’une connexion partageable. Si l’application d’alimentation est partagée avec un autre utilisateur, la connexion est également partagée. Pour plus d’informations, consultez la vue d’ensemble des connecteurs pour les applications de canevas - Power Apps | Microsoft Docs

Nom	Type	Descriptif	Obligatoire
URI de connexion Salesforce	ficelle	https://custom-domain-or-instance.my.salesforce.com	Vrai
Version de l’API Salesforce	ficelle	Version de l’API Salesforce. Par défaut, laissez vide ou utilisez v58.0

Connexion avec un compte Salesforce

ID d’authentification : BasicAuthentication

Applicable : Toutes les régions

Indiquez les informations d’identification Salesforce pour vous connecter.

Il s’agit d’une connexion partageable. Si l’application d’alimentation est partagée avec un autre utilisateur, la connexion est également partagée. Pour plus d’informations, consultez la vue d’ensemble des connecteurs pour les applications de canevas - Power Apps | Microsoft Docs

Nom	Type	Descriptif	Obligatoire
URI de connexion (environnement)	ficelle	URI de connexion Salesforce. Pour la production, laissez vide ou utilisez https://login.salesforce.com
Version de l’API Salesforce	ficelle	Version de l’API Salesforce. Par défaut, laissez vide ou utilisez v58.0

Valeur par défaut [DÉCONSEILLÉE]

Applicable : Toutes les régions

Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.

Ce n’est pas une connexion partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom	Type	Descriptif	Obligatoire
URI de connexion (environnement)	ficelle	URI de connexion Salesforce. Pour la production, laissez vide ou utilisez https://login.salesforce.com
Version de l’API Salesforce	ficelle	Version de l’API Salesforce. Par défaut, laissez vide ou utilisez v58.0

Limitations

Nom	Appels	Période de renouvellement
Appels d’API par connexion	900	60 secondes

Actions

Charger des données de travail	Charge des données pour un travail à l’aide de données CSV.
Créer un enregistrement	Cette opération crée un enregistrement et autorise les valeurs Null.
Créer un enregistrement [DÉCONSEILLÉ]	Cette opération crée un enregistrement.
Créer un travail (V2)	Crée un travail, qui représente une opération en bloc (et des données associées) envoyées à Salesforce pour un traitement asynchrone. Fournissez des données de travail via une demande charger des données de travail.
Créer un travail [DÉCONSEILLÉ]	Cette action a été déconseillée. Utilisez plutôt Créer un travail (V2). Crée un travail, qui représente une opération en bloc (et des données associées) envoyées à Salesforce pour un traitement asynchrone. Fournissez des données de travail via une demande charger des données de travail.
Envoyer une requête HTTP	Construire une demande d’API REST Salesforce à appeler
Exécuter une requête de recherche SOSL	Exécuter le qyery de recherche SOSL spécifié
Exécuter une requête SOQL	Exécutez une requête SOQL.
Fermer ou abandonner un travail	Ferme ou abandonne un travail. Utilisez UploadComplete pour fermer un travail ou abandonner pour abandonner un travail. Si vous fermez un travail, Salesforce met en file d’attente le travail et charge les données pour traitement, et vous ne pouvez pas ajouter de données de travail supplémentaires. Si vous abandonnez un travail, le travail n’est pas mis en file d’attente ou traité.
Insérer ou mettre à jour (Upsert) un enregistrement par ID externe (V2)	Cette opération insère ou met à jour (upserts) un enregistrement à l’aide d’un ID externe.
Insérer ou mettre à jour (Upsert) un enregistrement par ID externe [DÉPRÉCIÉ]	Cette action a été déconseillée. Utilisez plutôt Insert ou Update (Upsert) un enregistrement par ID externe (V2). Cette opération insère ou met à jour (upserts) un enregistrement à l’aide d’un ID externe.
Mettre à jour l’enregistrement (V3)	Cette opération met à jour un enregistrement et autorise les valeurs Null.
Mettre à jour l’enregistrement [DÉCONSEILLÉ]	Cette action a été déconseillée. Utilisez plutôt Update record (V3). Cette opération met à jour un enregistrement et autorise les valeurs Null.
Mettre à jour l’enregistrement [DÉCONSEILLÉ]	Cette opération met à jour un enregistrement.
Obtenir des enregistrements	Cette opération obtient des enregistrements d’un certain type d’objet Salesforce, comme « Prospects ».
Obtenir des enregistrements de cas à partir de Salesforce	Cette opération obtient les enregistrements Case de Salesforce.
Obtenir des enregistrements de compte à partir de Salesforce	Cette opération obtient les enregistrements de compte de Salesforce.
Obtenir des enregistrements de contact à partir de Salesforce	Cette opération obtient les enregistrements contact de Salesforce.
Obtenir des enregistrements de produit à partir de Salesforce	Cette opération obtient les enregistrements product de Salesforce.
Obtenir des enregistrements Opportunité à partir de Salesforce	Cette opération obtient les enregistrements Opportunity de Salesforce.
Obtenir des enregistrements utilisateur à partir de Salesforce	Cette opération obtient les enregistrements utilisateur de Salesforce.
Obtenir des informations sur le travail	Récupère des informations détaillées sur un travail.
Obtenir des types d’objets	Cette opération répertorie les types d’objets Salesforce disponibles.
Obtenir les résultats d’un travail	Récupère une liste d’enregistrements en fonction du type de résultat d’un travail terminé.
Obtenir l’enregistrement [DÉCONSEILLÉ]	Cette action a été déconseillée. Utilisez l’enregistrement Get à la place. Cette opération obtient un enregistrement.
Obtenir tous les travaux	Obtenir la liste de tous les travaux
Obtenir un enregistrement	Cette opération obtient un enregistrement.
Obtenir un enregistrement par ID externe	Cette opération récupère un enregistrement à l’aide d’un ID externe.
Serveur MCP pour Salesforce	Serveur MCP pour Salesforce
Supprimer un enregistrement	Cette opération supprime un enregistrement.
Supprimer un travail	Supprime un travail. Pour être supprimé, un travail doit avoir un état de UploadComplete, JobComplete, Aborted ou Failed.

Charger des données de travail

Créer un enregistrement

Créer un enregistrement [DÉCONSEILLÉ]

Créer un travail (V2)

Créer un travail [DÉCONSEILLÉ]

Envoyer une requête HTTP

Exécuter une requête de recherche SOSL

Exécuter une requête SOQL

Fermer ou abandonner un travail

Insérer ou mettre à jour (Upsert) un enregistrement par ID externe (V2)

Insérer ou mettre à jour (Upsert) un enregistrement par ID externe [DÉPRÉCIÉ]

Mettre à jour l’enregistrement (V3)

Mettre à jour l’enregistrement [DÉCONSEILLÉ]

Mettre à jour l’enregistrement [DÉCONSEILLÉ]

Obtenir des enregistrements

Obtenir des enregistrements de cas à partir de Salesforce

Obtenir des enregistrements de compte à partir de Salesforce

Obtenir des enregistrements de contact à partir de Salesforce

Obtenir des enregistrements de produit à partir de Salesforce

Obtenir des enregistrements Opportunité à partir de Salesforce

Obtenir des enregistrements utilisateur à partir de Salesforce

Obtenir des informations sur le travail

Obtenir des types d’objets

Obtenir les résultats d’un travail

Obtenir l’enregistrement [DÉCONSEILLÉ]

Obtenir tous les travaux

Obtenir un enregistrement

Obtenir un enregistrement par ID externe

Serveur MCP pour Salesforce

Supprimer un enregistrement

Supprimer un travail

Déclencheurs

Lorsqu’un enregistrement est créé	Cette opération se déclenche lorsqu’il existe des enregistrements nouvellement créés.
Lorsqu’un enregistrement est modifié	Cette opération se déclenche lorsqu’il existe des enregistrements nouvellement modifiés.

Lorsqu’un enregistrement est créé

Lorsqu’un enregistrement est modifié

Définitions

CreateJobResponse

Table

TablesList

GetAllJobsResponse

JobInfo

CheckJobResponse

SOSLSearchQueryResponse

SearchRecordObject

ObjectWithoutType

MCPQueryResponse

ficelle

objet