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

Verwenden Sie die Funktion „ Funktion: Abrufen“, um mehrere Entitätsdatensätze abzurufen. Verwenden Sie außerdem den Abfragegenerator , um die abgerufenen Datensätze zu filtern. In diesem Beispiel wenden wir einen Filter auf die Entität Kunde an, sodass die Suche nur Kunden aus dem Bundesstaat Washington zurückgibt.

Weitere Informationen finden Sie unter Die Abruffunktion .

Hinweis:

Wenn Sie einen einzelnen Datensatz abrufen möchten, verwenden Sie stattdessen die Funktion FetchOne .

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.

Weitere Informationen und praktische Beispiele im Zusammenhang mit dem Bearbeitungsrastersteuerelement finden Sie unter Verwenden von Fetch zum Abrufen von Entitätsdatensätzen in Bearbeitungsrastersteuerelementen und Verwenden von Entitäten mit Bearbeitungsrastersteuerelementen .