Salesforce

Der Salesforce Connector stellt eine API zum Arbeiten mit Salesforce-Objekten bereit.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung	Class	Regions
Copilot Studio	Premium	Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:      - US Government (GCC High)      - China Cloud betrieben von 21Vianet      - US Department of Defense (DoD)
Logik-Apps	Norm	Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:      - US Department of Defense (DoD)
Power Apps	Premium	Alle Power Apps-Regionen mit Ausnahme der folgenden:      - US Government (GCC High)      - China Cloud betrieben von 21Vianet      - US Department of Defense (DoD)
Power Automate	Premium	Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:      - US Government (GCC High)      - China Cloud betrieben von 21Vianet      - US Department of Defense (DoD)

Connectormetadaten
Herausgeber	Microsoft

Um diese Integration zu verwenden, benötigen Sie Zugriff auf ein Salesforce-Konto mit aktiviertem API-Zugriff. Wenn Sie sehen möchten, welche Salesforce-Editionen über API-Zugriff verfügen, lesen Sie den Salesforce-Artikel. Um eine Verbindung herzustellen, wählen Sie "Anmelden" aus. Sie werden aufgefordert, Ihre Salesforce-Anmeldung anzugeben, folgen Sie den restlichen Bildschirmen, um eine Verbindung zu erstellen. Die derzeit vom Connector verwendete Standard-API-Version ist v58.0.

Sie können jetzt mit der Verwendung dieser Integration beginnen.

Hinweis

Der Salesforce-Connector ist jetzt in Microsoft CoPilot Studio verfügbar.

Bekannte Probleme und Einschränkungen

1. Es gibt ein Limit für die Anzahl der Felder, die eine Abfrage für Salesforce enthalten kann. Der Grenzwert variiert je nach Spaltentyp, Anzahl berechneter Spalten usw. Wenn Sie eine Fehlermeldung erhalten, "Abfrage wählt entweder zu viele Felder aus, oder die Filterbedingungen sind zu kompliziert", bedeutet dies, dass die Abfrage den Grenzwert überschreitet. Um dies zu vermeiden, verwenden Sie die erweiterte Option "Abfrage auswählen", und geben Sie Felder an, die Sie wirklich benötigen.
2. Salesforce-Sitzungseinstellungen können diese Integration blockieren. Stellen Sie sicher, dass die Einstellung "Sitzungen an die IP-Adresse sperren, von der sie stammen" deaktiviert ist.
3. Salesforce-API-Zugriff sollte aktiviert sein. Um die Zugriffseinstellungen zu überprüfen, wechseln Sie zu Profileinstellungen für den aktuellen Benutzer, und suchen Sie nach dem Kontrollkästchen "API aktiviert".
4. Salesforce-Testkonten haben keinen API-Zugriff und können daher nicht verwendet werden.
5. Benutzerdefinierte Felder vom Typ "Auswahlliste (Multi-Select)" werden von Aktionen zum Erstellen von Datensätzen und Aktualisierungsdatensatz (V3) ( einschließlich der jeweiligen veralteten Versionen) nicht unterstützt.
6. Das Erstellen einer neuen Verbindung mithilfe der Salesforce-Anmeldung "Benutzerdefinierte Domäne" wird nicht unterstützt.
7. Die Verwendung nullabler Felder im Order By Parameter sollte vermieden werden, da dies zu Laufzeitfehlern bei folgenden Vorgängen führen kann: Abrufen von Datensätzen, Wenn ein Datensatz erstelltoder geändert wird.
8. Wenn ein Datensatz geändert wird , kann nur die Datensatzänderung des Standardobjekts erkannt werden, die Anlagenänderung des Standardobjekts kann jedoch nicht erkannt werden.
9. Die folgenden Auslöser und Aktionen konnten in benutzerdefinierten Tabellen ohne Spalte "ID" nicht ordnungsgemäß funktionieren: Wenn ein Datensatzerstellt oder geändert wird, get record, Create record, Update Record (V3), Delete record.
10. Wenn ein Datensatz erstellt oder geändert wird , werden sowohl neue als auch geänderte Elemente zurückgegeben. Um zu überprüfen, ob ein zurückgegebenes Element neu oder geändert ist, vergleichen Sie die Feldwerte "CreatedDate" und "LastModifiedDate". Bei neuen Elementen werden diese Werte erwartet, dass sie gleich sind. In diesem Zusammenhang sind beide Felder für die Elemente obligatorisch, für die dieser Auslöser angewendet wird.
11. Komplexe Objekte (Objekte mit geschachtelten Objekten, siehe Beispiel unten) werden von "Datensatz erstellen " und "Aktualisieren" (V3) ( einschließlich der entsprechenden veralteten Versionen) nicht unterstützt. Um diese Einschränkung zu umgehen, sollten flache Objektstrukturen verwendet werden.
12. Ausführen einer SOQL-Abfrage und Abrufen von Datensatzaktionen basieren auf der 'Abfrage'-API. Daher können nicht alle Datensätze aufgrund von API-Einschränkungen (z. B. gelöschte Elemente) zurückgegeben werden.
13. Wenn beim Abrufen von Daten ein Problem mit dem Standardwert mithilfe des Update-Datensatzes (V3) besteht, liegt dies an der Kopfzeile "sforce-auto-assign" auf "true". Um dies zu umgehen, wird empfohlen, eine HTTP-Anforderungsaktion zu verwenden und den benutzerdefinierten Headerwert als "sforce-auto-assign: false" festzulegen.
14. Der Salesforce-Connector verfügt jedoch aufgrund einer Einschränkung des Salesforce-Back-Ends über eine spezielle Behandlung für die Authentifizierung. Token laufen ab, wenn sie nicht für eine lange Zeit verwendet werden, und Die Benutzer haben möglicherweise einen Fehler "Bad_OAuth_Token/Sitzung abgelaufen oder ungültig". Melden Sie sich mit Ihren Anmeldeinformationen erneut an.
    • Diese Einschränkung wird jetzt behoben, jedoch muss eine neue Verbindung für die Verwendung erstellt werden. Die bereits vorhandene Verbindung funktioniert weiterhin, aber das oben genannte Problem kann auftreten.

Beispiel für ein komplexes Objekt, das nicht unterstützt wird, da es über ein geschachteltes Objekt mit MerchandiseExtID__c Feld verfügt:

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

Beispiel für das oben genannte komplexe Objekt, das als flaches Objekt umgeschrieben wird, das unterstützt wird:

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

Hochladen von Anlagen

Die Salesforce-API unterstützt das Hochladen von Anlagen für die folgenden Objekte: 'Account', 'Asset', 'Campaign', 'Case', 'Contact', 'Contract', 'Custom objects', 'EmailMessage', 'EmailTemplate', 'Event', 'Lead', 'Opportunity', 'Product2', 'Solution', 'Task'. Verwenden Sie zum Hochladen der Anlagendatei die Aktion " Datensatz erstellen", und verweisen Sie auf der Salesforce-Dokumentationsseite zu den erforderlichen Feldern und Parametern.

Power Apps delegierbare Funktionen und Vorgänge für Salesforce

Diese Power Apps-Vorgänge können für einen bestimmten Datentyp zur Verarbeitung an Salesforce delegiert werden (anstatt lokal in Power Apps zu verarbeiten).

Funktionen der obersten Ebene

	Delegierbar
Average	Nein
Filter	Yes
LookUp	Yes
Max.	Nein
Min	Nein
Suche	Yes
Sortieren	Yes
SortByColumns	Yes
Summe	Nein

Filter- und LookUp-Prädikate

	Salesforce
Nicht	Yes
IsBlank	Nein
TrimEnds	Nein
Len	Nein
+, -	Nein
<, <=, =, <>, >, >=	Yes
Und (&&&), Oder (||), Nicht (!)	Yes
in	Yes
StartsWith	Nein

Verbinder im Detail

Weitere Informationen zum Verbinder finden Sie im ausführlichen Abschnitt.

Allgemeine Grenzwerte

Name	Wert
Maximale Anzahl von Anforderungen, die vom Connector gleichzeitig verarbeitet werden	50

Erstellen einer Verbindung

Der Connector unterstützt die folgenden Authentifizierungstypen:

Anmelden mit benutzerdefiniertem Salesforce-Anmelde-URI	Anmelden mit benutzerdefiniertem Salesforce-Anmelde-URI	Nur US-Regierung (GCC)	Freigabefähig
Anmelden mit Salesforce-Konto	Geben Sie Salesforce-Anmeldeinformationen für die Anmeldung an.	Alle Regionen	Freigabefähig
Standard [VERALTET]	Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt.	Alle Regionen	Nicht teilbar

Anmelden mit benutzerdefiniertem Salesforce-Anmelde-URI

Auth-ID: CustomLoginURIAuth

Anwendbar: Nur US Government (GCC)

Anmelden mit benutzerdefiniertem Salesforce-Anmelde-URI

Dies ist eine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird auch die Verbindung freigegeben. Weitere Informationen finden Sie in der Übersicht über Connectors für Canvas-Apps – Power Apps | Microsoft-Dokumente

Name	Typ	Description	Erforderlich
Salesforce-Anmelde-URI	Schnur	https://custom-domain-or-instance.my.salesforce.com	Richtig
Salesforce-API-Version	Schnur	Die Salesforce-API-Version. Lassen Sie für die Standardeinstellung leer, oder verwenden Sie v58.0.

Anmelden mit Salesforce-Konto

Auth-ID: BasicAuthentication

Anwendbar: Alle Regionen

Geben Sie Salesforce-Anmeldeinformationen für die Anmeldung an.

Dies ist eine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird auch die Verbindung freigegeben. Weitere Informationen finden Sie in der Übersicht über Connectors für Canvas-Apps – Power Apps | Microsoft-Dokumente

Name	Typ	Description	Erforderlich
Anmelde-URI (Umgebung)	Schnur	Der Salesforce-Anmelde-URI. Lassen Sie für die Produktion leer oder verwenden Sie https://login.salesforce.com
Salesforce-API-Version	Schnur	Die Salesforce-API-Version. Lassen Sie für die Standardeinstellung leer, oder verwenden Sie v58.0.

Standard [VERALTET]

Anwendbar: Alle Regionen

Diese Option ist nur für ältere Verbindungen ohne expliziten Authentifizierungstyp vorgesehen und wird nur aus Gründen der Abwärtskompatibilität bereitgestellt.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name	Typ	Description	Erforderlich
Anmelde-URI (Umgebung)	Schnur	Der Salesforce-Anmelde-URI. Lassen Sie für die Produktion leer oder verwenden Sie https://login.salesforce.com
Salesforce-API-Version	Schnur	Die Salesforce-API-Version. Lassen Sie für die Standardeinstellung leer, oder verwenden Sie v58.0.

Drosselungsgrenzwerte

Name	Aufrufe	Verlängerungszeitraum
API-Aufrufe pro Verbindung	900	60 Sekunden

Aktionen

Abrufen aller Aufträge	Abrufen einer Liste aller Aufträge
Abrufen eines Datensatzes nach externer ID	Dieser Vorgang ruft einen Datensatz mithilfe einer externen ID ab.
Abrufen von Auftragsergebnissen	Ruft eine Liste von Datensätzen basierend auf dem Ergebnistyp für einen abgeschlossenen Auftrag ab.
Abrufen von Benutzerdatensätzen aus Salesforce	Dieser Vorgang ruft Benutzerdatensätze aus Salesforce ab.
Abrufen von Datensätzen	Dieser Vorgang ruft Datensätze eines bestimmten Salesforce-Objekttyps wie "Leads" ab.
Abrufen von Falldatensätzen aus Salesforce	Dieser Vorgang ruft Falldatensätze von Salesforce ab.
Abrufen von Kontaktdatensätzen aus Salesforce	Dieser Vorgang ruft Kontaktdatensätze aus Salesforce ab.
Abrufen von Kontodatensätzen aus Salesforce	Dieser Vorgang ruft Kontodatensätze aus Salesforce ab.
Abrufen von Objekttypen	Dieser Vorgang listet die verfügbaren Salesforce-Objekttypen auf.
Abrufen von Produktdatensätzen aus Salesforce	Dieser Vorgang ruft Produktdatensätze aus Salesforce ab.
Abrufen von Verkaufschancendatensätzen aus Salesforce	Dieser Vorgang ruft Verkaufschancendatensätze von Salesforce ab.
Auftragsinformationen abrufen	Ruft detaillierte Informationen zu einem Auftrag ab.
Ausführen der SOSL-Suchabfrage	Ausführen der angegebenen SOSL-Suchabfrage
Ausführen einer SOQL-Abfrage	Führen Sie eine SOQL-Abfrage aus.
Datensatz abrufen	Dieser Vorgang ruft einen Datensatz ab.
Datensatz abrufen [VERALTET]	Diese Aktion ist veraltet. Verwenden Sie stattdessen "Datensatz abrufen ". Dieser Vorgang ruft einen Datensatz ab.
Datensatz aktualisieren [VERALTET]	Diese Aktion ist veraltet. Verwenden Sie stattdessen den Update-Eintrag (V3 ). Dieser Vorgang aktualisiert einen Datensatz und lässt Nullwerte zu.
Datensatz aktualisieren [VERALTET]	Dieser Vorgang aktualisiert einen Datensatz.
Datensatz erstellen	Dieser Vorgang erstellt einen Datensatz und lässt Nullwerte zu.
Datensatz erstellen [VERALTET]	Dieser Vorgang erstellt einen Datensatz.
Datensatz löschen	Dieser Vorgang löscht einen Datensatz.
Einfügen oder Aktualisieren (Upsert) eines Datensatzes nach externer ID (V2)	Mit diesem Vorgang wird ein Datensatz mithilfe einer externen ID eingefügt oder aktualisiert (upserts).
Einfügen oder Aktualisieren (Upsert) eines Datensatzes nach externer ID [VERALTET]	Diese Aktion ist veraltet. Verwenden Sie stattdessen "Einfügen" oder "Aktualisieren" (Upsert) für einen Datensatz nach externer ID (V2 ). Mit diesem Vorgang wird ein Datensatz mithilfe einer externen ID eingefügt oder aktualisiert (upserts).
Erstellen eines Auftrags (V2)	Erstellt einen Auftrag, der einen Massenvorgang (und zugehörige Daten) darstellt, der zur asynchronen Verarbeitung an Salesforce gesendet wird. Stellen Sie Auftragsdaten über eine Anforderung zum Hochladen von Auftragsdaten bereit.
Erstellen eines Auftrags [VERALTET]	Diese Aktion ist veraltet. Verwenden Sie stattdessen " Auftrag erstellen" (V2 ). Erstellt einen Auftrag, der einen Massenvorgang (und zugehörige Daten) darstellt, der zur asynchronen Verarbeitung an Salesforce gesendet wird. Stellen Sie Auftragsdaten über eine Anforderung zum Hochladen von Auftragsdaten bereit.
Hochladen von Auftragsdaten	Lädt Daten für einen Auftrag mithilfe von CSV-Daten hoch.
Löschen eines Auftrags	Löscht einen Auftrag. Um gelöscht zu werden, muss ein Auftrag den Status "UploadComplete", "JobComplete", "Abgebrochen" oder "Fehlgeschlagen" aufweisen.
MCP-Server für Salesforce	MCP-Server für Salesforce
Schließen oder Abbrechen eines Auftrags	Schließt oder bricht einen Auftrag ab. Verwenden Sie UploadComplete, um einen Auftrag zu schließen oder abgebrochen, um einen Auftrag abzubrechen. Wenn Sie einen Auftrag schließen, stellt Salesforce den Auftrag in die Warteschlange und lädt daten zur Verarbeitung hoch, und Sie können keine zusätzlichen Auftragsdaten hinzufügen. Wenn Sie einen Auftrag abbrechen, wird der Auftrag nicht in die Warteschlange eingereiht oder verarbeitet.
Senden einer HTTP-Anforderung	Erstellen einer Salesforce-REST-API-Anforderung zum Aufrufen
Updatedatensatz (V3)	Dieser Vorgang aktualisiert einen Datensatz und lässt Nullwerte zu.

Abrufen aller Aufträge

Vorgangs-ID:

GetAllJobs

Abrufen einer Liste aller Aufträge

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Parallelitätsmodus	concurrenyMode		string	Parallelitätsmodus
Ist PK-Blockierung aktiviert	isPkChunkingEnabled		boolean	Ist PK-Blockierung aktiviert
Auftragstyp	jobType		string	Auftragstyp
Abfrage-Locator	queryLocator		string	Abfrage-Locator

Gibt zurück

Body

GetAllJobsResponse

Abrufen eines Datensatzes nach externer ID

Vorgangs-ID:

GetItemByExternalId

Dieser Vorgang ruft einen Datensatz mithilfe einer externen ID ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Salesforce-Objekttyp	table	True	string	Der Salesforce-Objekttyp wie "Leads".
Externes ID-Feld	externalIdField	True	string	Feld, das als externes ID-Feld im Salesforce-Objekt markiert ist.
Externe ID	externalId	True	string	Externe ID des abzurufenden Datensatzes.

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Abrufen von Auftragsergebnissen

Vorgangs-ID:

GetJobRecordResults

Ruft eine Liste von Datensätzen basierend auf dem Ergebnistyp für einen abgeschlossenen Auftrag ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Auftrags-ID	jobId	True	string	Auftrags-ID
Ergebnistyp	resultType	True	string	Ergebnistyp

Gibt zurück

response

string

Abrufen von Benutzerdatensätzen aus Salesforce

Vorgangs-ID:

GetItems_table_user

Dieser Vorgang ruft Benutzerdatensätze aus Salesforce ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage zum Einschränken der zurückgegebenen Einträge (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Sortieren nach	$orderby		string	Eine OData-Abfrage „orderBy“ zum Angeben der Reihenfolge der Einträge
Höchste Anzahl	$top		integer	Gesamtanzahl abzurufender Einträge (Standard = „all“).
Anzahl überspringen	$skip		integer	Die Anzahl der zu überspringenden Einträge (Standard = 0).
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Abrufen von Datensätzen

Vorgangs-ID:

GetItems

Dieser Vorgang ruft Datensätze eines bestimmten Salesforce-Objekttyps wie "Leads" ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Salesforce-Objekttyp	table	True	string	Der Salesforce-Objekttyp wie "Leads".
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage zum Einschränken der zurückgegebenen Einträge (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Sortieren nach	$orderby		string	Eine OData-Abfrage „orderBy“ zum Angeben der Reihenfolge der Einträge
Höchste Anzahl	$top		integer	Gesamtanzahl abzurufender Einträge (Standard = „all“).
Anzahl überspringen	$skip		integer	Die Anzahl der zu überspringenden Einträge (Standard = 0).
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Abrufen von Falldatensätzen aus Salesforce

Vorgangs-ID:

GetItems_table_case

Dieser Vorgang ruft Falldatensätze von Salesforce ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage zum Einschränken der zurückgegebenen Einträge (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Sortieren nach	$orderby		string	Eine OData-Abfrage „orderBy“ zum Angeben der Reihenfolge der Einträge
Höchste Anzahl	$top		integer	Gesamtanzahl abzurufender Einträge (Standard = „all“).
Anzahl überspringen	$skip		integer	Die Anzahl der zu überspringenden Einträge (Standard = 0).
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Abrufen von Kontaktdatensätzen aus Salesforce

Vorgangs-ID:

GetItems_table_contact

Dieser Vorgang ruft Kontaktdatensätze aus Salesforce ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage zum Einschränken der zurückgegebenen Einträge (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Sortieren nach	$orderby		string	Eine OData-Abfrage „orderBy“ zum Angeben der Reihenfolge der Einträge
Höchste Anzahl	$top		integer	Gesamtanzahl abzurufender Einträge (Standard = „all“).
Anzahl überspringen	$skip		integer	Die Anzahl der zu überspringenden Einträge (Standard = 0).
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Abrufen von Kontodatensätzen aus Salesforce

Vorgangs-ID:

GetItems_table_account

Dieser Vorgang ruft Kontodatensätze aus Salesforce ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage zum Einschränken der zurückgegebenen Einträge (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Sortieren nach	$orderby		string	Eine OData-Abfrage „orderBy“ zum Angeben der Reihenfolge der Einträge
Höchste Anzahl	$top		integer	Gesamtanzahl abzurufender Einträge (Standard = „all“).
Anzahl überspringen	$skip		integer	Die Anzahl der zu überspringenden Einträge (Standard = 0).
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Abrufen von Objekttypen

Vorgangs-ID:

GetTables

Dieser Vorgang listet die verfügbaren Salesforce-Objekttypen auf.

Gibt zurück

Stellt eine Liste von Tabellen dar.

Body

TablesList

Abrufen von Produktdatensätzen aus Salesforce

Vorgangs-ID:

GetItems_table_product2

Dieser Vorgang ruft Produktdatensätze aus Salesforce ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage zum Einschränken der zurückgegebenen Einträge (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Sortieren nach	$orderby		string	Eine OData-Abfrage „orderBy“ zum Angeben der Reihenfolge der Einträge
Höchste Anzahl	$top		integer	Gesamtanzahl abzurufender Einträge (Standard = „all“).
Anzahl überspringen	$skip		integer	Die Anzahl der zu überspringenden Einträge (Standard = 0).
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Abrufen von Verkaufschancendatensätzen aus Salesforce

Vorgangs-ID:

GetItems_table_opportunity

Dieser Vorgang ruft Verkaufschancendatensätze von Salesforce ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage zum Einschränken der zurückgegebenen Einträge (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Sortieren nach	$orderby		string	Eine OData-Abfrage „orderBy“ zum Angeben der Reihenfolge der Einträge
Höchste Anzahl	$top		integer	Gesamtanzahl abzurufender Einträge (Standard = „all“).
Anzahl überspringen	$skip		integer	Die Anzahl der zu überspringenden Einträge (Standard = 0).
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Auftragsinformationen abrufen

Vorgangs-ID:

GetJobInfo

Ruft detaillierte Informationen zu einem Auftrag ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Auftrags-ID	jobId	True	string	Auftrags-ID

Gibt zurück

Body

CheckJobResponse

Ausführen der SOSL-Suchabfrage

Vorgangs-ID:

ExecuteSOSLQuery

Ausführen der angegebenen SOSL-Suchabfrage

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
SOSL-Suchzeichenfolge	q	True	string	SOSL-Suchzeichenfolge

Gibt zurück

SOSL-Suchabfrageantwort

Body

SOSLSearchQueryResponse

Ausführen einer SOQL-Abfrage

Vorgangs-ID:

ExecuteSoqlQuery

Führen Sie eine SOQL-Abfrage aus.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
SOQL-Abfrage	query	True	string	SOQL-Abfragetext. Dynamische Parameter können mithilfe der Syntax "@paramName" angegeben werden.
Abfrageparameter	parameters		object	DYNAMISCHE PARAMETER FÜR SOQL-Abfrage. Der Schlüssel ist der Parametername (ohne '@' bei Zeichen), der Wert ist der Parameterwert.

Gibt zurück

response

object

Datensatz abrufen

Vorgangs-ID:

GetItem_V2

Dieser Vorgang ruft einen Datensatz ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Salesforce-Objekttyp	table	True	string	Tabellenname
Datensatz-ID	id	True	string	Elementschlüssel
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Datensatz abrufen [VERALTET]

Vorgangs-ID:

GetItem

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Datensatz abrufen ".

Dieser Vorgang ruft einen Datensatz ab.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Tisch	table	True	string
id	id	True	string

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Datensatz aktualisieren [VERALTET]

Vorgangs-ID:

PatchItem_V2

Diese Aktion ist veraltet. Verwenden Sie stattdessen den Update-Eintrag (V3 ).

Dieser Vorgang aktualisiert einen Datensatz und lässt Nullwerte zu.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Salesforce-Objekttyp	table	True	string	Tabellenname
Datensatz-ID	id	True	string	Elementschlüssel
Zu aktualisierende Element	item	True	dynamic	Zu aktualisierende Element
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Datensatz aktualisieren [VERALTET]

Vorgangs-ID:

PatchItem

Dieser Vorgang aktualisiert einen Datensatz.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Salesforce-Objekttyp	table	True	string	Der Salesforce-Objekttyp wie "Leads".
Datensatz-ID	id	True	string	Der eindeutige Bezeichner des zu aktualisierenden Datensatzes.
Datensatz	item	True	dynamic	Der Datensatz mit geänderten Eigenschaften.

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Datensatz erstellen

Vorgangs-ID:

PostItem_V2

Dieser Vorgang erstellt einen Datensatz und lässt Nullwerte zu.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Salesforce-Objekttyp	table	True	string	Tabellenname
Datensatz	item	True	dynamic	Datensatz

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Datensatz erstellen [VERALTET]

Vorgangs-ID:

PostItem

Dieser Vorgang erstellt einen Datensatz.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Salesforce-Objekttyp	table	True	string	Der Salesforce-Objekttyp wie "Leads".
Datensatz	item	True	dynamic	Der zu erstellende Datensatz.

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Datensatz löschen

Vorgangs-ID:

DeleteItem

Dieser Vorgang löscht einen Datensatz.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Salesforce-Objekttyp	table	True	string	Der Salesforce-Objekttyp wie "Leads".
Datensatz-ID	id	True	string	Der eindeutige Bezeichner des zu löschenden Datensatzes.

Einfügen oder Aktualisieren (Upsert) eines Datensatzes nach externer ID (V2)

Vorgangs-ID:

PatchItemByExternalIdV2

Mit diesem Vorgang wird ein Datensatz mithilfe einer externen ID eingefügt oder aktualisiert (upserts).

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Salesforce-Objekttyp	table	True	string	Der Salesforce-Objekttyp wie "Leads".
Externes ID-Feld	externalIdField	True	string	Feld, das als externes ID-Feld im Salesforce-Objekt markiert ist.
Externe ID	externalId	True	string	Externe ID des Datensatzes zum Upsert.
Datensatz	item	True	dynamic	Der Datensatz mit geänderten Eigenschaften.

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Einfügen oder Aktualisieren (Upsert) eines Datensatzes nach externer ID [VERALTET]

Vorgangs-ID:

PatchItemByExternalId

Diese Aktion ist veraltet. Verwenden Sie stattdessen "Einfügen" oder "Aktualisieren" (Upsert) für einen Datensatz nach externer ID (V2 ).

Mit diesem Vorgang wird ein Datensatz mithilfe einer externen ID eingefügt oder aktualisiert (upserts).

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Salesforce-Objekttyp	table	True	string	Der Salesforce-Objekttyp wie "Leads".
Externes ID-Feld	externalIdField	True	string	Feld, das als externes ID-Feld im Salesforce-Objekt markiert ist.
Externe ID	externalId	True	string	Externe ID des Datensatzes zum Upsert.
Datensatz	item	True	dynamic	Der Datensatz mit geänderten Eigenschaften.

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Erstellen eines Auftrags (V2)

Vorgangs-ID:

CreateJobV2

Erstellt einen Auftrag, der einen Massenvorgang (und zugehörige Daten) darstellt, der zur asynchronen Verarbeitung an Salesforce gesendet wird. Stellen Sie Auftragsdaten über eine Anforderung zum Hochladen von Auftragsdaten bereit.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Object	object	True	string	Der Objekttyp für die verarbeiteten Daten.
Operation	operation	True	string	Der Verarbeitungsvorgang für den Auftrag.
Spaltentrennzeichen	columnDelimiter		string	Das Spaltentrennzeichen, das für CSV-Auftragsdaten verwendet wird.
Name des externen ID-Felds	externalIdFieldName		string	Das externe ID-Feld im Objekt, das aktualisiert wird. Nur für Upsert-Vorgänge erforderlich. Feldwerte müssen auch in CSV-Auftragsdaten vorhanden sein.
Zeilenende	lineEnding		string	Die Zeile, die für CSV-Auftragsdaten verwendet wird und das Ende einer Datenzeile markiert.
Inhaltstyp	contentType		string	Der Inhaltstyp für den Auftrag.

Gibt zurück

Ausgabe für den Vorgang "CreateJobV2"

Body

CreateJobResponse

Erstellen eines Auftrags [VERALTET]

Vorgangs-ID:

CreateJob

Diese Aktion ist veraltet. Verwenden Sie stattdessen " Auftrag erstellen" (V2 ).

Erstellt einen Auftrag, der einen Massenvorgang (und zugehörige Daten) darstellt, der zur asynchronen Verarbeitung an Salesforce gesendet wird. Stellen Sie Auftragsdaten über eine Anforderung zum Hochladen von Auftragsdaten bereit.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Spaltentrennzeichen	columnDelimiter		string	Spaltentrennzeichen
Name des externen ID-Felds	externalIdFieldName		string	Name des externen ID-Felds
Zeilenende	lineEnding		string	Zeilenende
Object	object	True	string	Object
Operation	operation	True	string	Operation

Gibt zurück

Body

JobInfo

Hochladen von Auftragsdaten

Vorgangs-ID:

UploadJobData

Lädt Daten für einen Auftrag mithilfe von CSV-Daten hoch.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Auftrags-ID	jobId	True	string	Auftrags-ID
CSV-Dateiinhalt	body	True	binary	CSV-Daten zum Hochladen

Löschen eines Auftrags

Vorgangs-ID:

DeleteJob

Löscht einen Auftrag. Um gelöscht zu werden, muss ein Auftrag den Status "UploadComplete", "JobComplete", "Abgebrochen" oder "Fehlgeschlagen" aufweisen.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Auftrags-ID	jobId	True	string	Auftrags-ID

MCP-Server für Salesforce

Vorgangs-ID:

mcp_SalesforceManagement

MCP-Server für Salesforce

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
jsonrpc	jsonrpc		string
id	id		string
method	method		string
Parameter	params		object
Ergebnis	result		object
Fehler	error		object
sessionId	sessionId		string

Gibt zurück

Body

MCPQueryResponse

Schließen oder Abbrechen eines Auftrags

Vorgangs-ID:

CloseJob

Schließt oder bricht einen Auftrag ab. Verwenden Sie UploadComplete, um einen Auftrag zu schließen oder abgebrochen, um einen Auftrag abzubrechen. Wenn Sie einen Auftrag schließen, stellt Salesforce den Auftrag in die Warteschlange und lädt daten zur Verarbeitung hoch, und Sie können keine zusätzlichen Auftragsdaten hinzufügen. Wenn Sie einen Auftrag abbrechen, wird der Auftrag nicht in die Warteschlange eingereiht oder verarbeitet.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Auftrags-ID	jobId	True	string	Auftrags-ID
Staat	state	True	string	Staat

Gibt zurück

Body

JobInfo

Senden einer HTTP-Anforderung

Vorgangs-ID:

HttpRequest

Erstellen einer Salesforce-REST-API-Anforderung zum Aufrufen

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
URI	Uri	True	string	Der vollständige oder relative URI. Beispiel für relativen URI: /services/data/v41.0/sobjects/account
Methode	Method	True	string	Die HTTP-Methode (Standard ist GET).
Body	Body		binary	Der Anforderungstextinhalt.
Inhaltstyp	ContentType		string	Der Inhaltstypheader für den Textkörper (Standard ist Application/json).
CustomHeader1	CustomHeader1		string	Benutzerdefinierte Kopfzeile 1. Im Format angeben: Headername: Headerwert
CustomHeader2	CustomHeader2		string	Benutzerdefinierte Kopfzeile 2. Im Format angeben: Headername: Headerwert
CustomHeader3	CustomHeader3		string	Benutzerdefinierte Kopfzeile 3. Im Format angeben: Headername: Headerwert
CustomHeader4	CustomHeader4		string	Benutzerdefinierte Kopfzeile 4. Im Format angeben: Headername: Headerwert
CustomHeader5	CustomHeader5		string	Benutzerdefinierte Kopfzeile 5. Im Format angeben: Headername: Headerwert

Gibt zurück

response

ObjectWithoutType

Updatedatensatz (V3)

Vorgangs-ID:

PatchItem_V3

Dieser Vorgang aktualisiert einen Datensatz und lässt Nullwerte zu.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Salesforce-Objekttyp	table	True	string	Tabellenname
Datensatz-ID	id	True	string	Elementschlüssel
Zu aktualisierende Element	item	True	dynamic	Zu aktualisierende Element
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Auslöser

Beim Erstellen eines Datensatzes	Dieser Vorgang wird ausgelöst, wenn neu erstellte Datensätze vorhanden sind.
Wenn ein Datensatz geändert wird	Dieser Vorgang wird ausgelöst, wenn neu geänderte Datensätze vorhanden sind.

Beim Erstellen eines Datensatzes

Vorgangs-ID:

GetOnNewItems

Dieser Vorgang wird ausgelöst, wenn neu erstellte Datensätze vorhanden sind.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Salesforce-Objekttyp	table	True	string	Der Salesforce-Objekttyp wie "Leads".
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage zum Einschränken der zurückgegebenen Einträge (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Sortieren nach	$orderby		string	Eine OData-Abfrage „orderBy“ zum Angeben der Reihenfolge der Einträge
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Wenn ein Datensatz geändert wird

Vorgangs-ID:

GetOnUpdatedItems

Dieser Vorgang wird ausgelöst, wenn neu geänderte Datensätze vorhanden sind.

Parameter

Name	Schlüssel	Erforderlich	Typ	Beschreibung
Salesforce-Objekttyp	table	True	string	Der Salesforce-Objekttyp wie "Leads".
Filterabfrage	$filter		string	Eine ODATA-Filterabfrage zum Einschränken der zurückgegebenen Einträge (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Sortieren nach	$orderby		string	Eine OData-Abfrage „orderBy“ zum Angeben der Reihenfolge der Einträge
Abfrage auswählen	$select		string	Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Definitionen

CreateJobResponse

Ausgabe für den Vorgang "CreateJobV2"

Name	Pfad	Typ	Beschreibung
Object	object	string	Der Objekttyp für die verarbeiteten Daten.
Operation	operation	string	Der Verarbeitungsvorgang für den Auftrag.
Spaltentrennzeichen	columnDelimiter	string	Das Spaltentrennzeichen, das für CSV-Auftragsdaten verwendet wird.
Name des externen ID-Felds	externalIdFieldName	string	Das externe ID-Feld im Objekt, das aktualisiert wird. Nur für Upsert-Vorgänge erforderlich. Feldwerte müssen auch in CSV-Auftragsdaten vorhanden sein.
Zeilenende	lineEnding	string	Die Zeile, die für CSV-Auftragsdaten verwendet wird und das Ende einer Datenzeile markiert.
Inhaltstyp	contentType	string	Der Inhaltstyp für den Auftrag.
API-Version	apiVersion	float	Die API-Version, in der der Auftrag erstellt wurde.
Parallelitätsmodus	concurrencyMode	string	Der Parallelitätsmodus für den Auftrag.
Inhalts-URL	contentUrl	string	Die URL, die für Uploadauftragsdatenanforderungen für diesen Auftrag verwendet werden soll. Nur gültig, wenn sich der Auftrag im Zustand "Öffnen" befindet.
Erstellt von ID	createdById	string	Die ID des Benutzers, der den Auftrag erstellt hat.
Erstellt am	createdDate	date-time	Das Datum und die Uhrzeit in der UTC-Zeitzone, in der der Auftrag erstellt wurde.
Id	id	string	Eindeutige ID für diesen Auftrag.
Auftragstyp	jobType	string	Der Auftragstyp.
Staat	state	string	Der aktuelle Status der Verarbeitung für den Auftrag.
System Modstamp	systemModstamp	date-time	Datum und Uhrzeit in der UTC-Zeitzone, wenn der Auftrag abgeschlossen ist.

Table

Stellt eine Tabelle dar.

Name	Pfad	Typ	Beschreibung
Name	Name	string	Der Name der Tabelle. Der Name wird zur Laufzeit verwendet.
Anzeigename	DisplayName	string	Der Anzeigename der Tabelle.
DynamicProperties	DynamicProperties	object	Zusätzliche Tabelleneigenschaften, die vom Connector für die Clients bereitgestellt werden.

TablesList

Stellt eine Liste von Tabellen dar.

Name	Pfad	Typ	Beschreibung
value	value	array of Table	Liste der Tabellen

GetAllJobsResponse

Name	Pfad	Typ	Beschreibung
Done	done	boolean	Done
Aufzeichnungen	records	array of JobInfo
Next Recored URL	nextRecordUrl	string	URL des nächsten Datensatzes

JobInfo

Name	Pfad	Typ	Beschreibung
API-Version	apiVersion	float	API-Version
Spaltentrennzeichen	columnDelimiter	string	Spaltentrennzeichen
Parallelitätsmodus	concurrencyMode	string	Parallelitätsmodus
Inhaltstyp	contentType	string	Inhaltstyp
Inhalts-URL	contentUrl	string	Inhalts-URL
Erstellt anhand der ID	createdById	string	Erstellt anhand der ID
Erstellt am	createdDate	date-time	Erstellt am
Name des externen ID-Felds	externalIdFieldName	string	Name des externen ID-Felds
ID	id	string	ID
Auftragstyp	jobType	string	Auftragstyp
Zeilenende	lineEnding	string	Zeilenende
Object	object	string	Object
Operation	operation	string	Operation
Staat	state	string	Staat
System-Mod-Stempel	systemModstamp	date-time	System-Mod-Stempel

CheckJobResponse

Name	Pfad	Typ	Beschreibung
APEX-Verarbeitungszeit	apexProcessingTime	number	APEX-Verarbeitungszeit
API-Aktive Verarbeitungszeit	apiActiveProcessingTime	number	API-Aktive Verarbeitungszeit
API-Version	apiVersion	float	API-Version
Spaltentrennzeichen	columnDelimiter	string	Spaltentrennzeichen
Parallelitätsmodus	concurrencyMode	string	Parallelitätsmodus
Inhaltstyp	contentType	string	Inhaltstyp
Inhalts-URL	contentUrl	string	Inhalts-URL
Erstellt anhand der ID	createdById	string	Erstellt anhand der ID
Erstellt am	createdDate	date-time	Erstellt am
Name des externen Felds	externalFieldName	string	Name des externen Felds
ID	id	string	ID
Auftragstyp	jobType	string	Auftragstyp
Zeilenende	lineEnding	string	Zeilenende
Object	object	string	Object
Operation	operation	string	Operation
Wiederholungen	retries	number	Wiederholungen
Staat	state	string	Staat
systemModStamp	systemModStamp	date-time
Gesamtverarbeitungszeit	totalProcessingTime	number	Gesamtverarbeitungszeit

SOSLSearchQueryResponse

SOSL-Suchabfrageantwort

Name	Pfad	Typ	Beschreibung
searchRecords	searchRecords	array of SearchRecordObject	Eine Liste von Suchdatensätzen, die von einer SOSL-Suchabfrage zurückgegeben werden

SearchRecordObject

Einzelner Datensatz, der von der SOSL-Abfrage zurückgegeben wird

Name	Pfad	Typ	Beschreibung
type	attributes.type	string	Typ des Datensatzes
URL	attributes.url	string	API-Pfad, der zum Abrufen des Objekts verwendet werden kann
Id	Id	string	Eindeutiger Bezeichner des Datensatzes

ObjectWithoutType

MCPQueryResponse

Name	Pfad	Typ	Beschreibung
jsonrpc	jsonrpc	string
id	id	string
method	method	string
Parameter	params	object
Ergebnis	result	object
Fehler	error	object

Schnur

Dies ist der grundlegende Datentyp "string".

Objekt

Dies ist der Typ 'object'.