Salesforce Workbench

Inleiding

Workbench is een krachtige, web-based suite van tools ontworpen om te communiceren met Salesforce.com organisaties via de Force.com API ‘ s.

dit artikel beschrijft verschillende belangrijke onderwerpen van Salesforce Workbench:

  1. datamanipulatie met behulp van workbench.
  2. gebruik van REST API en asynchrone methoden in workbench.
  3. migratie via workbench.
  4. verschil tussen developer console en workbench.
  5. scenario ‘ s die de functionaliteiten van workbench beschrijven.

Salesforce Workbench Login

  • Login op Workbench met de volgende URL.

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

  • Selecteer de omgeving, API-versie en voer de Salesforce-referenties in.
  • Salesforce Workbench wordt weergegeven na een succesvolle login.
  1. gegevensmanipulatie met behulp van workbench

Navigeer naar het tabblad ‘Data’ om verschillende bewerkingen voor gegevensmanipulatie uit te voeren.

1.1 om Insert -, Update-en Upsert-bewerkingen uit te voeren,

  • selecteer een object uit de drop-down’ objecttype’.
  • Selecteer ofwel ‘Single record ‘of’ uit bestand ‘ optie en klik op Volgende.
  • Upload Een geldig CSV-of ZIP-bestand in de optie ‘van bestand’.
  • klik op de knop ‘Bevestigen’ om het aantal invoegen / bijwerken / upsert-records te bevestigen.
  • na succesvolle datamanipulatie geeft het scherm,
  1. Salesforce ID van de records
  2. resultaat
  3. Status

1.2 om te verwijderen, Undelete en Purge operaties uit te voeren,

  • Selecteer ofwel ‘Single record ‘of’ uit bestand ‘ optie en klik op Volgende.
  • voer het record-ID (Salesforce-ID) in om te verwijderen, ongedaan te maken of te verwijderen.
  • klik op de knop ‘Bevestigen’ om het aantal delete / Undelete / Purge-records te bevestigen.
  • Workbench geeft de ‘Salesforce ID’ en de status van het resultaat weer na succesvolle gegevensmanipulatie.
  1. gebruik van REST API en asynchrone methoden in workbench

2.1 REST Explorer

REST Explorer in workbench helpt de gebruiker om de REST API te verkennen en te ontdekken, waardoor de gebruiker de gegevens in de Salesforce org kan ophalen, aanmaken, bijwerken of verwijderen.

  • Ga naar het tabblad ‘Hulpprogramma’ s ‘ en selecteer ‘REST Explorer”
  • standaard is de HTTP methode ingesteld op’GET’.
  • Als u op de knop ‘Headers’ klikt, verschijnt de ‘Request Headers’
  • het antwoord is standaard ingesteld op ‘JSON’ – indeling. Het kan ook worden gewijzigd in ‘XML’

2.1.1 HTTP-methoden in REST API

Methode 1: POST

  • voor het maken van records met behulp van REST API wordt de ‘POST’ – methode gebruikt.
  • zorg ervoor dat de verbinding is ingesteld als ‘/sobjects/URI’.
  • Stel de “aanvraagtekst” in met velden en de bijbehorende waarden.
  • klik op de knop ‘Uitvoeren’ om het antwoordbericht te ontvangen dat het invoegen bevestigt.

Methode 2: GET

  • om een record van Salesforce org te lezen, wordt de’ GET ‘ – methode gebruikt.
  • Stel de SOQL query in die alle records in de Salesforce org retourneert.

Query: / services / data / v41. 0/query/?q=Select + Id, Name + from + Account + LIMIT+5

  • klik op de knop ‘ Uitvoeren ‘om het succesbericht en de’ ruwe reactie ‘ te ontvangen.

Methode 3: PATCH

  • voor het bewerken / bijwerken van records via REST API wordt de ‘PATCH’ – methode gebruikt.
  • Stel de “aanvraagtekst” in met velden en waarden voor het bijwerken van de records.
  • klik op ‘Uitvoeren’ om het antwoordbericht te ontvangen.

Methode 4: Verwijder

  • om records via REST API te verwijderen, wordt de methode ‘DELETE’ gebruikt.
  • Stel de URI in volgens het te verwijderen object en voer de bijbehorende ID in.
  • klik op de knop ‘Uitvoeren’ om het antwoordbericht te ontvangen dat de succesvolle verwijdering bevestigt.

2.2 asynchrone methoden in workbench

Apex-code en de Status van de API-taken kunnen in workbench worden uitgevoerd via asynchrone methoden.

2.2.1 Apex uitvoeren

  • met Apex uitvoeren kan de gebruiker records aanmaken, bijwerken en verwijderen.
  • Navigeer naar Hulpprogramma ‘ s à Apex uitvoeren.
  • Voer de Apex-Code in de opgegeven spatie in, die werkt als een anoniem venster.
  • Selecteer de ‘log category’ als ‘Apex Code’ en ‘Log Level’ als ‘Debug’.
  • klik op de knop ‘Uitvoeren’ om de resultaten van de Apex-uitvoering in hetzelfde venster te zien.

2.2.2 Bulk API-taakstatus

  • Bulk API-taakstatus wordt gebruikt om de ‘asynchrone gegevensbelastingsstatus en resultaten’
  • Navigeer naar Hulpprogramma ‘ s à Bulk API-taakstatus weer te geven.
  • voer het ’taak-ID’ in het opgegeven tekstvak in.
  • klik op de knop ‘Status ophalen’ om de status van de bulkdatataken op te halen en in hetzelfde venster weer te geven.
  1. migratie via Workbench

migratie in workbench helpt de gebruiker om de metagegevenscomponenten te’ ophalen ‘en’ implementeren ‘ die de organisatie helpen structureren, zoals aangepaste toepassingen, objecten en andere componenten.

3.1 ophalen

om metagegevenscomponenten uit de organisatie op te halen,

  • bereid een XML-bestand met normen en typen gedefinieerd met de versie van API voor de aanvraag.

  • Navigeer naar migratie à ophalen
  • in de sectie unpackaged Manifest, selecteer het aangemaakte pakket XML-bestand om de component attributen te verkrijgen.
  • voer optioneel de ‘ pakketnamen ‘in en schakel het selectievakje’ enkel pakket ‘ in en klik op Volgende.
  • na het succesvol uploaden van het XML-bestand, klikt u op’ Ophalen ‘
  • klik op ‘Download ZIP-bestand’ om de metagegevenscomponenten van de organisatie te bekijken.

3.2 implementeer

om de metagegevenscomponenten in de organisatie te implementeren,

  • Maak een map aan met ‘Package XML’ in de root en een submap met de naam van de component. Rits de map dicht.
  • Navigeer naar migratie à implementatie
  • in Kies sectie, selecteer de map met het pakket XML om de metagegevenscomponenten te implementeren.
  • selecteer optioneel de onderstaande selectievakjes en klik op Volgende.
  • na succesvolle upload klikt u op’ Implementeren ‘
  • bevestig de resultaten implementeren met succes, als u de bestanden niet controleert op fouten.

4.Verschil tussen Developer Console en Workbench

Salesforce Object Query Language (SOQL) en Salesforce Object Search Language (SOSL) query ‘ s kunnen zowel in developer console als in workbench worden uitgevoerd.

het belangrijkste verschil tussen het gebruik van developer console en workbench is de gebruikersinterface. Workbench biedt gebruikers een verbeterde gebruikersinterface om de records te bevragen.

  • de SOQL-queries kunnen worden gebouwd door alleen de drop-down ‘Object’ en ‘fields’ te selecteren.

  • Queries kunnen worden gefilterd met behulp van’ Sorteer resultaten op ‘en’ resultaten filteren op ‘ drop-down.

  • in workbench kunnen de query-resultaten worden bekeken als,
  1. lijst
  2. Matrix
  3. Bulk CSV
  4. Bulk XML

  • de records die worden verwijderd en gearchiveerd kunnen worden uitgesloten of opgenomen.

  • de resultaten van SOQL query kan worden geëxporteerd via ‘Bulk CSV’ optie om de gegevens te analyseren voor toekomstig gebruik.
  • de SOSL-queries kunnen worden gebouwd door de opties ‘zoeken naar’ en ‘object retourneren’ op te geven.
  • de resultaten van de SOSL queries worden weergegeven in de lijst formaat waarin de ID ‘s. Ga met de muis over de ID’ s om acties uit te voeren, zoals,
  1. Update
  2. Delete
  3. Undelete
  4. Purge
  5. View in Salesforce

5.Scenario ’s die Workbench’ s functionaliteiten

Scenario 1

een gebruiker wordt gevraagd om het aantal metagegevenscomponenten in een Salesforce-organisatie te achterhalen.

om dit te bereiken met workbench,

  • Navigeer naar Info Tab à metadata types & componenten.
  • Selecteer elke metadata uit de keuzelijst.
  • bij selectie beschrijft en toont workbench het ’totale aantal componenten’ dat aanwezig is in de specifieke Metadata.

Scenario 2

Exporteer gegevens voor de gebruikers die zijn toegewezen aan Machtigingssets.

om dit scenario te bereiken met behulp van Workbench,

  • Navigeer naar Queries à SOQL Query
  • Selecteer ‘PermissionSetAssignment’ in de object drop-down en de benodigde velden.
  • Selecteer ‘Bulk CSV’ in weergave als optie en klik op Query.
  • dit brengt de gebruiker naar een volgend scherm met het taak-ID en de status van de taak.
  • klik op de downloadknop om de SOQL-query naar een CSV-bestand te exporteren.

Scenario 3

een gebruiker kon niet inloggen en kreeg de e-mail voor het opnieuw instellen van het wachtwoord niet toen hij probeerde het wachtwoord te resetten.

om dit te bereiken met workbench,

  • Navigeer naar Utilities à Password Management
  • klik op de ‘Reset’ optie en voer het gebruikers-ID in.
  • klik op de knop ‘Wachtwoord wijzigen’ om het wachtwoord opnieuw in te stellen.
  • klik op de ‘ Set ‘ optie en voer het gebruikers-ID in.
  • Voer de waarden in voor de velden ‘Wachtwoord’ en ‘Wachtwoord bevestigen’.
  • klik op ‘Wachtwoord wijzigen’ om het wachtwoord voor de gebruiker te wijzigen.

voordelen van workbench

  • het geeft ons toegang tot gegevens en structurele informatie van alle objecten in het systeem.
  • voor bevroren of vergrendelde gebruikers helpt SOQL-queries in Workbench om de gegevens te bekijken.
  • die op Mac kunnen het gebruiken zonder extra software.

nadelen van workbench

  • Workbench heeft een onvermogen om gegevenslasttoewijzingen op te slaan en te hergebruiken, zoals we dat met de gegevenslader kunnen doen.
  • Workbench heeft geen mogelijkheid om command line of geplande acties uit te voeren, zoals bij data loader.