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:

  1. manipulacja danymi za pomocą workbench.
  2. wykorzystanie REST API i metod asynchronicznych w workbenchu.
  3. migracja poprzez workbench.
  4. różnica między konsolą programistyczną a stołem warsztatowym.
  5. 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.
  1. 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,
  1. Salesforce ID rekordów
  2. wynik
  3. 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.
  1. 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.
  1. 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,
  1. lista
  2. Matrix
  3. luzem CSV
  4. 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,
  1. zaktualizuj
  2. Usuń
  3. Przywróć
  4. Wyczyść
  5. 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.