NetSuite Connector-Suche im Jitterbit Design Studio

Die NetSuite Suchaktivität ist im NetSuite Connector verfügbar ermöglicht Ihnen die Suche nach vorhandenen Datensätzen in einer verbundenen NetSuite Instanz mithilfe von Jitterbit.

Auf dieser Seite wird beschrieben, wie Sie nach vorhandenen NetSuite-Datensätzen suchen. Dabei werden dieselben Beispieldatensätze verwendet, die während der exemplarischen Vorgehensweisen für NetSuite-Connector erstellen erstellt und aktualisiert wurden, NetSuite Konnektor-Update und NetSuite Connector-Upsert.

Die folgenden Abschnitte sind in das Starten der Suchaktivität, das Definieren der Operation und das Bereitstellen und Ausführen der Operation unterteilt. Im Folgenden finden Sie auch spezifische Informationen zu den einzelnen verfügbaren NetSuite-Suchtypen.

Erstellen eines NetSuite Operation

1. Innerhalb Ihres Projekts in Jitterbit Studio gibt es mehrere Möglichkeiten, eine neue NetSuite Suchaktivität zu starten. Jede der folgenden Optionen startet den NetSuite-Suchassistenten, der Sie durch den Vorgang führt.

   • Gehen Sie zu Datei > Neu > Konnektoren > Neue NetSuite Suche.
   • Klicken Sie im Baum links unter Konnektoren mit der rechten Maustaste auf die Kategorie NetSuite und wählen Sie dann Neue NetSuite Suche.
   • Doppelklicken Sie im Baum links unter Connectors auf die Kategorie NetSuite, klicken Sie dann mit der rechten Maustaste auf New NetSuite Search und wählen Sie New NetSuite Search.
   • Klicken Sie in der oberen Symbolleiste auf das Verbindungssymbol (orangefarbenes Puzzleteil) . Wählen Sie im Popup NetSuite und dann NetSuite Search aus.

2. Der Endpoint-Bildschirm des NetSuite-Suchassistenten sollte in der Hauptansicht von Studio geöffnet werden. In diesem Bildschirm werden Sie aufgefordert, den Endpoint auszuwählen, in dem Sie nach vorhandenen Daten suchen möchten. Sie sollten Ihren Endpoint bereits in NetSuite Connector-Endpoint eingerichtet haben. Verwenden Sie das Dropdown-Menü, um den entsprechenden Endpoint auszuwählen. Klicken Sie auf Weiter, wenn Sie fertig sind.

   

3. Auf dem Bildschirm Objekt des NetSuite-Suchassistenten werden Sie aufgefordert, das Objekt auszuwählen, in dem Sie nach vorhandenen Daten suchen möchten. In dieser exemplarischen Vorgehensweise möchten wir in Netsuite nach vorhandenen Kundendatensätzen suchen. Daher wählen wir das Objekt „Kunde“ aus und klicken dann auf Fertig, um fortzufahren.

   Notiz

   Möglicherweise stellen Sie Unterschiede in der Liste der Objekte fest, die während einer NetSuite - Operation angezeigt werden, im Vergleich zu den Objekten, die während der NetSuite Erstellen-Operation verfügbar sind, aktualisieren und upsert Operationen. Dies liegt daran, dass NetSuite den Zugriff zum Hinzufügen oder Ändern von Datensätzen im Gegensatz zum Zugriff zum Suchen von Datensätzen gewährt.

   Notiz

   Wenn in Ihrem NetSuite-Konto viele Objekte verfügbar sind, müssen Sie möglicherweise einen Moment warten, bis sie geladen sind. Sie können auch einen Objektnamen in das Feld Filter eingeben oder das Dropdown-Menü Anzuzeigende Objekte verwenden, um die Ergebnisse auf „Standardobjekte“, „Benutzerdefinierte Objekte“, „Transaktionssuchobjekte“ oder „Artikelsuchobjekte“ zu beschränken. Versuchen Sie es mit der Schaltfläche Aktualisieren, wenn die Ergebnisse nicht Ihren Erwartungen entsprechen.

   

   Notiz

   Wenn Sie innerhalb eines Transaktionsobjekts suchen und nach Status suchen möchten, beachten Sie die speziellen Hinweise unter „NetSuite Transaktionssuche nach Status“ in Erweiterter NetSuite Connector.

4. Der Bildschirm Suchtyp des NetSuite-Suchassistenten fordert Sie auf, den Suchtyp auszuwählen, den Sie durchführen möchten.

   

   In den folgenden Unterabschnitten finden Sie ein Beispiel für die Verwendung jeder dieser Sucharten. - Einfache Suche: Eine einfache Suche beschränkt die Suche auf das Objekt, das Sie im vorherigen Bildschirm ausgewählt haben. Eine einfache Suche gibt immer alle verfügbaren Felder für das ausgewählte Objekt zurück. Beispielsweise Abfrage.

   • Erweiterte Suche: Eine erweiterte Suche umfasst das ausgewählte Objekt sowie alle zugehörigen Objekte in NetSuite. Beispielsweise umfasst eine erweiterte Suche nach dem ausgewählten Objekt „Kunde“ auch zusätzliche zugehörige Objekte in NetSuite wie billingAccountJoin, contactJoin, opportunityJoin, transactionJoin usw.

     Notiz

     Erweiterte Suchen müssen eine Abfrage zu einem verwandten Objekt enthalten, sonst erhalten Sie einen Fehler in Jitterbit. Wenn die abgerufenen Kriterien und Felder sich auf dasselbe Objekt beziehen, verwenden Sie bitte eine einfache Suche.

     Notiz

     Erweiterte und erweiterte Suchvorgänge können für benutzerdefinierte Objekte oder andere Objekte deaktiviert werden, die keine zugehörigen Objekte in NetSuite haben.

   • Erweiterte Suche: Eine erweiterte Suche umfasst das ausgewählte Objekt sowie alle damit verbundenen Objekte und bietet Ihnen im nächsten Bildschirm eine zusätzliche Option zur Auswahl der spezifischen Felder, die Sie Abfrage möchten. Eine erweiterte Suche kann viel schneller sein als eine einfache oder erweiterte Suche, selbst wenn Sie keine verwandten Objekte Abfrage möchten, da Sie die Abfrage auf bestimmte Felder in NetSuite beschränken können.

     Notiz

     Erweiterte und erweiterte Suchvorgänge können für benutzerdefinierte Objekte oder andere Objekte deaktiviert werden, die keine zugehörigen Objekte in NetSuite haben.

     Warnung

     Bei einer erweiterten Suche werden benutzerdefinierte Segmente vom Typ Liste/Datensatz nicht unterstützt. Weitere Informationen finden Sie unter Verwenden benutzerdefinierter NetSuite Segmente in Erweiterter NetSuite Connector.

   • Gespeicherte Suche: Eine gespeicherte Suche ist eine wiederverwendbare Suche, die Sie bereits in NetSuite definiert haben. Anstatt die Suche in Jitterbit zu erstellen, ist die Suche bereits in NetSuite eingerichtet und kann dann in Jitterbit übernommen werden. Weitere Informationen zu gespeicherten NetSuite Suchen finden Sie in der NetSuite Dokumentation unter Verwenden gespeicherter Suchvorgänge.

Einfache Suche

Bei einer einfachen Suche wird die Suche nur auf das Objekt beschränkt, das Sie im vorherigen Bildschirm ausgewählt haben. Bei einer einfachen Suche werden immer alle verfügbaren Felder für das ausgewählte Objekt zurückgegeben.

Das folgende Beispiel zeigt eine einfache Suche nach dem ausgewählten Objekt „Customer“. Die im Beispiel verwendeten Kriterien geben Datensätze mit einem Feld „lastModifiedDate“ nach „yesterday“ zurück, um die Datensätze zurückzugeben, die während der in NetSuite create verwendeten Beispiele geändert wurden, aktualisieren und upsert Operationen.

1. Auf dem Bildschirm Suchtyp des NetSuite-Suchassistenten werden Sie aufgefordert, den Suchtyp auszuwählen, den Sie durchführen möchten. Wählen Sie Einfache Suche und klicken Sie dann auf Weiter, um fortzufahren.

2. Im Bildschirm Abfrage erstellen des NetSuite-Suchassistenten geben Sie die Kriterien für Ihre Suche ein. Jede konfigurierbare Option wird im Folgenden erläutert.

   

   • Geben Sie Kriterien an, um Ihre Suche einzugrenzen: Auf der linken Seite des Bildschirms befindet sich eine Liste der Felder, die im ausgewählten Objekt verfügbar sind. Für das Beispiel scrollen Sie nach unten zu „lastModifiedDate“. Doppelklicken Sie auf das Feld, um eine Bedingung hinzuzufügen, oder wählen Sie das Feld aus und klicken Sie dann auf die Schaltfläche Bedingung hinzufügen.

   • Bedingung hinzufügen: Wählen Sie im Popup Bedingung hinzufügen über die Dropdown-Liste einen Operator aus. Im Beispiel wählen wir „nach“. Aktivieren Sie unten das Optionsfeld für Vordefinierten Wert verwenden und wählen Sie „gestern“. Sie können alternativ ein genaues Datum angeben, wie im Dialog angegeben. Klicken Sie auf Bedingung hinzufügen, um fortzufahren.

   • Aktuelle Bedingungen: Eine Zusammenfassung der Bedingungen, die Sie aktuell ausgewählt haben, wird als Liste angezeigt. Verwenden Sie die Schaltflächen Bearbeiten oder Löschen, um die aktuelle Auswahl zu verwalten.

     Notiz

     Sie können Ihrer Suche beliebig viele Bedingungen hinzufügen, indem Sie einfach links ein weiteres Feld auswählen und eine weitere Bedingung hinzufügen. Auf diese Weise können Sie effektiv beliebige Kombinationen mehrerer Datensatzsuchen erstellen.

   • Größe der Suchseite: Legen Sie bei Bedarf die Anzahl der Datensätze pro Seite fest.

   • Abfrage testen: Klicken Sie unten rechts auf die Schaltfläche Abfrage testen, um Ihre Abfrage zu testen. Für unser Beispiel, das während der NetSuite create verwendet wurde,, aktualisieren und upsert-Vorgänge zeigt die Abfrage an, dass seit gestern drei Datensätze geändert wurden. Wenn die Ergebnisse korrekt aussehen, klicken Sie auf Fertigstellen.

3. Jitterbit erstellt dann eine NetSuite API Antwortstruktur, die die Struktur der Antwort zeigt. In Studio sollte eine neue Tab mit dem Namen NetSuite-Suchen angezeigt werden. Sie können Ihre Suchaktivität hier bei Bedarf umbenennen. Im Beispiel heißt unsere „Beispiel für einen einfachen NetSuite-Suchkunden“. Sie können auch die Schaltflächen + - oder Pfeile verwenden, um alle Elemente innerhalb der Struktur zu erweitern.

   

4. Klicken Sie anschließend auf demselben Bildschirm auf die Schaltfläche Operation erstellen unter In einer Integration verwenden in der oberen rechten Ecke. Dadurch wird die Jitterbit Operation erstellt, die die Suche durchführt.

5. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Suchaktivität enthält.

   

   Notiz

   Die Symbole für Antwort und Ziel im Bild oben sind Platzhalter für die Operation, die wir im nächsten Abschnitt definieren werden.

   Speichern Sie Ihren Operation, indem Sie entweder auf das Symbol für eine einzelne Festplatte klicken, um nur diesen Operation zu speichern, oder auf das Symbol für mehrere Festplatten, um alle Änderungen in Ihrem Integrationsprojekt zu speichern. Sie sollten sehen, dass das Sternchen auf der Tab Vorgänge und der Titel des Operation verschwinden, da Ihre neue Aktualisierungsaktivität jetzt erstellt und in Ihrem Projekt gespeichert ist.

Erweiterte Suche

Eine erweiterte Suche umfasst das ausgewählte Objekt sowie alle zugehörigen Objekte in NetSuite. Eine erweiterte Suche nach dem ausgewählten Objekt „Kunde“ umfasst beispielsweise auch zusätzliche zugehörige Objekte in NetSuite wie „billingAccountJoin“, „contactJoin“, „opportunityJoin“, „transactionJoin“ usw.

Das folgende Beispiel zeigt eine erweiterte Suche nach dem ausgewählten Objekt „Customer“ und verwandten Objekten. Die im Beispiel verwendeten Kriterien geben Datensätze aus dem verwandten Objekt „contactJoin“ mit einem Feld „lastModifiedDate“ nach „yesterday“ zurück, um Datensätze zurückzugeben. Wenn Sie die Beispiele für NetSuite create verfolgt haben,, aktualisieren und upsert-Vorgänge beachten Sie bitte, dass für die Zwecke dieses Beispiels auch einem der Testkunden in NetSuite ein Kontakt hinzugefügt wurde.

1. Auf dem Bildschirm Suchtyp des NetSuite-Suchassistenten werden Sie aufgefordert, den Suchtyp auszuwählen, den Sie durchführen möchten. Wählen Sie Erweiterte Suche und klicken Sie dann auf Weiter, um fortzufahren.

2. Im Bildschirm Abfrage erstellen des NetSuite-Suchassistenten geben Sie die Kriterien für Ihre Suche ein. Jede konfigurierbare Option wird im Folgenden erläutert.

   

   • Geben Sie Kriterien an, um Ihre Suche einzugrenzen: Auf der linken Seite des Bildschirms befinden sich das ausgewählte Objekt und alle zugehörigen Objekte. Verwenden Sie die Pfeile, um die Felder innerhalb des zugehörigen Objekts zu erweitern, das Sie Abfrage möchten. Erweitern Sie beispielsweise das Objekt „contactJoin“ und wählen Sie das Feld „lastModifiedDate“ aus. Doppelklicken Sie auf das Feld, um eine Bedingung hinzuzufügen, oder wählen Sie das Feld aus und klicken Sie dann auf die Schaltfläche Bedingung hinzufügen.

   • Bedingung hinzufügen: Wählen Sie im Popup Bedingung hinzufügen aus der Dropdown-Liste einen Operator aus. Im Beispiel wählen wir „nach“. Aktivieren Sie unten das Optionsfeld für Vordefinierten Wert verwenden und wählen Sie „gestern“. Sie können alternativ ein genaues Datum angeben, wie im Dialogfeld angegeben. Klicken Sie auf Bedingung hinzufügen, um fortzufahren.

   • Aktuelle Bedingungen: Eine Zusammenfassung der aktuell ausgewählten Bedingungen wird als Liste angezeigt. Verwenden Sie die Schaltflächen Bearbeiten oder Löschen, um die aktuelle Auswahl zu verwalten.

     Notiz

     Sie können Ihrer Suche beliebig viele Bedingungen hinzufügen, indem Sie einfach links ein weiteres Feld auswählen und eine weitere Bedingung hinzufügen. Auf diese Weise können Sie effektiv beliebige Kombinationen mehrerer Datensatzsuchen erstellen.

   • Größe der Suchseite: Legen Sie bei Bedarf die Anzahl der Datensätze pro Seite fest.

   • Abfrage testen: Klicken Sie unten rechts auf die Schaltfläche Abfrage testen, um Ihre Abfrage zu testen. Die Ergebnisse sollten die Anzahl der Datensätze anzeigen, für die Sie das Kontaktobjekt seit gestern geändert haben. Wenn die Ergebnisse korrekt aussehen, klicken Sie auf Fertigstellen.

3. Jitterbit erstellt dann eine NetSuite API Antwortstruktur, die die Struktur der Antwort zeigt. In Studio sollte eine neue Tab mit dem Namen NetSuite-Suchen angezeigt werden. Sie können Ihre Suchaktivität hier bei Bedarf umbenennen. Im Beispiel heißt unsere „Beispiel für erweiterte NetSuite-Suche nach Kunden“. Sie können auch die Schaltflächen + - oder Pfeile verwenden, um alle Elemente innerhalb der Struktur zu erweitern.

   

4. Klicken Sie anschließend auf demselben Bildschirm auf die Schaltfläche Operation erstellen unter In einer Integration verwenden in der oberen rechten Ecke. Dadurch wird die Jitterbit Operation erstellt, die die Suche durchführt.

5. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Suchaktivität enthält.

   

   Notiz

   Die Symbole für Antwort und Ziel im Bild oben sind Platzhalter für die Operation, die wir im nächsten Abschnitt definieren werden.

   Speichern Sie Ihren Operation, indem Sie entweder auf das Symbol für eine einzelne Festplatte klicken, um nur diesen Operation zu speichern, oder auf das Symbol für mehrere Festplatten, um alle Änderungen in Ihrem Integrationsprojekt zu speichern. Sie sollten sehen, dass das Sternchen auf der Tab Vorgänge und der Titel des Operation verschwinden, da Ihre neue Aktualisierungsaktivität jetzt erstellt und in Ihrem Projekt gespeichert ist.

Erweiterte Suchoptionen

Eine erweiterte Suche umfasst das ausgewählte Objekt sowie alle zugehörigen Objekte und bietet Ihnen im nächsten Bildschirm eine zusätzliche Option zur Auswahl der spezifischen Felder, die Sie Abfrage möchten. Eine erweiterte Suche kann viel schneller sein als eine einfache oder erweiterte Suche, selbst wenn Sie keine zugehörigen Objekte Abfrage möchten, da Sie die Abfrage auf bestimmte Felder in NetSuite beschränken können.

Das folgende Beispiel zeigt eine erweiterte Suche nach dem ausgewählten Objekt „Kunde“ und verwandten Objekten. Im Beispiel beschränken wir die zurückgegebenen Felder auch auf diejenigen, die wir während der Transformation im Beispiel NetSuite create zugeordnet haben, aktualisieren und upsert-Operationen. Dieses Beispiel gibt Datensätze vom Objekt „Kunde“ mit einem Feld „lastModifiedDate“ nach „gestern“ zurück. In diesem Beispiel werden keine verwandten Objekte Abfrage, aber Sie können dies ganz einfach tun, indem Sie die Filterkriterien auf die gleiche Weise wie beim Hauptobjekt definieren.

1. Auf dem Bildschirm Suchtyp des NetSuite-Suchassistenten werden Sie aufgefordert, den Suchtyp auszuwählen, den Sie durchführen möchten. Wählen Sie Erweiterte Suche und klicken Sie dann auf Weiter, um fortzufahren.

2. Im Bildschirm Abfrage erstellen des NetSuite-Suchassistenten geben Sie die Kriterien für Ihre Suche ein. Dieser Bildschirm enthält zwei Registerkarten: Zurückzugebende Spalten auswählen und Filterkriterien definieren, die unten erläutert werden.

   • Wählen Sie die zurückzugebenden Spalten aus: Wählen Sie auf dieser Tab die Felder innerhalb der Objekte aus, die Sie Abfrage möchten. Im Beispiel wählen wir alle Felder aus, die während der Transformation im Beispiel NetSuite create zugeordnet wurden, aktualisieren und upsert Operationen.

     Notiz

     Wenn es eine große Anzahl von Feldern gibt, können Sie diese möglicherweise leichter finden, indem Sie den Filter unter der Liste verwenden. Achten Sie darauf, das richtige Feld auszuwählen - in NetSuite kann es mehrere Felder mit ähnlichen Namen geben. Beachten Sie auch, dass beim Verwenden des Filters alle bereits ausgewählten Felder weiterhin angezeigt werden.

     

   • Filterkriterien definieren: Geben Sie auf dieser Tab die Kriterien für Ihre Suche ein. Jede Option wird unten erläutert.

     

     • Geben Sie Kriterien an, um Ihre Suche einzugrenzen: Auf der linken Seite des Bildschirms befinden sich das ausgewählte Objekt und alle zugehörigen Objekte. Verwenden Sie die Pfeile, um die Felder innerhalb des Objekts zu erweitern, das Sie Abfrage möchten. Erweitern Sie für das Beispiel das Objekt „Kunde“ und wählen Sie das Feld „lastModifiedDate“ aus. Doppelklicken Sie auf das Feld, um eine Bedingung hinzuzufügen, oder wählen Sie das Feld aus und klicken Sie dann auf die Schaltfläche Bedingung hinzufügen.

     • Bedingung hinzufügen: Wählen Sie im Popup Bedingung hinzufügen aus der Dropdown-Liste einen Operator aus. Im Beispiel wählen wir „nach“. Aktivieren Sie unten das Optionsfeld für Vordefinierten Wert verwenden und wählen Sie „gestern“. Sie können alternativ ein genaues Datum angeben, wie im Dialogfeld angegeben. Klicken Sie auf Bedingung hinzufügen, um fortzufahren.

     • Aktuelle Bedingungen: Eine Zusammenfassung der aktuell ausgewählten Bedingungen wird als Liste angezeigt. Verwenden Sie die Schaltflächen Bearbeiten oder Löschen, um die aktuelle Auswahl zu verwalten.

       Notiz

       Sie können Ihrer Suche beliebig viele Bedingungen hinzufügen, indem Sie einfach links ein weiteres Feld auswählen und eine weitere Bedingung hinzufügen. Auf diese Weise können Sie effektiv beliebige Kombinationen mehrerer Datensatzsuchen erstellen.

     • Größe der Suchseite: Legen Sie bei Bedarf die Anzahl der Datensätze pro Seite fest.

     • Abfrage testen: Klicken Sie unten rechts auf die Schaltfläche Abfrage testen, um Ihre Abfrage zu testen. Für unser Beispiel, das während der NetSuite create verwendet wurde,, aktualisieren und upsert-Vorgänge zeigt die Abfrage an, dass seit gestern drei Datensätze geändert wurden. Wenn die Ergebnisse korrekt aussehen, klicken Sie auf Fertig.

3. Jitterbit erstellt dann eine NetSuite API Antwortstruktur, die die Struktur der Antwort zeigt. In Studio sollte eine neue Tab mit dem Namen NetSuite-Suchen angezeigt werden. Sie können Ihre Suchaktivität hier bei Bedarf umbenennen. Im Beispiel heißt unsere „Beispiel für erweiterte NetSuite-Suche Kunde“. Sie können auch die Schaltflächen + - oder Pfeile verwenden, um alle Elemente innerhalb der Struktur zu erweitern.

   

   Notiz

   Beachten Sie bei einer erweiterten Suche, dass Sie beim Erweitern des Objekts (in diesem Beispiel die Zeile „Kunde“ oben) jedes Objekt weiter erweitern können, um zusätzliche Eigenschaften anzuzeigen. Je nach Feldtyp des Objekts können die im Feld verfügbaren Eigenschaften unterschiedlich sein.

   Beispielsweise ist companyName ein Zeichenfolgenfeld und enthält die Eigenschaften customLabel und searchValue. Die Eigenschaft searchValue enthält das Ergebnis der Abfrage. externalId ist jedoch ein Lookup und hat erweiterbare searchValues, einschließlich internalId, externalId, type und name. Beachten Sie, dass Sie beim Durchführen Ihrer Transformation im nächsten Abschnitt unten je nach Typ möglicherweise unterschiedliche Eigenschaften zuordnen müssen.

4. Klicken Sie anschließend auf demselben Bildschirm auf die Schaltfläche Operation erstellen unter In einer Integration verwenden in der oberen rechten Ecke. Dadurch wird die Jitterbit Operation erstellt, die die Suche durchführt.

5. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Suchaktivität enthält.

   

   Notiz

   Die Symbole für Antwort und Ziel im Bild oben sind Platzhalter für die Operation, die wir im nächsten Abschnitt definieren werden.

   Speichern Sie Ihren Operation, indem Sie entweder auf das Symbol für eine einzelne Festplatte klicken, um nur diesen Operation zu speichern, oder auf das Symbol für mehrere Festplatten, um alle Änderungen in Ihrem Integrationsprojekt zu speichern. Sie sollten sehen, dass das Sternchen auf der Tab Vorgänge und der Titel des Operation verschwinden, da Ihre neue Aktualisierungsaktivität jetzt erstellt und in Ihrem Projekt gespeichert ist.

Gespeicherte Suche

Eine gespeicherte Suche ist eine wiederverwendbare Suche, die Sie bereits in NetSuite definiert haben. Anstatt die Suche in Jitterbit zu erstellen, ist die Suche bereits in NetSuite eingerichtet und kann dann in Jitterbit übernommen werden. Weitere Informationen zu gespeicherten NetSuite Suchen finden Sie in der NetSuite Dokumentation unter Verwenden gespeicherter Suchvorgänge.

Das folgende Beispiel zeigt die Verwendung einer gespeicherten NetSuite Suche in einem Jitterbit Operation. In diesem Beispiel gibt die gespeicherte Abfrage in NetSuite neue Datensätze aus dem Objekt „Kunde“ zurück, die am heutigen Datum erstellt wurden.

1. Auf dem Bildschirm Suchtyp des NetSuite-Suchassistenten werden Sie aufgefordert, den Suchtyp auszuwählen, den Sie durchführen möchten. Wählen Sie Gespeicherte Suche und klicken Sie dann auf Weiter, um fortzufahren.

2. Der Bildschirm Abfrage erstellen des NetSuite-Suchassistenten fordert Sie auf, eine gespeicherte Suche für das ausgewählte Objekt auszuwählen. Diese Suchvorgänge werden direkt von Ihrer verbundenen NetSuite-Instanz abgerufen. Wählen Sie diejenige aus, die Sie für Ihre Abfrage verwenden möchten, und klicken Sie dann auf Abfrage testen, um sicherzustellen, dass die Anzahl der Datensätze Ihren Erwartungen entspricht. Klicken Sie auf Fertig, um fortzufahren.

   

   Notiz

   Wenn dieses Dropdown-Menü nicht ausgefüllt ist, Sie aber viele gespeicherte Suchvorgänge erwarten, erreichen Sie möglicherweise ein von NetSuite festgelegtes Limit von 1.000 Datensätzen für API Anfragen. Lesen Sie in diesem Fall Beschränkungen für gespeicherte Suchvorgänge in NetSuite, um die Einschränkung zu bestätigen und Vorschläge zur Problemumgehung zu erhalten.

3. Jitterbit erstellt dann eine NetSuite API Antwortstruktur, die die Struktur der Antwort zeigt. In Studio sollte eine neue Tab mit dem Namen NetSuite-Suchen angezeigt werden. Sie können Ihre Suchaktivität hier bei Bedarf umbenennen. Im Beispiel heißt unsere „Beispiel für gespeicherte NetSuite-Suche nach Kunden“. Sie können auch die Schaltflächen + - oder Pfeile verwenden, um alle Elemente innerhalb der Struktur zu erweitern.

   

   Notiz

   Wie bei einer erweiterten Suche können Sie bei einer gespeicherten Suche jedes Objekt weiter erweitern, um zusätzliche Eigenschaften anzuzeigen, wenn Sie das Objekt erweitern (in diesem Beispiel die Zeile „Kunde“ oben). Je nach Feldtyp des Objekts können die im Feld verfügbaren Eigenschaften unterschiedlich sein.

   Beispielsweise ist companyName ein Zeichenfolgenfeld und enthält die Eigenschaften customLabel und searchValue. Die Eigenschaft searchValue enthält das Ergebnis der Abfrage. externalId ist jedoch ein Lookup und hat erweiterbare searchValues, einschließlich internalId, externalId, type und name. Beachten Sie, dass Sie beim Durchführen Ihrer Transformation im nächsten Abschnitt unten je nach Typ möglicherweise unterschiedliche Eigenschaften zuordnen müssen.

4. Klicken Sie anschließend auf demselben Bildschirm auf die Schaltfläche Operation erstellen unter In einer Integration verwenden in der oberen rechten Ecke. Dadurch wird die Jitterbit Operation erstellt, die die Suche durchführt.

5. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Suchaktivität enthält.

   

   Notiz

   Die Symbole für Antwort und Ziel im Bild oben sind Platzhalter für die Operation, die wir im nächsten Abschnitt definieren werden.

   Speichern Sie Ihren Operation, indem Sie entweder auf das Symbol für eine einzelne Festplatte klicken, um nur diesen Operation zu speichern, oder auf das Symbol für mehrere Festplatten, um alle Änderungen in Ihrem Integrationsprojekt zu speichern. Sie sollten sehen, dass das Sternchen auf der Tab Vorgänge und der Titel des Operation verschwinden, da Ihre neue Aktualisierungsaktivität jetzt erstellt und in Ihrem Projekt gespeichert ist.

Definieren der Operation

Als Nächstes müssen wir die anderen Komponenten der Operation definieren, die in der grafischen Darstellung erscheinen, einschließlich Antwort und Ziel.

Die folgenden Anweisungen führen Sie jeweils dazu, zur grafischen Darstellung der von Ihnen erstellten Operation zurückzukehren und auf jedes Symbol zu doppelklicken, um die einzelnen Komponenten zu konfigurieren. Alternativ können Sie Antwort und Ziel auch separat erstellen und sie dann per Drag & Drop aus dem Baum links direkt auf die Symbole in der visuellen Darstellung Ihrer Operation ziehen.

Für die Zwecke dieser exemplarischen Vorgehensweise stellen wir die folgenden Beispiele als Referenz zur Verfügung: Jitterpak NetSuiteExample.jpk und zugehörige Dateien in NetSuiteSampleFiles.zip. Für jede Komponente der Operation können viele verschiedene Datentypen verwendet werden. Weitere Informationen zu zusätzlichen Anpassungsoptionen finden Sie im Design Studio Abschnitt unserer Dokumentation.

Einfache Suche

Im Folgenden werden die Komponenten Ziel und Antwort für den grundlegenden Operation erläutert, der unter „Erstellen eines Suchvorgangs“ als Beispiel verwendet wurde.

• Ziel: Doppelklicken Sie auf das Ziel-Symbol. Im Beispiel zeichnen wir die Abfrage von NetSuite in einer CSV-Datei auf. Klicken Sie auf die Schaltfläche Neues Ziel erstellen und geben Sie Ihrem Ziel einen Namen (z. B. CustomerBasicSearchResponse.csv). Für dieses Beispiel verwenden wir einen privaten Agenten mit lokalen Dateien aktiviert, und wählen Sie daher als Typ „Lokale Datei“ aus und navigieren Sie dann zu dem Speicherort, an dem wir die Daten speichern möchten. Im Beispiel ist der Ordner „C:\NetSuiteSampleFiles“ und der Dateiname ist „CustomerBasicSearchResponse.csv“.

  Hinweis

  Sie können auch in eine Vielzahl unterschiedlicher Zieltypen ausgeben. Der Typ muss nicht mit dem Quelltyp identisch sein. Siehe Ziele für Optionen.

• Antwort: Doppelklicken Sie auf das Symbol Antwort und wählen Sie Neue Transformation erstellen. Dadurch wird der Transformation geöffnet, der Sie durch die Erstellung der Antwort führt.

  Notiz

  Weitere Informationen zu Antwortstrukturen finden Sie unter Transformations.

  1. Geben Sie auf dem ersten Bildschirm Name einen Namen für Ihre Transformation ein oder belassen Sie den Standardwert. Verwenden Sie dann das Dropdown-Menü Ziel, um den Zieltyp auszuwählen. Für das Beispiel haben wir eine CSV-Datei verwendet, die als „Text“ gilt. Klicken Sie auf Weiter, um fortzufahren.

  2. Wählen Sie auf dem nächsten Bildschirm Ziel im Dropdown-Menü Verfügbare Dateiformatdefinitionen dieselbe Quelldateiformatdefinition aus, die während Erstellen des NetSuite Connectors erstellt wurde (d. h. „Beispiel einer Kunden-Flachdatei“). Klicken Sie auf Fertig, um fortzufahren.

  3. Die Tab Transformations sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Quell- und Zielelemente in jedem Baum zu erweitern. Ziehen Sie dann jedes Feld, das Sie zuordnen möchten, per Drag & Drop von einem Baum zum anderen.

     Notiz

     Während der in diesem Beispiel verwendeten Transformation wurde ein Schleifenknoten im Element „addressbook“ vorhanden, wie durch die Position der unten gezeigten dicken schwarzen Linie angezeigt. Jedes Datenelement, das mehrere Datensätze haben kann, wie z. B. „addressbook“ in NetSuite, kann dazu führen, dass der Schleifenknoten von diesem Objekt ausgeht und nicht vom Hauptobjekt wie „Kunde“.

     

     Notiz

     Um den Loop-Knoten zu reparieren, geben wir in diesem Beispiel in einem Script an, nur den ersten Datensatz zu verwenden, indem wir im Feldvariablennamen nach dem Loop-Knoten „#1“ hinzufügen. Alternativen sind die Angabe einer benutzerdefinierten Logik zum Abrufen der Standard-Rechnungs- oder Lieferadresse oder die Änderung Ihrer Zieldatenstruktur, um auch mehrere Adressen zu unterstützen.

     • Doppelklicken Sie auf der Zielseite das Feld „Adresse“, um den Formel-Generator zu öffnen und dem Script die folgenden Funktionen hinzuzufügen. Klicken Sie dann auf OK.

       <trans>
       searchResponse$searchResult$recordList$record.Customer$addressbookList$addressbook#1.addressbookAddress$addr1$
       </trans>
       

     • Doppelklicken Sie auf der Zielseite das Feld „Stadt“, um den Formel-Generator zu öffnen und dem Script die folgenden Funktionen hinzuzufügen. Klicken Sie dann auf OK.

       <trans>
       searchResponse$searchResult$recordList$record.Customer$addressbookList$addressbook#1.addressbookAddress$city$
       </trans>
       

     • Doppelklicken Sie auf der Zielseite das Feld „Status“, um den Formel-Generator zu öffnen und dem Script die folgenden Funktionen hinzuzufügen. Klicken Sie dann auf OK.

       <trans>
       searchResponse$searchResult$recordList$record.Customer$addressbookList$addressbook#1.addressbookAddress$state$
       </trans>
       

     • Doppelklicken Sie auf der Zielseite das Feld „Zip“, um den Formel-Generator zu öffnen und dem Script die folgenden Funktionen hinzuzufügen. Klicken Sie anschließend auf OK.

       <trans>
       searchResponse$searchResult$recordList$record.Customer$addressbookList$addressbook#1.addressbookAddress$zip$
       </trans>
       

     Ihre endgültige Transformation sollte ungefähr wie die unten gezeigte aussehen:

     

Erweiterte Suche

Im Folgenden werden die Komponenten Ziel und Antwort für den erweiterten Operation erläutert, der unter „Erstellen eines Suchvorgangs“ als Beispiel verwendet wurde.

• Ziel: Doppelklicken Sie auf das Ziel-Symbol. Im Beispiel zeichnen wir die Abfrage von NetSuite in einer CSV-Datei auf. Klicken Sie auf die Schaltfläche Neues Ziel erstellen und geben Sie Ihrem Ziel einen Namen (z. B. CustomerExpandedSearchResponse.csv). Für dieses Beispiel verwenden wir einen privaten Agenten mit lokalen Dateien aktiviert, und wählen Sie daher als Typ „Lokale Datei“ aus und navigieren Sie dann zu dem Speicherort, an dem wir die Daten speichern möchten. Im Beispiel ist der Ordner „C:\NetSuiteSampleFiles“ und der Dateiname ist „CustomerExpandedSearchResponse.csv“.

  Hinweis

  Sie können auch in eine Vielzahl unterschiedlicher Zieltypen ausgeben. Der Typ muss nicht mit dem Quelltyp identisch sein. Siehe Ziele für Optionen.

• Antwort: Doppelklicken Sie auf das Symbol Antwort und wählen Sie Neue Transformation erstellen. Dadurch wird der Transformation geöffnet, der Sie durch die Erstellung der Antwort führt.

  Notiz

  Weitere Informationen zu Antwortstrukturen finden Sie unter Transformations.

  1. Geben Sie auf dem ersten Bildschirm Name einen Namen für Ihre Transformation ein oder belassen Sie den Standardwert. Verwenden Sie dann das Dropdown-Menü Ziel, um den Zieltyp auszuwählen. Für das Beispiel haben wir eine CSV-Datei verwendet, die als „Text“ gilt. Klicken Sie auf Weiter, um fortzufahren.

  2. Auf dem nächsten Bildschirm, Ziel, müssen wir eine neue Dateiformatdefinition erstellen, da die erweiterte Suche ein zusätzliches Feld für Kontakt enthält, das in den anderen Beispielen nicht verwendet wird.

     Um das neue Dateiformat zu erstellen, wählen Sie Neu erstellen. Dadurch werden zusätzliche Optionen zum Definieren eines neuen Dateiformats geöffnet. Geben Sie einen Namen für das neue Dateiformat ein (im Beispiel nennen wir unser Format „Beispiel für eine flache Kundendatei mit Kontakt“). Wir können mit einer Textdefinition beginnen, die auf unserer vorhandenen CSV-Datei basiert, die für die anderen Beispiele verwendet wurde, und dann das zusätzliche Feld hinzufügen. Wählen Sie dazu Aus Datei erstellen und navigieren Sie dann im Popup zur lokalen Datei „CustomerCreateRequest.csv“. Klicken Sie im nächsten Bildschirm auf Neu und fügen Sie der Dateiformatdefinition ein zusätzliches Feld namens „Kontakt“ hinzu.

     Klicken Sie auf Fertig, um fortzufahren.

  3. Die Tab Transformations sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Quell- und Zielelemente in jedem Baum zu erweitern. Ziehen Sie dann jedes Feld, das Sie zuordnen möchten, per Drag & Drop von einem Baum zum anderen.

     Notiz

     Während der in diesem Beispiel verwendeten Transformation wurde sowohl im Element „Adressbuch“ als auch im Element „Kontakt“ ein Schleifenknoten angezeigt, wie durch die Position der dicken schwarzen Linien angezeigt. Um die Schleifenknoten zu beheben, geben wir in diesem Beispiel in einem Script an, nur den ersten Datensatz zu verwenden, indem wir „#1“ nach dem Schleifenknoten im Feldvariablennamen hinzufügen. Die „#1“ wurde im Script in den Zielfeldern Adresse, Stadt, Bundesland, Postleitzahl und Kontakt hinzugefügt. Ausführlichere Anweisungen dazu finden Sie im Beispiel in der obigen einfachen Suche, bei dem ebenfalls ein Problem mit Schleifenknoten auftrat, oder in der endgültigen Zuordnung im Jitterpak.

     Ihre endgültige Transformation sollte ungefähr wie die unten gezeigte aussehen:

     

Erweiterte Suchoptionen

Im Folgenden werden die Komponenten Ziel und Antwort für die erweiterte Operation erläutert, die unter „Erstellen einer Suchoperation“ als Beispiel verwendet wurde.

• Ziel: Doppelklicken Sie auf das Ziel-Symbol. Im Beispiel zeichnen wir die Abfrage von NetSuite in einer CSV-Datei auf. Klicken Sie auf die Schaltfläche Neues Ziel erstellen und geben Sie Ihrem Ziel einen Namen (z. B. CustomerAdvancedSearchResponse.csv). Für dieses Beispiel verwenden wir einen privaten Agenten mit lokalen Dateien aktiviert, und wählen Sie daher als Typ „Lokale Datei“ aus und navigieren Sie dann zu dem Speicherort, an dem wir die Daten speichern möchten. Im Beispiel ist der Ordner „C:\NetSuiteSampleFiles“ und der Dateiname ist „CustomerAdvancedSearchResponse.csv“.

  Hinweis

  Sie können auch in eine Vielzahl unterschiedlicher Zieltypen ausgeben. Der Typ muss nicht mit dem Quelltyp identisch sein. Siehe Ziele für Optionen.

• Antwort: Doppelklicken Sie auf das Symbol Antwort und wählen Sie Neue Transformation erstellen. Dadurch wird der Transformation geöffnet, der Sie durch die Erstellung der Antwort führt.

  Notiz

  Weitere Informationen zu Antwortstrukturen finden Sie unter Transformations.

  1. Geben Sie auf dem ersten Bildschirm Name einen Namen für Ihre Transformation ein oder belassen Sie den Standardwert. Verwenden Sie dann das Dropdown-Menü Ziel, um den Zieltyp auszuwählen. Für das Beispiel haben wir eine CSV-Datei verwendet, die als „Text“ gilt. Klicken Sie auf Weiter, um fortzufahren.

  2. Wählen Sie auf dem nächsten Bildschirm Ziel im Dropdown-Menü Verfügbare Dateiformatdefinitionen dieselbe Quelldateiformatdefinition aus, die während Erstellen des NetSuite Connectors erstellt wurde (d. h. „Beispiel einer Kunden-Flachdatei“). Klicken Sie auf Fertig, um fortzufahren.

  3. Die Tab Transformations sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Quell- und Zielelemente in jedem Baum zu erweitern. Beachten Sie, dass Sie auf der Quellseite nur die Felder haben, die Sie bei der Suche ausgewählt haben. Ziehen Sie dann jedes Feld, das Sie zuordnen möchten, per Drag & Drop von einem Baum zum anderen.

     Ihre Transformation sollte ungefähr wie unten gezeigt aussehen:

     

Gespeicherte Suche

Im Folgenden werden die Komponenten Ziel und Antwort für den gespeicherten Operation erläutert, der unter „Erstellen eines Suchvorgangs“ als Beispiel verwendet wurde.

• Ziel: Doppelklicken Sie auf das Ziel-Symbol. Im Beispiel zeichnen wir die Abfrage von NetSuite in einer CSV-Datei auf. Klicken Sie auf die Schaltfläche Neues Ziel erstellen und geben Sie Ihrem Ziel einen Namen (z. B. CustomerSavedSearchResponse.csv). Für dieses Beispiel verwenden wir einen privaten Agenten mit lokalen Dateien aktiviert, und wählen Sie daher einen Typ von „Lokale Datei“ aus und navigieren Sie dann zu dem Speicherort, an dem wir die Daten speichern möchten. Im Beispiel ist der Ordner „C:\NetSuiteSampleFiles“ und der Dateiname ist „CustomerSavedSearchResponse.csv“.

  Hinweis

  Sie können auch in eine Vielzahl unterschiedlicher Zieltypen ausgeben. Der Typ muss nicht mit dem Quelltyp identisch sein. Siehe Ziele für Optionen.

• Antwort: Doppelklicken Sie auf das Symbol Antwort und wählen Sie Neue Transformation erstellen. Dadurch wird der Transformation geöffnet, der Sie durch die Erstellung der Antwort führt.

  Notiz

  Weitere Informationen zu Antwortstrukturen finden Sie unter Transformations.

  1. Geben Sie auf dem ersten Bildschirm Name einen Namen für Ihre Transformation ein oder belassen Sie den Standardwert. Verwenden Sie dann das Dropdown-Menü Ziel, um den Zieltyp auszuwählen. Für das Beispiel haben wir eine CSV-Datei verwendet, die als „Text“ gilt. Klicken Sie auf Weiter, um fortzufahren.

  2. Wählen Sie auf dem nächsten Bildschirm Ziel im Dropdown-Menü Verfügbare Dateiformatdefinitionen dieselbe Quelldateiformatdefinition aus, die während Erstellen des NetSuite Connectors erstellt wurde (d. h. „Beispiel einer Kunden-Flachdatei“). Klicken Sie auf Fertig, um fortzufahren.

  3. Die Tab Transformations sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Quell- und Zielelemente in jedem Baum zu erweitern. Ziehen Sie dann jedes Feld, das Sie zuordnen möchten, per Drag & Drop von einem Baum zum anderen.

     Ihre Transformation sollte ungefähr wie unten gezeigt aussehen:

     

Bereitstellen und Ausführen der Operation

Nachdem die NetSuite Suchaktivität vollständig konfiguriert ist, können wir den Operation einsetzen und ausführen.

1. Klicken Sie auf der Tab Operationen auf die einsetzen -Symbol.
2. Klicken Sie dann auf „Ausführen“ , um den Operation zur Ausführung in die Warteschlange zu stellen.
3. Im unteren Teil des Bildschirms sollte der Operationsmonitor anzeigen, dass Ihr Operation erfolgreich ausgeführt wurde. Wenn nicht, können Sie auf das Symbol Status doppelklicken, um alle Protokollmeldungen anzuzeigen.
4. Sie sollten jetzt auch die Ausgabeantwort sehen, die Ihrer Zieldatei zugeordnet wurde. Im Beispiel wird die Datei jetzt in „C:\NetSuiteSampleFiles\“ mit dem Namen der Art der durchgeführten Suche erstellt. Die Datei sollte Daten für Ihre spezifische Suche in jeder Spalte enthalten, die Sie der Ausgabedatei zugeordnet haben.