Upsert des NetSuite Connectors im Jitterbit Design Studio

Die NetSuite Upsert-Aktivität ist im NetSuite Connector verfügbar ermöglicht Ihnen, vorhandene Datensätze zu aktualisieren oder neue Datensätze in einer verbundenen NetSuite Instanz mit Jitterbit zu erstellen. Ein „Upsert“ ist im Wesentlichen entweder eine Aktualisierungs- oder eine Operation oder beides, abhängig von den bereitgestellten Daten.

Auf dieser Seite wird beschrieben, wie Sie gleichzeitig vorhandene NetSuite Datensätze aktualisieren und neue erstellen. Als Beispiel wird die Aktualisierung der Telefonnummer eines vorhandenen Kunden und die Erstellung eines neuen Kunden in NetSuite aus Quelldaten verwendet, die in einer CSV-Datei über Jitterbit bereitgestellt werden.

Dieses Beispiel zeigt das Erstellen eines neuen Kunden und das Aktualisieren von Kundeninformationen in einem Datensatz, der als Beispiel während der NetSuite Connector-Erstellung erstellt wurde exemplarische Vorgehensweise. Dieses Beispiel dient nur zu Demonstrationszwecken und deckt nicht alle im Produkt verfügbaren Optionen ab. Weitere Informationen finden Sie unter Design Studio für eine ausführlichere Dokumentation.

Die folgenden Abschnitte gliedern sich in das Starten der Upsert-Aktivität, das Definieren der Operation und das Bereitstellen und Ausführen der Operation.

Erstellen eines NetSuite Upsert-Operation

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

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

2. Der Endpoint-Bildschirm des NetSuite Upsert Wizard sollte in der Hauptansicht von Studio geöffnet werden. In diesem Bildschirm werden Sie aufgefordert, den Endpoint auszuwählen, in dem Sie neue Daten erstellen oder vorhandene Daten aktualisieren 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 Objekt-Bildschirm des NetSuite Upsert-Assistenten werden Sie aufgefordert, das Objekt auszuwählen, in das Sie Daten einfügen möchten. In diesem Beispiel möchten wir einen neuen Kundendatensatz erstellen und einen vorhandenen Kundendatensatz in Netsuite aktualisieren. Daher 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 das Upsert von Daten innerhalb Ihres verbundenen NetSuite-Kontos ermöglicht. In Studio sollte eine neue Tab mit dem Namen NetSuite Upserts angezeigt werden. Sie können Ihre Upsert-Aktivität hier bei Bedarf umbenennen; im Beispiel heißt unsere „Beispiel NetSuite Upsert-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 Kundendaten in NetSuite aktualisiert.

6. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Upsert-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 Upsert-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.

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 Quelle, Anforderung, 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.

• Quelle: Im Beispiel verwenden wir eine CSV-Datei als Eingabeanforderung, um sowohl einen bestehenden Kunden zu aktualisieren als auch einen neuen Kunden mit den unten angegebenen Feldwerten zu erstellen. Die folgende Tabelle zeigt den Inhalt der Beispieldatei CustomerUpsertRequest.csv.

  ID	Name	Email	Telefon	Adresse	Stadt	Staat	PLZ
  Testkunde 1	Testkunde 1	test1@example.com	1-999-999-9999	1234 Main St.	Denver	CO	80250
  Testkunde 2	Testkunde 2	test2@example.com	1-888-888-8888	1234 Sample Dr.	San Francisco	CA	94101
  Testkunde 3	Testkunde 3	test3@example.com	1-777-777-7777	1234 Example Way	Houston	TX	77001

  Notiz

  Ein NetSuite-Upsert sollte ein ID-Feld enthalten, das der ExternalID des Kunden in NetSuite zugeordnet ist. Wenn neue Datensätze erstellt werden müssen, reicht die Verwendung von InternalID allein nicht aus, da dieses Feld für neue Datensätze in NetSuite noch nicht erstellt wird.

  Notiz

  In der obigen Tabelle wurden Testkunde 1 und Testkunde 2 ursprünglich im NetSuite Connector erstellen erstellt exemplarische Vorgehensweise. Die Telefonnummer für Testkunde 1 wurde dann während des NetSuite Connector-Updates aktualisiert exemplarische Vorgehensweise. Das Beispiel für ein Upsert auf dieser Seite enthält (1) die aktualisierte Telefonnummer für Testkunden 1, sodass dieser Datensatz aktualisiert wird, falls dies noch nicht geschehen ist; andernfalls bleibt er unverändert, (2) eine neu aktualisierte Telefonnummer für Testkunden 2 und (3) einen neuen Kundendatensatz zum Hinzufügen von Testkunde 3.

  Hinweis

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

  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. CustomerUpsertRequest.csv). Als nächstes verwenden wir für dieses Beispiel einen privaten Agenten mit aktivierten lokalen Dateien, 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 Datei abrufen ist „CustomerUpsertRequest.csv“. Wir werden auch die Optionen erweitern und Zeilen ignorieren auf Erste: „1“ setzen, da unsere CSV-Datei eine Header verwendet.

• Ziel: Doppelklicken Sie auf das Symbol Ziel. Im Beispiel zeichnen wir die Antwort von NetSuite in einer CSV-Datei auf, um Informationen über Erfolg/Misserfolg bereitzustellen. Klicken Sie auf die Schaltfläche Neues Ziel erstellen, geben Sie Ihrem Ziel einen Namen (z. B. CustomerUpsertResponse.csv), 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 „CustomerUpsertResponse.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.

• 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 dieselbe Quelldateiformatdefinition aus, die während Erstellen des NetSuite Connectors erstellt wurde (also „Beispiel-Kunden-Flatfile“).

     Oder, wenn Sie von Grund auf neu erstellen, können Sie Neu erstellen auswählen. Dadurch werden zusätzliche Optionen zum Definieren eines neuen Dateiformats geöffnet. Geben Sie einen Namen für das neue Dateiformat an (im Beispiel nennen wir unser Format „Beispiel-Kunden-Flachdatei“). 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 „CustomerUpsertRequest.csv“.

     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

     Ein NetSuite Upsert sollte ein ID-Feld enthalten, das der ExternalID des Kunden in NetSuite zugeordnet ist. Wenn neue Datensätze erstellt werden müssen, reicht die Verwendung von InternalID allein nicht aus, da dieses Feld für neue Datensätze in NetSuite noch nicht erstellt wird.

     Ihre Transformation sollte ungefähr wie unten gezeigt aussehen:

     

• 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 Zieldateiformatdefinition aus, die während Erstellen des NetSuite Connectors erstellt wurde (d. h. „NetSuite Antwortstruktur“).

     Oder, wenn Sie von Grund auf neu erstellen, können Sie Neu erstellen auswählen. Im Beispiel richten wir eine typische Antwortstruktur ein, die die externe ID, den Status und die Nachricht in die Antwort schreibt, damit wir eine Rückmeldung erhalten, wenn der Upsert Operation fehlschlägt. Legen Sie im ersten Bildschirm den Namen des neuen Dateiformats fest (im Beispiel heißt unser Format „NetSuite-Antwortstruktur“) und klicken Sie dann auf die Schaltfläche zum Manuellen Erstellen. Klicken Sie im nächsten Bildschirm auf Neu und fügen Sie drei neue Felder mit den Namen „ExterneID“, „Status“ und „Nachricht“ 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 Zielseiten zu erweitern. In diesem Beispiel fügen wir Scripts hinzu, um die externe ID in NetSuite abzurufen, sodass wir bei einem fehlgeschlagenen Operation nun die ID des fehlgeschlagenen Datensatzes kennen, um das Problem zu fehlerbehebung. Gehen Sie dazu wie folgt vor:

     • Ziehen Sie das Feld „isSuccess“ von der Quellseite in das neue Feld „Status“ auf der Zielseite.

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

       <trans>
       FindByPos(SourceInstanceCount(),jbroot$jbrequest$upsertList$record#.Customer$externalId)
       </trans>
       

       Die Funktion FindByPos findet die Instanz in den anfordernden Daten, die der Antwort entspricht.

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

       <trans>
       SumString(jbroot$jbresponse$upsertListResponse$writeResponseList$writeResponse.status$statusDetail#.message$,"|",true)
       </trans>
       

       Die Funktion SumString verkettet ein Element, das möglicherweise mehr als eine Instanz hat, zu einer einzigen Zeichenfolge.

       !!! note "Notiz" Finden Sie zusätzliche Script, die Sie während Ihrer Transformation verwenden können Mapping oder separat als Scripts unter dem Formel-Generator Abschnitt. Darüber hinaus gibt es mehrere NetSuite-spezifische Funktionen, die in Connector-Funktionen, die für komplexere Zuordnungen oder Scripts verwendet werden können.

     Ihre Transformation sollte ungefähr wie unten gezeigt aussehen:

     

• 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 Upsert-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 Ihrer Zieldatei zugeordnet wurde. Im Beispiel wird die Datei jetzt in „C:\NetSuiteSampleFiles\CustomerUpsertResponse.csv“ erstellt. Da der Operation erfolgreich ausgeführt wurde, sehen wir das ID-Feld gefolgt von einem Status von „1“, was Erfolg anzeigt. Wenn der Operation fehlgeschlagen wäre, würden wir eine „0“ zusammen mit einer dritten Spalte sehen, die die Protokollfehlermeldung anzeigt.

   Externe ID	Status	Nachricht
   Testkunde 1	1
   Testkunde 2	1
   Testkunde 3	1

5. Wenn Sie außerdem Ihr NetSuite-Konto überprüfen, sollten Sie feststellen, dass die Informationen für Testkunde 2 mit der neuen Telefonnummer aktualisiert und der Datensatz für Testkunde 3 erstellt wurde.

   

   Notiz

   Weitere Informationen zum API Aufruf an NetSuite finden Sie im Web Services Usage Log, das in NetSuite unter Setup > Integration > Web Services Usage Log verfügbar ist. Dieses bietet detaillierte Informationen zu Erfolg/Misserfolg sowie zu der Anfrage und Antwort, die an Jitterbit gesendet wurde.