NetSuite Connector in Jitterbit Design Studio löschen

Die NetSuite Löschaktivität ist im NetSuite Connector verfügbar ermöglicht Ihnen das Löschen vorhandener Datensätze in einer verbundenen NetSuite Instanz mit Jitterbit.

Auf dieser Seite wird anhand eines einfachen Beispiels mit externen IDs, die in einer CSV-Datei über Jitterbit bereitgestellt werden, beschrieben, wie vorhandene NetSuite-Datensätze nach ID gelöscht werden. Damit ist die Demonstration mit Beispieldatensätzen abgeschlossen, die während der exemplarischen Vorgehensweisen für NetSuite-Connector erstellen erstellt und aktualisiert wurden, NetSuite Konnektor-Update und NetSuite Connector-Upsert.

Die folgenden Abschnitte gliedern sich in das Beginnen der Löschaktivitä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 Löschaktivität zu starten. Jede der folgenden Optionen startet den NetSuite-Löschassistenten, der Sie durch den Vorgang führt.

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

2. Der Endpoint-Bildschirm des NetSuite-Löschassistenten sollte in der Hauptansicht von Studio geöffnet werden. In diesem Bildschirm werden Sie aufgefordert, den Endpoint auszuwählen, von dem Sie Datensätze löschen 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 Fertig, um den Assistenten abzuschließen.

   

3. Jitterbit erstellt dann eine NetSuite API Anforderungs- und Antwortstruktur, die das Löschen von Datensätzen innerhalb Ihres verbundenen NetSuite-Kontos ermöglicht. In Studio sollte eine neue Tab mit dem Namen NetSuite GetLists angezeigt werden. Sie können Ihre GetList-Aktivität hier bei Bedarf umbenennen; im Beispiel heißt unsere „Beispiel NetSuite Löschen“. Sie können auch die + - Schaltflächen oder Pfeile verwenden, um alle Elemente innerhalb jeder Struktur zu erweitern.

   

4. 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 löscht.

5. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Löschaktivitä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 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 Löschaktivitä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 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 vorhandene Kundendatensätze nach ID zu löschen. Diese gleichen IDs wurden ursprünglich während des Beispiels NetSuite create der externen NetSuite-ID zugeordnet, aktualisieren und upsert Operationen.

  Notiz

  NetSuite Delete unterstützt das Löschen von Objektdaten entweder nach ExternalID oder InternalID.

  Für dieses Beispiel verwenden wir die gleiche Quelle, die im NetSuite Connector GetList erstellt wurde Beispiel. Wenn Sie dieser Schritt-für-Schritt-Anleitung gefolgt sind, doppelklicken Sie zur Verwendung derselben CSV-Datei auf das Symbol Quelle und wählen Sie die vorhandene Quelle CustomerGetListRequest.csv aus.

  Wenn Sie von Grund auf neu erstellen, 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. CustomerDeleteRequest.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 Abrufdateien sind „CustomerGetListRequest.csv“. Wir werden auch die Optionen erweitern und Zeilen ignorieren auf Erste: „1“ setzen, da unsere CSV-Datei eine Header verwendet.

  Hinweis

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

• Ziel: Doppelklicken Sie auf das Ziel-Symbol. Im Beispiel zeichnen wir die Antwort von NetSuite in einer XML-Datei auf. Klicken Sie auf die Schaltfläche Neues Ziel erstellen, geben Sie Ihrem Ziel einen Namen (z. B. CustomerDeleteResponse.xml), 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 „CustomerDeleteResponse.xml“.

  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 die vorhandene Definition „Nur Beispiel-Kunden-Flatfile-ID“ aus, die im NetSuite-Connector GetList erstellt wurde Beispiel.

     Wenn Sie von Grund auf neu erstellen, wählen Sie im Dropdown-Menü Verfügbare Dateiformatdefinitionen die Option 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 „Nur Beispiel für Kunden-Flatfile-ID“). 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 „CustomerGetListRequest.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. In diesem Fall wird die in unserer CSV-Datei angegebene ID dem Feld „externalId“ in NetSuite zugeordnet.

     Als nächstes müssen wir das Objekt für das Löschen definieren. Doppelklicken Sie dazu auf das Feld „Typ“ unter „externalId“ und geben Sie „Kunde“ in Anführungszeichen in den Formel-Generator ein, um die mit den angegebenen IDs verknüpften Kundendatensätze zu löschen:

     <trans>
     "customer"
     </trans>
     

     Notiz

     Die unterstützten Typen, die mit einem NetSuite Operation gelöscht werden können, werden angezeigt, wenn Sie den Mauszeiger über „Typ“ bewegen.

     

     Ihre endgültige Transformation sollte ungefähr wie die unten gezeigte aussehen:

• Antwort: Klicken Sie mit der rechten Maustaste auf das Antwort-Symbol und wählen Sie Pass-Through. Dadurch können wir alle mit den gelöschten Datensätzen verknüpften Daten an die Ausgabedatei weitergeben.

• 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 Löschaktivitä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 an Ihre Zieldatei weitergeleitet wurde. Im Beispiel wird die Datei jetzt in „C:\NetSuiteSampleFiles\CustomerDeleteResponse.xml“ erstellt. Die Datei sollte alle Daten zu den nach ID gelöschten Kundendatensätzen enthalten.

5. Wenn Sie außerdem Ihr NetSuite-Konto überprüfen, sollten Sie feststellen, dass die gelöschten Kundendatensätze nicht mehr vorhanden sind.

   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.