Clarizen-Anschluss Erstellen im Jitterbit Design Studio

Die Clarizen Erstellungsaktivität ist im Clarizen-Connector verfügbar ermöglicht Ihnen die Erstellung neuer Daten in einer verbundenen Clarizen-Instanz mit Jitterbit.

Auf dieser Seite wird die Erstellung neuer Clarizen Datensätze anhand eines Beispiels für die Erstellung einer neuen Aufgabe in Clarizen aus 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 den Beginn der Erstellungsaktivität, das Definieren der Operation und das Bereitstellen und Ausführen des Operation.

Erstellen eines Clarizen Create Operation

1. Innerhalb Ihres Projekts in 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 > Konnektoren > Neues Clarizen erstellen.
   • Klicken Sie im Baum links unter Konnektoren mit der rechten Maustaste auf die Kategorie Clarizen und wählen Sie dann Neues Clarizen erstellen.
   • Doppelklicken Sie im Baum links unter Konnektoren auf die Kategorie Clarizen, klicken Sie dann mit der rechten Maustaste auf Clarizen Create Activities und wählen Sie New Clarizen Create.
   • Klicken Sie in der oberen Symbolleiste auf das Verbindungssymbol (orangefarbenes Puzzleteil) . Wählen Sie im Popup Clarizen und dann Clarizen Create aus.

2. Der Endpoint-Bildschirm des Clarizen Create Wizard sollte in der Hauptansicht von Studio geöffnet werden. In diesem Bildschirm werden Sie aufgefordert, den Endpoint auszuwählen, in dem Sie neue Daten erstellen 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. Der Objekt-Bildschirm des Clarizen-Erstellungsassistenten 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 „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 Datenerstellung innerhalb Ihrer verbundenen Clarizen-Instanz ermöglicht. In Studio sollte eine neue Tab mit dem Namen Clarizen Create Activities angezeigt werden. Sie können Ihre Erstellungsaktivität hier bei Bedarf umbenennen; im Beispiel heißt unsere „Beispiel Clarizen Create 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 eine neue Aufgabe in Clarizen erstellt.

6. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Erstellungsaktivitä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 mit einem Datenträger klicken, um nur diesen Operation zu speichern, oder auf das Symbol mit mehreren Datenträgern, 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 Erstellungsaktivitä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 erscheinen, 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 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

  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. ClarizenCreate_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 „ClarizenCreate_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. ClarizenCreate_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 „ClarizenCreate_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 Erstellen 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 Erstellungsaufgabe“) 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 Erstellen 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 Erstellungsaufgabe“) 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 Erstellungsaktivitä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\ClarizenCreate_Task_Response.xml“ erstellt. Da der Operation erfolgreich ausgeführt wurde, sehen wir die vollständige interne ID der Aufgabe in Clarizen und einen Status von „1“, der 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. Wenn Sie außerdem Ihre Clarizen-Instanz überprüfen, sollten Sie die neu erstellte Aufgabe finden.