Décode l'informatique
Affichage par défaut

Créer une nouvelle entité CDS dans le service de données communes

Cet exemple vous explique comment créer une nouvelle entité dans la base de données CDS (Common Data Service).

Vous constaterez que les entités sont créées au singulier. C’est voulu car la forme plurielle est générée automatiquement pour la table de données correspondante.

Dans ce scénario, il s’agit de créer une entité qui peut gérer des notes de frais. Ces notes de frais seront centralisées puis saisies par l’opérateur du service central.

Cet exemple est le premier d’une série de plusieurs qui vous feront notamment découvrir la richesse des applications basées sur un modèle. Toutefois, il faudra être patient car le travail préparatoire se fait par étapes avant d’en voir le résultat qui vaut vraiment le coup 😉.

Par ailleurs, vous ferez attention de ne pas valider trop vite la création de la nouvelle entité.

Préparation

  • Pour faire cet exercice, vous avez besoin d’une base CDS existante.

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.

Créer une entité

Pour créer votre entité, cliquez (haut) sur Nouvelle entité: le volet Nouvelle entité s’ouvre sur la droite.

Dans le volet Nouvelle entité, renseignez le nom d’affichage avec Note de frais.

Le nom de l’entité est au singulier.

Les champs Plusieurs noms d’affichage et Nom se mettent à jour automatiquement en fonction du nom d’affichage que vous avez entré.

Le champ Plusieurs noms d’affichage permet d’indiquer le nom de la table qui stocke les données de l’entité.

Modifiez la valeur du champ Plusieurs noms d’affichage en Notes de frais.

Le champ Nom peut être éventuellement modifié maintenant. Il s’agit d’un nom unique au sein de votre environnement. Après la création d’une entité, ce nom ne peut plus être modifié. Pour la formation, il n’est pas nécessaire de le modifier. De plus, il comporte un préfixe qui a été automatiquement généré par le système, par exemple cr121_. Ce préfixe permet de donner un nom unique à vos objets si vous souhaitez les importer dans un autre environnement, qui aura un autre préfixe.

Notez quelque part votre préfixe car vous en aurez besoin plus tard.

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

Nouvelle entité en cours de création
Nouvelle entité en cours de création

Ne cliquez pas sur le bouton Créer !

Créer le champ principal

Un nom d’affichage du Champ principal est proposé. Il sert à identifier chacun des futurs enregistrements. Afin de rendre convivial l’application, le choix est fait dans ce scénario d’utiliser le nom de la Dépense comme identificateur. Toutefois, vous auriez pu aussi utiliser un identifiant numérique ou un code.

Modifiez la valeur du champ Nom d’affichage du champ principal en Dépense.

Vous remarquerez que la valeur du champ Nom du champ principal a été générée automatiquement. Notamment, l’accent a été supprimé sur le é du mot Dépense.

Ne cliquez pas sur le bouton Créer !

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

Nouvelle entité en cours de création
Nouvelle entité en cours de création

Avant de créer l’entité, vous allez compléter quelques informations complémentaires.

Paramétrer l’entité

Cliquez sur le lien Plus de paramètres puis ouvrez Description et saisissez le texte suivant Enregistrement des dépenses liées aux notes de frais pour obtenir leur remboursement.

Ensuite, vous allez ajouter des champs supplémentaires facultatifs à l’aide des options proposées lors de la création ou la modification de l’entité. Bien que ces champs soient facultatifs, la plupart d’entre eux ne pourront pas être supprimés par la suite. Par exemple, si vous vous rendez compte que finalement ils ne servent à rien. Pour la formation ce n’est évidemment pas gênant. Toutefois, en production, cela peut devenir perturbant.

Ouvrez aussi le lien Collaboration, puis cochez :

  • Autoriser les commentaires
  • Activer la gestion de documents SharePoint

Laissez les autres options de collaboration à leurs valeurs par défaut.

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

Options de collaboration
Options de collaboration

Ne modifiez les autres options de création de l’entité.

Maintenant, cliquez (enfin !) sur le bouton Créer : un pop-up surgit. Il vous informe que certaines options ne pourront plus être désactivées.

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

Confirmer les modifications
Confirmer les modifications

Vérifiez que vous avez coché les bonnes options puis cliquez sur le bouton OK.

Patientez quelques secondes : l’entité est en cours de création.

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

Entité Note de frais en cours de provisionnement
Entité Note de frais en cours de provisionnement

Au bout d’une vingtaine de secondes, l’entité Note de frais est bien créée et provisionnée.

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

Entité Note de frais créée
Entité Note de frais créée

Consulter la liste des entités

Avec la méthode de votre choix, revenez sur la liste des entités. Votre entité Note de frais s’affiche parmi toutes les autres entités. Ce qui ne la rend pas très visible. Toutefois, vous pouvez la rendre plus visible.

Pour ce faire, en haut et à droite, cliquez sur l’affichage qui s’intitule Par défaut.

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

Affichage par défaut
Affichage par défaut

Dans ce menu, cliquez sur l’affichage qui s’intitule Personnalisé : l’entité Note de frais que vous venez de créer s’affiche seule. C’est normal car pour l’instant vous n’avez créé qu’une seule entité.

L’exercice suivant fournira plus d’explications sur l’entité et ses composantes.

L’exercice est terminé.

Résumé

Dans cet exercice, vous avez appris à créer et paramétrer votre propre entité.

À partir de maintenant, cette entité servira aux prochains exercices.

Article mis à jour le 17.04.2020.

Claude COUDERC

Ajouter un commentaire