Tilgængelige Liquid-objekter

Liquid-objekter indeholder attributter til at producere dynamisk indhold til siden. For eksempel har sideobjektet har en attribut med navnet title, der kan bruges til at udskrive titlen på den aktuelle side.

Brug et punktum (.) til at få adgang til en objektattribut efter navn. For at gengive et objekts attribut i en skabelon skal du ombryde den i {{ and }}.

{{ page.title }}

Du kan også få adgang til attributterne for et objekt ved hjælp af et strengnavn og []. Dette format er nyttigt i tilfælde, hvor den ønskede attribut bestemmes dynamisk, eller attributnavnet indeholder tegn, mellemrum, specialtegn osv., der ville være ugyldige ved brug af et punktum (.) i syntaksen.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Følgende objekter kan bruges og bruges overalt i enhver skabelon.

ads

Gør det muligt at hente og få vist en annonce.

Med ads-objektet kan du vælge en bestemt reklame eller reklameplacering.

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

Reklameattributter

Attributter for reklameplaceringer

Egenskaber ved reklameplacering

En reklameplacering er et tabelobjekt med de samme generelle attributter og følgende attributter:

Annonceattributter

Attributter for reklamebillede

blogs

Gør det muligt at hente og se blogge og blogindlæg.

Med blogs-objektet kan du vælge en bestemt blog eller blogopslag.

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

Objektet blogs giver dig adgang til en bestemt blog på portalen eller til alle blogopslag på portalen.

I følgende tabel beskrives de attributter, der er knyttet til blogs-objektet.

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

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

Objektet blog

Objektet blog gør det muligt at arbejde med en enkelt blog, så du kan få adgang til opslagene for denne blog.

I følgende tabel beskrives de forskellige attributter, der er knyttet til blog-objektet.

Blogposts-objektet

Objektet blogposts giver dig adgang til en samling af blogopslagsobjekter. Du kan bestille blogopslagene og gennemføre sideinddeling ud over at bruge Liquid-filtre:

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

Andre mulige indstillinger:

• (for at hente alle blogindlæg)
• blogs.posts | from\_index: 0 | take: 2

I følgende tabel beskrives de forskellige attributter, der er knyttet til blogposts-objektet.

Objektet blogpost

Refererer til et enkelt blogopslag.

I følgende tabel beskrives de forskellige attributter, der er knyttet til blogpost-objektet.

enheder

Gør det muligt at indlæse enhver Dataverse-tabel efter id. Hvis tabellen findes, returneres et tabelobjekt. Hvis en tabel med det angivne id ikke blev fundet, returneres 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 %}

Enhed

Et enhedsobjekt giver adgang til attributterne for en tabelpost i Dataverse.

Tilknyttet tabelreference

Opslagsattributværdier returneres som tilknyttede tabelreferenceobjekter med følgende attributter.

Bemærk

En note er en tabel, der giver adgang til attributter og relationer i en anmærkningspost. Ud over alle attributterne for en tabel har en note følgende ekstra attributter.

Værdi for valgmulighedssæt

Attributværdier for grupperet indstilling/valglister returneres som tilknyttede tabelreferenceobjekter med følgende attributter.

Tabeltilladelser

Objektet Tabeltilladelser giver adgang til samlede tilladelsesassertionsresultater for en tabel.

Refleksiv relation

Forsøg på at indlæse refleksive relationer (dvs. relationer, der refererer til sig selv) i objekter returneres som objekter med følgende attributter.

entitetsliste

Objektlisteobjektet bruges i Dataverse tabel-tags. Det giver adgang til alle attributterne for en bestemt liste.

Attributter

Attributter for listevisning

Attributter for kolonner i listevisning

entityview

Objektet entityview bruges i entityview-mærket og giver adgang til metadataene for visningen ud over at visning af resultatposter.

Attributter

begivenheder

Gør det muligt at hente og vise hændelser. Med objektet events kan du vælge en bestemt hændelse eller alle hændelser.

Objektet Events

Objektet events giver dig adgang til en bestemt hændelse på portalen eller til alle hændelser på portalen (uanset hændelsen).

Objektet events har følgende attributter:

Event-objekt

Objektet event gør det muligt at arbejde med en enkelt hændelse, så du kan få adgang til tidsplaner og forekomster for hændelsen.

Objektet event har følgende attributter:

Objektet eventoccurrences

Objektet eventoccurrences giver dig adgang til en samling af hændelsesforekomstobjekter. Du kan ændre rækkefølgen af hændelsesforekomster og angive et datointerval for de hændelser, der skal hentes, og gennemføre sideinddeling samt bruge Liquid-filtre:

{% assign occurances = event.occurrences.from[today].to[advance_date] %}

Følgende indstilling er også mulig:

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

Følgende attributter er knyttet til eventoccurrences-objekt

Objektet eventoccurrence

Repræsenterer en enkelt hændelsesforekomst. Der er følgende tilknyttede attributter:

forloop

Indeholder egenskaber, der er nyttige i en forløkkeblok.

Kode

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

This is child page number {{ forloop.index }}.

{% endif %}

{% endfor %}

Resultat

This is the first child page!

This is child page number 2.

This is child page number 3.

Attributter

forums

Gør det muligt at hente og få vist fora og forumtråde. Muligheden for at bruge væske til at gengive forumdata omfatter indlæg, men hvis du vil oprette et nyt indlæg eller en ny tråd, skal du bruge en ASP.NET sideskabelon med flere trin med den funktionalitet, der er indbygget (f.eks. standardskabelonerne forumtråd og forumindlægsside).

Med objektet forum kan du vælge et forum eller forumtråde:

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

forumobjekt

Objektet forums giver dig adgang til et bestemt forum på portalen eller til alle forumtråde på portalen (uanset forummet).

Objektet forum gør det muligt at arbejde med et enkelt forum, så du kan få adgang til trådene for dette forum.

Objektet forumthreads giver dig adgang til en samling af forumthread-objekter. Du kan bestille forumtråde og gennemføre sideinddeling samt ved hjælp af Liquid-filtre.

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

En enkelt forumtråd

Objektet forumposts giver dig adgang til en samling af forumposts-objekter.

Attributter

Objektet forum

Attributter

Objektet Forumthreads

Attributter

Objektet forumthread

Attributter

Objektet forumposts

Attributter

Et enkelt forumopslag

Attributter

viden

Giver adgang til tabelposter af typen knowledgearticle og category i Dataverse til gengivelse af artikler og kategorier i en portal.

Attributter

Objektet artikler

Objektet articles giver dig adgang til en samling af article-objekter. Du kan arrangere artiklerne og gennemføre sideinddeling ved hjælp af Liquid-filtre.

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

Attributter

Filtre

Følgende filtre kan acceptere valgfrie parametre for størrelse og sprog. Den første parameter er det tal eller de poster, der skal hentes. Standardsidestørrelsen er 5. Den anden parameter er koden for et sprog, der bruges til at hente artikler på et bestemt sprog. Filtre kan kombineres med andre Liquid-filtre.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}

Objektet kategorier

Objektet categories giver dig adgang til en samling af kategoriobjekter. Du kan arrangere kategorierne og gennemføre sideinddeling ved hjælp af Liquid-filtre.

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

Attributter

Filtre

Følgende filtre kan acceptere en valgfri parameter, som angiver sidestørrelse. Standardsidestørrelsen er 5. Filtre kan kombineres med andre Liquid-filtre.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}

Objektet article

Objektet article giver dig mulighed at arbejde med en enkelt videnartikel for at få vist detaljerne for denne artikel på portalen.

Attributter

Article er et objekt af typen entity med de samme attributter foruden følgende attributter:

Kategori objekt

Objektet category giver dig mulighed at arbejde med en enkelt kategori for at vise dens detaljer på portalen.

Attributter

category er et objekt af typen entity med de samme attributter foruden følgende attributter:

sprog

Angiver det aktuelle sprognavn og den aktuelle sprogkode, hvis understøttelse af flere sprog er aktiveret.

Attributter

Webskabelonen Rulleliste med sprog bruger f.eks. som standard dette liquid-objekt til at angive de tilgængelige sprog, når der er flere sprog.

log

Udviklere har mulighed for at indarbejde logsætninger i deres Liquid-kode. Når det Power pages websted kører, vises de logge, der er tilføjet af en udvikler i flydende kode, i udvidelsen Power Pages udviklerværktøj. Disse logge, der er integreret af udvikleren, vises i udviklerværktøjsudvidelsen, når diagnosticeringsindstillingen er aktiveret.

Følgende syntaks kan bruges i Liquid-kode til at logføre brugerdefinerede meddelelser:

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

Logattributter

Eksempel:

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

Refererer til den aktuelle anmodningsside i portalen. Dette objekt kombinerer attributterne for sitemap og den aktuelle anmodning om entities (normalt en webside).

Objektet page giver adgang til ting som brødkrummerne for den aktuelle side, titel eller URL-adresse på den aktuelle side og eventuelle andre attributter eller relaterede objekter i den underliggende Dataverse-post.

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

Sideattributter

afstemninger

Gør det muligt at hente og vise en afstemning.

Med polls-objektet kan du vælge en bestemt afstemning eller afstemningssted.

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

Afstemningsattributter

Attributter for afstemningssteder

Attributter for afstemningssted

Afstemningsattributter

Attributter for afstemningsmulighed

anmodning

Indeholder oplysninger om den aktuelle HTTP-anmodning.

{% assign id = request.params['id'] | escape %}

<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>

Attributter

søgeindeks

Objektet searchindex bruges i Dataverse-tabeltags og giver adgang til resultaterne af en forespørgsel.

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

Attributter

Søgeindeksresultater

indstillinger

Gør det muligt at indlæse en webstedsindstilling efter navn. Hvis en indstilling med det angivne navn ikke blev fundet, returneres 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

Giver adgang til oversigten over portalwebstedet.

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

Sitemap-attributter

Attributter for webstedskortnoder

sitemarkers

Gør det muligt at indlæse ethvert webstedsmærke efter navn. Hvis sitemarker findes, returneres et sitemarker-objekt. Hvis en sitemarker med det angivne navn ikke blev fundet, returneres null.

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

Sitemarker-attributter

snippets

Gør det muligt at indlæse alle indholdskodestykker efter navn. Hvis et kodestykke med det angivne navn ikke blev fundet, returneres null.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Indeholder egenskaber, der er nyttige i en Gentagelsesmærker-løkkeblok.

Attributter

Bruger

Refererer til den aktuelle portalbruger og giver adgang til alle attributter i den underliggende kontaktpersonpost i Dataverse. Hvis ingen bruger er logget på, er denne variabel null.

User er et entity-objekt.

{% if user %}
 
Hello, {{ user.fullname | escape }}!
 
{% else %}
 
Hello, anonymous user!
 
{% endif %}

Attributter

Ud over at have alle attributterne for et entity-objekt har bruger følgende attributter.

weblinks

Gør det muligt at indlæse alle weblinks efter navn eller id.

Hvis weblinksættet findes, returneres et weblinksætobjekt. Hvis et weblinksæt med det angivne navn eller id ikke blev fundet, returneres null.

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

Attributter for weblinksæt

Attributter for weblinks

Attributter for weblinkbillede

website

Henviser til portalwebstedet og giver adgang til alle attributter på Dataverse-webstedsposten (adx_website) for portalen.

Kode

{{ website.adx_name }} ({{ website.id }})

Resultat

Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)

Attributter

I følgende tabel vises attributterne for denne kode, der kan bruges til at erstatte standardværdierne for at undgå cachelagring.

Se også

Liquid-typer
Liquid-mærker
Liquid-filtre