Verwenden von Apps mit dem Data Service

Hintergrundinformationen

Hinweis:

• Zur Laufzeit werden maximal 1000 Datensätze für jeden Filter abgerufen.
• Nachdem die Entitätsdaten geladen wurden, werden die Daten nur aktualisiert, wenn eine Regel ausgeführt wird. Alle Änderungen, die durch Prozesse oder andere Mittel an der Entität vorgenommen werden, werden nicht automatisch in Apps aktualisiert. Stellen Sie sicher, dass Sie die Daten in diesen Szenarien explizit aktualisieren.
• Der in -Operator unterstützt nur Primärdatentypen, z. B.: string, number, boolean, null.

Der in-Operator wird in Data Service-Szenarien mit choice-set nicht unterstützt. Sie können stattdessen den contains-Operator verwenden, aber nur für eine Eingabe.

Überblick

Bevor Sie dieses Beispiel starten, stellen Sie sicher, dass Sie über die richtigen Berechtigungen vom Data Service verfügen. Weitere Informationen finden Sie auf der Seite Data Service – Zugriff verwalten.

Für dieses Beispiel verwenden wir eine Entität namens Kunde mit den folgenden Feldern:

• Address
• Adresse 2
• Stadt
• E-Mail
• Name
• Telefon
• Plan
• Status (State)
• Postal Code

Kunden nach Staaten filtern

Use the Function: Fetch function to retrieve multiple entity records. Additionally, use the Query builder to filter the retrieved records. In this example, we apply a filter to the Customer entity, so the search only returns customers from the state of Washington.

Refer to The Fetch function for more details.

Hinweis:

If you want to retrieve a single record, use the FetchOne function instead.

1. Öffnen Sie eine vorhandene Anwendung oder erstellen Sie eine neue Anwendung.
2. Fügen Sie Ihrer App ein Tabellensteuerelement hinzu:
   1. Wählen Sie Steuerelement hinzufügen aus.
   2. Wählen Sie Anzeige aus.
   3. Ziehen Sie das Tabellensteuerelement in einen Bereich in Ihrer App.
3. Fügen Sie Ihrer App eine Entität hinzu:
   1. Wählen Sie Hinzufügen aus Symbol oben in der Arbeitsfläche.
   2. Wählen Sie Entität aus.
   3. Wählen Sie einen Mandanten aus.
   4. Wählen Sie die Entität aus, die Sie Ihrer App hinzufügen möchten, und dann Hinzufügen.
4. Binden Sie die Entität an das Tabellensteuerelement :
   1. Wählen Sie auf der Registerkarte Allgemein des Eigenschaftenbereichs die Schaltfläche Zusätzliche Ressourcen neben Datenquelle aus.
   2. Wählen Sie Abfragegenerator aus.
   3. Wählen Sie die Entität aus, die Sie verwenden möchten, und fügen Sie dann Bedingung hinzu.
   4. Wählen Sie ein Feld aus dem Dropdownmenü aus und dann einen Operator, z. B. =.
   5. Geben Sie die Zeichenfolge ein, nach der Sie die Datensätze filtern möchten, umgeben von Anführungszeichen.
      Wenn Sie beispielsweise nur Kundendatensätze aus dem Bundesstaat Washington möchten, fügen Sie "WA" als Wert hinzu.
5. Verwenden Sie den Ausdrucks-Editor , um einen Filter unter bestimmten Bedingungen anzuwenden:
   1. Wählen Sie im Abfragegenerator die Schaltfläche Ressourcen öffnen und dann Ausdrucks-Editor aus.
   2. Schreiben Sie einen Ausdruck, der eine Bedingung enthält. Sie können beispielsweise eine IF-Bedingung verwenden, um einen Filter nur anzuwenden, wenn ein Dropdown -Steuerelement auf der Hauptseite der App nicht leer ist und einen vom Benutzer angegebenen Wert enthält:

      Fetch(of Customer)(  
      If(  
      MainPage.Dropdown is Nothing,  
      Nothing,  
      createFilterGroup(New QueryFilter(){addFilter("State", "contains", MainPage.Dropdown.Value)}, Nothing, 0)),  
      Nothing, Nothing, Nothing, New ExpansionFieldOption( {addExpansionFieldOption("CreatedBy", New String(){"Id","Name"}), addExpansionFieldOption("UpdatedBy", New String(){"Id","Name"})})

Wenn Sie eine Vorschau der App anzeigen oder sie ausführen, wird die Abfrage ausgeführt und die gefilterten Datensätze abgerufen.

Kunden sortieren

Verwenden Sie den Abfragegenerator , um Sortieroptionen auf Ihre Suche anzuwenden.

1. Öffnen Sie eine vorhandene Anwendung oder erstellen Sie eine neue Anwendung.
2. Fügen Sie Ihrer App ein Tabellensteuerelement hinzu:
   1. Wählen Sie Steuerelement hinzufügen aus.
   2. Wählen Sie Anzeige aus.
   3. Ziehen Sie das Tabellensteuerelement in einen Bereich in Ihrer App.
3. Fügen Sie Ihrer App eine Entität hinzu:
   1. Wählen Sie Hinzufügen aus Symbol oben in der Arbeitsfläche.
   2. Wählen Sie Entität aus.
   3. Wählen Sie einen Mandanten aus.
   4. Wählen Sie die Entität aus, die Sie Ihrer App hinzufügen möchten, und dann Hinzufügen.
4. Binden Sie die Entität an die Tabelle und wenden Sie eine Sortierregel an:
   1. Wählen Sie auf der Registerkarte Allgemein des Eigenschaftenbereichs die Schaltfläche Zusätzliche Ressourcen neben Datenquelle aus.
   2. Wählen Sie Abfragegenerator aus.
   3. Wählen Sie Zusätzliche Einstellungen aus.
   4. Fügen Sie im Feld Sortieren nach das Feld hinzu, nach dem Sie sortieren möchten, z. B. Name.
   5. Das Feld Aufsteigend sortieren ist standardmäßig auf „ true “ festgelegt. Wählen Sie das Feld aus und geben Sie dann False ein, um die Ergebnisse in absteigender Reihenfolge zu sortieren.
5. Zeigen Sie eine Vorschau der App an oder führen Sie sie aus.

   Wenn Sie eine Vorschau Ihrer App anzeigen oder sie ausführen, zeigt die Tabelle Datensätze aus dem Feld Name in Ihrer Entität in alphabetisch absteigender Reihenfolge an.

Verwendung von Entitäten im Bearbeitungsraster

Sie können das Bearbeitungsrastersteuerelement verwenden, um Entitätsdatensätze in Ihrer App anzuzeigen und mit diesem Steuerelement CRUD-Vorgänge für Ihre Entität durchzuführen.

Refer to Using Fetch to retrieve entity records in Edit Grid controls and Using entities with Edit Grid controls for more details and practical examples related to the Edit Grid control.