Zum Inhalt springen

Four51 -Anschluss im Jitterbit Design Studio löschen

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

Notiz

Bevor Sie einen Four51 Operation einrichten, müssen Sie einen Four51 Endpoint definieren. Weitere Informationen zum Erstellen eines Endpoint finden Sie unter Four51 -Connector-Endpoint.

Auf dieser Seite wird am Beispiel des Löschens einer vorhandenen Käuferadresse mit Jitterbit beschrieben, wie vorhandene Daten in Four51 gelöscht werden.

Wichtig

Dieses Beispiel dient nur zu Demonstrationszwecken und deckt nicht alle im Produkt verfügbaren Optionen ab; siehe Design Studio für eine ausführlichere Dokumentation.

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 Four51 Operation

Hinweis

Wenn Sie noch nicht mit Jitterbit vertraut sind, lesen Sie Erste Schritte oder Design Studio für detaillierte Informationen zur Verwendung des Produkts.

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

    • Gehen Sie zu Datei > Neu > Anschlüsse > Neu Four51 Löschen.
    • Klicken Sie im Baum links unter Konnektoren mit der rechten Maustaste auf die Kategorie Four51 und wählen Sie dann Neu Four51 Löschen.
    • Doppelklicken Sie im Baum links unter Konnektoren auf die Kategorie Four51, klicken Sie dann mit der rechten Maustaste auf Four51 -Löschaktivitäten und wählen Sie Neues Four51 Löschen.
    • Klicken Sie in der oberen Symbolleiste auf das Verbindungssymbol (orangefarbenes Puzzleteil) Anhang. Wählen Sie im Popup Four51 und dann Four51 Löschen aus.
  2. Der Endpoint-Bildschirm des Four51 -Löschassistenten sollte in der Hauptansicht von Studio geöffnet werden. In diesem Bildschirm werden Sie aufgefordert, den Endpoint auszuwählen, in dem Sie vorhandene Daten löschen möchten. Sie sollten Ihren Endpoint bereits in Four51 -Connector-Endpoint eingerichtet haben. Verwenden Sie das Dropdown-Menü, um den entsprechenden Endpoint auszuwählen. Klicken Sie auf Weiter, wenn Sie fertig sind.

    Anhang

  3. Die nächsten Bildschirme im Four51 Löschassistent helfen Ihnen dabei, zu dem spezifischen Objekt zu gelangen, in dem Sie Daten erstellen möchten. Der erste dieser Bildschirme, Abschnitt, fordert Sie auf, eine der aufgelisteten Kategorien der obersten Ebene in Four51 auszuwählen: „Authentifizierung“, „Käufer“, „Bestellung“, „Organisation“ oder „Benutzerperspektive“.

    Notiz

    Sie können herausfinden, welche Auswahl Sie treffen müssen, indem Sie auf die OrderCloud API verweisen. Beispielsweise entsprechen diese fünf Kategorien der obersten Ebene direkt denen, die auf der linken Seite der OrderCloud API Konsole aufgeführt sind. Auch die restlichen Objektauswahlbildschirme folgen der Organisation der OrderCloud API.

    Im Beispiel möchten wir eine bestehende Käuferadresse löschen, daher wählen wir den Bereich „Käufer“ aus und klicken auf Weiter, um fortzufahren.

    Anhang

  4. Der nächste Bildschirm im Four51 Delete Wizard, genannt Ressource, zeigt die Ressourcen an, die im ausgewählten Abschnitt verfügbar sind. Da wir im Beispiel eine vorhandene Adresse löschen möchten, wählen wir „Adressen“ aus und klicken auf Weiter, um fortzufahren.

    Anhang

  5. Der letzte Auswahlbildschirm im Four51 Delete Wizard, genannt Resource Endpoint, zeigt die letzten für die ausgewählte Ressource verfügbaren Objekte an. Im Beispiel wählen wir zum Löschen einer vorhandenen Adresse die Option „Adresse löschen“. Klicken Sie auf Fertig, um fortzufahren.

    Notiz

    Die für jede Abschnittsressource verfügbaren Endpoints hängen von der Art der für den Operation ausgewählten Four51 Aktivität ab (d. h. Erstellen, Lesen, Aktualisieren, Patch-Update oder Löschen).

    Anhang

  6. Jitterbit erstellt dann eine API Anforderungs- und Antwortstruktur, die das Löschen von Daten über die OrderCloud API ermöglicht. In Studio sollte eine neue Tab mit dem Namen Four51 Delete Activities angezeigt werden. Sie können Ihre Löschaktivität hier bei Bedarf umbenennen. Im Beispiel heißt unsere „Four51 Delete - Buyer > Addresses > Delete Address“. Sie können auch die Schaltflächen + - oder Pfeile verwenden, um alle Elemente innerhalb jeder Struktur zu erweitern.

    Anhang

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

  8. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Löschaktivität enthält.

    Anhang

    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.

Sie können entweder zur grafischen Darstellung der von Ihnen erstellten Operation zurückkehren und auf jedes Symbol doppelklicken, um die einzelnen Komponenten zu konfigurieren, oder Sie können Quelle, Anforderung, Antwort und Ziel separat erstellen und diese dann per Drag & Drop aus der Baumstruktur auf der linken Seite direkt auf die Symbole in der visuellen Darstellung Ihrer Operation ziehen.

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

    Hinweis

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

  • Ziel: Doppelklicken Sie auf das Symbol Ziel. Im Beispiel zeichnen wir die Antwort der OrderCloud-API in einer temporären Textdatei auf, um Informationen über Erfolg/Misserfolg bereitzustellen. Klicken Sie auf die Schaltfläche Neues Ziel erstellen und geben Sie Ihrem Ziel einen Namen (z. B. „Ziel löschen“). Als Nächstes möchten wir für dieses Beispiel in den standardmäßigen temporären Speicherort auf unserem privaten Agenten schreiben, also wählen wir einen Typ „Temporärer Speicher“ und geben einen Dateinamen von „Delete_File.txt“ für das Beispiel ein.

    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 den Standardwert. Verwenden Sie dann das Dropdown-Menü Quelle, um die Quelle für die Transformation auszuwählen. Im Beispiel ist unsere Quelle fest codiert, daher wählen wir „Keine“ aus. Klicken Sie auf Fertig, um fortzufahren.

    2. Die Tab Transformations sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Elemente im Zielbaum rechts zu erweitern. Bei einer Transformation würden Sie jedes Feld, das Sie zuordnen möchten, per Drag & Drop von einem Baum zum anderen ziehen. Um in diesem Beispiel die Quelle hart zu codieren, doppelklicken Sie auf jedes Feld auf der Zielseite und geben Sie die folgenden im Beispiel verwendeten Werte in das Script ein:

      ZIEL: INPUT > CreateorUpdateAddress > Parameter Script
      Käufer-ID <trans>
      "TestBuyerID0001"
      </trans>
      Adress-ID <trans>
      "TestAddressID0000"
      </trans>

      Notiz

      Die obige Käufer-ID ist die vorhandene ID der Käuferorganisation, zu der sich die Adresse gehört, und die obige Adress-ID ist die vorhandene ID der neuen Adresse, die während der Erstellung des Four51 Connectors erstellt wurde Beispiel.

      Nach dem Festcodieren der Quelle sollte Ihre Transformation ungefähr wie unten gezeigt aussehen.Anhang

  • Antwort: Doppelklicken Sie auf das Symbol Antwort und wählen Sie Neue Transformation erstellen. Dadurch wird der Transformation geöffnet, der Sie durch die Erstellung der Antwort führt.

    Notiz

    Weitere Informationen zu Antwortstrukturen finden Sie unter Transformations.

    1. Geben Sie auf dem ersten Bildschirm Name einen Namen für Ihre Transformation ein oder belassen Sie ihn beim Standard. Verwenden Sie dann das Dropdown-Menü Ziel, um das Ziel für die Transformation auszuwählen. Im Beispiel möchten wir die Antwort der OrderCloud-API verwenden, also wählen wir „Four51 -Funktionsantwort“ aus. Klicken Sie auf Weiter, um fortzufahren.

    2. Wählen Sie auf dem nächsten Bildschirm Ziel das Optionsfeld für den Aktivitätstyp aus, dessen Antwort Sie verwenden möchten. In diesem Fall möchten wir die Antwort der Löschaktivität verwenden, die wir gerade eingerichtet haben. Wählen Sie daher „Erstellen“. Klicken Sie auf Weiter, um fortzufahren.

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

    4. Die Tab Transformations sollte sich öffnen, wo Sie Ihr Mapping abschließen können. Verwenden Sie das +, um die Quell- und Zielseiten zu erweitern. Klicken Sie auf den Ordner „OUTPUT“ und ziehen Sie ihn von der linken Seite (Quellseite) in den Ordner „OUTPUT“ auf der rechten Seite (Zielseite). Ihr Mapping-Bildschirm sollte nun ungefähr wie unten aussehen.

      Anhang

Ihr konfigurierter Operation sollte dem unten gezeigten Beispiel ähneln.

Anhang

Bereitstellen und Ausführen der Operation

Nachdem die Four51 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 Anhang-Symbol.

  2. Klicken Sie dann auf „Ausführen Anhang, 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. [ Screenshot hier einfügen]

  4. Sie sollten jetzt auch die Ausgabeantwort 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 der 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 Console unter Käufer > Adressen sollten Sie feststellen, dass die Käuferadresse nicht mehr existiert.

    Anhang

    Beachten Sie, dass nur die Käuferadresse gelöscht wurde, nicht der Käufer selbst. Wenn Sie Ihre Käufer unter Organisation > Käufer überprüfen, finden Sie den vorhandenen Käufer immer noch.

    Anhang