This connector is a good starting point that implements a core set of the service's most common functions. You should expect to extend it by adding functions for the specific endpoints your workflow requires. Additionally, some configuration may be required in Salesforce to establish a connection with Tulip. Please review our [connectors](/r230/docs/<span translate=)">connector framework to learn more about how to build and modify connectors in Tulip.
To download the app, visit: [connectors](https://tulip.co/library/<span translate=)/salesforce-connector/">Library
Bevezetés
A Salesforce egy felhőalapú CRM szoftverplatform, amelyet az értékesítési leadek nyomon követésétől a megrendelések és a készletkezelésig terjedő alkalmazásokban használnak.
Cél
Ez a dokumentum a Tulip Library-ben található Salesforce REST API-csatlakozót ismerteti. A konfigurálás után ezek a csatlakozófüggvények felhasználhatók a Salesforce-adatok lekérésére, lekérdezésére és módosítására egy Tulip-alkalmazásból.
API-dokumentáció
A Salesforce REST API dokumentációja itt található. Vegye figyelembe, hogy a cikkben bemutatott néhány csatlakozó funkció a lekérdezéseket SOQL (Salesforce Object Query Language) segítségével hajtja végre, amelynek teljes szintaxisa itt található.
Note: Salesforce supports a number of API across a variety of methods, the full list of which can be found here. This article and the Connectors to which it is related are built to use the Salesforce REST API.
Első beállítás
Warning: generating the following values requires developer- or administrator-level permissions in Salesforce.
A Salesforce API hitelesítése az OAuth 2.0 szabványoknak felel meg. Az alábbi eljárás bemutatja, hogyan lehet frissítési tokent generálni, amelyet ezután bármely Tulip-alkalmazás felhasználhat a Salesforce-hoz való sikeres csatlakozáshoz szükséges hozzáférési token lekéréséhez.
- Hozzon létre egy csatlakoztatott alkalmazást a Salesforce-ban. Ehhez lépjen a Salesforce „Beállítások” területére. Ezután válassza a PLATFORM TOOLS >> Alkalmazások >> Csatlakoztatott alkalmazások >> Csatlakoztatott alkalmazások kezelése menüpontot.
- Hozzon létre egy új kapcsolódó alkalmazást. Adja meg: a. az alkalmazásához szükséges hatóköröket, de feltétlenül adja meg
a refresh_token-tis. b. Válassza az „OAuth-beállítások engedélyezése” lehetőséget, és írja be a visszahívási URL-t:https://login.salesforce.com/services/oauth2/success. - Miután befejezte, kattintson a „Fogyasztói adatok kezelése” gombra, hogy megtekintse a „Fogyasztói kulcsot” és a „Fogyasztói titkot”. Ezekre később szükség lesz.
- Most a Tulipban nyissa meg a „ Connector Function ” [Beállítás] „Get Auth Code URL” menüpontot. Másolja és illessze be a fenti 3. lépésben generált „Fogyasztói kulcsot”
a client_idlekérdezési paraméterként. - „Futtassa” a „ Connector Function ” alkalmazást.
- Figyelje meg, hogy a csatlakozó „Output” (Kimenet) rovatában generálódott egy URL. Illessze be ezt az URL-t a böngészőablakába.
- Töltse ki a megjelenő hitelesítési ablakot, hogy a Tulip sikeresen engedélyt kapjon a Salesforce-példányával való interakcióra.
- Sikeres hitelesítés esetén a böngésző átirányít egy új oldalra, amelyen a
„Remote Access Application Authorization”felirat látható. Az engedélyezési kód ezen az oldalon található az URL-ben. Például ahttps://login.salesforce.com/services/oauth2/success?code=asdf1234URL-ben az engedélyezési kódasdf1234. - Mentse el ezt az engedélyezési kódot. Vegye figyelembe, hogy a kódnak két egyenlőségjelre (
==) kell végződnie. Ha a kód%3D%3D-vel végződik, távolítsa el ezeket a karaktereket, és cserélje ki==-re. - Lépjen a [Beállítás] Frissítési token lekérése (Tulip) oldalra: Connector Function. A Lekérdezési paraméterek mezőbe illessze be a fent összegyűjtött összes információt:
grant_type=authorization_coderedirect_uri=https://login.salesforce.com/services/oauth2/successclient_id=a fenti 3. lépésből származó fogyasztói kulcsclient_secret=a fenti 3. lépésből származó fogyasztói titokcode=a fenti 9. lépésből származó engedélyezési kód
- Futtassa ezt a csatlakozót, és mentse el a válaszban megjelenő
refresh_tokenértéket. - Végül lépjen az [Auth] Get Access Token Connector Function oldalra. Töltse ki a következő lekérdezési paramétereket:
grant_type=authorization_codeclient_id=a fenti 3. lépésből származó fogyasztói kulcsclient_secret=a fenti 3. lépésből származó fogyasztói titokrefresh_token=a fenti 10. lépésből származó frissítési token
- Futtassa a csatlakozót. Vegye figyelembe, hogy a válasz tartalmaz egy
access_token-t, amely kimenetként van hozzárendelve. Mentse el a csatlakozót a frissítési token mentéséhez
Amint ez a függvény képes access_token generálására, a beállítás befejeződött! Ez az access_token mostantól bármely későbbi Connector Function -ben felhasználható, amíg a 2. lépésben konfigurált időtúllépési beállítások engedik.
Tulip-kapcsolati adatok
Ahhoz, hogy a csatlakozói összeköttetést létesíthessen a Salesforce-szal, adja meg a Salesforce-példány aldomainjét „Alapértelmezett aldomain” néven a csatlakozó Kapcsolati adatok részében. Például, ha a Salesforce-példány a sample.my.salesforce.com címen érhető el, akkor az alapértelmezett aldomainnek a sample.my-nek kell lennie.
Ne feledje, hogy az összes Connector Functions itt a Salesforce REST API v46.0 verzióval való együttműködésre lett kialakítva.
Connector Functions
Két fő csatlakozó-típus létezik: az objektumtípusú és a lekérdezéstípusú csatlakozók. Ne feledje, hogy mindkét csatlakozóhoz access_token szükséges, ezért ezek futtatása előtt feltétlenül hajtsa végre az [Auth] Get Access Token műveletet az alkalmazásában! Általában ajánlott az alkalmazás vagy a folyamat indításakor új hozzáférési tokent generálni, és azt egy alkalmazásváltozóba menteni későbbi felhasználás céljából.
Objektumtípusú csatlakozók
- A kérdéses objektum összes mezőjét visszaadja.
- Használja a
./services/data/v46.0/sobjects/<objektum neve>/<objektum azonosítója>végpontot - Példa: [Opportunity] Get All Fields csatlakozó
Lekérdezés típusú csatlakozók
- Csak a lekérdezésben megadott mezőket adja vissza.
- Visszaadhatnak kapcsolódó (pl. egy üzleti lehetőséghez kapcsolódó fióknév) vagy összesített (pl. rekordok száma) információkat.
- Használja a
./services/data/v46.0/queryvégpontot - SOQL használatával kell lekérdezést írni (a dokumentáció itt található{
target=_blank}). - Példa: [Order] csatlakozó – Az összes „Status” állapotú megrendelés lekérése
Tartalom Connector Functions
A következő Connector Functions szerepelnek ebben a csomagban, és bevezetésként szolgálnak a Salesforce API-n keresztül elérhető funkciókhoz:* [Setup] Get Auth Code URL & [Setup] Get Refresh Token * Kizárólag az első beállításhoz használható. További információkért lásd fent.*[Auth] Get Access Token * Hozzáférési token generálására szolgál, amelyet minden későbbi Connector Functions hívásban meg kell adni.*[Opportunity] funkciók: * Get All Fields * Visszaadja a lekérdezett Opportunity összes mezőjét. Hozzáférési token és Opportunity azonosító szükséges. * Change Stage * Frissíti a megadott Opportunity szakaszát a megadott értékre.*[Order] függvények: * Get All Orders of Status * Visszaadja a megadott Status-ú összes Order listáját. * Count Orders of Status * Visszaadja a megadott Status-ú összes Order darabszámát. * Get Order Number from ID * Visszaadja az Order számát a megadott Order ID alapján.
Ha ezeket a függvényeket saját igényeinek megfelelően szeretné módosítani, vegye figyelembe az alábbi tanácsokat: 1. Az objektumtípusú Connector Functions módosításához egyszerűen változtassa meg az URL-ben megadott objektumot. Szükség szerint adjon hozzá vagy távolítson el kimeneti elemeket. 2. A lekérdezés típusú Connector Functions módosításához minden változtatást a lekérdezésben kell elvégezni. Ez a lekérdezési paraméterek között található, a q kulcs alatt. 1. Tipp: korlátozza a lekérdezés válaszainak számát a LIMIT(válaszok_száma) függvénnyel
Megtalálta, amit keresett?
Látogasson el a community.tulip.co oldalra is, ahol felteheti kérdését, vagy megnézheti, hogy mások is szembesültek-e már hasonló problémával!