Objets Liquid disponibles
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 objets Liquid contiennent des attributs pour présenter le contenu dynamique dans la page. Par exemple, l’objet page comporte un attribut nommé title qui peut être utilisé pour présenter le titre de la page actuelle.
Pour accéder à un attribut d’objet par son nom, utilisez un point (.). Pour afficher un attribut d’objet dans un modèle, incluez-le dans un wrapper dans {{ and }}.
Important
Pour éviter d’éventuels problèmes de script intersite (XSS), utilisez toujours le filtre d’échappement pour encoder des données HTML chaque fois que vous utilisez des objets Liquid pour lire des données non fiables fournies par l’utilisateur.
{{ page.title }}
Les attributs d’un objet peuvent également être accessibles via un nom sous forme de chaîne et []. Ce format est utile dans les cas où l’attribut requis est déterminé dynamiquement, ou si le nom de l’attribut contient des caractères, des espaces, des caractères spéciaux, etc. qui ne sont pas valides lors de l’utilisation d’un point (.) dans la syntaxe.
{{ page[title] }}
{% assign attribute_name = Name with spaces %}
{{ object[attribute_name] }}
Les objets suivants peuvent être utilisés et sont accessibles partout, dans tous les modèles.
| Objet | Description |
|---|---|
| entités | Permet de charger n’importe quelle table Power Apps par son ID. Pour plus d’informations : entities |
| maintenant | Un objet date/heure qui fait référence à l’heure UTC actuelle, à l’heure où le modèle est affiché. Remarque : cette valeur est mise en cache par l’application Web du portail et n’est pas actualisée à chaque fois. Pour plus d’informations : Date filters |
| page | Se rapporte à la page de requête du portail actuel. L’objet page donne accès à des éléments tels que les vues miniatures, le titre ou l’URL de la page actuelle, ainsi qu’à tous les autres attributs ou entités associés de l’enregistrement Power Apps sous-jacent. Pour plus d’informations : page |
| params | Raccourci pratique pour request.params. Pour plus d’informations : request |
| request | Contient des informations sur la requête HTTP actuelle. Pour plus d’informations : request |
| paramètres | Permet de charger n’importe quel paramètre de site par nom. Pour plus d’informations : settings |
| sitemap | Autoriser l’accès au plan de site du portail. Pour plus d’informations : sitemap |
| sitemarkers | Permet de charger n’importe quel marqueur de site par nom. Pour plus d’informations : sitemarkers |
| snippets | Permet de charger n’importe quel extrait de code de contenu (snippet) par nom. Pour plus d’informations : snippets |
| utilisateur | Se rapporte à l’utilisateur actuel du portail, donnant ainsi accès à tous les attributs de l’enregistrement de contact Power Apps sous-jacent. Si aucun utilisateur n’est connecté, cette variable est null. Pour plus d’informations : user |
| weblinks | Vous permet de charger n’importe quel lien Web défini par son nom ou son ID. Pour plus d’informations : weblinks |
| website | Se rapporte à l’enregistrement de site Web du portail, donnant ainsi accès à tous les attributs de l’enregistrement du site Web Power Apps (adx_website) pour le portail. Pour plus d’informations : website |
ads
Offre la possibilité d’accéder à une publicité et de l’afficher.
L’objet ads vous permet de sélectionner une publicité ou un placement publicitaire spécifique :
<div>
{% assign ad = ads[Ad Name] %}
<h4>{{ ad.title }}</h4>
<a href={{ ad.redirect_url }}>
<img src={{ ad.image.url }} alt={{ ad.image.alternate_text }} />
</a>
</div>
Attributs de publicités
| Attribut | Description |
|---|---|
| placements | Renvoie l’objet placements publicitaires. |
| [nom ou ID de la publicité] | Vous pouvez accéder à n’importe quelle publicité par ses propriétés de nom ou d’ID. {% assign ad = ads[Ad Name] %}{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Attributs de placements publicitaires
| Attribut | Description |
|---|---|
| [nom ou ID du placement publicitaire] | Vous pouvez accéder à n’importe quel placement publicitaire par ses propriétés de nom ou d’ID.{% assign placement = ads.placements[Placement Name or Id] %}{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %} |
Attributs de placement publicitaire
Un emplacement d’annonce est un objet de tableau avec les mêmes attributs généraux et les attributs répertoriés ci-dessous.
| Attribut | Description |
|---|---|
| Publicités | Renvoie la collection d’objets de publicité associés à l’emplacement. Les balises d’itération et les filtres de tableau peuvent être utilisés avec cette collection. |
| Nom | Renvoie le champ Nom pour le placement publicitaire. |
| placement_url | L’URL qui peut servir à récupérer le placement publicitaire totalement affiché par un modèle. |
| random_url | L’URL qui peut servir à récupérer une publicité aléatoire totalement affichée par un modèle. |
Attributs de publicité
Notes
Une publicité est un objet de table, avec tous les mêmes attributs en plus de ceux répertoriés ci-dessous.
| Attribut | Description |
|---|---|
| ad_url | L’URL qui peut servir à récupérer la publicité totalement affichée par un modèle. |
| Copier | Renvoie le champ Copier pour la publicité. |
| image | Renvoie l’objet image (le cas échéant) pour la publicité. |
| Nom | Renvoie le champ Nom pour la publicité. |
| open_in_new_window | Renvoie true (vrai) si l’URL spécifiée par redirect_url s’ouvre dans une nouvelle fenêtre. |
| redirect_url | L’URL vers laquelle l’utilisateur est dirigé quand il sélectionne la publicité. |
Attributs d’image de publicité
| Attribut | Description |
|---|---|
| alternate_text | Renvoie le texte qui doit s’afficher dans l’attribut alt de la balise. |
| hauteur | Renvoie la hauteur en pixels de l’image |
| URL | Renvoie l’URL source pour l’image. |
| largeur | Renvoie la largeur en pixels de l’image |
blogs
Permet d’accéder aux blogs et billets de blog et de les afficher.
L’objet blogs vous permet de sélectionner un blog ou des billets de blog spécifiques.
{% assign posts = blogs.posts | paginate: 0,4 %}
<div class=content-panel panel panel-default>
<div class=panel-heading>
{% assign sitemarker = sitemarkers["Blog Home"] %}
{% assign snippet = snippets[Home Blog Activity Heading] %}
<a class=pull-right href={{sitemarker.url}}> All Blogs </a>
<h4>
<a class=feed-icon fa fa-rss-square href={{ blogs.feedpath }} />
{{ snippet.adx_value }}
</h4>
</div>
<ul class=list-group>
{% for post in posts.all %}
<li class=list-group-item >
<a class=user-avatar href={{ post.author_url }}>
<img src={{ post.user_image_url }} />
</a>
<h4 class=list-group-item-heading>
<a href={{ post.app_relative_path }}>{{ post.title }}</a>
</h4>
<div class=content-metadata>
<abbr class=timeago>{{ post.publish_date }}</abbr>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<a href={{ post.application_path }}#comments>
<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}
</a>
</div>
</li>
{% endfor %}
</ul>
</div>
Objet blogs
L’objet blogs vous permet d’accéder à un blog spécifique du portail ou d’accéder à tous les billets de blog du portail.
Le tableau suivant décrit les attributs associés à l’objet blogs.
| Attribut | Description |
|---|---|
| posts | Retourne un objet blogposts contenant tous les billets de blog du portail. |
| [nom ou ID du blog] | Vous pouvez accéder à n’importe quel blog par ses propriétés de nom ou d’ID. |
{% assign blog = blogs["Blog Name"] %}
{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Objet blog
L’objet blog vous permet d’utiliser un seul blog et d’accéder aux billets de ce blog.
Le tableau suivant décrit les différents attributs associés à l’objet blog.
| Attribut | Description |
|---|---|
| posts | Retourne un objet blogposts contenant tous les billets de ce blog. |
| Nom | Nom du blog. |
| title | Titre du blog. |
| URL | URL du blog. |
Objet blogposts
L’objet blogposts vous permet d’accéder à un ensemble d’objets de billet de blog. Vous pouvez organiser les billets de blog, réaliser la pagination et utiliser des filtres Liquid :
{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}
Autres options possibles :
blogs.posts.all(pour obtenir tous les billets du blog)blogs.posts | from\_index: 0 | take: 2
Le tableau suivant décrit les différents attributs associés à l’objet blogposts.
| Attribut | Description |
|---|---|
| Tous | Retourne tous les objets blogpost dans la collection |
Objet blogpost
Fait référence à un billet de blog unique.
Le tableau suivant décrit les différents attributs associés à l’objet blogpost.
| Attribut | Description |
|---|---|
| URL | URL du billet. |
| contenu | Retourne le champ Contenu du billet. |
| auteur | Retourne les auteurs du billet (qui est simplement un objet de table de contact. |
| titre | Titre du billet. |
| comment_count | Retourne la valeur entière du nombre de commentaires associés à un billet donné. |
| publishdate_date | Date de publication du billet. |
entités
Attention
Pour éviter d’éventuels problèmes de script intersite (XSS), utilisez toujours le filtre d’échappement pour encoder les données de chaîne en HTML à l’utilisation d’un objet Liquid d’entités pour lire les données fournies par l’utilisateur qui ne sont pas fiables.
Notes
Certaines des conventions d’affectation de noms Dataverse ont changé, par exemple, les entités Dataverse sont maintenant appelées tables. Les changements de nom ne s’appliquent pas aux objets Liquid. L’objet d’entités Liquid continuera d’être appelé entités.
Permet de charger n’importe quelle table Power Apps par son ID. Si la table existe, un objet table est retourné. Si une table avec l’ID donné est introuvable, null est retourné.
{% assign account = entities.account['936DA01F-9ABD-4d9d-80C7-02AF85C822A8'] %}
{% if account %}
{{ account.name | escape }} ({{ account.statecode.label | escape }})
{% endif %}
{% assign entity_logical_name = 'contact' %}
{% assign contact = entities[entity_logical_name][request.params.contactid] %}
{% if contact %}
{{ contact.fullname | escape }} ({{ contact.parentcustomerid.name | escape }})
{% endif %}
Entity
Un objet entité permet d’accéder aux attributs d’un enregistrement de table Power Apps.
| Attribut | Description |
|---|---|
| ID | ID GUID de la table, sous la forme d’une chaîne. Par exemple, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | Nom logique de la table Power Apps. |
| Notes | Charge les notes (annotation) associées à la table, classées de la plus ancienne à la plus récente (createdon). Les notes sont retournées en tant qu’objets de note. |
| autorisations | Charge les résultats d’assertion d’autorisation de table pour la table. Les résultats sont retournés en tant qu’objet d’autorisations. |
| url | Retourne le chemin d’accès de l’URL du système de gestion de contenu des portails Power Apps pour la table. Si la table ne possède pas d’URL valide dans le site Web actuel, retourne null. En général, une valeur est retournée uniquement pour certains types de tables qui ont été intégrés dans le système CMS du portail, sauf si vous avez personnalisé le fournisseur d’URL dans votre application. |
| [nom d’attribut ou de relation] | Vous pouvez accéder à tous les attributs de la table Power Apps par leur nom logique. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Les valeurs de la plupart des attributs de table sont directement mappées aux types Liquid : les champs Deux options sont mappés à des valeurs booléennes, les champs de texte à des chaînes, les champs numériques ou monétaires à des nombres, les champs de date/heure à des objets de date. Mais, certains types d’attributs sont retournés comme objets :
{{ page.adx_webpage_entitylist.adx_name }}Dans le cas d’une relation réflexive (c’est-à-dire, auto-référentielle), un objet de relation réflexive est retourné. (Sinon, le résultat serait ambigu.){{ page.adx_webpage_webpage.referencing.adx_name }} Remarque : le chargement d’un grand nombre d’entités associées ou l’accès à un grand nombre de relations dans un seul modèle peut avoir un impact négatif sur les performances de rendu du modèle. Évitez de charger les entités associées pour chaque élément d’un tableau, dans une boucle. Si possible, utilisez les balises de table Dataverse pour charger des collections d’entités. |
Référence de table associée
Les valeurs d’attribut de recherche sont retournées comme objets de référence de table associés, avec les attributs suivants.
| Attribut | Description |
|---|---|
| ID | ID GUID de la table référencée, sous la forme d’une chaîne. Par exemple, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | Nom logique Power Apps de la table référencée. |
| Nom | Attribut de nom principal de la table référencée. |
Note
Une note est un objet table qui permet d’accéder aux attributs et relations d’un enregistrement annotation. En plus de tous les attributs d’un objet table, une note contient les attributs supplémentaires suivants.
| Attribut | Description |
|---|---|
| documentbody | Charge l’attribut documentbody de l’enregistrement annotation de la note, sous la forme d’une chaîne codée en Base64. Comme le contenu de cet attribut peut être volumineux, il n’est pas chargé avec le reste des attributs de note, mais uniquement sur demande. Remarque : l’attribut documentbody peut avoir un impact négatif sur les performances de rendu du modèle, et doit être utilisé avec précaution. Utilisez plutôt l’attribut url pour fournir un lien vers la pièce jointe à la note, si possible. |
| url | Retourne le chemin d’accès de l’URL pour le gestionnaire intégré de pièces jointes d’annotation du portail. Si l’utilisateur dispose de l’autorisation nécessaire et que la note contient un fichier joint, une demande de cette URL télécharge le fichier joint à la note. |
Notes
Valeurs de groupe d’options
Les valeurs d’attribut Groupe d’options/Liste de sélection sont retournées comme objets de référence de table associée, avec les attributs suivants.
| Attribut | Description |
|---|---|
| Étiquette | Étiquette localisée de la valeur d’attribut Groupe d’options/Liste de sélection. Par exemple, valeur |
| active | Nombre entier de la valeur d’attribut Groupe d’options/Liste de sélection. Par exemple, 0 |
Autorisations de table
L’objet Autorisations de table permet d’accéder aux résultats d’assertion d’autorisation agrégés pour une table.
| Attribut | Description |
|---|---|
| can_append | Retourne true si l’utilisateur actuel est autorisé à ajouter des enregistrements aux relations de cet enregistrement. Sinon, retourne false. |
| can_append_to | Retourne true si l’utilisateur actuel est autorisé à ajouter cet enregistrement à une relation d’une autre table. Sinon, retourne false. |
| can_create | Retourne true si l’utilisateur actuel est autorisé à créer des enregistrements de ce type de table. Sinon, retourne false. |
| can_delete | Retourne true si l’utilisateur actuel est autorisé à supprimer cet enregistrement. Sinon, retourne false. |
| can_read | Retourne true si l’utilisateur actuel est autorisé à lire cet enregistrement. Sinon, retourne false. |
| can_write | Retourne true si l’utilisateur actuel est autorisé à mettre à jour cet enregistrement. Sinon, retourne false. |
| rules_exist | Retourne true si les résultats de l’autorisation représentés par cet objet sont le résultat de règles d’autorisation définies explicitement. Retourne false s’il s’agit des résultats par défaut en l’absence d’autorisations définies explicitement. |
Relation réflexive
Les tentatives de chargement des relations réflexives (c’est-à-dire, auto-référentielles) sur les entités sont retournées comme objets avec les attributs suivants.
| Attribut | Description |
|---|---|
| is_reflexive | Retourne true. Peut être utilisé pour tester si un objet retourné par une relation est un objet de relation réflexive. |
| referenced | Retourne un tableau d’entités référencées pour la relation donnée. |
| referencing | Retourne une table de référencement pour la relation donnée. Retourne null si aucune table de référencement n’existe. Si la relation est de type plusieurs-à-plusieurs (N:N), retourne un tableau d’entités de référencement. |
entitylist
L’objet liste d’entités est utilisé dans les balises de table Power Apps Dataverse. Il permet d’accéder à tous les attributs d’une liste donnée.
Attributs
Notes
| Attribut | Description |
|---|---|
| create_enabled | Renvoie true si la création d’enregistrements est configurée pour la liste. Sinon, retourne false. |
| create_url | Renvoie le chemin URL configuré pour un lien/bouton de conception pour la liste. |
| detail_enabled | Renvoie true si une vue spécifique d’enregistrements distincts est configurée pour la liste. Sinon, retourne false. |
| detail_id_parameter | Renvoie le nom du paramètre de chaîne de requête à utiliser pour l’ID lors de la construction d’une URL d’affichage détaillé. Voir Filtres d’URL pour des informations sur l’utilisation de filtres Liquid pour la construction d’URL. Par exemple, id |
| detail_label | Renvoie l’étiquette localisée configurée pour des liens/boutons d’affichage détaillé pour la liste. |
| detail_url | Renvoie le chemin URL configuré pour des liens/boutons d’affichage détaillé pour la liste. |
| empty_list_text | Renvoie le texte traduit configuré à afficher lorsque la liste ne renvoie aucun résultat. |
| enable_entity_permissions | Renvoie true si le filtrage d’autorisation de table est activé pour cette liste. Sinon, retourne false. |
| entity_logical_name | Renvoie le nom logique de table Power Apps des enregistrements à afficher par cette liste. Par exemple, contact |
| filter_account_attribute_name | Renvoie le nom logique de l’attribut pour la recherche account qui sera utilisé pour filtrer les enregistrements de résultats par le compte parent actuel de l’utilisateur du portail. Par exemple, accountid |
| filter_apply_label | Renvoie l’étiquette localisée configurée à utiliser pour le lien/bouton qui concerne un filtre d’attribut avancé aux résultats de la liste. |
| filter_definition | Renvoie la définition de filtre d’attribut JSON pour la liste. Voir Filtres de liste pour des informations sur la manière d’utiliser le filtre Liquid metafilters pour traiter ce paramètre. |
| filter_enabled | Renvoie true si le filtrage avancé d’attribut est activé pour la liste. Sinon, retourne false. |
| filter_portal_user_attribute_name | Renvoie le nom logique de l’attribut pour la recherche contact qui sera utilisé pour filtrer les enregistrements de résultats par le contact actuel de l’utilisateur du portail. Par exemple, contactid |
| filter_website_attribute_name | Renvoie le nom logique de l’attribut pour la recherche adx_website qui sera utilisé pour filtrer les enregistrements de résultats par le site Web actuel du portail. Par exemple, adx_websiteid |
| language_code | Renvoie le code de langue de type entier dans Power Apps qui servira à sélectionner toutes les étiquettes localisées de cette liste. |
| page_size | Renvoie la taille de la page de résultats configurée pour la liste. |
| primary_key_name | Renvoie le nom logique de l’attribut de clé principal des enregistrements à afficher par cette liste. |
| search_enabled | Renvoie true si la recherche est activée pour cette liste. Sinon, retourne false. |
| search_placeholder | Renvoie le texte traduit configuré pour l’espace réservé des champs de recherche de la liste. |
| search_tooltip | Renvoie le texte traduit configuré pour l’info-bulle des champs de recherche de la liste. |
| vues | Renvoie les vues disponibles pour la liste sous forme d’objets d’affichage de la liste. |
| [nom logique de l’attribut] | Accédez à n’importe quel attribut de l’enregistrements Power Apps de la liste (adx_entitylist) par le nom logique, de la même manière qu’avec un objet table. Par exemple, {{ entitylist.adx_name }} |
Liste des attributs de vue
| Attribut | Description |
|---|---|
| colonnes | Renvoie des colonnes de la vue comme des objets de colonne de vue de la liste. |
| entity_logical_name | Renvoie le nom logique de table Power Apps pour les enregistrements inclus dans la vue. Par exemple, contact |
| ID | Renvoie l’ID GUID de la vue. |
| language_code | Renvoie le code de langue de type entier dans Power Apps qui servira à sélectionner toutes les étiquettes localisées (colonnes, en-têtes, etc.) pour la vue. |
| Nom | Renvoie le nom complet Power Apps de la vue. |
| primary_key_logical_name | Renvoie le nom logique de la clé principale de table Power Apps pour les enregistrements inclus dans la vue. Par exemple, contactid |
| sort_expression | Renvoie l’expression du tri par défaut pour la vue. Par exemple, name ASC, createdon DESC |
Attributs de colonne de vue de la liste
| Attribut | Description |
|---|---|
| attribute_type | Renvoie le nom du type d’attribut Power Apps pour la colonne, sous forme de chaîne. Par exemple, Lookup, Picklist, String, Boolean, DateTime |
| logical_name | Renvoie le nom logique de l’attribut Power Apps pour la colonne. Par exemple, createdon |
| Nom | Renvoie le nom complet de l’attribut Power Apps localisé pour la colonne. Par exemple, Created On |
| sort_ascending | Renvoie une chaîne de tri d’expression pour trier la colonne dans l’ordre croissant. Par exemple, createdon ASC |
| sort_descending | Renvoie une chaîne de tri d’expression pour trier la colonne dans l’ordre décroissant. Par exemple, createdon DESC |
| sort_disabled | Renvoie true si le tri est désactivé pour la colonne. Sinon, retourne false. |
| sort_enabled | Renvoie true si le tri est activé pour la colonne. Sinon, retourne false. |
| largeur | Renvoie la largeur configurée pour la colonne, en pixels. |
affichage des entités
L’objet entityview est utilisé dans la balise entityview (vue d’entité), et donne accès aux métadonnées de la vue, ainsi qu’aux enregistrements de résultat de la vue.
Attributs
| Attribut | Description |
|---|---|
| colonnes | Renvoie des colonnes de la vue comme des objets de colonne de vue table. |
| entity_permission_denied | Renvoie true si l’accès aux résultats de la vue est refusé en raison d’autorisations suffisantes table pour l’utilisateur actuel. Renvoie false si l’accès en lecture aux résultats de la vue est accordé. |
| entity_logical_name | Nom logique de table Power Apps des enregistrements de résultat de la vue. Par exemple, contact |
| first_page | Le numéro de la page de la première page des résultats de la vue. Ce numéro est 1 à moins qu’aucun résultat ne soit renvoyé auquel cas il est null. |
| ID | ID GUID de la vue Power Apps qui définit cet objet entityview. |
| language_code | Code de langue (nombre entier) dans Power Apps qui est utilisé pour charger les étiquettes traduites de la vue active. |
| last_page | Le numéro de la page de la dernière page des résultats de la vue. Si aucun résultat n’est renvoyé, ce numéro est null. |
| nom | Nom de la vue Power Apps qui définit cet objet entityview, par exemple, Contacts actifs. |
| next_page | Le numéro de la page de la page suivante des résultats de la vue. Si aucune page de résultats n’est renvoyée, ce numéro est null. |
| Page | Le numéro de la page de la page en cours des résultats de la vue. |
| pages | Renvoie un tableau de numéros de page contenant toutes les pages de résultats pour la vue active. |
| page_size | Nombre de résultats renvoyés par page pour la vue actuelle. |
| previous_page | Le numéro de la page de la page suivante des résultats de la vue. S’il n’y a pas de page précédente, ce numéro est null. |
| primary_key_logical_name | Nom logique Power Apps de l’attribut de clé principale de table de résultat pour cette vue. Par exemple, contactid. |
| enregistrements | Page actuelle des enregistrements de résultat pour la vue, en tant qu’objets table. |
| sort_expression | L’expression du tri par défaut pour la vue. Par exemple, nameASC, createdon DESC. |
| total_pages | Le nombre total de pages de résultats pour la vue. |
| total_records | Le nombre total de résultats pour la vue (dans toutes les pages). |
événements
Permet d’accéder aux événements et de les afficher. L’objet events vous permet de sélectionner un événement spécifique ou tous les événements.
Objet events
L’objet events vous permet d’accéder à un événement spécifique du portail ou d’accéder à tous les événements du portail (quel que soit l’événement).
L’objet events contient les attributs suivants :
| Attribut | Description |
|---|---|
| occurences | Retourne un objet eventoccurancess contenant toutes les occurrences d’événement dans le portail. |
| [nom ou ID de l’événement] | Vous pouvez accéder à n’importe quel événement par ses propriétés de nom ou d’ID. {% assign event = events["Event Name"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Objet event
L’objet event vous permet d’utiliser un seul événement et d’accéder aux planifications et occurrences de cet événement.
L’objet event contient les attributs suivants :
| Attribut | Description |
|---|---|
| occurrences | Retourne un objet eventoccurrences contenant toutes les occurrences de l’événement. |
| nom | Nom de l’événement. |
| URL | URL de l’événement. |
Objet eventoccurences
L’objet eventoccurrences vous permet d’accéder à un ensemble d’objets d’occurrences d’événement. Vous pouvez organiser les occurrences d’événement, spécifier une plage de dates pour les occurrences à récupérer, réaliser la pagination et utiliser des filtres Liquid
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
notez que
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
est également possible.
Les attributs suivants sont associés à l’objet eventoccurrences
| Attribut | Description |
|---|---|
| Tous | Retourne tous les objets eventoccurance dans la collection. |
Objet eventoccurence
Représente une occurrence d’événement unique. Les attributs associés sont indiqués ci-dessous :
| Attribut | Description |
|---|---|
| URL | URL de l’occurrence. |
| is_all_day_event | L’événement se déroule-t-il sur une journée entière ? |
| start_time | Heure de début de l’événement. |
| end_time | Heure de fin de l’événement. |
forloop
Contient des propriétés utiles dans un bloc de boucle for.
Notes
forloop peut être utilisé uniquement dans une balise for.
Code
{% for child in page.children %}
{% if forloop.first %}
This is the first child page!
{% else %}
This is child page number {{ forloop.index }}.
{% endif %}
{% endfor %}
Sortie
This is the first child page!
This is child page number 2.
This is child page number 3.
Attributs
| Attribut | Description |
|---|---|
| Premier | Retourne true s’il s’agit de la première itération de la boucle. Retourne false s’il ne s’agit pas de la première itération. |
| index | Position de l’élément actuel dans la collection, où le premier élément a la position 1. |
| index0 | Position de l’élément actuel dans la collection, où le premier élément a la position 0. |
| Dernier | Retourne true s’il s’agit de la dernière itération de la boucle. Retourne false s’il ne s’agit pas de la dernière itération. |
| length | Retourne le nombre d’itérations pour la boucle ߝ nombre d’éléments dans la collection itérée. |
| rindex | Nombre d’éléments restants dans la boucle (longueur – index), où 1 est l’index du dernier élément. |
| rindex0 | Nombre d’éléments restants dans la boucle (longueur – index), où 0 est l’index du dernier élément. |
forums
Permet d’accéder et d’afficher des forums et les fils de discussion des forums. La capacité à utiliser le liquide pour l’affichage des données du forum s’étend aux messages, mais pour créer un nouveau message sur le fil, il faut utiliser un modèle de page des formulaires à plusieurs étapes ASP.NET avec ladite fonctionnalité intégrée (tel que le fil de discussion par défaut du forum et les modèles de pages de messages du forum).
L’objet forums vous permet de sélectionner un forum ou des fils de discussion :
<div class=content-panel panel panel-default>
<div class=panel-heading>
<h4>
<span class=fa fa-comments aria-hidden=true></span>
{{ snippets[Home Forum Activity Heading] | default: Forum Activity | h }}
</h4>
</div>
{% for forum in website.forums %}
<ul class=list-group>
<li class=list-group-item>
<div class=row>
<div class=col-sm-6>
<h4 class=list-group-item-heading><a href="{{ forum.url | h }}"> {{ forum.name | h }}</a></h4>
<div class=list-group-item-text content-metadata>{{ forum.adx_description | h }}</div>
</div>
<div class=col-sm-3 content-metadata>{{ forum.thread_count }} threads</div>
<div class=col-sm-3 content-metadata>{{ forum.post_count }} posts</div>
</div>
</li>
</ul>
{% endfor %}
</div>
Objet forums
L’objet forums vous permet d’accéder à tous les forums du portail ou d’accéder à tous les fils de discussion du portail (quel que soit le forum).
L’objet forum vous permet de travailler sur un seul forum et d’accéder aux fils de discussion de ce forum.
L’objet fils de discussion du forum vous permet d’accéder à une collection d’objets de fils de discussion de forum. Vous pouvez organiser les fils de discussion du forum, réaliser la pagination et utiliser des filtres Liquid.
{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}
Fil de discussion unique
L’objet publications sur forum vous permet d’accéder à un ensemble d’objets de messages de forum.
Attributs
| Attribut | Description |
|---|---|
| threads | Retourne un objet forumthreads contenant tous les objets forumthread du portail. |
| Tous | Retourne tous les objets forum dans le portail. Notez que website.forums est également un équivalent. |
| thread_count | Retourne la valeur entière du compte de nombre de fils de discussion présents dans tout le site Internet. |
| post_count | Retourne la valeur entière du nombre total de publications dans le portail. |
| [nom ou ID du forum] | Vous pouvez accéder à n’importe quel forum par ses propriétés de nom ou d’ID. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %} |
Objet forum
Attributs
Notes
| Attribute | Description |
|---|---|
| threads | Retourne un objet forumthreads contenant tous les fils de discussion pour le forum. |
| Nom | Le nom du forum. |
| thread_count | Retourne la valeur entière du nombre de fils de discussion présents dans le forum. |
| post_count | Retourne la valeur entière du nombre de messages présents dans le forum entier. |
Objet forumthreads
Attributs
| Attribut | Description |
|---|---|
| Tous | Retourne tous les objets forumthread dans la collection. |
Objet forumthread
Attributs
Notes
| Attribut | Description |
|---|---|
| posts | Retourne un objet forumposts contenant toutes les publications du forum pour le fil de discussion. |
| author | Retourne l’auteur du fil de discussion (qui est simplement un objet table de contact). |
| latest_post | Retourne le dernier message du fil de discussion. |
| first_post | Retourne le premier message du fil de discussion. |
| post_count | Retourne la valeur entière du nombre de messages présents dans le fil de discussion. |
| is_answered | Le fil est-il résolu ou non ? |
| is_sticky | Le fil de discussion est-il de type Sticky ? |
Objet forumposts
Attributs
| Attribut | Description |
|---|---|
| Tous | Retourne tous les objets forumthread dans la collection. |
Un message unique du forum
Attributs
Notes
| Attribut | Description |
|---|---|
| author | Retourne l’auteur du billet (qui est simplement un objet de table de contact). |
| content | Le contenu du message. |
| is_answer | Ce message est-il une réponse au fil ? |
knowledge
Permet d’accéder aux enregistrements de la table knowledgearticle et category de Power Apps pour afficher les articles et les catégories dans un portail.
Attributs
| Attribut | Description |
|---|---|
| articles | Renvoie un objet articles contenant des objets article pour les enregistrements de table knowledgearticle disponibles dans le portail. |
| catégories | Renvoie un objet catégories contenant des objets catégorie pour les enregistrements de table catégorie disponibles dans le portail. |
objet articles
L’objet articles vous permet d’accéder à un ensemble d’objets article. Vous pouvez organiser les articles, réaliser la pagination et utiliser des filtres Liquid.
{% assign count = count | default: 3 %}
{% assign languagecode = website.selected_language.code %}
{% assign popular_articles = knowledge.articles | popular: count,languagecode %}
{% if popular_articles %}
<div class=list-group>
{% for article in popular_articles %}
<div class=list-group-item clearfix>
<a class=title href={{ article.url | escape }}>{{ article.title | escape }}</a>
<p class=description>{{ article.description | escape }}</p>
</div>
{% endfor %}
</div>
{% endif %}
Attributs
| Attribut | Description |
|---|---|
| popular | Renvoie un ensemble d’objets article contenant la plupart des vues. {% assign popular_articles = knowledge.articles.popular %} |
| recent | Renvoie un ensemble d’objets article contenant la date de dernière modification. {% assign recent_articles = knowledge.articles.recent %} |
| haut | Renvoie un ensemble d’objets article contenant l’évaluation la plus élevée. {% assign top_articles = knowledge.articles.top %} |
Filtres
Les filtres suivants peuvent accepter des paramètres facultatifs pour la taille et la langue de la page. Le premier paramètre est le nombre d’enregistrements à récupérer. La taille par défaut de la page est 5. Le deuxième paramètre est le code de langue pour récupérer des articles pour une langue donnée. Les filtres peuvent être combinés avec d’autres filtres Liquid.
{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
| Attribut | Description |
|---|---|
| popular | Renvoie un ensemble d’objets article contenant la plupart des vues. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %} |
| recent | Renvoie un ensemble d’objets article contenant la date de dernière modification. {% assign recent_articles = knowledge.articles \| recent: 5 %} |
| haut | Renvoie un ensemble d’objets article contenant l’évaluation la plus élevée. {% assign top_articles = knowledge.articles \| top: 3, en-US %} |
objet catégories
L’objet catégories vous permet d’accéder à un ensemble d’objets catégorie. Vous pouvez organiser les catégories, réaliser la pagination et utiliser des filtres Liquid.
{% assign category_url = sitemarkers['Category'].url %}
{% assign count = count | default: 0 %}
{% assign categories = knowledge.categories | top_level: count %}
{% if categories %}
<div class=list-group unstyled>
{% for category in categories %}
<a href={{ category_url | add_query: 'id', category.categorynumber }} class=list-group-item>
{{ category.title }}
</a>
{% endfor %}
</div>
{% endif %}
Attributs
| Attribut | Description |
|---|---|
| recent | Renvoie un ensemble d’objets catégorie contenant la date de dernière modification. |
| top_level | Renvoie un ensemble d’objets catégorie qui n’ont pas de catégorie parent. |
Filtres
Les filtres suivants peuvent accepter un paramètre facultatif indiquant la taille de la page. La taille par défaut de la page est 5. Les filtres peuvent être combinés avec d’autres filtres Liquid.
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
| Attribut | Description |
|---|---|
| recent | Renvoie un ensemble d’objets catégorie contenant la date de dernière modification. Vous pouvez fournir les paramètres {% assign recent_categories = knowledge.categories \| recent: 10 %} |
| top_level | Renvoie un ensemble d’objets catégorie qui n’ont pas de catégorie parent. {% assign root_categories = knowledge.categories \| top_level %} |
objet article
L’objet article vous permet d’utiliser une entité knowledgearticle unique pour afficher les détails de cet article dans le portail.
Attributs
article est un objet entité, avec tous les mêmes attributs en plus de ceux répertoriés ci-dessous.
| Attribut | Description |
|---|---|
| article_public_number | Numéro public de l’article. |
| comment_count | Valeur entière du nombre de commentaires associés à un article donné. |
| content | Contenu de l’article. |
| current_user_can_comment | Renvoie une valeur booléenne indiquant si l’utilisateur actuel peut ajouter des commentaires sur l’article. |
| is_rating_enabled | Renvoie une valeur booléenne indiquant si l’évaluation d’un article est activée. |
| keywords | Mots clés de l’article. |
| nom | Autre alias pour le titre de l’article. |
| rating | Valeur d’évaluation décimale de l’article. |
| title | Titre de l’article. |
| view_count | Valeur entière du nombre de visualisations de l’article. |
objet catégorie
L’objet catégorie vous permet d’utiliser une catégorie unique pour afficher ses détails dans le portail.
Attributs
category est un objet entité, avec tous les mêmes attributs en plus de ceux répertoriés ci-dessous.
| Attribut | Description |
|---|---|
| categorynumber | Numéro de la catégorie. |
| nom | Autre alias pour le titre de la catégorie. |
| titre | Titre de la catégorie. |
langue
Fournit le nom de la langue actuelle et le code de la langue si la prise en charge multilingue est autorisée.
Attributs
| Attribut | Description |
|---|---|
| url | L’URL de la demande actuelle précédée du code de langue actuel. |
| url_substitution | L’URL de la demande actuelle précédée du code de langue actuel contournant le cache de sortie de page. |
| nom | Titre de la langue actuelle. |
| code | Code de langue de la langue. |
Par exemple, le modèle Web Liste déroulante des langues utilise par défaut cet objet liquide pour répertorier les langues disponibles lorsque plusieurs langues sont disponibles.
page
Se rapporte à la page de requête du portail actuel. Cet objet combine les attributs du plan de site et de la requête actuelle entités (généralement une page Web).
L’objet page donne accès à des éléments tels que les vues miniatures, le titre ou l’URL de la page actuelle, ainsi qu’à tous les autres attributs ou entités associés de l’enregistrement Power Apps sous-jacent.
<ul class=breadcrumb>
{% for crumb in page.breadcrumbs %}
<li><a href={{ crumb.url | escape }}>{{ crumb.title | escape }}</a></li>
{% endfor %}
<li class=active>{{ page.title | escape }}</li>
</ul>
<div class=page-header>
<h1>{{ page.title | escape }}</h1>
</div>
<div class=page-copy>
{{ page.adx_copy }}
</div>
<div class=list-group>
{% for child in page.children %}
<a class=list-group-item href={{ child.url | escape }}>
{{ child.title | escape }}
</a>
{% endfor %}
</div>
<!-- Page {{ page.id }} was last modified on {{ page.modifiedon }}. -->
Attributs de page
Notes
| Attribut | Description |
|---|---|
| breadcrumbs | Retourne les objets nœud de plan de site miniature pour la page, en commençant par le nœud racine du plan de site et en terminant par le parent. |
| children | Retourne les objets nœud de plan de site enfant de la page. |
| mère | Retourne le nœud de plan de site parent de la page. Si la page est la page accueil, le parent est null. |
| title | Titre de la page. |
| URL | L’URL de la page. |
| [nom d’attribut ou de relation] | Vous pouvez accéder à tous les attributs de l’enregistrement Power Apps sous-jacent par son nom logique.{{ page.createdon }}{% assign attribute_name = 'name' %}{{ page[attribute_name] }}Les valeurs de la plupart des attributs de table sont directement mappées aux types Liquid : les champs Deux options sont mappés à des valeurs booléennes, les champs de texte à des chaînes, les champs numériques ou monétaires à des nombres, les champs de date/heure à des objets de date. Mais, certains types d’attributs sont retournés comme objets :
{{ page.adx_webpage_entitylist.adx_name }}Dans le cas d’une relation réflexive (c’est-à-dire, auto-référentielle), un objet entities sera retourné. (Sinon, le résultat serait ambigu.) {{ page.adx_webpage_webpage.referencing.adx_name }} Remarque : le chargement d’un grand nombre d’entités associées ou l’accès à un grand nombre de relations dans un seul modèle peut avoir un impact négatif sur les performances de rendu du modèle. Évitez de charger les entités associées pour chaque élément d’un tableau, dans une boucle. Si possible, utilisez les balises de table Power Apps Dataverse pour charger des collections d’entités. |
polls
Offre la possibilité d’accéder à une interrogation et de l’afficher.
L’objet polls vous permet de sélectionner une interrogation ou un placement d’interrogation spécifique.
<div>
{% assign poll = polls[Poll Name] %}
<h4>{{ poll.question }}</h4>
{% for option in poll.options %}
<div>
<input type=radio name={{ poll.name }} id={{ option.id }} />
<label for={{ option.id }}>{{ option.answer }}</label>
</div>
{% endfor %}
<button type=button>{{ poll.submit_button_label }}</button>
</div>
Attributs d’interrogation
| Attribut | Description |
|---|---|
| placements | Renvoie l’objet placements d’interrogation. |
| [nom ou ID du sondage] | Vous pouvez accéder à n’importe quelle interrogation par ses propriétés de nom ou d’ID. {% assign poll = polls[Poll Name] %}{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %} |
Attributs de placements d’interrogation
| Attribut | Description |
|---|---|
| [nom ou ID de l’emplacement de sondage] | Vous pouvez accéder à n’importe quel emplacement de sondage par ses propriétés de nom ou d’ID.{% assign placement = polls.placements[Placement Name or Id] %}{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %} |
Attributs de placement d’interrogation
Notes
| Attribut | Description |
|---|---|
| Nom | Renvoie le champ Nom pour le placement d’interrogation. |
| placement_url | L’URL qui peut servir à récupérer le placement d’interrogation totalement affiché par un modèle. |
| interrogations | Renvoie la collection d’objets d’interrogation associés à l’emplacement. Les balises d’itération et les filtres de tableau peuvent être utilisés avec cette collection. |
| random_url | L’URL qui peut servir à récupérer une interrogation aléatoire totalement à partir de l’emplacement affiché par un modèle. |
| submit_url | L’URL vers laquelle une interrogation terminée est envoyée. |
Attributs d’interrogation
Notes
| Attribut | Description |
|---|---|
| has_user_voted | Renvoie True si l’utilisateur actuel (connecté ou anonyme) a déjà voté dans cette interrogation. |
| Nom | Renvoie le champ Nom pour l’interrogation. |
| options | Renvoie la collection d’objets d’options de sondage associés au sondage. Les balises d’itération et les entités peuvent être utilisées avec cette collection. |
| poll_url | L’URL qui peut servir à récupérer l’interrogation totalement affichée par un modèle. |
| question | Renvoie le champ Question pour l’interrogation. |
| submit_button_label | Renvoie une chaîne qui peut servir à remplacer l’étiquette du bouton Envoyer pour l’interrogation. |
| submit_url | L’URL vers laquelle une interrogation terminée est envoyée. |
| user_selected_option | Renvoie l’objet d’option d’interrogation sélectionné par l’utilisateur (s’il a déjà voté). |
| votes | Renvoie le nombre de votes ayant été tabulés pour l’interrogation. |
Attributs des options d’interrogation
Notes
| Attribut | Description |
|---|---|
| answer | Renvoie le champ Réponse pour l’interrogation. |
| pourcentage | Renvoie le pourcentage de votes dans l’interrogation pour l’option, sous forme de nombre décimal entre 0 et 100. |
| votes | Renvoie le nombre de votes ayant été tabulés pour l’option. |
demande
Contient des informations sur la requête HTTP actuelle.
{% assign id = request.params['id'] | escape %}
<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>
Notes
- Vous pouvez générer dynamiquement des URL dans Liquid à l’aide de filtres d’URL.
- 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.
- La version de publication des portails Power Apps 9.3.8.x ou ultérieure a, par défaut, un filtre Liquid d’échappement appliqué pour l’utilisateur et des objets Liquid de demande. Pour désactiver cette configuration par défaut et autoriser ces objets Liquid sans filtre Liquid d’échappement, voir Paramètres du site du portail - Site/EnableDefaultHtmlEncoding.
Attributs
| Attribut | Description |
|---|---|
| paramètres | Valeurs de paramètre nommées pour la demande actuelle. params est une combinaison de paramètres de chaîne de requête d’URL, de paramètres de publication de formulaire et de cookies. |
| Chemin d’accès | Chemin d’accès de l’URL de la demande actuelle. /profile/ |
| path_and_query | Chemin d’accès et requête de l’URL de la demande actuelle. /profile/?foo=1&bar=something |
| query | Partie de la requête de l’URL de la demande actuelle. ?foo=1&bar=something |
| URL | URL complète de la demande actuelle. https://www.example.com/profile/?foo=1&bar=something |
searchindex
L’objet searchindex est utilisé dans les balises de table Power Apps Dataverse Common Data Service, et donne accès aux résultats d’une requête.
{% searchindex query: 'support', page: params.page, page_size: 10 %}
{% if searchindex.results.size > 0 %}
<p>Found about {{ searchindex.approximate_total_hits }} matches:</p>
<ul>
{% for result in searchindex.results %}
<li>
<h3><a href={{ result.url | escape }}>{{ result.title | escape }}</a></h3>
<p>{{ result.fragment }}</p>
</li>
{% endfor %}
</ul>
{% else %}
<p>Your query returned no results.</p>
{% endif %}
{% endsearchindex %}
Attributs
| Attribut | Description |
|---|---|
| approximate_total_hits | Renvoie un nombre approximatif de correspondances totales correspondant à la requête d’index. En raison de la manière dont l’index de recherche fonctionne par rapport au filtrage de sécurité et à d’autres facteurs de conception, ce nombre est uniquement approximatif et peut dans certains cas ne pas correspondre exactement au nombre total de résultats disponibles à l’utilisateur actuel. |
| Page | Renvoie le numéro de page de la requête actuelle. |
| page_size | Renvoie la taille maximale de page de la requête actuelle. Si vous souhaitez obtenir le nombre réel de résultats renvoyés pour la page actuelle (car il peut être inférieur à la taille de page maximale spécifiée), utilisez results.size. |
| Résultats | Renvoie la page de résultats de la requête, en tant qu’objets de résultat d’index de recherche. |
Résultats d’index de recherche
| Attribut | Description |
|---|---|
| Entité | Entités sous-jacentes pour le résultat. |
| fragment | Un court fragment de texte approprié pour le résultat, avec des termes correspondant à la requête spécifiée mise en surbrillance à l’aide de la balise HTML <em>. Certains types de requêtes ne prennent pas en charge les fragments en surbrillance, comme les requêtes floues (~) et les requêtes avec caractère générique (*). Dans ces cas, cette propriété est null. |
| ID | ID table Power Apps de l’enregistrement sous-jacent pour le résultat, sous forme de chaîne. Par exemple, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | Nom logique de table Power Apps de l’enregistrement sous-jacent pour le résultat. Par exemple, adx_webpage |
| Numéro | Le numéro du résultat, compté dans toutes les pages de résultats, à partir de 1. Par exemple, pour le premier résultat de la deuxième page de résultats, avec une taille de page de 10, cette valeur est 11. |
| score | Le score Lucene du résultat, sous forme de valeur à virgule flottante. Les résultats seront retournés dans l’ordre indiqué par cette valeur. |
| title | Le titre du résultat. |
| URL | L’URL du résultat. C’est généralement—mais pas nécessairement—un chemin d’accès absolu pour l’application actuelle, plutôt qu’une URL complète. Par exemple : /articles/article1/ |
paramètres
Permet de charger n’importe quel paramètre de site par nom. Si un paramètre n’est pas trouvé par son nom, null sera retourné.
Notes
Les paramètres sont renvoyés comme chaînes, mais vous pouvez utiliser les filtres de type pour les convertir en d’autres types.
{{ settings[My Setting] }}
{% assign search_enabled = settings[Search/Enabled] | boolean %}
{% if search_enabled %}
Search is enabled.
{% endif %}
{% assign pagesize = settings['page size'] | integer | default: 10 %}
{% if pagesize > 10 %}
Page size is greater than 10.
{% endif %}
sitemap
Autoriser l’accès au plan de site du portail.
<h1>{{ sitemap.root.title }}</h1>
<ul class=breadcrumb>
{% for crumb in sitemap.current.breadcrumbs %}
<li><a href={{ crumb.title }}>{{ crumb.title }}</a></li>
{% endfor %}
<li class=active>{{ sitemap.current.title }}</li>
</ul>
{% for child in sitemap.current.children %}
<a href={{ child.url }}>{{ child.title }}</a>
{% endfor %}
It's also possible to load a site map node by URL path:
{% assign node = sitemap[/content/page1/] %}
{% if node %}
{% for child in node.children %}
<a href={{ child.url }}>{{ child.title }}</a>
{% endfor %}
{% endif %}
Attributs d’un plan de site
| Attribut | Description |
|---|---|
| Actuel | Retourne l’objet nœud du plan de site pour la page actuelle. |
| Racine | Retourne l’objet nœud du plan de site pour la page racine (accueil) du site Web. |
Attributs d’un nœud du plan de site
| Attribut | Description |
|---|---|
| Vues miniatures | Retourne les objets nœud de plan de site miniature pour le nœud, en commençant par le nœud racine du plan de site et en terminant par le parent. |
| Enfants | Retourne les objets nœud de plan de site enfant du nœud. |
| Description | Contenu de la description ou du résumé du nœud. (Ce champ peut contenir du contenu HTML.) |
| Entité | Retourne les entités sous-jacentes du nœud. Si le nœud ne contient pas table sous-jacente, cette valeur est null. |
| is_sitemap_ancestor | Retourne true si le nœud du plan de site est un ancêtre du nœud actuel ; sinon, false. |
| is_sitemap_current | Retourne true si le nœud du plan de site est le nœud actuel ; sinon, false. |
| Parent | Retourne le nœud de plan de site parent du nœud. Si le nœud est le nœud racine, le parent a la valeur null. |
| Fonction | Titre du nœud. |
| URL | URL du nœud. |
marqueurs de site
Permet de charger n’importe quel marqueur de site par nom. Si le marqueur de site existe, un objet marqueur de site sera retourné. Si un marqueur de site n’est pas trouvé par son nom, null sera retourné.
{{ sitemarkers[Login].url }}
{% assign my_sitemarker = sitemarkers["My Site Marker"] %}
{% if my_sitemarker %}
<a href={{ my_sitemarker.url }}>{{ my_sitemarker.adx_name }}</a>
{% else %}
Site marker My Site Marker does not exist.
{% endif %}
Attributs d’un marqueur de site
| Attribut | Description |
|---|---|
| URL | L’URL de la cible du marqueur de site. |
| [nom logique de l’attribut] | Accédez à tous les attributs de l’enregistrement Power Apps de la cible du marqueur de site par nom logique. Par exemple, {{ sitemarker.adx_name }} |
snippets
Permet de charger n’importe quel extrait de code de contenu (snippet) par nom. Si un extrait de code avec le nom donné est introuvable, null sera retourné.
{{ snippets[Header] }}
{% assign footer = snippets[Footer] %}
{% if footer %}
{{ footer }}
{% else %}
No footer snippet was found.
{% endif %}
tablerowloop
Contient des propriétés utiles dans un bloc de boucle Balises d’itération.
Notes
tablerowloop peut être uniquement utilisé dans une balise Balises d’itération.
Attributs
| Attribut | Description |
|---|---|
| Col | Renvoie l’index de la ligne actuelle, en commençant à 1. |
| col0 | Renvoie l’index de la ligne actuelle, en commençant à 0. |
| col_first | Renvoie true si la colonne actuelle est la première colonne d’une ligne, renvoie false si ce n’est pas le cas. |
| col_last | Renvoie true si la colonne actuelle est la dernière colonne d’une ligne, renvoie false si ce n’est pas le cas. |
| Premier | Retourne true s’il s’agit de la première itération de la boucle. Retourne false s’il ne s’agit pas de la première itération. |
| Index | Position de l’élément actuel dans la collection, où le premier élément a la position 1. |
| index0 | Position de l’élément actuel dans la collection, où le premier élément a la position 0. |
| Dernier | Retourne true s’il s’agit de la dernière itération de la boucle. Retourne false s’il ne s’agit pas de la dernière itération. |
| Durée | Retourne le nombre d’itérations pour la boucle ߝ nombre d’éléments dans la collection itérée. |
| Rindex | Nombre d’éléments restants dans la boucle (longueur – index), où 1 est l’index du dernier élément. |
| rindex0 | Nombre d’éléments restants dans la boucle (longueur – index), où 0 est l’index du dernier élément. |
utilisateur
Se rapporte à l’utilisateur actuel du portail, donnant ainsi accès à tous les attributs de l’enregistrement de contact Power Apps sous-jacent. Si aucun utilisateur n’est connecté, cette variable est null.
user est un objet entité.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
Notes
La version de publication des portails Power Apps 9.3.8.x ou ultérieure a, par défaut, un filtre Liquid d’échappement appliqué pour l’utilisateur et des objets Liquid de demande. Pour désactiver cette configuration par défaut et autoriser ces objets Liquid sans filtre Liquid d’échappement, voir Paramètres du site du portail - Site/EnableDefaultHtmlEncoding.
Attributs
En plus d’avoir tous les attributs d’un objet entities, user possède les attributs suivants.
| Attribut | Description |
|---|---|
| roles | Renvoie les rôles auxquels l’utilisateur appartient, comme tableau.{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}Remarque : Vous pouvez également utiliser le filtre has_role pour déterminer les différentes appartenances de rôle. |
| basic_badges_url | Renvoie l’URL de service pour récupérer les badges d’un utilisateur. Pour afficher les badges d’un utilisateur vous devez inclure une balise avec les attributs « data-badge » et « data-uri ». Pour afficher les badges de l’utilisateur actuel : <div data-badge data-uri='{{user.basic_badges_url }}'></div>Pour afficher les badges d’un utilisateur par ID (id utilisateur variable) : `<div data-badge data-uri=’{{user.basic_badges_url |
weblinks
Vous permet de charger n’importe quel lien Web par son nom ou son ID.
Si le jeu de liens Web existe, un objet jeu de liens Web est retourné. Si un jeu de liens Web avec le nom ou l’ID donné est introuvable, null est retourné.
<!-- Load web link set by ID -->
{{ weblinks[page.adx_navigation.id].name }}
<!-- Load web link set by name -->
{% assign nav = weblinks[Primary Navigation] %}
{% if nav %}
<h1>{{ nav.title | escape }}</h1>
<ul>
{% for link in nav.weblinks %}
<li>
<a href={{ link.url | escape }} title={{ link.tooltip | escape }}>
{% if link.image %}
<img src={{ link.image.url | escape }} alt={{ link.image.alternate_text | escape }} />
{% endif %}
{{ link.name | escape }}
</a>
</li>
{% endfor %}
</ul>
{% endif %}
Attributs d’un jeu de liens Web
Notes
Un jeu de liens Web est un objet entity, avec tous les mêmes attributs en plus de ceux répertoriés ci-dessous.
| Attribut | Description |
|---|---|
| Copier | Copie HTML du jeu de liens Web. |
| Nom | Nom du jeu de liens Web. |
| Fonction | Titre du jeu de liens Web. |
| Liens Web | Tableau d’objets de lien Web associés au jeu de liens Web. |
| [nom logique de l’attribut] | Vous pouvez accéder à tous les attributs de l’enregistrement Power Apps du jeu de liens Web par leur nom logique. Par exemple,{{ weblinkset.createdon }} |
Attributs d’un lien Web
Notes
Un lien Web est un objet entity, avec tous les mêmes attributs en plus de ceux répertoriés ci-dessous.
| Attribut | Description |
|---|---|
| Description | Description HTML du lien Web. |
| display_image_only | Attribut booléen indiquant si le lien Web doit être affiché comme image uniquement, sans texte de lien. |
| display_page_child_links | Attribut booléen indiquant si le lien Web doit afficher des liens vers les pages enfants de la page liée du plan de site, en tant que sous-liens. |
| Image | Objet image de lien Web pour ce lien. Cet attribut a la valeur null si aucune image n’est disponible. |
| is_external | Attribut booléen indiquant si l’URL cible du lien Web pointe vers un site externe (et non vers une page interne du portail). |
| is_sitemap_ancestor | Retourne true si l’URL du lien Web référence un ancêtre du nœud actuel du plan de site ; sinon false. |
| is_sitemap_current | Retourne true si l’URL du lien Web référence un nœud actuel du plan de site ; sinon false. |
| Nom | Nom/titre du lien Web. |
| Nofollow | Attribut booléen indiquant si le lien Web doit être marqué comme rel="nofollow". |
| open_in_new_window | Attribut booléen indiquant si le lien Web doit être ouvert dans une nouvelle fenêtre ou un nouvel onglet du navigateur lorsque l’utilisateur le sélectionne. |
| Info-bulle | Texte d’info-bulle du lien Web. |
| URL | URL du lien Web. |
| Liens Web | Tableau d’objets de lien Web enfant associés au lien Web. |
| [nom logique de l’attribut] | Vous pouvez accéder à tous les attributs de l’enregistrement Power Apps du lien Web par leur nom logique. Par exemple,{{ weblink.createdon }} |
Attributs d’une image de lien Web
| alternate_text | Autre texte pour l’image. |
|---|---|
| Hauteur | Entier contenant la hauteur spécifiée de l’image. Si aucune valeur de hauteur n’est fournie, cet attribut a la valeur null. |
| URL | URL de l’image. |
| Largeur | Entier contenant la largeur spécifiée de l’image. Si aucune valeur de largeur n’est fournie, cet attribut a la valeur null. |
website
Se rapporte à l’enregistrement de site Web, donnant ainsi accès à tous les attributs de l’enregistrement du site Web Power Apps (adx_website) pour le portail.
Notes
Le site Web est un objet entity, avec tous les mêmes attributs.
Code
{{ website.adx_name }} ({{ website.id }})
Sortie
Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)
Attributs
Le tableau suivant répertorie les attributs de cette balise qui peuvent être utilisés en remplaçant les valeurs par défaut pour éviter la mise en cache.
| Default | Substitut (évite la mise en cache) | Exemple |
|---|---|---|
| sign_in_url | sign_in_url_substitution | Default: website.sign_in_url : /en-US/SignIn?returnUrl=%2Fen-US%2F Substitution (évite la mise en cache) : website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("substitute-page" dans cet exemple remplace l’URL mise en cache par défaut.) |
| sign_out_url | sign_out_url_substitution | Default : website.sign_out_url : /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F Substitution (évite la mise en cache) : website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("substitute-page" dans cet exemple remplace l’URL mise en cache par défaut.) |
Voir aussi
Types Liquid
Balises Liquid
Filtres 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é).