Einführung in den App Builder - Lektion 7: Mehr über Regeln

Dies ist die siebte Lektion der Einführung in den App Builder Tutorialreihe.

Wir haben seit Lektion 3 Regeln verwendet, um unsere Northwinds-Anwendung zu entwickeln, aber jetzt werden wir unser Verständnis dafür vertiefen, indem wir uns mit einigen weiteren Konzepten rund um Regeln und deren Verwendung vertraut machen.

Standardregeln

Wenn Sie möchten, dass bestimmte Daten standardmäßig zu neuen Datensätzen hinzugefügt werden, sobald sie erstellt werden, müssen Sie das verwenden, was wir eine Standardregel nennen. Wenn Sie beispielsweise ein neues Produkt hinzufügen, muss es einen Standardpreis geben.

Standardregeln werden im selben Bereich des App Builders erstellt, in dem Sie andere Regeln erstellen, aber bevor wir unsere erste Standardregel erstellen, werfen wir einen Blick auf ein weiteres wichtiges Konzept: Joins.

Joins

Wenn wir Regeln erstellen, ist es manchmal notwendig, Daten aus zwei separaten Tabellen abzurufen. Dazu verbinden wir die Tabellen miteinander, indem wir das verwenden, was wir einen Join nennen. Es gibt drei Arten von Joins: inner, left outer und right outer.

Join-Typen

Inner Join: Ein Inner Join gibt nur die Werte zurück, die in beiden Tabellen existieren.
Left Outer Join: Ein Left Outer Join gibt alle Werte aus der linken Tabelle zurück, unabhängig davon, ob sie auch in der rechten Tabelle erscheinen oder nicht.
Right Outer Join: Ein Right Outer Join gibt alle Werte aus der rechten Tabelle zurück, unabhängig davon, ob sie auch in der linken Tabelle erscheinen oder nicht.

Erstellen einer Standardregel

Lassen Sie uns eine Standardregel für das Beispiel erstellen, das wir oben verwendet haben: Wir möchten nicht, dass die Endbenutzer unserer Northwinds-Anwendung einen Stückpreis festlegen. Daher werden wir eine Regel erstellen, die die Stückpreise aus der Datenquelle abruft.

In Lektion 6 haben wir bereits die Stückpreis-Steuerelemente in der Benutzeroberfläche der Anwendung auf schreibgeschützt gesetzt, also werden wir jetzt eine Regel erstellen, die diesen Wert speziell festlegt.

Gehe zu App Workbench > Regeln und klicke auf + Regel.
Gib gemäß den Namenskonventionen des App Builders den Namen OrderDetail (Standard Einheitspreis) ein.
Wähle im Feld Zweck Standard aus.
Wähle im Feld Ziel die Tabelle OrderDetail aus.
Klicke auf Erstellen.
Sobald der App Builder die Regel erstellt hat, siehst du die Tabelle OrderDetail im Tab Tabellen. Wir benötigen die Spalten OrderID und ProductID.
Klicke im Tab Tabellen auf + Tabellen und wähle ebenfalls die Tabelle Produkt aus. Sie wird mit der Tabelle OrderDetail verknüpft erscheinen, da sie durch eine Fremdschlüsselbeziehung verbunden sind.
Wähle die Spalte Einheitspreis in der Tabelle Produkt aus.
Der App Builder wird automatisch den Join schreiben, aber klicke auf den Tab Joins, um sicherzustellen, dass keine Fehler vorhanden sind:
Wie bei allen Regeln ist es immer eine gute Praxis, sie zu validieren, indem du auf die Schaltfläche Ergebnisse klickst. Du solltest drei Spalten sehen, wobei eine den Einheitspreis für ein bestimmtes Produkt anzeigt.

Füge eine Standardregel zu einem Panel hinzu

Die Standardregeln müssen mit einem Panel verbunden sein, um eine Wirkung zu erzielen. Lass uns also zum Bearbeitungsbildschirm der Bestellungen-Seite zurückkehren und das Panel OrderDetails auswählen.

Klicke auf Mehr > Standards. Der Dialog Standards öffnet sich.
Klicke auf Registrieren, und ein weiterer Dialog öffnet sich mit einigen Optionen:
1. Wähle im Feld Typ Regel aus.
2. Wähle im Feld Regel OrderDetail (Standard Einheitspreis) aus.
3. Wähle im Feld Bindung Implizit aus.
  
  Hinweis
  
  Um mehr über die beiden Bindungsoptionen zu erfahren, siehe Implizite und explizite Bindung.
4. Klicke auf Speichern.

Wenn du jetzt zur Vorschau der Bestellungen-Seite zurückkehrst und versuchst, einen neuen Eintrag im Panel Order Details hinzuzufügen, wirst du sehen, dass der Einheitspreis jetzt automatisch ausgefüllt wird, wenn du eine Auswahl im Feld Produkt triffst, was bedeutet, dass deine Standardregel funktioniert.

List retrieves

List retrieves sind eine Möglichkeit, die Funktionalität von Listensteuerelementen zu erweitern. Ein reguläres Listensteuerelement ermöglicht es Ihnen, den ID-Wert eines bestimmten Datensatzes abzurufen. Ein List Retrieve ermöglicht es Ihnen auch, andere Werte abzurufen. Wir werden demonstrieren, wie List Retrieves funktionieren, indem wir unsere bestehende Produkt (Liste)-Regel verbessern.

Navigieren Sie zur Produkt (Liste)-Regel, indem Sie sie in App Workbench > Regeln finden.
Klicken Sie im Tab Spalten auf + Spalte.
Geben Sie im Feld Spalte oder Ausdruck P.UnitPrice ein.
Wählen Sie im Feld Ziel UnitPrice aus.
Klicken Sie auf Speichern.
Lassen Sie uns nun das Steuerelement aktualisieren, das diese Regel verwendet. Navigieren Sie zum Bearbeitungsbildschirm der Bestellungen-Seite, indem Sie sie in App Workbench > Seiten finden.
Wählen Sie im Panel Bestelldetails Steuerelemente aus, um die Liste der im Panel vorhandenen Steuerelemente anzuzeigen.
Doppelklicken Sie auf die Zeile des Produkt-Steuerelements.

Hinweis

Sie können auch auf dieselben Optionen zugreifen, indem Sie die Bestellungen-Seite mit der Schaltfläche Seite anzeigen in der Vorschau anzeigen, dann den Live-Designer im Aktionsbereich öffnen und das Produkt-Steuerelement auswählen.
Klicken Sie im Tab Listenoptionen auf die Schaltfläche Abrufe.
Klicken Sie im Dialogfeld Abrufe auf + Abruf hinzufügen.
Wählen Sie im Feld Panelspalte UnitPrice aus. Wählen Sie im Feld (Listenquelle) Spalte UnitPrice aus.
Klicken Sie auf das Bestätigungsicon, um zu speichern und das Dialogfeld zu schließen.

Der App Builder benötigt einen Moment, um zu speichern. Nachdem dies geschehen ist, kehren Sie zur Vorschau der Bestellungen-Seite zurück und versuchen Sie, eines der Produkte auf der Seite Bestelldetails zu bearbeiten. Sie werden sehen, dass das Steuerelement Einheitspreis automatisch basierend auf Ihrer Auswahl aktualisiert wird.

Validation rules

Validierungsregeln werden verwendet, um sicherzustellen, dass erforderliche Daten immer bereitgestellt werden und dass die in den App Builder eingegebenen Daten gültig sind. Validierungsregeln werden in der Geschäftsschicht konfiguriert.

In diesem Beispiel werden wir eine Validierungsregel erstellen, um das Feld Vorname in der Mitarbeiter-Tabelle zu einem Pflichtfeld zu machen. Befolgen Sie diese Schritte:

In App Workbench > Regeln, klicken Sie auf + Regel.
Geben Sie im Feld Name Mitarbeiter (Vorname erforderlich) ein.
Geben Sie im Feld Zweck Validierung ein.
Stellen Sie im Feld Ziel sicher, dass Mitarbeiter ausgewählt ist.
Klicken Sie auf Erstellen.
Wenn der App Builder die Regel erstellt, wird automatisch die Mitarbeiter-Tabelle im Tab Tabellen angezeigt, mit dem Primärschlüssel MitarbeiterID ausgewählt. Wählen Sie auch die Spalte Vorname aus.
Klicken Sie im Tab Wo auf + Where-Klausel.
Geben Sie im Feld Linke Ausdruck E.Vorname ein.
Wählen Sie im Feld Operator IST NULL aus.
Klicken Sie auf Speichern.

Die Regel ist jetzt erstellt.

Validierungsregel an ein Ereignis anhängen

Validierungsregeln müssen an ein Ereignis angehängt werden, um verwendet zu werden. Für diesen Anwendungsfall möchten wir, dass die Validierung jedes Mal ausgeführt wird, wenn ein Benutzer versucht, einen Mitarbeiterdatensatz zu speichern. Daher werden wir sie an das intrinsische Speichereignis anhängen.

In App Workbench > Regeln, suchen Sie das Geschäftsinstrument Mitarbeiter (Quelle) und öffnen Sie es.
Klicken Sie im Panel Regel auf Ereignisse. Der Dialog Alle Ereignisse (Mitarbeiter (Quelle)) öffnet sich.
Suchen Sie das Ereignis Speichern und klicken Sie auf Regelereignisdetails.
Klicken Sie im Panel Validierungen auf Registrieren.
Stellen Sie im Feld Typ sicher, dass Regel ausgewählt ist.
Wählen Sie im Feld Regel Mitarbeiter (Vorname erforderlich) aus.
Stellen Sie im Feld Bindung sicher, dass Implizit ausgewählt ist.

Hinweis

Lesen Sie mehr darüber, was dieses Feld bedeutet, in Anhang B.
Geben Sie im Feld Nachricht eine beschreibende Nachricht ein, die den Benutzern angezeigt wird, wenn diese Validierung fehlschlägt. Etwas Einfaches wie "Vorname ist erforderlich" sollte ausreichen.
Lassen Sie die anderen Felder mit ihren Standardauswahlen und klicken Sie auf Speichern.
Die Validierung wurde erstellt und an die Speichereignisse in der Mitarbeiter-Tabelle angehängt. Um dies zu testen, besuchen Sie die Vorschau der Mitarbeiter-Seite und versuchen Sie, einen neuen Eintrag im Mitarbeiter-Panel ohne Vornamen hinzuzufügen. Sie sollten die eingegebene Nachricht sehen.

Übungszeit: Erstellen Sie eine weitere Validierungsregel

Befolgen Sie die gleichen Schritte wie oben, um eine weitere Validierungsregel zu erstellen, die die Nachname-Spalte der Mitarbeiter-Tabelle ebenfalls erforderlich macht. Nachdem Sie die Validierungsregel erstellt haben, hängen Sie sie an das intrinsische Speichereignis an und testen Sie es.

CRUD-Regeln

Die letzte Art von Regel, die wir besprechen werden, sind CRUD-Regeln, die verwendet werden, um Daten in großen Mengen zu aktualisieren. CRUD-Regeln können verwendet werden, um Datensätze zu erstellen, einzufügen, zu aktualisieren oder zu löschen, und oft müssen Sie dies in Ihren App Builder-Anwendungen tun. Wir werden uns ansehen, wie man mit CRUD-Regeln arbeitet, und dabei werden wir zwei wichtige Funktionen kennenlernen. Diesmal arbeiten wir an der Mitarbeiter-Seite.

Erstellen Sie eine obere CRUD-Regel

Gehen Sie zu App Workbench > Regeln.
Klicken Sie auf + Regel.
Geben Sie den Namen Mitarbeiter (Vornamen Großschreibung Aktualisierung) ein.
Wählen Sie im Feld Zweck CRUD aus.
Ein neues Feld, Aktion, erscheint. Wählen Sie Aktualisieren.
Wählen Sie im Feld Zielschicht Datenebene aus.
Wählen Sie im Feld Ziel Mitarbeiter aus.
Klicken Sie auf Erstellen.
Im Tab Tabellen wählt der App Builder automatisch die MitarbeiterID-Spalte aus, die der Primärschlüssel der Mitarbeiter-Tabelle ist. Wir benötigen keine weiteren, also klicken Sie einfach auf + Spalte.
Wenn der Dialog Spalte hinzufügen geöffnet wird, geben Sie die folgende Syntax im Feld Spalte oder Ausdruck ein: Upper(E.FirstName).

Hinweis

Diese Syntax ruft die Upper() Datenbankfunktion auf, die einen String als Argument annimmt, um ihn zu kapitalisieren und dann zurückzugeben. Mehrere andere Datenbankfunktionen stehen zur Verwendung mit App Builder zur Verfügung.
Geben Sie im Alias-Feld UpperFirstName ein.
Wählen Sie im Ziel-Feld FirstName aus.
Klicken Sie auf Speichern.

Sobald der App Builder die neue Regel gespeichert hat, überprüfen Sie, ob sie funktioniert, indem Sie im Regel-Panel auf Ergebnisse klicken. Die Upper-Funktion nimmt den Namen jedes Mitarbeiters und schreibt ihn in Großbuchstaben um.

Fügen Sie die neue Upper CRUD-Regel einem Ereignis hinzu

Es ist immer am besten, Ihre CRUD-Regeln auf den Tabellen zu platzieren, da dies hilft, die Ereignisse zu optimieren und zu organisieren, insbesondere wenn Sie in Zukunft Aktualisierungen oder Änderungen vornehmen müssen.

Suchen Sie die Mitarbeiter (Quelle)-Regel in App Workbench > Regeln und öffnen Sie sie.
Klicken Sie auf Ereignisse.
Wenn der Dialog Alle Ereignisse geöffnet wird, klicken Sie auf + Regelereignis.
Geben Sie ihm den Namen Upper First Name. Sie können die anderen Felder mit ihren Standardwerten belassen. Klicken Sie auf Speichern.
Wenn Sie zurück zum Dialog Alle Ereignisse geleitet werden, sollte das neue Ereignis, das Sie gerade erstellt haben, verfügbar sein. Klicken Sie auf die Schaltfläche Regelereignisdetails.
Klicken Sie im Aktionen-Panel auf Registrieren.
Wenn der Dialog Aktion geöffnet wird, verwenden Sie das Regel-Feld, um Mitarbeiter (FirstName Upper Update) auszuwählen, die CRUD-Regel, die wir zuvor erstellt haben. Klicken Sie auf Speichern.
Sie sehen dann die Bestätigungsseite, die Details zum neuen Ereignis anzeigt:

Beachten Sie das Bindings-Panel. Es zeigt, welche Spalten wir verwendet haben, um die Datensätze in der UI-Schicht (das Quellspalten-Feld) mit den Datensätzen in der Regel (das Regelspalten-Feld) zu verknüpfen. Mit dieser Bindung wird die Regel nur gegen Datensätze in der UI ausgeführt, die entsprechende Werte haben. Ohne Bindung würde die Regel alle Zeilen betreffen, die in der CRUD-Regel zurückgegeben werden.

Jetzt, da wir ein Ereignis erstellt haben, fügen wir einen Button hinzu, der es auf unserer Seite ausführt.

Navigieren Sie zum Bearbeitungsbildschirm der Mitarbeiter-Seite und greifen Sie auf die Liste der Steuerelemente im Mitarbeiter-Panel zu.
Klicken Sie auf + Steuerung, um eine neue Steuerung hinzuzufügen.
Wählen Sie im Feld Steuerungstyp Schaltfläche aus.
Geben Sie im Feld Name First Name Upper ein. Klicken Sie auf Weiter.
Wählen Sie im Feld Ein Ereignis ausführen UpperFirstName aus, unser neu erstelltes Ereignis.
Klicken Sie auf Weiter und dann auf Fertigstellen.

Greifen Sie nun auf die Vorschau der Mitarbeiter-Seite zu und testen Sie die neue Schaltfläche. Wenn Sie darauf klicken, sollte der Vorname eines Mitarbeiters in Großbuchstaben angezeigt werden.

Übungszeit: Erstellen Sie eine Lower CRUD-Regel

Versuchen Sie zur Übung, diese Schritte, die wir gerade befolgt haben, zu wiederholen, aber diesmal eine Schaltfläche zu erstellen, die den gegenteiligen Prozess ausführt. Erstellen Sie mit der Lower() Datenbankfunktion eine Schaltfläche, die die Namen der Mitarbeiter in Kleinbuchstaben anzeigt.

Überprüfung und Abschluss

In dieser Lektion haben wir unser Wissen über Regeln im App Builder erheblich erweitert und dabei über Standard-, Validierungs- und CRUD-Regeln sowie Anwendungsparameter und Listenabrufe gelernt. Damit endet diese Tutorialreihe.

Ihre Northwinds-Anwendung ist jetzt funktionsfähig! Sie zeigt Informationen über Kunden, die von ihnen aufgegebenen Bestellungen, Mitarbeiter, Lieferanten und Versanddienstleister auf organisierte und effiziente Weise an. Die Konzepte und Techniken, die Sie während ihrer Erstellung gelernt haben, können angewendet werden, um jede andere Anwendung zu erstellen.