Balises de modèle

  • Article

Notes

À compter du 12 octobre 2022, le portail Power Apps devient Power Pages. Plus d’informations : Microsoft Power Pages est maintenant généralement disponible (blog)
Nous allons bientôt migrer et fusionner la documentation des portails Power Apps avec la documentation de Power Pages.

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.

Notes

Vous pouvez en savoir plus sur l’interrogation des données à l’aide de fetchxml sur utiliser FetchXML pour interroger les données.

{% 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 de résultats dans la variable fournie (comme "resultVariable" dans l’exemple ci-dessus) contient les résultats de la requête FetchXML 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.

Élément/élément enfant Attributs Élément enfant
fetch mappage
version
nombre
page
paging-cookie
utc-offset
cumul
distinct
min-active-row-version
output-format
returntotalrecordcount
no-lock		 commande
Entité
commande attribut
alias
décroissant
Entité name
all-attributes
no-attrs
attribut		 commande
filter
link-entity
filter type
hint
isquickfindfields		 Condition
filter
link-entity name
de
à
alias
link-type
visible
intersection
all-attributes
no-attrs
attribut		 commande
filter
link-entity
Condition colonne
entityname
attribut
opérateur
cumul
alias
uiname
uitype
uihidden
valeur		 valeur

inclure

Inclut le contenu d’un modèle dans un autre, par son nom. Dans les portails Power Apps, la source de cet autre modèle est généralement un modèle web. Cela 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. Ils seront alors définis comme des variables dans le modèle inclus.

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

block

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

extends

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

Dans les portails Power Apps, 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. Cela 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.

Conseil

L’URL utilisée dans request.url peut être n’importe quelle valeur demandée et obtient mis en cache pour les demandes ultérieures. Pour garantir une valeur correcte dans request.url, pensez à utiliser une balise de substitution, une URL partielle telle que ~{chemin du fichier web} ou stockez l’URL du portail dans Paramètres du site.

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
Étiquettes d’entité Power Apps Dataverse
Utiliser les composants de code de l’indicateur de modèle Liquid

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é).