Salesforce Workbench

Úvod

Workbench je výkonný, web-based sada nástrojů navržen tak, aby komunikovat s Salesforce.com organizace prostřednictvím Force.com rozhraní Api.

Tento článek popisuje různé důležité témata Salesforce Workbench:

  1. Manipulace s Daty pomocí workbench.
  2. využití REST API a asynchronních metod v workbench.
  3. migrace přes pracovní stůl.
  4. rozdíl mezi vývojářskou konzolí a pracovním stolem.
  5. scénáře popisující funkce pracovního stolu.

Salesforce Workbench Login

  • přihlaste se do Workbench pomocí následující adresy URL.

URL: https://workbench.developerforce.com/login.php

  • vyberte prostředí, verzi API a zadejte pověření Salesforce.
  • Salesforce Workbench se zobrazí po úspěšném přihlášení.
  1. Manipulace s Daty pomocí workbench

Přejděte na „Údaje“ na kartě provádět různé manipulace s daty operace.

1.1 Chcete-li provádět operace vložení, aktualizace a Upsert,

  • v rozevírací nabídce „Typ objektu“ vyberte objekt.
  • vyberte možnost „jeden záznam“ nebo „ze souboru“ a klikněte na další.
  • Nahrajte libovolný platný soubor CSV nebo ZIP v možnosti „ze souboru“.
  • kliknutím na tlačítko „Potvrdit“ potvrďte počet záznamů Insert / Update / Upsert.
  • Po úspěšné manipulaci s daty operace, na displeji se zobrazí,
  1. Salesforce ID záznamů
  2. Výsledek
  3. Stav

1.2 Chcete-li provést operace mazání, obnovení a vyčištění,

  • vyberte možnost „jeden záznam“ nebo „ze souboru“ a klikněte na další.
  • zadejte ID záznamu (Salesforce ID) pro odstranění, obnovení nebo vymazání.
  • kliknutím na tlačítko „Potvrdit“ potvrďte počet záznamů o odstranění / obnovení / vyčištění.
  • Workbench zobrazuje „Salesforce ID“ a stav výsledku po úspěšné manipulaci s daty.
  1. využití REST API a asynchronních metod v workbench

2.1 rest Explorer

REST Explorer v workbench pomáhá uživateli prozkoumat a objevit REST API, což umožňuje uživateli načíst, vytvořit, aktualizovat nebo odstranit data v Salesforce org.

  • přejděte na kartu ‚Utilities‘ a vyberte ‚REST Explorer‘
  • ve výchozím nastavení je metoda HTTP nastavena na „GET“.
  • kliknutím na tlačítko „záhlaví“ se zobrazí „záhlaví požadavků“
  • odpověď je ve výchozím nastavení nastavena na formát „JSON“. Může být také změněn na ‚XML‘

2.1.1 HTTP metody v REST API

Metoda 1: POST

  • pro vytváření záznamů pomocí REST API se používá metoda‘ POST‘.
  • ujistěte se, že je připojení nastaveno jako ‚/ sobjects / URI‘.
  • nastavte „tělo požadavku“ s poli a jeho hodnotami.
  • kliknutím na tlačítko „Spustit“ obdržíte zprávu s odpovědí potvrzující úspěšné vložení.

Metoda 2: ZÍSKAT

  • přečtěte si záznam z Salesforce org, ‚GET‘ metoda se používá.
  • nastavte dotaz SOQL, který vrátí všechny záznamy přítomné v Salesforce org.

dotaz: / services / data / v41. 0/dotaz/?q=vybrat + Id, jméno+z + účet+LIMIT+5

  • kliknutím na tlačítko „Spustit“ obdržíte zprávu o úspěchu a „surovou odpověď“.

Metoda 3: Oprava

  • pro editaci / aktualizaci záznamů pomocí rozhraní REST API se používá metoda „PATCH“.
  • nastavte „tělo požadavku“ s poli a hodnotami pro aktualizaci záznamů.
  • kliknutím na tlačítko „Spustit“ obdržíte zprávu s odpovědí.

Metoda 4: smazat

  • Chcete-li odstranit záznamy pomocí rozhraní REST API, použije se metoda „DELETE“.
  • nastavte URI podle objektu, který má být odstraněn, a zadejte jeho související ID.
  • kliknutím na tlačítko „Spustit“ obdržíte zprávu s odpovědí potvrzující úspěšné odstranění.

2.2 asynchronní metody v workbench

Apex kód a stav úloh API lze provádět v workbench pomocí asynchronních metod.

2.2.1 Apex Execute

  • pomocí Apex Execute může uživatel vytvářet, aktualizovat a mazat záznamy.
  • přejděte na Nástroje à Apex Execute.
  • zadejte do zadaného prostoru Apex kód, který funguje jako anonymní okno.
  • vyberte „Log category“ jako „Apex Code“ a „Log Level“ jako „Debug“.
  • kliknutím na tlačítko „Spustit“ zobrazíte výsledky provádění Apex ve stejném okně.

2.2.2 Hromadné API Job Status

  • Hromadné API Stav Úlohy slouží k zobrazení ‚Asynchronní data stav zatížení a výsledků
  • Přejděte na Nástroje à Hromadné API Stav Úlohy.
  • do zadaného textového pole zadejte „ID úlohy“.
  • klikněte na tlačítko „Získat stav“ pro načtení stavu úloh hromadných dat a zobrazení ve stejném okně.
  1. Migrace přes Workbench

Migrace v pracovní desce umožňuje uživateli, aby ‚Načíst‘ a ‚Nasadit‘ Metadata komponenty, které pomáhají struktura organizace jako vlastní aplikace, objekty a další komponenty.

3.1 Načtení

načíst Metadata komponent od organizace,

  • Připravit XML soubor s normami a typy definované s verzí API pro žádost.

  • Přejděte k Migraci à Načíst
  • V Nebalené Manifest část, vyberte vytvořený balíček XML souboru pro získání komponentu atributy.
  • volitelně zadejte „názvy balíčků“ a zaškrtněte políčko „jeden balíček“ a klikněte na další.
  • po úspěšném nahrání souboru XML klikněte na „Načíst“
  • kliknutím na „Stáhnout soubor ZIP“ zobrazíte nasazené komponenty metadat z organizace.

3.2 Nasazení

nasazení Metadat komponenty organizace,

  • Vytvořte složku s ‚Balíček XML‘ v kořenové a podřízené úrovni složky s názvem součásti. ZIP složku.
  • přejděte na Migration à Deploy
  • v sekci Vybrat vyberte složku s balíčkem XML pro nasazení komponent metadat.
  • volitelně zaškrtněte níže uvedená políčka a klikněte na tlačítko Další.
  • po úspěšném nahrání klikněte na tlačítko „nasadit“
  • potvrďte úspěšné nasazení výsledků, pokud nekontrolujete soubory kvůli chybám.

4.Rozdíl mezi Developer Console a Workbench

Salesforce Object Query Language (SOQL) a Salesforce Objekt Hledání Jazyka (SOSL), Dotazy mohou být provedeny jak ve vývojářské konzoli, stejně jako v workbench.

hlavní rozdíl mezi používáním vývojářské konzole a workbench je uživatelské rozhraní. Workbench poskytuje uživatelům vylepšené uživatelské rozhraní pro dotazování záznamů.

  • dotazy SOQL lze vytvořit pouhým výběrem rozbalovací nabídky „objekt“ a „pole“.

  • dotazy lze filtrovat pomocí rozbalovací nabídky „třídit výsledky podle“ a „filtrovat výsledky podle“.

  • V workbench, výsledky dotazu může být viděn jako,
  1. Seznam
  2. Matrix
  3. Hromadné CSV
  4. Hromadné XML

  • Záznamy, které jsou odstraněny a archivovány může být buď vyloučeny nebo v ceně.

  • výsledky soql dotazu lze exportovat pomocí „Bulk CSV“ možnost analyzovat data pro budoucí použití.
  • dotazy SOSL lze vytvořit zadáním možností „vyhledat“ a „vrátit objekt“.
  • výsledky SOSL dotazy jsou zobrazeny ve formátu Seznamu s uvedením ID. Umístěte kurzor na ID je provádět akce, jako je,
  1. Aktualizace
  2. Odstranit
  3. Obnovit
  4. Purge
  5. Zobrazit v Salesforce

5.Scénáře popisující funkce Workbench

Scénář 1

uživatel je požádán, aby zjistil počet komponent metadat v Organizaci Salesforce.

k dosažení tohoto cíle pomocí pracovního stolu,

  • přejděte na kartu Informace à typy metadat & komponenty.
  • vyberte libovolná Metadata ze seznamu rozevíracího seznamu.
  • při výběru workbench popisuje a zobrazuje „celkový počet komponent“ přítomných v konkrétních metadatech.

scénář 2

Export dat pro uživatele, kteří jsou přiřazeni k sadám oprávnění.

K dosažení tohoto scénáře, s využitím Workbench,

  • Přejděte na Dotazy à Dotaz SOQL
  • Vyberte ‚PermissionSetAssignment v objektu drop-dolů a potřebná pole.
  • vyberte možnost „Bulk CSV“ v zobrazení jako možnost a klikněte na dotaz.
  • tím se uživatel dostane na další obrazovku zobrazující ID úlohy a stav úlohy.
  • kliknutím na tlačítko Stáhnout exportujete dotaz SOQL do souboru CSV.

scénář 3

uživatel se Nemohl přihlásit a při pokusu o resetování hesla nedostal e-mail pro obnovení hesla.

K dosažení tohoto cíle pomocí workbench,

  • Přejděte na Nástroje à Správa Hesla
  • Klepněte na „Reset“ možnost a zadejte ID Uživatele.
  • pro obnovení hesla klikněte na tlačítko „Změnit heslo“.
  • klikněte na možnost „nastavit“ a zadejte ID uživatele.
  • zadejte hodnoty pro pole „Heslo“ a „Potvrdit heslo“.
  • klikněte na „Změnit heslo“ pro změnu hesla pro uživatele.

Výhody workbench

  • To nám dává přístup k datům a strukturálních informací ze všech objektů v systému.
  • pro zmrazené nebo uzamčené uživatele, soql dotazy v Workbench pomáhá zobrazit data.
  • ti na Macu jej mohou používat bez dalšího softwaru.

Nevýhody workbench

  • Workbench má neschopnost uložit a znovu použít data načíst mapování, jako to můžeme udělat s údaji loader.
  • Workbench nemá schopnost provádět příkazový řádek nebo naplánované akce, jako u Data loader.