Salesforce Workbench

BY admin
|

Einführung

Workbench ist eine leistungsstarke, webbasierte Suite von Tools, die für die Interaktion mit Salesforce.com organisationen über die Force.com APIs.

Dieser Artikel beschreibt verschiedene wichtige Themen der Salesforce Workbench:

  1. Datenmanipulation mit Workbench.
  2. Verwendung der REST-API und asynchroner Methoden in Workbench.
  3. Migration über Workbench.
  4. Unterschied zwischen Developer Console und Workbench.
  5. Szenarien, die die Funktionalitäten der Workbench beschreiben.

Salesforce Workbench-Anmeldung

  • Melden Sie sich mit der folgenden URL bei Workbench an.

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

  • Wählen Sie die Umgebung und die API-Version aus und geben Sie die Salesforce-Anmeldeinformationen ein.
  • Salesforce Workbench wird nach erfolgreicher Anmeldung angezeigt.
  1. Datenmanipulation mit Workbench

Navigieren Sie zur Registerkarte ‚Daten‘, um verschiedene Datenmanipulationsvorgänge auszuführen.

1.1 Zum Ausführen von Insert-, Update- und Upsert-Vorgängen,

  • Wählen Sie ein Objekt aus der Dropdown-Liste ‚Objekttyp‘ aus.
  • Wählen Sie entweder ‚Single record‘ oder ‚From file‘ Option und klicken Sie auf Weiter.
  • Laden Sie eine gültige CSV- oder ZIP-Datei in die Option ‚Aus Datei‘ hoch.
  • Klicken Sie auf die Schaltfläche ‚Bestätigen‘, um die Anzahl der Insert / Update / Upsert-Datensätze zu bestätigen.
  • Nach erfolgreicher Datenmanipulation zeigt der Bildschirm,
  1. Salesforce-ID der Datensätze
  2. Ergebnis
  3. Status

1.2 Zum Ausführen von Delete-, Undelete- und Purge-Vorgängen,

  • Wählen Sie entweder ‚Single record‘ oder ‚From File‘ Option und klicken Sie auf Weiter.
  • Geben Sie die Datensatz-ID (Salesforce-ID) zum Löschen, Wiederherstellen oder Bereinigen ein.
  • Klicken Sie auf die Schaltfläche ‚Bestätigen‘, um die Anzahl der Delete / Undelete / Purge-Datensätze zu bestätigen.
  • Workbench zeigt die ‚Salesforce ID‘ und den Status des Ergebnisses nach erfolgreicher Datenmanipulation an.
  1. Verwendung von REST API und asynchronen Methoden in Workbench

2.1 REST Explorer

REST Explorer in Workbench hilft dem Benutzer, die REST-API zu erkunden und zu entdecken, sodass der Benutzer die Daten in der Salesforce-Organisation abrufen, erstellen, aktualisieren oder löschen kann.

  • Navigieren Sie zur Registerkarte ‚Dienstprogramme‘ und wählen Sie ‚REST Explorer‘
  • Standardmäßig ist die HTTP-Methode auf ‚GET‘ festgelegt.
  • Wenn Sie auf die Schaltfläche ‚Headers‘ klicken, werden die ‚Request Headers‘ angezeigt.
  • Die Antwort ist standardmäßig auf das Format ‚JSON‘ eingestellt. Es kann auch in ‚XML‘ geändert werden‘

2.1.1 HTTP-Methoden in der REST-API

Methode 1: POST

  • Zum Erstellen von Datensätzen mithilfe der REST-API wird die Methode ‚POST‘ verwendet.
  • Stellen Sie sicher, dass die Verbindung als ‚/sobjects/URI‘ festgelegt ist.
  • Setzen Sie den ‚Request Body‘ mit Feldern und seinen Werten.
  • Klicken Sie auf die Schaltfläche ‚Ausführen‘, um die Antwortnachricht zu erhalten, die das erfolgreiche Einfügen bestätigt.

Methode 2: GET

  • Um einen Datensatz aus der Salesforce-Organisation zu lesen, wird die Methode ‚GET‘ verwendet.
  • Legen Sie die SOQL-Abfrage fest, die alle in der Salesforce-Organisation vorhandenen Datensätze zurückgibt.

Abfrage: /services/data/v41.0/Abfrage/?q = Auswählen + ID, Name + von + Konto + LIMIT+5

  • Klicken Sie auf die Schaltfläche ‚Ausführen‘, um die Erfolgsmeldung sowie die ‚Rohe Antwort‘ zu erhalten.

Methode 3: PATCH

  • Zum Bearbeiten / Aktualisieren von Datensätzen über die REST-API wird die ‚PATCH‘-Methode verwendet.
  • Setzen Sie den ‚Request Body‘ mit Feldern und Werten zum Aktualisieren der Datensätze.
  • Klicken Sie auf die Schaltfläche ‚Ausführen‘, um die Antwortnachricht zu erhalten.

Methode 4: DELETE

  • Um Datensätze über die REST-API zu löschen, wird die Methode ‚DELETE‘ verwendet.
  • Legen Sie den URI entsprechend dem zu löschenden Objekt fest und geben Sie die zugehörige ID ein.
  • Klicken Sie auf die Schaltfläche ‚Ausführen‘, um die Antwortnachricht zu erhalten, die das erfolgreiche Löschen bestätigt.

2.2 Asynchrone Methoden in Workbench

Apex-Code und der Status der API-Jobs können in Workbench über asynchrone Methoden ausgeführt werden.

2.2.1 Apex Execute

  • Mit Apex Execute kann der Benutzer die Datensätze erstellen, aktualisieren und löschen.
  • Navigieren Sie zu Dienstprogramme à Apex Ausführen.
  • Geben Sie den Apex-Code in das dafür vorgesehene Feld ein, das als anonymes Fenster fungiert.
  • Wählen Sie ‚Log category‘ als ‚Apex Code‘ und ‚Log Level‘ als ‚Debug‘.
  • Klicken Sie auf die Schaltfläche ‚Ausführen‘, um die Ergebnisse der Apex-Ausführung im selben Fenster anzuzeigen.

2.2.2 Bulk-API-Jobstatus

  • Der Bulk-API-Jobstatus wird verwendet, um den ‚Asynchronen Datenladestatus und die Ergebnisse‘ anzuzeigen
  • Navigieren Sie zu Dienstprogramme à Bulk-API-Jobstatus.
  • Geben Sie die ‚Job-ID‘ in das dafür vorgesehene Textfeld ein.
  • Klicken Sie auf die Schaltfläche ‚Status abrufen‘, um den Status der Massendatenjobs abzurufen und im selben Fenster anzuzeigen.
  1. Migration über Workbench

Die Migration in Workbench hilft dem Benutzer, die Metadatenkomponenten, die zur Strukturierung der Organisation beitragen, wie benutzerdefinierte Anwendungen, Objekte und andere Komponenten, abzurufen und bereitzustellen.

3.1 Abrufen von

Zum Abrufen von Metadatenkomponenten aus der Organisation,

  • Bereiten Sie eine XML-Datei mit Standards und Typen vor, die mit der API-Version für die Anforderung definiert sind.

  • Navigieren Sie zu Migration à Abrufen
  • Wählen Sie im Abschnitt Entpacktes Manifest die erstellte Paket-XML-Datei aus, um die Komponentenattribute abzurufen.
  • Geben Sie optional die ‚Paketnamen‘ ein, aktivieren Sie das Kontrollkästchen ‚Einzelnes Paket‘ und klicken Sie auf Weiter.
  • Klicken Sie nach erfolgreichem Hochladen der XML-Datei auf ‚Abrufen‘
  • Klicken Sie auf ‚ZIP-Datei herunterladen‘, um die bereitgestellten Metadatenkomponenten aus der Organisation anzuzeigen.

3.2 Bereitstellen von

Zum Bereitstellen der Metadatenkomponenten für die Organisation,

  • Erstellen Sie einen Ordner mit ‚Package XML‘ im Stammverzeichnis und einen Unterordner mit dem Komponentennamen. ZIP den Ordner.
  • Navigieren Sie zu Migration à Bereitstellen
  • Wählen Sie im Abschnitt Auswählen den Ordner mit dem Paket aus XML zum Bereitstellen der Metadatenkomponenten.
  • Aktivieren Sie optional die folgenden Kontrollkästchen und klicken Sie auf Weiter.
  • Nach erfolgreichem Upload, klicken Sie auf die ‚Bereitstellen‘
  • Bestätigen Sie die Ergebnisse erfolgreich bereitstellen, wenn nicht die Dateien auf Fehler überprüfen.

4.Unterschied zwischen Developer Console und Workbench

Salesforce Object Query Language (SOQL) und Salesforce Object Search Language (SOSL) Abfragen können sowohl in der Developer Console als auch in der Workbench ausgeführt werden.

Der Hauptunterschied zwischen Developer Console und Workbench ist die Benutzeroberfläche. Workbench bietet Benutzern eine erweiterte Benutzeroberfläche zum Abfragen der Datensätze.

  • Die SOQL-Abfragen können einfach durch Auswahl der Dropdown-Listen ‚Objekt‘ und ‚Felder‘ erstellt werden.

  • Abfragen können mithilfe der Dropdown-Listen ‚Ergebnisse sortieren nach‘ und ‚Ergebnisse filtern nach‘ gefiltert werden.

  • In Workbench können die Abfrageergebnisse wie folgt angezeigt werden,
  1. Liste
  2. Matrix
  3. Massen-CSV
  4. Massen-XML

  • Die gelöschten und archivierten Datensätze können entweder ausgeschlossen oder eingeschlossen werden.

  • Die Ergebnisse der SOQL-Abfrage können über die Option ‚Bulk CSV‘ exportiert werden, um die Daten für die zukünftige Verwendung zu analysieren.
  • Die SOSL-Abfragen können durch Angabe der Optionen ‚Suchen nach‘ und ‚Objekt zurückgeben‘ erstellt werden.
  • Die Ergebnisse der SOSL-Abfragen werden im Listenformat angezeigt, in dem die IDs angegeben sind. Bewegen Sie den Mauszeiger über die IDs, um Aktionen wie,
  1. Aktualisieren
  2. Löschen
  3. Wiederherstellen
  4. Bereinigen
  5. Ansicht in Salesforce

5.Szenarien zur Beschreibung der Workbench-Funktionen

Szenario 1

Ein Benutzer wird aufgefordert, die Anzahl der Metadatenkomponenten in einer Salesforce-Organisation zu ermitteln.

Um dies mit Workbench zu erreichen,

  • Navigieren Sie zur Registerkarte Info à Metadatentypen & Komponenten.
  • Wählen Sie Metadaten aus der Dropdown-Liste aus.
  • Nach der Auswahl beschreibt Workbench die ‚Gesamtzahl der Komponenten‘, die in den jeweiligen Metadaten vorhanden sind, und zeigt sie an.

Szenario 2

Exportieren Sie Daten für die Benutzer, die Berechtigungssätzen zugewiesen sind.

Um dieses Szenario mit Workbench zu erreichen,

  • Navigieren Sie zu Abfragen à SOQL-Abfrage
  • Wählen Sie ‚PermissionSetAssignment‘ im Dropdown-Menü Objekt und die erforderlichen Felder aus.
  • Wählen Sie ‚Bulk CSV‘ in Ansicht als Option und klicken Sie auf Abfrage.
  • Dies führt den Benutzer zu einem nächsten Bildschirm, auf dem die Job-ID und der Status des Jobs angezeigt werden.
  • Klicken Sie auf die Schaltfläche Herunterladen, um die SOQL-Abfrage in eine CSV-Datei zu exportieren.

Szenario 3

Ein Benutzer konnte sich nicht anmelden und erhielt beim Zurücksetzen des Kennworts keine E-Mail zum Zurücksetzen des Kennworts.

Um dies mit Workbench zu erreichen,

  • Navigieren Sie zu Dienstprogramme à Passwortverwaltung
  • Klicken Sie auf die Option ‚Zurücksetzen‘ und geben Sie die Benutzer-ID ein.
  • Klicken Sie auf die Schaltfläche ‚Passwort ändern‘, um das Passwort zurückzusetzen.
  • Klicken Sie auf die Option ‚Set‘ und geben Sie die Benutzer-ID ein.
  • Geben Sie die Werte für die Felder ‚Passwort‘ und ‚Passwort bestätigen‘ ein.
  • Klicken Sie auf ‚Passwort ändern‘, um das Passwort für den Benutzer zu ändern.

Vorteile von Workbench

  • Es gibt uns Zugriff auf Daten und strukturelle Informationen von allen Objekten im System.
  • Für eingefrorene oder gesperrte Benutzer helfen SOQL-Abfragen in Workbench beim Anzeigen der Daten.
  • Mac-Benutzer können es ohne zusätzliche Software verwenden.

Nachteile der Workbench

  • Workbench kann Datenladezuordnungen nicht speichern und wiederverwenden, wie dies mit dem Data Loader möglich ist.
  • Workbench kann keine Befehlszeilen- oder geplanten Aktionen ausführen, wie bei data Loader.