020: Recycling-Heroes - Launchpad Integration (Contact)
Damit der Anwender mit unserer Anwendung arbeiten kann, müssen wir sie ins Fiori Launchpad integrieren. Hier kümmern wir uns um die Kachel, Pages und Spaces, sodass der Anwender seinen Arbeitsplatz erhält.
Inhaltsverzeichnis
Einleitung
Im letzten Video haben wir das Deployment auf das System durchgeführt und die Anwendung zur Verfügung gestellt. Allerdings können wir sie immer noch nicht im Launchpad aufrufen und damit keinen User zuordnen. Deshalb schauen wir uns in dieser Folge an, wie wir die Zuweisung machen, Pages und Spaces definieren und die Anwendung dem Anwender zur Verfügung stellen.
IAM App
Nach dem Deployment haben wir nun die BSP Applikation und das Launchpad App Descriptor Item zur Verfügung, die wir nun auch für die weitere Anlage benötigen. Definieren wir uns im ersten Schritt eine IAM App, hierbei handelt es sich um ein zusätzliches Artefakt, das wir zum Berechtigen benötigen. Wir vergeben der App einen Namen, eine Beschreibung und einen Typen. Da es sich um eine externe Fiori Anwendung handelt, wählen wir den Typen "External App".
Nach der Anlage ordnen wir die Launchpad Konfiguration zu, hier befindet sich die Konfiguration zur Anwendung, sowie die Navigationskonfiguration für das Launchpad. Kennst du den Eintrag nicht aus dem Kopf, dann kannst du über STRG + 1 den Content Assist aufrufen. Neben der Launchpad Konfiguration, wird über das Objekt auch der Service berechtigt, den man zur Ausführung braucht, sowie es können zusätzliche Berechtigungsobjekte zugeordnet werden.
Zum Abschluss speichern wir das Objekt, ein Aktivieren ist hier nicht nötig. Damit die Anwendung und die Konfiguration im Launchpad zur Verfügung stehen, musst du "Publish Locally" ausführen. Die Ausführung kann immer etwas Zeit in Anspruch nehmen.
Business Catalog
Sind wir mit diesem Schritt fertig, dann können wir die IAM App noch nicht berechtigen, sondern benötigen dafür einen Business Catalog. Dieser bündelt verschiedene Apps zu einem Paket und später können wir verschiedene Business Kataloge zu einer Rolle für den Anwender zusammenfassen.
In diesem Beispiel können wir direkt aus der IAM App einen neuen Business Katalog anlegen und die App zuordnen. Dazu klickst du auf den entsprechenden Link im Objekt, um die Anlage des Katalogs zu starten. Hier benötigen wir einen Namen und eine Beschreibung. Beim Namen verwenden wir meist ein BC am Anfang, um die Business Kataloge abzugrenzen. Haben wir das Objekt angelegt, müssen wir noch die Zuordnung definieren. Grundsätzlich sind alle entsprechenden Informationen vorbefüllt und wir müssen lediglich das Paket definieren. Sind die beiden Objekte angelegt, können wir die Zuordnung direkt zu machen, da wir diese nicht weiter benötigen. Im Business Katalog drücken wir nun ebenfalls "Publish Locally", damit der Katalog im Launchpad zur Verfügung steht. Dies kann eine Weile in Anspruch nehmen.
Ist der Katalog veröffentlicht, prüfen wir noch den Reiter Apps. Über die Zuordnung wurde unsere App nun dem Katalog zugeordnet, wenn ein Anwender den Katalog erhält, dann kann er die angegebenen Apps und weiteren Objekte verwenden.
Business Role
Einen Business Katalog können wir nicht direkt einem User zuordnen, sondern benötigen dazu immer eine Business Role. Dazu gehen wir ins Launchpad des Systems auf die Kachel "Maintain Business Roles" und schauen, ob es bereits Rollen mit ZRH gibt. Über den Button "New" legen wir eine neue Rolle mit Beschreibung an. Die Business Role ID kann später jederzeit geändert werden, falls du sie noch anpassen musst. Legen wir im ersten Schritt eine Rolle für den Admin an, dieser kann alle Anwendungen mit allen Berechtigungen ausführen, was uns für den Anfang reicht.
Im Bereich Business Catalogs ordnen wir nun unseren Katalog der Rolle zu. Über "Add" starten wir die Suche und können auch auf den Namen des Katalogs einschränken. Mit "Apply" können wir den Katalog zuordnen und dann im Popup weiterarbeiten, mit "OK" wird der Katalog hinzugefügt und die Bearbeitung beendet. Im Anschluss können wir direkt auf Business Users wechseln und unseren eigenen User eintragen, damit dieser Berechtigungen für die neue Rolle erhält. Zum Abschluss müssen wir noch auf "General Role Details" wechseln und "Write, Read" auf "Unrestricted" setzen, damit die Rolle auch die nötigen Änderungsberechtigungen erhält. Das ist vor allem später nötig, wenn wir mit Berechtigungen und Abgrenzungen arbeiten. Zum Abschluss können wir mit "Save" die Rolle anlegen und zuweisen lassen.
Damit wir nun die neuen Berechtigungen testen können, müssen wir uns zuerst vom System ab- und wieder anmelden, damit die neuen Berechtigungen greifen. Damit wir die App in unsere Home-Page einbinden können, wechseln wir über das Menü zum App Finder. Dort können wir dann nach der neuen Anwendung suchen und über das Plus Symbol die Anwendung hinzufügen, wo wir sie brauchen. Zum Schluss rufen wir die Anwendung auf und sehen sofort die Daten.
Space
Der der Anwender nicht immer erst die Anwendung über den App Finder suchen soll, wollen wir ihm direkt einen entsprechenden Bereich einrichten. Dazu wechseln wir in die Anwendung "Manage Launchpad Spaces". Dort können wir über den "Create" Button einen neuen Space im System anlegen. Die ID nicht unbedingt relevant für die Anzeige, hier ist vor allem der Titel später wichtig. Um es einfach zu halten, lassen wir Titel und Beschreibung auf demselben Text und ergänzen die Beschreibung noch ein wenig. Als Transport benötigen wir einen Customizing Transport, solltest du noch keinen haben, musst du noch einmal die Anwendung wechseln, um einen im System anzulegen.
Da wir noch keine Page haben, setzen wir auch hier gleich den Haken, um mit dem Space zusammen eine Page zu definieren. Den Seiten werden später die Anwendungen zugeordnet und zeigen diese entsprechend in Gruppen an. Der Page Titel wird später einmal relevant, wenn wir mehr als eine Seite einem Space zugeordnet haben. Über "Create" legen wir die beiden Objekte an.
Um nun gleich unsere Anwendung zuordnen zu können, hinterlegen wir den neuen Space an unserer Business Rolle. Wechseln wir dazu noch einmal die Anwendung und gehen über "Edit" in den Änderungsmodus der Rolle. Nun können wir auf den Reiter "Launchpad Spaces" wechseln und unseren neuen Space hinzufügen. Dazu wechseln wir im Popup von "Use Space Template" zu "Use Space", da wir unseren Bereich manuell im Launchpad definiert haben. In der Liste können wir dann nach unserem Bereich suchen und diesen wählen. Speichern nun nicht vergessen, damit die Änderungen übernommen werden.
Page
Um nun die Seite zu bearbeiten, öffnen wir die Anwendung "Manage Launchpad Pages" und gehen auf unsere neue Seite ZRH_CORE. Über "Edit" können wir die Seite bearbeiten. Vergeben wir daher für unseren neuen Bereich einen Namen, dieser taucht dann als Überschrift auf der Seite auf.
Da wir den Space bereits einer Rolle zugeordnet haben, erhalten wir Vorschläge für Anwendungen aus den entsprechenden Rollen, die wir nun zuordnen können. Damit ist am Ende sichergestellt, dass wir nur Anwendungen aufnehmen, die auch in den zugeordneten Rollen enthalten sind. Über Add können wir definieren, in welcher Größe die Kachel im Bereich hinzugefügt wird. Über "Save" speichern wir den aktuellen Stand der Seite und sind damit erst einmal fertig.
Anzeige
Um nun den neuen Bereich zu sehen, müssen wir uns ab- und wieder anmelden, damit die Änderungen, Strukturen und Berechtigungen greifen. Sollte der Bereich dann noch nicht zu sehen sein, können wir diesen über das Menü hinzufügen. Dazu gehen wir auf "All Spaces" und können nach unserem Bereich suchen und diesen wieder anpinnen.
Im Bereich sollte nun unsere Anwendung zu sehen sein. Wir können diese nun ebenfalls starten und sind somit mit der Einbindung ins Launchpad fertig.
Zusammenfassung
In dieser Folge hatten wir uns angeschaut, wie wir die Anwendung in eine IAM App packen und diese einem Business Catalog zuordnen. Diesen haben wir dann schließlich einer Rolle zugeordnet und dafür einen Space und eine Page definiert. Zum Abschluss erhält nun jeder Anwender mit dieser Rolle entsprechende Berechtigungen und sollte den Space als Standardzugriff erhalten.
Damit sind wir am Ende dieser Folge. Ich bedanke mich fürs Zuschauen und bis zum nächsten Mal dann.
YouTube
Video