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
Wprowadzenie
Salesforce to oparta na chmurze platforma oprogramowania CRM, wykorzystywana w różnych zastosowaniach — od śledzenia potencjalnych klientów po zarządzanie zamówieniami i zapasami.
Cel
Niniejszy dokument zawiera szczegółowe informacje na temat łącznika Salesforce REST API dostępnego w bibliotece Tulip. Po skonfigurowaniu funkcji łącznika można ich używać do pobierania, wyszukiwania i modyfikowania danych Salesforce z poziomu aplikacji Tulip.
Dokumentacja API
Dokumentację dotyczącą interfejsu API REST Salesforce można znaleźć tutaj. Należy pamiętać, że niektóre funkcje łącznika omówione w tym artykule wykonują zapytania przy użyciu języka SOQL (Salesforce Object Query Language), którego pełna składnia została opisana tutaj.
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.
Pierwsza konfiguracja
Warning: generating the following values requires developer- or administrator-level permissions in Salesforce.
Uwierzytelnianie API Salesforce odbywa się zgodnie ze standardami OAuth 2.0. Poniższa procedura opisuje, jak wygenerować token odświeżający, który będzie następnie wykorzystywany przez dowolną aplikację Tulip do pobrania tokenu dostępu niezbędnego do pomyślnego połączenia z Salesforce.
- Utwórz aplikację połączoną w Salesforce. W tym celu przejdź do obszaru „Konfiguracja” w Salesforce. Następnie przejdź do NARZĘDZIA PLATFORMY >> Aplikacje >> Aplikacje połączone >> Zarządzaj aplikacjami połączonymi.
- Utwórz nową aplikację połączoną. Podaj: a. wszystkie zakresy wymagane przez Twoją aplikację, pamiętaj jednak o uwzględnieniu
refresh_token. b. Wybierz opcję „Włącz ustawienia OAuth” i wprowadź adres URL wywołania zwrotnego jakohttps://login.salesforce.com/services/oauth2/success. - Po zakończeniu kliknij opcję „Zarządzaj danymi konsumenta ”, aby wyświetlić „Klucz konsumenta” i „Sekret konsumenta”. Będą one potrzebne później.
- Teraz w Tulip otwórz stronę Connector Function [Konfiguracja] Pobierz adres URL kodu autoryzacyjnego. Skopiuj i wklej „Klucz konsumenta” wygenerowany w kroku 3 powyżej jako parametr zapytania
client_id. - „Uruchom” Connector Function.
- Zauważ, że jako „Wynik” łącznika wygenerowano adres URL. Wklej ten adres URL do okna przeglądarki.
- Wypełnij wyświetlony monit uwierzytelniający, aby pomyślnie autoryzować Tulip do interakcji z Twoją instancją Salesforce.
- Jeśli operacja się powiedzie, przeglądarka powinna przekierować Cię na nową stronę zatytułowaną
„Autoryzacja aplikacji zdalnego dostępu”. Kod autoryzacyjny znajduje się w adresie URL tej strony. Na przykład w adresie URLhttps://login.salesforce.com/services/oauth2/success?code=asdf1234kod autoryzacyjny toasdf1234. - Zapisz ten kod autoryzacyjny. Pamiętaj, że kod musi kończyć się dwoma znakami równości:
==. Jeśli kod kończy się na%3D%3D, usuń te znaki i zastąp je==. - Przejdź do sekcji [Konfiguracja] Pobierz token odświeżający w serwisie Tulip Connector Function. W polu „Parametry zapytania” wklej wszystkie informacje zebrane powyżej:
grant_type=authorization_coderedirect_uri=https://login.salesforce.com/services/oauth2/successclient_id=klucz konsumenta z kroku 3 powyżejclient_secret=sekret konsumenta z kroku 3 powyżejcode=kod autoryzacyjny z kroku 9 powyżej
- Uruchom ten łącznik i zapisz token odświeżający (
refresh_token), który pojawi się w odpowiedzi. - Na koniec przejdź do sekcji [Auth] „Pobierz token dostępu ” Connector Function. Wypełnij następujące parametry zapytania:
grant_type=authorization_codeclient_id=klucz konsumenta z kroku 3 powyżejclient_secret=sekret konsumenta z kroku 3 powyżejrefresh_token=token odświeżający z kroku 10 powyżej
- Uruchom łącznik. Zwróć uwagę, że odpowiedź zawiera
token dostępu (access_token), który jest mapowany jako dane wyjściowe. Zapisz łącznik, aby zachować token odświeżający
Gdy ta funkcja będzie w stanie wygenerować token dostępu (access_token), konfiguracja zostanie zakończona! Ten token dostępu można teraz wykorzystać w dowolnym kolejnym żądaniu typu „ Connector Function ” tak długo, jak pozwalają na to ustawienia limitu czasu skonfigurowane w kroku 2.
Szczegóły połączenia z Tulip
Aby umożliwić łącznikom komunikację z Salesforce, wprowadź subdomenę swojej instancji Salesforce jako „Domyślną subdomenę” w sekcji „Szczegóły połączenia” łącznika. Na przykład, jeśli instancja Salesforce znajduje się pod adresem sample.my.salesforce.com, domyślną subdomeną powinno być sample.my.
Należy pamiętać, że wszystkie łączniki typu „ Connector Functions ” są zaprojektowane do współpracy z interfejsem API REST Salesforce w wersji 46.0.
Connector Functions
Istnieją dwa główne typy łączników: łączniki typu obiektowego i typu zapytania. Należy pamiętać, że oba łączniki wymagają tokenu dostępu (access_token), dlatego przed ich użyciem należy w aplikacji uruchomić [Auth] Pobierz token dostępu! Zazwyczaj zaleca się wygenerowanie nowego tokenu dostępu przy uruchomieniu aplikacji lub procesu oraz zapisanie go w zmiennej aplikacji do późniejszego wykorzystania.
Łączniki typu obiektowego
- Zwracają wszystkie pola danego obiektu.
- Użyj punktu końcowego
./services/data/v46.0/sobjects/<nazwa obiektu>/<identyfikator obiektu> - Przykład: Łącznik [Opportunity] Pobierz wszystkie pola
Łączniki typu zapytania
- Zwracają tylko pola określone w zapytaniu.
- Mogą zwracać informacje powiązane (np. nazwę konta powiązaną z szansą sprzedaży) lub zagregowane (np. liczbę rekordów).
- Użyj punktu końcowego
./services/data/v46.0/query - Wymagane jest napisanie zapytania przy użyciu języka SOQL (dokumentacja tutaj{
target=_blank}). - Przykład: Łącznik [Order] Pobierz wszystkie zamówienia o statusie
W zestawie Connector Functions
W niniejszym pakiecie zawarto następujące operacje typu „ Connector Functions ”, które mają służyć jako wprowadzenie do funkcji dostępnych za pośrednictwem interfejsu API Salesforce:* [Setup] Pobierz adres URL kodu autoryzacyjnego oraz [Setup] Pobierz token odświeżający * Używane wyłącznie podczas pierwszej konfiguracji. Więcej informacji znajduje się powyżej.*[Auth] Pobierz token dostępu * Służy do wygenerowania tokenu dostępu, który musi być dołączony do wszystkich kolejnych wywołań Connector Functions.* Funkcje [Opportunity]: * Pobierz wszystkie pola * Zwraca wszystkie pola zapytanej szansy sprzedaży. Wymaga tokenu dostępu i identyfikatora szansy sprzedaży. * Zmień etap * Aktualizuje etap wskazanej szansy sprzedaży na określoną wartość.* Funkcje [Order]: * Pobierz wszystkie zamówienia o statusie * Zwraca listę wszystkich zamówień o określonym statusie. * Liczba zamówień o statusie * Zwraca liczbę wszystkich zamówień o określonym statusie. * Pobierz numer zamówienia na podstawie identyfikatora * Zwraca numer zamówienia na podstawie podanego identyfikatora zamówienia.
Aby dostosować te funkcje do własnych potrzeb, należy uwzględnić poniższe wskazówki: 1. Aby zmodyfikować funkcję typu obiektowego Connector Functions, wystarczy zmienić obiekt wskazany w adresie URL. W razie potrzeby dodaj lub usuń nowe wyniki. 2. Aby zmodyfikować funkcję typu zapytania Connector Functions, wszystkie zmiany należy wprowadzić w zapytaniu. Znajdziesz je w parametrach zapytania pod kluczem q. 1. Wskazówka: ogranicz liczbę wyników zapytania za pomocą funkcji LIMIT(liczba_wyników)
Czy znalazłeś to, czego szukałeś?
Możesz również przejść na stronę community.tulip.co, aby zadać pytanie lub sprawdzić, czy inni użytkownicy mieli podobny problem!