Salesforce Abfrage im Jitterbit Design Studio

Erstellen einer Salesforce - Abfrage

Auf dieser Seite wird beschrieben, wie Sie mit dem Jitterbit Connect Salesforce-Abfrageassistenten eine Salesforce Operation erstellen.

Starten des Assistenten

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

  

• Um den Assistenten zu starten, klicken Sie im Menü des Jitterbit Connect-Assistenten auf die Schaltfläche Salesforce-Abfrage, wodurch der Assistent geöffnet wird.

Salesforce Anmeldung

• Wenn Sie bereits eine Salesforce Organisation erstellt haben-Anmeldung werden die Verbindungsdetails im Abfrageassistenten angezeigt. Sie können auf die Schaltfläche Salesforce-Anmeldung testen 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 Salesforce-Organisation auswählen oder erstellen.

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

• Klicken Sie auf dem Salesforce Anmeldebildschirm auf Weiter, um zum nächsten Bildschirm zu gelangen. (Bei Bedarf können Sie auf jedem dieser Bildschirme auf die Schaltfläche Zurück klicken, um zum vorherigen Bildschirm zurückzukehren.)

Wählen Sie das Salesforce-Objekt

• Geben Sie auf dem Objekt-Bildschirm das Salesforce Objekt an, das für den Operation verwendet wird.

• Vereinfachen Sie Ihre Ansicht, indem Sie die ersten Buchstaben eines Objektnamens in das Texteingabefeld Filter eingeben, oder klicken Sie auf das Dropdown-Menü Anzuzeigende Objekte und wählen Sie entweder Standardmäßige allgemeine Objekte, Alle benutzerdefinierten Objekte oder Alle Objekte aus.

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

  

• Klicken Sie auf Weiter, um zum Quelle-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 Referenzen in einer einzigen Tabelle) verwenden Sie den Bereich Einfache Abfrage auf der linken Seite und markieren Sie die Elemente, die in Ihre Abfrage aufgenommen werden sollen. Dabei werden sie der Abfragezeichenfolge im rechten Bereich hinzugefügt. Mithilfe des Texteingabefelds Filter sowie der Schaltflächen Alles auswählen und Alles entfernen können Sie jedes Feld schnell angeben.

• Für eine Abfrage (die Verweise auf andere Tabellen enthält, entweder übergeordnete oder untergeordnete Tabellen des aktuellen Objekts), klicken Sie links auf die Tab Beziehungsabfrage. Unten im linken Bereich werden Listen für übergeordnete und untergeordnete Beziehungen angezeigt:

  

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

  

• Aktivieren Sie ein Kontrollkästchen in der untergeordneten Tabelle, um es Ihrer Abfrage hinzuzufügen. Auch hier können Sie das Texteingabefeld Filter verwenden, um gewünschte Elemente schnell zu finden.

• Um zu einer früheren Tabelle zurückzukehren (z. B. Account, wie im obigen Beispiel gezeigt), klicken Sie in der Breadcrumb-Navigation des Assistenten auf den Tabellennamen.

• Sie können der Abfrage Bedingungen hinzufügen, indem Sie die Steuerelemente Feld, Operator und Wert unter Bedingungen verwenden, z. B. AccountSource = 'SF'. Wenn Sie die Einträge in diesen Steuerelementen abgeschlossen haben, klicken Sie auf Bedingung hinzufügen und die Bedingung wird der Abfrage hinzugefügt:

  

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

• Klicken Sie nach Abschluss der Abfrage auf Weiter, um zum Ziel-Bildschirm zu gelangen.

Definieren Sie das Ziel

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

Das Ziel ist das Ziel der aus der Salesforce Abfrage abgerufenen Daten. Wählen Sie eine der folgenden Optionen aus:

• Ein vorhandener Zieltyp aus dem Dropdown-Menü, z. B. Lokale Datei, FTP Site, 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 aktuell ausgewählten Typs zu erstellen.

Einzelheiten zu den verschiedenen Zielen finden Sie in der Dokumentation zu Zielen.

Lokale Dateiziele

Im Fall eines Standortdateiziels können Sie direkt einen Dateinamen angeben, in dem die Daten gespeichert werden sollen.

• Eine lokale Datei als Ziel angeben und ihren Standort angeben:

  

• Wenn Sie auf Weiter klicken, gelangen Sie zum Bildschirm Dateiformat auswählen, wo Sie angeben können, ob ein Dateiformat basierend auf den Feldern in der Abfrage erstellt werden soll (optional mit den Feldnamen als erste Zeile der Datei), ob ein vorhandenes Dateiformat ausgewählt oder ein neues Dateiformat erstellt werden soll:

  

• Eine lokale Datei als Ziel angeben und die Verwendung eines vorhandenen lokalen Dateiziels auswählen:

  

• Wenn 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 Zieldateiformat angeben. Wenn Sie ein Datenbankziel statt eines Dateiziels ausgewählt haben, lesen Sie Verwenden einer Datenbank als Ziel.

  

• Wählen Sie eine Optionsschaltfläche aus, 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.

• Klicken Sie auf Weiter.

Zeitplan und Optionen

• Das Erstellen oder Festlegen eines Zeitplans ist optional und kann zu einem späteren Zeitpunkt erfolgen. Weitere Einzelheiten zur Planung finden Sie unter Zeitplan erstellen.
• Sie können einen vorhandenen Zeitplan bearbeiten, indem Sie ihn im Ordner „Zeitpläne“ des Projektelemente-Bedienfelds öffnen und die gewünschten Anpassungen vornehmen.
• Über diesen Assistentenbildschirm können Sie entweder einer ungeplanten Operation eine Planung hinzufügen oder die Operation im Projektelementfenster öffnen und die entsprechenden Anpassungen vornehmen.
• Legen Sie das Vorkommen, die Tägliche Häufigkeit (Stunden oder Minuten) und die Dauer des Operation fest.
• Beachten Sie beim Festlegen der Dauer, dass die Daten Beginn um und Ende um in einem Zeitplan inklusiv sind.
• Um diese Optionen anzuzeigen, öffnen Sie die Dreiecke neben Vorkommen, Tägliche Häufigkeit und Dauer.

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

Übersichtsbildschirm

In der Zusammenfassung können Sie den dem Assistenten zugewiesenen Namen bearbeiten und angeben, ob der Automapper des Assistenten zum Zuordnen der Daten verwendet werden soll:

• Klicken Sie auf Fertig, um den Assistenten abzuschließen.
• Wenn Sie eine Transformation erstellen oder genehmigen müssen, werden Sie zu diesem Bildschirm weitergeleitet.
• Andernfalls werden die Designelemente für Ihren Operation erstellt und im Bereich „Projektelemente“ auf der linken Seite des Bildschirms angezeigt. Außerdem werden Sie zur Salesforce Abfrageseite des Vorgangs weitergeleitet.

Transformation

Wenn Sie im Zielbildschirm des Assistenten Vorhandenes Dateiformat auswählen gewählt haben (oder ein neues erstellt haben), wird die Transformation in Ihrem Arbeitsbereich angezeigt:

• Wenn Sie das Kontrollkästchen Automapper verwenden aktiviert haben, kann die Feldzuordnung größtenteils oder vollständig abgeschlossen werden. Führen Sie ggf. die manuelle Zuordnung durch.
• Eine Zuordnung wird als Linie zwischen 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 die Gültigkeit einer Zuordnung fraglich ist. Der Operation versucht jedoch die Transformation mit dieser Zuordnung.
• Sie können die Zuordnung auf der Tab „Transformation“ abschließen, indem Sie sie von der Quelle links auf das Ziel rechts ziehen und dort ablegen. Wenn Sie dies tun und eine gültige Zuordnung das Ergebnis ist, wird links neben den Quell- und Zielelementen ein blaues Quadrat angezeigt.
• Um Ihre Transformation zu speichern, klicken Sie auf den Abwärtspfeil in der Statusleiste und wählen Sie Speichern.

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

Abgeschlossene Salesforce Abfrage

• Sobald Sie fertig sind, werden Sie zum Übersichtsbildschirm für die neue Salesforce Abfrage weitergeleitet.
• Sie können zu dieser Übersichtsseite zurückkehren, indem Sie im Bereich „Projektelemente“ unter „Jitterbit Connect“ nach dem Operation suchen.
• Sie können alle Designelemente in Ihrem Projekt wie Salesforce-Anmeldung, Salesforce Abfrage, Zuordnungen, Daten schreiben in, Vorgang und Nach Zeitplan ausführen ändern, indem Sie auf die nebenstehende Schaltfläche Bearbeiten klicken.
• Die Schaltflächenfunktionen Abfrage ausführen, Abfrage testen und Löschen werden weiter unten unter Projekt bereitstellen und Operation ausführen beschrieben.
• Erweiterte Optionen umfassen Operation wie chunking und Feldkürzung. Sie werden weiter unten in Erweiterte Optionen behandelt.

Erweiterte Optionen

Diese erweiterten Optionen sind für eine Salesforce Abfrage verfügbar:

Dateioptionen

• Als UTF-8 schreiben: Wählen Sie diese Option aus, um die Zieldatei mit der Zeichenkodierung UTF-8 zu schreiben.
• Header: Wählen Sie zwischen Keine Header, Salesforce-Feldnamen oder Dateiformat-Feldnamen.**

Operationsoptionen

• Gelöschte Zeilen einschließen: Wählen Sie diese Option aus, um gelöschte Zeilen in die Ausgabe der Abfrage einzuschließen.
• Batchgröße: Standardmäßig ist diese auf 2000 Datensätze eingestellt.
• Wiederholungsrichtlinie: Zeigt einen Dialog zum Festlegen der Wiederholungsrichtlinien an. Weitere Informationen finden Sie unter Salesforce erweitert Seite.
• Chunking: Standardmäßig ist chunking für Salesforce-Abfragen nicht aktiviert. Es kann in den Operationsoptionen aktiviert werden, wie unter Salesforce erweitert beschrieben Seite.

Weitere Operation zum chunking und zum Schreiben von Erfolgs- und Fehlerprotokollen werden auf der Seite Salesforce Advanced beschrieben Seite.

Bereitstellen des Projekts und Ausführen des Operation

Bereitstellen des Projekts

Das Bereitstellen eines Projekts vor der Ausführung ist nicht erforderlich, da es bei Bedarf automatisch bereitgestellt wird.

So stellen Sie das Projekt einsetzen:

• Klicken Sie in der Symbolleiste auf das Symbol Bereitstellen. oder

• Klicken Sie im Fenster „Projektelemente“ mit der rechten Maustaste auf den Namen des soeben erstellten Projekts und klicken Sie dann im angezeigten Dropdown-Menü mit der linken Maustaste auf Bereitstellen. oder

• Klicken Sie mit der rechten Maustaste auf **Operationen oben im Bedienfeld „Projektelemente“ und klicken Sie dann im angezeigten Dropdown-Menü mit der linken Maustaste auf Bereitstellen.

Der einsetzen beginnt mit dem Senden des Projekts an Harmony und eine Fortschrittsmeldung wird angezeigt.

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

• Um den einsetzen abzubrechen, klicken Sie auf Abbrechen. Dadurch gelangen Sie zum vorherigen Bildschirm zurück.

Der Operation ist nun abgeschlossen und bereitgestellt.

Ausführen des Operation

Dieses Bild zeigt die Schaltflächen, die auf den Übersichtsseiten des Salesforce Assistenten verfügbar sind. Die Beschriftungen (wie Abfrage ausführen oder Einfügen ausführen) variieren je nach verwendetem Assistenten. Die Schaltfläche Ergebnisverlauf ist auf der Übersichtsseite Salesforce-Abfragen nicht verfügbar und die Schaltfläche Test… ist auf der Übersichtsseite Salesforce-Massenprozesse nicht verfügbar.

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

  • Wenn das Projekt noch nicht bereitgestellt wurde oder seit der letzten einsetzen geändert wurde, wird es automatisch bereitgestellt. Siehe Operation erstellen für weitere Informationen zum Erstellen, Bereitstellen und Ausführen von Vorgängen.

  • Der Vorgangsmonitor zeigt unten auf dem Bildschirm den Status, die Empfangszeit, die Startzeit und die Zeit an, zu der die Operation abgeschlossen wurde.

  • Wenn die Verarbeitung des Operation abgeschlossen ist, zeigt das Popup-Fenster Ergebnis den Zeitpunkt der Fertigstellung, den Status, die Anzahl der erfolgreich verarbeiteten Datensätze und die Anzahl der Datensätze an, deren Verarbeitung fehlgeschlagen ist. Die Schaltflächen Erfolgsdatei anzeigen und Fehlerdatei anzeigen werden unten beschrieben.

  • Drücken Sie die Schaltfläche Test…, um den Operation zu testen. Diese Option ist nur zum Testen des Operation in einer Umfeld gedacht, die mit einer Salesforce Sandbox verbunden ist, und sollte nicht in einer Umfeld verwendet werden. Wenn Sie beispielsweise auf der Übersichtsseite Salesforce Inserts die Option Test Insert auswählen, werden die ersten 200 Datensätze verarbeitet und in die Salesforce Sandbox eingefügt. Hinweis: Die Schaltfläche Test… ist auf der Übersichtsseite Salesforce Bulk Processes nicht verfügbar.
  • Klicken Sie auf die Schaltfläche Ergebnisverlauf, um eine Popup-Liste der letzten Aktivitäten anzuzeigen, einschließlich der abgeschlossenen Zeit, des Status, der Anzahl der erfolgreich verarbeiteten Datensätze und der Anzahl der Datensätze, deren Verarbeitung fehlgeschlagen ist. Wählen Sie ein Ergebnis in der Liste aus, um die Schaltflächen Erfolgsdatei anzeigen und Fehlerdatei anzeigen zu aktivieren, die unten beschrieben werden. Hinweis: Die Schaltfläche Ergebnisverlauf ist auf der Übersichtsseite Salesforce-Abfragen nicht verfügbar.
  • Drücken Sie die Schaltfläche Löschen, um den Operation aus dem Projekt zu löschen.
  • Das Popup-Fenster Löschen bestätigen wird angezeigt. Klicken Sie auf Löschen, um den Operation zu bestätigen und zu löschen.
  • Das Popup Assistentenelemente löschen? zeigt die zugehörigen Operation an.
    • Wählen Sie Ja, um zusätzlich zum Operation die zugehörigen Assistentenobjekte zu löschen.
    • Wenn Sie Nein auswählen, bleiben die Assistentenobjekte im Projekt verfügbar. HINWEIS: Nur der Operation wird gelöscht.
    • Durch Auswahl von Abbrechen wird das Löschen des Operation und der zugehörigen Assistentenobjekte abgebrochen.

Siehe Eine Operation erstellen für weitere Informationen zum Erstellen, Bereitstellen und Ausführen von Vorgängen.

Anzeigen von Erfolgs- und Fehlerdateien

Die Anzeige von Erfolgs- und Fehlerdateien ist möglich, wenn Sie Vorgänge auf einem privaten Agenten ausführen. Die Schaltflächen Erfolgsdatei anzeigen und Fehlerdatei anzeigen sind verfügbar, nachdem Sie wie oben beschrieben auf die Schaltfläche Ausführen... oder die Schaltfläche Ergebnisverlauf geklickt und dann eines der Ergebnisse ausgewählt haben. Dies ist ein Beispiel für das Popup-Fenster Ergebnisverlauf, das die Schaltflächen und ein ausgewähltes Ergebnis anzeigt:

• Erfolgsdatei anzeigen: Wenn Sie den Operation auf einem privaten Agenten ausführen, werden durch Auswahl der Schaltfläche Erfolgsdatei anzeigen die ersten 100 Datensätze, die erfolgreich verarbeitet wurden, in einem Popup-Fenster angezeigt.

• Fehlerdatei anzeigen: Wenn Sie den Operation auf einem privaten Agenten ausführen, wenn Sie die Schaltfläche Fehlerdatei anzeigen auswählen, werden die ersten 100 Datensätze, deren Verarbeitung fehlgeschlagen ist, in einem Popup-Fenster angezeigt.

• In diesem Beispiel werden drei Datensätze angezeigt:

  

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

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