Tilgjengelige Liquid-objekter

Liquid-objekter inneholder attributter for å levere dynamisk innhold på siden. Objektet har for eksempel page et attributt title kalt som du kan bruke til å skrive ut tittelen på gjeldende side.

Hvis du vil ha tilgang til et objektattributt etter navn, bruker du et punktum (.). Hvis du vil gjengi attributtet til et objekt i en mal, pakker du det inn {{ og }}.

{{ page.title }}

Du får også tilgang til attributter for et objekt ved hjelp av et strengnavn og []. Dette formatet er nyttig i tilfeller der obligatorisk attributt bestemmes dynamisk, eller attributtnavnet inneholder tegn, mellomrom, spesialtegn og så videre, som ellers ville være ugyldige når du bruker et punktum (.) inne i syntaksen.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Du kan bruke og få tilgang til følgende objekter hvor som helst, i en hvilken som helst mal.

ads

Gjør at en annonse kan hentes og vises.

ads-objektet lar deg velge en bestemt annonse eller annonseplassering:

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

Attributter for annonser

Attributter for annonseplasseringer

Attributter for annonseplassering

En annonseplassering er et tabellobjekt med de samme generelle attributtene, og følgende attributter:

Attributter for annonse

Attributter for annonsebilde

Blogger

Aktiverer henting og visning av blogger og blogginnlegg.

Med bloggobjektet kan du velge en bestemt blogg eller blogginnlegg.

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

bloggobjekt

Med bloggobjektet kan du få tilgang til en bestemt blogg i portalen, eller få tilgang til alle blogginnleggene i portalen.

Tabellen nedenfor beskriver attributtene som er forbundet med blogs-objektet.

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

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

blog-objektet

Bloggobjektet fungerer med én enkelt blogg, slik at du kan få tilgang til innleggene for bloggen.

Tabellen nedenfor forklarer ulike attributter som er knyttet til bloggobjektet.

blogposts-objektet

Blogginnlegg-objektet gir deg tilgang til en samling blogginnleggobjekter. Du kan bestille blogginnleggene og oppnå paginering ved hjelp av flytende filtre.

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

Andre mulige alternativer inkluderer:

• blogs.posts.all (for å få alle blogginnlegg)
• blogs.posts | from\_index: 0 | take: 2

Tabellen nedenfor forklarer ulike attributter som er knyttet til bloggpostobjektet.

blogpost-objektet

Refererer til ett enkelt blogginnlegg.

Tabellen nedenfor forklarer ulike attributter som er knyttet til blogginnleggobjektet.

Objekter

Bruk dette objektet til å laste inn en datavers tabell etter ID. Hvis tabellen finnes, returnerer den et tabellobjekt. Hvis en tabell med angitt ID ikke blir funnet, returnerer den 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 %}

Enhet

Et enhetsobjekt gir tilgang til attributtene til en oppføring i Dataverse-tabellen.

Tilknyttet tabellreferanse

Verdier for oppslagsattributt returneres som tilknyttede tabellreferanseobjekter med følgende attributter:

Notat

Et notat er et tabellobjekt som gir tilgang til attributter og relasjoner for en annotation-oppføring. I tillegg til alle attributtene til et tabellobjekt har et notat følgende ekstra attributter:

Verdi for alternativsett

Attributtverdier for alternativsett/nettrekksmeny returneres som tilknyttede rabellreferanseobjekter med følgende attributter:

Tabelltillatelser

Objektet for tabelltillatelser gir tilgang til deklarasjonsresultater for aggregert tillatelse for en tabell.

Refleksiv relasjon

Forsøk på å laste inn refleksive relasjoner (det vil være selvrefererende) på enheter som returneres som objekter med følgende attributter.

entitylist

entitylist Bruk objektet i dataverse tabellkoder for å få tilgang til alle attributtene til en gitt liste.

Attributter

Listevisningsattributter

Kolonneattributter for listevisning

entityview

Bruk entityview-objektet i enhetsvisningskoden. Den gir tilgang til metadataene for visningen, i tillegg til å vise resultatposter.

Attributter

Hendelser

Gjør at hendelser kan hentes og vises. events-objektet lar deg velge en bestemt hendelse eller alle hendelser.

hendelsesobjekt

events Bruk objektet til å få tilgang til en bestemt hendelse i portalen eller for å få tilgang til alle hendelser i portalen.

Objektet events har følgende attributter:

hendelsesobjekt

Bruk objektet til å arbeide med én event enkelt hendelse. Du kan få tilgang til tidsplanene og forekomstene for denne hendelsen.

Objektet event har følgende attributter:

eventoccurences-objektet

eventoccurences-objektet gir deg tilgang til en samling av eventoccurences-objekter. Du kan sortere hendelsesforekomstene og angi et datointervall for forekomstene for å hente og få paginering i tillegg til å bruke Liquid-filtre:

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

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

Følgende attributter er tilknyttet eventoccurences-objektet

eventoccurence-objektet

Representerer én enkelt hendelsesforekomst. Dette er de tilknyttede attributtene:

forloop

Inneholder egenskaper som er nyttig i en for-løkkeblokk.

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

Utdata

This is the first child page!

This is child page number 2.

This is child page number 3.

Attributter

forums

Gjør at fora og forumtråder kan hentes og vises. Muligheten til å bruke væske til å gjengi forumdata strekker seg til innlegg, men hvis du vil opprette et nytt innlegg eller en ny tråd, må du bruke en ASP.NET sidemal med flere trinn med nevnte funksjonalitet innebygd (for eksempel standard forumtråd og maler for foruminnleggssider).

Forums-objektet lar deg velge et forum eller forumtråder:

<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

Forums-objektet lar deg få tilgang til et bestemt forum i portalen, eller å få tilgang til alle forumtråder i portalen (uavhengig av forumet).

Med forumobjektet kan du arbeide med ett enkelt forum, slik at du får tilgang til trådene for dette forumet.

Forumthreads-objektet gir deg tilgang til en samling av forumthread-objekter. Du kan bestille forumtrådene og oppnå paginering ved hjelp av flytende filtre.

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

En enkelt forumtråd

Forumposts-objektet gir deg tilgang til en samling av forumpost-objekter.

Attributter

forum-objektet

Attributter

forumthreads-objektet

Attributter

forumthread-objektet

Attributter

forumposts-objektet

Attributter

Ett enkelt foruminnlegg

Attributter

kunnskap

Gir tilgang til Dataverse-kunnskapsbaseartikkelen og kategoritabelloppføringene for å vise artikler og kategorier i en portal.

Attributter

articles-objekt

Med articles-objektet får deg tilgang til en samling av artikkelobjekter. Du kan sortere artiklene og få paginering også ved hjelp av 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

Disse filtrene kan godta valgfrie parametere for sidestørrelse og språket. Første parameter er tallet eller oppføringene som skal hentes. Standard sidestørrelse 5. Den andre parameteren er koden for språket du vil hente artikler for et bestemt språk. 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 %}

Kategoriobjekt

Med categories-objektet får du tilgang til en samling kategoriobjekter. Du kan sortere kategoriene, paginere og bruke 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

Disse filtrene kan godta en valgfri parameter som indikerer sidestørrelsen. Standard sidestørrelse 5. Filtre kan kombineres med andre Liquid-filtre.

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

article-objekt

Med article-objektet kan du arbeide med en enkelt kunnskapsartikkel for å vise detaljene for denne artikkelen i portalen.

Attributter

Article er et entity-objekt med alle de samme attributtene, i tillegg til følgende attributter:

category-objekt

Med category-objektet kan du arbeide med en enkelt kategori for å vise detaljene i portalen.

Attributter

category er et entity-objekt med alle de samme attributtene, i tillegg til følgende attributter:

språk

Angir gjeldende språknavn og språkkode hvis støtte for flere språk er aktivert.

Attributter

Webmalen for Språk-rullegardinlisten bruker for eksempel dette flytende objektet for å vise de tilgjengelige språkene når flere språk er tilgjengelige.

logg

Opprettere har muligheten til å inkludere loggsetninger i Liquid -koden. Når Power pages-området kjører, vises loggene som legges til av en produsent i liquid code i Power Pages verktøyutvidelse for utviklere. Disse loggene, innebygd av oppretteren, vises i utviklerverktøyutvidelsen når diagnoseinnstillingen er aktivert.

Du kan bruke følgende syntaks i Liquid-kode til å logge egendefinerte meldinger:

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

Loggattributter

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

side

Refererer til gjeldende side for portalforespørsel. Dette objektet kombinerer attributtene til områdekart og gjeldende enheter for forespørsel (vanligvis en nettside).

Objektet page gir tilgang til for eksempel synlig søkebane for gjeldende side, tittel eller nettadresse for gjeldende side, og andre attributter eller relaterte enheter for den underliggende Dataverse-oppføringen.

<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

polls

Gjør at en avstemning kan hentes og vises.

polls-objektet lar deg velge en bestemt avstemning eller avstemningsplassering:

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

Avstemningsattributter

Attributter for avstemningsplasseringer

Attributter for avstemningsplassering

Avstemningsattributter

Attributter for avstemningsalternativ

forespørsel

Inneholder informasjon om gjeldende HTTP-forespørsel.

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

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

Attributter

searchindex

Objektet searchindex brukes i Dataverse-tabellkoder og gir tilgang til resultatene for en spørring.

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

Resultater for søkeindeks

serverlogic

Under gjengivelse av flytende mal serverlogic aktiverer koden en serverlogikkoperasjon. Parameteren output for serverlogic koden oppretter objektet. Objektet er ikke tilgjengelig som et globalt liquid-objekt.

Syntaks

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

Parametre

Følgende eksempel sender JSON-inndata til en serverlogikkoperasjon:

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

Bruk denne til å lese inndataene i serverlogikkoperasjonen Server.Context.Input :

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

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

Finn ut mer i Samtaleserverlogikk fra Liquid.

Attributter

innstillinger

Bruk dette objektet til å laste inn en hvilken som helst områdeinnstilling etter navn. Hvis portalen ikke finner en innstilling med det angitte navnet, 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 %}

Områdekart

Bruk dette objektet til å få tilgang til portalområdekartet.

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

Attributter for områdekart

Nodeattributter for områdekart

sitemarkers

Lar deg laste inn hvilke som helst områdemarkører etter navn. Hvis områdemarkøren ikke finnes, returneres et sitemarker-objekt. Hvis du ikke finner en områdemarkør med det angitte navnet, 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 %}

Områdemerkeattributter

snippets

Gjør det mulig å laste inn hvilke som helst innholdssnutter etter navn. Hvis du ikke finner en snutt med det angitte navnet, returneres null.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Inneholder egenskaper som er nyttig i en Iterasjonskoder-løkkeblokk.

Attributter

Bruker

Henviser til gjeldende portalbruker, og gir tilgang til alle attributtene for den underliggende Dataverse-kontaktoppføringen. Hvis ingen brukere er logget på, er denne variabelen null.

User er et entity-objekt.

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

Attributter

I tillegg til å ha alle attributtene for et entity-objekt har brukeren attributtene nedenfor.

weblinks

Lar deg laste inn nettkoblinger etter navn eller ID.

Hvis det finnes et nettkoblingssett, returneres et nettkoblingssettobjekt. Hvis et nettkoblingssett med angitt navn eller ID ikke finnes, 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 nettkoblingssett

Webkoblingsattributter

Attributter for bilde for nettkobling

nettsted

Henviser til nåværende portalnettsted, og gir tilgang til alle attributtene for Dataverse-nettstedsoppføringen (adx_website) for portalen.

Kode

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

Utdata

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

Attributter

Tabellen nedenfor viser attributtene for dette merket som kan brukes til å erstatte standardverdiene for å unngå hurtigbufring.

Se også

Væsketyper
Liquid-tags
Liquid-filtre