Catégories
Consultant, Formateur

Créer des champs supplémentaires dans une entité CDS

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

Administrer l’entité

Ouvrez le site web Microsoft Power Apps et identifiez-vous avec votre compte.

https://make.powerapps.com/

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.

Champs de l'entité (extrait)
Champs de l’entité (extrait)

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.

Création du champ Mission
Création du champ Mission

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.

Création du champ Date déplacement
Création du champ Date déplacement

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.

Création du champ Moyen de transport
Création du champ Moyen de transport

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.

Création du champ Nombre Km
Création du champ Nombre Km

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.

Création du champ Montant payé
Création du champ Montant payé

Ajouter le champ Date validation

Ajoutez le champ Date validation de type Date uniquement.

Pour vous aider, regardez la copie d’écran ci-dessous.

Création du champ Date validation
Création du champ Date validation

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.

Création du champ NdF Validée
Création du champ NdF Validée

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.

Création du champ Remboursable
Création du champ Remboursable

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.

Champs personnalisés
Champs personnalisés

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.

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *