NetSuite Anschluss GetList im Jitterbit Design Studio

Die NetSuite GetList-Aktivität ist im NetSuite Connector verfügbar ermöglicht Ihnen die Abfrage von Datensätzen nach interner oder externer ID in einer verbundenen NetSuite Instanz mithilfe von Jitterbit.

Auf dieser Seite wird anhand eines einfachen Beispiels mit externen IDs, die in einer CSV-Datei über Jitterbit bereitgestellt werden, beschrieben, wie vorhandene NetSuite-Datensätze nach ID Abfrage werden. Dies ist eine Fortsetzung der Demonstration anhand von Beispieldatensätzen, 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 gliedern sich in das Starten der GetList-Aktivität, das Definieren der Operation und das Bereitstellen und Ausführen des Operation.

Erstellen eines NetSuite GetList-Operation

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

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

2. Der Endpoint-Bildschirm des NetSuite GetList Wizard sollte in der Hauptansicht von Studio geöffnet werden. In diesem Bildschirm werden Sie aufgefordert, den Endpoint auszuwählen, von dem Sie die Daten abrufen 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. Der Objekt-Bildschirm des NetSuite GetList Wizard fordert Sie auf, das Objekt auszuwählen, dessen Datensätze Sie Abfrage möchten. Derzeit kann pro Anfrage nur ein Objekttyp abgefragt werden. In diesem Beispiel möchten wir vorhandene Kundendatensätze in NetSuite Abfrage, also wählen wir das Objekt „Kunde“ aus und klicken dann auf Fertig, um fortzufahren.

   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“ oder „Benutzerdefinierte Objekte“ zu beschränken. Versuchen Sie es mit der Schaltfläche Aktualisieren, wenn die Ergebnisse nicht Ihren Erwartungen entsprechen.

   

4. Jitterbit erstellt dann eine NetSuite API Anforderungs- und Antwortstruktur, die die Abfrage von Daten innerhalb Ihres verbundenen NetSuite-Kontos ermöglicht. In Studio sollte eine neue Tab mit dem Namen NetSuite GetLists angezeigt werden. Sie können Ihre GetList-Aktivität hier bei Bedarf umbenennen; im Beispiel heißt unsere „Beispiel NetSuite GetList-Kunde“. Sie können auch die + - Schaltflächen oder Pfeile verwenden, um alle Elemente innerhalb jeder Struktur zu erweitern.

5. Klicken Sie anschließend auf demselben Bildschirm auf die Schaltfläche Operation erstellen, die sich unter In einer Integration verwenden in der oberen rechten Ecke befindet. Dadurch wird die Jitterbit Operation erstellt, die vorhandene Kundendaten in NetSuite Abfrage.

6. In Studio sollte eine neue Tab mit dem Namen Operationen geöffnet werden, die eine grafische Darstellung der GetList-Aktivität enthält.

   Notiz

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

   Speichern Sie Ihren Operation, indem Sie entweder auf das Symbol mit einem Datenträger klicken, um nur diesen Operation zu speichern, oder auf das Symbol mit mehreren Datenträgern, 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 GetList-Aktivitä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 angezeigt werden, einschließlich Quelle, Anforderung, Antwort und Ziel.

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.

• Quelle: Im Beispiel verwenden wir eine CSV-Datei als Eingabeanforderung, um vorhandene Kundendatensätze nach ID Abfrage. Diese gleichen IDs wurden ursprünglich während des Beispiels NetSuite create der externen NetSuite-ID zugeordnet, aktualisieren und upsert Operationen.

  Notiz

  NetSuite GetList unterstützt die Abfrage von Objektdaten entweder per ExternalID oder InternalID.

  • ExternalID: Wenn die ID, die Sie für NetSuite ExternalID verwenden möchten, noch nicht in vorhandenen NetSuite-Datensätzen vorhanden ist, können Sie ein NetSuite Connector-Update durchführen oder NetSuite Connector-Upsert, Operation es hinzuzufügen.
  • InternalID: Die NetSuite InternalID wird von NetSuite generiert und kann aus dem Datensatz innerhalb von NetSuite abgerufen werden. Sie kann auch über eine NetSuite Connector-Suche abgefragt werden Operation sowie diese GetList Operation.

  Um die CSV-Datei zu verwenden, doppelklicken Sie zuerst auf das Symbol Quelle, klicken Sie dann auf die Schaltfläche Neue Quelle erstellen und geben Sie Ihrer Quelle einen Namen (z. B. CustomerGetListRequest.csv). Als nächstes verwenden wir für dieses Beispiel einen privaten Agenten mit lokalen Dateien aktiviert, und wählen Sie daher einen Typ von „Lokale Datei“ und Navigieren Sie dann zum Speicherort. Wenn Sie die Beispieldateien verwenden, ist der Ordner „C:\NetSuiteSampleFiles“ und die Abrufdateien sind „CustomerGetListRequest.csv“. Wir werden auch die Optionen erweitern und Zeilen ignorieren auf Erste: „1“ setzen, da unsere CSV-Datei eine Header verwendet.

  Hinweis

  In Jitterbit sind verschiedene Quelltypen verfügbar. Siehe Quellen für mehr.

• Ziel: Doppelklicken Sie auf das Ziel-Symbol. Im Beispiel zeichnen wir die Antwort von NetSuite in einer XML-Datei auf. Klicken Sie auf die Schaltfläche Neues Ziel erstellen, geben Sie Ihrem Ziel einen Namen (z. B. CustomerGetListResponse.xml), wählen Sie erneut einen Typ „Lokale Datei“ und Navigieren Sie zu einem Speicherort auf dem privaten Agenten, an dem wir die Daten speichern möchten. Im Beispiel ist der Ordner „C:\NetSuiteSampleFiles“ und der Dateiname ist „CustomerGetListResponse.xml“.

  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.

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

  Notiz

  Weitere Informationen zu Anfragestrukturen finden Sie unter Transformations.

  1. Geben Sie auf dem ersten Bildschirm Name einen Namen für Ihre Transformation ein oder belassen Sie es beim Standard. Verwenden Sie dann das Dropdown-Menü Quelle, um den Quelltyp 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 Quelle im Dropdown-Menü Verfügbare Dateiformatdefinitionen Neu erstellen aus. 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 „Nur Beispiel-Kunden-Flatfile-ID“). Um die Textdefinition basierend auf unserer vorhandenen CSV-Datei zu erstellen, wählen Sie Aus Datei erstellen und navigieren Sie dann im Popup zur lokalen Datei „CustomerGetListRequest.csv“. Klicken Sie auf Fertigstellen, 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. In diesem Fall wird die in unserer CSV-Datei angegebene ID dem Feld „externalId“ in NetSuite zugeordnet.

     Ihre Transformation sollte ungefähr wie unten gezeigt aussehen:

• Antwort: Klicken Sie mit der rechten Maustaste auf das Symbol Antwort und wählen Sie Pass-Through. Dadurch können wir alle Daten erfassen, die mit den von uns abgefragten Datensätzen verknüpft sind.

  Notiz

  In diesem Beispiel möchten wir Daten aus NetSuite Abfrage und an eine Ausgabedatei oder unsere XML-Datei weitergeben. Wenn wir Daten vor der Ausgabe transformieren möchten, können wir hier eine neue Transformation erstellen, ähnlich wie in den anderen Beispielen in NetSuite create, aktualisieren, upsert und Suche Operationen.

• Optionale Scripts: Hier finden Sie zusätzliche Script, die Sie während Ihrer Transformation verwenden können Mapping oder separat als Scripts unter dem Formel-Generator Abschnitt. Weitere Informationen finden Sie unter NetSuite Connector - Erweitert.

Bereitstellen und Ausführen der Operation

Nachdem die NetSuite GetList-Aktivitä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 an Ihre Zieldatei weitergeleitet wurde. Im Beispiel wird die Datei jetzt in „C:\NetSuiteSampleFiles\CustomerGetListResponse.xml“ erstellt. Die Datei sollte alle Daten zu den nach ID abgefragten Kundendatensätzen enthalten.