QuickBooks Konnektor Aktivitäten im Jitterbit Design Studio löschen

Bevor Sie QuickBooks Daten aus Jitterbit löschen können, müssen Sie einen QuickBooks Endpoint in Jitterbit Studio erstellt haben (siehe QuickBooks-Connector OAuth 1.0a - Endpoint erstellen oder QuickBooks Connector 2.0 - Endpoint erstellen. Jetzt, da Jitterbit Zugriff auf Ihre QuickBooks Online-Instanz hat, können Sie vier Hauptaktivitäten mit Ihren QuickBooks Daten durchführen: Abfragen, Erstellen, Aktualisieren oder Löschen.

Auf dieser Seite geht es um das Löschen von QuickBooks-Daten. Als Beispiel wird das Löschen eines Lieferantenguthabens mit einer bestimmten ID in QuickBooks über eine XML-Datei über Jitterbit verwendet. Diese Schritte sind unterteilt in das Starten der Löschaktivität, das Definieren der Operationskomponenten und das Bereitstellen und Ausführen der Operation.

Wenn Sie Daten löschen möchten, die mit einer bestimmten Komponente verknüpft sind, für die die Löschaktivität nicht zulässig ist, können Sie als Workaround eine Aktualisierungsaktivität ausführen und sparse="0" festlegen, um alle Felder auf Null zu setzen. Weitere Informationen finden Sie unter QuickBooks-Connector - Aktualisierungsaktivitäten.

Erstellen eines QuickBooks Operation

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

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

2. Der Endpoint-Bildschirm des QuickBooks Löschassistenten fordert Sie auf, den Endpoint auszuwählen, von dem Sie Daten löschen möchten. Sie sollten bereits Endpoints in QuickBooks-Connector OAuth 1.0a - Endpoint erstellen eingerichtet haben oder QuickBooks Connector 2.0 - Endpoint erstellen. Wählen Sie den entsprechenden Endpoint aus, z. B. einen Sandbox- oder Endpoint. Klicken Sie nach Abschluss auf Weiter.

   Notiz

   Das in dieser Dokumentation verwendete Beispiel löscht einen Lieferantenkredit für einen bestimmten Kunden in einem QuickBooks Sandbox-Konto. Zur weiteren Bezugnahme können Sie auch die im Jitterpak bereitgestellten Beispiele zum Erstellen und Aktualisieren von Lieferantenkrediten befolgen.

   

3. Der Objekt-Bildschirm des QuickBooks Löschassistenten fordert Sie auf, das Objekt auszuwählen, das Sie löschen möchten. In diesem Beispiel haben wir bei der Erstellung der QuickBooks Online-App die Buchhaltungs API verwendet und müssen daher nur ein Objekt auswählen: Buchhaltung. Klicken Sie auf das Objekt und dann auf Weiter, um fortzufahren.

   

4. Der Komponenten-Bildschirm des QuickBooks-Löschassistenten zeigt alle Komponenten an, die mit dem Buchhaltungsobjekt in Ihrer verbundenen QuickBooks-Instanz verknüpft sind. Für die Zwecke dieser exemplarischen Vorgehensweise löschen wir einen vorhandenen Lieferantenkredit und wählen daher die Komponente VendorCredit aus. Klicken Sie dann auf die Schaltfläche Fertigstellen.

   Notiz

   Aufgrund von Einschränkungen durch die QuickBooks-Software können nicht alle dieser Komponenten unbedingt aus Jitterbit gelöscht werden.

5. Jitterbit Studio erstellt dann eine QuickBooks API Anforderungs- und-Antwortstruktur, die die Aktualisierung von Daten innerhalb Ihrer verbundenen QuickBooks Online-Instanz ermöglicht. In Studio sollte eine neue Tab mit dem Namen QuickBooks Löschaktivitäten angezeigt werden. Sie können Ihre Erstellungsaktivität hier bei Bedarf umbenennen; in unserem Beispiel heißt unsere „Customer QuickBooks Delete“.

   Klicken Sie auf das +-Symbol ganz rechts in den Strukturansichten „Anforderung“ und „Antwort“, um alle Elemente innerhalb der jeweiligen Struktur zu erweitern. Wenn nun jede Seite erweitert ist, sollte nun ein Bildschirm angezeigt werden, der dem unten gezeigten Bild ähnelt.

6. 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 Lieferantenkreditdaten in QuickBooks löscht.

7. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Löschaktivität enthält. Speichern Sie Ihre Operation, indem Sie entweder auf das Symbol für eine einzelne Festplatte klicken, um nur diese 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 „Operationen“ und der Titel der Operation verschwinden, da Ihre neue Löschaktivität jetzt erstellt und in Ihrem Projekt gespeichert ist.

Definieren der Operation

Jetzt müssen wir die anderen Komponenten der Operation definieren, die in der grafischen Darstellung erscheinen, einschließlich Quelle, Anforderung, Antwort und Ziel. Für die Zwecke dieser Anleitung stellen wir die folgenden Beispiele als Referenz zur Verfügung: Jitterpak QuickBooksExample.jpk und dazugehörige Dateien QuickBooksSampleRequestFiles.zip.

• Quelle: Im Beispiel ist das folgende XML eine Eingabeanforderung zum Löschen eines vorhandenen Lieferantenkredits mit der angegebenen QuickBooks-ID.

  Notiz

  Es ist wichtig, die in QuickBooks verwendete ID und den SyncToken zu verwenden, um den Datensatz zu verknüpfen, den wir löschen möchten. Beachten Sie, dass „sparse“ auf „0“ gesetzt ist, da wir alle Lieferantenkreditdaten löschen möchten.

  VendorCreditDeleteRequest.xml

  <?xml version="1.0" encoding="utf-8"?>
  <ns:INPUT xmlns:ns="urn:qboln-res:document:qboln:oln:functions">
  <VendorCredit sparse="0">
      <Id>155</Id>
      <SyncToken>1</SyncToken>
  </VendorCredit>
  </ns:INPUT>
  

  Um die XML-Datei zu verwenden, doppelklicken Sie zuerst auf das Quellsymbol und wählen Sie dann einen neuen Quelltyp aus. Für dieses Beispiel verwenden wir einen privaten Agenten mit lokalen Dateien aktiviert, und wählen Sie daher als Typ „Lokale Datei“ aus und navigieren Sie dann zum Speicherort. Wenn Sie die Beispieldateien verwenden, ist der Ordner „C:\projects\quickbooks“ und die Datei abrufen ist „VendorCreditDeleteRequest.xml“.

• Ziel: Doppelklicken Sie auf das Zielsymbol. Im Beispiel geben wir die gelöschten Daten aus QuickBooks in eine XML-Datei aus, um sicherzustellen, dass sie gelöscht wurden. Dazu wählen wir erneut den Typ „Lokale Datei“ und navigieren zu einem Speicherort auf dem privaten Agenten, an dem wir die Daten speichern möchten. Im Beispiel ist der Ordner „C:\projects\quickbooks“ und der Dateiname „VendorCreditDeleteResponse.xml“.

• Anfrage: Doppelklicken Sie auf das Anfragesymbol und wählen Sie Neue Transformation erstellen. Oder klicken Sie auf der Registerkarte QuickBooks Aktivitäten löschen auf die Tab Anfrage erstellen. Dadurch wird der Transformation geöffnet, der Sie durch die Erstellung der Anfrage führt.

  1. Wählen Sie auf dem ersten Bildschirm Name den oben verwendeten Quelltyp aus. Für das Beispiel haben wir XML gewählt. Belassen Sie das Ziel auf der Standardeinstellung.
  2. Wählen Sie auf dem nächsten Bildschirm Quelle die Schaltfläche Vorhandene XML-Struktur auswählen. Wählen Sie in der Dropdown-Liste „QuickBooks Schemas“ aus. Wählen Sie dann „QuickBooksDeleteRequest.xsd“ als Strukturdatei aus. Klicken Sie auf dem nächsten Bildschirm auf Fertigstellen.
  3. Die Tab Transformations sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Klicken Sie auf das + unten auf der Quell- und der Zielseite, um die Elemente in jedem Baum zu erweitern. Klicken Sie dann auf das Symbol „Automatische Zuordnung“, das unter der Zielseite des Baums angezeigt wird: Ihr Mapping-Bildschirm sollte nun ungefähr wie unten aussehen:

• Antwort: Klicken Sie für dieses Beispiel mit der rechten Maustaste auf das Antwortsymbol und wählen Sie Pass-Through. Sie könnten stattdessen eine neue Transformation erstellen und Ihre Felder wie in den Aktivitäten „Erstellen“, „Abfragen“ und „Aktualisieren“ zuordnen.

Bereitstellen und Ausführen der Operation

Nachdem die QuickBooks Löschaktivität vollständig eingerichtet ist, können wir den Vorgang einsetzen und ausführen.

Klicken Sie auf der Tab „Operationen“ auf die Schaltfläche „Bereitstellen“ -Symbol. Klicken Sie dann auf Ausführen , um den Vorgang zur Ausführung in die Warteschlange zu stellen.

Im unteren Teil des Bildschirms sollte der Vorgangsmonitor anzeigen, dass Ihr Vorgang erfolgreich ausgeführt wurde. Wenn nicht, können Sie auf das Statussymbol doppelklicken, um alle Protokollmeldungen anzuzeigen.

Sie sollten jetzt auch die gelöschten Daten aus der QuickBooks-Ausgabe an das von Ihnen angegebene Ziel sehen. Für das Beispiel wird die Datei jetzt in „C:\projects\quickbooks\VendorCreditDeleteResponse.xml“ erstellt:

Darüber hinaus sollten Sie beim Überprüfen Ihres QuickBooks-Kontos feststellen, dass das angegebene Lieferantenguthaben nicht mehr existiert.