Utilisation d'Apps avec Data Service

Informations d'arrière-plan

Remarque :

• Un maximum de 1 000 enregistrements pour n'importe quel filtre est récupéré au moment de l'exécution.
• Une fois les données d'entité chargées, les données sont actualisées uniquement lorsqu'une règle est exécutée. Toute modification apportée à l'entité via des processus ou d'autres moyens n'est pas automatiquement mise à jour dans Apps. Assurez-vous d'actualiser explicitement les données dans ces scénarios.
• L'opérateur in ne prend en charge que les types de données primitifs, tels que : string, number, boolean, null.

L'opérateur in n'est pas pris en charge dans les scénarios Data Service utilisant choice-set. Vous pouvez utiliser l'opérateur contains à la place, mais uniquement pour une entrée.

Vue d'ensemble (Overview)

Avant de commencer cet exemple, assurez-vous que vous disposez des autorisations appropriées délivrées par le Data Service. Pour plus d'informations, consultez la page Data Service. - Gestion de l'accès.

Pour les besoins de cet exemple, nous utiliserons une entité appelée Client avec les champs suivants :

• Address
• Adresse 2
• Ville
• E-mail (Email)
• Nom
• Téléphone
• Plan
• État (State)
• Code postal

Filtrer les clients par état

Utilisez la fonction Fonction : Récupérer (Function: Etch ) pour récupérer plusieurs enregistrements d'entité. Utilisez également le générateur de requêtes pour filtrer les enregistrements récupérés. Dans cet exemple, nous appliquons un filtre à l'entité Client (Customer), de sorte que la recherche ne renvoie que les clients de l'état de Washington.

Reportez-vous à la fonction Récupérer (Fetch) pour plus de détails.

Remarque :

Si vous souhaitez récupérer un seul enregistrement, utilisez plutôt la fonction RécupérerUn ( FetchOne ).

1. Ouvrez une application existante ou créez-en une nouvelle.
2. Ajoutez une commande Table à votre application :
   1. Sélectionnez Ajouter une commande (Add control).
   2. Sélectionnez Afficher.
   3. Faites glisser la commande Table vers une zone de votre application.
3. Ajouter une entité à votre application :
   1. Sélectionnez l'option Ajouter un icône en haut de la zone de dessin.
   2. Sélectionner une entité.
   3. Sélectionner un locataire.
   4. Sélectionnez l'entité que vous souhaitez ajouter à votre application, puis Ajouter (Add).
4. Liez l'entité au champ Table :
   1. Dans l'onglet Général (General) du panneau Propriétés (Properties), sélectionnez le bouton Ressources supplémentaires ( Additional resources ) adjacent à Source de données (Data source).
   2. Sélectionnez Générateur de requêtes (Query Builder).
   3. Sélectionnez l'entité que vous souhaitez utiliser, puis Ajouter une condition (Add condition.
   4. Sélectionnez un champ dans le menu déroulant, puis un opérateur, tel que =.
   5. Entrez la chaîne par laquelle vous souhaitez filtrer les enregistrements, placées entre guillemets.
      Par exemple, si vous souhaitez uniquement les enregistrements de clients de l'état de Washington, ajoutez "WA" comme valeur.
5. Utilisez l ' éditeur d'expressions pour appliquer un filtre sous des conditions spécifiques :
   1. Dans le Générateur de requêtes ( Query Builder), sélectionnez le bouton Ouvrir les ressources (Open resources), puis Éditeur d'expressions ( Expression editor).
   2. Écrire une expression contenant une condition. Par exemple, vous pouvez utiliser une condition IF pour appliquer un filtre uniquement lorsqu'une commande Dropdown sur la page principale de l'application n'est pas vide et contient une valeur spécifiée par l'utilisateur :

      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"})})

Lorsque vous prévisualisez ou exécutez l'application, la requête s'exécute et récupère les enregistrements filtrés.

Triez les clients

Utilisez le générateur de requêtes pour appliquer les options de tri à votre recherche.

1. Ouvrez une application existante ou créez-en une nouvelle.
2. Ajoutez une commande Table à votre application :
   1. Sélectionnez Ajouter une commande (Add control).
   2. Sélectionnez Afficher.
   3. Faites glisser la commande Table vers une zone de votre application.
3. Ajouter une entité à votre application :
   1. Sélectionnez l'option Ajouter un icône en haut de la zone de dessin.
   2. Sélectionner une entité.
   3. Sélectionner un locataire.
   4. Sélectionnez l'entité que vous souhaitez ajouter à votre application, puis Ajouter (Add).
4. Liez l'entité à la table et appliquez une règle de tri :
   1. Dans l'onglet Général (General) du panneau Propriétés (Properties), sélectionnez le bouton Ressources supplémentaires ( Additional resources ) adjacent à Source de données (Data source).
   2. Sélectionnez Générateur de requêtes (Query Builder).
   3. Sélectionnez Paramètres supplémentaires.
   4. Dans le champ Trier par (Sort by), ajoutez le champ par lequel vous souhaitez trier, tel que Nom (Name).
   5. Le champ Trier par ordre croissant est défini sur Vrai (True) par défaut. Sélectionnez le champ, puis saisissez Faux pour trier les résultats par ordre décroissant.
5. Prévisualisez ou exécutez votre application.

   Lorsque vous prévisualisez ou exécutez votre application, la table affiche les enregistrements du champ Nom (Name ) dans votre entité, par ordre alphabétique décroissant.

Utilisation d'entités avec Modifier la grille (Edit Grid)

Vous pouvez utiliser la commande Modifier la grille ( Edit Grid ) pour afficher les enregistrements d'entité dans votre application et effectuer des opérations CRUD sur votre entité à l'aide de cette commande.

Reportez-vous à Utilisation de la récupération pour récupérer les enregistrements d'entité dans les commandes Modifier la grille et Utilisation d'entités avec les commandes Modifier la grille pour plus de détails et d'exemples pratiques liés à la commande Modifier la grille .