Voraussetzungen
Simplifier Instanz Release 6.0.
In diesem Artikel stellen wir dir verschiedene Anwendungsfälle von Simplifier Data Services vor. Unsere Beispiel-App ist ein einfaches Projektmanagement-Tool, das die Verwaltung von Projekten und Mitarbeitern ermöglicht.
Schritt 1 – Datenbankschema
Im Folgenden sehen Sie das Datenbankschema unseres laufenden Beispiels:
Schritt 2 – Laden von Datensätzen
Um eine einfache Übersicht deiner Projekte und Mitarbeiter zu erhalten (z. B. über ein Listen- oder Tabellen-Widget), kannst du den ‘Load Dataset’ Data Service nutzen, wie in der Simplifier Dokumentation erklärt.
Schritt 3 – Projektdetails anzeigen
Wenn Sie auf ein Projekt klicken, öffnet sich die Detailansicht mit dem Namen, der Beschreibung und den Mitgliedern des Projekts:
Um diese Informationen zu erhalten, müssen Sie in einem ersten Schritt das ausgewählte Projekt muss bestimmt (und in einer globalen Variable gespeichert) werden. Dies kann mit der Funktion getSelectedSourceItem des Business Objects SF_UI5BindingHelper erfolgen, das Teil des Standard Content ist.
Der ID-Eintrag der Variable für das ausgewählte Projekt kann nun als Input für den ‘Load Data’ Data Service (Simplifier Dokumentation) verwendet werden, um den Datensatz des ausgewählten Projekts zu laden.
Als Nächstes müssen die entsprechenden Projektmitglieder geladen werden. Dafür verwenden wir einen ODataV4 REST-Aufruf, der die erweiterten (ODataV4 – $expand) ProjectMembers-Datensätze filtert (ODataV4 – $filter). Durch die Verwendung dieses Connectors in einem Business Object können wir die Employee-Datensätze der Projektmitglieder des ausgewählten Projekts abrufen.
Schritt 4 – Hinzufügen eines Projektmitglieds
Um ein neues Projektmitglied hinzuzufügen, verwenden wir ein Auswahldialog-Widget, das sich durch Klicken auf die Schaltfläche “Hinzufügen” öffnet:
Um eine Liste von Mitarbeitern zu erhalten, die als Projektmitglieder ausgewählt werden können, wird ein Business Object verwendet, das einen ODataV4 REST-Aufruf ausführt und die bereits zugewiesenen Projektmitglieder aus den Employees-Datensätzen herausfiltert (ODataV4 – $filter):
Um neue Projektmitglieder-Datensätze entsprechend der Benutzerauswahl zur Datenbank hinzuzufügen, werden die ausgewählten Mitarbeiter-Objekte aus dem Auswahldialog in eine globale Variable übertragen:
var selectedItems = oEvent.getParameter("selectedItems");
var projectMembers = [];
for (var i = 0; i < selectedItems.length; i++) {
projectMembers.push(selectedItems[i].getBindingContext("Popups").getObject());
};
this.getGlobals().setVar("projectMembersNew", projectMembers);
Mithilfe eines ‘Iterator’-Moduls können die neuen Projektmitglieder-Datensätze über den ‘Write Data’ Data Service (Simplifier Dokumentation) zur Datenbank hinzugefügt werden.
Schritt 5 – Löschen des Projektmitglieds
Die Löschaktionen in dieser App sind über die Widget-Eigenschaft ‘type = delete’ der Listenelemente implementiert:
Um ein Projektmitglied zu löschen, muss zuerst der ausgewählte Mitarbeiter bestimmt (und in einer globalen Variable gespeichert) werden. Dies kann mit der Funktion getSelectedListItem des Business Objects SF_UI5BindingHelper erfolgen, das Teil des Standard Content ist.
Als Nächstes kann die ID des entsprechenden Projektmitglied-Datensatzes über ein Business Object ermittelt werden, das einen ODataV4 REST–Filter-Aufruf (ODataV4 – $filter) auf die Projektmitglieder-Tabelle ausführt, welche um Mitarbeiter erweitert (ODataV4 – $expand) ist:
Schritt 6 – Projekt speichern/abbrechen
Um Änderungen an den Eingabefeldern (‘Name’, ‘Beschreibung’) zu speichern, kann der ‘Write Data’ Data Service (Simplifier Dokumentation) verwendet werden.
Um Änderungen an den Eingabefeldern zu verwerfen, kann der ‘Reset Changes’ Data Service (Simplifier Dokumentation) verwendet werden.
Schritt 7 – Mitarbeiterdetails anzeigen
Ähnliche Schritte können für die Mitarbeiter durchgeführt werden: Mit einem Klick auf einen Mitarbeiter öffnet sich die Detailansicht mit Name, Vorname, Abteilung und Projekten des Mitarbeiters:
Der Story Flow im Prozessdesigner kann analog zur Projektdetailansicht eingerichtet werden (siehe Schritt 3).
Schritt 8 – Abteilungswechsel
In diesem Fall wird die Abteilungsauswahl über ein Auswahl-Widget umgesetzt.
Dazu werden in einem ersten Schritt alle Department-Datensätze über den ‘Load Dataset’ Data Service (Simplifier Dokumentation) geladen. Die Felder ‘id’ und ‘name’ werden auf die Eigenschaften ‘text’ und ‘key’ der Auswahlelemente gemappt:
Als Nächstes kann der ausgewählte Mitarbeiter-Datensatz über den ‘Load Data’ Data Service (Simplifier Dokumentation) geladen werden. Bei den Simple Form Eingabefeldern können die Datenfelder ‘firstName’ und ‘lastName’ direkt gemappt werden. Im Falle der Abteilung des Mitarbeiters muss die Eigenschaft ‘selected key’ des Select-Widgets mit ‘dept___id’ verknüpft werden.
Schritt 9 – Projekt/Mitarbeiter löschen
Um einen ganzen Projekt- (oder Mitarbeiter-) Eintrag zu löschen, kann der ‘Delete Dataset’ Data Service (Simplifier Dokumentation) verwendet werden: