Enterprise Integration mit Dell Boomi (Teil 1 von 5)

Hallo Integrations-Enthusiasten.

Willkommen zum ersten Teil von Enterprise Integration mit Dell Boomi, einer Blogreihe für alle, die ERP-Integration mit Dell Boomi auf unterhaltsame und praxisnahe Weise lernen möchten.

In unserer vorherigen Blogreihe haben wir die Welt der Enterprise Integration bereits über SAP CPI kennengelernt. Wir werden einen ähnlichen Ansatz wählen, aber zusätzlich analysieren, wie unterschiedlich diese beiden Werkzeuge sind, wenn es darum geht, Integrations- bzw. Prozessflüsse mit demselben Zweck zu bauen.

Voraussetzung

Es wird vorausgesetzt, dass Sie die Grundlagen von Dell Boomi und Boomi AtomSphere kennen. Falls nicht, arbeiten Sie diese kurze, aber umfassende Einführung durch.

Wenn Sie die Blogreihe zu SAP CPI noch nicht gelesen haben, empfiehlt es sich, das nachzuholen, da wir für diese Blogreihe dasselbe Szenario verwenden. Die Vertrautheit mit den vorherigen Blogposts hilft Ihnen dabei, die praktischen Unterschiede zwischen Dell Boomi und CPI besser zu verstehen, sie ist aber keineswegs zwingend erforderlich.

Szenario

Wir betreiben einen Supermarkt namens "Northwind". Für die Bestandsverwaltung pflegen wir eine Liste von Produkten mit relevanten Details wie Produktname, Kategorie, verbleibendem Lagerbestand, Stückpreis und Lieferanten-Id. Außerdem haben wir für jedes Produkt einen Schwellenwertparameter namens "Reorder Level" definiert. Sobald der Lagerbestand eines Produkts diesen Schwellenwert erreicht oder unterschreitet, wird es für eine Nachbestellung berücksichtigt. Jeden Tag müssen wir die Liste der nachzubestellenden Artikel (im CSV-Format) zusammen mit den Lieferantendetails per E-Mail versenden, damit unser Filialleiter die Bestellungen auslösen kann.

Unsere Datenquelle

Für unseren Anwendungsfall verwenden wir einen öffentlichen OData-Service (Northwind). Nachfolgend einige Beispiele dafür, wie die Datenfeeds für unser Bestandsverwaltungssystem aussehen:

Liste der Produkte:

Liste der Lieferanten:

Vorgehen

Wie beim letzten Mal teilen wir das Problem in kleinere Teile auf und lösen einen Teil nach dem anderen. Beim letzten Mal hatten wir die folgenden Schritte zur Lösung identifiziert:

1. Die Integration so konfigurieren, dass sie täglich läuft
2. Die Liste der Produkte abrufen
3. Für jedes Produkt in der Liste ermitteln, ob eine Nachbestellung erforderlich ist
4. Wenn ein Produkt nachbestellt werden muss, die Lieferanteninformationen abrufen
5. Eine Liste der nachzubestellenden Produkte samt Lieferanteninformationen erstellen
6. Die Liste in das CSV-Format konvertieren
7. Die Liste per E-Mail an den Manager senden

Die in Dell Boomi zu befolgenden Schritte werden etwas anders aussehen. In SAP CPI hatten wir die Integration mit der Start-Timer-Shape so konfiguriert, dass sie täglich läuft, und deshalb war es sinnvoll, Ihnen diese Shape und das zugrundeliegende Konzept im ersten Schritt vorzustellen. In Boomi erfolgt die Prozessplanung jedoch erst nach dem Deployment des Prozesses. Daher ist es besser, dies später aufzugreifen. Die übrigen Schritte belassen wir so, wie sie waren, damit wir die Unterschiede zwischen SAP CPI und Dell Boomi bewerten können. Bitte beachten Sie, dass der Prozessfluss, den wir erstellen werden, möglicherweise nicht der optimalste ist. Ziel ist es, beim Bau dieses Prozessflusses so viele Komponenten wie möglich kennenzulernen, und wir nehmen ein paar zusätzliche Schritte gerne in Kauf, wenn das zu besseren Vergleichen führt.

Die neue Liste der Schritte sieht daher etwa so aus:

1. Die Liste der Produkte abrufen
2. Für jedes Produkt in der Liste ermitteln, ob eine Nachbestellung erforderlich ist
3. Wenn ein Produkt nachbestellt werden muss, die Lieferanteninformationen abrufen
4. Eine Liste der nachzubestellenden Produkte samt Lieferanteninformationen erstellen
5. Die Liste in das CSV-Format konvertieren
6. Die Liste per E-Mail an den Manager senden
7. Den Prozess so konfigurieren, dass er täglich läuft

Nachdem wir nun die grundlegenden Schritte kennen, beginnen wir mit der Entwicklung des Prozessflusses.

Melden Sie sich hier bei Ihrem Boomi-Konto an. Falls Sie noch kein Konto haben, können Sie sich für eine kostenlose Testversion registrieren.

Nach der Anmeldung erstellen wir einen neuen Ordner für dieses Projekt. Das geschieht im Component Explorer (linke Leiste), indem Sie auf den Dropdown-Pfeil neben dem obersten Ordner klicken (der denselben Namen wie Ihr Kontoname trägt) und "New Folder" auswählen.

Nun erstellen wir unsere Process-Komponente. Zuvor klären wir aber, was diese Begriffe bedeuten.

Components in Boomi

Components sind die wiederverwendbaren Konfigurationsobjekte, die in Prozessen verwendet werden. Sie werden im Component Explorer angezeigt. Components können einmal erstellt und von Process Shapes über mehrere Prozesse hinweg referenziert werden.

Process

Ein Process besteht aus einer Reihe von Schritten, dargestellt durch Shapes, die vorgeben, wie der Prozess Daten von der Quelle zum Ziel abruft, verarbeitet, weiterleitet und sendet.

Sobald der Prozess erstellt wurde, ist er auf der Canvas sichtbar und eine Start Shape ist standardmäßig vorhanden.

Klicken Sie auf die Start Shape, um sie zu konfigurieren. Sie kann auf einen der folgenden 3 Typen gesetzt werden:

1. Connector: Holt Daten über einen der Application- oder Technology-Connectors in den Prozess oder sendet Daten aus dem Prozess heraus.
2. Data Passthrough: Holt Daten aus einem anderen übergeordneten Prozess oder einer anderen externen Quelle in den Prozess.
3. No Data: Der Prozess empfängt oder ruft keine Daten aus einer Quelle ab. Stattdessen wird ein einzelnes leeres Dokument durch den Prozessfluss weitergereicht.

Wir verwenden "No Data", weil unser Prozess eingeplant werden soll und zu Beginn keine Daten erwartet.

In SAP CPI haben wir verschiedene Kombinationen aus Start Shape und Connectors verwendet, um das zu erreichen, was diese Start Shape in Dell Boomi leisten kann. Diese Connectors waren in SAP CPI nicht Teil der Shape selbst. Stattdessen waren sie als Verbindung zwischen einer Sender Shape und der Start Message Shape dargestellt. In Boomi fehlen Sender Shapes und diese externen Connector Shapes. Bemerkenswert ist, dass Connector-Komponenten in Dell Boomi weiterhin recht unabhängig und wiederverwendbar sind, obwohl die Start Shape die Möglichkeit bietet, Connectors anzugeben. Darüber sprechen wir später noch ausführlicher.

Schritt 1: Liste der Produkte abrufen

Der erste Schritt dieser Integration besteht darin, die Liste der Produkte in unserem Bestand abzurufen. Unsere Produktliste kann über das OData-Protokoll abgerufen werden. Falls Sie sich mit dem OData-Protokoll noch nicht gut auskennen, keine Sorge: Diese Seite enthält alles, was Sie im Moment wissen müssen.
Um diese Daten abzurufen, verwenden wir einen OData Client Connector. Mit diesem Connector lassen sich Daten aus einer OData-Quelle abrufen (Get), löschen (Delete), anlegen (Create), aktualisieren (Update) und abfragen (Query).

Wir unterteilen diesen Schritt weiter in kleinere Schritte und gehen sie nacheinander durch.

Schritt 1.1: Shape auf der Canvas hinzufügen

Sie finden diesen Connector über die Suche in der Leiste "Search Shapes". Ziehen Sie ihn per Drag-and-drop neben die Start Shape auf die Canvas.

Schritt 1.2: Connector Shape konfigurieren

Sie werden von den Konfigurationsoptionen wie folgt begrüßt:

Geben Sie einen Display Name für diese Shape ein. Da wir Daten aus unserer OData-Quelle auf Basis einer bestimmten Bedingung abrufen möchten, wählen wir als Action "Query".

Connector Shapes sind mit zwei Komponenten verknüpft: Connection und Operation.

• Connection: Die physische Verbindungsinformation. Sie definieren die URL einer Datenquelle oder Anwendung und hinterlegen die Zugangsdaten für den Zugriff.
• Operation: Die aufzurufende Funktion oder die zu verarbeitenden Dateien, also wie die Daten verarbeitet werden.

Beide Komponenten sind wiederverwendbar und stehen im gesamten Prozess zur Verfügung. Sobald sie erstellt wurden, finden Sie sie in unserem Projektordner unter "Connectors".

Schritt 1.3: Connection hinzufügen/auswählen

Klicken Sie auf die grüne Plus-Schaltfläche im Dropdown-Feld neben Connection.

Tragen Sie die Service-Root-URL für unseren OData-Service ein. In diesem Fall müssen wir Folgendes eintragen: https://services.odata.org/Northwind/Northwind.svc

Als Nächstes geben wir die OData-Version an. Zur Auswahl stehen V 1.0, V 2.0 und V 4.0. Der Vergleichbarkeit mit unserer vorherigen Blogreihe halber wählen wir V 2.0.

Danach müssen wir das OData-Format wählen. Zur Auswahl stehen Atom und JSON. Auch hier wählen wir Atom, um möglichst nah an dem zu bleiben, was wir in SAP CPI gemacht hatten.

Da unser OData-Service keine Authentifizierung erfordert, setzen wir den Authentication Type auf "None".

Weitere Einstellungen sind in dieser Connection nicht nötig, und wir können die Verbindung nun testen, indem wir auf der vorherigen Maske rechts auf die Schaltfläche "Test Connection" klicken.

Wählen Sie den Atom aus, mit dem Sie diese Verbindung testen möchten, und klicken Sie auf "Next". Wenn die Verbindungsdetails korrekt sind, erhalten Sie die folgende Maske. Sie können auf "Finish" und anschließend auf der Konfigurationsseite der Connection auf "Save and Close" klicken. Nachdem Sie diese Connection gespeichert haben, sehen Sie sie im Ordner "Connectors" innerhalb Ihres Projektordners.

Schritt 1.4: Operation hinzufügen/auswählen

Klicken Sie auf das grüne Plus-Symbol im Operation-Dropdown-Feld, dann erhalten Sie eine Maske wie diese:

Sie werden feststellen, dass die Connector Action bereits auf QUERY gesetzt ist, da wir das in der Connector Shape selbst angegeben hatten.

Bislang haben wir die URL für unseren OData-Service und die Connector Action festgelegt. Wir haben aber noch nicht definiert, zu welchem Objekt wir Details abrufen möchten. Holen wir das nach. Klicken Sie rechts auf der Maske auf die Schaltfläche "Import".

Der OData Client Import Wizard öffnet sich. Wählen Sie einen Atom für die Ausführung dieser Anfrage, wählen Sie die im vorherigen Schritt erstellte Connection und klicken Sie auf "Next". Beachten Sie, dass wir bei Bedarf auch Filter setzen können, das ist aber nicht zwingend.

Wählen Sie auf der nächsten Maske "Products" aus dem Dropdown-Feld und klicken Sie auf "Next". Prüfen Sie Ihre Auswahl und klicken Sie auf "Finish". Damit haben wir das Objekt, zu dem wir Details abrufen möchten, erfolgreich ausgewählt.

Nun müssen wir das Response Profile für diese Operation auswählen. Klicken Sie auf das Eingabefeld für das Response Profile, um es auszuwählen, und navigieren Sie in den Projektordner. Dort finden Sie das Response Profile für unsere Query Operation.

An diesem Punkt haben wir den zu verwendenden OData-Service, das Objekt und das erwartete Response Profile festgelegt. Nun müssen wir angeben, welche Felder abgefragt werden sollen, und die Query-Filter definieren.

Diese Optionen finden wir im unteren Bereich der Maske. Klicken Sie auf den Reiter "Fields", um die Felder auszuwählen, die in der Response enthalten sein sollen. Wir wählen das gesamte Product-Objekt aus, da wir alle Felder in der Response haben möchten.

Nun müssen wir im Reiter "Filter" Filter hinzufügen. Warum ist das wichtig? Wenn wir keine Filter setzen, wird jedes Produkt abgerufen, einschließlich der Produkte, die ausgelistet wurden, und derjenigen, die bereits nachbestellt wurden. Daher wollen wir Filter hinzufügen, um sicherzustellen, dass nur relevante Produkte abgerufen werden.

Klicken Sie auf das Dropdown-Symbol neben "Filter" und dann auf "Add Logical Sub-Group". Das ist erforderlich, weil wir Bedingungen auf Basis von 2 Feldern setzen und diese logisch verknüpfen wollen, um unsere finale Filterbedingung zu bilden.

So sieht die logische Untergruppe aus. Da beide Feldfilter zutreffen müssen, damit ein Produkt abgerufen wird, wählen wir AND als Operator.

Klicken Sie nun auf das Dropdown-Symbol neben diesem "Logical - AND" und anschließend auf "Add Expression". Klicken Sie auf die Expression und geben Sie ihr zur Identifikation einen passenden Namen. Wir nennen sie "Units reordered".

Als Nächstes wählen wir das Feld, auf das dieser Filter angewendet werden soll.

Wählen Sie unter "Properties" das Feld "UnitsOnOrder". Als Operator wählen wir "Equals". Damit ist die Filterkonfiguration abgeschlossen. Später legen wir einen Parameter fest, der gegen diese Bedingung geprüft wird.

Wiederholen Sie ähnliche Schritte für den zweiten Filter.

Klicken Sie auf "Save and Close".

Schritt 1.5: Parameter konfigurieren

Nun kommen wir zum letzten Schritt der Query-Erstellung, dem Hinzufügen von Parametern. Wechseln Sie in den Reiter "Parameters" der Connector Shape.

Hier sehen Sie eine Aufforderung, die Parameter zu importieren, die wir im vorherigen Schritt festgelegt hatten. Das ist ein einfacher Weg, Parameter zu setzen. Alternativ können Sie auf die Schaltfläche "Add Parameter" (+) klicken. Wählen Sie über das mit "Input" gekennzeichnete Dropdown den Namen des Parameters, für den Sie einen Wert angeben möchten. Als Type belassen wir "Static". Für "Units reordered" geben wir als Static Value 0 an und für "Discontinued" den Wert false. Klicken Sie auf "Ok" und speichern Sie den Prozessfluss.

Nun ist unser Connector vollständig konfiguriert und bereit zum Testen. Klicken Sie auf den Pfeil am Ende der Start Shape und ziehen Sie ihn zur Connector Shape. Der Pfeil wird grün und die beiden Shapes sind im Prozessfluss verbunden.

Man könnte einwenden, dass das komplizierter ist als das, was wir in SAP CPI gemacht hatten. Aber das heißt nicht, dass es keine Vorteile mit sich bringt. Alle Komponenten, die wir in den vorherigen Schritten erstellt haben, stehen zur Wiederverwendung bereit und lassen sich leicht neu konfigurieren, ohne den Prozess selbst zu bearbeiten.

Test Mode

Wir besprechen nun eine sehr einfache Möglichkeit, unsere Prozessflüsse zu testen, ohne sie tatsächlich zu deployen. AtomSphere bietet die Möglichkeit, Integrationen in einer visuellen Echtzeitansicht des Dokumentenflusses zu testen. Das nennt sich Test Mode.

Eine ähnliche Testoption wurde kürzlich auch in SAP CPI ergänzt, in Boomi ist sie hingegen schon recht lange Bestandteil.

Um den Test Mode zu nutzen, klicken Sie oben rechts auf der Canvas auf die Schaltfläche "Test", wählen Sie den Atom, den Sie zum Testen verwenden möchten, und klicken Sie dann auf "Run Test".

Nach einem erfolgreichen Testlauf sehen Sie die folgende Maske.

Sie können auf die Shapes klicken, um die zugehörigen Logs und Daten zu sehen.

Wenn Sie auf eine Datendatei klicken, sehen wir deren Inhalt wie im folgenden Screenshot gezeigt:

Fazit

In diesem Blogpost haben wir das Szenario festgelegt, uns mit der Start Shape und ihren Optionen vertraut gemacht und eine Connector Shape erstellt und konfiguriert. Außerdem haben wir gelernt, wie man den Test Mode in Dell Boomi nutzt. Vor allem aber haben wir uns beim Erstellen unseres Prozesses die praktischen Unterschiede zwischen SAP CPI und Dell Boomi angesehen.

An dieser Stelle legen wir eine Pause ein, damit wir uns nicht mit zu vielen Informationen auf einmal überladen. In den nächsten Blogposts lernen wir mehr über Dell Boomi Shapes, während wir sie einsetzen, um unser Problem zu lösen. Es empfiehlt sich, mit den Shapes vertraut zu werden, sobald wir ihnen begegnen. Das war es für den Moment, wir setzen unsere Reise durch die Enterprise Integration bald fort. Bis dahin: Auf Wiedersehen und viel Freude beim Lernen!