NetSuite-Connector Upsert im Jitterbit Design Studio

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

Diese Seite beschreibt, wie Sie vorhandene NetSuite-Datensätze gleichzeitig aktualisieren und neue erstellen, anhand eines Beispiels zur Aktualisierung der Telefonnummer eines bestehenden Kunden und zur Erstellung eines neuen Kunden in NetSuite aus Quelldaten, die in einer CSV-Datei über Jitterbit bereitgestellt werden.

Dieses Beispiel demonstriert die Erstellung eines neuen Kunden und die Aktualisierung von Kundeninformationen in einem Datensatz, der als Beispiel während des NetSuite-Connector-Erstellens durchlaufen wurde. Dieses Beispiel dient nur zu Demonstrationszwecken und deckt nicht alle im Produkt verfügbaren Optionen ab; bitte beziehen Sie sich auf Design Studio für umfassendere Dokumentation.

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

Erstellen einer NetSuite Upsert-Operation

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

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

2. Der Bildschirm Endpoint des NetSuite Upsert Wizard sollte in der Hauptansicht von Studio geöffnet werden. Dieser Bildschirm fordert Sie auf, den Endpunkt auszuwählen, in dem Sie neue Daten erstellen oder vorhandene Daten aktualisieren 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 Upsert Wizard fordert Sie auf, das Objekt auszuwählen, in dem Sie Daten upserten möchten. In diesem Beispiel möchten wir einen neuen Kundenstamm erstellen und einen vorhandenen Kundenstamm in NetSuite aktualisieren, 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.

   

4. Jitterbit wird dann mit der Erstellung einer NetSuite API-Anforderungs- und Antwortstruktur fortfahren, die das Upsert von Daten in Ihrem verbundenen NetSuite-Konto ermöglicht. Ein neuer Tab sollte in Studio erscheinen, der NetSuite Upserts heißt. Sie können Ihre Upsert-Aktivität hier nach Wunsch umbenennen; in unserem Beispiel heißt sie "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 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 Kundendaten in NetSuite upsert.

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

   

   Hinweis

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

   Speichern Sie Ihre Operation, indem Sie entweder auf das einzelne Diskettensymbol klicken, um nur diese Operation zu speichern, oder auf das Mehrfach-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 Upsert-Aktivität jetzt erstellt und in Ihrem Projekt gespeichert ist.

Definieren der Komponenten der Operation

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

Für jede der Komponenten geben die folgenden Anweisungen an, dass Sie zur grafischen Darstellung der von Ihnen erstellten Operation zurückkehren und auf jedes Symbol doppelklicken, um jede Komponente zu konfigurieren. Alternativ könnten Sie auch die Quelle, Anforderung, Antwort und Ziel separat erstellen und sie dann per Drag & Drop aus dem Baum auf der linken Seite direkt auf die Symbole in der visuellen Darstellung Ihrer Operation ziehen.

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

• Quelle: Im Beispiel verwenden wir eine CSV-Datei als Eingabewunsch, 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	Bundesland	PLZ
  Test Cust 1	Test Customer 1	test1@example.com	1-999-999-9999	1234 Main St.	Denver	CO	80250
  Test Cust 2	Test Customer 2	test2@example.com	1-888-888-8888	1234 Sample Dr.	San Francisco	CA	94101
  Test Cust 3	Test Customer 3	test3@example.com	1-777-777-7777	1234 Example Way	Houston	TX	77001

  Hinweis

  Ein NetSuite-Upsert sollte ein ID-Feld enthalten, das auf die Kunden-ExternalID in NetSuite abgebildet ist. Wenn neue Datensätze erstellt werden müssen, reicht es nicht aus, nur die InternalID zu verwenden, da dieses Feld für neue Datensätze in NetSuite noch nicht erstellt wurde.

  Hinweis

  In der obigen Tabelle wurden Test Customer 1 und Test Customer 2 ursprünglich im NetSuite connector create Walkthrough erstellt. Die Telefonnummer von Test Customer 1 wurde dann während des NetSuite connector update Walkthroughs aktualisiert. Das Beispiel für ein Upsert auf dieser Seite umfasst (1) die aktualisierte Telefonnummer für Test Customer 1, sodass dieser Datensatz aktualisiert wird, wenn er noch nicht vorhanden ist; andernfalls bleibt er gleich, (2) eine neu aktualisierte Telefonnummer für Test Customer 2 und (3) einen neuen Kundendatensatz, um Test Customer 3 hinzuzufügen.

  Hinweis

  Eine Vielzahl von Quelltypen ist in Jitterbit verfügbar. Siehe Quellen für weitere Informationen.

  Um die CSV-Datei zu verwenden, doppelklicken Sie zuerst auf das Source-Symbol, klicken Sie dann auf die Schaltfläche Create New Source und geben Sie Ihrer Quelle einen Namen (z. B. CustomerUpsertRequest.csv). Als Nächstes verwenden wir in diesem Beispiel einen privaten Agenten mit lokalen Dateien aktiviert und wählen daher einen Typ von "Local File" 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 'CustomerUpsertRequest.csv'. Wir werden auch die Optionen erweitern und Ignore Lines auf First: '1' setzen, da unsere CSV-Datei eine Kopfzeile verwendet.

• Ziel: Doppelklicken Sie auf das Target-Symbol. Im Beispiel werden wir die Antwort von NetSuite in eine CSV-Datei aufzeichnen, um Informationen über Erfolg/Misserfolg bereitzustellen. Klicken Sie auf die Schaltfläche Create New Target, geben Sie Ihrem Ziel einen Namen (z. B. CustomerUpsertResponse.csv) und wählen Sie erneut einen Typ von "Local File" 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 'CustomerUpsertResponse.csv'.

  Hinweis

  Sie können auch in eine Vielzahl von verschiedenen Zieltypen ausgeben. Der Typ muss nicht derselbe sein wie der Quelltyp. Siehe Ziele für Optionen.

• Anfrage: Doppelklicken Sie auf das Request-Symbol und wählen Sie Create New Transformation. Dies öffnet den Transformation Wizard, der Sie durch die Erstellung der Anfrage führt.

  Hinweis

  Zusätzliche Informationen zu Anforderungsstrukturen finden Sie unter Transformationen.

  1. Auf dem ersten Bildschirm, Name, geben Sie einen Namen für Ihre Transformation an oder lassen Sie ihn als Standard. Verwenden Sie dann das Dropdown-Menü Source, 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 dieselbe Quell-Dateiformatdefinition auszuwählen, die während der NetSuite-Connector-Erstellung erstellt wurde (d.h. "Beispiel-Kunden-Flat-Datei").

     Oder, wenn Sie von Grund auf neu erstellen, können Sie Neu erstellen auswä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-Flat-Datei"). Um die Textdefinition basierend auf unserer vorhandenen CSV-Datei zu erstellen, wählen Sie Aus Datei erstellen, und durchsuchen Sie im Popup die lokale Datei 'CustomerUpsertRequest.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 zum anderen.

     Hinweis

     Ein NetSuite-Upsert sollte ein ID-Feld enthalten, das auf die Kunden-ExternalID in NetSuite abgebildet ist. Wenn neue Datensätze erstellt werden müssen, reicht es nicht aus, nur die InternalID zu verwenden, da dieses Feld für neue Datensätze in NetSuite noch nicht erstellt wurde.

     Ihre Transformationszuordnung sollte ähnlich aussehen wie unten gezeigt:

     

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

  Hinweis

  Weitere Informationen zu Antwortstrukturen finden Sie unter Transformationen.

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

  2. Auf dem nächsten Bildschirm, Ziel, verwenden Sie das Dropdown-Menü Verfügbare Dateiformatdefinitionen, um dieselbe Ziel-Dateiformatdefinition auszuwählen, die während der NetSuite-Connector-Erstellung erstellt wurde (d.h. "NetSuite-Antwortstruktur").

     Oder, wenn Sie von Grund auf neu erstellen, können Sie Neu erstellen auswählen. In dem Beispiel haben wir eine typische Antwortstruktur eingerichtet, die die externe ID, den Status und die Nachricht in die Antwort schreibt, damit wir Feedback erhalten, falls der Upsert-Vorgang fehlschlägt. Setzen Sie im ersten Bildschirm den Namen des neuen Dateiformats (in unserem Beispiel heißt es "NetSuite-Antwortstruktur"), und klicken Sie dann auf die Schaltfläche Manuell erstellen. Klicken Sie im nächsten Bildschirm auf Neu und fügen Sie drei neue Felder mit den Namen "ExternalID", "Status" und "Message" hinzu.

     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 Zielseiten zu erweitern. In diesem Beispiel fügen wir Skripte hinzu, um die externe ID in NetSuite zu erhalten, damit wir, falls der Vorgang fehlschlägt, jetzt die ID des fehlgeschlagenen Datensatzes zur Fehlersuche kennen. Um dies zu tun:

     • Ziehen Sie das Feld "isSuccess" von der Quellseite auf das neue Feld "Status" auf der Zielseite.

     • Doppelklicken Sie auf das Feld "ExternalID" auf der Zielseite, um den Formel-Builder zu öffnen, und fügen Sie die folgenden Funktionen zum Skript hinzu, und klicken Sie dann 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 das Feld "Message" auf der Zielseite, um den Formel-Builder zu öffnen, und fügen Sie die folgenden Funktionen zum Skript hinzu, und klicken Sie dann auf OK.

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

       Die SumString-Funktion wird ein Element, das möglicherweise mehr als eine Instanz hat, zu einem einzigen String verketten.

       Hinweis

       Finden Sie zusätzliche Skriptfunktionen, die Sie während Ihrer Transformation Mapping oder separat als Skripte im Abschnitt Formel-Builder verwenden können. Darüber hinaus gibt es mehrere NetSuite-spezifische Funktionen, die in Connector-Funktionen dokumentiert sind und für komplexere Mappings oder Skripte verwendet werden können.

     Ihr Transformationsmapping sollte ähnlich aussehen wie das unten Gezeigte:

     

• Optionale Skripte: Sie können zusätzliche Skriptfunktionen finden, die Sie während Ihres Transformation Mappings 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

Mit der vollständig konfigurierten NetSuite-Upsert-Aktivität 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 etwaige Protokollnachrichten anzuzeigen.

   

4. Sie sollten jetzt auch die Ausgabenantwort sehen, die auf Ihre Zieldatei abgebildet wurde. Im Beispiel wurde die Datei jetzt in 'C:\NetSuiteSampleFiles\CustomerUpsertResponse.csv' erstellt. Da der Vorgang erfolgreich ausgeführt wurde, sehen wir das ID-Feld gefolgt von einem Status von '1', was Erfolg anzeigt. Wenn der Vorgang fehlgeschlagen wäre, würden wir eine '0' zusammen mit einer dritten Spalte sehen, die die Protokollfehlermeldung anzeigt.

   ExternalID	Status	Message
   Test Cust 1	1
   Test Cust 2	1
   Test Cust 3	1

5. Darüber hinaus sollten Sie, wenn Sie Ihr NetSuite-Konto überprüfen, feststellen, dass die Informationen für Test Customer 2 mit der neuen Telefonnummer aktualisiert wurden und der Datensatz für Test Customer 3 erstellt wurde.

   

   Hinweis

   Sie finden weitere Informationen zum API-Aufruf an NetSuite im Web Services Usage Log, das in NetSuite unter Setup > Integration > Web Services Usage Log verfügbar ist. Dies bietet detaillierte Informationen über Erfolg/Misserfolg sowie die Anfrage und Antwort, die an Jitterbit gesendet wurden.