Four51 Connector Löschen im Jitterbit Design Studio

Die Four51-Löschaktivität, die im Four51 Connector verfügbar ist, ermöglicht es Ihnen, vorhandene Daten in Four51 über die OrderCloud API mithilfe von Jitterbit zu löschen.

Diese Seite beschreibt, wie Sie vorhandene Daten in Four51 löschen, anhand eines Beispiels zum Löschen einer vorhandenen Käuferadresse mit Jitterbit.

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

Erstellen einer Four51-Löschoperation

1. Innerhalb Ihres Projekts in Jitterbit Studio gibt es mehrere Möglichkeiten, eine neue Four51-Löschaktivität zu beginnen. Jede der folgenden Optionen startet den Four51 Löschen-Assistenten, der Sie durch den Prozess führt.

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

2. Der Endpoint-Bildschirm des Four51 Delete Wizard sollte in der Hauptansicht von Studio geöffnet werden. Dieser Bildschirm fordert dazu auf, den Endpoint auszuwählen, in dem Sie vorhandene Daten löschen möchten. Sie sollten Ihren Endpoint bereits im Four51 connector endpoint eingerichtet haben. Verwenden Sie das Dropdown-Menü, um den entsprechenden Endpoint auszuwählen. Klicken Sie auf Weiter, wenn Sie fertig sind.

   

3. Die nächsten Bildschirme im Four51 Delete Wizard helfen Ihnen, zu dem spezifischen Objekt zu gelangen, in dem Sie Daten erstellen möchten. Der erste dieser Bildschirme, Section, fordert Sie auf, eine der aufgeführten obersten Kategorien innerhalb von Four51 auszuwählen: "Authentication", "Buyer", "Ordering", "Organization" oder "UserPerspective".

   Hinweis

   Sie können herausfinden, welche Auswahl zu treffen ist, indem Sie auf die OrderCloud API verweisen. Zum Beispiel entsprechen diese fünf obersten Kategorien direkt denen, die auf der linken Seite der OrderCloud API Console aufgeführt sind. Die verbleibenden Auswahlbildschirme für Objekte folgen ebenfalls der Organisation der OrderCloud API.

   Im Beispiel möchten wir eine vorhandene Käuferadresse löschen, also wählen wir den Abschnitt "Buyer" aus und klicken auf Weiter, um fortzufahren.

   

4. Der nächste Bildschirm im Four51 Delete Wizard, genannt Resource, zeigt die innerhalb des ausgewählten Abschnitts verfügbaren Ressourcen an. Im Beispiel, da wir eine vorhandene Adresse löschen möchten, wählen wir "Addresses" aus und klicken auf Weiter, um fortzufahren.

   

5. Der letzte Auswahlbildschirm im Four51 Delete Wizard, genannt Resource Endpoint, zeigt die endgültigen Objekte an, die für die ausgewählte Ressource verfügbar sind. Im Beispiel, um eine vorhandene Adresse zu löschen, wählen wir die Option "Delete Address" aus. Klicken Sie auf Fertigstellen, um fortzufahren.

   Hinweis

   Die verfügbaren Ressourcenendpunkte für jede Abschnittsressource hängen von der Art der für die Operation ausgewählten Four51-Aktivität ab (d.h. erstellen, lesen, aktualisieren, Patch-Aktualisierung oder löschen).

   

6. Jitterbit wird dann mit der Erstellung einer API-Anforderungs- und -Antwortstruktur fortfahren, die es ermöglicht, Daten über die OrderCloud-API zu löschen. Ein neuer Tab sollte in Studio erscheinen, der Four51 Delete Activities heißt. Sie können Ihre Löschaktivität hier nach Wunsch umbenennen; in unserem Beispiel heißt sie "Four51 Delete - Buyer > Addresses > Delete Address." Sie können auch die + - Schaltflächen oder Pfeile verwenden, um alle Elemente innerhalb jeder Struktur zu erweitern.

   

7. 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 eine vorhandene Käuferadresse in Four51 löscht.

8. Ein neuer Tab sollte in Studio geöffnet werden, der Operations heißt und eine grafische Darstellung der Löschaktivitä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 Operations-Tab 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 Source, Request, Response und Target.

Sie können entweder zur grafischen Darstellung der von Ihnen erstellten Operation zurückkehren und auf jedes Symbol doppelklicken, um jede Komponente zu konfigurieren, oder Sie können 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.

Viele verschiedene Datentypen 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: Um dieses Beispiel zu vereinfachen, wird die Quelle fest codiert. Daher entfernen wir die Quelle, indem wir mit der rechten Maustaste auf das Quellsymbol im Vorgangsdiagramm klicken und Aus dem Diagramm entfernen auswählen.

  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 der OrderCloud-API in eine temporäre Textdatei aufzeichnen, um Informationen über Erfolg/Misserfolg bereitzustellen. Klicken Sie auf die Schaltfläche Neues Ziel erstellen, geben Sie Ihrem Ziel einen Namen (z. B. 'Delete Target'). Als Nächstes möchten wir in diesem Beispiel in den standardmäßigen temporären Speicherort auf unserem privaten Agenten schreiben, also wählen wir einen Typ von "Temporärer Speicher" und geben einen Dateinamen von 'Delete_File.txt' für das Beispiel ein.

  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

  Weitere 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 die Quelle für die Transformation auszuwählen. In diesem Beispiel ist unsere Quelle fest codiert, also wählen wir "Keine." Klicken Sie auf Fertigstellen, um fortzufahren.

  2. Der Tab Transformationen sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Elemente im Zielbaum auf der rechten Seite zu erweitern. In einer Standardtransformation würden Sie jedes Feld, das Sie zuordnen möchten, von einem Baum in den anderen ziehen und ablegen. In diesem Beispiel, um die Quelle fest zu codieren, doppelklicken Sie auf jedes Feld auf der Zielseite und geben Sie die folgenden Werte, die im Beispiel verwendet werden, in das Skript ein:

     ZIEL: EINGABE > CreateorUpdateAddress > Parameter	Skript
     buyerID	<trans> "TestBuyerID0001" </trans>
     addressID	<trans> "TestAddressID0000" </trans>

     Hinweis

     Der oben angegebene buyerID ist die bestehende ID der Käuferorganisation, zu der die Adresse gehört, und die oben angegebene addressID ist die bestehende ID der neuen Adresse, die während des Four51-Connector-Erstellens Beispiels erstellt wurde.

     Nachdem Sie den Quellcode fest codiert haben, sollte Ihre Transformationszuordnung ähnlich aussehen wie unten gezeigt.

• Antwort: Doppelklicken Sie auf das Antwort-Symbol und wählen Sie Neue Transformation erstellen. Dies öffnet den Transformationsassistenten, der Sie durch die Erstellung der Antwort führt.

  Hinweis

  Zusätzliche Informationen zu Antwortstrukturen 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ü Ziel, um das Ziel für die Transformation auszuwählen. Im Beispiel möchten wir die Antwort von der OrderCloud-API verwenden, also wählen wir "Four51-Funktionsantwort." Klicken Sie auf Weiter, um fortzufahren.

  2. Wählen Sie auf dem nächsten Bildschirm Ziel die Optionsschaltfläche für die Art der Aktivität, von der Sie die Antwort verwenden möchten. In diesem Fall möchten wir die Antwort von der Löschaktivität verwenden, die wir gerade eingerichtet haben, also wählen Sie "Erstellen." Klicken Sie auf Weiter, um fortzufahren.

  3. Der Bildschirm Ziel zeigt jetzt ein Dropdown-Menü zur Auswahl der Aktivität an. Wählen Sie die Löschaktivität aus, die Sie gerade eingerichtet haben. Die zugehörigen Anforderungs- und Antwortstrukturen der ausgewählten Löschaktivität sollten jetzt angezeigt werden. Klicken Sie auf Fertigstellen, um fortzufahren.

  4. Der Transformations-Tab sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Quell- und Zielseiten zu erweitern. Klicken und ziehen Sie den "OUTPUT"-Ordner von der linken Seite (Quellseite) zum "OUTPUT"-Ordner auf der rechten Seite (Zielseite). Ihr Zuordnungsbildschirm sollte jetzt ähnlich wie unten aussehen.

     

Ihre konfigurierte Operation sollte ähnlich wie das unten gezeigte Beispiel aussehen.

Bereitstellen und Ausführen der Operation

Mit der vollständig konfigurierten Four51-Löschaktivität sind wir bereit, die Operation bereitzustellen und auszuführen.

1. Klicken Sie im Operations-Tab 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 Operation Monitor anzeigen, dass Ihre Operation erfolgreich ausgeführt wurde. Andernfalls können Sie auf das Status-Symbol doppelklicken, um alle Protokollnachrichten anzuzeigen. [Screenshot hier einfügen]

4. Sie sollten jetzt auch die Ausgabereaktion sehen, die Ihrer Zieldatei 'Delete_File.txt' zugeordnet wurde. Im Beispiel wird die Datei jetzt im temporären Speicher auf dem privaten Agenten erstellt (d.h. standardmäßig '/tmp/jitterbit/TemporaryStorage' für Linux oder 'C:\Windows\Temp\Jitterbit\' für Windows). Der Status '1' zeigt an, dass die Operation erfolgreich war.

   <ns:OUTPUT xmlns:ns="urn:F51oln-res:document:F51oln:oln:entities">
       <DeleteAddress>
           <Status>1</Status>
       </DeleteAddress>
   </ns:OUTPUT>
   

5. Wenn Sie außerdem die OrderCloud API-Konsole unter Buyer > Addresses überprüfen, sollten Sie feststellen, dass die Käuferadresse nicht mehr existiert.

   

   Beachten Sie, dass nur die Käuferadresse gelöscht wurde, nicht der Käufer. Wenn Sie Ihre Käufer unter Organization > Buyers überprüfen, werden Sie den bestehenden Käufer weiterhin finden.