NetSuite-Connector-Update im Jitterbit Design Studio

Die NetSuite-Update-Aktivität, die im NetSuite-Connector verfügbar ist, ermöglicht es Ihnen, vorhandene Datensätze in einer verbundenen NetSuite-Instanz mithilfe von Jitterbit zu aktualisieren.

Diese Seite beschreibt, wie Sie vorhandene NetSuite-Datensätze aktualisieren, indem Sie ein Beispiel zur Aktualisierung der Telefonnummer eines bestehenden Kunden-Datensatzes in NetSuite aus Quelldaten, die in einer CSV-Datei bereitgestellt werden, durch Jitterbit verwenden.

Dieses Beispiel demonstriert ein Update eines Kunden-Datensatzes, der als Beispiel während des NetSuite-Connector-Erstellens Walkthroughs erstellt 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 unterteilt in den Beginn der Update-Aktivität, die Definition der Betriebsbestandteile sowie die Bereitstellung und Ausführung der Operation.

Erstellung einer NetSuite-Update-Operation

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

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

2. Der Bildschirm Endpoint des NetSuite Update Wizard sollte in der Hauptansicht von Studio geöffnet werden. Dieser Bildschirm fordert Sie auf, den Endpunkt auszuwählen, in dem Sie vorhandene Daten aktualisieren möchten. Sie sollten Ihren Endpunkt bereits in 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 Update Wizard fordert Sie auf, das Objekt auszuwählen, in dem Sie vorhandene Daten aktualisieren möchten. In diesem Beispiel möchten wir 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 es ermöglicht, vorhandene Daten in Ihrem verbundenen NetSuite-Konto zu aktualisieren. Ein neuer Tab sollte in Studio erscheinen, der NetSuite Updates heißt. Sie können Ihre Aktualisierungsaktivität hier nach Belieben umbenennen; in unserem Beispiel heißt sie "Beispiel NetSuite Update 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 Create Operation, die sich unter Use in an Integration in der oberen rechten Ecke befindet. Dies wird die Jitterbit-Operation erstellen, die vorhandene Kundendaten in NetSuite aktualisiert.

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

   

   Hinweis

   Die Symbole für Source, Request, Response und Target 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 Operations und der Titel der Operation verschwinden, da Ihre neue Aktualisierungsaktivitä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 Source, Request, Response und Target.

Für jede Komponente 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 Source, Request, Response und Target separat erstellen und sie dann aus dem Baum auf der linken Seite direkt auf die Symbole in der visuellen Darstellung Ihrer Operation ziehen und ablegen.

Für die Zwecke dieses Walkthroughs stellen wir die folgenden Beispiele zur Referenz bereit: 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 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	Bundesstaat	PLZ
  Test Cust 1	Test Customer 1	test1@example.com	1-999-999-9999	1234 Main St.	Denver	CO	80250

  Hinweis

  Ein NetSuite-Update muss immer entweder (1) ein ID-Feld enthalten, das auf die Kunden-ExternalID in NetSuite verweist, oder (2) die InternalID des Kundenrekords in NetSuite. Dieses Beispiel verwendet die ExternalID, die während der NetSuite connector create erstellt wurde. Wenn Sie jedoch eine InternalID verwenden möchten, können Sie diese innerhalb von NetSuite oder innerhalb von Jitterbit über eine NetSuite connector search finden.

  Hinweis

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

  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 Neue Quelle erstellen und geben Sie Ihrer Quelle einen Namen (z. B. CustomerUpdateRequest.csv). Als Nächstes verwenden wir in diesem Beispiel 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 'CustomerUpdateRequest.csv'. Wir werden auch die Optionen erweitern und Ignoriere Zeilen auf Erste: '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 Neue Ziel erstellen, geben Sie Ihrem Ziel einen Namen (z. B. CustomerUpdateResponse.csv) und wählen Sie erneut einen Typ von "Lokale Datei" 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 'CustomerUpdateResponse.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 Neue Transformation erstellen. Dies öffnet den Transformationsassistenten, der Sie durch die Erstellung der Anfrage führt.

  Hinweis

  Zusätzliche Informationen zu Anforderungsstrukturen finden Sie unter Transformationen.

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

  2. Auf dem nächsten Bildschirm, Source, verwenden Sie das Dropdown-Menü Available File Format Definitions, um dieselbe Quell-Dateiformatdefinition auszuwählen, die während der NetSuite connector create erstellt wurde (d.h. "Beispiel Kunden-Flat-Datei").

     Oder, wenn Sie von Grund auf neu erstellen, können Sie Create New 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 Create From File und durchsuchen Sie im Popup die lokale Datei 'CustomerUpdateRequest.csv'.

     Klicken Sie auf Finish, um fortzufahren.

  3. Der Tab Transformations 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-Update muss immer entweder (1) ein ID-Feld enthalten, das auf die Kunden-ExternalID in NetSuite abgebildet ist, oder (2) die InternalID des Kundenrekords in NetSuite. Dieses Beispiel verwendet die ExternalID, die während des NetSuite connector create Beispiels erstellt wurde. Wenn Sie die InternalID verwenden würden, würden Sie stattdessen auf das NetSuite internalId-Feld abbilden.

     Ihre Transformationszuordnung sollte ähnlich aussehen wie unten gezeigt:

     

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

  Hinweis

  Zusätzliche Informationen zu Antwortstrukturen finden Sie unter Transformations.

  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ü Target, um den Zieltyp auszuwählen. Für das Beispiel haben wir eine CSV-Datei verwendet, die als "Text" betrachtet wird. Klicken Sie auf Next, 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, sodass wir Feedback erhalten, wenn der Aktualisierungsvorgang 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, sodass wir, falls der Vorgang fehlschlägt, nun 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 in das Skript ein, und klicken Sie dann 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 das Feld "Message" auf der Zielseite, um den Formel-Builder zu öffnen, und fügen Sie die folgenden Funktionen in das Skript ein, und klicken Sie dann auf OK.

       <trans>
       SumString(jbroot$jbresponse$updateListResponse$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 finden zusätzliche Skriptfunktionen, 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-Update-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 Ausgabereaktion sehen, die auf Ihre Zieldatei abgebildet wurde. Im Beispiel wurde die Datei jetzt in 'C:\NetSuiteSampleFiles\CustomerUpdateResponse.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

5. Darüber hinaus sollten Sie, wenn Sie Ihr NetSuite-Konto überprüfen, die Kundeninformationen mit der neuen Telefonnummer aktualisiert finden.

   

   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.