NetSuite-Connector GetList im Jitterbit Design Studio

Die NetSuite GetList-Aktivität, die im NetSuite-Connector verfügbar ist, ermöglicht es Ihnen, Datensätze anhand interner oder externer IDs in einer verbundenen NetSuite-Instanz über Jitterbit abzufragen.

Diese Seite beschreibt, wie Sie vorhandene NetSuite-Datensätze anhand von IDs mit einem einfachen Beispiel abfragen, bei dem externe IDs in einer CSV-Datei über Jitterbit bereitgestellt werden. Dies setzt die Demonstration mit Beispiel-Datensätzen fort, die während der Durchgänge für NetSuite-Connector erstellen, NetSuite-Connector aktualisieren und NetSuite-Connector upsert erstellt und aktualisiert wurden.

Die folgenden Abschnitte sind in den Beginn der GetList-Aktivität, die Definition der Betriebsbestandteile sowie die Bereitstellung und Ausführung der Operation unterteilt.

Erstellen einer 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 öffnet den NetSuite GetList Wizard, der Sie durch den Prozess führt.

   • Gehen Sie zu Datei > Neu > Connectoren > Neue NetSuite GetList.
   • Klicken Sie im Baum auf der linken Seite unter Connectoren mit der rechten Maustaste auf die Kategorie NetSuite und wählen Sie dann Neue NetSuite GetList.
   • Doppelklicken Sie im Baum auf der linken Seite unter Connectoren auf die Kategorie NetSuite, klicken Sie dann mit der rechten Maustaste auf Neue NetSuite GetList und wählen Sie Neue NetSuite GetList.
   • Klicken Sie in der oberen Symbolleiste auf das Connector-Symbol (orangefarbener Puzzlestück) . Wählen Sie im Popup NetSuite und dann NetSuite GetList.

2. Der Bildschirm Endpoint des NetSuite GetList Wizard sollte in der Hauptansicht von Studio geöffnet werden. Dieser Bildschirm fordert Sie auf, den Endpunkt auszuwählen, von dem Sie die Daten abrufen möchten. Sie sollten Ihren Endpunkt bereits im NetSuite-Connector-Endpunkt eingerichtet haben. Verwenden Sie das Dropdown-Menü, um den entsprechenden Endpunkt auszuwählen. Klicken Sie auf Weiter, wenn Sie fertig sind.

3. Der Bildschirm Objekt des NetSuite GetList Wizard fordert Sie auf, das Objekt auszuwählen, von dem Sie Datensätze abfragen möchten. Zu diesem Zeitpunkt kann pro Anfrage nur ein Objekttyp abgefragt werden. In diesem Beispiel möchten wir vorhandene Kundenaufzeichnungen in NetSuite abfragen, also wählen wir das Objekt "Kunde" aus und klicken dann auf Fertigstellen, um fortzufahren.

   Hinweis

   Wenn Sie viele Objekte in Ihrem NetSuite-Konto verfügbar haben, 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 die Schaltfläche Aktualisieren, wenn die Ergebnisse nicht Ihren Erwartungen entsprechen.

1. Jitterbit wird dann mit der Erstellung einer NetSuite API-Anfrage- und Antwortstruktur fortfahren, die es ermöglicht, Daten innerhalb Ihres verbundenen NetSuite-Kontos abzufragen. Ein neuer Tab sollte in Studio erscheinen, der NetSuite GetLists heißt. Sie können Ihre GetList-Aktivität hier nach Belieben umbenennen; in unserem Beispiel heißt sie "Beispiel NetSuite GetList Kunde." Sie können auch die + - Schaltflächen oder Pfeile verwenden, um alle Elemente innerhalb jeder Struktur zu erweitern.

2. Klicken Sie als Nächstes auf demselben Bildschirm auf die Schaltfläche Operation erstellen, die sich unter In einer Integration verwenden in der oberen rechten Ecke befindet. Dies wird die Jitterbit-Operation erstellen, die vorhandene Kundendaten in NetSuite abfragt.

3. Ein neuer Tab sollte in Studio geöffnet werden, der Operationen heißt und eine grafische Darstellung der GetList-Aktivität enthält.

Speichern Sie Ihre Operation, indem Sie entweder auf das einzelne Diskettensymbol klicken, um nur diese Operation zu speichern, oder auf das mehrfache Diskettensymbol, um alle Änderungen in Ihrem Integrationsprojekt zu speichern. Sie sollten sehen, dass der Stern auf dem Tab Operationen und der Titel der Operation verschwinden, da Ihre neue GetList-Aktivität jetzt erstellt und in Ihrem Projekt gespeichert ist.

Definieren der Betriebskomponenten

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

Für die Zwecke dieses Walkthroughs stellen wir die folgenden Beispiele zur Referenz zur Verfügung: Jitterpak NetSuiteExample.jpk und begleitende Dateien in NetSuiteSampleFiles.zip. Viele verschiedene Arten von Daten können für jede Komponente der Operation verwendet werden. Um mehr über zusätzliche Anpassungsoptionen zu erfahren, beziehen Sie sich auf den Abschnitt Design Studio unserer Dokumentation.

• Quelle: Im Beispiel verwenden wir eine CSV-Datei als Eingabeanforderung, um vorhandene Kundenakten nach ID abzufragen. Diese IDs wurden ursprünglich während der Beispiel-NetSuite-Erstellung, Aktualisierung und Upsert Operationen mit der NetSuite External ID verknüpft.

  Hinweis

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

  • ExternalID: Wenn die ID, die Sie für die NetSuite ExternalID verwenden möchten, noch nicht in den vorhandenen NetSuite-Datensätzen existiert, können Sie eine NetSuite-Connector-Aktualisierung oder eine NetSuite-Connector-Upsert Operation durchführen, um sie 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 sowie über diese GetList-Operation abgefragt werden.

  Um die CSV-Datei zu verwenden, doppelklicken Sie zuerst auf das Quelle-Symbol, klicken Sie dann auf die Schaltfläche Neue Quelle erstellen und geben Sie Ihrer Quelle einen Namen (z. B. CustomerGetListRequest.csv). Für dieses Beispiel verwenden wir einen privaten Agenten mit lokalen Dateien aktiviert und wählen daher einen Typ von "Lokale Datei" und klicken dann auf Durchsuchen, um den Speicherort auszuwählen. Wenn Sie die Beispieldateien verwenden, ist der Ordner 'C:\NetSuiteSampleFiles' und die Datei abrufen ist 'CustomerGetListRequest.csv'. Wir werden auch die Optionen erweitern und Zeilen ignorieren auf Erste: '1' setzen, da unsere CSV-Datei eine Kopfzeile verwendet.

  Hinweis

  Eine Vielzahl von Quelltypen ist in Jitterbit verfügbar. Weitere Informationen finden Sie unter Quellen.

• Ziel: Doppelklicken Sie auf das Ziel-Symbol. Im Beispiel werden wir die Antwort von NetSuite in einer XML-Datei aufzeichnen. Klicken Sie auf die Schaltfläche Neues Ziel erstellen, geben Sie Ihrem Ziel einen Namen (z. B. CustomerGetListResponse.xml) und wählen Sie erneut einen Typ von "Lokale Datei" aus und Durchsuchen Sie einen 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 von verschiedenen Zieltypen ausgeben. Der Typ muss nicht mit dem Quelltyp übereinstimmen. Siehe Ziele für Optionen.

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

  Hinweis

  Zusätzliche Informationen zu Anfrage-Strukturen finden Sie unter Transformationen.

  1. Auf dem ersten Bildschirm, Name, geben Sie einen Namen für Ihre Transformation an oder lassen Sie den Standardwert. 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" betrachtet wird. Klicken Sie auf Weiter, um fortzufahren.

  2. Auf dem nächsten Bildschirm, Quelle, verwenden Sie das Dropdown-Menü Verfügbare Dateiformatdefinitionen, um Neu erstellen auszuwählen. Dies öffnet zusätzliche Optionen zur Definition eines neuen Dateiformats. Geben Sie einen Namen für das neue Dateiformat an (im Beispiel nennen wir unseres "Beispiel-Kunden-Flachdatei-ID nur"). Um die Textdefinition basierend auf unserer vorhandenen CSV-Datei zu erstellen, wählen Sie Von Datei erstellen, und durchsuchen Sie dann im Popup die lokale Datei 'CustomerGetListRequest.csv'. Klicken Sie auf Fertigstellen, um fortzufahren.

  3. Der Tab Transformationen sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Quell- und Zielobjekte in jedem Baum zu erweitern. Ziehen Sie dann jedes Feld, das Sie zuordnen möchten, von einem Baum in den anderen. In diesem Fall wird die ID, die in unserer CSV-Datei bereitgestellt wird, dem Feld 'externalId' in NetSuite zugeordnet.

     Ihre Transformationszuordnung sollte ähnlich aussehen wie unten gezeigt:

• Antwort: Klicken Sie mit der rechten Maustaste auf das Antwort-Symbol und wählen Sie Durchreichen. Dadurch können wir alle Daten erfassen, die mit den abgefragten Datensätzen verbunden sind.

  Hinweis

  In diesem Beispiel möchten wir Daten aus NetSuite abfragen und sie an eine Ausgabedatei oder unsere XML-Datei weiterleiten. Wenn wir einige der Daten vor der Ausgabe transformieren möchten, könnten wir hier eine neue Transformation erstellen, ähnlich den anderen Beispielen, die in NetSuite für erstellen, aktualisieren, upsert und suchen bereitgestellt werden.

• Optionale Skripte: Sie finden zusätzliche Skriptfunktionen, die Sie während Ihrer Transformation Zuordnung oder separat als Skripte im Abschnitt Formel-Builder verwenden können. Für weitere Informationen siehe NetSuite-Connector erweitert.

Bereitstellen und Ausführen der Operation

Nachdem die NetSuite GetList-Aktivität vollständig konfiguriert ist, sind wir bereit, die Operation bereitzustellen und auszuführen.

1. Klicken Sie im Tab Operationen auf das Bereitstellen Symbol.
2. Klicken Sie dann auf das Ausführen Symbol, um die Operation in die Warteschlange zur Ausführung zu stellen.
3. Im unteren Bereich des Bildschirms sollte der Betriebsmonitor anzeigen, dass Ihre Operation erfolgreich ausgeführt wurde. Andernfalls können Sie auf das Status-Symbol doppelklicken, um alle Protokollnachrichten anzuzeigen.
4. Sie sollten jetzt auch die Ausgabereaktion 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 Kundenaufzeichnungen enthalten, die nach ID abgefragt wurden.