NetSuite Connector-Update im Jitterbit Design Studio

Die NetSuite Updateaktivität ist im NetSuite Connector verfügbar ermöglicht Ihnen die Aktualisierung vorhandener Datensätze in einer verbundenen NetSuite Instanz mithilfe von Jitterbit.

Auf dieser Seite wird die Aktualisierung vorhandener NetSuite Datensätze beschrieben. Als Beispiel wird die Aktualisierung der Telefonnummer eines vorhandenen Kundendatensatzes in NetSuite anhand von Quelldaten verwendet, die in einer CSV-Datei über Jitterbit bereitgestellt werden.

Dieses Beispiel zeigt die Aktualisierung eines Kundendatensatzes, 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 in Design Studio für eine ausführlichere Dokumentation.

Die folgenden Abschnitte gliedern sich in die Schritte „Starten der Aktualisierungsaktivität“, „Definieren der Operation “ und „Ausführen und Ausführen des Operation“.

Erstellen eines NetSuite Operation

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

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

2. Der Endpoint-Bildschirm des NetSuite Update Wizard sollte in der Hauptansicht von Studio geöffnet werden. In diesem Bildschirm werden Sie aufgefordert, den Endpoint auszuwählen, in dem Sie 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 Bildschirm Objekt des NetSuite Update-Assistenten werden Sie aufgefordert, das Objekt auszuwählen, in dem Sie vorhandene Daten aktualisieren möchten. In diesem Beispiel möchten wir 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, mit der vorhandene Daten in Ihrem verbundenen NetSuite-Konto aktualisiert werden können. In Studio sollte eine neue Tab mit dem Namen NetSuite-Updates angezeigt werden. Sie können Ihre Aktualisierungsaktivität hier bei Bedarf umbenennen. Im Beispiel heißt unsere „Beispiel für NetSuite Update-Kunden“. 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 aktualisiert.

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

   

   Notiz

   Die Symbole für Quelle, Anforderung, 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 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 den bestehenden Kunden mit den unten angegebenen Feldwerten zu aktualisieren. Die folgende Tabelle zeigt den Inhalt der Beispieldatei CustomerUpdateRequest.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

  Notiz

  Ein NetSuite Update muss immer entweder (1) ein ID-Feld enthalten, das der ExternalID des Kunden in NetSuite zugeordnet ist, oder (2) die InternalID des Kundendatensatzes in NetSuite. In diesem Beispiel wird die ExternalID verwendet, die während Erstellen des NetSuite Connectors erstellt wurde. Wenn Sie jedoch eine InternalID verwenden möchten, können Sie diese in NetSuite oder in Jitterbit über eine NetSuite Connector-Suche finden.

  Notiz

  Der bestehende Kunde wurde im Beispiel für NetSuite Connector erstellen ursprünglich mit der Telefonnummer 1-111-111-1111 erstellt. In der Quelldatei für den Operation fügen wir die geänderte Telefonnummer zusammen mit den anderen ursprünglichen Feldern ein, da wir dieselbe Dateiformatdefinition verwenden. Sie können die anderen Felder jedoch weglassen, wenn Sie ein neues Dateiformat nur mit diesen Feldern erstellen möchten.

  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. CustomerUpdateRequest.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 Datei abrufen ist „CustomerUpdateRequest.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. CustomerUpdateResponse.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 „CustomerUpdateResponse.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 „CustomerUpdateRequest.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 Update muss immer entweder (1) ein ID-Feld enthalten, das der ExternalID des Kunden in NetSuite zugeordnet ist, oder (2) die InternalID des Kundendatensatzes in NetSuite. In diesem Beispiel wird die ExternalID verwendet, die während der Erstellung des NetSuite-Connectors erstellt wurde Beispiel. Wenn Sie InternalID verwenden würden, würden Sie stattdessen das NetSuite Feld internalId zuordnen.

     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 haben wir eine typische Antwortstruktur eingerichtet, die die externe ID, den Status und die Nachricht in die Antwort schreibt, damit wir eine Rückmeldung erhalten, wenn der 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$updateList$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$updateListResponse$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 Aktualisierungsaktivitä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\CustomerUpdateResponse.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

5. Wenn Sie außerdem Ihr NetSuite-Konto überprüfen, sollten Sie feststellen, dass die Kundeninformationen mit der neuen Telefonnummer aktualisiert wurden.

   

   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.