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 : Récupérer pour récupérer plusieurs enregistrements d'entité. Par ailleurs, utilisez 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 , de sorte que la recherche ne renvoie que les clients de l'État de Californie.

Reportez-vous à la section La fonction Récupérer pour de plus amples informations.

Remarque :

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

1. Ouvrez une application existante ou créez-en une nouvelle.
2. Ajoutez une commande Table à votre application :
   1. Sélectionnez Ajouter un contrôle.
   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 icône en haut de la zone de dessin.
   2. Select Entity.
   3. Sélectionner un locataire.
   4. Sélectionnez l'entité que vous souhaitez ajouter à votre application, puis sélectionnez Ajouter.
4. Liez l'entité à la commande Table :
   1. Dans l'onglet Général du panneau Propriétés , sélectionnez le bouton Ressources supplémentaires adjacent à Source de données.
   2. Sélectionnez Générateur de requêtes (Query Builder).
   3. Sélectionnez l'entité que vous souhaitez utiliser, puis ajoutez une 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, entourée de guillemets. Par exemple, si vous souhaitez uniquement les enregistrements des clients de l'État de Californie, ajoutez "WA" comme valeur.
5. Utilisez l' éditeur d'expressions pour appliquer un filtre dans des conditions spécifiques :
   1. Dans le Générateur de requêtes, sélectionnez le bouton Ouvrir les ressources , puis Éditeur d’expressions.
   2. Écrivez une expression contenant une condition. Par exemple, vous pouvez utiliser une condition IF pour appliquer un filtre uniquement lorsqu'une commande Liste déroulante 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 un contrôle.
   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 icône en haut de la zone de dessin.
   2. Select Entity.
   3. Sélectionner un locataire.
   4. Sélectionnez l'entité que vous souhaitez ajouter à votre application, puis sélectionnez Ajouter.
4. Liez l'entité à la table et appliquez une règle de tri :
   1. Dans l'onglet Général du panneau Propriétés , sélectionnez le bouton Ressources supplémentaires adjacent à Source de données.
   2. Sélectionnez Générateur de requêtes (Query Builder).
   3. Sélectionnez Paramètres supplémentaires.
   4. Dans le champ Trier par, ajoutez le champ par lequel vous souhaitez trier, tel que Nom.
   5. Le champ Trier par ordre croissant est défini sur Vrai 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 de 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 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 aux sections Utiliser et récupérer des enregistrements d'entités pour récupérer des enregistrements d'entités dans les commandes Modifier la grille et Utiliser des entités avec les commandes Modifier la grille pour plus de détails et d'exemples pratiques liés à la commande Modifier la grille .