Clarizen-Connector Erstellen im Jitterbit Design Studio

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

Diese Seite beschreibt, wie Sie neue Clarizen-Datensätze erstellen, indem Sie ein Beispiel für die Erstellung einer neuen Aufgabe in Clarizen aus Quelldaten bereitgestellt in einer XML-Datei über Jitterbit verwenden.

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 in den Beginn der Erstellungsaktivität, die Definition der Betriebsbestandteile sowie die Bereitstellung und Ausführung der Operation unterteilt.

Erstellen einer Clarizen-Erstellungsoperation

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

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

2. Der Endpoint-Bildschirm des Clarizen Create Wizard sollte in der Hauptansicht von Studio geöffnet werden. Dieser Bildschirm fordert dazu auf, den Endpoint auszuwählen, in dem Sie neue Daten erstellen 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 Create Wizard fordert Sie auf, das Objekt auszuwählen, in dem Sie neue Daten erstellen möchten. In diesem Beispiel möchten wir eine neue Aufgabe in Clarizen erstellen, also wählen wir das Objekt "Task" aus und klicken dann auf Fertigstellen, um fortzufahren.

   Hinweis

   Wenn Sie viele Objekte in Ihrer Clarizen-Instanz zur Verfügung 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-Anfrage und -Antwortstruktur fortfahren, die es ermöglicht, Daten in Ihrer verbundenen Clarizen-Instanz zu erstellen. Ein neuer Tab sollte in Studio erscheinen, der Clarizen Create Activities heißt. Sie können Ihre Erstellungsaktivität hier umbenennen, wenn gewünscht; in unserem Beispiel heißt sie "Beispiel Clarizen Create Task." Sie können auch die + -Tasten 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 erstellt die Jitterbit-Operation, die eine neue Aufgabe in Clarizen erstellt.

6. Ein neuer Tab sollte in Studio geöffnet werden, der Operations heißt und eine grafische Darstellung der Erstellungsaktivitä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 Registerkarte Operations und der Titel der Operation verschwinden, da Ihre neue Aktivitä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 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önnten Sie auch Source, Request, Response und Target separat erstellen und sie 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 bereit: Jitterpak ClarizenExample.jpk und begleitende 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, beziehen Sie sich auf den Abschnitt Design Studio unserer Dokumentation.

• Source: Im Beispiel verwenden wir eine XML-Datei als Eingabew request, um eine neue Aufgabe mit den unten angegebenen Feldwerten zu erstellen:

  Input

  <ns:INPUT xmlns:ns="urn:czoln:document:czoln:oln:entities">
      <Task>
          <Name>Task1</Name>
          <Description>FirstTask</Description>
          <Duration>
              <unit>Days</unit>
              <value>3</value>
          </Duration>
          <ActualStartDate>2016-12-13 12:12:12</ActualStartDate>
          <ActualCost/>
          <PlannedBudget></PlannedBudget>
          <FixedCost/>
          <FixedPrice/>
          <PlannedRevenue/>
          <ActualRevenue/>
          <DirectPlannedExpenses/>
          <DirectPlannedBilledExpenses/>
          <AllowReportingOnSubItems>1</AllowReportingOnSubItems>
          <BudgetedHours/>
          <ActualEffortUpdatedFromTimesheets>1</ActualEffortUpdatedFromTimesheets>
          <Deliverable>1</Deliverable>
          <PlannedAmount/>
          <ChargedAmount/>
          <TotalEstimatedCost/>
          </Task>
  </ns:INPUT>
  

  Hinweis

  Eine Vielzahl von Quelltypen ist in Jitterbit verfügbar. Weitere Informationen finden Sie unter Sources.

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. ClarizenCreate_Task_Request.xml). Für dieses Beispiel verwenden wir einen privaten Agenten mit lokalen Dateien aktiviert und wählen daher einen Type von "Local File" und klicken dann auf Browse, um den Speicherort auszuwählen. Wenn Sie die Beispieldateien verwenden, ist der Folder 'C:\ClarizenSampleFiles' und die Get Files ist 'ClarizenCreate_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. ClarizenCreate_Task_Response.xml) und wählen Sie erneut einen Type von "Local File" und klicken Sie auf Browse, um einen Speicherort auf dem privaten Agenten auszuwählen, an dem wir die Daten speichern möchten. Im Beispiel ist der Folder 'C:\ClarizenSampleFiles' und der Filename ist 'ClarizenCreate_Task_Response.xml'.

  Hinweis

  Sie können auch in eine Vielzahl von verschiedenen Zieltypen ausgeben. Der Typ muss nicht derselbe sein wie der Quelltyp. Siehe Targets für Optionen.

• Request: Doppelklicken Sie auf das Request-Symbol und wählen Sie Create New Transformation. Dies öffnet den Transformation Wizard, der Sie durch die Erstellung der Anfrage führt.

  Hinweis

  Zusätzliche Informationen zu Anforderungsstrukturen finden Sie unter Transformations.

  1. Auf dem ersten Bildschirm, Name, geben Sie einen Name für Ihre Transformation an oder lassen Sie ihn als Standard. Verwenden Sie dann das Dropdown-Menü Source, um "Clarizen Function Request" auszuwählen. Klicken Sie auf Next, um fortzufahren.

  2. Auf dem nächsten Bildschirm, Source, wählen Sie die Optionsschaltfläche für Create und klicken Sie dann auf Next. Auf dem folgenden Bildschirm verwenden Sie das Dropdown-Menü, um die Erstellungsoperation auszuwählen (z. B. "Example Clarizen Create Task"), und klicken Sie dann auf Finish.

  3. Der Transformations-Tab 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-Map-Symbol klicken, das unter der Zielseite des Baums erscheint:

     

     Ihre Transformationszuordnung sollte ähnlich aussehen wie die unten gezeigte:

     

• Response: Doppelklicken Sie auf das Response-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 Transformations.

  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 "Clarizen Function Response" auszuwählen. Klicken Sie auf Weiter, um fortzufahren.

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

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

     

Bereitstellen und Ausführen der Operation

Mit der vollständig konfigurierten Clarizen-Erstellungsaktivität sind wir bereit, die Operation bereitzustellen und auszuführen.

1. Klicken Sie im Operations-Tab auf das Deploy 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 etwaige Protokollnachrichten anzuzeigen.

   

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

   Output

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

5. Darüber hinaus sollten Sie, wenn Sie Ihre Clarizen-Instanz überprüfen, die neu erstellte Aufgabe finden.