Clarizen-Connector Löschen im Jitterbit Design Studio

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

Diese Seite beschreibt, wie Sie vorhandene Clarizen-Datensätze löschen, indem ein Beispiel für das Löschen einer vorhandenen Aufgabe nach ID in Clarizen aus Quelldaten bereitgestellt in einer XML-Datei über Jitterbit verwendet wird. Dieses Beispiel löscht dieselbe Beispieldatei, die in den Beispielen Clarizen-Connector erstellen und Clarizen-Connector aktualisieren verwendet wird.

Dieses Beispiel dient nur zu Demonstrationszwecken und deckt nicht alle im Produkt verfügbaren Optionen ab; bitte beziehen Sie sich auf Design Studio für umfassendere Dokumentation.

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 Clarizen-Löschoperation

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

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

2. Der Bildschirm Endpoint des Clarizen 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 Clarizen-Connector-Endpunkt eingerichtet haben. Verwenden Sie das Dropdown-Menü, um den entsprechenden Endpunkt auszuwählen. Klicken Sie auf Weiter, wenn Sie fertig sind.

   

3. Der Bildschirm Objekt des Clarizen Delete Wizard fordert Sie auf, das Objekt auszuwählen, von dem Sie Datensätze löschen möchten. In diesem Beispiel möchten wir eine vorhandene Aufgabe in Clarizen löschen, also wählen wir das Objekt "Aufgabe" aus und klicken dann auf Fertigstellen, um fortzufahren.

   Hinweis

   Wenn Sie viele Objekte in Ihrer Clarizen-Instanz verfügbar haben, müssen Sie möglicherweise einen Moment warten, bis sie geladen sind. Sie können auch einen Objektnamen in das Feld Filter eingeben. Versuchen Sie die Schaltfläche Aktualisieren, wenn die Ergebnisse nicht Ihren Erwartungen entsprechen.

   

4. Jitterbit wird dann mit der Erstellung einer Clarizen API-Anforderungs- und Antwortstruktur fortfahren, die es ermöglicht, Datensätze in Ihrer verbundenen Clarizen-Instanz zu löschen. Ein neuer Tab sollte in Studio erscheinen, der Clarizen Delete Activities heißt. Sie können Ihre Löschaktivität hier nach Wunsch umbenennen; in unserem Beispiel heißt sie "Beispiel Clarizen Löschaufgabe." Sie können auch die + - Schaltflächen oder Pfeile verwenden, um alle Elemente innerhalb jeder Struktur zu erweitern.

   

5. 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 die vorhandene Aufgabe in Clarizen löscht.

6. 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 das einzelne Diskettensymbol klicken, um nur diese Operation zu speichern, oder das mehrfache Diskettensymbol, um alle Änderungen in Ihrem Integrationsprojekt zu speichern. Sie sollten sehen, dass der Stern auf dem Tab Operations und der Titel der Operation verschwinden, da Ihre neue Aktualisierungsaktivitä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.

Für jede der Komponenten 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 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.

Für die Zwecke dieses Walkthroughs stellen wir die folgenden Beispiele zur Referenz zur Verfügung: Jitterpak ClarizenExample.jpk und die dazugehörigen Dateien in ClarizenSampleFiles.zip. Viele verschiedene Arten von Daten können für jede Komponente der Operation verwendet werden. Um mehr über zusätzliche Anpassungsoptionen zu erfahren, siehe den Abschnitt Design Studio unserer Dokumentation.

• Quelle: Im Beispiel verwenden wir eine XML-Datei als Eingabewunsch, um eine vorhandene Aufgabe mit der unten angegebenen ID zu löschen. Eine ID muss in der Quelle für eine Löschaktivität enthalten sein und kann entweder die externe ID oder die interne ID (vollständige ID) im Format /\<object_type>/\<external_id> sein.

  <ns:INPUT xmlns:ns="urn:czoln:document:czoln:oln:entities">
      <Task>
          <id>jw47joqmno25rh7l5azcmo3o26</id>
      </Task>
  </ns:INPUT>
  

  Hinweis

  Eine Clarizen-Löschaktivität muss die interne oder externe ID des Objekts innerhalb von Clarizen verwenden, um das Löschen mit dem richtigen Objekt zu verknüpfen. Die vollständige interne ID von Clarizen enthält den Objektnamen im Format /\<object_type>/\<external_id> (z. B. /Task/jw47joqmno25rh7l5azcmo3o26), während die externe ID von Clarizen standardmäßig nur die ID ist, z. B. jw47joqmno25rh7l5azcmo3o26.

  Hinweis

  Im Beispiel verwenden wir die Clarizen-ID, die in der Antwort von dem Beispiel zurückgegeben wird, das in Clarizen connector create und Clarizen connector update verwendet wird. Wenn Sie dem Beispiel folgen, müssen Sie diese ID durch die spezifische ID der Aufgabe in Ihrer Clarizen-Instanz ersetzen.

  Hinweis

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

  Um die XML-Datei zu verwenden, doppelklicken Sie zunächst auf das Source-Symbol, klicken Sie dann auf die Schaltfläche Create New Source und geben Sie Ihrer Quelle einen Namen (z. B. ClarizenDelete_Task_Request.xml). Als Nächstes verwenden wir für dieses Beispiel einen privaten Agenten mit lokalen Dateien aktiviert und wählen daher einen Typ von "Local File" und klicken dann auf Durchsuchen, um den Speicherort auszuwählen. Wenn Sie die Beispieldateien verwenden, ist der Ordner 'C:\ClarizenSampleFiles' und die Get Files ist 'ClarizenDelete_Task_Request.xml'.

• Ziel: Doppelklicken Sie auf das Ziel-Symbol. Im Beispiel geben wir die ID und den Status in eine XML-Datei aus, um sicherzustellen, dass die Operation erfolgreich war. Klicken Sie auf die Schaltfläche Neues Ziel erstellen, geben Sie Ihrem Ziel einen Namen (z. B. ClarizenDelete_Task_Response.xml) und wählen Sie erneut einen Typ von "Lokale Datei" aus und Durchsuchen Sie einen Speicherort auf dem privaten Agenten, an dem wir die Daten speichern möchten. Im Beispiel ist der Ordner 'C:\ClarizenSampleFiles' und der Dateiname 'ClarizenDelete_Task_Response.xml'.

  Hinweis

  Sie können auch in eine Vielzahl von verschiedenen Zieltypen ausgeben. Der Typ muss nicht der gleiche 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 Anforderungsstrukturen finden Sie unter Transformationen.

  1. Auf dem ersten Bildschirm, Name, geben Sie einen Namen für Ihre Transformation ein oder lassen Sie den Standardwert. Verwenden Sie dann das Dropdown-Menü Quelle, um "Clarizen Funktionsanfrage" auszuwählen. Klicken Sie auf Weiter, um fortzufahren.

  2. Auf dem nächsten Bildschirm, Quelle, wählen Sie die Optionsschaltfläche für Löschen und klicken Sie dann auf Weiter. Wählen Sie auf dem folgenden Bildschirm im Dropdown-Menü die Löschoperation aus (z. B. "Beispiel Clarizen Aufgabe löschen") und klicken Sie auf Fertigstellen.

  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 zum anderen. Ziehen Sie das 'id'-Feld auf der Eingabeseite zum 'id'-Feld auf der Ausgabeseite. Ihre Transformationszuordnung sollte ä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 den Antwortstrukturen finden Sie unter Transformations.

  1. Geben Sie auf dem ersten Bildschirm Name einen Namen für Ihre Transformation ein oder lassen Sie den Standardwert. Wählen Sie dann im Dropdown-Menü Ziel die Option "Clarizen Function Response". Klicken Sie auf Weiter, um fortzufahren.

  2. Wählen Sie auf dem nächsten Bildschirm Ziel die Optionsschaltfläche für Löschen und klicken Sie dann auf Weiter. Wählen Sie auf dem folgenden Bildschirm im Dropdown-Menü die Löschoperation aus (z. B. "Beispiel Clarizen Löschen Aufgabe") und klicken Sie dann auf Fertigstellen.

  3. Der Tab Transformationen sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Quell- und Zielseiten zu erweitern. In diesem Beispiel erstellen wir die Ausgabereaktion, sodass sie die ID, den Status und etwaige Fehlermeldungen in der Antwort enthält. Ziehen Sie den Ordner "OUTPUT" von der linken Seite (Quellseite) zum Ordner "OUTPUT" auf der rechten Seite (Zielseite). Ihr Zuordnungsbildschirm sollte jetzt ähnlich wie unten aussehen.

     

Bereitstellen und Ausführen der Operation

Mit der vollständig konfigurierten Clarizen-Aktivitä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 etwaige Protokollnachrichten anzuzeigen.

   

4. Sie sollten jetzt auch die Ausgabereaktion sehen, die Ihrer Zieldatei zugeordnet wurde. Im Beispiel wird die Datei jetzt in 'C:\ClarizenSampleFiles\ClarizenDelete_Task_Response.xml' erstellt. Da die Operation erfolgreich ausgeführt wurde, sehen wir die ID der Aufgabe in Clarizen und einen Status von '1', der den Erfolg anzeigt.

   <ns:OUTPUT xmlns:ns="urn:czoln-res:document:czoln:oln:entities">
       <Task>
           <id>jw47joqmno25rh7l5azcmo3o26</id>
           <status>1</status>
       </Task>
   </ns:OUTPUT>
   

5. Darüber hinaus sollten Sie feststellen, dass die gelöschte Aufgabe in Ihrer Clarizen-Instanz nicht mehr existiert.