Kurs 6
Deine erste Integration einrichten

Aufbau der Route

Nachdem erfolgreich Verbindungen zwischen den beiden Anwendungen hergestellt wurden, die wir integrieren möchten (durch Auswahl einer Verbindungsmethode), ist es jetzt an der Zeit, den Datenaustausch zu aktivieren. In unserem Beispiel bedeutet dies, Daten aus unserer Picqer-Lagerverwaltungssoftware abzurufen und an unseren Shopify-E-Commerce-Webshop zu senden. Lassen Sie uns untersuchen, wie das alles in Aktion funktioniert.

Schritt 2: Konfiguration der Integration

Um eine Integration zwischen Anwendungen (Shopify und Picqer) über das Alumio iPaaS zu erstellen, zu automatisieren, zu transformieren und zu orchestrieren, erstellen wir zunächst eine neue Route wie folgt:

1. Beginne mit einer Route: Wählen Sie in der Navigationsleiste die Option „Integrationen“ und klicken Sie im Drop-down-Menü auf den Abschnitt „Routen“, um mit der Erstellung Ihrer Integration zu beginnen.

2. Erstellen Sie eine neue Route: Klicken Sie in der Routenübersicht auf das Plus-Symbol, um mit dem Erstellen einer neuen Route zu beginnen.

3. Nennen Sie Ihre Integration: Geben Sie Ihrer Route in der angezeigten Benutzeroberfläche zur Routenerstellung einen eindeutigen Namen und eine Beschreibung, damit Sie Ihre Integration leicht identifizieren, durchsuchen und definieren können. Zu den bewährten Methoden gehören die Benennung der Anwendungen, die Sie integrieren möchten, und die Angabe des Datenflusses.

4. Erstellen Sie eine eingehende Konfiguration: Um den ersten Teil Ihrer Integration zu erstellen, müssen Sie zunächst Daten aus Ihrem Quellsystem abrufen (Picqer, wie in unserem Beispiel). Um dies zu erreichen, müssen Sie eine eingehende Konfiguration auf der Route erstellen, indem Sie die folgenden Aktionen ausführen:

a. Geben Sie eingehende Daten ein: In der Schnittstelle zum Erstellen der Incoming Configuration müssen Sie ihr zunächst einen Namen und eine Beschreibung geben, die definiert, welche Art von Daten sie aus der Quell-App abrufen wird.

b. Wählen Sie einen Abonnenten: Zu definieren Sie, wie Alumio Daten von einer Quellanwendung empfängt. Als Nächstes müssen Sie einen relevanten Abonnenten und eine HTTP-Anforderungsmethode auswählen. Wie Sie sehen können, haben wir in der Abbildung unten den Picqer-Abonnenten aus dem Drop-down-Menü ausgewählt und die von uns gewählte Anforderungsmethode ist „GET“, eine HTTP-Methode, die zum Abrufen von Daten verwendet wird.

c. Wählen Sie eine Entität aus: Als Nächstes müssen Sie eine „Datenentität“ oder einen bestimmten Datentyp auswählen, um auszuwählen, welche spezifischen Daten Sie von der Anwendung über die Eingangskonfiguration erhalten möchten. Da wir in unserem Beispiel Produktdaten von Picqer in Shopify integrieren möchten, wählen wir die Entität „Alle Produkte abrufen“ aus.

d. Wählen Sie den HTTP-Client: Am wichtigsten ist, dass wir als Nächstes den Picqer-HTTP-Client auswählen müssen, den wir gleich zu Beginn der Erstellung Ihrer Integration erstellt haben, um Ihre Verbindungsmethode zu definieren.

e. Eingehende Daten speichern: Damit haben wir unsere Eingangskonfiguration erfolgreich so konfiguriert, dass Produktdaten von Picqer in den Alumio iPaaS übertragen werden. Wir können jetzt die eingehende Konfiguration speichern und mit der Konfiguration des Restes Ihrer Route fortfahren.

Hinweis: Die zusätzlichen Optionen, die Sie auf der Benutzeroberfläche sehen, sind optionale Felder, die Sie konfigurieren können, um Ihre Verbindung weiter anzupassen.

5. Eine ausgehende Konfiguration erstellen: Der nächste Schritt zur Fertigstellung unserer Route besteht darin, die Ausgangskonfiguration zu erstellen. Dies hilft bei der Definition der Zielanwendung (Shopify), an die wir die abgerufenen Daten senden möchten. Sie müssen die Option Ausgehende Konfiguration auf der Route-Oberfläche auswählen, indem Sie auf das Plus-Symbol neben dem Feld klicken und dann die folgenden Aktionen ausführen:

a. Geben Sie ausgehende Daten ein: In der Schnittstelle zum Erstellen der Ausgangskonfiguration müssen Sie ihr zunächst einen Namen und eine Beschreibung geben, die angibt, welche Daten Sie an die Zielanwendung senden.

b. Wählen Sie einen Verlag: Zu definieren Sie, wie Alumio Daten an die Zielanwendung sendet. Als Nächstes müssen Sie einen relevanten Herausgeber und eine HTTP-Anforderungsmethode auswählen. Wie Sie in der Abbildung unten sehen können, haben wir den Shopify-Publisher aus dem Drop-down-Menü ausgewählt. Die gewählte Anforderungsmethode ist „POST“, eine HTTP-Methode, mit der neue Artikel in einer anderen Anwendung erstellt werden.

c. Wählen Sie eine Entität aus: Als Nächstes müssen Sie eine „Datenentität“ oder einen bestimmten Datentyp auswählen, um auszuwählen, welche spezifischen Daten Sie über die Ausgangskonfiguration an die Anwendung senden möchten. Da wir in unserem Beispiel Produktdaten von Picqer in Shopify integrieren möchten, wählen wir in Shopify die Entität „Neues Produkt erstellen“ aus.

d. Wählen Sie den HTTP-Client: Ähnlich wie bei der Eingangskonfiguration müssen wir unsere Ausgangskonfiguration abschließen, indem wir den Shopify-HTTP-Client auswählen, den wir gleich zu Beginn dieser exemplarischen Vorgehensweise erstellt haben.

e. Ausgehende Daten speichern: Wir haben unsere Ausgangskonfiguration jetzt erfolgreich konfiguriert, um die Picqer-Produktdaten über das Alumio iPaaS an Shopify zu senden. Wir können die ausgehende Konfiguration speichern und unsere Route wieder abschließen.

6. Bereite die Route zum Laufen vor: Wenn Sie zur Routenerstellungsschnittstelle für das Senden von „Picqer-Produkten an Shopify“ zurückkehren, können Sie jetzt sehen, dass wir erfolgreich eine eingehende und ausgehende Konfiguration erstellt und daran angehängt haben. Damit ist die Route auf einer grundlegenden Ebene abgeschlossen.

a. Speichern Sie die Route: Um die Route auszuführen, überprüfen Sie ein letztes Mal alle Details und klicken Sie dann auf die Option „Speichern und fortfahren“.

b. Führen Sie das Incoming aus: Sie können wählen, ob Sie die gesamte Route direkt ausführen möchten. Wenn Sie eine Route zum ersten Mal konfigurieren, können Sie jedoch zunächst die Eingangskonfiguration manuell ausführen, um zu überprüfen, ob alles funktioniert. Auf diese Weise können Sie überprüfen, ob der Alumio iPaaS Daten korrekt aus dem Quellsystem abruft.

c. Neue Aufgaben überprüfen: In der Route-Oberfläche gibt es mehrere Registerkarten: Bearbeiten, Versionskontrolle, Protokolle, Geplante Jobs, Benachrichtigungen, Aufgaben, Beziehungen. Sie müssen die Registerkarte „Aufgaben“ auswählen, um zu überprüfen, ob bei der manuellen Ausführung Ihrer Eingangskonfiguration erfolgreich Daten von Picqer abgerufen wurden. Wenn Sie sehen, dass Aufgaben mit dem Status „NEU“ erstellt wurden, bedeutet dies, dass Ihre Eingangskonfiguration funktioniert. Wenn der Status „Fehlgeschlagen“ lautet, müssen Sie ihn neu konfigurieren, indem Sie in den Protokollen nachsehen, was schief gelaufen ist.

d. Führen Sie die Route aus: Nachdem wir erfolgreich überprüft haben, ob Alumio die richtigen Daten aus der Quellanwendung abruft, können wir nun versuchen, diese Daten an die Zielanwendung zu senden. Um das zu tun, müssen wir die Route ausführen.

e. Abgeschlossene Aufgaben: Nachdem Sie die Route ausgeführt haben, können Sie die Aufgabenseite innerhalb der Route aktualisieren, um zu überprüfen, ob die Daten erfolgreich integriert wurden (von Picqer nach Shopify — wie in unserem Beispiel). Wenn sich der Status der Aufgaben von „Neu“ auf „Fertig“ ändert, bedeutet dies, dass die Integration erfolgreich war.

Bitte beachten Sie: Sie können auf jede Aufgabe klicken und dort zur Registerkarte Entitätsdaten navigieren, um die Daten, die integriert werden (die Produktdaten von Picqer bis Shopify), im JSON-Format zu visualisieren.

f. Protokolle überprüfen: Um nach dem Ausführen der Route alle Daten, die über die Integration ausgetauscht wurden, im Detail zu überprüfen, wählen Sie einfach den Tab „Logs“ innerhalb der Route aus. Oberflächlich betrachtet zeigt dir diese Übersicht alle Daten, Zeiten und Dauer der Routenaktivität, ihren Speicherverbrauch und die Anzahl der generierten, fehlgeschlagenen oder gefilterten Aufgaben.

g. Angaben zum Protokoll: Klicken Sie auf die Option „Protokolle“, um die Details zu jedem einzelnen Ereignis und Datenaustausch zu sehen, nachdem die Route innerhalb des Alumio iPaaS ausgeführt wurde.

7. Überprüfen Sie die Integration: Der letzte Schritt, um zu überprüfen, ob Ihre Integration über Alumio tatsächlich funktioniert, besteht darin, Ihre tatsächliche Bewerbung zu überprüfen, um festzustellen, ob die neuen Daten an sie gesendet wurden. In unserem Beispiel müssen wir Shopify überprüfen, um festzustellen, ob Produkte von Picqer erfolgreich darin integriert wurden.

Damit ist eine sehr grundlegende Anleitung abgeschlossen, wie Sie Ihre erste Integration konfigurieren, testen und manuell ausführen können. Alumio iPaaS hilft Ihnen jedoch nicht nur dabei, schnell Verbindungen zwischen Endpunkten aufzubauen, sondern hilft Ihnen auch dabei, Ihre Integrationen zu automatisieren, zu transformieren und zu orchestrieren. In unserer nächsten Lektion wollen wir uns nun damit befassen, wie Sie diese Integration intelligent planen und automatisieren können und wie Sie einige grundlegende Transformers anwenden können, um diese Integration anzupassen.