Salesforce Connector

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!