Salesforce Connector
  • 13 Jan 2025
  • 4 Elolvasandó percek
  • Közreműködők

Salesforce Connector


Cikk összefoglaló

To download the app, visit: Library

Bevezetés

A Salesforce egy felhőalapú CRM szoftverplatform, amelyet az értékesítési leadek nyomon követésétől a rendelés- és készletkezelésig terjedő alkalmazásokban használnak.

Cél

Ez a dokumentum a Tulip könyvtárban található Salesforce REST API csatlakozót részletezi. A konfigurálást követően ezek a csatlakozófunkciók a Salesforce-adatok lekérdezésére, lekérdezésére és módosítására használhatók egy Tulip alkalmazásból.

API dokumentáció

A Salesforce REST API dokumentációja itt található. Vegye figyelembe, hogy néhány, ebben a cikkben szereplő Connector Functions a SOQL (Salesforce Object Query Language) használatával hajt végre lekérdezéseket, amelynek teljes szintaxisát itt dokumentálja.

API Variations

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

Permissions Warning

Warning: generating the following values requires developer- or administrator-level permissions in Salesforce.
::::A Salesforce API hitelesítés az OAuth 2.0 szabványokat követi.A következő folyamat bemutatja, hogyan kell létrehozni egy frissítési tokent, amelyet aztán bármelyik Tulip alkalmazás használ a Salesforce-hoz való sikeres csatlakozáshoz szükséges hozzáférési token lekéréséhez.

  1. Hozzon létre egy csatlakoztatott alkalmazást a Salesforce-ban. Ehhez navigáljon a Salesforce "Beállítás" terére. Ezután navigáljon a PLATFORM TOOLS >> Apps >> Connected Apps >> Manage Connected Apps menüpontba.
  2. Hozzon létre egy új csatlakoztatott alkalmazást. Tüntesse fel: a. az alkalmazáshoz szükséges összes hatóköröket, de mindenképpen vegye fel a refresh_token-t. b. Válassza az OAuth-beállítások engedélyezése lehetőséget, és adja meg a visszahívási URL-t a https://login.salesforce.com/services/oauth2/success címen .
  3. Ha elkészült, kattintson a Fogyasztói adatok kezelése gombra, hogy láthassa a "Fogyasztói kulcsot" és a "Fogyasztói titkot". Ezeket a későbbiekben fogjuk használni.
  4. Most a Tulipban nyissa meg a Connector Function [Setup] Get Auth Code URL-t. Másolja ki és illessze be a fenti 3. lépésben generált "Fogyasztói kulcsot" a lekérdezési paraméter client_id-ként.
  5. "Futtassa" a csatlakozófüggvényt.
  6. Figyelje meg, hogy a csatlakozó "kimenetként" egy URL-t generált. Illessze be ezt az URL-t a böngésző ablakába.
  7. Töltse ki a megjelenő hitelesítési kérdőívet, hogy sikeresen engedélyezze a Tulip számára a Salesforce-példányával való interakciót.
  8. Ha sikeres, a böngészőjének át kell irányítania egy új oldalra, amelyen a Távoli hozzáférés alkalmazásengedélyezés felirat szerepel. Az engedélyezési kódot az oldal URL-címében találja. Például a https://login.salesforce.com/services/oauth2/success?code=asdf1234 URL-címben az Engedélyezési kód asdf1234.
  9. 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-re végződik, távolítsa el ezeket a karaktereket, és helyettesítse == -vel.
  10. Navigáljon a [Setup] Get Refresh Token Tulip Connector funkcióhoz. A lekérdezési paraméterek mezőbe illessze be a fent összegyűjtött összes információt:
    • grant_type= authorization_code
    • redirect_uri= https://login.salesforce.com/services/oauth2/success
    • client_id= a fenti 3. lépésben megadott fogyasztói kulcs.
    • client_secret= a fenti 3. lépésben megadott fogyasztói titok.
    • code= az engedélyezési kód a fenti 9. lépésből.
  11. Futtassa ezt a Connector-t, és mentse el a válaszban megjelenő refresh_token-t.
  12. Végül navigáljon az [Auth] Get Access Token Connector Function ( Hozzáférési token lekérdezése ) menüponthoz. Töltse ki a következő lekérdezési paramétereket:
    • grant_type= authorization_code
    • client_id= a fenti 3. lépésben megadott fogyasztói kulcs.
    • client_secret= a fenti 3. lépésben megadott fogyasztói titok.
    • refresh_token= a fenti 10. lépésben megadott frissítési token.
  13. Futtassa a csatlakozót. Vegye figyelembe, hogy a válasz tartalmaz egy access_token-t, amely kimenetként van leképezve. Mentse a csatlakozót a frissítési token elmentéséhez.

Ha ez a funkció képes létrehozni egy access_tokent, a beállítás befejeződött! Ez a access_token mostantól bármelyik későbbi csatlakozófüggvényben felhasználható, amíg a 2. lépésben konfigurált időkorlát beállítások lehetővé teszik.

Tulip kapcsolat részletei

Ahhoz, hogy a csatlakozói kapcsolódhassanak a Salesforce-hoz, adja meg a Salesforce példányának aldomainjét az "Alapértelmezett aldomain"-ként a csatlakozó csatlakozási adatai között. Például, ha a Salesforce-példány a sample.my.salesforce.com címen található, akkor az alapértelmezett aldomainnek a sample.my-nak kell lennie.

Vegye figyelembe, hogy az összes itt található csatlakozófunkció a Salesforce REST API v46.0-val való együttműködésre készült.

Csatlakozó funkciók

A csatlakozónak két elsődleges típusa létezik: objektum típusú és lekérdezés típusú csatlakozók. Vegye figyelembe, hogy mindkét csatlakozóhoz access_token szükséges, ezért ezek előtt mindenképpen futtassa le a [Auth] Get Access Token-t az alkalmazásában! Általában ajánlott az alkalmazás vagy folyamat indításakor új Access Tokent generálni, és azt egy App Variable-be menteni későbbi használatra.

Objektum-típusú csatlakozók

  • A kérdéses objektum összes mezőjének visszaadása.
  • Használja a ./services/data/v46.0/sobjects/<Object Name>/<Object ID> végpontot .
  • Példa: Minden mező lekérdezése

Lekérdezés típusú csatlakozók

  • Csak a lekérdezésben megadott mezőket adja vissza.
  • Visszaadhat kapcsolt (pl. egy lehetőséghez kapcsolódó számlanév) vagy összesített (pl. a rekordok száma) információkat.
  • Használja a ./services/data/v46.0/query végpontot .
  • A SOQL használatával történő lekérdezés megírása szükséges (dokumentáció itt{target=_blank}).
  • Példa: Az összes státuszú rendelés lekérdezése.

Tartalmazott csatlakozó funkciók

A következő csatlakozófüggvények szerepelnek ebben a csomagban, és bevezetésként szolgálnak a Salesforce API-n keresztül lehetséges funkciókhoz:* [Setup] Get Auth Code URL & [Setup] Get Refresh Token * Csak első alkalommal történő beállításhoz használható. További információkért lásd fentebb.* [Auth] Get Access Token * Access Token generálására szolgál, amelyet minden további csatlakozófunkcióban szerepeltetni kell.* [Opportunity] funkciók: * Get All Fields * Visszaadja a lekérdezett Opportunity összes mezőjét. Access Token és Opportunity ID szükséges. * Stage módosítása * A megadott Opportunity Stage-jét frissíti a megadott értékre.* [Order] függvények: * Get All Orders of Status * Visszaadja a megadott státuszú összes megrendelés listáját. * Count Orders of Status * Visszaadja a megadott státuszú összes megrendelés számát. * Get Order Number from ID * Visszaad egy rendelésszámot egy megadott rendelésazonosítóból.

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ú csatlakozófüggvények módosításához egyszerűen módosítsa az URL-ben megadott objektumot. Szükség szerint adjon hozzá vagy távolítson el új kimeneteket. 2. A lekérdezés típusú csatlakozófüggvények módosításához minden módosítást a lekérdezésben kell elvégezni. Ez a lekérdezés paramétereiben található, a q kulcsszóval. 1. Tipp: korlátozza a lekérdezésből származó válaszok számát a LIMIT(number_of_responses) függvénnyel.


Megtalálta, amit keresett?

A community.tulip.co oldalon is megteheti, hogy felteszi kérdését, vagy megnézheti, hogy mások is szembesültek-e hasonló kérdéssel!


Hasznos volt ez a cikk?