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>

&ndash;

<a href={{ post.author_url }}> {{ post.author_name }} </a>

&ndash;

<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 :
  • Les champs de recherche (référence de table associée) sont renvoyés en tant qu’objets de référence de table associés.
  • Les champs Groupe d’options/Liste de sélection sont retournés comme objets de valeur de groupe d’options.
  • Vous pouvez également charger les entités associées par le nom du schéma de relation.
  • {{ 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.

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

entités

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

entités

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

entities

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

entities

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

entities

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 :
  • Les champs de recherche (référence de table associée) sont renvoyés en tant qu’objets de référence de table associés.
  • Les champs Groupe d’options/Liste de sélection sont retournés comme objets de valeur de groupe d’options.
  • Vous pouvez également charger les entités associées par le nom du schéma de relation.
    {{ 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

entities

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

entities

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

entities

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

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

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