Workbench Salesforce
wprowadzenie
Workbench to potężny, internetowy pakiet narzędzi zaprojektowany do interakcji z Salesforce.com organizacje za pośrednictwem Force.com APIs.
Ten artykuł opisuje różne ważne tematy stołu roboczego Salesforce:
- manipulacja danymi za pomocą workbench.
- wykorzystanie REST API i metod asynchronicznych w workbenchu.
- migracja poprzez workbench.
- różnica między konsolą programistyczną a stołem warsztatowym.
- scenariusze opisujące funkcjonalności workbencha.
Zaloguj się do Workbencha Salesforce
- Zaloguj się do Workbencha za pomocą następującego adresu URL.
URL: https://workbench.developerforce.com/login.php
- Wybierz środowisko, wersję interfejsu API i wprowadź poświadczenia Salesforce.
- stół roboczy Salesforce zostanie wyświetlony po pomyślnym zalogowaniu.
- manipulacja danymi za pomocą workbench
przejdź do zakładki „Dane”, aby wykonać różne operacje manipulacji danymi.
1.1 do wykonywania operacji Insert, Update i Upsert,
- wybierz obiekt z listy rozwijanej „typ obiektu”.
- wybierz opcję „pojedynczy rekord” lub „z pliku” i kliknij Dalej.
- Prześlij dowolny poprawny plik CSV lub ZIP w opcji „z pliku”.
- kliknij przycisk „Potwierdź”, aby potwierdzić liczbę rekordów Insert / Update / Upsert.
- po udanej operacji manipulacji danymi, ekran wyświetla,
- Salesforce ID rekordów
- wynik
- Status
1.2 aby wykonać operacje usuwania, przywracania i usuwania,
- wybierz opcję „pojedynczy rekord” lub „z pliku” i kliknij Dalej.
- wprowadź identyfikator rekordu (Salesforce ID), aby usunąć, przywrócić lub usunąć.
- kliknij przycisk „Potwierdź”, aby potwierdzić liczbę Usuń / Przywróć / Wyczyść rekordy.
- Workbench wyświetla „Salesforce ID” i status wyniku Po udanej manipulacji danymi.
- wykorzystanie REST API i metod asynchronicznych w workbench
2.1 Rest Explorer
Rest Explorer w workbench pomaga użytkownikowi eksplorować i odkrywać interfejs API REST, umożliwiając użytkownikowi pobieranie, tworzenie, aktualizowanie lub usuwanie danych w organizacji Salesforce.
- przejdź do zakładki „Narzędzia” i wybierz „REST Explorer’
- domyślnie metoda HTTP jest ustawiona na 'GET’.
- kliknięcie przycisku „nagłówki” wyświetla „nagłówki żądania”
- odpowiedź jest domyślnie ustawiona na format „JSON”. Można go również zmienić na „XML’
2.1.1 metody HTTP w REST API
Metoda 1: POST
- do tworzenia rekordów przy użyciu REST API używana jest metoda 'POST’.
- upewnij się, że połączenie jest ustawione jako '/sobjects/URI’.
- Ustaw „treść żądania” z polami i jego wartościami.
- kliknij przycisk „Wykonaj”, aby otrzymać wiadomość odpowiedzi potwierdzającą pomyślne wstawienie.
Metoda 2: Pobierz
- aby odczytać rekord z Salesforce org, używana jest metoda 'GET’.
- Ustaw zapytanie SOQL, które zwraca wszystkie rekordy obecne w org.Salesforce.
zapytanie: / services / data/v41.0/query/?q=Select + Id, Name + from + Account + LIMIT+5
- kliknij przycisk „Wykonaj”, aby otrzymać wiadomość o sukcesie, a także „odpowiedź surową”.
Metoda 3: PATCH
- do edycji / aktualizacji rekordów przez REST API używana jest metoda 'PATCH’.
- Ustaw „treść żądania” z polami i wartościami do aktualizacji rekordów.
- kliknij przycisk „Wykonaj”, aby otrzymać wiadomość odpowiedzi.
metoda 4: DELETE
- aby usunąć rekordy za pośrednictwem REST API, używana jest metoda 'DELETE’.
- Ustaw URI zgodnie z obiektem, który ma zostać usunięty, i wprowadź jego powiązany identyfikator.
- kliknij przycisk „Wykonaj”, aby otrzymać wiadomość z odpowiedzią potwierdzającą pomyślne usunięcie.
2.2 metody asynchroniczne w workbench
kod Apex i Status zadań API mogą być wykonywane w workbench za pomocą metod asynchronicznych.
2.2.1 Apex Execute
- używając Apex Execute użytkownik może tworzyć, aktualizować i usuwać rekordy.
- przejdź do Narzędzia à Apex Execute.
- Wprowadź kod wierzchołka w podanej przestrzeni, który działa jako anonimowe okno.
- Wybierz „kategorię dziennika” jako „kod wierzchołka” i „poziom dziennika” jako „debugowanie”.
- kliknij przycisk „Wykonaj”, aby zobaczyć wyniki wykonania Apex w tym samym oknie.
2.2.2 status zadania zbiorczego API
- status zadania zbiorczego API służy do wyświetlania „asynchronicznego stanu obciążenia danych i wyników”
- przejdź do opcji Narzędzia à Bulk API Status.
- wprowadź „ID zadania” w podanym polu tekstowym.
- kliknij przycisk „Uzyskaj Status”, aby pobrać status zadań zbiorczych danych i wyświetlić w tym samym oknie.
- migracja za pomocą Workbench
migracja w workbench pomaga użytkownikowi „pobrać” i „wdrożyć” składniki metadanych, które pomagają w strukturyzacji organizacji, takie jak niestandardowe aplikacje, obiekty i inne składniki.
3.1 Pobierz
, aby pobrać składniki metadanych z organizacji,
- przygotowanie pliku XML ze standardami i typami zdefiniowanymi w wersji API dla żądania.
- przejdź do Migracja do pobrania
- w sekcji Manifest Bez opakowania wybierz utworzony plik XML pakietu, aby uzyskać atrybuty komponentu.
- Opcjonalnie Wprowadź „nazwy pakietów”, zaznacz pole wyboru „pojedynczy pakiet” i kliknij Dalej.
- po pomyślnym przesłaniu pliku XML kliknij „Pobierz”
- kliknij „Pobierz plik ZIP”, aby wyświetlić wdrożone składniki metadanych z organizacji.
3.2 Wdróż
, aby wdrożyć składniki metadanych w organizacji,
- Utwórz folder z „Package XML” w katalogu głównym i folder podrzędny z nazwą komponentu. Zapnij folder.
- przejdź do Migration à Deploy
- w sekcji Wybierz Wybierz folder z pakietem XML, aby wdrożyć składniki metadanych.
- Opcjonalnie zaznacz poniższe pola wyboru i kliknij Dalej.
- po pomyślnym przesłaniu kliknij przycisk „Wdróż”
- Potwierdź wyniki wdrożenia, jeśli nie, sprawdź pliki pod kątem błędów.
4.Różnica między Developer Console a Workbench
zapytania Salesforce Object Query Language (SOQL) i Salesforce Object Search Language (SOSL) mogą być wykonywane zarówno w developer console, jak i w Workbench.
główną różnicą między używaniem konsoli programistycznej a workbencha jest interfejs użytkownika. Workbench zapewnia użytkownikom ulepszony interfejs użytkownika do odpytywania rekordów.
- zapytania SOQL można zbudować, wybierając listę rozwijaną „obiekt” i „pola”.
- zapytania można filtrować za pomocą listy rozwijanej „Sortuj wyniki według” i „filtruj wyniki według”.
- w workbench wyniki zapytania można przeglądać jako,
- lista
- Matrix
- luzem CSV
- luzem XML
- rekordy, które zostaną usunięte i zarchiwizowane, mogą być wykluczone lub dołączone.
- wyniki zapytania SOQL można wyeksportować za pomocą opcji „Bulk CSV” w celu analizy danych do wykorzystania w przyszłości.
- zapytania SOSL można zbudować, określając opcje „Szukaj” i „zwracanie obiektu”.
- wyniki zapytań SOSL są wyświetlane w formacie listy określającym ID. najedź kursorem na ID, aby wykonać takie działania, jak,
- zaktualizuj
- Usuń
- Przywróć
- Wyczyść
- Zobacz w Salesforce
5.Scenariusze opisujące funkcje Workbench
scenariusz 1
użytkownik jest proszony o sprawdzenie liczby składników metadanych w organizacji Salesforce.
aby to osiągnąć za pomocą workbench,
- przejdź do zakładki Informacje à metadane typy & składniki.
- Wybierz dowolne metadane z listy rozwijanej.
- po wybraniu workbench opisuje i wyświetla „całkowitą liczbę komponentów” obecnych w poszczególnych metadanych.
Scenariusz 2
Eksportuj dane dla użytkowników przypisanych do zestawów uprawnień.
aby osiągnąć ten scenariusz za pomocą Workbench,
- przejdź do zapytania à SOQL Query
- Wybierz „PermissionSetAssignment” z rozwijanej listy obiektów i niezbędnych pól.
- Wybierz „zbiorczy plik CSV” w widoku jako opcję i kliknij zapytanie.
- spowoduje to przejście użytkownika do następnego ekranu wyświetlającego identyfikator zadania i status zadania.
- kliknij przycisk Pobierz, aby wyeksportować zapytanie SOQL do pliku CSV.
Scenariusz 3
użytkownik nie mógł się zalogować i nie otrzymywał wiadomości e-mail zresetowania hasła podczas próby zresetowania hasła.
aby to osiągnąć za pomocą workbench,
- przejdź do narzędzia Zarządzanie hasłem
- kliknij opcję „Resetuj”i wprowadź identyfikator użytkownika.
- kliknij przycisk „Zmień hasło”, aby zresetować hasło.
- kliknij opcję „Ustaw” i wprowadź identyfikator użytkownika.
- wprowadź wartości dla pól „hasło” i „Potwierdź hasło”.
- kliknij „Zmień hasło”, aby zmienić hasło dla użytkownika.
zalety workbencha
- daje nam dostęp do danych i informacji strukturalnych ze wszystkich obiektów w systemie.
- w przypadku zamrożonych lub zablokowanych użytkowników zapytania SOQL w Workbench pomagają wyświetlić dane.
- osoby na Macu mogą z niego korzystać bez dodatkowego oprogramowania.
wady workbencha
- Workbench ma niemożność zapisywania i ponownego wykorzystywania mapowań ładowania danych, co możemy zrobić z programem do ładowania danych.
- Workbench nie ma możliwości wykonywania linii poleceń ani zaplanowanych działań, jak w przypadku programu data loader.