Salesforce-Abfrage-Assistent im Jitterbit Design Studio

Erstellen einer Salesforce-Abfrageoperation

Diese Seite beschreibt, wie man eine Salesforce-Abfrageoperation mit dem Jitterbit Connect Salesforce Query Wizard erstellt.

Assistenten starten

• Klicken Sie auf das Symbol oben auf dem Bildschirm, um das Jitterbit Connect-Dialogfenster anzuzeigen:

  

• Um den Assistenten zu starten, klicken Sie auf die Schaltfläche Salesforce Query im Menü des Jitterbit Connect Wizards, um den Assistenten zu öffnen.

Salesforce-Anmeldung

• Wenn Sie bereits eine Salesforce-Org Anmeldung erstellt haben, werden die Verbindungsdetails im Abfrage-Assistenten angezeigt. Sie möchten möglicherweise auf die Schaltfläche Test Salesforce Login klicken, um die Verbindung zu überprüfen.

  

• Wenn Sie noch keine Salesforce-Anmeldung erstellt haben oder andere Anmeldeinformationen verwenden müssen, wählen Sie Neu erstellen… aus dem Dropdown-Menü unter Wählen oder erstellen Sie eine Salesforce-Org.

• Beachten Sie, dass alle Änderungen, die Sie auf dieser Seite des Assistenten vornehmen, automatisch in der auf der Seite angezeigten Salesforce-Org gespeichert werden. Weitere Einzelheiten finden Sie auf der Seite Salesforce-Org.

• Auf dem Salesforce-Anmeldebildschirm klicken Sie auf Weiter, um zum nächsten Bildschirm zu gelangen. (Falls erforderlich, können Sie die Zurück-Schaltfläche klicken, um zu einem vorherigen Bildschirm zurückzukehren.)

Wählen Sie das Salesforce-Objekt

• Auf dem Objekt-Bildschirm geben Sie das Salesforce-Objekt an, das die Operation verwenden wird.

• Vereinfachen Sie Ihre Ansicht, indem Sie die ersten Buchstaben des Namens eines Objekts in das Textfeld Filter eingeben, oder klicken Sie auf das Dropdown-Menü Anzuzeigende Objekte und wählen Sie entweder Standardgemeinsame Objekte, Alle benutzerdefinierten Objekte oder Alle Objekte aus.

• Wählen Sie das gewünschte Salesforce-Objekt aus. In diesem Beispiel wurde acc in das Filter-Feld eingegeben und Account ausgewählt.

  

• Klicken Sie auf Weiter, um zum Quell-Bildschirm zu gelangen.

Erstellen Sie Ihre Salesforce-Abfrage

• Auf diesem Bildschirm beginnen Sie mit dem Erstellen der Abfrage. Sie können entweder eine Einfache oder eine Beziehungsabfrage erstellen:

  

• Für eine einfache Abfrage (alle Verweise in einer einzelnen Tabelle) verwenden Sie das Einfache Abfrage-Fenster auf der linken Seite und aktivieren die Elemente, die in Ihre Abfrage aufgenommen werden sollen. Während Sie dies tun, werden sie im Abfrage-String im rechten Fenster hinzugefügt. Mit dem Textfeld Filter, der Schaltfläche Alle auswählen und der Schaltfläche Alle entfernen können Sie schnell jedes Feld angeben.

• Für eine Beziehungsabfrage (die Verweise auf andere Tabellen enthält, entweder Eltern oder Kinder des aktuellen Objekts) klicken Sie auf die Registerkarte Beziehungsabfrage auf der linken Seite. Listen für Eltern- und Kind-Beziehungen erscheinen am unteren Ende des linken Fensters:

  

• Wählen Sie ein Objekt aus der Liste Kindbeziehungen aus und doppelklicken Sie darauf, um seine Felder im Objekt anzuzeigen. Sie können diese hinzufügen, wie in diesem Beispiel gezeigt, in dem Felder von Kontakten hinzugefügt wurden (Nachname, Abteilung, Email usw.):

  

• Überprüfen Sie ein Feld in der Kindtabelle, um es zu Ihrer Abfragezeichenfolge hinzuzufügen. Sie können erneut das Textfeld Filter verwenden, um schnell die gewünschten Elemente zu finden.

• Um zu einer früheren Tabelle zurückzukehren (wie Account, wie im obigen Beispiel gezeigt), klicken Sie auf den Tabellennamen im Breadcrumbs des Wizards.

• Sie können Bedingungen zur Abfrage hinzufügen, indem Sie die Steuerelemente Feld, Operator und Wert unter Bedingungen verwenden; zum Beispiel AccountSource = 'SF'. Wenn Sie die Eingaben in diesen Steuerelementen abgeschlossen haben, klicken Sie auf Bedingung hinzufügen, und die Bedingung wird zur Abfragezeichenfolge hinzugefügt:

  

• Sie können auf die Schaltfläche Abfrage testen unten rechts klicken, um die Abfrage zu validieren.

• Nachdem Sie die Abfrage abgeschlossen haben, klicken Sie auf Weiter, um zum Bildschirm Ziel zu gelangen.

Ziel definieren

Wählen Sie aus, wo Sie Ihre Daten speichern möchten

Das Ziel ist der Speicherort der aus der Salesforce-Abfrage abgerufenen Daten. Wählen Sie eines aus:

• Einen vorhandenen Zieltyp aus dem Dropdown-Menü, wie Lokale Datei, FTP-Standort, Dateifreigabe, Temporärer Speicher, Datenbank, HTTP oder LDAP
• Klicken Sie auf die Schaltfläche Auswählen oder Neu erstellen, um entweder ein vorhandenes Ziel auszuwählen oder ein neues Ziel des derzeit ausgewählten Typs zu erstellen.

Für Details zu den verschiedenen Zielen siehe die Dokumentation zu Zielen.

Lokale Dateiziele

Im Fall eines Standort-Dateiziels können Sie direkt einen Dateinamen angeben, wo Sie die Daten speichern möchten.

• Angabe einer lokalen Datei als Ziel und Angabe ihres Speicherorts:

  

• Durch Klicken auf Weiter gelangen Sie zum Bildschirm Dateiformat auswählen, wo Sie entweder angeben, ein Dateiformat basierend auf den Feldern in der Abfrage zu erstellen (optional mit den Feldnamen in der ersten Zeile der Datei), ein vorhandenes Dateiformat auszuwählen oder ein neues Dateiformat zu erstellen:

  

• Einen lokalen Datei als Ziel angeben und die Verwendung eines vorhandenen lokalen Datei-Ziels auswählen:

  

• Nachdem Sie Ihre Eingaben für das Ziel abgeschlossen haben, klicken Sie auf Weiter, um zum nächsten Bildschirm zu gelangen.

Wählen Sie ein Dateiformat

• Nachdem Sie das Ziel angegeben haben, müssen Sie das Ziel-Dateiformat festlegen. Wenn Sie ein Datenbankziel anstelle eines Dateiziels ausgewählt haben, siehe Verwendung einer Datenbank als Ziel.

  

• Wählen Sie eine Radio-Schaltfläche, um entweder ein Dateiformat aus den Feldern Ihrer Abfrage zu erstellen, ein vorhandenes Dateiformat auszuwählen oder ein neues Dateiformat zu erstellen.

• Wenn Sie entweder ein vorhandenes Dateiformat verwenden oder ein neues erstellen, werden Sie am Ende des Assistenten aufgefordert, im Dropdown-Menü Auswählen oder Neu erstellen auszuwählen.

• Klicken Sie auf Weiter.

Zeitplan und Optionen

• Einen Zeitplan zu erstellen oder festzulegen ist optional und kann zu einem späteren Zeitpunkt erfolgen. Für weitere Details zur Planung siehe Einen Zeitplan erstellen.
• Sie können einen vorhandenen Zeitplan bearbeiten, indem Sie ihn im Ordner "Zeitpläne" im Projekt-Elemente-Panel öffnen und die gewünschten Anpassungen vornehmen.
• Sie können diesen Assistentenbildschirm verwenden, um entweder einen Zeitplan zu einer nicht geplanten Operation hinzuzufügen oder die Operation im Projekt-Elemente-Panel zu öffnen und die entsprechenden Anpassungen vorzunehmen.
• Legen Sie die Häufigkeit, tägliche Frequenz (Stunden oder Minuten) und Dauer der Operation fest.
• Beim Festlegen der Dauer beachten Sie, dass die Start- und Enddaten in einem Zeitplan einschließlich sind.
• Um diese Optionen anzuzeigen, öffnen Sie die Pfeile neben Häufigkeit, tägliche Frequenz und Dauer.

• Wenn Sie fertig sind, klicken Sie auf Weiter, um zum Zusammenfassungs-Bildschirm zu gelangen.

Zusammenfassungsbildschirm

Auf der Zusammenfassung können Sie den Namen ändern, der dem Assistenten gegeben wurde, und angeben, ob der Automapper des Assistenten zur Zuordnung der Daten verwendet werden soll:

• Klicken Sie auf Fertigstellen, um den Assistenten abzuschließen.
• Wenn Sie eine Transformationszuordnung erstellen oder genehmigen müssen, werden Sie zu diesem Bildschirm weitergeleitet.
• Andernfalls werden die Designelemente für Ihre Operation erstellt und im Projekt-Elemente-Bereich auf der linken Seite des Bildschirms sichtbar, und Sie werden zur Salesforce-Abfrage-Seite der Operation weitergeleitet.

Transformationszuordnung

Wenn Sie im Zielbildschirm des Assistenten Ein vorhandenes Dateiformat auswählen (oder ein neues erstellt) haben, erscheint die Transformationszuordnung in Ihrem Arbeitsbereich:

• Wenn Sie das Kontrollkästchen Automapper verwenden angegeben haben, kann die meisten oder alle Feldzuordnungen abgeschlossen sein. Vervollständigen Sie alle manuellen Zuordnungen nach Bedarf.
• Eine Zuordnung wird als Linie zwischen den Elementen in den Spalten Quelle (links) und Ziel (rechts) angezeigt.
• Eine grüne Linie zeigt eine gültige Zuordnung an und wird zusätzlich durch das Vorhandensein eines blauen Quadrats neben jedem gültig zugeordneten Elementnamen angezeigt.
• Eine rote Linie zeigt eine ungültige Zuordnung an.
• Eine gelbe Linie zeigt an, dass eine Zuordnung fraglicher Gültigkeit ist; die Operation wird jedoch versuchen, die Transformation mit dieser Zuordnung durchzuführen.
• Sie können die Zuordnung auf der Registerkarte Transformation abschließen, indem Sie von der Quelle auf der linken Seite zur Zielseite auf der rechten Seite ziehen und ablegen. Wenn Sie dies tun und eine gültige Zuordnung das Ergebnis ist, erscheint ein blaues Quadrat links von beiden, den Quell- und Ziel-Elementen.
• Um Ihre Transformation zu speichern, klicken Sie auf den nach unten zeigenden Pfeil in der Statusleiste und wählen Sie Speichern.

Vervollständigen Sie die Zuordnung nach Bedarf und klicken Sie auf Fertigstellen, um den Assistenten und die Erstellung der Designelemente abzuschließen.

Abgeschlossene Salesforce-Abfrage

• Nach Abschluss werden Sie zum Zusammenfassungsbildschirm für die neue Salesforce-Abfrage weitergeleitet.
• Sie können zu dieser Zusammenfassungsseite zurückkehren, indem Sie den Operationsnamen unter Jitterbit Connect im Projektobjekte-Panel finden.
• Sie können beliebige Designelemente in Ihrem Projekt wie Salesforce-Anmeldung, Salesforce-Abfrage, Mappings, Daten schreiben an, Operation und Geplant ausführen ändern, indem Sie auf die danebenstehende Bearbeiten-Schaltfläche klicken.
• Die Funktionen der Schaltflächen Abfrage ausführen, Abfrage testen und Löschen werden weiter unten in Projekt bereitstellen und Operation ausführen beschrieben.
• Erweiterte Optionen umfassen Betriebsoptionen wie Chunking und Feldtrunkierung. Diese werden weiter unten in Erweiterte Optionen behandelt.

Erweiterte Optionen

Diese erweiterten Optionen stehen für eine Salesforce-Abfrage zur Verfügung:

Dateioptionen

• Als UTF-8 schreiben: Wählen Sie diese Option, um die Zieldatei als UTF-8-Zeichencodierung zu schreiben.
• Zielheader: Wählen Sie aus Kein Header, Salesforce-Feldnamen oder Dateiformat-Feldnamen.

Betriebsoptionen

• Gelöschte Zeilen einbeziehen: Wählen Sie diese Option, um gelöschte Zeilen in die Ausgabe der Abfrage einzuschließen.
• Batch-Größe: Standardmäßig ist dies auf 2000 Datensätze eingestellt.
• Wiederholungsrichtlinie: Zeigt einen Dialog an, um die Wiederholungsrichtlinien festzulegen. Siehe die Seite Salesforce advanced.
• Chunking: Standardmäßig ist Chunking für Salesforce-Abfragen nicht aktiviert. Es kann in den Betriebsoptionen aktiviert werden, wie auf der Seite Salesforce advanced beschrieben.

Zusätzliche Betriebsoptionen für Chunking sowie das Schreiben von Erfolgs- und Fehlermeldungen werden auf der Seite Salesforce advanced beschrieben.

Projekt bereitstellen und die Operation ausführen

Projekt bereitstellen

Es ist nicht erforderlich, ein Projekt vor der Ausführung bereitzustellen, da es automatisch bereitgestellt wird, falls erforderlich.

Um das Projekt bereitzustellen, entweder:

• Klicken Sie auf das Bereitstellen-Symbol in der Symbolleiste; oder

• Klicken Sie im Projektobjekte-Bereich mit der rechten Maustaste auf den Namen des gerade erstellten Projekts und klicken Sie dann mit der linken Maustaste auf Bereitstellen im sich öffnenden Dropdown-Menü; oder

• Klicken Sie mit der Rechten Maustaste auf Operationen oben im Projektobjekte-Bereich und klicken Sie dann mit der linken Maustaste auf Bereitstellen im sich öffnenden Dropdown-Menü.

Der Bereitstellungsprozess des Projekts beginnt, das Projekt an Harmony zu senden, und eine Fortschrittsnachricht erscheint.

• Um die Fortschrittsnachricht im Hintergrund auszuführen, klicken Sie auf Im Hintergrund ausführen.

• Um den Bereitstellungsprozess abzubrechen, klicken Sie auf Abbrechen, was Sie zum vorherigen Bildschirm zurückbringt.

Die Operation ist nun abgeschlossen und bereitgestellt.

Die Operation ausführen

Dieses Bild zeigt die Schaltflächen, die auf den Zusammenfassungsseiten des Salesforce Wizards verfügbar sind. Die Bezeichnungen (wie Abfrage ausführen oder Einfügen ausführen) variieren je nach Wizard, den Sie verwenden. Die Schaltfläche Ergebnisverlauf ist auf der Zusammenfassungsseite Salesforce-Abfragen nicht verfügbar, und die Schaltfläche Test… ist auf der Zusammenfassungsseite Salesforce-Bulk-Prozesse nicht verfügbar.

• Drücken Sie die entsprechende Schaltfläche Ausführen…, um die Operation in die Warteschlange zur Ausführung zu stellen.

  • Wenn das Projekt noch nicht bereitgestellt wurde oder seit der letzten Bereitstellung geändert wurde, wird es automatisch bereitgestellt. Weitere Informationen zum Erstellen, Bereitstellen und Ausführen von Operationen finden Sie unter Eine Operation erstellen.

  • Der Operationsmonitor wird am unteren Bildschirmrand angezeigt und verfolgt den Status, die Empfangszeit, die Startzeit und die Zeit, zu der die Operation die Verarbeitung abgeschlossen hat.

  • Wenn die Operation die Verarbeitung abgeschlossen hat, zeigt das Popup Ergebnis die Abschlusszeit, den Status, die Anzahl der erfolgreich verarbeiteten Datensätze und die Anzahl der Datensätze, die nicht verarbeitet werden konnten. Die Schaltflächen Erfolgsdatei anzeigen und Fehlerdatei anzeigen werden unten beschrieben.

  • Drücken Sie die Schaltfläche Test…, um die Operation zu testen. Diese Option ist dazu gedacht, die Operation nur in einer Umgebung zu testen, die mit einer Salesforce Sandbox verbunden ist, und sollte nicht in einer Produktionsumgebung verwendet werden. Wenn Sie beispielsweise Test Einfügen auf der Zusammenfassungsseite Salesforce Einfügungen auswählen, werden die ersten 200 Datensätze in die Salesforce Sandbox verarbeitet und eingefügt. Hinweis: Die Schaltfläche Test… ist auf der Zusammenfassungsseite Salesforce-Bulk-Prozesse nicht verfügbar.
  • Drücken Sie die Schaltfläche Ergebnisverlauf, um eine Popup-Liste der letzten Aktivitäten anzuzeigen, einschließlich der Abschlusszeit, des Status, der Anzahl der erfolgreich verarbeiteten Datensätze und der Anzahl der Datensätze, die nicht verarbeitet werden konnten. Wählen Sie ein Ergebnis in der Liste aus, um die Schaltflächen Erfolgsdatei anzeigen und Fehlerdatei anzeigen zu aktivieren, die unten beschrieben sind. Hinweis: Die Schaltfläche Ergebnisverlauf ist auf der Zusammenfassungsseite Salesforce-Abfragen nicht verfügbar.
  • Drücken Sie die Schaltfläche Löschen, um die Operation aus dem Projekt zu löschen.
  • Das Popup-Fenster Löschen bestätigen wird angezeigt. Klicken Sie auf Löschen, um zu bestätigen und die Operation zu löschen.
  • Das Popup Wizard-Elemente löschen? zeigt die zugehörigen Komponenten der Operation an.
    • Wählen Sie Ja, um die zugehörigen Wizard-Objekte zusätzlich zur Einfügeoperation zu löschen.
    • Wenn Sie Nein auswählen, bleiben die Wizard-Objekte im Projekt verfügbar. HINWEIS: Nur die Einfügeoperation wird gelöscht.
    • Wenn Sie Abbrechen auswählen, wird das Löschen der Einfügeoperation und der zugehörigen Wizard-Objekte abgebrochen.

Siehe Erstellen einer Operation für zusätzliche Informationen zum Erstellen, Bereitstellen und Ausführen von Operationen.

Erfolgs- und Fehlermeldungsdateien anzeigen

Das Anzeigen von Erfolgs- und Fehlermeldungsdateien ist verfügbar, wenn Sie Operationen auf einem privaten Agenten ausführen. Die Schaltflächen Erfolgsdatei anzeigen und Fehlermeldungsdatei anzeigen sind verfügbar, nachdem Sie die Schaltfläche Ausführen... oder die Schaltfläche Ergebnisverlauf wie oben beschrieben gedrückt haben und dann eines der Ergebnisse auswählen. Dies ist ein Beispiel für das Popup-Fenster Ergebnisverlauf, das die Schaltflächen und ein ausgewähltes Ergebnis zeigt:

• Erfolgsdatei anzeigen: Wenn Sie die Operation auf einem privaten Agenten ausführen, zeigt das Auswählen der Schaltfläche Erfolgsdatei anzeigen die ersten 100 Datensätze an, die erfolgreich in einem Popup-Fenster verarbeitet wurden.

• Fehlermeldungsdatei anzeigen: Wenn Sie die Operation auf einem privaten Agenten ausführen, zeigt das Auswählen der Schaltfläche Fehlermeldungsdatei anzeigen die ersten 100 Datensätze an, die nicht verarbeitet werden konnten, in einem Popup-Fenster.

• In diesem Beispiel werden drei Datensätze angezeigt:

  

  • Datei kopieren nach...: Diese Schaltfläche speichert die Erfolgs- oder Fehlermeldungsdatensätze in einer CSV-Datei. Der Standarddateiname ist salesforce.csv.

  • Externes Programm öffnen: Diese Option ist derzeit nicht verfügbar.