Objets Liquid disponibles

Les objets Liquid contiennent des attributs pour présenter le contenu dynamique dans la page. Par exemple, l’objet page a un attribut appelé title que vous pouvez utiliser pour générer le titre de la page active.

Pour accéder à un attribut d’objet par nom, utilisez un point (.). Pour afficher l’attribut d’un objet dans un modèle, encapsulez-le et {{}}.

{{ 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] }}

Vous pouvez utiliser et accéder aux objets suivants n’importe où, dans n’importe quel modèle.

Annonces

Permet la récupération et l’affichage d’une publicité.

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

Attributs de placements publicitaires

Attributs de placement d’annonces

Un placement publicitaire est un objet table avec les mêmes attributs généraux et les attributs suivants :

Attributs de publicité

Attributs d’image publicitaire

blogs

Permet la récupération et l’affichage des blogs et des billets de blog.

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>

blogs (objet)

L’objet blogs vous permet d’accéder à n’importe quel blog spécifique dans le portail, ou d’accéder à tous les billets de blog du portail.

Le tableau suivant décrit les attributs associés à l’objet blogs.

{% assign blog = blogs["Blog Name"] %}                             

{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}  |

Objet blog

L’objet blog fonctionne avec un seul blog, afin que vous puissiez accéder aux billets de ce blog.

Le tableau suivant décrit différents attributs associés à l’objet blog.

Objet blogposts

L’objet blogposts vous donne accès à une collection d’objets de billet de blog. Vous pouvez commander les billets de blog et obtenir la pagination à l’aide de filtres liquides.

{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}

Voici d’autres options possibles :

• blogs.posts.all (pour obtenir tous les billets de blog)
• blogs.posts | from\_index: 0 | take: 2

Le tableau suivant décrit différents attributs associés à l’objet blogposts.

Objet blogpost

Fait référence à un billet de blog unique.

Le tableau suivant décrit différents attributs associés à l’objet blogpost.

entités

Utilisez cet objet pour charger n’importe quelle table Dataverse par ID. Si la table existe, elle retourne un objet table. Si une table avec l’ID donné est introuvable, elle retourne null.

{% 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 %}

Entité

Un objet entité permet d’accéder aux attributs d’un enregistrement de table Dataverse.

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.

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.

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.

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.

Relation réflexive

Tente de charger des relations réflexives (c’est-à-dire autoréférentielles) sur les entités retournées en tant qu’objets avec les attributs suivants.

entitylist

Utilisez l’objet entitylist dans les balises de table Dataverse pour accéder à tous les attributs d’une liste donnée.

Attributs

Attributs d’affichage de liste

Attributs de colonne d’affichage de liste

entityview

Utilisez l’objet entityview dans la balise entityview. Il fournit l’accès aux métadonnées de la vue, en plus d’afficher les enregistrements de résultats.

Attributs

events

Permet la récupération et l’affichage d’événements. L’objet events vous permet de sélectionner un événement spécifique ou tous les événements.

objet events

Utilisez l’objet events pour accéder à un événement spécifique dans le portail ou pour accéder à tous les événements du portail.

L’objet events a les attributs suivants :

objet d'événement

Utilisez l’objet event pour travailler avec un seul événement. Vous pouvez accéder aux planifications et aux occurrences de cet événement.

L’objet event a les attributs suivants :

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] %}

{% assign occurances = event.occurrences.min[today].max[advance_date] %}

Les attributs suivants sont associés à l’objet eventoccurrences

Objet eventoccurence

Représente une occurrence d’événement unique. Voici les attributs associés :

forloop

Contient des propriétés utiles dans un bloc de boucle 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

forums

Permet la récupération et l’affichage de forums et de fils de discussion de forum. La capacité d'utiliser Liquid pour restituer les données du forum s'étend aux messages, mais pour créer un nouveau message ou fil de discussion, vous devez utiliser un modèle de page de formulaires multétapes ASP.NET avec des fonctionnalités intégrées (comme les modèles de page par défaut de fil de discussion du forum et de message 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 de forum vous permet d’utiliser un seul forum afin de pouvoir accéder aux threads 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 commander les threads du forum et obtenir la pagination à l’aide de filtres Liquid.

{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}

Un thread de forum unique

L’objet publications sur forum vous permet d’accéder à un ensemble d’objets de messages de forum.

Attributs

Objet forum

Attributs

Objet forumthreads

Attributs

Objet forumthread

Attributs

Objet forumposts

Attributs

Un message unique du forum

Attributs

connaissance

Permet d’accéder aux enregistrements de la table knowledgearticle et category de Dataverse pour afficher les articles et les catégories dans un portail.

Attributs

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

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 %}

Objet Categories

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

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 %}

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 des attributs suivants :

objet catégorie

L’objet catégorie vous permet d’utiliser une catégorie unique pour afficher ses détails dans le portail.

Attributs

Catégorie est un objet entité, avec tous les mêmes attributs, en plus des attributs suivants :

langue

Fournit le nom de la langue actuelle et le code de la langue si la prise en charge multilingue est autorisée.

Attributs

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.

log

Les créateurs ont la possibilité d’incorporer des instructions de journal dans leur code Liquid. Lorsque le site Power Pages est en cours d’exécution, les journaux ajoutés par un créateur dans le code Liquid sont affichés dans l’extension de l’outil de développeur Power Pages. Ces journaux, incorporés par le créateur, sont affichés dans l’extension de l’outil de développeur lorsque le paramètre de diagnostic est activé.

La syntaxe suivante peut être utilisée dans le code Liquid pour enregistrer des messages personnalisés :

{% log message:'Custom message' level:'Warning' %}

Enregistrer les attributs

Exemple :

{% log message: 'Log from Home page' %}

{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}

{% assign contacts = query.results.entities %}

{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %} 
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}

page

Fait référence à la page de requête de portail en cours. 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 Dataverse 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

interrogations

Permet la récupération et l’affichage d’un sondage.

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

Attributs de placements d’interrogation

Attributs de placement d’interrogation

Attributs d’interrogation

Attributs des options d’interrogation

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>

Attributs

searchindex

L’objet searchindex est utilisé dans les balises de table Dataverse 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

Résultats d’index de recherche

serverlogic

Pendant le rendu du modèle Liquid, la serverlogic balise appelle une opération logique de serveur. Le output paramètre de la balise crée l’objet serverlogic . L’objet n’est pas disponible en tant qu’objet Liquid global.

Syntax

{% serverlogic name: 'server-logic-name', operation: 'operation-name', input: inputData, output: result %}

Parameters

L’exemple suivant transmet une entrée JSON à une opération logique de serveur :

{% assign inputData = '{"category":"active","maximumResults":5}' %}

{% serverlogic name: 'customer-summary', operation: 'getSummary', input: inputData, output: result %}

{% if result.success %}
  <p>{{ result.data.message | escape }}</p>
{% else %}
  <p>The customer summary couldn't be retrieved.</p>
{% endif %}

Dans l’opération logique du serveur, utilisez cette option Server.Context.Input pour lire l’entrée :

function getSummary() {
    var input = JSON.parse(Server.Context.Input || "{}");

    return JSON.stringify({
        message: "Summary retrieved",
        category: input.category,
        maximumResults: input.maximumResults
    });
}

En savoir plus sur la logique du serveur d’appels à partir de Liquid.

Attributs

settings

Utilisez cet objet pour charger n’importe quel paramètre de site par nom. Si le portail ne trouve pas de paramètre portant le nom donné, il retourne la valeur Null.

{{ 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

Utilisez cet objet pour accéder à la carte 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

Attributs de nœud de carte de site

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 est retourné. Si un marqueur de site avec le nom donné est introuvable, null est 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 Sitemarker

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 est 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.

Attributs

Utilisateur

Se rapporte à l’utilisateur actuel du portail, donnant ainsi accès à tous les attributs de l’enregistrement de contact Dataverse 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 %}

Attributs

En plus d’avoir tous les attributs d’un objet entity, user possède les attributs suivants.

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

Attributs de lien web

Attributs d’une image de lien web

site web

Se rapporte au site web du portail, donnant ainsi accès à tous les attributs de l’enregistrement du site Web Dataverse (adx_website) pour le portail.

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.

Voir aussi

Types de liquides
Balises Liquid
Filtres Liquid