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:
- Manipulace s Daty pomocí workbench.
- využití REST API a asynchronních metod v workbench.
- migrace přes pracovní stůl.
- rozdíl mezi vývojářskou konzolí a pracovním stolem.
- 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í.
- 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í,
- Salesforce ID záznamů
- Výsledek
- 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.
- 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ě.
- 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,
- Seznam
- Matrix
- Hromadné CSV
- 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,
- Aktualizace
- Odstranit
- Obnovit
- Purge
- 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.