Balises de modèle
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é).