CloudTools for Salesforce (Preview)

Apptigent CloudTools poskytuje celou řadu akcí integrace dat pro Salesforce, ke kterým může přistupovat libovolná aplikace nebo pracovní postup připojený ke cloudu.

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)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Logic Apps	Standard	Všechny oblasti Logic Apps s výjimkou následujících:      – Oblasti Azure Government      – Oblasti Azure China      - Ministerstvo obrany USA (DoD)
Power Apps	Premium	Všechny oblasti Power Apps s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)
Power Automate	Premium	Všechny oblasti Power Automate s výjimkou následujících:      – státní správa USA (GCC)      – státní správa USA (GCC High)      - China Cloud provozovaný společností 21Vianet      - Ministerstvo obrany USA (DoD)

Kontakt
Název	Podpora apptigentů
URL	https://www.apptigent.com/help
Email	support@apptigent.com

Metadata konektoru
Vydavatel	Apptigent
Internetová stránka	https://www.apptigent.com
Zásady ochrany osobních údajů	https://www.apptigent.com/help/privacy-policy/
Kategorie	Produktivita

Automatizace důležitých obchodních procesů s bezproblémovou integrací cloudu napříč platformami pro Salesforce Snadno propojte Power Apps a Power Automate s organizací Salesforce a získejte informace o zákaznících, zavřete obchody, vytvořte záznamy, převádějte potenciální zákazníky, spouštět hromadné úlohy, spouštět rychlé akce, nahrávat soubory, přidružit dokumenty k záznamům, kanály aktualizací, načítat propojené soubory a mnoho dalšího. Pomocí SOQL, SOSL a GraphQL můžete dokonce spouštět pokročilé dotazy a seachy. CloudTools odemkne potenciál podnikových dat CRM tím, že je snadno přístupný z libovolné aplikace nebo pracovního postupu.

Požadavky

CloudTools vyžaduje platnou licenci Salesforce, instalaci spravovaného balíčku CloudTools v organizaci Salesforce (libovolnou edici) a aktuální předplatné CloudTools (fakturované samostatně). Podrobné pokyny k tomu, jak začít navštívit https://www.apptigent.com/solutions/cloudtools/configuration.

Jak získat přihlašovací údaje

Pomocí těchto jednoduchých kroků vygenerujte klíč licence (API):

1. Nainstalujte spravovaný balíček CloudTools přes Salesforce App Exchange.
2. Na stránce konfigurace CloudTools vyberte odkaz Apptigent CloudTools ve spouštěči aplikací.
3. Podle pokynů na obrazovce vytvořte připojenou aplikaci a vygenerujte licenční klíč.
4. Zkopírujte klíč a zadejte ho v novém dialogovém okně připojení v Power Apps, Power Automate nebo Azure Logic Apps.

Známé problémy a omezení

Instalace a konfigurace CloudTools pro Salesforce Sales Cloud vyžaduje oprávnění správce systému v Salesforce. Pokud ve vaší organizaci nemáte dostatečná oprávnění, obraťte se na správce Salesforce.

Vytvoření připojení

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

výchozí	Parametry pro vytvoření připojení	Všechny oblasti	Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

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é
Licenční klíč	securestring	Licenční klíč CloudTools	Pravdivé

Limity omezování

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

Akce

Akce – Načtení rychlých akcí	Načtení seznamu všech rychlých akcí v organizaci
Akce – popis rychlé akce	Načtení všech vlastností rychlé akce
Akce – Provedení rychlé akce	Provedení rychlé akce s potřebnými daty
Dotazy – Dotaz GraphQL	Spuštění dotazu Graph QL pro načtení dat objektu a záznamu
Dotazy – Dotaz SOQL	Provedení dotazu SOQL
Dotazy – Vyhledávací dotaz	Spuštění vyhledávacího dotazu (SOSL)
Informační kanály – Vytvoření položky informačního kanálu	Vytvoření nové položky informačního kanálu přidruženého k záznamu
Informační kanály – Získání kanálu záznamů	Načtení kanálu záznamů Chatter
Objekty – aktualizovatelná pole objektu	Načtení aktualizovatelných polí objektu sObject
Objekty – List sObjects	Načtení seznamu všechobjektůch
Objekty – metadata objektů	Načtení metadat objektu sObject
Objekty – pole objektů	Načtení polí objektu sObject
Objekty – popis objektu	Načtení všech metadat a polí objektu sObject
Organizace – nejnovější verze rozhraní API	Získání nejnovější podporované verze rozhraní API pro organizaci
Organizace – Výpis verzí rozhraní API	Získání seznamu všech podporovaných verzí rozhraní API v organizaci
Potenciální zákazníci – převod potenciálního zákazníka	Převod potenciálního zákazníka
Soubory – informace o verzi	Načtení informací o jednotlivých verzích souborů (ContentVersion)
Soubory – metadata dokumentů	Načtení informací o souboru (ContentDocument)
Soubory – Sdílení dokumentu	Přidružení souboru (ContentDocument) k záznamu a nastavení vlastností sdílení
Soubory – verze dokumentů	Načtení seznamu informací o verzi pro jednotlivé soubory (ContentDocument)
Soubory – vytvoření verze	Nahrání souboru jako nového objektu ContentVersion
Soubory – Vytvořit veřejný odkaz	Vytvoření odkazu na veřejný soubor, ke kterému mají přístup neověření uživatelé
Soubory – získání verze	Načtení verze jednotlivých souborů (ContentVersion)
Záznamy – aktualizovat záznam	Aktualizace záznamu zadaného typu objektu
Záznamy – Odstranit záznam	Odstranění záznamu zadaného typu objektu
Záznamy – propojené soubory	Načtení informací o všech souborech propojených se záznamem
Záznamy – vytvořit záznam	Vytvoření nového záznamu zadaného typu objektu
Záznamy – Získání záznamu	Načtení záznamu zadaného typu objektu
Úlohy – Odstranit úlohu	Smazat úlohu
Úlohy – přerušená úloha	Přerušení úlohy
Úlohy – Vytvoření hromadné úlohy dotazu	Vytvoření úlohy hromadného dotazu
Úlohy – Vytvoření úlohy hromadného vložení	Vytvoření úlohy hromadného vložení
Úlohy – Získání stavu hromadné úlohy	Kontrola stavu úlohy
Úlohy – Získání výsledku hromadné úlohy	Získání informací o výsledku hromadné úlohy
Úlohy – Získání všech úloh	Získání informací o všech úlohách

Akce – Načtení rychlých akcí

ID operace:

ActionsListQuickActions

Načtení seznamu všech rychlých akcí v organizaci

Návraty

Body

outputActionList

Akce – popis rychlé akce

ID operace:

ActionsDescribeQuickAction

Načtení všech vlastností rychlé akce

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název	name	True	string	Název objektu nebo položky

Návraty

Body

outputStringResult

Akce – Provedení rychlé akce

ID operace:

ActionsExecuteQuickAction

Provedení rychlé akce s potřebnými daty

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název	name	True	string	Název rychlé akce
Data	data	True	object	Data rychlých akcí

Návraty

Body

outputStringResult

Dotazy – Dotaz GraphQL

ID operace:

QueriesGraphQuery

Spuštění dotazu Graph QL pro načtení dat objektu a záznamu

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Query	query	True	string	Text dotazu GraphQL

Návraty

response

object

Dotazy – Dotaz SOQL

ID operace:

QueriesSOQlQuery

Provedení dotazu SOQL

Parametry

Name	Klíč	Vyžadováno	Typ	Description
dotaz	query	True	string	Text dotazu SOQL (nekódovaný)

Návraty

response

object

Dotazy – Vyhledávací dotaz

ID operace:

QueriesSearchQuery

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

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název	query	True	string	Text vyhledávacího dotazu (nekódovaný)

Návraty

response

object

Informační kanály – Vytvoření položky informačního kanálu

ID operace:

FeedCreateItem

Vytvoření nové položky informačního kanálu přidruženého k záznamu

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Obsah informačního kanálu	body	True	string	Obsah položky informačního kanálu Přijímá hodnoty ve formátu prostého textu nebo objekt JSON messageSegments pro složitější typy příspěvků (viz https://bit.ly/4706k0M).
ID záznamu	recordId	True	string	ID přidruženého záznamu

Návraty

response

object

Informační kanály – Získání kanálu záznamů

ID operace:

FeedsGetRecordElements

Načtení kanálu záznamů Chatter

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID záznamu	recordId	True	string	ID záznamu

Návraty

response

object

Objekty – aktualizovatelná pole objektu

ID operace:

GlobalObjectUpdateFields

Načtení aktualizovatelných polí objektu sObject

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název objektu	name	True	string	Název objektu sObject

Návraty

Body

outputStringResult

Objekty – List sObjects

ID operace:

GlobalListObjects

Načtení seznamu všechobjektůch

Návraty

Body

outputStringResult

Objekty – metadata objektů

ID operace:

GlobalObjectMetadata

Načtení metadat objektu sObject

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název objektu	name	True	string	Název objektu sObject

Návraty

Body

outputStringResult

Objekty – pole objektů

ID operace:

GlobalObjectFields

Načtení polí objektu sObject

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název objektu	name	True	string	Název objektu sObject

Návraty

Body

outputStringResult

Objekty – popis objektu

ID operace:

GlobalDescribeObject

Načtení všech metadat a polí objektu sObject

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Vybrat název objektu	name	True	string	Název objektu sObject

Návraty

Body

outputStringResult

Organizace – nejnovější verze rozhraní API

ID operace:

OrgLatestVersion

Získání nejnovější podporované verze rozhraní API pro organizaci

Návraty

Body

outputStringResult

Organizace – Výpis verzí rozhraní API

ID operace:

OrgListVersions

Získání seznamu všech podporovaných verzí rozhraní API v organizaci

Návraty

Body

outputVersionList

Potenciální zákazníci – převod potenciálního zákazníka

ID operace:

RecordsLeadsConvertLead

Převod potenciálního zákazníka

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID potenciálního zákazníka	leadId	True	string	Identifikátor potenciálního zákazníka
Vytvořit příležitost	createOpportunity		boolean	Vytvoření záznamu příležitosti při převodu Výchozí hodnota je true.
Název příležitosti	opportunityName		string	Nastaví název příležitosti k vytvoření. Pokud není zadán žádný název, tato hodnota se ve výchozím nastavení nastaví na název společnosti zájemce.
Přepsání zdroje potenciálních zájemců	overwriteLeadSource		boolean	Přepište pole LeadSource v cílovém objektu kontaktu obsahem pole LeadSource ve zdrojovém objektu potenciálního zákazníka. Výchozí hodnota je False.
Odeslat e-mail s oznámením	sendNotificationEmail		boolean	Pošlete vlastníkovi e-mail s oznámením. Výchozí hodnota je False.
Sloučení s ID účtu	mergeAccountId		string	ID účtu, do kterého se zájemce sloučí. Používejte pouze při aktualizaci existujícího účtu.
Sloučení s ID kontaktu	mergeContactId		string	ID kontaktu, do kterého bude zájemce sloučen (musí být již přidružen k účtu zadanému v mergeAccountId). Používejte pouze při aktualizaci existujícího kontaktu.
Sloučení s ID příležitosti	mergeOpportunityId		string	ID příležitosti, do které se zájemce sloučí. Používejte pouze při aktualizaci existující příležitosti.
ID vlastníka	ownerId		string	ID osoby, která vlastní jakýkoli nově vytvořený účet, kontakt nebo příležitost. Pokud je hodnota vlastníka potenciálního zákazníka prázdná, použije se.

Návraty

response

object

Soubory – informace o verzi

ID operace:

FilesVersionMetadata

Načtení informací o jednotlivých verzích souborů (ContentVersion)

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID verze	versionId	True	string	ID verze obsahu souboru, která se má načíst

Návraty

response

object

Soubory – metadata dokumentů

ID operace:

FilesDocumentMetadata

Načtení informací o souboru (ContentDocument)

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID dokumentu	documentId	True	string	ID dokumentu obsahu souboru, který se má načíst

Návraty

response

object

Soubory – Sdílení dokumentu

ID operace:

FilesShareDocument

Přidružení souboru (ContentDocument) k záznamu a nastavení vlastností sdílení

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID dokumentu	documentId	True	string	ID souboru (objekt ContentDocument)
ID záznamu	recordId	True	string	ID záznamu, ke které bude soubor přidružen
Viditelnost	visibility	True	string	Uživatelé, kteří mají přístup k souboru
Povolení	permissions	True	string	Oprávnění ke sdílení (Pouze prohlížeč [Jenom prohlížení], Spolupracovníci [Zobrazit/Upravit/Sdílet], Odvozeno ze souvisejícího záznamu)

Návraty

response

object

Soubory – verze dokumentů

ID operace:

FilesListVersions

Načtení seznamu informací o verzi pro jednotlivé soubory (ContentDocument)

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID verze	documentId	True	string	ID objektu dokumentu obsahu obsahujícího verze, které se mají načíst

Návraty

response

object

Soubory – vytvoření verze

ID operace:

FilesCreateVersion

Nahrání souboru jako nového objektu ContentVersion

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název	name		string	Název souboru (včetně přípony)
Title	title		string	Název souboru
ID dokumentu	documentId		string	(Volitelné) ID objektu ContentDocument (používá se pouze při připojování nové verze k existujícímu souboru)
Důvod změny	reasonForChange		string	(Volitelné) Popis změny
File	file		file	Binární data souboru

Návraty

response

object

Soubory – Vytvořit veřejný odkaz

ID operace:

FilesCreatePublicLink

Vytvoření odkazu na veřejný soubor, ke kterému mají přístup neověření uživatelé

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID verze	versionId	True	string	ID verze obsahu souboru
Název souboru	name	True	string	Název souboru
Zobrazit v prohlížeči	viewInBrowser		boolean	Vytvoření odkazu náhledu pro zobrazení v prohlížeči
Povolit stahování	allowDownload		boolean	Vytvoření odkazu ke stažení pro načtení obsahu souboru
Heslo	password		boolean	Heslo
Vypršení platnosti	expiration		string	Datum vypršení platnosti (volitelné)

Návraty

Body

outputPublicLink

Soubory – získání verze

ID operace:

FilesGetVersion

Načtení verze jednotlivých souborů (ContentVersion)

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID verze	versionId	True	string	ID verze souboru, která se má načíst

Návraty

response

object

Záznamy – aktualizovat záznam

ID operace:

GlobalUpdateRecord

Aktualizace záznamu zadaného typu objektu

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Vybrat název objektu	name	True	string	Typ objektu, který se aktualizuje
ID záznamu	recordId	True	string	ID záznamu, který se má aktualizovat
body	body	True	dynamic	Záznam aktualizačního vstupu

Návraty

response

object

Záznamy – Odstranit záznam

ID operace:

GlobalDeleteObject

Odstranění záznamu zadaného typu objektu

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Vybrat název objektu	name	True	string	Typ objektu, který bude odstraněn
ID záznamu	recordId	True	string	ID záznamu, který se má odstranit

Návraty

response

object

Záznamy – propojené soubory

ID operace:

GlobalRecordLinkedFiles

Načtení informací o všech souborech propojených se záznamem

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID záznamu	recordId	True	string	ID záznamu
Typy propojení	linkTypes	True	string	Typ propojených souborů, které se mají zahrnout

Návraty

response

object

Záznamy – vytvořit záznam

ID operace:

GlobalCreateRecord

Vytvoření nového záznamu zadaného typu objektu

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Výběr názvu objektu	name	True	string	Typ objektu, který se vytvoří
body	body	True	dynamic	Vstup pro vytvoření záznamu

Návraty

response

object

Záznamy – Získání záznamu

ID operace:

GlobalGetRecord

Načtení záznamu zadaného typu objektu

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Vybrat název objektu	name	True	string	Typ objektu, který se načte
ID záznamu	recordId	True	string	ID záznamu, který se má načíst

Návraty

response

object

Úlohy – Odstranit úlohu

ID operace:

GlobalJobsDeleteJob

Smazat úlohu

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID	id	True	string	ID objektu
Typ	type	True	string	Typ objektu

Návraty

Body

outputStringResult

Úlohy – přerušená úloha

ID operace:

GlobalJobsAbortJob

Přerušení úlohy

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID	id	True	string	ID objektu
Typ	type	True	string	Typ objektu

Návraty

Body

outputStringResult

Úlohy – Vytvoření hromadné úlohy dotazu

ID operace:

JobsCreateQueryJob

Vytvoření úlohy hromadného dotazu

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Operace dotazu	operation		string	Typ operace dotazu
Oddělovač sloupců	delimiter		string	Oddělovač sloupců ve výstupním souboru
Konec čáry	lineEnding		string	Ukončovací znak výstupního souboru. LF pro Unix/Linux/Mac OS, CRLF pro Windows
Query	query		string	Velký dotaz SOQL sady výsledků (nekódovaný)

Návraty

response

object

Úlohy – Vytvoření úlohy hromadného vložení

ID operace:

JobsCreateInsertJob

Vytvoření úlohy hromadného vložení

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Název objektu	objectName		string	Název typu objektu sObject (např. Opportunity)
Formát souboru	fileFormat		string	Formát souboru (aktuálně se podporuje jenom CSV)
Konec čáry	lineEnding		string	Ukončovací znak vstupního souboru. LF pro Unix/Linus/Mac OS, CRLF pro Windows
File	file		file	Binární data souborů (limit 25 MB)

Návraty

response

object

Úlohy – Získání stavu hromadné úlohy

ID operace:

GlobalJobsGetStatus

Kontrola stavu úlohy

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID	id	True	string	ID objektu
Typ	type	True	string	Typ objektu

Návraty

Body

outputStringResult

Úlohy – Získání výsledku hromadné úlohy

ID operace:

JobsGetJobResult

Získání informací o výsledku hromadné úlohy

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID úlohy	jobId		string	ID úlohy
Typ úlohy	jobType		string	Typ úlohy
Typ výsledku	resultType		string	Typ sady výsledků, která se má načíst
Lokátor	locator		string	Lokátor záznamů
Maximální počet záznamů	maxRecords		string	Maximální počet záznamů, které se mají vrátit

Návraty

response

object

Úlohy – Získání všech úloh

ID operace:

JobsGetAllJobs

Získání informací o všech úlohách

Návraty

response

object

Definice

outputActionList

Name	Cesta	Typ	Description
Results	results	array of object	Results
items	results	object

outputPublicLink

Name	Cesta	Typ	Description
ID objektu	objectId	string	ID objektu distribuce obsahu
Success	success	boolean	Označuje úspěch nebo selhání operace.
Heslo	password	string	Automaticky vygenerovaná hodnota hesla
URL	url	string	Veřejná adresa URL

outputStringResult

Name	Cesta	Typ	Description
výsledek	result	string	Textová odpověď

outputVersionList

Name	Cesta	Typ	Description
Results	results	array of object	Results
items	results	object

objekt

Toto je typ 'objekt'.