CloudTools for Salesforce (előzetes verzió)

Az Apptigent CloudTools számos adatintegrációs műveletet biztosít a Salesforce számára, amelyeket bármely felhőalapú alkalmazás vagy munkafolyamat elérhet.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service	Class	Régiók
Copilot Studio	prémium	Az összes Power Automate-régió, kivéve a következőket:      - USA kormánya (GCC)      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások	Standard	Az összes Logic Apps-régió , kivéve a következőket:      - Azure Government-régiók      - Azure China-régiók      - Amerikai Védelmi Minisztérium (DoD)
Power Alkalmazások	prémium	Az összes Power Apps-régió , kivéve a következőket:      - USA kormánya (GCC)      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)
Power Automate	prémium	Az összes Power Automate-régió, kivéve a következőket:      - USA kormánya (GCC)      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)

Érintkezés
Név	Apptigent-támogatás
URL	https://www.apptigent.com/help
Email	support@apptigent.com

Összekötő metaadatai
Kiadó	Apptigent
Webhely	https://www.apptigent.com
Adatvédelmi irányelvek	https://www.apptigent.com/help/privacy-policy/
Kategóriák	Termelékenység

Automatizálhatja a kritikus üzleti folyamatokat a Salesforce platformfüggetlen felhőintegrációjával. Egyszerűen csatlakoztathatja a Power Appst és a Power Automate-et a Salesforce-szervezethez az ügyféladatok lekéréséhez, az ügyletek bezárásához, rekordok létrehozásához, érdeklődők konvertálásához, tömeges feladatok futtatásához, gyorsműveletek végrehajtásához, fájlok feltöltéséhez, dokumentumok rekordokhoz való társításához, hírcsatornák frissítéséhez, csatolt fájlok lekéréséhez és sok máshoz. A SOQL, AZ SOSL és a GraphQL használatával speciális lekérdezéseket és varratokat is végrehajthat. A CloudTools úgy oldja fel a vállalati CRM-adatokban rejlő lehetőségeket, hogy könnyen elérhetővé teszi azokat bármely alkalmazásból vagy munkafolyamatból.

Előfeltételek

A CloudToolshoz érvényes Salesforce-licencre, a CloudTools felügyelt csomagjának salesforce-szervezeten belüli telepítésére (bármely kiadásra) és egy aktuális CloudTools-előfizetésre van szükség (külön számlázva). Az első lépésekre vonatkozó részletes útmutatásért látogasson el https://www.apptigent.com/solutions/cloudtools/configurationide.

Hitelesítő adatok lekérése

Hozzon létre egy licenckulcsot az alábbi egyszerű lépések végrehajtásával:

1. Telepítse a CloudTools felügyelt csomagját a Salesforce App Exchange-en keresztül.
2. Indítsa el a CloudTools konfigurációs oldalát az App Launcher "Apptigent CloudTools" hivatkozásának kiválasztásával.
3. A képernyőn megjelenő utasításokat követve hozzon létre egy csatlakoztatott alkalmazást, és hozzon létre egy licenckulcsot.
4. Másolja ki a kulcsot, és adja meg az új kapcsolati párbeszédpanelen a Power Appsben, a Power Automate-ben vagy az Azure Logic Appsben.

Ismert problémák és korlátozások

A CloudTools salesforce sales cloudhoz való telepítéséhez és konfigurálásához rendszergazdai engedélyekre van szükség a Salesforce-ban. Ha nem rendelkezik megfelelő engedélyekkel a szervezeten belül, forduljon a Salesforce rendszergazdájához.

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:

Alapértelmezett	A kapcsolat létrehozásának paraméterei.	Minden régió	Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név	Típus	Description	Kötelező
Licenckulcs	securestring	A CloudTools licenckulcsa	True

Szabályozási korlátok

Name	Hívások	Megújítási időszak
API-hívások kapcsolatonként	100	60 másodperc

Műveletek

Feladatok – Feladat törlése	Feladat törlése
Feladatok – Megszakított feladat	Feladat megszakítása
Feladatok – Minden feladat lekérése	Információk lekérése az összes feladatról
Feladatok – Tömeges beszúrási feladat létrehozása	Tömeges beszúrási feladat létrehozása
Feladatok – Tömeges feladat eredményének lekérése	Tömeges feladat eredményadatainak lekérése
Feladatok – Tömeges feladat állapotának lekérése	Feladat állapotának ellenőrzése
Feladatok – Tömeges lekérdezési feladat létrehozása	Tömeges lekérdezési feladat létrehozása
Fájlok – Dokumentum megosztása	Fájl (ContentDocument) társítása egy rekordhoz, és a megosztási tulajdonságok beállítása
Fájlok – Dokumentum metaadatai	Fájl adatainak lekérése (ContentDocument)
Fájlok – Dokumentumverziók	Az egyes fájlok verzióinformációinak lekérése (ContentDocument)
Fájlok – Nyilvános hivatkozás létrehozása	Nyilvános fájlhivatkozás létrehozása, amelyhez nem hitelesített felhasználók férhetnek hozzá
Fájlok – Verzió lekérése	Egyéni fájlverzió lekérése (ContentVersion)
Fájlok – Verzió létrehozása	Fájl feltöltése új ContentVersion-objektumként
Fájlok – Verzióadatok	Információk lekérése egy adott fájlverzióról (ContentVersion)
Hírcsatornák – Hírcsatornaelem létrehozása	Rekordhoz társított új hírcsatornaelem létrehozása
Hírcsatornák – Rekordcsatorna lekérése	A csevegőrekord hírcsatornájának lekérése
Lekérdezések – GraphQL-lekérdezés	Graph QL-lekérdezés végrehajtása objektum- és rekordadatok lekéréséhez
Lekérdezések – Keresési lekérdezés	Keresési (SOSL) lekérdezés végrehajtása
Lekérdezések – SOQL-lekérdezés	SOQL-lekérdezés végrehajtása
Műveletek – Gyorsművelet leírása	Gyorsművelet összes tulajdonságának lekérése
Műveletek – Gyorsművelet végrehajtása	Gyorsművelet végrehajtása a szükséges adatokkal
Műveletek – Gyorsműveletek lekérése	A szervezeti gyorsműveletek listájának lekérése
Objektumok – Objektum frissíthető mezői	Egy sObject frissíthető mezőinek lekérése
Objektumok – Objektum leírása	Egy sObject összes metaadatainak és mezőinek lekérése
Objektumok – Objektum metaadatai	Egy sObject metaadatainak lekérése
Objektumok – Objektummezők	Egy sObject mezőinek lekérése
Objektumok – SObjects listázása	Egy szervezet összes sObjects-listájának lekérése
Rekordok – Csatolt fájlok	A rekordhoz csatolt összes fájl adatainak lekérése
Rekordok – Rekord frissítése	A megadott objektumtípus rekordjának frissítése
Rekordok – Rekord lekérése	A megadott objektumtípus rekordjának lekérése
Rekordok – Rekord létrehozása	A megadott objektumtípus új rekordjának létrehozása
Rekordok – Rekord törlése	A megadott objektumtípus rekordjának törlése
Szervezet – API-verziók listázása	A szervezet összes támogatott API-verziójának listájának lekérése
Szervezet – Az API legújabb verziója	Egy szervezet legújabb támogatott API-verziójának lekérése
Érdeklődők – Érdeklődő konvertálása	Érdeklődő konvertálása

Feladatok – Feladat törlése

Műveletazonosító:

GlobalJobsDeleteJob

Feladat törlése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
azonosító	id	True	string	Objektumazonosító
Típus	type	True	string	Objektumtípus

Válaszok

Törzs

outputStringResult

Feladatok – Megszakított feladat

Műveletazonosító:

GlobalJobsAbortJob

Feladat megszakítása

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
azonosító	id	True	string	Objektumazonosító
Típus	type	True	string	Objektumtípus

Válaszok

Törzs

outputStringResult

Feladatok – Minden feladat lekérése

Műveletazonosító:

JobsGetAllJobs

Információk lekérése az összes feladatról

Válaszok

response

object

Feladatok – Tömeges beszúrási feladat létrehozása

Műveletazonosító:

JobsCreateInsertJob

Tömeges beszúrási feladat létrehozása

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Objektum neve	objectName		string	Az sObject típus neve (pl. Lehetőség)
Fájlformátum	fileFormat		string	Fájlformátum (jelenleg csak CSV támogatott)
Sorvégződés	lineEnding		string	A bemeneti fájl egyenes terminátora. Unix/Linus/Mac OS LF, WINDOWS CRLF
File	file		file	Bináris fájladatok (25 MB-os korlát)

Válaszok

response

object

Feladatok – Tömeges feladat eredményének lekérése

Műveletazonosító:

JobsGetJobResult

Tömeges feladat eredményadatainak lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Feladat azonosítója	jobId		string	Feladat azonosítója
Feladattípus	jobType		string	Feladat típusa
Eredmény típusa	resultType		string	A lekérendő eredményhalmaz típusa
Lokátor	locator		string	Rekordkereső
Rekordok maximális kihasználtság	maxRecords		string	Visszaadandó rekordok maximális száma

Válaszok

response

object

Feladatok – Tömeges feladat állapotának lekérése

Műveletazonosító:

GlobalJobsGetStatus

Feladat állapotának ellenőrzése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
azonosító	id	True	string	Objektumazonosító
Típus	type	True	string	Objektumtípus

Válaszok

Törzs

outputStringResult

Feladatok – Tömeges lekérdezési feladat létrehozása

Műveletazonosító:

JobsCreateQueryJob

Tömeges lekérdezési feladat létrehozása

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Lekérdezési művelet	operation		string	A lekérdezési művelet típusa
Oszlophatároló	delimiter		string	Oszlopelválasztó a kimeneti fájlban
Sorvégződés	lineEnding		string	A kimeneti fájl egyenes terminátora. LF Unix/Linux/Mac OS rendszerhez, CRLF Windowshoz
Query	query		string	Nagy eredményhalmaz SOQL-lekérdezése (kódolatlan)

Válaszok

response

object

Fájlok – Dokumentum megosztása

Műveletazonosító:

FilesShareDocument

Fájl (ContentDocument) társítása egy rekordhoz, és a megosztási tulajdonságok beállítása

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Dokumentumazonosító	documentId	True	string	A fájl azonosítója (ContentDocument objektum)
Rekordazonosító	recordId	True	string	Annak a rekordnak az azonosítója, amelyhez a fájl társítva lesz
Láthatóság	visibility	True	string	A fájlhoz hozzáférő felhasználók
Permissions	permissions	True	string	Megosztási engedélyek (Megtekintő [Csak megtekintés], Közreműködő [Nézet/Szerkesztés/Megosztás], Kapcsolódó rekordból származó következtetés)

Válaszok

response

object

Fájlok – Dokumentum metaadatai

Műveletazonosító:

FilesDocumentMetadata

Fájl adatainak lekérése (ContentDocument)

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Dokumentumazonosító	documentId	True	string	A lekérendő fájltartalom-dokumentum azonosítója

Válaszok

response

object

Fájlok – Dokumentumverziók

Műveletazonosító:

FilesListVersions

Az egyes fájlok verzióinformációinak lekérése (ContentDocument)

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Verzióazonosító	documentId	True	string	A lekérendő verziókat tartalmazó tartalomdokumentum-objektum azonosítója

Válaszok

response

object

Fájlok – Nyilvános hivatkozás létrehozása

Műveletazonosító:

FilesCreatePublicLink

Nyilvános fájlhivatkozás létrehozása, amelyhez nem hitelesített felhasználók férhetnek hozzá

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Verzióazonosító	versionId	True	string	A fájl tartalomverzió-azonosítója
Fájlnév	name	True	string	Fájlnév
Megtekintés böngészőben	viewInBrowser		boolean	Előnézeti hivatkozás létrehozása a böngészőben való megtekintéshez
Letöltés engedélyezése	allowDownload		boolean	Letöltési hivatkozás létrehozása a fájl tartalmának lekéréséhez
Jelszó	password		boolean	Jelszó
Lejárat	expiration		string	Lejárati dátum (nem kötelező)

Válaszok

Törzs

outputPublicLink

Fájlok – Verzió lekérése

Műveletazonosító:

FilesGetVersion

Egyéni fájlverzió lekérése (ContentVersion)

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Verzióazonosító	versionId	True	string	A lekérendő fájlverzió azonosítója

Válaszok

response

object

Fájlok – Verzió létrehozása

Műveletazonosító:

FilesCreateVersion

Fájl feltöltése új ContentVersion-objektumként

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Név	name		string	A fájl neve (a kiterjesztést is beleértve)
Cím	title		string	A fájl címe
Dokumentumazonosító	documentId		string	(Nem kötelező) A ContentDocument objektum azonosítója (csak akkor használatos, ha új verziót fűz egy meglévő fájlhoz)
A változás oka	reasonForChange		string	(Nem kötelező) A változás leírása
File	file		file	Bináris fájladatok

Válaszok

response

object

Fájlok – Verzióadatok

Műveletazonosító:

FilesVersionMetadata

Információk lekérése egy adott fájlverzióról (ContentVersion)

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Verzióazonosító	versionId	True	string	A lekérendő fájltartalom-verzió azonosítója

Válaszok

response

object

Hírcsatornák – Hírcsatornaelem létrehozása

Műveletazonosító:

FeedCreateItem

Rekordhoz társított új hírcsatornaelem létrehozása

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Hírcsatorna tartalma	body	True	string	Hírcsatornaelem tartalma. Egyszerű szöveges értékeket vagy "messageSegments" JSON-objektumot fogad el összetettebb bejegyzéstípusokhoz (lásd https://bit.ly/4706k0M: ).
Rekordazonosító	recordId	True	string	Társított rekordazonosító

Válaszok

response

object

Hírcsatornák – Rekordcsatorna lekérése

Műveletazonosító:

FeedsGetRecordElements

A csevegőrekord hírcsatornájának lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Rekordazonosító	recordId	True	string	A rekord azonosítója

Válaszok

response

object

Lekérdezések – GraphQL-lekérdezés

Műveletazonosító:

QueriesGraphQuery

Graph QL-lekérdezés végrehajtása objektum- és rekordadatok lekéréséhez

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Query	query	True	string	GraphQL-lekérdezés szövege

Válaszok

response

object

Lekérdezések – Keresési lekérdezés

Műveletazonosító:

QueriesSearchQuery

Keresési (SOSL) lekérdezés végrehajtása

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Név	query	True	string	Keresési lekérdezés szövege (kódolatlan)

Válaszok

response

object

Lekérdezések – SOQL-lekérdezés

Műveletazonosító:

QueriesSOQlQuery

SOQL-lekérdezés végrehajtása

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
lekérdezés	query	True	string	SOQL-lekérdezés szövege (kódolatlan)

Válaszok

response

object

Műveletek – Gyorsművelet leírása

Műveletazonosító:

ActionsDescribeQuickAction

Gyorsművelet összes tulajdonságának lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Név	name	True	string	Objektum vagy elem neve

Válaszok

Törzs

outputStringResult

Műveletek – Gyorsművelet végrehajtása

Műveletazonosító:

ActionsExecuteQuickAction

Gyorsművelet végrehajtása a szükséges adatokkal

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Név	name	True	string	Gyorsművelet neve
Adat	data	True	object	Gyorsműveleti adatok

Válaszok

Törzs

outputStringResult

Műveletek – Gyorsműveletek lekérése

Műveletazonosító:

ActionsListQuickActions

A szervezeti gyorsműveletek listájának lekérése

Válaszok

Törzs

outputActionList

Objektumok – Objektum frissíthető mezői

Műveletazonosító:

GlobalObjectUpdateFields

Egy sObject frissíthető mezőinek lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Objektum neve	name	True	string	Az sObject neve

Válaszok

Törzs

outputStringResult

Objektumok – Objektum leírása

Műveletazonosító:

GlobalDescribeObject

Egy sObject összes metaadatainak és mezőinek lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Objektumnév kiválasztása	name	True	string	Az sObject neve

Válaszok

Törzs

outputStringResult

Objektumok – Objektum metaadatai

Műveletazonosító:

GlobalObjectMetadata

Egy sObject metaadatainak lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Objektum neve	name	True	string	Az sObject neve

Válaszok

Törzs

outputStringResult

Objektumok – Objektummezők

Műveletazonosító:

GlobalObjectFields

Egy sObject mezőinek lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Objektum neve	name	True	string	Az sObject neve

Válaszok

Törzs

outputStringResult

Objektumok – SObjects listázása

Műveletazonosító:

GlobalListObjects

Egy szervezet összes sObjects-listájának lekérése

Válaszok

Törzs

outputStringResult

Rekordok – Csatolt fájlok

Műveletazonosító:

GlobalRecordLinkedFiles

A rekordhoz csatolt összes fájl adatainak lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Rekordazonosító	recordId	True	string	Rekordazonosító
Hivatkozástípusok	linkTypes	True	string	A belefoglalandó csatolt fájlok típusa

Válaszok

response

object

Rekordok – Rekord frissítése

Műveletazonosító:

GlobalUpdateRecord

A megadott objektumtípus rekordjának frissítése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Objektumnév kiválasztása	name	True	string	Frissítendő objektumtípus
Rekordazonosító	recordId	True	string	A frissíteni kívánt rekord azonosítója
body	body	True	dynamic	Frissítési bemenet rögzítése

Válaszok

response

object

Rekordok – Rekord lekérése

Műveletazonosító:

GlobalGetRecord

A megadott objektumtípus rekordjának lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Objektumnév kiválasztása	name	True	string	A lekérendő objektumtípus
Rekordazonosító	recordId	True	string	A lekérendő rekord azonosítója

Válaszok

response

object

Rekordok – Rekord létrehozása

Műveletazonosító:

GlobalCreateRecord

A megadott objektumtípus új rekordjának létrehozása

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Objektumnév kiválasztása	name	True	string	Létrehozandó objektumtípus
body	body	True	dynamic	Rekordlétrehozás bemenete

Válaszok

response

object

Rekordok – Rekord törlése

Műveletazonosító:

GlobalDeleteObject

A megadott objektumtípus rekordjának törlése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Objektumnév kiválasztása	name	True	string	Törölendő objektumtípus
Rekordazonosító	recordId	True	string	A törölni kívánt rekord azonosítója

Válaszok

response

object

Szervezet – API-verziók listázása

Műveletazonosító:

OrgListVersions

A szervezet összes támogatott API-verziójának listájának lekérése

Válaszok

Törzs

outputVersionList

Szervezet – Az API legújabb verziója

Műveletazonosító:

OrgLatestVersion

Egy szervezet legújabb támogatott API-verziójának lekérése

Válaszok

Törzs

outputStringResult

Érdeklődők – Érdeklődő konvertálása

Műveletazonosító:

RecordsLeadsConvertLead

Érdeklődő konvertálása

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Érdeklődő azonosítója	leadId	True	string	Érdeklődő azonosítója
Lehetőség létrehozása	createOpportunity		boolean	Lehetőségrekord létrehozása átalakításkor. Alapértelmezett érték: true (igaz).
Lehetőség neve	opportunityName		string	Beállítja a létrehozási lehetőség nevét. Ha nincs megadva név, ez az érték alapértelmezés szerint az érdeklődő cégneve lesz.
Érdeklődőforrás felülírása	overwriteLeadSource		boolean	Írja felül a célkapcsolat objektum LeadSource mezőjét a forrás érdeklődőobjektum LeadSource mezőjének tartalmával. Az alapértelmezett érték false.
Értesítési e-mail küldése	sendNotificationEmail		boolean	Küldjön egy értesítési e-mailt a tulajdonosnak. Az alapértelmezett érték false.
Egyesítés fiókazonosítóval	mergeAccountId		string	Annak a fióknak az azonosítója, amelybe az érdeklődőt egyesítik. Csak meglévő fiók frissítésekor használható.
Egyesítés partnerazonosítóval	mergeContactId		string	Annak a partnernek az azonosítója, amelybe az érdeklődőt egyesíteni fogják (már társítva kell lennie a mergeAccountId azonosítóban megadott fiókkal). Csak meglévő partner frissítésekor használható.
Egyesítés lehetőségazonosítóval	mergeOpportunityId		string	Annak a lehetőségnek az azonosítója, amelybe az érdeklődőt egyesíteni kell. Csak meglévő lehetőség frissítésekor használható.
Tulajdonosi azonosító	ownerId		string	Annak a személynek az azonosítója, aki rendelkezik az újonnan létrehozott fiókkal, kapcsolattartóval vagy lehetőséggel. Ha üres, az érdeklődő tulajdonosának értéke lesz használva.

Válaszok

response

object

Definíciók

outputActionList

Name	Elérési út	Típus	Description
Results	results	array of object	Results
items	results	object

outputPublicLink

Name	Elérési út	Típus	Description
Objektumazonosító	objectId	string	Tartalomterjesztési objektum azonosítója
Success	success	boolean	A művelet sikerességét vagy sikertelenségét jelzi
Jelszó	password	string	Automatikusan létrehozott jelszóérték
URL vagy webcím	url	string	Nyilvános URL-cím

outputStringResult

Name	Elérési út	Típus	Description
eredmény	result	string	Szöveges válasz

outputVersionList

Name	Elérési út	Típus	Description
Results	results	array of object	Results
items	results	object

objektum

Ez az "objektum" típus.