Salesforce

Konektor Salesforce poskytuje rozhraní API pro práci s objekty Salesforce.

Tento konektor je dostupný v následujících produktech a oblastech:

Service	Class	Regions
Copilot Studio	Premium	Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet
Logic Apps	Standard	Všechny oblasti Logic Apps
Power Apps	Premium	Všechny oblasti Power Apps s výjimkou následujících: – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet
Power Automate	Premium	Všechny oblasti Power Automate s výjimkou následujících: – státní správa USA (GCC High) - China Cloud provozovaný společností 21Vianet

Metadata konektoru
Vydavatel	Microsoft

K použití této integrace budete potřebovat přístup k účtu Salesforce s povoleným přístupem k rozhraní API. Pokud chcete zjistit, k jakým edicím Salesforce mají přístup rozhraní API, projděte si článek Salesforce. Pokud chcete vytvořit připojení, vyberte Přihlásit se. Zobrazí se výzva k zadání přihlašovacích údajů Salesforce, postupujte podle zbývajících obrazovek a vytvořte připojení. Výchozí verze rozhraní API aktuálně využívaná konektorem je v58.0.

Teď jste připraveni začít tuto integraci používat.

Poznámka:

Konektor Salesforce je nyní k dispozici v aplikaci Microsoft CoPilot Studio.

Známé problémy a omezení

Existuje omezení počtu polí, která může dotaz na Salesforce obsahovat. Limit se liší v závislosti na typu sloupců, počtu vypočítaných sloupců atd. Když se zobrazí chyba Dotaz buď vybírá příliš mnoho polí, nebo jsou podmínky filtru příliš složité, znamená to, že dotaz překročí limit. Abyste tomu předešli, použijte upřesňující možnost Výběr dotazu a zadejte pole, která opravdu potřebujete.
Nastavení relace Salesforce může tuto integraci blokovat. Ujistěte se, že je zakázané nastavení Uzamčení relací na IP adresu, ze které pocházejí .
Přístup k rozhraní API Salesforce by měl být povolený. Pokud chcete ověřit nastavení přístupu, přejděte do nastavení profilu pro aktuálního uživatele a vyhledejte zaškrtávací políčko Povoleno rozhraní API.
Zkušební účty Salesforce nemají přístup k rozhraní API, a proto je nelze použít.
Vlastní pole typu Rozevírací seznam (vícenásobný výběr) nejsou podporována akcemi Vytvořit záznam a aktualizovat záznam (V3) ( včetně příslušných zastaralých verzí).
Vytvoření nového připojení pomocí přihlášení "Vlastní doména" Salesforce se nepodporuje.
Použití polí s možnou hodnotou null v Order By parametru by se mělo vyhnout, protože to může způsobit chybu za běhu v následujících operacích: Získání záznamů při vytvoření záznamu, při vytvoření nebo úpravě záznamu.
Když trigger změny záznamu dokáže rozpoznat pouze změnu záznamu standardního objektu, ale nemůže rozpoznat změnu přílohy standardního objektu.
Následující triggery a akce nemohly správně fungovat u vlastních tabulek bez sloupce ID: Při vytvoření záznamu, při vytvoření nebo úpravě záznamu, získání záznamu, vytvoření záznamu, záznamu aktualizace (V3) a odstranění záznamu.
Když se vytvoří nebo upraví aktivační událost záznamu , vrátí nové i změněné položky. Pokud chcete zkontrolovat, jestli je vrácená položka nová nebo upravená, porovnejte hodnoty polí CreatedDate a LastModifiedDate. U novýchpoložekch V tomto ohledu jsou obě pole povinná pro položky, pro které se tento trigger použije.
Komplexní objekty (objekty s vnořenými objekty, viz příklad níže) nejsou podporovány vytvořením záznamu a záznamu aktualizace (V3) ( včetně příslušných zastaralých verzí). Pokud chcete toto omezení obejít, měly by se použít ploché objektové struktury.
Provedení dotazu SOQL a akce Získání záznamů jsou založené na rozhraní API dotazu. Proto ne všechny záznamy můžou být vráceny z důvodu omezení rozhraní API (např. odstraněných položek).
Pokud dochází k nějakému problému s nastavením dat na výchozí hodnotu pomocí záznamu aktualizace (V3), příčinou je hlavička sforce-auto-assign nastavená na hodnotu true. Pokud chcete tento problém obejít, doporučujeme použít akci Odeslat požadavek HTTP a nastavit vlastní hodnotu hlavičky jako sforce-auto-assign: false.
Konektor Salesforce má speciální zpracování pro ověřování, ale kvůli omezení back-endu Salesforce vyprší platnost tokenů, pokud se po dlouhou dobu nepoužívají, a uživatelé můžou mít chybu "Bad_OAuth_Token/Relace vypršela nebo je neplatná". Znovu se přihlaste pomocí svých přihlašovacích údajů.
- Toto omezení je nyní vyřešeno, ale pro použití se musí vytvořit nové připojení. Stávající připojení bude stále fungovat, ale výše uvedený problém může narazit.

Příklad komplexního objektu, který není podporován, protože obsahuje vnořený objekt s polem MerchandiseExtID__c:

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

Příklad výše uvedeného komplexního objektu se přepíše jako plochý objekt, který je podporován:

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

Nahrání příloh

Rozhraní Salesforce API podporuje nahrávání příloh pro následující objekty: Account(Účet), Asset (Asset), Campaign (Kampaň), Case (Případ), Contact (Případ), Contact (Kontakt), Contract (Kontrakt), Custom objects (Vlastní objekty), EmailMessage (E-mailová zpráva), EmailTemplate (EmailTemplate), Event (Událost), Lead (Zájemce), Opportunity (Příležitost), Product2 (Produkt2), Solution (Řešení). Pokud chcete nahrát soubor přílohy, použijte akci Vytvořit záznam a projděte si stránku dokumentace Salesforce o požadovaných polích a parametrech.

Delegovatelné funkce a operace Power Apps pro Salesforce

Tyto operace Power Apps pro daný datový typ můžou být delegovány do Salesforce pro zpracování (místo místního zpracování v Power Apps).

Funkce nejvyšší úrovně

	Delegovatelné
Průměr	Ne
Filter	Ano
LookUp	Ano
Max	Ne
Minuta	Ne
Search	Ano
Seřadit	Ano
SortByColumns	Ano
Suma	Ne

Predikáty filtrování a vyhledávání

	Salesforce
Ne	Ano
IsBlank	Ne
TrimEnds	Ne
Len	Ne
+, -	Ne
<, <=, =, <>, , >>=	Ano
A (&&&), Nebo (\|\|), Ne (!)	Ano
v	Ano
StartsWith	Ne

Konektor do hloubky

Další informace o konektoru najdete v podrobné části.

Obecné limity

Název	Hodnota
Maximální počet žádostí zpracovávaných konektorem současně	50

Vytvoření připojení

Konektor podporuje následující typy ověřování:


Přihlášení pomocí vlastního identifikátoru URI pro přihlášení Salesforce	Přihlášení pomocí vlastního identifikátoru URI pro přihlášení Salesforce	Pouze státní správa USA (GCC)	Sdíletelný
Přihlášení pomocí účtu Salesforce	Zadejte přihlašovací údaje Salesforce pro přihlášení.	Všechny oblasti	Sdíletelný
Výchozí [ZASTARALÉ]	Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu.	Všechny oblasti	Nesdílitelné

ID ověřování: CustomLoginURIAuth

Platné: Pouze státní správa USA (GCC)

Přihlášení pomocí vlastního identifikátoru URI pro přihlášení Salesforce

Toto připojení je možné sdílet. Pokud se power app sdílí s jiným uživatelem, sdílí se i připojení. Další informace najdete v přehledu konektorů pro aplikace plátna – Power Apps | Microsoft Docs

Název	Typ	Description	Povinné
Identifikátor URI přihlášení Salesforce	řetězec	https://custom-domain-or-instance.my.salesforce.com	Pravdivé
Verze rozhraní API Salesforce	řetězec	Verze rozhraní SALESFORCE API. Ve výchozím nastavení ponechte prázdné nebo použijte v58.0.

ID ověřování: BasicAuthentication

Použitelné: Všechny oblasti

Zadejte přihlašovací údaje Salesforce pro přihlášení.

Název	Typ	Description	Povinné
Identifikátor URI přihlášení (prostředí)	řetězec	Identifikátor URI přihlášení Salesforce. Pro produkční prostředí ponechte prázdné nebo použijte https://login.salesforce.com
Verze rozhraní API Salesforce	řetězec	Verze rozhraní SALESFORCE API. Ve výchozím nastavení ponechte prázdné nebo použijte v58.0.

Výchozí [ZASTARALÉ]

Použitelné: Všechny oblasti

Tato možnost je určená pouze pro starší připojení bez explicitního typu ověřování a poskytuje se pouze pro zpětnou kompatibilitu.

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název	Typ	Description	Povinné
Identifikátor URI přihlášení (prostředí)	řetězec	Identifikátor URI přihlášení Salesforce. Pro produkční prostředí ponechte prázdné nebo použijte https://login.salesforce.com
Verze rozhraní API Salesforce	řetězec	Verze rozhraní SALESFORCE API. Ve výchozím nastavení ponechte prázdné nebo použijte v58.0.

Limity omezování

Name	Volání	Období obnovení
Volání rozhraní API na připojení	900	60 sekund

Akce

Aktualizace záznamu (V3)	Tato operace aktualizuje záznam a povolí hodnoty null.
Aktualizovat záznam [ZASTARALÉ]	Tato akce je zastaralá. Místo toho použijte aktualizovat záznam (V3 ). ~~Tato operace aktualizuje záznam a povolí hodnoty null.~~
Aktualizovat záznam [ZASTARALÉ]	Tato operace aktualizuje záznam.
Nahrání dat úlohy	Nahraje data pro úlohu pomocí dat CSV.
Odeslání požadavku HTTP	Vytvoření požadavku rozhraní REST API Salesforce pro vyvolání
Odstranit záznam	Tato operace odstraní záznam.
Provedení dotazu SOQL	Spusťte dotaz SOQL.
Server MCP pro Salesforce	Server MCP pro Salesforce
Smazat úlohu	Odstraní úlohu. Aby byla úloha odstraněna, musí mít stav UploadComplete, JobComplete, Aborted neboFailed.
Spuštění vyhledávacího dotazu SOSL	Spusťte zadané vyhledávání SOSL qyery.
Vložení nebo aktualizace záznamu podle externího ID (V2)	Tato operace vloží nebo aktualizuje záznam pomocí externího ID.
Vložení nebo aktualizace záznamu podle externího ID [ZASTARALÉ]	Tato akce je zastaralá. Místo toho použijte příkaz Vložit nebo Aktualizovat (Upsert) záznam podle externího ID (V2). ~~Tato operace vloží nebo aktualizuje záznam pomocí externího ID.~~
Vytvoření záznamu	Tato operace vytvoří záznam a povolí hodnoty null.
Vytvoření záznamu [ZASTARALÉ]	Tato operace vytvoří záznam.
Vytvoření úlohy (V2)	Vytvoří úlohu, která představuje hromadnou operaci (a přidružená data), která se odešle do Salesforce pro asynchronní zpracování. Zadejte data úlohy prostřednictvím žádosti o nahrání dat úlohy.
Vytvoření úlohy [ZASTARALÉ]	Tato akce je zastaralá. Místo toho použijte vytvořit úlohu (V2 ). Vytvoří úlohu, která představuje hromadnou operaci (a přidružená data), která se odešle do Salesforce pro asynchronní zpracování. Zadejte data úlohy prostřednictvím žádosti o nahrání dat úlohy.
Zavření nebo přerušení úlohy	Zavře nebo přeruší úlohu. Pomocí funkce UploadComplete zavřete úlohu nebo ji přerušíte. Pokud úlohu zavřete, Salesforce zařadí úlohu do fronty a nahraná data ke zpracování a nemůžete přidat žádná další data úlohy. Pokud úlohu přerušíte, úloha se nezařadí do fronty ani nezpracuje.
Získání informací o úloze	Načte podrobné informace o úloze.
Získání typů objektů	Tato operace obsahuje seznam dostupných typů objektů Salesforce.
Získání výsledků úlohy	Načte seznam záznamů na základě typu výsledku pro dokončenou úlohu.
Získání všech úloh	Získání seznamu všech úloh
Získání záznamu	Tato operace získá záznam.
Získání záznamu [ZASTARALÉ]	Tato akce je zastaralá. Místo toho použijte get record . ~~Tato operace získá záznam.~~
Získání záznamu podle externího ID	Tato operace načte záznam pomocí externího ID.
Získání záznamů	Tato operace získá záznamy určitého typu objektu Salesforce, jako jsou Potenciální zákazníci.
Získání záznamů kontaktů ze Salesforce	Tato operace získá záznamy kontaktů ze salesforce.
Získání záznamů o produktech ze Salesforce	Tato operace získá záznamy o produktech ze salesforce.
Získání záznamů příležitostí ze Salesforce	Tato operace získá záznamy příležitostí ze salesforce.
Získání záznamů případu ze Salesforce	Tato operace získá záznamy případu ze salesforce.
Získání záznamů uživatelů ze Salesforce	Tato operace získá záznamy uživatelů ze salesforce.
Získání záznamů účtu ze Salesforce	Tato operace získá záznamy účtů ze salesforce.

Aktualizace záznamu (V3)

ID operace:: PatchItem_V3

Tato operace aktualizuje záznam a povolí hodnoty null.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ objektu Salesforce	table	True	string	název tabulky
ID záznamu	id	True	string	klíč položky
položka, která se má aktualizovat	item	True	dynamic	položka, která se má aktualizovat
Výběr dotazu	$select		string	Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Aktualizovat záznam [ZASTARALÉ]

ID operace:: PatchItem_V2

Tato akce je zastaralá. Místo toho použijte aktualizovat záznam (V3 ).

~~Tato operace aktualizuje záznam a povolí hodnoty null.~~

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ objektu Salesforce	table	True	string	název tabulky
ID záznamu	id	True	string	klíč položky
položka, která se má aktualizovat	item	True	dynamic	položka, která se má aktualizovat
Výběr dotazu	$select		string	Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Aktualizovat záznam [ZASTARALÉ]

ID operace:: PatchItem

Tato operace aktualizuje záznam.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ objektu Salesforce	table	True	string	Typ objektu Salesforce, jako je Potenciální zákazníci.
ID záznamu	id	True	string	Jedinečný identifikátor záznamu, který se má aktualizovat.
Záznam	item	True	dynamic	Záznam se změněnými vlastnostmi.

Návraty

Výstupy této operace jsou dynamické.

Nahrání dat úlohy

ID operace:: UploadJobData

Nahraje data pro úlohu pomocí dat CSV.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID úlohy	jobId	True	string	ID úlohy
Obsah souboru CSV	body	True	binary	Data CSV k nahrání

Odeslání požadavku HTTP

ID operace:: HttpRequest

Vytvoření požadavku rozhraní REST API Salesforce pro vyvolání

Parametry

Name	Klíč	Vyžadováno	Typ	Description
identifikátor URI	Uri	True	string	Úplný nebo relativní identifikátor URI. Příklad relativního identifikátoru URI: /services/data/v41.0/sobjects/account
Metoda	Method	True	string	Metoda HTTP (výchozí hodnota je GET).
Body	Body		binary	Základní obsah požadavku.
Typ obsahu	ContentType		string	Hlavička typu obsahu pro tělo (výchozí hodnota je application/json).
CustomHeader1	CustomHeader1		string	Vlastní hlavička 1. Zadejte ve formátu: header-name: header-value
CustomHeader2	CustomHeader2		string	Vlastní hlavička 2. Zadejte ve formátu: header-name: header-value
CustomHeader3	CustomHeader3		string	Vlastní hlavička 3. Zadejte ve formátu: header-name: header-value
CustomHeader4	CustomHeader4		string	Vlastní hlavička 4. Zadejte ve formátu: header-name: header-value
CustomHeader5	CustomHeader5		string	Vlastní hlavička 5. Zadejte ve formátu: header-name: header-value

Návraty

response: ObjectWithoutType

Odstranit záznam

ID operace:: DeleteItem

Tato operace odstraní záznam.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ objektu Salesforce	table	True	string	Typ objektu Salesforce, jako je Potenciální zákazníci.
ID záznamu	id	True	string	Jedinečný identifikátor záznamu, který chcete odstranit.

Provedení dotazu SOQL

ID operace:: ExecuteSoqlQuery

Spusťte dotaz SOQL.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Dotaz SOQL	query	True	string	Text dotazu SOQL Dynamické parametry je možné zadat pomocí syntaxe @paramName.
Parametry dotazu	parameters		object	Dynamické parametry dotazu SOQL Klíč je název parametru (bez znaku @), hodnota je hodnota parametru.

Návraty

response: object

Server MCP pro Salesforce

ID operace:: mcp_SalesforceManagement

Server MCP pro Salesforce

Parametry

Name	Klíč	Typ
jsonrpc	jsonrpc	string
identifikační číslo	id	string
metoda	method	string
parametry	params	object
výsledek	result	object
chyba	error	object
sessionId	sessionId	string

Návraty

Body: MCPQueryResponse

Smazat úlohu

ID operace:: DeleteJob

Odstraní úlohu. Aby byla úloha odstraněna, musí mít stav UploadComplete, JobComplete, Aborted neboFailed.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID úlohy	jobId	True	string	ID úlohy

Spuštění vyhledávacího dotazu SOSL

ID operace:: ExecuteSOSLQuery

Spusťte zadané vyhledávání SOSL qyery.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Hledaný řetězec SOSL	q	True	string	Hledaný řetězec SOSL

Návraty

Odpověď vyhledávacího dotazu SOSL

Body: SOSLSearchQueryResponse

Vložení nebo aktualizace záznamu podle externího ID (V2)

ID operace:: PatchItemByExternalIdV2

Tato operace vloží nebo aktualizuje záznam pomocí externího ID.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ objektu Salesforce	table	True	string	Typ objektu Salesforce, jako je Potenciální zákazníci.
Pole externího ID	externalIdField	True	string	Pole označené jako pole externího ID v objektu Salesforce.
Externí ID	externalId	True	string	Externí ID záznamu pro upsert.
Záznam	item	True	dynamic	Záznam se změněnými vlastnostmi.

Návraty

Výstupy této operace jsou dynamické.

Vložení nebo aktualizace záznamu podle externího ID [ZASTARALÉ]

ID operace:: PatchItemByExternalId

Tato akce je zastaralá. Místo toho použijte příkaz Vložit nebo Aktualizovat (Upsert) záznam podle externího ID (V2).

~~Tato operace vloží nebo aktualizuje záznam pomocí externího ID.~~

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ objektu Salesforce	table	True	string	Typ objektu Salesforce, jako je Potenciální zákazníci.
Pole externího ID	externalIdField	True	string	Pole označené jako pole externího ID v objektu Salesforce.
Externí ID	externalId	True	string	Externí ID záznamu pro upsert.
Záznam	item	True	dynamic	Záznam se změněnými vlastnostmi.

Návraty

Výstupy této operace jsou dynamické.

Vytvoření záznamu

ID operace:: PostItem_V2

Tato operace vytvoří záznam a povolí hodnoty null.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ objektu Salesforce	table	True	string	název tabulky
Záznam	item	True	dynamic	Záznam

Návraty

Výstupy této operace jsou dynamické.

Vytvoření záznamu [ZASTARALÉ]

ID operace:: PostItem

Tato operace vytvoří záznam.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ objektu Salesforce	table	True	string	Typ objektu Salesforce, jako je Potenciální zákazníci.
Záznam	item	True	dynamic	Záznam, který chcete vytvořit.

Návraty

Výstupy této operace jsou dynamické.

Vytvoření úlohy (V2)

ID operace:: CreateJobV2

Vytvoří úlohu, která představuje hromadnou operaci (a přidružená data), která se odešle do Salesforce pro asynchronní zpracování. Zadejte data úlohy prostřednictvím žádosti o nahrání dat úlohy.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Object	object	True	string	Typ objektu pro zpracovávaná data.
Operation	operation	True	string	Operace zpracování úlohy.
Oddělovač sloupců	columnDelimiter		string	Oddělovač sloupců používaný pro data úlohy CSV.
Název pole externího ID	externalIdFieldName		string	Pole externího ID v objektu, který se aktualizuje. Pouze potřebné pro operace upsertu. Hodnoty polí musí existovat také v datech úlohy CSV.
Konec čáry	lineEnding		string	Konec řádku používaný pro data úlohy CSV označující konec datového řádku.
Typ obsahu	contentType		string	Typ obsahu pro úlohu.

Návraty

Výstup operace CreateJobV2

Body: CreateJobResponse

Vytvoření úlohy [ZASTARALÉ]

ID operace:: CreateJob

Tato akce je zastaralá. Místo toho použijte vytvořit úlohu (V2 ).

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Oddělovač sloupců	columnDelimiter		string	Oddělovač sloupců
Název pole externího ID	externalIdFieldName		string	Název pole externího ID
Konec čáry	lineEnding		string	Konec čáry
Object	object	True	string	Object
Operation	operation	True	string	Operation

Návraty

Body: JobInfo

Zavření nebo přerušení úlohy

ID operace:: CloseJob

Zavře nebo přeruší úlohu. Pomocí funkce UploadComplete zavřete úlohu nebo ji přerušíte. Pokud úlohu zavřete, Salesforce zařadí úlohu do fronty a nahraná data ke zpracování a nemůžete přidat žádná další data úlohy. Pokud úlohu přerušíte, úloha se nezařadí do fronty ani nezpracuje.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID úlohy	jobId	True	string	ID úlohy
stav	state	True	string	stav

Návraty

Body: JobInfo

Získání informací o úloze

ID operace:: GetJobInfo

Načte podrobné informace o úloze.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID úlohy	jobId	True	string	ID úlohy

Návraty

Body: CheckJobResponse

Získání typů objektů

ID operace:: GetTables

Tato operace obsahuje seznam dostupných typů objektů Salesforce.

Návraty

Představuje seznam tabulek.

Body: TablesList

Získání výsledků úlohy

ID operace:: GetJobRecordResults

Načte seznam záznamů na základě typu výsledku pro dokončenou úlohu.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID úlohy	jobId	True	string	ID úlohy
Typ výsledku	resultType	True	string	Typ výsledku

Návraty

response: string

Získání všech úloh

ID operace:: GetAllJobs

Získání seznamu všech úloh

Parametry

Name	Klíč	Typ	Description
Režim souběžnosti	concurrenyMode	string	Režim souběžnosti
Je povolené vytváření bloků dat PK.	isPkChunkingEnabled	boolean	Je povolené vytváření bloků dat PK.
Typ úlohy	jobType	string	Typ úlohy
Lokátor dotazů	queryLocator	string	Lokátor dotazů

Návraty

Body: GetAllJobsResponse

Získání záznamu

ID operace:: GetItem_V2

Tato operace získá záznam.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ objektu Salesforce	table	True	string	název tabulky
ID záznamu	id	True	string	klíč položky
Výběr dotazu	$select		string	Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Získání záznamu [ZASTARALÉ]

ID operace:: GetItem

Tato akce je zastaralá. Místo toho použijte get record .

~~Tato operace získá záznam.~~

Parametry

Name	Klíč	Vyžadováno	Typ	Description
tabulka	table	True	string
identifikační číslo	id	True	string

Návraty

Výstupy této operace jsou dynamické.

Získání záznamu podle externího ID

ID operace:: GetItemByExternalId

Tato operace načte záznam pomocí externího ID.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ objektu Salesforce	table	True	string	Typ objektu Salesforce, jako je Potenciální zákazníci.
Pole externího ID	externalIdField	True	string	Pole označené jako pole externího ID v objektu Salesforce.
Externí ID	externalId	True	string	Externí ID záznamu, které se má načíst.

Návraty

Výstupy této operace jsou dynamické.

Získání záznamů

ID operace:: GetItems

Tato operace získá záznamy určitého typu objektu Salesforce, jako jsou Potenciální zákazníci.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ objektu Salesforce	table	True	string	Typ objektu Salesforce, jako je Potenciální zákazníci.
Dotaz filtru	$filter		string	Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle	$orderby		string	Dotaz ODATA orderBy pro určení pořadí položek.
Maximální počet	$top		integer	Celkový počet položek k načtení (výchozí = všechny).
Přeskočit počet	$skip		integer	Počet položek, které se mají přeskočit (výchozí hodnota = 0).
Výběr dotazu	$select		string	Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Získání záznamů kontaktů ze Salesforce

ID operace:: GetItems_table_contact

Tato operace získá záznamy kontaktů ze salesforce.

Parametry

Name	Klíč	Typ	Description
Dotaz filtru	$filter	string	Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle	$orderby	string	Dotaz ODATA orderBy pro určení pořadí položek.
Maximální počet	$top	integer	Celkový počet položek k načtení (výchozí = všechny).
Přeskočit počet	$skip	integer	Počet položek, které se mají přeskočit (výchozí hodnota = 0).
Výběr dotazu	$select	string	Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Získání záznamů o produktech ze Salesforce

ID operace:: GetItems_table_product2

Tato operace získá záznamy o produktech ze salesforce.

Parametry

Name	Klíč	Typ	Description
Dotaz filtru	$filter	string	Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle	$orderby	string	Dotaz ODATA orderBy pro určení pořadí položek.
Maximální počet	$top	integer	Celkový počet položek k načtení (výchozí = všechny).
Přeskočit počet	$skip	integer	Počet položek, které se mají přeskočit (výchozí hodnota = 0).
Výběr dotazu	$select	string	Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Získání záznamů příležitostí ze Salesforce

ID operace:: GetItems_table_opportunity

Tato operace získá záznamy příležitostí ze salesforce.

Parametry

Name	Klíč	Typ	Description
Dotaz filtru	$filter	string	Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle	$orderby	string	Dotaz ODATA orderBy pro určení pořadí položek.
Maximální počet	$top	integer	Celkový počet položek k načtení (výchozí = všechny).
Přeskočit počet	$skip	integer	Počet položek, které se mají přeskočit (výchozí hodnota = 0).
Výběr dotazu	$select	string	Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Získání záznamů případu ze Salesforce

ID operace:: GetItems_table_case

Tato operace získá záznamy případu ze salesforce.

Parametry

Name	Klíč	Typ	Description
Dotaz filtru	$filter	string	Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle	$orderby	string	Dotaz ODATA orderBy pro určení pořadí položek.
Maximální počet	$top	integer	Celkový počet položek k načtení (výchozí = všechny).
Přeskočit počet	$skip	integer	Počet položek, které se mají přeskočit (výchozí hodnota = 0).
Výběr dotazu	$select	string	Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Získání záznamů uživatelů ze Salesforce

ID operace:: GetItems_table_user

Tato operace získá záznamy uživatelů ze salesforce.

Parametry

Name	Klíč	Typ	Description
Dotaz filtru	$filter	string	Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle	$orderby	string	Dotaz ODATA orderBy pro určení pořadí položek.
Maximální počet	$top	integer	Celkový počet položek k načtení (výchozí = všechny).
Přeskočit počet	$skip	integer	Počet položek, které se mají přeskočit (výchozí hodnota = 0).
Výběr dotazu	$select	string	Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Získání záznamů účtu ze Salesforce

ID operace:: GetItems_table_account

Tato operace získá záznamy účtů ze salesforce.

Parametry

Name	Klíč	Typ	Description
Dotaz filtru	$filter	string	Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle	$orderby	string	Dotaz ODATA orderBy pro určení pořadí položek.
Maximální počet	$top	integer	Celkový počet položek k načtení (výchozí = všechny).
Přeskočit počet	$skip	integer	Počet položek, které se mají přeskočit (výchozí hodnota = 0).
Výběr dotazu	$select	string	Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Aktivační události

Při vytvoření záznamu	Tato operace se aktivuje při nově vytvořených záznamech.
Při změně záznamu	Tato operace se aktivuje v případě nově změněných záznamů.

Při vytvoření záznamu

ID operace:: GetOnNewItems

Tato operace se aktivuje při nově vytvořených záznamech.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ objektu Salesforce	table	True	string	Typ objektu Salesforce, jako je Potenciální zákazníci.
Dotaz filtru	$filter		string	Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle	$orderby		string	Dotaz ODATA orderBy pro určení pořadí položek.
Výběr dotazu	$select		string	Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Při změně záznamu

ID operace:: GetOnUpdatedItems

Tato operace se aktivuje v případě nově změněných záznamů.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Typ objektu Salesforce	table	True	string	Typ objektu Salesforce, jako je Potenciální zákazníci.
Dotaz filtru	$filter		string	Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Seřadit podle	$orderby		string	Dotaz ODATA orderBy pro určení pořadí položek.
Výběr dotazu	$select		string	Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Definice

CreateJobResponse

Výstup operace CreateJobV2

Name	Cesta	Typ	Description
Object	object	string	Typ objektu pro zpracovávaná data.
Operation	operation	string	Operace zpracování úlohy.
Oddělovač sloupců	columnDelimiter	string	Oddělovač sloupců používaný pro data úlohy CSV.
Název pole externího ID	externalIdFieldName	string	Pole externího ID v objektu, který se aktualizuje. Pouze potřebné pro operace upsertu. Hodnoty polí musí existovat také v datech úlohy CSV.
Konec čáry	lineEnding	string	Konec řádku používaný pro data úlohy CSV označující konec datového řádku.
Typ obsahu	contentType	string	Typ obsahu pro úlohu.
Verze rozhraní API	apiVersion	float	Verze rozhraní API, ve které byla úloha vytvořena.
Režim souběžnosti	concurrencyMode	string	Režim souběžnosti pro úlohu.
Adresa URL obsahu	contentUrl	string	Adresa URL, která se má použít pro požadavky na nahrání dat úlohy pro tuto úlohu. Platí pouze v případě, že je úloha ve stavu Otevřít.
Vytvořil(a) ID	createdById	string	ID uživatele, který úlohu vytvořil.
Datum vytvoření	createdDate	date-time	Datum a čas v časovém pásmu UTC při vytvoření úlohy.
identifikační číslo	id	string	Jedinečné ID pro tuto úlohu
Typ úlohy	jobType	string	Typ úlohy.
Stát	state	string	Aktuální stav zpracování úlohy.
Modstamp systému	systemModstamp	date-time	Datum a čas v časovém pásmu UTC po dokončení úlohy

Table

Představuje tabulku.

Name	Cesta	Typ	Description
Název	Name	string	Název tabulky. Název se používá za běhu.
ZobrazovanéJméno	DisplayName	string	Zobrazovaný název tabulky.
DynamicProperties	DynamicProperties	object	Další vlastnosti tabulky poskytované konektorem klientům

TablesList

Představuje seznam tabulek.

Name	Cesta	Typ	Description
value	value	array of Table	Seznam tabulek

GetAllJobsResponse

Name	Cesta	Typ	Description
Hotovo	done	boolean	Hotovo
záznamy	records	array of JobInfo
Další adresa URL s hodnocením	nextRecordUrl	string	Adresa URL dalšího záznamu

JobInfo

Name	Cesta	Typ	Description
Verze rozhraní API	apiVersion	float	Verze rozhraní API
Oddělovač sloupců	columnDelimiter	string	Oddělovač sloupců
Režim souběžnosti	concurrencyMode	string	Režim souběžnosti
Typ obsahu	contentType	string	Typ obsahu
Adresa URL obsahu	contentUrl	string	Adresa URL obsahu
Vytvořeno podle ID	createdById	string	Vytvořeno podle ID
Datum vytvoření	createdDate	date-time	Datum vytvoření
Název pole externího ID	externalIdFieldName	string	Název pole externího ID
ID	id	string	ID
Typ úlohy	jobType	string	Typ úlohy
Konec čáry	lineEnding	string	Konec čáry
Object	object	string	Object
Operation	operation	string	Operation
Stát	state	string	Stát
Systémová modální razítka	systemModstamp	date-time	Systémová modální razítka

CheckJobResponse

Name	Cesta	Typ	Description
Doba zpracování APEX	apexProcessingTime	number	Doba zpracování APEX
Doba aktivního zpracování rozhraní API	apiActiveProcessingTime	number	Doba aktivního zpracování rozhraní API
Verze rozhraní API	apiVersion	float	Verze rozhraní API
Oddělovač sloupců	columnDelimiter	string	Oddělovač sloupců
Režim souběžnosti	concurrencyMode	string	Režim souběžnosti
Typ obsahu	contentType	string	Typ obsahu
Adresa URL obsahu	contentUrl	string	Adresa URL obsahu
Vytvořeno podle ID	createdById	string	Vytvořeno podle ID
Datum vytvoření	createdDate	date-time	Datum vytvoření
Název externího pole	externalFieldName	string	Název externího pole
ID	id	string	ID
Typ úlohy	jobType	string	Typ úlohy
Konec čáry	lineEnding	string	Konec čáry
Object	object	string	Object
Operation	operation	string	Operation
Opakování	retries	number	Opakování
Stát	state	string	Stát
systemModStamp	systemModStamp	date-time
Celková doba zpracování	totalProcessingTime	number	Celková doba zpracování

SOSLSearchQueryResponse

Odpověď vyhledávacího dotazu SOSL

Name	Cesta	Typ	Description
searchRecords	searchRecords	array of SearchRecordObject	Seznam vyhledávacích záznamů vrácených vyhledávacím dotazem SOSL

SearchRecordObject

Individuální záznam vrácený dotazem SOSL

Name	Cesta	Typ	Description
typ	attributes.type	string	Typ záznamu
adresa URL	attributes.url	string	Cesta rozhraní API, která se dá použít k načtení objektu
identifikační číslo	Id	string	Jedinečný identifikátor záznamu

ObjectWithoutType

MCPQueryResponse

Name	Cesta	Typ
jsonrpc	jsonrpc	string
identifikační číslo	id	string
metoda	method	string
parametry	params	object
výsledek	result	object
chyba	error	object

řetězec

Toto je základní datový typ String.

objekt

Toto je typ "object".

Sdílet prostřednictvím

Salesforce

Známé problémy a omezení

Nahrání příloh

Delegovatelné funkce a operace Power Apps pro Salesforce

Funkce nejvyšší úrovně

Predikáty filtrování a vyhledávání

Konektor do hloubky

Obecné limity

Vytvoření připojení

Přihlášení pomocí vlastního identifikátoru URI pro přihlášení Salesforce

Přihlášení pomocí účtu Salesforce

Výchozí [ZASTARALÉ]

Limity omezování

Akce

Aktualizace záznamu (V3)

Parametry

Návraty

Aktualizovat záznam [ZASTARALÉ]

Parametry

Návraty

Aktualizovat záznam [ZASTARALÉ]

Parametry

Návraty

Nahrání dat úlohy

Parametry

Odeslání požadavku HTTP

Parametry

Návraty

Odstranit záznam

Parametry

Provedení dotazu SOQL

Parametry

Návraty

Server MCP pro Salesforce

Parametry

Návraty

Smazat úlohu

Parametry

Spuštění vyhledávacího dotazu SOSL

Parametry

Návraty

Vložení nebo aktualizace záznamu podle externího ID (V2)

Parametry

Návraty

Vložení nebo aktualizace záznamu podle externího ID [ZASTARALÉ]

Parametry

Návraty

Vytvoření záznamu

Parametry

Návraty

Vytvoření záznamu [ZASTARALÉ]

Parametry

Návraty

Vytvoření úlohy (V2)

Parametry

Návraty

Vytvoření úlohy [ZASTARALÉ]

Parametry

Návraty

Zavření nebo přerušení úlohy

Parametry

Návraty

Získání informací o úloze

Parametry

Návraty

Získání typů objektů

Návraty

Získání výsledků úlohy

Parametry

Návraty

Získání všech úloh

Parametry

Návraty

Získání záznamu

Parametry

Návraty

Získání záznamu [ZASTARALÉ]

Parametry

Návraty