Salesforce
De Salesforce-connector biedt een API voor gebruik met Salesforce-objecten.
Deze connector is beschikbaar in de volgende producten en regio's:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Logic-apps | Standaard | Alle Logic Apps-regio's , met uitzondering van het volgende: - Us Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-regio's , met uitzondering van het volgende: - Amerikaanse overheid (GCC High) - China Cloud beheerd door 21Vianet - Us Department of Defense (DoD) |
| Connectormetagegevens | |
|---|---|
| Uitgever | Microsoft |
Als u deze integratie wilt gebruiken, hebt u toegang nodig tot een Salesforce-account waarvoor API-toegang is ingeschakeld. Als u wilt zien welke Salesforce-edities API-toegang hebben, raadpleegt u het Salesforce-artikel. Als u verbinding wilt maken, selecteert u Aanmelden. U wordt gevraagd om uw Salesforce-aanmelding op te geven. Volg de rest van de schermen om een verbinding te maken. De standaard-API-versie die momenteel door de connector wordt gebruikt, is v58.0.
U kunt deze integratie nu gaan gebruiken.
Opmerking
De Salesforce-connector is nu beschikbaar in Microsoft CoPilot Studio.
Bekende problemen en beperkingen
- Er is een limiet voor het aantal velden dat een query naar Salesforce kan bevatten. De limiet varieert, afhankelijk van het type kolommen, het aantal berekende kolommen, enzovoort. Wanneer u de foutmelding 'Query selecteert te veel velden of de filtervoorwaarden te ingewikkeld zijn' wordt weergegeven, betekent dit dat uw query de limiet overschrijdt. U kunt dit voorkomen door de geavanceerde optie Query selecteren te gebruiken en velden op te geven die u echt nodig hebt.
- Salesforce-sessie-instellingen kunnen deze integratie blokkeren. Zorg ervoor dat het instellen van 'Sessies vergrendelen naar het IP-adres waaruit ze afkomstig zijn' is uitgeschakeld.
- Salesforce API-toegang moet zijn ingeschakeld. Als u de toegangsinstellingen wilt controleren, gaat u naar profielinstellingen voor de huidige gebruiker en zoekt u naar het selectievakje API ingeschakeld.
- Salesforce-proefaccounts hebben geen API-toegang en kunnen dus niet worden gebruikt.
- Aangepaste velden van het type 'Selectielijst (multiselectie)' worden niet ondersteund door bewerkingen Record maken en Record bijwerken (V3), inclusief hun respectieve afgeschafte versies.
- Het maken van een nieuwe verbinding met aanmelding bij Salesforce 'Aangepast domein' wordt niet ondersteund.
- Het gebruik van null-velden in
Order Byparameter moet worden vermeden, omdat dit kan leiden tot runtimefouten in de volgende bewerkingen: Records ophalen, wanneer een record wordt gemaakt, wanneer een record wordt gemaakt of gewijzigd. - Wanneer een record wordt gewijzigd , kan alleen de recordwijziging van het standaardobject worden gedetecteerd, maar kan de bijlagewijziging van het standaardobject niet worden gedetecteerd.
- De volgende triggers en acties kunnen niet goed werken in aangepaste tabellen zonder de kolom Id: Wanneer een record wordt gemaakt of gewijzigd, kan record ophalen, Record maken, Record bijwerken(V3), Record verwijderen wanneer een record wordt gemaakt of gewijzigd.
- Wanneer een record wordt gemaakt of gewijzigd , worden zowel nieuwe als gewijzigde items geretourneerd. Als u wilt controleren of een geretourneerd item nieuw of gewijzigd is, vergelijkt u de veldwaarden CreatedDate en LastModifiedDate. Voor nieuwe items zijn deze waarden naar verwachting gelijk. In dit opzicht zijn beide velden verplicht voor de items waarvoor deze trigger wordt toegepast.
- Complexe objecten (objecten met geneste objecten, zie het onderstaande voorbeeld) worden niet ondersteund door Record maken en Bijwerken (V3) ( inclusief hun respectieve afgeschafte versies). Om deze beperking tijdelijk te omzeilen, moeten platte objectstructuren worden gebruikt.
- Een SOQL-query uitvoeren en records ophalen acties zijn gebaseerd op 'Query' API. Daarom kunnen niet alle records worden geretourneerd vanwege API-beperkingen (bijvoorbeeld verwijderde items).
- Als er problemen zijn met het instellen van gegevens op standaardwaarde met behulp van Updaterecord (V3), wordt dit veroorzaakt door de header 'sforce-auto-assign' ingesteld op true. Als tijdelijke oplossing wordt aanbevolen om een HTTP-aanvraagactie verzenden te gebruiken en aangepaste headerwaarde in te stellen als 'sforce-auto-assign: false'
- De Salesforce-connector heeft speciale verwerking voor verificatie, maar vanwege een beperking op de Salesforce-back-end verlopen tokens als ze gedurende lange tijd niet worden gebruikt en kunnen gebruikers te maken krijgen met een fout 'Bad_OAuth_Token/Sessie verlopen of ongeldig'. Meld u opnieuw aan met uw referenties.
- Deze beperking wordt nu opgelost, maar er moet een nieuwe verbinding worden gemaakt voor gebruik. De bestaande verbinding werkt nog steeds, maar het bovenstaande probleem kan zich voordoen.
Voorbeeld van een complex object dat niet wordt ondersteund omdat het een genest object met MerchandiseExtID__c veld heeft:
{
"Name" : "LineItemCreatedViaExtID",
"Merchandise__r" :
{
"MerchandiseExtID__c" : 123
}
}
Voorbeeld van het bovenstaande complexe object dat is herschreven als een plat object dat wordt ondersteund:
{
"Name" : "LineItemCreatedViaExtID",
"MerchandiseExtID__c" : 123
}
Bijlagen uploaden
Salesforce API ondersteunt het uploaden van bijlagen voor de volgende objecten: Account, Asset, Campagne, Case, Contact, Contract, Custom Objects, EmailMessage, EmailTemplate, Event, Lead, Opportunity, Product2, Solution, Task. Als u een bijlagebestand wilt uploaden, gebruikt u de actie Record maken en raadpleegt u de documentatiepagina van Salesforce over vereiste velden en parameters.
Delegeerbare functies en bewerkingen voor Power Apps voor Salesforce
Deze Power Apps-bewerkingen kunnen voor een bepaald gegevenstype worden gedelegeerd aan Salesforce voor verwerking (in plaats van lokaal te verwerken in Power Apps).
Functies op het hoogste niveau
| Delegeerbaar | |
|---|---|
| Average | Nee. |
| Filter | Yes |
| LookUp | Yes |
| Max | Nee. |
| Minuut | Nee. |
| Zoeken | Yes |
| Sorteren | Yes |
| SortByColumns | Yes |
| Som | Nee. |
Filter- en lookuppredicaten
| Salesforce | |
|---|---|
| Niet | Yes |
| IsBlank | Nee. |
| TrimEnds | Nee. |
| Len | Nee. |
| +, - | Nee. |
| <, <=, =, <>, >= > | Yes |
| En (&&), of (||), niet (!) | Yes |
| in | Yes |
| StartsWith | Nee. |
Connector uitgebreid
Zie de uitgebreide sectie voor meer informatie over de connector.
Algemene limieten
| Naam | Waarde |
|---|---|
| Maximum aantal aanvragen dat gelijktijdig door de connector wordt verwerkt | 50 |
Een verbinding maken
De connector ondersteunt de volgende verificatietypen:
| Aanmelden met aangepaste Salesforce-aanmeldings-URI | Aanmelden met aangepaste Salesforce-aanmeldings-URI | Alleen voor de Amerikaanse overheid (GCC) | Deelbaar |
| Aanmelden met Salesforce-account | Geef Salesforce-referenties op om u aan te melden. | Alle regio's | Deelbaar |
| Standaard [AFGESCHAFT] | Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies. | Alle regio's | Niet deelbaar |
Aanmelden met aangepaste Salesforce-aanmeldings-URI
Verificatie-id: CustomLoginURIAuth
Van toepassing: alleen GCC (Us Government)
Aanmelden met aangepaste Salesforce-aanmeldings-URI
Dit is deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt de verbinding ook gedeeld. Zie het overzicht van connectors voor canvas-apps - Power Apps | Microsoft Docs
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| Aanmeldings-URI van Salesforce | touw | https://custom-domain-or-instance.my.salesforce.com | Klopt |
| Salesforce API-versie | touw | De Salesforce API-versie. Laat standaard leeg of gebruik v58.0 |
Aanmelden met Salesforce-account
Verificatie-id: BasicAuthentication
Van toepassing: Alle regio's
Geef Salesforce-referenties op om u aan te melden.
Dit is deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt de verbinding ook gedeeld. Zie het overzicht van connectors voor canvas-apps - Power Apps | Microsoft Docs
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| Aanmeldings-URI (omgeving) | touw | De aanmeldings-URI van Salesforce. Voor Productie laat u leeg of gebruikt u https://login.salesforce.com | |
| Salesforce API-versie | touw | De Salesforce API-versie. Laat standaard leeg of gebruik v58.0 |
Standaard [AFGESCHAFT]
Van toepassing: Alle regio's
Deze optie is alleen bedoeld voor oudere verbindingen zonder expliciet verificatietype en is alleen beschikbaar voor compatibiliteit met eerdere versies.
Dit is geen deelbare verbinding. Als de power-app wordt gedeeld met een andere gebruiker, wordt een andere gebruiker gevraagd om expliciet een nieuwe verbinding te maken.
| Naam | Typologie | Description | Verplicht |
|---|---|---|---|
| Aanmeldings-URI (omgeving) | touw | De aanmeldings-URI van Salesforce. Voor Productie laat u leeg of gebruikt u https://login.salesforce.com | |
| Salesforce API-versie | touw | De Salesforce API-versie. Laat standaard leeg of gebruik v58.0 |
Beperkingslimieten
| Name | Aanroepen | Verlengingsperiode |
|---|---|---|
| API-aanroepen per verbinding | 900 | 60 seconden |
Acties
| Accountrecords ophalen uit Salesforce |
Met deze bewerking worden accountrecords opgehaald uit Salesforce. |
| Alle taken ophalen |
Een lijst met alle taken ophalen |
| Caserecords ophalen uit Salesforce |
Met deze bewerking worden caserecords opgehaald uit Salesforce. |
| Een HTTP-aanvraag verzenden |
Een Salesforce REST API-aanvraag maken om aan te roepen |
| Een record invoegen of bijwerken (Upsert) op externe id (V2) |
Met deze bewerking wordt een record ingevoegd of bijgewerkt (upserts) met behulp van een externe id. |
| Een record invoegen of bijwerken (Upsert) op externe id [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan Een record invoegen of bijwerken (Upsert) op basis van externe id (V2 ).
|
| Een record ophalen op basis van externe id |
Met deze bewerking wordt een record opgehaald met behulp van een externe id. |
| Een SOQL-query uitvoeren |
Voer een SOQL-query uit. |
| Een taak maken (V2) |
Hiermee maakt u een taak, die een bulkbewerking (en bijbehorende gegevens) vertegenwoordigt die naar Salesforce wordt verzonden voor asynchrone verwerking. Geef taakgegevens op via een aanvraag voor taakgegevens uploaden. |
| Een taak maken [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan Een taak maken (V2 ).
|
| Een taak sluiten of afbreken |
Hiermee wordt een taak gesloten of afgebroken. Gebruik UploadComplete om een taak te sluiten of afgebroken om een taak af te breken. Als u een taak sluit, worden de taak en geüploade gegevens in de wachtrij geplaatst voor verwerking en kunt u geen extra taakgegevens toevoegen. Als u een taak afbreekt, wordt de taak niet in de wachtrij geplaatst of verwerkt. |
| Een taak verwijderen |
Hiermee verwijdert u een taak. Om te worden verwijderd, moet een taak de status UploadComplete, JobComplete, Afgebroken of Mislukt hebben. |
| Gebruikersrecords ophalen uit Salesforce |
Met deze bewerking worden gebruikersrecords opgehaald uit Salesforce. |
| MCP-server voor Salesforce |
MCP-server voor Salesforce |
| Objecttypen ophalen |
Met deze bewerking worden de beschikbare Salesforce-objecttypen weergegeven. |
| Productrecords ophalen uit Salesforce |
Met deze bewerking worden productrecords opgehaald uit Salesforce. |
| Record bijwerken (V3) |
Met deze bewerking wordt een record bijgewerkt en worden null-waarden toegestaan. |
| Record bijwerken [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan Updaterecord (V3 ).
|
| Record bijwerken [AFGESCHAFT] |
Met deze bewerking wordt een record bijgewerkt. |
| Record maken |
Met deze bewerking maakt u een record en staat u null-waarden toe. |
| Record maken [AFGESCHAFT] |
Met deze bewerking maakt u een record. |
| Record ophalen |
Met deze bewerking wordt een record ophaalt. |
| Record ophalen [AFGESCHAFT] |
Deze actie is afgeschaft. Gebruik in plaats daarvan Get-record .
|
| Record verwijderen |
Met deze bewerking wordt een record verwijderd. |
| Records ophalen |
Met deze bewerking worden records opgehaald van een bepaald Salesforce-objecttype, zoals Potentiële klanten. |
| Records voor contactpersonen ophalen uit Salesforce |
Met deze bewerking worden records voor contactpersonen opgehaald uit Salesforce. |
| SOSL-zoekquery uitvoeren |
De opgegeven SOSL-zoekopdracht uitvoeren |
| Taakgegevens ophalen |
Hiermee haalt u gedetailleerde informatie over een taak op. |
| Taakgegevens uploaden |
Hiermee worden gegevens voor een taak geüpload met behulp van CSV-gegevens. |
| Taakresultaten ophalen |
Hiermee wordt een lijst met records opgehaald op basis van het resultaattype voor een voltooide taak. |
| Verkoopkansrecords ophalen uit Salesforce |
Met deze bewerking worden verkoopkansrecords opgehaald uit Salesforce. |
Accountrecords ophalen uit Salesforce
Met deze bewerking worden accountrecords opgehaald uit Salesforce.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Filterquery
|
$filter | string |
Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellen op
|
$orderby | string |
Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen. |
|
|
Aantal tops
|
$top | integer |
Totaal aantal items dat moet worden opgehaald (standaard = alle). |
|
|
Aantal overslaan
|
$skip | integer |
Het aantal items dat moet worden overgeslagen (standaard = 0). |
|
|
Query selecteren
|
$select | string |
Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle). |
Retouren
Alle taken ophalen
Een lijst met alle taken ophalen
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Gelijktijdigheidsmodus
|
concurrenyMode | string |
Gelijktijdigheidsmodus |
|
|
Is PK-segmentering ingeschakeld
|
isPkChunkingEnabled | boolean |
Is PK-segmentering ingeschakeld |
|
|
Taaktype
|
jobType | string |
Taaktype |
|
|
Queryzoeker
|
queryLocator | string |
Queryzoeker |
Retouren
- Body
- GetAllJobsResponse
Caserecords ophalen uit Salesforce
Met deze bewerking worden caserecords opgehaald uit Salesforce.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Filterquery
|
$filter | string |
Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellen op
|
$orderby | string |
Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen. |
|
|
Aantal tops
|
$top | integer |
Totaal aantal items dat moet worden opgehaald (standaard = alle). |
|
|
Aantal overslaan
|
$skip | integer |
Het aantal items dat moet worden overgeslagen (standaard = 0). |
|
|
Query selecteren
|
$select | string |
Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle). |
Retouren
Een HTTP-aanvraag verzenden
Een Salesforce REST API-aanvraag maken om aan te roepen
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
URI
|
Uri | True | string |
De volledige of relatieve URI. Voorbeeld van relatieve URI: /services/data/v41.0/sobjects/account |
|
Methode
|
Method | True | string |
De HTTP-methode (standaard is GET). |
|
Body
|
Body | binary |
De inhoud van de hoofdtekst van de aanvraag. |
|
|
Inhoudstype
|
ContentType | string |
De koptekst van het inhoudstype voor de hoofdtekst (standaard is application/json). |
|
|
CustomHeader1
|
CustomHeader1 | string |
Aangepaste koptekst 1. Opgeven in indeling: header-name: header-value |
|
|
CustomHeader2
|
CustomHeader2 | string |
Aangepaste koptekst 2. Opgeven in indeling: header-name: header-value |
|
|
CustomHeader3
|
CustomHeader3 | string |
Aangepaste koptekst 3. Opgeven in indeling: header-name: header-value |
|
|
CustomHeader4
|
CustomHeader4 | string |
Aangepaste koptekst 4. Opgeven in indeling: header-name: header-value |
|
|
CustomHeader5
|
CustomHeader5 | string |
Aangepaste koptekst 5. Opgeven in indeling: header-name: header-value |
Retouren
- response
- ObjectWithoutType
Een record invoegen of bijwerken (Upsert) op externe id (V2)
Met deze bewerking wordt een record ingevoegd of bijgewerkt (upserts) met behulp van een externe id.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Salesforce-objecttype
|
table | True | string |
Het Salesforce-objecttype, zoals 'Leads'. |
|
Extern id-veld
|
externalIdField | True | string |
Veld dat is gemarkeerd als extern id-veld in Salesforce-object. |
|
Externe ID
|
externalId | True | string |
Externe id van de record naar upsert. |
|
Opnemen
|
item | True | dynamic |
De record met gewijzigde eigenschappen. |
Retouren
Een record invoegen of bijwerken (Upsert) op externe id [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan Een record invoegen of bijwerken (Upsert) op basis van externe id (V2 ).
Met deze bewerking wordt een record ingevoegd of bijgewerkt (upserts) met behulp van een externe id.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Salesforce-objecttype
|
table | True | string |
Het Salesforce-objecttype, zoals 'Leads'. |
|
Extern id-veld
|
externalIdField | True | string |
Veld dat is gemarkeerd als extern id-veld in Salesforce-object. |
|
Externe ID
|
externalId | True | string |
Externe id van de record naar upsert. |
|
Opnemen
|
item | True | dynamic |
De record met gewijzigde eigenschappen. |
Retouren
Een record ophalen op basis van externe id
Met deze bewerking wordt een record opgehaald met behulp van een externe id.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Salesforce-objecttype
|
table | True | string |
Het Salesforce-objecttype, zoals 'Leads'. |
|
Extern id-veld
|
externalIdField | True | string |
Veld dat is gemarkeerd als extern id-veld in Salesforce-object. |
|
Externe ID
|
externalId | True | string |
Externe id van de record die moet worden opgehaald. |
Retouren
Een SOQL-query uitvoeren
Voer een SOQL-query uit.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
SOQL-query
|
query | True | string |
SOQL-querytekst. Dynamische parameters kunnen worden opgegeven met de syntaxis '@paramName'. |
|
Queryparameters
|
parameters | object |
DYNAMISCHE SOQL-queryparameters. De sleutel is de parameternaam (zonder @bij teken), de waarde is de parameterwaarde. |
Retouren
- response
- object
Een taak maken (V2)
Hiermee maakt u een taak, die een bulkbewerking (en bijbehorende gegevens) vertegenwoordigt die naar Salesforce wordt verzonden voor asynchrone verwerking. Geef taakgegevens op via een aanvraag voor taakgegevens uploaden.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Object
|
object | True | string |
Het objecttype voor de gegevens die worden verwerkt. |
|
Operation
|
operation | True | string |
De verwerkingsbewerking voor de taak. |
|
Kolomscheidingsteken
|
columnDelimiter | string |
Het kolomscheidingsteken dat wordt gebruikt voor CSV-taakgegevens. |
|
|
Veldnaam voor externe id
|
externalIdFieldName | string |
Het externe id-veld in het object dat wordt bijgewerkt. Alleen nodig voor upsert-bewerkingen. Veldwaarden moeten ook bestaan in CSV-taakgegevens. |
|
|
Lijneinde
|
lineEnding | string |
De regel die wordt gebruikt voor CSV-taakgegevens, waarmee het einde van een gegevensrij wordt gemarkeerd. |
|
|
Inhoudstype
|
contentType | string |
Het inhoudstype voor de taak. |
Retouren
Uitvoer voor bewerking CreateJobV2
- Body
- CreateJobResponse
Een taak maken [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan Een taak maken (V2 ).
Hiermee maakt u een taak, die een bulkbewerking (en bijbehorende gegevens) vertegenwoordigt die naar Salesforce wordt verzonden voor asynchrone verwerking. Geef taakgegevens op via een aanvraag voor taakgegevens uploaden.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Kolomscheidingsteken
|
columnDelimiter | string |
Kolomscheidingsteken |
|
|
Veldnaam voor externe id
|
externalIdFieldName | string |
Veldnaam voor externe id |
|
|
Lijneinde
|
lineEnding | string |
Lijneinde |
|
|
Object
|
object | True | string |
Object |
|
Operation
|
operation | True | string |
Operation |
Retouren
- Body
- JobInfo
Een taak sluiten of afbreken
Hiermee wordt een taak gesloten of afgebroken. Gebruik UploadComplete om een taak te sluiten of afgebroken om een taak af te breken. Als u een taak sluit, worden de taak en geüploade gegevens in de wachtrij geplaatst voor verwerking en kunt u geen extra taakgegevens toevoegen. Als u een taak afbreekt, wordt de taak niet in de wachtrij geplaatst of verwerkt.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Functie-ID
|
jobId | True | string |
Functie-ID |
|
state
|
state | True | string |
state |
Retouren
- Body
- JobInfo
Een taak verwijderen
Hiermee verwijdert u een taak. Om te worden verwijderd, moet een taak de status UploadComplete, JobComplete, Afgebroken of Mislukt hebben.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Functie-ID
|
jobId | True | string |
Functie-ID |
Gebruikersrecords ophalen uit Salesforce
Met deze bewerking worden gebruikersrecords opgehaald uit Salesforce.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Filterquery
|
$filter | string |
Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellen op
|
$orderby | string |
Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen. |
|
|
Aantal tops
|
$top | integer |
Totaal aantal items dat moet worden opgehaald (standaard = alle). |
|
|
Aantal overslaan
|
$skip | integer |
Het aantal items dat moet worden overgeslagen (standaard = 0). |
|
|
Query selecteren
|
$select | string |
Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle). |
Retouren
MCP-server voor Salesforce
MCP-server voor Salesforce
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
jsonrpc
|
jsonrpc | string | ||
|
identiteitskaart
|
id | string | ||
|
method
|
method | string | ||
|
params
|
params | object | ||
|
resultaat
|
result | object | ||
|
fout
|
error | object | ||
|
sessie-id
|
sessionId | string |
Retouren
- Body
- MCPQueryResponse
Objecttypen ophalen
Met deze bewerking worden de beschikbare Salesforce-objecttypen weergegeven.
Retouren
Vertegenwoordigt een lijst met tabellen.
- Body
- TablesList
Productrecords ophalen uit Salesforce
Met deze bewerking worden productrecords opgehaald uit Salesforce.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Filterquery
|
$filter | string |
Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellen op
|
$orderby | string |
Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen. |
|
|
Aantal tops
|
$top | integer |
Totaal aantal items dat moet worden opgehaald (standaard = alle). |
|
|
Aantal overslaan
|
$skip | integer |
Het aantal items dat moet worden overgeslagen (standaard = 0). |
|
|
Query selecteren
|
$select | string |
Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle). |
Retouren
Record bijwerken (V3)
Met deze bewerking wordt een record bijgewerkt en worden null-waarden toegestaan.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Salesforce-objecttype
|
table | True | string |
tabelnaam |
|
Record-id
|
id | True | string |
itemsleutel |
|
item dat moet worden bijgewerkt
|
item | True | dynamic |
item dat moet worden bijgewerkt |
|
Query selecteren
|
$select | string |
Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle). |
Retouren
Record bijwerken [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan Updaterecord (V3 ).
Met deze bewerking wordt een record bijgewerkt en worden null-waarden toegestaan.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Salesforce-objecttype
|
table | True | string |
tabelnaam |
|
Record-id
|
id | True | string |
itemsleutel |
|
item dat moet worden bijgewerkt
|
item | True | dynamic |
item dat moet worden bijgewerkt |
|
Query selecteren
|
$select | string |
Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle). |
Retouren
Record bijwerken [AFGESCHAFT]
Met deze bewerking wordt een record bijgewerkt.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Salesforce-objecttype
|
table | True | string |
Het Salesforce-objecttype, zoals 'Leads'. |
|
Record-id
|
id | True | string |
De unieke id van de record die moet worden bijgewerkt. |
|
Opnemen
|
item | True | dynamic |
De record met gewijzigde eigenschappen. |
Retouren
Record maken
Met deze bewerking maakt u een record en staat u null-waarden toe.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Salesforce-objecttype
|
table | True | string |
tabelnaam |
|
Opnemen
|
item | True | dynamic |
Opnemen |
Retouren
Record maken [AFGESCHAFT]
Met deze bewerking maakt u een record.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Salesforce-objecttype
|
table | True | string |
Het Salesforce-objecttype, zoals 'Leads'. |
|
Opnemen
|
item | True | dynamic |
De record die moet worden gemaakt. |
Retouren
Record ophalen
Met deze bewerking wordt een record ophaalt.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Salesforce-objecttype
|
table | True | string |
tabelnaam |
|
Record-id
|
id | True | string |
itemsleutel |
|
Query selecteren
|
$select | string |
Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle). |
Retouren
Record ophalen [AFGESCHAFT]
Deze actie is afgeschaft. Gebruik in plaats daarvan Get-record .
Met deze bewerking wordt een record ophaalt.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
table
|
table | True | string | |
|
identiteitskaart
|
id | True | string |
Retouren
Record verwijderen
Met deze bewerking wordt een record verwijderd.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Salesforce-objecttype
|
table | True | string |
Het Salesforce-objecttype, zoals 'Leads'. |
|
Record-id
|
id | True | string |
De unieke id van de record die u wilt verwijderen. |
Records ophalen
Met deze bewerking worden records opgehaald van een bepaald Salesforce-objecttype, zoals Potentiële klanten.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Salesforce-objecttype
|
table | True | string |
Het Salesforce-objecttype, zoals 'Leads'. |
|
Filterquery
|
$filter | string |
Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellen op
|
$orderby | string |
Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen. |
|
|
Aantal tops
|
$top | integer |
Totaal aantal items dat moet worden opgehaald (standaard = alle). |
|
|
Aantal overslaan
|
$skip | integer |
Het aantal items dat moet worden overgeslagen (standaard = 0). |
|
|
Query selecteren
|
$select | string |
Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle). |
Retouren
Records voor contactpersonen ophalen uit Salesforce
Met deze bewerking worden records voor contactpersonen opgehaald uit Salesforce.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Filterquery
|
$filter | string |
Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellen op
|
$orderby | string |
Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen. |
|
|
Aantal tops
|
$top | integer |
Totaal aantal items dat moet worden opgehaald (standaard = alle). |
|
|
Aantal overslaan
|
$skip | integer |
Het aantal items dat moet worden overgeslagen (standaard = 0). |
|
|
Query selecteren
|
$select | string |
Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle). |
Retouren
SOSL-zoekquery uitvoeren
De opgegeven SOSL-zoekopdracht uitvoeren
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
SOSL-zoekreeks
|
q | True | string |
SOSL-zoekreeks |
Retouren
SOSL-antwoord op zoekquery
Taakgegevens ophalen
Hiermee haalt u gedetailleerde informatie over een taak op.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Functie-ID
|
jobId | True | string |
Functie-ID |
Retouren
- Body
- CheckJobResponse
Taakgegevens uploaden
Hiermee worden gegevens voor een taak geüpload met behulp van CSV-gegevens.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Functie-ID
|
jobId | True | string |
Functie-ID |
|
Inhoud van CSV-bestand
|
body | True | binary |
CSV-gegevens die moeten worden geüpload |
Taakresultaten ophalen
Hiermee wordt een lijst met records opgehaald op basis van het resultaattype voor een voltooide taak.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Functie-ID
|
jobId | True | string |
Functie-ID |
|
Resultaattype
|
resultType | True | string |
Resultaattype |
Retouren
- response
- string
Verkoopkansrecords ophalen uit Salesforce
Met deze bewerking worden verkoopkansrecords opgehaald uit Salesforce.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Filterquery
|
$filter | string |
Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellen op
|
$orderby | string |
Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen. |
|
|
Aantal tops
|
$top | integer |
Totaal aantal items dat moet worden opgehaald (standaard = alle). |
|
|
Aantal overslaan
|
$skip | integer |
Het aantal items dat moet worden overgeslagen (standaard = 0). |
|
|
Query selecteren
|
$select | string |
Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle). |
Retouren
Triggers
| Wanneer een record wordt gemaakt |
Deze bewerking wordt geactiveerd wanneer er nieuw gemaakte records zijn. |
| Wanneer een record wordt gewijzigd |
Deze bewerking wordt geactiveerd wanneer er nieuw gewijzigde records zijn. |
Wanneer een record wordt gemaakt
Deze bewerking wordt geactiveerd wanneer er nieuw gemaakte records zijn.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Salesforce-objecttype
|
table | True | string |
Het Salesforce-objecttype, zoals 'Leads'. |
|
Filterquery
|
$filter | string |
Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellen op
|
$orderby | string |
Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen. |
|
|
Query selecteren
|
$select | string |
Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle). |
Retouren
Wanneer een record wordt gewijzigd
Deze bewerking wordt geactiveerd wanneer er nieuw gewijzigde records zijn.
Parameters
| Name | Sleutel | Vereist | Type | Description |
|---|---|---|---|---|
|
Salesforce-objecttype
|
table | True | string |
Het Salesforce-objecttype, zoals 'Leads'. |
|
Filterquery
|
$filter | string |
Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Bestellen op
|
$orderby | string |
Een ODATA orderBy-query voor het opgeven van de volgorde van vermeldingen. |
|
|
Query selecteren
|
$select | string |
Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle). |
Retouren
Definities
CreateJobResponse
Uitvoer voor bewerking CreateJobV2
| Name | Pad | Type | Description |
|---|---|---|---|
|
Object
|
object | string |
Het objecttype voor de gegevens die worden verwerkt. |
|
Operation
|
operation | string |
De verwerkingsbewerking voor de taak. |
|
Kolomscheidingsteken
|
columnDelimiter | string |
Het kolomscheidingsteken dat wordt gebruikt voor CSV-taakgegevens. |
|
Veldnaam voor externe id
|
externalIdFieldName | string |
Het externe id-veld in het object dat wordt bijgewerkt. Alleen nodig voor upsert-bewerkingen. Veldwaarden moeten ook bestaan in CSV-taakgegevens. |
|
Lijneinde
|
lineEnding | string |
De regel die wordt gebruikt voor CSV-taakgegevens, waarmee het einde van een gegevensrij wordt gemarkeerd. |
|
Inhoudstype
|
contentType | string |
Het inhoudstype voor de taak. |
|
API-versie
|
apiVersion | float |
De API-versie waarin de taak is gemaakt. |
|
Gelijktijdigheidsmodus
|
concurrencyMode | string |
De gelijktijdigheidsmodus voor de taak. |
|
Inhouds-URL
|
contentUrl | string |
De URL die moet worden gebruikt voor het uploaden van taakgegevensaanvragen voor deze taak. Alleen geldig als de taak de status Openen heeft. |
|
Gemaakt door id
|
createdById | string |
De id van de gebruiker die de taak heeft gemaakt. |
|
Aanmaakdatum
|
createdDate | date-time |
De datum en tijd in de UTC-tijdzone waarop de taak is gemaakt. |
|
Identiteitsbewijs
|
id | string |
Unieke id voor deze taak. |
|
Taaktype
|
jobType | string |
Het type taak. |
|
Staat
|
state | string |
De huidige status van de verwerking voor de taak. |
|
Systeem modstamp
|
systemModstamp | date-time |
Datum en tijd in de UTC-tijdzone wanneer de taak is voltooid. |
Table
Vertegenwoordigt een tabel.
| Name | Pad | Type | Description |
|---|---|---|---|
|
Naam
|
Name | string |
De naam van de tabel. De naam wordt tijdens runtime gebruikt. |
|
Schermnaam
|
DisplayName | string |
De weergavenaam van de tabel. |
|
DynamicProperties
|
DynamicProperties | object |
Aanvullende tabeleigenschappen die door de connector aan de clients worden geleverd. |
TablesList
Vertegenwoordigt een lijst met tabellen.
| Name | Pad | Type | Description |
|---|---|---|---|
|
waarde
|
value | array of Table |
Lijst met tabellen |
GetAllJobsResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
Gereed
|
done | boolean |
Gereed |
|
archief
|
records | array of JobInfo | |
|
Volgende hercored URL
|
nextRecordUrl | string |
Volgende record-URL |
JobInfo
| Name | Pad | Type | Description |
|---|---|---|---|
|
API-versie
|
apiVersion | float |
API-versie |
|
Kolomscheidingsteken
|
columnDelimiter | string |
Kolomscheidingsteken |
|
Gelijktijdigheidsmodus
|
concurrencyMode | string |
Gelijktijdigheidsmodus |
|
Inhoudstype
|
contentType | string |
Inhoudstype |
|
Inhouds-URL
|
contentUrl | string |
Inhouds-URL |
|
Gemaakt door id
|
createdById | string |
Gemaakt door id |
|
Aanmaakdatum
|
createdDate | date-time |
Aanmaakdatum |
|
Veldnaam voor externe id
|
externalIdFieldName | string |
Veldnaam voor externe id |
|
ID-kaart
|
id | string |
ID-kaart |
|
Taaktype
|
jobType | string |
Taaktype |
|
Lijneinde
|
lineEnding | string |
Lijneinde |
|
Object
|
object | string |
Object |
|
Operation
|
operation | string |
Operation |
|
Staat
|
state | string |
Staat |
|
Systeem mod stempel
|
systemModstamp | date-time |
Systeem mod stempel |
CheckJobResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
APEX-verwerkingstijd
|
apexProcessingTime | number |
APEX-verwerkingstijd |
|
Actieve verwerkingstijd van API
|
apiActiveProcessingTime | number |
Actieve verwerkingstijd van API |
|
API-versie
|
apiVersion | float |
API-versie |
|
Kolomscheidingsteken
|
columnDelimiter | string |
Kolomscheidingsteken |
|
Gelijktijdigheidsmodus
|
concurrencyMode | string |
Gelijktijdigheidsmodus |
|
Inhoudstype
|
contentType | string |
Inhoudstype |
|
Inhouds-URL
|
contentUrl | string |
Inhouds-URL |
|
Gemaakt door id
|
createdById | string |
Gemaakt door id |
|
Aanmaakdatum
|
createdDate | date-time |
Aanmaakdatum |
|
Naam van extern veld
|
externalFieldName | string |
Naam van extern veld |
|
ID-kaart
|
id | string |
ID-kaart |
|
Taaktype
|
jobType | string |
Taaktype |
|
Lijneinde
|
lineEnding | string |
Lijneinde |
|
Object
|
object | string |
Object |
|
Operation
|
operation | string |
Operation |
|
Hernieuwde pogingen
|
retries | number |
Hernieuwde pogingen |
|
Staat
|
state | string |
Staat |
|
systemModStamp
|
systemModStamp | date-time | |
|
Totale verwerkingstijd
|
totalProcessingTime | number |
Totale verwerkingstijd |
SOSLSearchQueryResponse
SOSL-antwoord op zoekquery
| Name | Pad | Type | Description |
|---|---|---|---|
|
searchRecords
|
searchRecords | array of SearchRecordObject |
Een lijst met zoekrecords die worden geretourneerd door een SOSL-zoekquery |
SearchRecordObject
Afzonderlijke record geretourneerd door SOSL-query
| Name | Pad | Type | Description |
|---|---|---|---|
|
type
|
attributes.type | string |
Type van de record |
|
url
|
attributes.url | string |
API-pad dat kan worden gebruikt om het object op te halen |
|
Identiteitsbewijs
|
Id | string |
Unieke id van de record |
ObjectWithoutType
MCPQueryResponse
| Name | Pad | Type | Description |
|---|---|---|---|
|
jsonrpc
|
jsonrpc | string | |
|
identiteitskaart
|
id | string | |
|
method
|
method | string | |
|
params
|
params | object | |
|
resultaat
|
result | object | |
|
fout
|
error | object |
touw
Dit is het basisgegevenstype 'tekenreeks'.
Voorwerp
Dit is het type 'object'.