Clarizen Connector-Update im Jitterbit Design Studio

Die Clarizen Update-Aktivität ist im Clarizen-Connector verfügbar ermöglicht Ihnen die Aktualisierung vorhandener Daten in einer verbundenen Clarizen-Instanz mithilfe von Jitterbit.

Auf dieser Seite wird die Aktualisierung vorhandener Clarizen Daten anhand eines Beispiels für die Aktualisierung einer vorhandenen Aufgabe in Clarizen anhand von Quelldaten beschrieben, die in einer XML-Datei über Jitterbit bereitgestellt werden.

Dieses Beispiel dient nur zu Demonstrationszwecken und deckt nicht alle im Produkt verfügbaren Optionen ab. Weitere Informationen finden Sie in Design Studio für eine ausführlichere Dokumentation.

Die folgenden Abschnitte gliedern sich in die Schritte „Starten der Aktualisierungsaktivität“, „Definieren der Operation “ und „Ausführen und Ausführen des Operation“.

Erstellen eines Clarizen Operation

1. Innerhalb Ihres Projekts in Jitterbit Studio gibt es mehrere Möglichkeiten, eine neue Clarizen Update-Aktivität zu starten. Jede der folgenden Optionen startet den Clarizen-Update-Assistent, der Sie durch den Vorgang führt.

   • Gehen Sie zu Datei > Neu > Konnektoren > Neues Clarizen Update.
   • Klicken Sie im Baum links unter Konnektoren mit der rechten Maustaste auf die Kategorie Clarizen und wählen Sie dann Neues Clarizen-Update.
   • Doppelklicken Sie im Baum links unter Konnektoren auf die Kategorie Clarizen, klicken Sie dann mit der rechten Maustaste auf Clarizen-Update-Aktivitäten und wählen Sie Neues Clarizen-Update.
   • Klicken Sie in der oberen Symbolleiste auf das Verbindungssymbol (orangefarbenes Puzzleteil) . Wählen Sie im Popup Clarizen und dann Clarizen Update aus.

2. Der Endpoint-Bildschirm des Clarizen Update Wizard sollte in der Hauptansicht von Studio geöffnet werden. In diesem Bildschirm werden Sie aufgefordert, den Endpoint auszuwählen, in dem Sie vorhandene Daten aktualisieren möchten. Sie sollten Ihren Endpoint bereits in Clarizen Connector-Endpoint eingerichtet haben. Verwenden Sie das Dropdown-Menü, um den entsprechenden Endpoint auszuwählen. Klicken Sie auf Weiter, wenn Sie fertig sind.

3. Auf dem Bildschirm Objekt des Clarizen-Aktualisierungsassistenten werden Sie aufgefordert, das Objekt auszuwählen, in dem Sie vorhandene Daten aktualisieren möchten. In diesem Beispiel möchten wir eine vorhandene Aufgabe in Clarizen aktualisieren. Daher wählen wir das Objekt „Aufgabe“ aus und klicken dann auf Fertig, um fortzufahren.

   Notiz

   Wenn in Ihrer Clarizen-Instanz viele Objekte verfügbar sind, 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 es mit der Schaltfläche Aktualisieren, wenn die Ergebnisse nicht Ihren Erwartungen entsprechen.

   

4. Jitterbit erstellt dann eine Clarizen API Anforderungs- und Antwortstruktur, die die Aktualisierung von Daten innerhalb Ihrer verbundenen Clarizen-Instanz ermöglicht. In Studio sollte eine neue Tab mit dem Namen Clarizen Update Activities angezeigt werden. Sie können Ihre Update-Aktivität hier bei Bedarf umbenennen; im Beispiel heißt unsere „Beispiel Clarizen Update Task“. Sie können auch die + - Schaltflächen oder Pfeile verwenden, um alle Elemente innerhalb jeder Struktur zu erweitern.

   

5. Klicken Sie anschließend auf demselben Bildschirm auf die Schaltfläche Operation erstellen unter In einer Integration verwenden in der oberen rechten Ecke. Dadurch wird die Jitterbit Operation erstellt, die die vorhandene Aufgabe in Clarizen aktualisiert.

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

   

   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 Aktualisierungsaktivitä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.

Die folgenden Anweisungen führen Sie jeweils dazu, zur grafischen Darstellung der von Ihnen erstellten Operation zurückzukehren und auf jedes Symbol zu doppelklicken, um die einzelnen Komponenten zu konfigurieren. Alternativ können Sie Quelle, Anforderung, Antwort und Ziel auch separat erstellen und sie dann per Drag & Drop aus dem Baum links direkt auf die Symbole in der visuellen Darstellung Ihrer Operation ziehen.

Für die Zwecke dieser exemplarischen Vorgehensweise stellen wir die folgenden Beispiele als Referenz zur Verfügung: Jitterpak ClarizenExample.jpk und zugehörige Dateien in ClarizenSampleFiles.zip. 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: Im Beispiel verwenden wir eine XML-Datei als Eingabeanforderung, um eine vorhandene Aufgabe mit den unten angegebenen Feldwerten zu aktualisieren. Für eine Aktualisierungsaktivität muss in der Quelle eine ID enthalten sein und kann entweder die externe ID oder die interne ID (vollständige ID) im Format /\<Objekttyp>/\<externe_ID> sein.

  <ns:INPUT xmlns:ns="urn:czoln:document:czoln:oln:entities">
      <Task>
          <id>jw47joqmno25rh7l5azcmo3o26</id>
          <Name>Testing 123</Name>
          <Description>This is my updated task.</Description>
          </Task>
  </ns:INPUT>
  

  Notiz

  Eine Clarizen Aktualisierungsaktivität muss die interne oder externe ID der Entität innerhalb von Clarizen verwenden, um die Aktualisierung dem richtigen Objekt zuzuordnen. Die vollständige interne Clarizen-ID enthält den Entitätsnamen im Format /\<Objekttyp>/\<externe_ID> (z. B. /Task/jw47joqmno25rh7l5azcmo3o26), während die externe Clarizen-ID standardmäßig nur die ID enthält, z. B. jw47joqmno25rh7l5azcmo3o26.

  Notiz

  Im Beispiel verwenden wir die Clarizen ID, die in der Antwort aus dem in Clarizen-Connector erstellen verwendeten Beispiel zurückgegeben wurde, wo wir Task1 erstellt haben. Wenn Sie dem Beispiel folgen, müssen Sie diese ID durch die für die jeweilige Aufgabe in Ihrer Clarizen-Instanz ersetzen. Das Update benennt „Task1“ in „Testing 123“ um und aktualisiert die Beschreibung.

  Hinweis

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

  Um die XML-Datei zu verwenden, doppelklicken Sie zuerst auf das Symbol Quelle, klicken Sie dann auf die Schaltfläche Neue Quelle erstellen und geben Sie Ihrer Quelle einen Namen (z. B. ClarizenUpdate_Task_Request.xml). Als nächstes verwenden wir für dieses Beispiel einen privaten Agenten mit aktivierten lokalen Dateien, 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:\ClarizenSampleFiles“ und die Datei abrufen ist „ClarizenUpdate_Task_Request.xml“.

• Ziel: Doppelklicken Sie auf das Symbol Ziel. Im Beispiel geben wir die ID und den Status der neuen Aufgabe in Clarizen in eine XML-Datei aus, um sicherzustellen, dass sie erstellt wurde. Klicken Sie auf die Schaltfläche Neues Ziel erstellen, geben Sie Ihrem Ziel einen Namen (z. B. ClarizenUpdate_Task_Response.xml), wählen Sie erneut einen Typ „Lokale Datei“ und Navigieren Sie zu einem Speicherort auf dem privaten Agenten, an dem wir die Daten speichern möchten. Im Beispiel ist der Ordner „C:\ClarizenSampleFiles“ und der Dateiname „ClarizenUpdate_Task_Response.xml“.

  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. Wählen Sie dann im Dropdown-Menü Quelle „Clarizen-Funktionsanforderung“ aus. Klicken Sie auf Weiter, um fortzufahren.

  2. Wählen Sie auf dem nächsten Bildschirm Quelle das Optionsfeld für Aktualisieren aus und klicken Sie dann auf Weiter. Wählen Sie auf dem folgenden Bildschirm im Dropdown-Menü den Operation aus (z. B. „Beispiel für Clarizen Aktualisierungsaufgabe“) und klicken Sie dann auf Fertigstellen.

  3. Die Tab Transformations sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Quell- und Zielelemente in jedem Baum zu erweitern. Ziehen Sie dann jedes Feld, das Sie zuordnen möchten, per Drag & Drop von einem Baum zum anderen. Als Abkürzung für dieses Beispiel können Sie auf das Auto-Map-Symbol klicken, das unter der Zielseite des Baums angezeigt wird:

     

     Ihre Transformation sollte ungefähr wie unten gezeigt aussehen:

     

• 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. Wählen Sie dann im Dropdown-Menü Ziel „Clarizen Function Response“ aus. Klicken Sie auf Weiter, um fortzufahren.

  2. Wählen Sie auf dem nächsten Bildschirm Ziel das Optionsfeld für Aktualisieren aus und klicken Sie dann auf Weiter. Wählen Sie auf dem folgenden Bildschirm im Dropdown-Menü den Operation aus (z. B. „Beispiel für Clarizen Aktualisierungsaufgabe“) und klicken Sie dann auf Fertigstellen.

  3. Die Tab Transformations sollte sich öffnen, wo Sie Ihr Mapping abschließen können. Verwenden Sie das +, um die Quell- und Zielseiten zu erweitern. In diesem Beispiel erstellen wir die Ausgabeantwort so, dass sie die ID, den Status und alle Fehlermeldungen in der Antwort enthält. 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 jetzt ungefähr wie unten aussehen.

     

Bereitstellen und Ausführen der Operation

Nachdem die Clarizen Update-Aktivität vollständig konfiguriert ist, können wir den Operation einsetzen und ausführen.

1. Klicken Sie auf der Tab Operationen auf die einsetzen -Symbol.

2. Klicken Sie dann auf „Ausführen , 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.

   

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

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

5. Wenn Sie Ihre Clarizen-Instanz überprüfen, sollten Sie außerdem feststellen, dass „Task1“ während Clarizen-Connector erstellen erstellt wurde heißt jetzt „Testing 123“ und die Beschreibung wurde aktualisiert.