Clarizen-Connector-Update im Jitterbit Design Studio

Die Clarizen-Update-Aktivität, die im Clarizen-Connector verfügbar ist, ermöglicht es Ihnen, vorhandene Daten in einer verbundenen Clarizen-Instanz mithilfe von Jitterbit zu aktualisieren.

Diese Seite beschreibt, wie Sie vorhandene Clarizen-Daten aktualisieren, indem ein Beispiel für die Aktualisierung einer bestehenden Aufgabe in Clarizen aus Quelldaten bereitgestellt in einer XML-Datei über Jitterbit 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 Update-Aktivität, die Definition der Betriebsbestandteile sowie die Bereitstellung und Ausführung der Operation.

Erstellen einer Clarizen-Update-Operation

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

   • Gehen Sie zu Datei > Neu > Connectoren > Neues Clarizen-Update.
   • Klicken Sie im Baum auf der linken Seite unter Connectoren mit der rechten Maustaste auf die Kategorie Clarizen und wählen Sie dann Neues Clarizen-Update.
   • Doppelklicken Sie im Baum auf der linken Seite unter Connectoren 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 Connector-Symbol (orangefarbener Puzzlestück) . Wählen Sie im Popup Clarizen und dann Clarizen Update aus.

2. Der Endpoint-Bildschirm des Clarizen Update Wizards sollte in der Hauptansicht von Studio geöffnet werden. Dieser Bildschirm fordert dazu auf, den Endpoint auszuwählen, in dem Sie vorhandene Daten aktualisieren möchten. Sie sollten Ihren Endpoint bereits im 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. Der Object-Bildschirm des Clarizen Update Wizards fordert Sie auf, das Objekt auszuwählen, in dem Sie vorhandene Daten aktualisieren möchten. In diesem Beispiel möchten wir eine vorhandene Aufgabe in Clarizen aktualisieren, also wählen wir das Objekt "Task" 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 fortfahren, eine Clarizen-API-Anforderungs- und -Antwortstruktur zu erstellen, die es ermöglicht, Daten in Ihrer verbundenen Clarizen-Instanz zu aktualisieren. Ein neuer Tab sollte in Studio erscheinen, der Clarizen Update Activities heißt. Sie können Ihre Aktualisierungsaktivität hier umbenennen, wenn gewünscht; in unserem Beispiel heißt sie "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 als Nächstes auf demselben Bildschirm auf die Schaltfläche Operation erstellen, die sich unter In einer Integration verwenden in der oberen rechten Ecke befindet. Dies erstellt die Jitterbit-Operation, die die vorhandene Aufgabe in Clarizen aktualisiert.

6. Ein neuer Tab sollte in Studio geöffnet werden, der Operationen heißt und eine grafische Darstellung der Aktualisierungsaktivität enthält.

   

   Hinweis

   Die Symbole für Source, Request, Response und Target im obigen Bild sind Platzhalter für die Betriebskomponenten, 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 mehrfache Diskettensymbol, um alle Änderungen in Ihrem Integrationsprojekt zu speichern. Sie sollten sehen, dass der Stern auf der Operations-Registerkarte und der Titel der Operation verschwinden, da Ihre neue Aktualisierungsaktivität jetzt erstellt und in Ihrem Projekt gespeichert wurde.

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 Komponente 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önnen Sie auch Source, Request, Response und Target separat erstellen und diese dann per Drag & Drop aus dem Baum auf der linken Seite direkt auf die Symbole in der visuellen Darstellung Ihrer Operation ziehen.

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

• Source: Im Beispiel verwenden wir eine XML-Datei als Eingabeanforderung, um eine vorhandene Aufgabe mit den unten angegebenen Feldwerten zu aktualisieren. Eine ID muss in der Quelle für eine Aktualisierungsaktivitä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>
          <Name>Testing 123</Name>
          <Description>This is my updated task.</Description>
          </Task>
  </ns:INPUT>
  

  Hinweis

  Eine Clarizen-Update-Aktivität muss die interne oder externe ID der Entität innerhalb von Clarizen verwenden, um das Update mit dem richtigen Objekt zu verknüpfen. Die vollständige interne ID von Clarizen enthält den Entitätsnamen 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 des Beispiels zurückgegeben wird, das in Clarizen connector create verwendet wurde, wo wir Task1 erstellt haben. Wenn Sie dem Beispiel folgen, müssen Sie diese ID durch die spezifische ID der Aufgabe in Ihrer Clarizen-Instanz ersetzen. Das Update wird 'Task1' in 'Testing 123' umbenennen und die Beschreibung aktualisieren.

  Hinweis

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

  Um die XML-Datei zu verwenden, doppelklicken Sie zuerst auf das Source-Symbol, klicken Sie dann auf die Schaltfläche Create New Source und geben Sie Ihrer Quelle einen Name (z. B. ClarizenUpdate_Task_Request.xml). Für dieses Beispiel verwenden wir 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 'ClarizenUpdate_Task_Request.xml'.

• Ziel: Doppelklicken Sie auf das Target-Symbol. 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 Create New Target, geben Sie Ihrem Ziel einen Name (z. B. ClarizenUpdate_Task_Response.xml) und wählen Sie erneut einen Typ von "Local File" 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 ist 'ClarizenUpdate_Task_Response.xml'.

  Hinweis

  Sie können auch in eine Vielzahl von verschiedenen Zieltypen ausgeben. Der Typ muss nicht mit dem Quelltyp übereinstimmen. 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 Anfrage-Strukturen 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 Aktualisieren und klicken Sie dann auf Weiter. Auf dem folgenden Bildschirm verwenden Sie das Dropdown-Menü, um die Aktualisierungsoperation auszuwählen (z. B. "Beispiel Clarizen Aktualisierungsaufgabe"), 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 Zielobjekte in jedem Baum zu erweitern. Ziehen Sie dann jedes Feld, das Sie zuordnen möchten, von einem Baum zum anderen. Als Abkürzung für dieses Beispiel können Sie auf das Auto-Zuordnungs-Symbol klicken, das unter der Zielseite des Baums erscheint:

     

     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 Antwort-Strukturen 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ü Ziel, um "Clarizen Funktionsantwort" auszuwählen. Klicken Sie auf Weiter, um fortzufahren.

  2. Wählen Sie auf dem nächsten Bildschirm Ziel die Option für Aktualisieren aus, und klicken Sie dann auf Weiter. Wählen Sie auf dem folgenden Bildschirm im Dropdown-Menü die Aktualisierungsoperation aus (z. B. "Beispiel Clarizen Aktualisierungsaufgabe"), 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 Zielseiten zu erweitern. In diesem Beispiel erstellen wir die Ausgabereaktion, sodass sie die ID, den Status und etwaige Fehlermeldungen in der Antwort enthält. Klicken und 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

Nachdem die Clarizen-Aktualisierungsaktivität vollständig konfiguriert ist, 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. In diesem Beispiel wurde die Datei jetzt in 'C:\ClarizenSampleFiles\ClarizenUpdate_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. Wenn Sie außerdem Ihre Clarizen-Instanz überprüfen, sollten Sie feststellen, dass 'Task1', die während Clarizen-Connector erstellen erstellt wurde, jetzt 'Testing 123' heißt und die Beschreibung aktualisiert wurde.