Four51 -Anschluss Lesen im Jitterbit Design Studio

Die Four51 Leseaktivität ist im Four51 Connector verfügbar ermöglicht Ihnen das Lesen vorhandener Daten in Four51 über die OrderCloud-API mithilfe von Jitterbit.

Auf dieser Seite wird das Lesen vorhandener Daten in Four51 anhand eines Beispiels für das Abrufen einer vorhandenen Käuferadresse mit Jitterbit beschrieben. In diesem Beispiel wird dieselbe Käuferadresse verwendet, die als Beispiel in Four51 Connector erstellen erstellt wurde.

Die folgenden Abschnitte gliedern sich in das Beginnen der Leseaktivität, das Definieren der Operation und das Bereitstellen und Ausführen der Operation.

Erstellen eines Four51 Operation

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

   • Gehen Sie zu Datei > Neu > Anschlüsse > Neuer Four51 Read.
   • Klicken Sie im Baum links unter Konnektoren mit der rechten Maustaste auf die Kategorie Four51 und wählen Sie dann Neuer Four51 Lesen.
   • Doppelklicken Sie im Baum links unter Konnektoren auf die Kategorie Four51, klicken Sie dann mit der rechten Maustaste auf Four51 -Leseaktivitäten und wählen Sie Neuer Four51 Lesevorgang.
   • Klicken Sie in der oberen Symbolleiste auf das Verbindungssymbol (orangefarbenes Puzzleteil) . Wählen Sie im Popup Four51 und dann Four51 Read aus.

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

   

3. Die nächsten Bildschirme im Four51 Read Wizard helfen Ihnen dabei, zu dem spezifischen Objekt zu gelangen, aus dem Sie Daten abrufen möchten. Der erste dieser Bildschirme, Abschnitt, fordert Sie auf, eine der aufgelisteten Kategorien der obersten Ebene in Four51 auszuwählen: „Authentifizierung“, „Käufer“, „Bestellung“, „Organisation“ oder „Benutzerperspektive“.

   Notiz

   Sie können herausfinden, welche Auswahl Sie treffen müssen, indem Sie auf die OrderCloud API verweisen. Beispielsweise entsprechen diese fünf Kategorien der obersten Ebene direkt denen, die auf der linken Seite der OrderCloud API Konsole aufgeführt sind. Auch die restlichen Objektauswahlbildschirme folgen der Organisation der OrderCloud API.

   Im Beispiel möchten wir eine bestehende Käuferadresse abrufen, daher wählen wir den Bereich „Käufer“ aus und klicken auf Weiter, um fortzufahren.

   

4. Der nächste Bildschirm im Four51 Read Wizard, genannt Ressource, zeigt die Ressourcen an, die im ausgewählten Abschnitt verfügbar sind. Da wir im Beispiel eine vorhandene Adresse abrufen möchten, wählen wir „Adressen“ aus und klicken auf Weiter, um fortzufahren.

   

5. Der letzte Auswahlbildschirm im Four51 Read Wizard, genannt Resource Endpoint, zeigt die letzten für die ausgewählte Ressource verfügbaren Objekte an. Im Beispiel wählen wir zum Lesen einer vorhandenen Adresse die Option „Einzelne Adresse abrufen“ aus. Klicken Sie auf Fertigstellen, um fortzufahren.

   Notiz

   Die für jede Abschnittsressource verfügbaren Endpoints hängen von der Art der für den Operation ausgewählten Four51 Aktivität ab (d. h. Erstellungs-, Lese-, Aktualisierungs-, Patch-Update- oder Löschaktivität).

   

6. Jitterbit erstellt dann eine API Anforderungs- und Antwortstruktur, die das Lesen von Daten über die OrderCloud API ermöglicht. In Studio sollte eine neue Tab mit dem Namen Four51 Read Activities angezeigt werden. Sie können Ihre Leseaktivität hier bei Bedarf umbenennen. Im Beispiel heißt unsere „Four51 Read - Käufer > Adressen > Eine einzelne Adresse abrufen“. Sie können auch die Schaltflächen + - oder Pfeile verwenden, um alle Elemente innerhalb jeder Struktur zu erweitern.

   

   Notiz

   Das „xp“ in der obigen Struktur steht für „Extended Properties“ und ist Teil der OrderCloud API. Mit dieser Eigenschaft können Sie den meisten Objekten benutzerdefinierte Felder hinzufügen. Weitere Informationen zur Verwendung der XP-Eigenschaft finden Sie unter Four51 Connector Advanced.

7. Klicken Sie anschließend auf demselben Bildschirm auf die Schaltfläche Operation erstellen, die sich unter In einer Integration verwenden in der oberen rechten Ecke befindet. Dadurch wird die Jitterbit Operation erstellt, die die vorhandene Käuferadresse von Four51 abruft.

8. In Studio sollte sich eine neue Tab mit dem Namen Operationen öffnen, die eine grafische Darstellung der Leseaktivitä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 Leseaktivitä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.

Sie können entweder zur grafischen Darstellung der von Ihnen erstellten Operation zurückkehren und auf jedes Symbol doppelklicken, um die einzelnen Komponenten zu konfigurieren, oder Sie können Quelle, Anforderung, Antwort und Ziel separat erstellen und diese dann per Drag & Drop aus der Baumstruktur auf der linken Seite direkt auf die Symbole in der visuellen Darstellung Ihrer Operation ziehen.

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: Um dieses Beispiel zu vereinfachen, wird die Quelle fest codiert. Daher entfernen wir die Quelle, indem wir mit der rechten Maustaste auf das Quellensymbol im Operation klicken und Aus Diagramm entfernen auswählen.

  Hinweis

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

• Ziel: Doppelklicken Sie auf das Symbol Ziel. Im Beispiel zeichnen wir die Antwort der OrderCloud-API in einer temporären Textdatei auf, um Informationen über Erfolg/Misserfolg bereitzustellen. Klicken Sie auf die Schaltfläche Neues Ziel erstellen und geben Sie Ihrem Ziel einen Namen (z. B. „Einzelziel lesen“). Als Nächstes möchten wir für dieses Beispiel in den standardmäßigen temporären Speicherort auf unserem privaten Agenten schreiben, also wählen wir einen Typ „Temporärer Speicher“ und geben einen Dateinamen von „Read_Single.txt“ für das Beispiel ein.

  Hinweis

  Sie können auch in eine Vielzahl unterschiedlicher Zieltypen ausgeben. Der Typ muss nicht mit dem Quelltyp identisch sein. Siehe Quellen und 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. Verwenden Sie dann das Dropdown-Menü Quelle, um die Quelle für die Transformation auszuwählen. Im Beispiel ist unsere Quelle fest codiert, daher wählen wir „Keine“ aus. Klicken Sie auf Fertig, um fortzufahren.

  2. Die Tab Transformations sollte sich öffnen, wo Sie Ihre Zuordnung abschließen können. Verwenden Sie das +, um die Elemente im Zielbaum rechts zu erweitern. Bei einer Transformation würden Sie jedes Feld, das Sie zuordnen möchten, per Drag & Drop von einem Baum zum anderen ziehen. Um in diesem Beispiel die Quelle hart zu codieren, doppelklicken Sie auf jedes Feld auf der Zielseite und geben Sie die folgenden im Beispiel verwendeten Werte in das Script ein:

     ZIEL: INPUT > GetaSingleAddress > Parameter	Script
     Käufer-ID	<trans> "TestBuyerID0001" </trans>
     Adress-ID	<trans> "TestAddressID0000" </trans>

     Notiz

     Die obige Käufer-ID ist die vorhandene ID der Käuferorganisation, zu der sich die Adresse gehört, und die obige Adress-ID ist die vorhandene ID der neuen Adresse, die während der Erstellung des Four51 Connectors erstellt wurde Beispiel.

     Nach dem Festcodieren der Quelle sollte Ihre Transformation 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. Verwenden Sie dann das Dropdown-Menü Ziel, um das Ziel für die Transformation auszuwählen. Im Beispiel möchten wir die Antwort der OrderCloud-API verwenden, also wählen wir „Four51 -Funktionsantwort“ aus. Klicken Sie auf Weiter, um fortzufahren.

  2. Wählen Sie auf dem nächsten Bildschirm Ziel das Optionsfeld für den Aktivitätstyp aus, dessen Antwort Sie verwenden möchten. In diesem Fall möchten wir die Antwort der Leseaktivität verwenden, die wir gerade eingerichtet haben. Wählen Sie daher „Lesen“. Klicken Sie auf Weiter, um fortzufahren.

  3. Der Ziel-Bildschirm zeigt nun ein Dropdown-Menü zur Auswahl der Aktivität an. Wählen Sie die Leseaktivität aus, die Sie gerade eingerichtet haben. Die mit der ausgewählten Leseaktivität verknüpften Anforderungs- und Antwortstrukturen sollten nun angezeigt werden. Klicken Sie auf Fertig, um fortzufahren.

  4. Die Tab Transformations sollte sich öffnen, wo Sie Ihr Mapping abschließen können. Verwenden Sie das +, um die Quell- und Zielseiten zu erweitern. 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 nun ungefähr wie unten aussehen.

     

     Notiz

     Wenn Sie mit großen Datenmengen arbeiten, können Sie auch die in Four51 Connector - Erweitert beschriebenen Optionen zur Paginierung, Suche, Filterung oder Sortierung verwenden.

Ihr konfigurierter Operation sollte dem unten gezeigten Beispiel ähneln.

Bereitstellen und Ausführen der Operation

Nachdem die Four51 Leseaktivitä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 „Read_Single.txt“ zugeordnet wurde. Im Beispiel wird die Datei jetzt im temporären Speicher auf dem privaten Agenten erstellt (d. h. standardmäßig „/tmp/jitterbit/TemporaryStorage“ für Linux oder „C:\ Windows\Temp\Jitterbit\“ für Windows). Der Status „1“ zeigt an, dass der Operation erfolgreich war.

   <?xml version="1.0" encoding="UTF-8"?>
   <ns:OUTPUT xmlns:ns="urn:F51oln-res:document:F51oln:oln:entities">
       <GetaSingleAddress>
           <Status>1</Status>
           <Meta>
               <ItemRange/></Meta>
           <Items>
               <Item>
                   <ID>TestAddressID0000</ID>
                   <CompanyName>Test Company</CompanyName>
                   <FirstName>First</FirstName>
                   <LastName>Last</LastName>
                   <Street1>Main Street</Street1>
                   <City>San Francisco</City>
                   <State>CA</State>
                   <Zip>123456</Zip>
                   <Country>US</Country>
                   <Phone>123456789</Phone>
                   <AddressName>Test_Address</AddressName>
               </Item>
           </Items>
       </GetaSingleAddress>
   </ns:OUTPUT>
   

5. Da es sich um einen Operation handelte, gibt es keine Änderungen innerhalb der OrderCloud API. Sie können jedoch weiterhin dieselben Informationen aus der OrderCloud API Konsole lesen unter Käufer > Adressen.