Guide pas à pas avec une table virtuelle utilisant le fournisseur de données OData v4

  • Article

Imaginez que vous souhaitiez accéder, créer, mettre à jour et supprimer des informations personnelles d'un contact à partir d'un source de données externe dans votre application pilotée par modèle. Dans cette procédure pas à pas, vous modéliserez une table virtuelle nommée Personne avec des colonnes mappés sur le schéma externe de ces opérations au moment de l'exécution à partir d'un service Web OData.

Détails sur la source de données

Comme la source de données utilisée pour cette procédure dispose d'un service Web OData v4, nous pouvons utiliser le fournisseur de données OData v4 inclus avec votre environnement.

URL du service Web : https://contosowebservice.azurewebsites.net/odata/

Important

  • L'URL du service web utilisé pour cette procédure n'est pas un service web fonctionnel.
  • Vous ne pouvez pas utiliser le fournisseur de données OData v4 pour vous connecter à un autre environnement.

Pour cette procédure, une table virtuelle unique contenant les colonnes suivantes est nécessaire.

Nom de la colonne externe Type de données externes Type de données de table virtuelle Objectif
ID Edm.Guid Clé primaire Clé primaire de la table
FirstName Edm.String Une seule ligne de texte Prénom de la personne
LastName Edm.String Une seule ligne de texte Nom de la personne
Âge Edm.Int32 Nombre entier Âge de la personne
LastModifiedOn Edm.DateTimeOffset Date et heure Date et heure de la dernière modification de l'enregistrement de la personne

Les métadonnées OData de la table Personne de la source de données externes :

XML de la source de données externe OData, partie 2.

Créer la source de données

Créez la source de données pour le fournisseur de données OData v4 qui utilise l'exemple du service Web OASIS Open Data Protocol (OData).

  1. Accédez à Paramètres > Administration > Sources de données d'entités virtuelles.

  2. Sélectionnez NOUVEAU, sélectionnez Fournisseur de données OData v4, puis sélectionnez OK.

  3. Entrez ou sélectionnez les informations suivantes.

    Champ valeur
    **Nom ** Exemple de source de données OData d'une personne
    URL https://contosowebservice.azurewebsites.net/odata
    Délai d'expiration 30
    Retourner le comptage en ligne Pagination côté client
    Retourner le comptage en ligne Vrai

Laissez les autres colonnes telles quelles et sélectionnez ENREGISTRER ET FERMER.

Conseil

Si vous utilisez votre propre service Web, vérifiez que l'URL est valide en la collant dans votre navigateur Web. Si vous souhaitez comprendre les colonnes et les types de données respectifs de la table qui vous intéresse, vous pouvez ajouter /$metadata à la fin de votre URL pour voir la définition des tables dans votre service Web.

Ouvrez l'explorateur de solutions

Une partie du nom d'une table personnalisée que vous créez est le préfixe de personnalisation. Il est défini en fonction de l'éditeur de solutions pour la solution que vous utilisez Veillez à utiliser une solution non gérée avec le préfixe de personnalisation que vous souhaitez pour cette table. Pour plus d'informations : Modifier le préfixe de l'éditeur de solutions

Ouvrir une solution non managée

  1. Dans Power Apps, sélectionnez Solutions dans le volet de navigation de gauche, puis dans la barre d’outils, sélectionnez Basculer vers l’affichage classique. Si l’élément ne se trouve pas dans le volet latéral, sélectionnez …Plus, puis sélectionnez l’élément souhaité.

  2. Dans la liste Toutes les solutions, ouvrez la solution non gérée souhaitée.

Créer la table virtuelle

  1. Dans le volet de navigation de gauche de l'explorateur de solution, sélectionnez Entités, puis sélectionnez Nouveau dans le volet principal.

  2. Dans le formulaire Entité : Nouveau, sélectionnez l'option Table virtuelle, puis entrez les informations suivantes :

    Champ valeur
    Source de données Exemple de source de données OData d'une personne
    Nom d'affichage Personne
    Nom au pluriel Personnes
    **Nom ** new_person
    Nom externe Personnes
    Nom de la collection externe Personnes
    Notes (avec pièces jointes) sélectionné
    Activités sélectionné

    Notes

    La sémantique du chemin d'accès à la ressource OData utilise EntitySet pour identifier la ressource. Dans l'exemple de service Web OData, le EntitySet est défini comme Personnes. Cette valeur est utilisée comme Nom externe pour la table virtuelle Personne.

  3. En regard de Zones affichant cette entité, sélectionnez Ventes, puis sélectionnez Enregistrer (mais ne fermez pas le formulaire de table). Définition de la table Personne.

Créer des colonnes pour la table virtuelle

Dans le volet de navigation de gauche de la page Entité : Personne, sélectionnez Champs. Dans le cadre de cette procédure pas à pas, vous allez modifier deux colonnes existantes et ajouter trois autres colonnes disponibles dans le source de données externe.

Important

Les noms externes respectent la casse. Reportez-vous aux métadonnées du service Web pour vérifier que vous utilisez le nom correct. Une valeur qui autorise la valeur Null False indique que l'attribut est obligatoire. Notez que les colonnes de clé primaire sont toujours exigées par le système.

  1. Ouvrez la colonne new_personid, et modifiez la propriété suivante avec la valeur indiquée ici :

    Nom externe : ID

    Créer la colonne ID.

  2. Sélectionnez Enregistrer et fermer.

  3. Ouvrez la colonne new_name, et modifiez les propriétés suivantes avec les valeurs indiquées ici :

    • Nom d'affichage: Nom de famille
    • Nom externe : LastName

    Créer la colonne Nom.

  4. Sélectionnez Enregistrer et fermer.

  5. Sélectionnez Nouveau, puis dans la page Champ : Nouveau pour Personne, entrez les informations suivantes :

    Champ valeur
    Nom d'affichage Prénom
    **Nom ** new_firstname
    Nom externe FirstName
    Champ requis Contrainte obligatoire
    Type de données Une seule ligne de texte

    Créer une colonne d'âge pour Personne.

  6. Sélectionnez Enregistrer et fermer.

  7. Sélectionnez Nouveau, puis dans la page Champ : Nouveau pour Personne, entrez les informations suivantes :

    Champ valeur
    Nom d'affichage Âge
    **Nom ** new_age
    Nom externe Âge
    Champ requis Contrainte obligatoire
    Type de données Nombre entier

    Créer une colonne d'âge.

  8. Sélectionnez Enregistrer et fermer.

  9. Sélectionnez Nouveau, puis dans la page Champ : Nouveau de Personne, entrez les informations suivantes :

    Champ valeur
    Nom d'affichage Dernière modification le
    **Nom ** new_lastmodifiedon
    Nom externe LastModifiedOn
    Champ requis Contrainte obligatoire
    Type de données Date et heure

    Créer la colonne Date de dernière modification.

Ajouter des colonnes au formulaire principal

  1. Dans la fenêtre de la table Personne, sélectionnez Formulaires.

  2. Ouvrez le formulaire principal, faites glisser et déposez les colonnes Prénom, Âge et Date de dernière modification du volet droit sur le formulaire dans la section Général.

    Colonnes Prénom, Âge et Date de dernière modification ajoutées au formulaire principal.

  3. Dans la fenêtre de la table Personne, sélectionnez Enregistrer et fermer.

Configurer la vue par défaut

  1. Dans le volet de gauche de l'explorateur de solutions, sous Entité Personne, sélectionnez Vues.
  2. Ouvrez la vue Toutes les personnes.
  3. Dans le volet Tâches courantes, sélectionnez Ajouter des colonnes. Ajouter des colonnes pour la vue.
  4. Sélectionnez les colonnes Prénom, Âge et Date de dernière modification, puis sélectionnez OK.
  5. Dans la fenêtre Vue : Toutes les personnes, organisez l'ordre des colonnes en sélectionnant les flèches de déplacement vers la gauche et vers la droite, puis sélectionnez Enregistrer et fermer.
  6. Dans la fenêtre de l'explorateur de solutions, sélectionnez Publier toutes les personnalisations.
  7. Une fois toutes les personnalisations publiées, fermez la fenêtre de l'explorateur de solutions.

Utiliser la table virtuelle dans une application pilotée par modèle

Créez une application pilotée par modèle et ajoutez la table Personne au plan du site. Ensuite, sélectionnez le formulaire principal Personne et la vue Recherche avancée de personne. Publier l'application Pour plus d'informations : Générer votre première application pilotée par modèle à partir de zéro

Ensuite, les utilisateurs de l'application peuvent effectuer des opérations de lecture, de création, de mise à jour et de suppression à l'aide de la table virtuelle exactement comme avec n'importe quelle autre table dans Microsoft Dataverse.

Créer, afficher et supprimer des enregistrements à l'aide de la table virtuelle

  1. Exécutez l'application pilotée par modèle. Sélectionnez Nouveau, remplissez les colonnes requises, puis enregistrez l'enregistrement.
  2. Sélectionnez Nouveau à nouveau pour créer un autre enregistrement et le sauvegarder.
  3. Vous devriez maintenant avoir deux enregistrements similaires à ce qui suit dans la vue Toutes les personnes. Vue Toutes les personnes.
  4. Pour supprimer un enregistrement, sélectionnez un enregistrement de personne, puis sélectionnez Supprimer. Confirmez la suppression de l'enregistrement sur la page de confirmation.

Voir aussi

Configuration du fournisseur de données OData v4, configurations requises et bonnes pratiques
Création et modification de tables virtuelles qui contiennent des données provenant d'une source de données externe

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).