Exercice : afficher une liste de comptes

20 minutes

L’objectif de ce labo pratique est d’accéder aux données Microsoft Dataverse à l’aide de Liquid.

Les exercices sont plus pertinents si vous disposez d’exemples de données à utiliser. En fonction de l’environnement utilisé, vous pouvez installer certains exemples de données pour vous aider dans les exercices. Microsoft Power Platform permet d’ajouter des exemples de données si nécessaire. Si aucun exemple de données n’est installé dans l’environnement utilisé, suivez les étapes de la documentation Ajouter ou supprimer des exemples de données pour installer les exemples de données dans votre environnement.

Objectifs d’apprentissage

La finalité de ces exercices est que vous découvriez comment :

saisir le code Liquid dans le cadre du contenu de la page ;
accéder à des données Dataverse à l’aide de Liquid ;
ajouter des instructions conditionnelles pour afficher uniquement les données disponibles.

Conditions préalables

Pour cet exercice, les paramètres suivants doivent être configurés dans votre environnement :

Un site web Power Pages approvisionné. Si vous ne disposez d’aucun site web, suivez les instructions Créer un site avec Power Pages.
Accès au studio de conception Power Pages.

Étapes générales

Dans cet exercice, vous allez afficher les enregistrements Dataverse sélectionnés en ajoutant du code HTML et Liquid à la section de texte d’une page web à l’aide de l’éditeur de code du studio de conception Power Pages.

Ouvrir votre site web dans le studio de conception Power Pages
Ajouter une page web Fournisseurs
Ajouter le code HTML et Liquid qui répertorie tous les comptes actifs
Prévisualiser les résultats dans le studio de conception et dans un navigateur
Ajouter des autorisations de lecture de table pour la table Compte et vérifier les résultats dans un navigateur

Étapes détaillées

Suivez les étapes détaillées dans cette section pour effectuer l’exercice.

Lancer le studio de conception Power Pages

Pour lancer le studio de conception Power Pages, procédez comme suit :

Connectez-vous à Power Pages.
Sélectionnez l’environnement adéquat dans le coin supérieur droit.
Sélectionnez le site web, puis cliquez sur Modifier.

Créer la page web Fournisseurs

Pour créer la page web Fournisseurs, procédez comme suit :

Sélectionnez l’espace de travail Pages.
Cliquez sur + Page.
- Saisissez Fournisseurs pour le nom de la page.
- Sélectionnez le modèle Démarrer à partir de zéro.
- Cliquez sur Ajouter.

Modifier le code source

Pour modifier le code source afin de répertorier tous les comptes actifs, procédez comme suit :

Sélectionnez le contenu sur le canevas de la page, puis ajoutez un composant de texte.

Remplacez l’espace réservé pour le composant par le texte suivant :

<h2>List of accounts</h2>
{% entityview logical_name:'account', name:'Active Accounts' %}
<p>We have {{ entityview.total_records }} accounts.</p>
<ul>
  {% for account in entityview.records -%}
  <li>{{ account.name }}
    {% if account.telephone1 %}
    (<a href="tel:{{ account.telephone1 }}">{{ account.telephone1 }}</a>)
    {% endif %}
  </li>
  {% endfor %}
</ul>
{% endentityview %}

Cliquez sur Synchroniser.
La liste des comptes actuels devrait s’afficher sur le canevas de la page, y compris les numéros de téléphone en lien hypertexte, le cas échéant.

Important

Le studio de conception vous permet de saisir du code Liquid à l’aide d’un composant de texte standard. Une fois que vous avez enregistré et synchronisé la page, Power Pages convertit le composant de texte en un composant avancé indiquant que la modification intraligne n’est plus disponible. Vous pouvez toujours accéder au code Liquid dans l’éditeur Visual Studio Code, que vous pouvez lancer en cliquant sur le bouton Modifier le code.
Cliquez sur Aperçu > Bureau. La page web qui s’affiche ne doit contenir que le texte « Nous avons 0 compte. »

Remarque

Ce résultat est attendu, car au moment de l’exécution, Power Pages refuse l’accès aux lignes de table, sauf si un enregistrement d’autorisation de table existe pour autoriser l’accès aux données.

Ajouter des autorisations de table

Pour afficher la liste des enregistrements de compte lorsque vous naviguez sur une page, vous devez ajouter des autorisations de table.

Avertissement

Dans cet exercice, vous allez ajouter des autorisations de lecture globales sur la table Compte pour tous les visiteurs. Ce paramétrage n’est pas une configuration de sécurité typique : elle est utilisée uniquement à des fins de démonstration.

Pour ajouter des autorisations de table, procédez comme suit :

Sélectionnez l’espace de travail Configuration, puis cliquez sur Autorisations de table.
Cliquez sur + Nouveau.
Saisissez les valeurs suivantes :
- Nom : Fournisseurs
- Table : sélectionnez la table Compte
- Type d’accès : sélectionnez Accès global
- Autorisation de : sélectionnez Lecture
Cliquez sur Ajouter des rôles.
Sélectionnez Utilisateurs anonymes et Utilisateurs authentifiés.
Cliquez sur Enregistrer.
Cliquez sur Aperçu > Bureau.

Une liste des comptes devrait s’afficher.

Continuer