Cet exemple vous explique comment créer des champs dans une entité de la base de données CDS.
Il est nécessaire de comprendre les nombreuses possibilités offertes par les champs. Respectez donc le type des champs, ainsi que leurs valeurs. Vous pourrez tirer profit de cette richesse par la suite.
Préparation
- L’exercice du TP Créer une entité doit être terminé avec succès.
Administrer l’entité
Ouvrez le site web Microsoft Power Apps et identifiez-vous avec votre compte.
Dans le volet de navigation (à gauche), cliquez sur Données, puis cliquez sur Entités : la liste des entités existantes s’affiche.
Dans le volet central, en haut et à droite, cliquez sur l’affichage qui s’intitule Par défaut.
Dans ce menu, cliquez sur l’affichage qui s’intitule Personnalisé : l’entité Note de frais apparaît.
Cliquez sur l’entité Note de frais pour l’ouvrir : plusieurs champs apparaissent, dont le champ Dépense.
Pour vous aider, regardez la copie d’écran ci-dessous.
Dans l’exercice précédent, c’est vous qui avez créé explicitement le champ Dépense. Dans la colonne Type, notez qu’il est Personnalisé. Dans CDS, la personnalisation indique une action volontaire du contributeur. Par exemple, votre entité Note de frais est aussi de type Personnalisé, car c’est vous qui l’avez créée.
Par ailleurs, la mention Champ principal, qui est accolée au nom du champ, indique le rôle essentiel de ce champ.
Les autres champs ont été rajoutés, à la suite de l’activation des options de l’exercice précédent. Vous êtes libre de les utiliser ou non, selon vos besoins.
Ajouter le champ Mission
Vous allez ajouter des champs métiers supplémentaires. Pour ce faire, cliquez sur le lien Ajouter un champ du menu : le volet Propriété du champ s’ouvre sur la droite.
Renseignez le nom d’affichage : Mission.
Sélectionnez le Type de données : Texte. Normalement, c’est le choix par défaut.
Laissez les autres options par défaut.
Pour vous aider, regardez la copie d’écran ci-dessous.
Puis cliquez sur le bouton OK : le champ Mission apparaît dans la liste des champs en gras.
Enregistrer les modifications de l’entité
Maintenant, vous allez enregistrer l’entité. En effet, pour l’instant, le champ n’est pas encore pris en compte par CDS. Pour ce faire, cliquez sur le bouton Enregistrer l’entité (en bas).
En respectant le même principe, ajoutez ces 7 champs supplémentaires :
Ajouter le champ Date déplacement
Ajoutez le champ Date déplacement de type Date uniquement.
Pour vous aider, regardez la copie d’écran ci-dessous.
Ajouter le champ Moyen de transport
Ajoutez le champ Moyen de transport de type Groupe d’options.
Cliquez sur Groupe d’options puis cliquez sur Nouveau groupe d’options puis créez les 4 éléments d’options suivants : Taxi, Train, Voiture, VTC.
Le moment venu, vous ne mettrez pas de valeur par défaut.
Pour vous aider, regardez la copie d’écran ci-dessous.
Ajouter le champ Nombre Km
Ajoutez le champ Nombre Km de type Nombre entier.
Indiquez dans les options avancées que la valeur minimale est 0 et la valeur maximale 10000.
Pour vous aider, regardez la copie d’écran ci-dessous.
Ajouter le champ Montant payé
Ajoutez le champ Montant payé de type Devise.
Indiquez dans les options avancées que la valeur minimale est 0 et la valeur maximale 10000.
Indiquez aussi que la Source de précision est Propriété de précision et que le Nombre de décimales est 2.
Pour vous aider, regardez la copie d’écran ci-dessous.
Ajouter le champ Date validation
Ajoutez le champ Date validation de type Date uniquement.
Pour vous aider, regardez la copie d’écran ci-dessous.
Ajouter le champ NdF Validée
Ajoutez le champ NdF Validée de type Deux options.
Gardez les valeurs proposées : Oui / Non.
Gardez aussi la valeur par défaut (Non).
Pour vous aider, regardez la copie d’écran ci-dessous.
Ajouter le champ Remboursable
Ajoutez le champ Remboursable de type Deux options.
Gardez les valeurs proposées : Oui / Non.
Gardez aussi la valeur par défaut (Non).
Pour vous aider, regardez la copie d’écran ci-dessous.
Enregistrer les nouvelles modifications de l’entité
Quand tous les champs seront créés, cliquez sur le bouton Enregistrer l’entité : vos champs ont bien été créés.
Pour ne voir que vos champs, cliquez sur l’affichage personnalisé. Vous voyez aussi apparaître automatiquement des champs supplémentaires à la suite de vos manipulations.
Pour vous aider, regardez la copie d’écran ci-dessous.
Les champs encadrés sont les champs que vous avez créés explicitement.
Les autres champs ont été rajoutés pour tenir compte des contraintes, liées aux types de données des champs initialement créés.
Par exemple, quand vous avez créé le champ Montant payé, les champs Devise, Montant payé (de base) et Taux de change ont été automatiquement ajoutés.
En effet, lors d’un achat en Francs Suisse, la devise est le franc suisse, le montant payé (de base) est la somme payée en francs suisse au taux de change de 0,95.
L’exercice est terminé.
Résumé
Dans cet exercice, vous avez appris à créer des champs dans l’entité. Vous avez aussi découvert qu’un champ pouvait avoir un type de données et qu’il existait de très nombreux types. Vous avez aussi vu que vous pouviez personnaliser certains types de données. Enfin, vous avez découvert que certains champs pouvaient s’ajouter automatiquement en fonction du type de données sélectionné.
Article mis à jour le 18.04.2020.