NetSuite-Connector Löschen im Jitterbit Design Studio

Die Löschaktivität für NetSuite, die im NetSuite-Connector verfügbar ist, ermöglicht es Ihnen, vorhandene Datensätze in einer verbundenen NetSuite-Instanz mithilfe von Jitterbit zu löschen.

Diese Seite beschreibt, wie Sie vorhandene NetSuite-Datensätze anhand der ID mithilfe eines einfachen Beispiels mit externen IDs, die in einer CSV-Datei über Jitterbit bereitgestellt werden, löschen können. Dies vervollständigt die Demonstration mit Beispiel-Datensätzen, die während der Durchgänge für NetSuite-Connector erstellen, NetSuite-Connector aktualisieren und NetSuite-Connector upsert erstellt und aktualisiert wurden.

Die folgenden Abschnitte sind unterteilt in den Beginn der Löschaktivität, die Definition der Betriebsbestandteile sowie das Bereitstellen und Ausführen der Operation.

Erstellen einer NetSuite-Löschoperation

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

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

2. Der Bildschirm Endpoint des NetSuite Delete Wizard sollte in der Hauptansicht von Studio geöffnet werden. Dieser Bildschirm fordert Sie auf, den Endpunkt auszuwählen, von dem Sie Datensätze löschen 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 Fertigstellen, um den Wizard abzuschließen.

   

3. Jitterbit wird dann fortfahren, eine NetSuite-API-Anforderungs- und -Antwortstruktur zu erstellen, die es ermöglicht, Datensätze in Ihrem verbundenen NetSuite-Konto zu löschen. Ein neuer Tab sollte in Studio erscheinen, der NetSuite GetLists heißt. Sie können Ihre GetList-Aktivität hier umbenennen, wenn gewünscht; in unserem Beispiel heißt sie "Beispiel NetSuite-Löschung." Sie können auch die + - Schaltflächen oder Pfeile verwenden, um alle Elemente innerhalb jeder Struktur zu erweitern.

   

4. Als Nächstes klicken Sie 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. Ein neuer Tab sollte in Studio mit dem Namen Operationen geöffnet werden, der eine grafische Darstellung der Löschaktivität enthält.

   

   Hinweis

   Die Symbole für Quelle, Anfrage, Antwort und Ziel in der obigen Abbildung 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 mehrfache 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 Löschaktivität jetzt erstellt und in Ihrem Projekt gespeichert ist.

Definieren der Betriebskomponenten

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

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 die Antwort und Ziel separat erstellen und 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 zur Verfügung: Jitterpak NetSuiteExample.jpk und begleitende Dateien in NetSuiteSampleFiles.zip. Viele verschiedene Arten von Daten können für jede Komponente der Operation verwendet werden. Um mehr über zusätzliche Anpassungsoptionen zu erfahren, beziehen Sie sich auf den Abschnitt Design Studio unserer Dokumentation.

• Quelle: In diesem Beispiel verwenden wir eine CSV-Datei als Eingabeanforderung, um vorhandene Kundenaufzeichnungen nach ID zu löschen. Diese IDs wurden ursprünglich während der Beispiel-NetSuite Erstellung, Aktualisierung und Upsert Operationen mit der NetSuite External ID verknüpft.

  Hinweis

  Das Löschen in NetSuite unterstützt die Löschung von Objektdaten entweder nach ExternalID oder InternalID.

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

  Wenn Sie von Grund auf neu erstellen, doppelklicken Sie zuerst auf das Quelle-Symbol, 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 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 'CustomerGetListRequest.csv'. Wir werden auch die Optionen erweitern und Ignoriere Zeilen auf Erste: '1' setzen, da unsere CSV-Datei eine Kopfzeile verwendet.

  Hinweis

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

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

  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 Anfrage-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 Anfrage-Strukturen 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. Wählen Sie auf dem nächsten Bildschirm Quelle im Dropdown-Menü Verfügbare Dateiformatdefinitionen die vorhandene Definition "Beispiel-Kunden-Flachdatei-ID nur" aus, die im Beispiel NetSuite-Connector GetList erstellt wurde.

     Wenn Sie von Grund auf neu erstellen, verwenden Sie das Dropdown-Menü Verfügbare Dateiformatdefinitionen, um Neu erstellen auszuwählen. Dies öffnet zusätzliche Optionen zur Definition eines neuen Dateiformats. Geben Sie einen Namen für das neue Dateiformat an (in unserem Beispiel nennen wir es "Beispiel-Kunden-Flachdatei-ID nur"). Um die Textdefinition basierend auf unserer vorhandenen CSV-Datei zu erstellen, wählen Sie Von Datei erstellen, und durchsuchen Sie im Popup die lokale Datei 'CustomerGetListRequest.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 in den anderen. In diesem Fall wird die ID, die in unserer CSV-Datei bereitgestellt wird, dem Feld 'externalId' in NetSuite zugeordnet.

     Als Nächstes müssen wir das Objekt für das Löschen definieren. Dazu doppelklicken Sie auf das Feld 'type' unter 'externalId' und geben Sie "customer" in doppelte Anführungszeichen in den Formel-Builder ein, um die mit den bereitgestellten IDs verknüpften Kundenaufzeichnungen zu löschen:

<trans>
"customer"
</trans>

Ihre endgültige Transformationszuordnung sollte ähnlich aussehen wie die unten gezeigte:

• 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 verbundenen Daten in die Ausgabedatei übergeben.

• Optionale Skripte: Sie finden zusätzliche Skriptfunktionen, die Sie während Ihrer Transformation Zuordnung oder separat als Skripte im Abschnitt Formel-Builder. Für weitere Informationen siehe NetSuite-Connector erweitert.

Bereitstellen und Ausführen der Operation

Mit der vollständig konfigurierten NetSuite-Löschaktivitä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 Protokollnachrichten anzuzeigen.

4. Sie sollten jetzt auch die Ausgabereaktion sehen, die an Ihre Zieldatei übergeben wurde. Im Beispiel wird die Datei jetzt in 'C:\NetSuiteSampleFiles\CustomerDeleteResponse.xml' erstellt. Die Datei sollte alle Daten zu den gelöschten Kundenaufzeichnungen nach ID enthalten.

5. Darüber hinaus sollten Sie feststellen, dass die gelöschten Kundenakten in Ihrem NetSuite-Konto nicht mehr existieren.

   Hinweis

   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. Dies bietet detaillierte Informationen über Erfolg/Misserfolg sowie die Anfrage und die Antwort, die an Jitterbit gesendet wurde.