Salesforce Inspector: zapytania i eksport danych (kurs Zapytania SOQL, lekcja 2)

Salesforce Inspector to bezpłatna wtyczka do przeglądarki, której używa na co dzień wielu administratorów i konsultantów Salesforce. Najczęściej służy do trzech rzeczy:

pisania i uruchamiania zapytań SOQL z podpowiedziami pól,
kopiowania wyników prosto do Excela,
sprawdzania nazw API pól i relacji na dowolnym rekordzie.

Na niej przećwiczysz wszystkie zapytania z tego kursu.

Którą wersję zainstalować? Oryginalny Salesforce Inspector nie jest już rozwijany i zniknął ze sklepu Chrome. Rozwijana wersja nazywa się Salesforce Inspector Reloaded i to ją opisujemy. Lekcja odpowiada wersji 2.0 z jesieni 2026 roku, więc w nowszych wydaniach niektóre nazwy mogą się różnić.

Zanim zainstalujesz: bezpieczeństwo

Wtyczka działa w Twojej przeglądarce i łączy się bezpośrednio z Salesforce. Według dokumentacji projektu dane nie trafiają do nikogo innego.
Działa w Twoim imieniu i z Twoimi uprawnieniami. Widzisz tylko to, do czego masz dostęp w Salesforce, ale możesz też zmienić wszystko, do czego masz prawo edycji.
Korzysta z API Salesforce, więc Twoje konto musi mieć dostęp do API. W darmowym orgu do nauki masz go jako administrator.
Historia zapytań zapisuje się w przeglądarce, łącznie z wartościami w warunkach WHERE. Na wspólnym komputerze nie wpisuj do zapytań danych wrażliwych.
W firmie najpierw sprawdź zasady dotyczące wtyczek. W części organizacji administrator musi dodatkowo zatwierdzić aplikację połączoną, z której korzysta Inspector. Bez tego zobaczysz błąd OAUTH_APP_BLOCKED.

Instalacja i pierwsze uruchomienie

Zainstaluj Salesforce Inspector Reloaded z oficjalnego sklepu swojej przeglądarki: Chrome, Edge albo Firefox.
Zaloguj się do swojego orga i odśwież stronę Salesforce.
Przy prawej krawędzi okna pojawi się mała zakładka ze strzałką. Po najechaniu wyświetli podpowiedź Show Salesforce details. Kliknij ją, żeby otworzyć okienko wtyczki. Możesz też kliknąć ikonę wtyczki na pasku przeglądarki.

Okienko ma zakładki Objects, Users, Shortcuts i Org oraz przyciski narzędzi. Najważniejsze dla nas to:

Przycisk	Do czego służy
Data Export	pisanie zapytań SOQL i eksport wyników
Show all data	wszystkie pola bieżącego rekordu z nazwami API i wartościami
Show fields API names	nazwy API pól wyświetlone bezpośrednio na stronie rekordu
Data Import	masowe tworzenie i zmiana rekordów (ostrożnie, o tym niżej)
Org Limits	wykorzystanie limitów orga, np. wywołań API

Data Export: zapytania z podpowiedziami

Kliknij Data Export. Otworzy się nowa karta z polem na zapytanie.

Podpowiedzi pojawiają się same. Po FROM zobaczysz pod polem listę obiektów, a w SELECT i WHERE listę pól wybranego obiektu. Kliknij podpowiedź, żeby ją wstawić. Działa to także dla relacji, np. po wpisaniu Account.Owner..
Ctrl + Spacja z kursorem między SELECT a FROM wstawia wszystkie pola, do których masz dostęp. W warunku WHERE ten sam skrót podpowiada wartości pól. Wartości picklist i checkboxów podpowiadają się same.
Zapytanie uruchamiasz przyciskiem Run Export albo skrótem Ctrl + Enter (lub F5).

Wynik pojawia się w tabeli poniżej, z licznikiem w rodzaju Exported 25 records. Pola rekordów nadrzędnych mają osobne kolumny, np. Account.Name. Pole Filter nad tabelą przeszukuje wyniki bez ponownego zapytania. Kliknięcie Id rekordu otwiera menu z opcjami: Show all data, Query Record, View in Salesforce i Copy Id.

Historia i zapisane zapytania

Każde udane zapytanie trafia do listy Query History.
Zapytania, do których wracasz, zapisz: wpisz nazwę w pole Query Label i kliknij Save Query. Znajdziesz je potem na liście Saved Queries.
Historia i zapisane zapytania są przechowywane w przeglądarce. Wyczyszczenie danych przeglądarki je usunie. W opcjach wtyczki możesz wyeksportować ustawienia jako kopię zapasową.

Usunięte rekordy i Tooling API

Nad zapytaniem są dwa przełączniki:

Deleted/Archived Records dołącza do wyników rekordy z kosza i rekordy zarchiwizowane. Przydaje się, gdy szukasz czegoś, co ktoś usunął.
Tooling API pozwala odpytywać metadane (np. definicje pól i Flow), ale nie zwykłe dane. Na początek zostaw go wyłączonego.

Obu przełączników nie da się włączyć jednocześnie.

Eksport wyników

Przycisk	Co robi
Copy (Excel)	kopiuje wyniki do schowka w formacie, który wklejasz prosto do Excela lub Arkuszy Google
Copy (CSV)	kopiuje wyniki jako tekst CSV
Copy (JSON)	kopiuje surową odpowiedź API, przydatną dla programistów
ikona pobierania	zapisuje wyniki jako plik CSV

Wtyczka nie zapisuje plików .xlsx. Do Excela przenosisz dane przez schowek albo plik CSV.

Polskie znaki w Excelu: jeśli po otwarciu pliku CSV w Excelu polskie litery wyglądają źle, włącz w opcjach wtyczki Use BOM for CSV export i pobierz plik jeszcze raz.

Duże eksporty: wtyczka pobiera wyniki partiami aż do końca, ale nie korzysta z Bulk API. Przy dziesiątkach tysięcy rekordów może spowolnić albo zawiesić przeglądarkę. Do takich eksportów lepiej użyć Data Loadera albo zawęzić zapytanie warunkiem WHERE.

Zapytania z podzapytaniami i agregatami też działają. Rekordy podrzędne z podzapytań trafiają do dodatkowych kolumn, więc wynik szybko rośnie.

Show all data: nazwy API i relacje

Otwórz dowolny rekord, np. nieruchomość z modułu 2 kursu podstaw, i w okienku wtyczki kliknij Show all data. Zobaczysz dwie zakładki:

Fields: każde pole z kolumnami Field API Name, Label, Type i Value. To najszybszy sposób, żeby sprawdzić dokładną nazwę API pola do zapytania.
Relationships: relacje podrzędne z kolumnami Relationship Name, Child Object, Field i Label. Tu znajdziesz nazwę relacji do podzapytania, np. Offers dla ofert nieruchomości. W zapytaniu dopiszesz do niej __r.

Show all data możesz też otworzyć dla całego obiektu, bez konkretnego rekordu: wybierz obiekt na zakładce Objects w okienku wtyczki.

Data Import: ostrożnie

Data Import potrafi masowo tworzyć, zmieniać i usuwać rekordy (operacje Insert, Update, Upsert, Delete, Undelete). Dane wklejasz z Excela lub CSV, a wtyczka zapisuje je bezpośrednio w Salesforce, z Twoimi uprawnieniami.

Przed każdym uruchomieniem wtyczka ostrzega, że zmiany nie da się cofnąć. Traktuj to poważnie:

ćwicz tylko w orgu do nauki albo w sandboxie,
przed zmianą danych zrób eksport rekordów, które zmieniasz, jako kopię zapasową,
pod wynikami eksportu jest też przycisk Delete Records, który usuwa wyświetlone rekordy. Nie klikaj go z ciekawości.

Ćwiczenie

Zainstaluj Salesforce Inspector Reloaded i otwórz okienko wtyczki na stronie dowolnej nieruchomości.
Kliknij Show all data i odczytaj nazwy API pól Cena i Sprzedający. Na zakładce Relationships znajdź nazwę relacji ofert.
W Data Export napisz z podpowiedziami zapytanie o nazwę, cenę i e-mail sprzedającego wszystkich nieruchomości. Uruchom je skrótem Ctrl + Enter.
Zapisz zapytanie pod nazwą Nieruchomości ze sprzedającymi.
Skopiuj wyniki przyciskiem Copy (Excel) i wklej je do arkusza.
Usuń testową ofertę w Salesforce, a potem znajdź ją w Inspectorze z włączonym przełącznikiem Deleted/Archived Records. Przywróć ją z kosza.

Sprawdź się

1. Gdzie najszybciej sprawdzisz nazwę relacji do podzapytania, np. dla ofert nieruchomości?

Pokaż odpowiedź

W Inspectorze: Show all data na rekordzie nieruchomości, zakładka Relationships, kolumna Relationship Name. W zapytaniu dopisujesz do niej __r.

2. Zapytanie nie zwraca rekordu, który ktoś usunął wczoraj. Co zrobisz?

Pokaż odpowiedź

Włączysz przełącznik Deleted/Archived Records. Wtedy wyniki obejmą też rekordy z kosza.

3. Masz wyeksportować 200 000 rekordów. Dlaczego lepiej nie robić tego w Inspectorze?

Pokaż odpowiedź

Inspector nie korzysta z Bulk API i przy bardzo dużych wynikach może zawiesić przeglądarkę. Do takich eksportów lepiej nadaje się Data Loader.

Następny krok: z Inspectorem pod ręką nauczysz się precyzyjnie filtrować dane w klauzuli WHERE.