Balises de modèle

Les balises de modèle contrôlent le résultat d’un modèle de différentes façons, et permettent de combiner plusieurs modèles en un seul résultat.

fetchxml

Permet à l’utilisateur d’interroger les données de Microsoft Dataverse et d’afficher les résultats dans une page.

{% fetchxml resultVariable %}
<!— Fetchxml query -->
...
{% endfetchxml %}

Lorsque vous utilisez fetchxml pour interroger des données, assurez-vous de ne pas utiliser de balises à fermeture automatique. Par exemple, au lieu de <attribute name="title"/>, utilisez <attribute name="title"></attribute> avec balise de fermeture explicite </attribute>.

Attribut Résultats

L’attribut Results dans la variable fournie (telle que "resultVariable" dans l’exemple ci-dessus) contient les FetchXML résultats de la requête et quelques autres attributs.

• Entités

  Cet attribut contient le résultat de la requête fetchxml. Vous pouvez parcourir le résultat et l’utiliser dans votre modèle web.

  <table> 
  {% for entityVariable in resultVariable.results.entities %} 
  <tr> 
  <td>Attribut-1: {{ entityVariable.attribute1 }}</td> 
  <td>Attribut-2: {{ entityVariable.attribute2 }}</td> 
  </tr> 
  {% endfor %} 
  </table> 
  

• TableName

  Obtient le nom logique de l’entité.

• ExtensionData

  Obtient la structure contenant les données supplémentaires.

• MinActiveRowVersion

  Obtient la valeur de version de ligne active la plus basse.

• MoreRecords

  Obtient s’il y a plus d’enregistrements disponibles.

• PagingCookie

  Obtient les informations de pagination actuelles.

• TotalRecordCount

  Obtient le nombre total d’enregistrements dans la collection.
  ReturnTotalRecordCount était vrai lorsque la requête a été exécutée.

• TotalRecordCountLimitExceeded

  Obtient si les résultats de la requête dépassent le nombre total d’enregistrements.

Attribut XML

L’attribut XML dans la variable fournie (comme "resultVariable" dans l’exemple ci-dessus) contient la requête résultante qui peut être utilisée pour obtenir des données de Microsoft Dataverse. Cet attribut est utile à des fins de débogage lorsque vous souhaitez comprendre comment l’autorisation de table est appliquée à cette balise fetchxml.

Autres éléments et attributs pris en charge

La balise liquide fetchxml prend en charge les attributs suivants et les éléments enfants.

inclure

Inclut le contenu d’un modèle dans un autre, par son nom. Dans Power Pages, la source de cet autre modèle est généralement un modèle web. Cet opérateur permet de réutiliser des fragments de modèles courants à plusieurs endroits.

Lorsqu’un modèle est inclus dans un autre, le modèle inclus aura accès à toutes les variables définies dans le modèle parent.

{% include 'My Template' %}

Il est également possible de passer n’importe quel nombre de paramètres dans la balise d’inclusion. Ces paramètres seront alors définis comme des variables dans le modèle inclus.

{% include 'My Template' a:x, b:y %}

block

Utilisé avec extends pour fournir l’héritage de modèle. Consultez extends pour savoir comment l’utiliser.

extends

Utilisé avec la balise block, fournit l’héritage de modèle. Cet opérateur permet à plusieurs modèles d’utiliser une structure partagée, tout en remplaçant des zones particulières de la disposition parente.

Dans Power Pages, le nom du modèle parent fourni à la balise se rapporte généralement au nom d’un modèle web.

Lorsque extends est utilisé, il doit s’agir du premier contenu du modèle, et il ne peut être suivi que par une ou plusieurs balises block.

Si un bloc (block) défini dans le modèle parent n’est pas remplacé, son contenu dans le modèle parent (le cas échéant) s’affichera.

commentaire

Vous permet de conserver code non affiché au sein d’un modèle Liquid. Aucun contenu du bloc ne s’affichera, et aucun code Liquid dans ne sera exécuté.

Code

Hello{% comment %}, {{ user.fullname }}{% endcomment %}. My name is Charles.

Sortie

Hello. My name is Charles.

raw

Permet la sortie de code Liquid sur une page sans analyse ni exécution préalable.

Sortie

Hello, {{ user.fullname }}. My name is Charles.

substitution

Lorsque vous activez la mise en cache de l’en-tête et du pied de page et que vous souhaitez éviter la mise en cache de certaines sorties de section, vous pouvez utiliser cette balise. Cette balise fournit le bloc de contenu dans l’en-tête ou le pied de page où la sortie du bloc de contenu encapsulé n’est pas mise en cache. Cet opérateur est utile dans les scénarios où l’utilisateur utilise un objet qui peut être fréquemment mis à jour, comme une demande, une page, une langue et une date. Par exemple, reportez-vous aux scénarios de mise à jour du code source du modèle web d’en-tête et de pied de page lorsque la mise en cache des en-têtes et pieds de page est activée.

codecomponent

Voir Comprendre la balise d’entité codecomponent Dataverse, Utiliser la balise de modèle Liquid des composants du code.

Voir aussi

Balises de flux de contrôle
Balises d’itération
Balises de variable
Balises Liquid Dataverse
Utiliser les composants de code de l’indicateur de modèle Liquid