NetSuite Connector Erstellen im Jitterbit Design Studio

Die NetSuite Erstellungsaktivität ist im NetSuite Connector verfügbar ermöglicht Ihnen das Erstellen neuer Datensätze in einer verbundenen NetSuite Instanz mit Jitterbit.

Auf dieser Seite wird die Erstellung neuer NetSuite Datensätze anhand eines Beispiels für die Erstellung neuer Kundendatensätze in NetSuite aus Quelldaten beschrieben, die in einer CSV-Datei über Jitterbit bereitgestellt werden.

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 den Beginn der Erstellungsaktivität, das Definieren der Operation und das Bereitstellen und Ausführen des Operation.

Erstellen eines NetSuite Operation

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

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

2. Der Endpoint-Bildschirm des NetSuite Create 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 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-Erstellungsassistenten werden Sie aufgefordert, das Objekt auszuwählen, in dem Sie neue Daten erstellen möchten. In diesem Beispiel möchten wir einen neuen Kundendatensatz in Netsuite erstellen. 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 die Datenerstellung innerhalb Ihres verbundenen NetSuite-Kontos ermöglicht. In Studio sollte eine neue Tab mit dem Namen NetSuite Creates angezeigt werden. Sie können Ihre Erstellungsaktivität hier bei Bedarf umbenennen; im Beispiel heißt unsere „Beispiel NetSuite Create Customer“. 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 neue Kundendaten in NetSuite erstellt.

6. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Erstellungsaktivitä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 Erstellungsaktivitä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 Eingabeaufforderung, um einen neuen Kunden mit den unten angegebenen Feldwerten zu erstellen. Die folgende Tabelle zeigt den Inhalt der Beispieldatei CustomerCreateRequest.csv.

  ID	Name	Email	Telefon	Adresse	Stadt	Staat	PLZ
  Testkunde 1	Testkunde 1	test1@example.com	1-111-111-1111	1234 Main St.	Denver	CO	80250
  Testkunde 2	Testkunde 2	test2@example.com	1-222-222-2222	1234 Sample Dr.	San Francisco	CA	94101

  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. CustomerCreateRequest.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 „CustomerCreateRequest.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. CustomerCreateResponse.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 „CustomerCreateResponse.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 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 „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 „CustomerCreateRequest.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.

     Notiz

     Es wird empfohlen, dem Kundenfeld „externalId“ in NetSuite ein ID-Feld zuzuordnen. Dadurch werden Upserts möglich, falls Sie diese später konfigurieren möchten. Siehe NetSuite Connector Upsert für weitere Einzelheiten.

     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 Neu erstellen aus. 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 Operation fehlschlägt. Legen Sie im ersten Bildschirm den Namen der neuen Datei fest (im Beispiel heißt unsere Datei „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 „Externe ID“, „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$addList$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$addListResponse$writeResponseList$writeResponse.status$statusDetail#.message$,"|",true)
       </trans>
       

       Die Funktion SumString verkettet ein Element, das mehr als eine Instanz haben kann, zu einem einzigen String.

     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 Erstellungsaktivitä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 Ihre 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\CustomerCreateResponse.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

5. Wenn Sie außerdem Ihr NetSuite-Konto überprüfen, sollten Sie die neu erstellten Kunden finden.

   

   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.