Unternehmensintegration mit Dell Boomi (Teil 4 von 5)

Hallo Integrationsbegeisterte!

Willkommen zum vierten Teil der Enterprise Integration mit Dell Boomi. Im dritten Teil (hier lesen, falls Sie es noch nicht getan haben) hatten wir die Lieferantendaten für jedes Produkt, das nachbestellt werden soll, abgerufen. In diesem Blogbeitrag werden wir den vierten und fünften Schritt besprechen:

1. Erhalten Sie die Liste der Produkte
2. Ermitteln Sie für jedes Produkt in der Liste, ob eine Nachbestellung erforderlich ist.
3. Wenn das Produkt nachbestellt werden muss, Informationen über den Lieferanten einholen
4. Erstellen Sie eine Liste der nachzubestellenden Produkte zusammen mit Lieferanteninformationen
5. Liste in csv-Format umwandeln
6. Liste per E-Mail an den Manager senden
7. Konfigurieren Sie den Prozess so, dass er jeden Tag ausgeführt wird

Schritt 4+5: Erstellen Sie eine Liste der nachzubestellenden Produkte zusammen mit den Lieferanteninformationen im CSV-Format.

Zu diesem Zeitpunkt haben wir sowohl Produkt- als auch Lieferantendaten bei uns. Es ist nun an der Zeit, diese zu kombinieren, so dass jedes Produkt auch Details über seinen jeweiligen Lieferanten enthält. Wir werden dies mit Hilfe einer Nachrichtenform erreichen.  

Message Shape erzeugt eine Freifluss-Textnachricht aus einem dynamischen oder statischen Satz von Eingabeparametern. Dokumente, die an ein Nachrichtenformular gesendet werden, werden umgewandelt, und die Dokumente, die herauskommen, haben das Format der Nachricht.

Suchen Sie die Form "Nachricht" in der Leiste "Formen suchen" und platzieren Sie sie neben der vorherigen Form. Nun werden wir dieses Shape konfigurieren. Nach der Kombination von Produkten und Lieferanteninformationen ist dies das gewünschte Ergebnis:

30
	Nord-Ost Matjeshering
	8
	10 - 200 g Gläser
	25.8900
	10
	15
	13
	Nord-Ost-Fisch Handelsgesellschaft mbH
	Sven Petersen
	Koordinator Auslandsmärkte
	Frahmredder 112a
	27478
	Deutschland
	(04721) 8713

Wir haben bereits Lieferanteninformationen als Inhalt unseres Dokuments, und wir können alle Felddaten mit dem XML-Profil für die Abfrage von Lieferanteninformationen leicht abrufen. In einem unserer früheren Blogbeiträge hatten wir außerdem Produktdetails in den dynamischen Dokumenteigenschaften gespeichert und können sie nun von dort abrufen.

Im Feld Variablen der Nachrichtenform werden wir diese Felddaten aus Profilelementen und dynamischen Dokumenteigenschaften hinzufügen. Klicken Sie auf das Symbol + neben diesem Feld. Um Profilelemente hinzuzufügen, wählen Sie als Parametertyp Profilelement und konfigurieren Sie es wie unten gezeigt.

Da wir dies bereits einmal getan haben, um Parameter für den OData-Client-Connector zu erstellen, werden wir die Schritte nicht noch einmal im Detail besprechen.

Um Daten aus dynamischen Dokumenteigenschaften zu verwenden, wählen wir als Typ "Dokumenteigenschaft". Sie werden feststellen, dass es keine Möglichkeit gibt, den Typ als "Dynamische Dokumenteigenschaft" anzugeben. Diese Option ist in Boomi standardmäßig nicht sichtbar.

Klicken Sie anschließend auf das Suchsymbol neben dem Feld "Dokumenteigenschaft". Daraufhin wird das folgende Dialogfeld geöffnet:

Klicken Sie nun auf das Dropdown-Menü Eigenschaftstyp und Sie sehen die Option "Dynamische Dokumenteigenschaft".

Geben Sie den Namen der Eigenschaft ein, die Sie abrufen möchten, und den Standardwert für diese Eigenschaft, der verwendet werden soll, wenn keine Daten verfügbar sind (nicht obligatorisch). Wiederholen Sie diesen Schritt für jedes Datenfeld, das in den Eigenschaften des dynamischen Dokuments gespeichert wurde.

Nachdem Sie die Variablen hinzugefügt haben, werden Sie feststellen, dass jeder von ihnen eine Nummer zugewiesen ist. Diese Nummer kann im Feld Nachricht verwendet werden, um auf diese Variable zu verweisen.

Wir können also die Nachricht als :

{1}
	{2}
	{3}
	{4}
	{5}
	{6}
	{7}
	{8}
	{9}
	{10}
	{11}
	{12}
	{13}
	{14}
	{15}

Wie bereits erwähnt, werden Zahlen in geschweiften Klammern verwendet, um auf den Inhalt dieser Variablen zu verweisen.

In vielerlei Hinsicht entspricht die Form der Nachricht der Form des "Content Modifier" von SAP CPI. In einem Content Modifier hätten wir den Nachrichtentext auf ähnliche Weise festlegen können. Anstelle von Zahlen, die die Variablen bezeichnen, hätten wir jedoch den Typ (Header/Property) und den Namen der Variablen verwendet. Der Nachrichtentext hätte dann etwa so ausgesehen:

${Eigenschaft.ProduktID}
	${Eigenschaft.Produktname}
	${Eigenschaft.KategorieID}
	${Eigenschaft.MengeEinheit}
	${Eigenschaft.StückPreis}
	${Eigenschaft.StückInBestand}
	${property.ReorderLevel}
	${Eigenschaft.LieferantenID}
	${Eigenschaft.Firmenname}
	${Eigenschaft.Kontaktname}
	${Eigenschaft.KontaktTitel}
	${Eigenschaft.Adresse}
	${Eigenschaft.Postleitzahl}
	${Grundstück.Land}
	${Eigenschaft.Telefon}

Da wir nun alle gewünschten Daten haben, werden wir sie in das CSV-Format (Comma Separated Values) konvertieren. Dies unterscheidet sich geringfügig von dem, was wir in SAP CPI gemacht haben, wo wir zuerst alle Xml-Knoten gesammelt und dann auf einmal in CSV konvertiert haben. Bitte beachten Sie, dass wir dasselbe auch in Boomi hätten tun können, aber ich denke, dies ist eine gute Gelegenheit, einen anderen Ansatz für dasselbe Problem zu erkunden.

Für die Konvertierung in CSV werden wir eine Kartenform verwenden. Karten werden verwendet, um Daten von einem Format in ein anderes umzuwandeln, oder genauer gesagt, von einem Profil in ein anderes. Das Map-Shape verweist auf eine vordefinierte Map-Komponente.

Bevor wir eine Kartenform verwenden, werden wir ein Profil für das resultierende CSV-Format erstellen. Klicken Sie dazu auf die Schaltfläche +Neu in der oberen linken Ecke des Canvas. Dadurch wird ein Dialog zum Erstellen einer neuen Komponente geöffnet.

Es wird ein neues Profil erstellt.

Klicken Sie auf den Dropdown-Pfeil neben "Elemente" und dann auf "Element hinzufügen".

Für jedes Datenfeld in Bezug auf Produkt und Lieferant, das wir in unserer Nachricht haben, werden wir ein entsprechendes Element in diesem Profil erstellen.

Abgesehen vom Namen des Elements nehmen wir keine Änderungen vor. Speichern und schließen Sie das Profil, sobald alle Elemente hinzugefügt wurden.

Klicken Sie auf die Registerkarte Optionen, um das Begrenzungszeichen für dieses Profil festzulegen. Wir werden ein Semikolon als Begrenzungszeichen verwenden. Dies kann wie folgt angegeben werden:

Auf ähnliche Weise werden wir ein Profil für die kombinierten Daten im XML-Format erstellen. Wiederholen Sie die Schritte zum Erstellen eines Profils, aber erstellen Sie dieses Mal ein XML-Profil. Dies ist der Bildschirm, den Sie sehen werden, wenn Sie ein neues XML-Profil erstellen.

Klicken Sie auf Importieren und Sie werden zu einem XML-Import-Assistenten weitergeleitet.

Sie können dieses Profil erstellen, indem Sie einfach die Daten aus der vorherigen Form importieren. Diese Daten können Sie erhalten, indem Sie den Prozess im Testmodus ausführen. Nach dem Importieren sieht das Profil wie folgt aus:

Nun, da wir sowohl das Quell- als auch das Zielprofil haben, fügen wir eine Kartenform auf der Leinwand hinzu. Suchen Sie nach dem Map-Shape und fügen Sie es nach dem Message-Shape hinzu, das wir zuvor konfiguriert hatten.

Klicken Sie auf die grüne Schaltfläche + neben dem Feld "Karte". Es wird eine neue Kartenkomponente erstellt.

Wählen Sie für Quelle zuordnen das von uns erstellte XML-Profil und für Ziel zuordnen das Flat-File-Profil aus. Nun müssen wir jedes Feld im Quellprofil auf sein Gegenstück im Zielprofil abbilden. Ziehen Sie dazu einfach eine Verbindung/Linie vom Quellfeld zum Zielfeld. Nachdem Sie alle Felder zugeordnet haben, sieht die Map-Komponente wie folgt aus:

In komplexeren Szenarien hätten wir diesen Zuordnungen Funktionen hinzufügen können. Da unsere Anforderung recht einfach ist, brauchen wir das nicht. Sie können mehr über diese Funktionen lesen hier.

Speichern und schließen Sie die Map-Komponente und führen Sie den Prozess im Testmodus aus, nachdem Sie die Map-Form mit dem Rest des Prozesses verbunden haben. Sie werden feststellen, dass die Ausgabe des Map Shapes im CSV-Format erfolgt. Aber jedes Dokument enthält immer noch Details zu einem einzelnen Produkt und wir haben noch keine kombinierte Liste. Diese Liste kann leicht erstellt werden, indem man alle diese Dokumente miteinander kombiniert. Zu diesem Zweck werden wir ein "Datenprozess-Shape" verwenden.

Data Process Shape bietet Ihnen eine Reihe von Optionen für die Bearbeitung von Dokumentdaten innerhalb eines Prozesses, vom Aufteilen und Kombinieren von Dokumenten bis hin zum Zippen und Entpacken von Daten. Sie können mehrere Verarbeitungsschritte definieren, um mehr als eine Aktion an den Dokumentdaten durchzuführen. Die Verarbeitungsschritte werden in der Reihenfolge ausgeführt, die in der Datenprozessform definiert ist. Jeder Verarbeitungsschritt bearbeitet die vom vorherigen Verarbeitungsschritt ausgegebenen Daten.

In SAP CPI hatten wir stattdessen ein 'Gather'-Shape verwendet. Die Funktionen des Shapes "Gather" sind eine Untermenge der Funktionen des Shapes "Data Process" in Boomi.

Suchen und platzieren Sie ein Shape "Datenprozess" auf der Arbeitsfläche und verbinden Sie es mit dem Shape "Karte". Fügen Sie innerhalb des Datenprozess-Shape einen Verarbeitungsschritt "Dokumente kombinieren" hinzu und konfigurieren Sie ihn wie folgt:

Wir haben den Profiltyp als Flachdatei angegeben, da wir die Daten bereits in das CSV-Format konvertiert haben.

Wenn Sie den Prozess jetzt im Testmodus ausführen, erhalten Sie eine Liste von Produkten und Lieferanteninformationen im CSV-Format, was das Ziel dieser Lektion war. Wir werden diesen Blog an dieser Stelle unterbrechen, damit Sie die Themen, auf die wir gestoßen sind, vollständig verstehen und würdigen können. In diesem Blog-Beitrag haben wir etwas über Message Shape, Map Shape, Data Process Shape sowie die Erstellung von Flat File und XML Profiles gelernt. Wir haben auch die Gegenstücke zu diesen Shapes in SAP CPI besprochen. Im nächsten Blog-Beitrag werden wir die Daten für den Versand vorbereiten und lernen, wie man einen Mail-Connector verwendet, um unsere Reise in die Unternehmensintegration mit Dell Boomi abzuschließen. Bis dahin, auf Wiedersehen und viel Spaß beim Lernen!