Käytettävissä olevat Liquid-objektit

Liquid-objektit sisältävät määritteitä, joilla tuotetaan dynaamista sisältöä sivulle. Esimerkiksi sivuobjektilla on otsikko-määrite, jonka avulla voidaan tulostaa nykyisen sivun otsikko.

Voit käyttää objektin määritettä nimen perusteella pisteen (.) avulla. Voit hahmontaa objektin määritteen mallissa asettamalla sen ympärille {{ and }}.

Tärkeä

Mahdollisten sivustojenvälisten komentosarjojen (XSS) ongelmien välttämiseksi käytä escape-suodatinta HTML-koodaamiseen aina, kun luet Liquid-objektien avulla käyttäjän ei-luotettuja tietoja.

{{ page.title }}

Objektin määritteitä voidaan käyttää myös merkkijonon nimen ja []-merkkien avulla. Tästä muodosta on hyötyä, jos tarvittu määrite määritetään dynaamisesti tai määritteen nimessä on esimerkiksi merkkejä, välilyöntejä ja erikoismerkkejä, jotka olisivat virheellisiä, kun käytetään pistettä (.) syntaksin sisällä.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Seuraavia objekteja voidaan käyttää ja käsitellä missä tahansa ja kaikissa malleissa.

Object	Description
kohteet	Antaa mahdollisuuden ladata minkä tahansa Microsoft Dataverse -taulukon tunnuksen perusteella. Lisätietoja: entiteetit
nyt	Päivämäärä/kellonaika-objekti, joka viittaa nykyiseen UTC-aikaan sinä hetkenä, kun malli on hahmonnetaan. Huomautus: Tämä arvo tallentuu välimuistiin portaalin verkkosovelluksella, eikä se päivity joka kerta. Lisätietoja: Päivämääräsuodattimet
sivun	Viittaa nykyiseen portaalin pyyntösivuun. Sivuobjekti mahdollistaa pääsyn esimerkiksi nykyisen sivun navigointipolkuun tai otsikkoon sekä muihin taustalla olevan Dataverse -tietueen määritteisiin ja liittyviin entiteetteihin. Lisätietoja: sivu
params	Sopiva request.params-lyhenne. Lisätietoja: pyyntö
pyyntö	Sisältää tietoja nykyisestä HTTP-pyynnöstä. Lisätietoja: pyyntö
asetukset	Sallii minkä tahansa sivustoasetuksen lataamisen nimen perusteella. Lisätietoja: asetukset
sivustokartta	Antaa oikeudet portaalin sivustokartan tarkasteluun. Lisätietoja: sivustokartta
Sivustomerkinnät	Sallii minkä tahansa sivustomerkinnän lataamisen nimen perusteella. Lisätietoja: sivustomerkinnät
snippets	Sallii minkä tahansa sisältökatkelman lataamisen nimen perusteella. Lisätietoja: koodikatkelmat
käyttäjä	Viittaa portaalin nykyiseen käyttäjään ja sallii kaikkien taustalla olevan Dataverse:n yhteyshenkilötietueen määritteiden käytön. Jos kirjautunutta käyttäjää ei ole, tämän muuttuja on tyhjäarvo. Lisätietoja: käyttäjä
Verkkolinkit	Sallii minkä tahansa verkkolinkin joukon lataamisen nimen tai tunnuksen perusteella. Lisätietoja: verkkolinkit
sivusto	Viittaa portaalin sivustotietueeseen ja sallii kaikkien Dataverse-sivuston (adx_website) portaalitietueen määritteiden käytön. Lisätietoja: sivusto

ads

Mahdollistaa mainoksen noutamisen ja näyttämisen.

Ads-objektin avulla voit valita tietyn mainoksen tai mainossijoittelun.

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

Mainosten määritteet

Määrite	Description
placements	Palauttaa adplacements-objektin.
[mainoksen nimi tai tunnus]	Voit käyttää mitä tahansa mainosta sen nimen tai tunnuksen perusteella. {% assign ad = ads[Ad Name] %} {% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Mainossijoittelujen määritteet

Määrite	Description
[mainossijoittelun nimi tai tunnus]	Voit käyttää mitä tahansa adplacement-objektia sen nimen tai tunnuksen perusteella. {% assign placement = ads.placements[Placement Name or Id] %} {% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Mainossijoittelun määritteet

Mainoksen sijoittelu on taulukko-objekti, jolla on samat yleiset määritteet ja seuraavat määritteet:

Määrite	Description
Mainokset	Palauttaa kokoelman sijoitteluun liittyviä mainosobjekteja. Iterointitunnisteita ja matriisin suodattimia voi käyttää tässä kokoelmassa.
Name	Palauttaa mainossijoittelun nimikentän.
placement_url	URL-osoite, jonka avulla mallin täysin hahmontama mainossijoittelu voidaan noutaa.
random_url	URL-osoite, jonka avulla mallin täysin hahmontamasta mainossijoittelusta voidaan noutaa satunnainen mainos.

Mainoksen määritteet

Muistiinpano

Mainos on taulukko-objekti, jolla on kaikki samat määritteet seuraavien määritteiden lisäksi:

Määrite	Description
ad_url	URL-osoite, jonka avulla mallin täysin hahmontama mainos voidaan noutaa.
Tekstisisältö	Palauttaa mainoksen tekstisisältökentän.
kuva	Palauttaa mainoksen kuvaobjektin (jos sellainen on).
Name	Palauttaa mainoksen nimikentän.
open_in_new_window	Palauttaa tosi-arvon, jos URL-osoite, jonka redirect_url määrittää, avataan uudessa ikkunassa.
redirect_url	URL-osoite, johon käyttäjä ohjataan, kun tämä valitsee mainoksen.

Mainoskuvan määritteet

Määrite	Description
alternate_text	Palauttaa tekstin, joka on tarkoitus näkyä tunnisteen alt-määritteessä.
height	Palauttaa kuvan korkeuden kuvapisteinä
URL-osoite	Palauttaa kuvan lähteen URL-osoitteen.
leveys	Palauttaa kuvan leveyden kuvapisteinä

blogs

Mahdollistaa blogien ja blogikirjoitusten noutamisen ja näyttämisen.

Blogs-objektin avulla voit valita tietyn blogin tai tietyt blogikirjoitukset.

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

blogs-objektin avulla voit käyttää mitä tahansa portaalin blogia tai kaikkia portaalin blogikirjoituksia.

Seuraavassa taulukossa kuvataan blogs-objektiin liittyvät määritteet.

Määrite	Kuvaus
posts	Palauttaa blogposts-objektin, joka sisältää kaikki portaalin blogikirjoitukset.
[blogin nimi tai tunnus]	Voit käyttää mitä tahansa blogia sen nimen tai tunnuksen perusteella.

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

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

blog-objekti

Blog-objektin avulla voit käsitellä yhtä blogia ja kyseisen blogin kirjoituksia.

Seuraavassa taulukossa kuvataan blog-objektiin liittyvät määritteet.

Määrite	Kuvaus
posts	Palauttaa blogposts-objektin, joka sisältää kaikki blogiin kuuluvat kirjoitukset.
Nimi	Blogin nimi.
title	Blogin otsikko.
URL-osoite	Blogin URL-osoite.

blogposts-objekti

blogposts-objektin avulla voit käyttää blogikirjoitusten-objektikokoelmaa. Voit järjestää ja sivuttaa kirjoitukset sekä käyttää Liquid-suodatusta:

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

Muut mahdolliset vaihtoehdot:

• blogs.posts.all (saat kaikki blogimerkinnät)
• blogs.posts | from\_index: 0 | take: 2

Seuraavassa taulukossa kuvataan blogposts-objektiin liittyvät määritteet.

Määrite	Kuvaus
Kaikki	Palauttaa kaikki kokoelman blogpost-objektit.

blogpost-objekti

Viittaa yhteen blogikirjoitukseen.

Seuraavassa taulukossa kuvataan blogpost-objektiin liittyvät määritteet.

Määrite	Kuvaus
url-osoite	Kirjoituksen URL-osoite.
sisältö	Palauttaa kirjoituksen Sisältö-kentän.
author	Palauttaa kirjoituksen tekijät (eli yksinkertaisesti yhteyshenkilötaulukon objektin).
otsikko	Kirjoituksen otsikko.
comment_count	Palauttaa kokonaislukuna kirjoitukselle annettujen kommenttien määrän.
publish_date	Päivämäärä, jolloin kirjoitus on julkaistu.

kohteet

Varoitus

Mahdollisten sivustojenvälisten komentosarjojen (XSS) ongelmien välttämiseksi käytä escape-suodatinta HTML-koodimerkkijonotietoihin aina, kun luet entiteettien Liquid-objektin avulla käyttäjän tietoja, joita ei voi pitää luotettuina.

Muistiinpano

Osa Dataverse nimeämiskäytännöistä on muuttunut. Esimerkiksi Dataverse-entiteettejä kutsutaan nyt taulukoiksi. Nimenmuutokset eivät päde Liquid-objekteihin. Liquid-entiteetti-objekteja kutsutaan vastaisuudessakin entiteeteiksi.

Antaa mahdollisuuden ladata minkä tahansa Dataverse -taulukon tunnuksen perusteella. Jos taulukko on olemassa, taulukko-objekti palautetaan. Jos tunnusta vastaavaa taulukkoa ei löydy, tyhjäarvo palautetaan.

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

Entiteettiobjekti antaa mahdollisuus käyttää Dataverse -taulukkotietueen määritteitä.

Määrite	Kuvaus
Tunniste	Taulukon GUID-tunnus merkkijonona. Esimerkki: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Taulukon looginen Dataverse -nimi.
Huomautuksia	Lataa taulukon liitetyt muistiinpanot (huomautus) järjestyksessä vanhimmasta uusimpaan (createdon). Muistiinpanot palautetaan muistiinpano-objekteina.
oikeudet	Lataa taulukon Taulukko-oikeuden vahvistuksen tulokset. Tulos palautetaan oikeusobjektina.
url-osoite	Palauttaa taulukon Power Pagesin sisällönhallintajärjestelmän URL-polun. Jos taulukolla ei ole kelvollista URL-osoitetta nykyisessä sivustossa, palautusarvo on tyhjäarvo. Yleensä tämä palauttaa arvon vain tietyille taulukkotyypeille, jotka on integroitu portaalin CMS:ään, ellei sovelluksen URL-osoitepalvelua ole mukautettu.
[määritteen tai suhteen nimi]	Mitä tahansa Dataverse -taulukon määritettä voi käyttää loogisen nimen perusteella. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Useimmat taulukkomääritteiden arvot yhdistetään suoraan Liquid-tyypit-objektiin: kahden asetuksen kentät yhdistyvät totuusarvoihin, tekstikentät merkkijonoihin, numero- ja valuuttakentät lukuihin sekä päivämäärä ja aikakentät päivämääräobjekteihin. Jotkin määritetyypit palautetaan kuitenkin objekteina: Valintakentät (liitetty taulukkoviittaus) palautuvat liitettyjen taulukon viiteobjekteina. Asetusjoukko/valintaluettelokentät palautetaan asetusjoukon arvo-objekteina. Voit myös ladata minkä tahansa liittyvän entiteetin suhderakenteen nimen mukaan. {{ page.adx_webpage_entitylist.adx_name }}Siinä tapauksessa, että suhde on refleksiivinen (eli itseensä viittaava), palautetaan refleksiivinen suhdeobjekti. (Muussa tapauksessa tulos olisi epäselvä.){{ page.adx_webpage_webpage.referencing.adx_name }} Huomautus: Jos lataat suuren määrän liittyviä entiteettejä tai käytät suurta määrää suhteita yhdessä mallissa, mallin hahmontamisen suorituskyky voi heikentyä. Vältä liittyvien entiteettien lataamista jokaisessa matriisin kohteessa silmukan sisällä. Entiteettikokoelmien lataamiseen kannattaa käyttää mahdollisuuksien mukaan Dataverse-taulukkotunnisteita.

Liitetty taulukkoviittaus

Hakumääritteiden arvot palautetaan liittyvän taulukon viittausobjekteina, joilla on seuraavat määritteet.

Määrite	Kuvaus
Tunniste	Viitatun taulukon GUID-tunnus merkkijonona. Esimerkki: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Viitatun taulukon looginen nimi Dataverse.
Name	Viitatun taulukon ensisijainen nimimäärite.

Huomautus

Muistiinpano on taulukko-objekti, jolla voi käyttää huomautustietueen määritteitä ja suhteita. Taulukko-objektin kaikkien määritteiden lisäksi muistiinpanolla on seuraavat lisämääritteet.

Määrite	Description
documentbody	Lataa muistiinpanon huomautustietueen documentbody-määritteen -tietueesta Base64-koodattuna merkkijonona. Koska kyseisen määritteen sisältö voi olla suuri, sitä ei ladata samalla kuin muut muistiinpanon määritteet; se on ladattava erikseen. Huomautus: documentbody-määritteen käytöllä saattaa olla heikentävä vaikutus mallin hahmontamisen suorituskykyyn, ja sitä tulee siis käyttää varoen. Tarjoa sen sijaan url-määritteen avulla linkki muistiinpanoon, jos mahdollista.
URL-osoite	Palauttaa portaalin sisäisen kommenttiliitteen käsittelijän URL-polun. Jos käyttäjällä on oikeudet ja muistiinpanoon on liitetty tiedosto, tähän URL-osoitteeseen lähetetty pyyntö lataa muistiinpanon liitetiedoston.

Muistiinpano

Lisäsuodattimet

Asetusjoukon arvo

Asetusjoukon tai valintaluettelon määritteiden arvot palautetaan liitetyn taulukon viittausobjekteina, joilla on seuraavat määritteet.

Määrite	Kuvaus
Selite	Asetusjoukon/valintaluettelon määritearvon lokalisoitu otsikko. Esimerkki: Aktiivinen
Arvo	Asetusjoukon/valintaluettelon määritearvon kokonaislukuarvo. Esimerkki: 0

Taulukon oikeudet

Taulukko-oikeuksien objekti antaa mahdollisuuden käyttää taulukon koottuja oikeuksien vahvistustuloksia.

Määrite	Description
can_append	Palauttaa Tosi-arvon, jos nykyisellä käyttäjällä on oikeus lisätä tietueita tämän tietueen suhteisiin. Muussa tapauksessa palauttaa arvon Epätosi.
can_append_to	Palauttaa Tosi-arvon, jos nykyisellä käyttäjällä on oikeus lisätä tämä tietue toisen taulukon suhteeseen. Muussa tapauksessa palauttaa arvon Epätosi.
can_create	Palauttaa Tosi-arvon, jos nykyisellä käyttäjällä on oikeus luoda uusia tämän taulukkotyypin tietueita. Muussa tapauksessa palauttaa arvon Epätosi.
can_delete	Palauttaa Tosi-arvon, jos nykyisellä käyttäjällä on oikeus poistaa tietue. Muussa tapauksessa palauttaa arvon Epätosi.
can_read	Palauttaa Tosi-arvon, jos nykyisellä käyttäjällä on oikeus lukea tietue. Muussa tapauksessa palauttaa arvon Epätosi.
can_write	Palauttaa Tosi-arvon, jos nykyisellä käyttäjällä on oikeus päivittää tietue. Muussa tapauksessa palauttaa arvon Epätosi.
rules_exist	Palauttaa Tosi-arvon, jos tämän objektin oikeuksien tulokset ovat seurausta erikseen määritetyistä oikeussäännöistä. Palauttaa Epätosi-arvon, jos ne ovat oletusarvoiset tuloksista, eikä oikeuksia ole erikseen määritetty.

Refleksiivinen suhde

Yritykset ladata entiteettien refleksiivisiä (eli itseensä viittaavia) suhteita palautetaan objekteina, joilla on seuraavat ominaisuudet.

Määrite	Description
is_reflexive	Palauttaa arvon Tosi. Tämän avulla voi testata, onko suhteen palauttama objektin refleksiivinen suhdeobjekti.
referenced	Palauttaa matriisin annetussa suhteessa viitatuista entiteeteistä.
referencing	Palauttaa annetun suhteen viittaavan taulukon. Palauttaa tyhjäarvon, jos viittaavaa taulukkoa ei ole. Jos suhde on monta-moneen (N:N), palauttaa matriisin viittaavista entiteeteistä.

entitylist

entitylist-objektia käytetään Dataverse-taulukkotunnisteissa. Sen avulla voi käyttää kaikkia annetun luettelon määritteitä.

Muistiinpano

Nykyiseen sivuun liittyvän luettelon hahmontaminen

Määritteet

Muistiinpano

kohteet

Määrite	Description
create_enabled	Palauttaa Tosi-arvon, jos uusien tietueiden luominen on määritetty luetteloon. Muussa tapauksessa palauttaa arvon Epätosi.
create_url	Palauttaa määritetyn URL-polun luettelon luontilinkille tai -painikkeelle.
detail_enabled	Palauttaa Tosi-arvon, jos luettelolle on määritetty yksittäisten tietojen lisätietonäkymä. Muussa tapauksessa palauttaa arvon Epätosi.
detail_id_parameter	Palauttaa kyselymerkkijonoparametrin nimen, jota käytetään tietuen tunnuksena tunnuksen lisätietonäkymän URL-osoitetta luotaessa. Lisätietoja Liquid-suodattimien käytöstä URL-osoitteiden muodostamisessa on kohdassa URL-suodattimet. Esimerkki: id
detail_label	Palauttaa määritetyn lokalisoidun otsikon luettelon lisätietonäkymän linkille tai painikkeille.
detail_url	Palauttaa määritetyn URL-polun luettelon lisätietonäkymän linkille tai painikkeille.
empty_list_text	Palauttaa määritetyn lokalisoitu tekstin, joka näytetään, kun luettelon näkymä ei palauta tuloksia.
enable_entity_permissions	Palauttaa Tosi-arvon, jos luettelon taulukko-oikeuksien suodatus on käytössä. Muussa tapauksessa palauttaa arvon Epätosi.
entity_logical_name	Palauttaa Dataverse -taulukon loogisen nimen tietueille, jotka näytetään tässä entiteettiluettelossa. Esimerkiksi contact
filter_account_attribute_name	Palauttaa määritteen loogisen nimen asiakashaulle, jota käytetään suodattamaan tulostietueet nykyisen portaalin käyttäjän pääasiakastilin perusteella. Esimerkki: accountid
filter_apply_label	Palauttaa määritetyn linkissä tai painikkeessa määrityn lokalisoidun otsikon, joka soveltaa tehokasta määritesuodatusta luettelon tuloksiin.
filter_definition	Palauttaa JSON-määritteen suodatinmäärityksen luettelolle. Lisätietoja Liquid-suodattimen metasuodattimien käyttämisestä tämän määrityksen käsittelemisessä on kohdassa Luettelon suodattimet .
filter_enabled	Palauttaa Tosi-arvon, jos määritteiden edistynyt suodatus on käytössä luettelossa. Muussa tapauksessa palauttaa arvon Epätosi.
filter_portal_user_attribute_name	Palauttaa määritteen loogisen nimen yhteyshenkilöhaulle, jota käytetään suodattamaan tulostietueet nykyisen portaalin käyttäjän yhteyshenkilön perusteella. Esimerkki: contactid
filter_website_attribute_name	Palauttaa määritteen loogisen nimen adx-verkkosivuston haulle , jota käytetään suodattamaan tulostietueet nykyisen portaalin käyttäjän sivuston perusteella. Esimerkki: adx_websiteid
kielikoodi	Palauttaa Dataverse kokonaislukumuotoisen kielikoodin, jolla valitaan luettelon kaikki lokalisoidut otsikot.
page_size	Palauttaa määritetyn tulossivun koon luettelolle.
primary_key_name	Palauttaa ensisijaisen avainmääritteen loogisen nimen tietueille, jotka näytetään tässä luettelossa.
search_enabled	Palauttaa Tosi-arvon, jos luettelon hakutoiminto on käytössä. Muussa tapauksessa palauttaa arvon Epätosi.
search_placeholder	Palauttaa lokalisoidun tekstin luettelon hakukentän paikkamerkille.
search_tooltip	Palauttaa lokalisoidun tekstin luettelon hakukentän työkaluvihjeelle.
näkymät	Palauttaa luettelon käytettävissä olevat näkymät luettelon näkymäobjekteina.
[määritteen looginen nimi]	Mitä tahansa luettelon (adx_entitylist) Dataverse-tietueen määritettä voi käyttää loogisen nimen perusteella samalla tavalla kuin taulukko-objektin kanssa. Esimerkki: {{ entitylist.adx_name }}

Luettelonäkymän määritteet

Määrite	Description
sarakkeet	Palauttaa näkymän sarakkeet luettelon näkymän sarakeobjekteina.
entity_logical_name	Palauttaa Dataverse -taulukon loogisen nimen näkymässä oleville tietueille. Esimerkiksi contact
Id	Palauttaa näkymän GUID-tunnuksen.
kielikoodi	Palauttaa Dataverse:n kokonaislukumuotoisen kielikoodin, jota käytetään valitsemaan kaikki näkymän lokalisoidut otsikot (sarakkeen otsikot jne.).
Name	Palauttaa näkymän Dataverse -näyttönimen.
primary_key_logical_name	Palauttaa Dataverse -taulukon ensisijaisen avaimen loogisen nimen näkymässä oleville tietueille. Esimerkki: contactid
sort_expression	Palauttaa näkymän oletusarvoisen lajittelulausekkeen. Esimerkki:, name ASC, createdon DESC

Luettelonäkymän sarakkeen määritteet

Määrite	Description
attribute_type	Palauttaa sarakkeen Dataverse -määritteen tyyppinimen merkkijonona. Esimerkki:, Valinta, Valintaluettelo, Merkkijono, Totuusarvo, Päivämäärä ja aika
logical_name	Palauttaa sarakkeen Dataverse -määritteen loogisen nimen. Esimerkki: createdon
Nimi	Palauttaa sarakkeen lokalisoidun Dataverse -näyttönimen. Esimerkki: Luotu
sort_ascending	Palauttaa lajittelulausekkeen merkkijonon, jolla sarake lajitellaan nousevaan järjestykseen. Esimerkki: createdon ASC
sort_descending	Palauttaa lajittelulausekkeen merkkijonon, jolla sarake lajitellaan laskevaan järjestykseen. Esimerkki: createdon DESC
sort_disabled	Palauttaa Tosi-arvon, jos sarakkeen lajittelu ei ole käytössä. Muussa tapauksessa palauttaa arvon Epätosi.
sort_enabled	Palauttaa Tosi-arvon, jos sarakkeen lajittelu on käytössä. Muussa tapauksessa palauttaa arvon Epätosi.
width	Palauttaa sarakkeen määritetyn leveyden kuvapisteinä.

entityview

Entityview-objektia käytetään entityview-tunnisteen kanssa ja se tarjoaa pääsyn näkymän metatietoihin sekä tulosarvojen tietueisiin.

Määritteet

Määrite	Kuvaus
sarakkeet	Palauttaa näkymän sarakkeet, kuten taulukkonäkymän sarakeobjektit.
entity_permission_denied	Palauttaa Tosi-arvon, jos tulosarvojen tarkasteluoikeudet on estetty käyttäjän riittämättömien taulukko-oikeuksien vuoksi. Palauttaa Epätosi-arvon jos tulosarvojen lukuoikeus myönnettiin.
entity_logical_name	Näkymän tulostietueiden Dataverse -taulukon looginen nimi. Esimerkiksi contact
first_page	Tulosarvojen ensimmäisen sivun sivunumero. Tämä on 1, ellei tuloksia ollut, jolloin se on tyhjäarvo.
Id	Sen Dataverse -näkymän GUID-tunnus, joka määrittää tämän entityview-tunnisteen.
kielikoodi	Dataverse:n kokonaislukumuotoinen kielikoodi, jota käytetään nykyisen näkymän lokalisoitujen otsikoiden lataamiseen.
last_page	Tulosarvojen viimeisen sivun sivunumero. Jos haku ei tuottanut tuloksia, tämä arvo on tyhjä.
name	Dataverse:n näkymän nimi, joka määrittää tämän entityview-tunnisteen. Se voi olla esimerkiksi Aktiiviset yhteyshenkilöt.
next_page	Tulosarvojen seuraavan sivun sivunumero. Jos tuloksia ei ole seuraavalla sivulla, tämä arvo on tyhjä.
Sivu	Tulosarvojen nykyisen sivun sivunumero.
pages	Palauttaa matriisin sivunumeroista, joka sisältää kaikki nykyisen näkymän tulosten sivut.
page_size	Nykyisen näkymän palautettujen tulosten sivukohtainen määrä.
previous_page	Tulosarvojen seuraavan sivun sivunumero. Jos tuloksia ei ole edellisellä sivulla, tämä arvo on tyhjä.
primary_key_logical_name	Näkymän tulostaulukon perusavaimen määritteen looginen nimi Dataverse. Esimerkiksi contactid.
tietueet	Näkymän tulostietueiden nykyinen sivu taulukko-objekteina.
sort_expression	Näkymän oletusarvoinen lajittelulauseke. Esimerkiksi nameASC, createdon DESC.
total_pages	Näkymän tulossivujen kokonaismäärä.
total_records	Näkymän tulosten kokonaismäärä (kaikilla sivuilla).

tapahtumat

Mahdollistaa tapahtumien noutamisen ja näyttämisen. Events-objektin avulla voit valita tietyn tapahtuman tai kaikki tapahtumat.

events-objekti

Events-objektin avulla voit käyttää mitä tahansa portaalin tapahtumaa tai kaikkia portaalin tapahtumia (tapahtumasta huolimatta).

Events-objektilla on seuraavat määritteet:

Määrite	Description
esiintymän jälkeen	Palauttaa eventoccurancessobject-objektin, joka sisältää kaikki tapahtuman esiintymät portaalissa.
[tapahtuman nimi tai tunnus]	Voit käyttää mitä tahansa tapahtumaa sen nimen tai tunnuksen perusteella. {% assign event = events["Event Name"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

event-objekti

Event-objektin avulla voit käsitellä yhtä tapahtumaa sekä sen aikatauluja ja esiintymiä.

Event-objektilla on seuraavat määritteet:

Määrite	Kuvaus
esiintymän jälkeen	Palauttaa eventoccurrencesobject-objektin, joka sisältää kaikki tapahtuman esiintymät.
Nimi	Tapahtuman nimi.
URL-osoite	Tapahtuman URL-osoite.

eventoccurences-objekti

Eventoccurrences-objektin avulla voit käyttää tapahtumaesiintymien objektikokoelmaa. Voit järjestää tapahtuman esiintymät ja määrittää päivämääräalueen, jolta esiintymät noudetaan, sekä saavuttaa sivutuksen Liquid-suodattimien avulla:

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

Myös seuraava vaihtoehto on mahdollinen:

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

Seuraavat määritteet liittyvät eventoccurrences-objektiin

Määrite	Kuvaus
Kaikki	Palauttaa kaikki kokoelman eventoccurance-objektit.

eventoccurence-objekti

Edustaa yhden tapahtuman esiintymää. Seuraavat ovat tähän liittyvät määritteet:

Määrite	Description
url-osoite	Esiintymän URL-osoite.
is_all_day_event	Onko kyseessä koko päivän kestävä tapahtuma?
start_time	Tapahtuman aloitusaika.
end_time	Tapahtuman päättymisaika.

forloop

Sisältää ominaisuuksia, jotka ovat hyödyllisiä for-silmukkalohkossa.

Muistiinpano

forloop-objektia voi käyttää vain for-tunnisteen kanssa.

Koodi

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

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

{% endif %}

{% endfor %}

Tuloste

This is the first child page!

This is child page number 2.

This is child page number 3.

Määritteet

Määrite	Kuvaus
Ensimmäinen	Palauttaa Tosi-arvon, jos se on silmukan ensimmäinen iteraatio. Palauttaa Epätosi-arvon, jos se ei ole ensimmäinen iteraatio.
index	Nykyisen kohteen sijainti kokoelmassa, jossa ensimmäisen kohteen sijainti on 1.
index0	Nykyisen kohteen sijainti kokoelmassa, jossa ensimmäisen kohteen sijainti on 0.
Viimeinen	Palauttaa Tosi-arvon, jos se on silmukan viimeinen iteraatio. Palauttaa Epätosi-arvon, jos se ei ole viimeinen iteraatio.
length	Palauttaa silmukan iteraatioiden määrän ߝ kokoelman nimikkeiden määrä, joita iteroidaan.
rindex	Silmukassa jäljellä olevien kohteiden määrä (length - index), jossa 1 on viimeisen kohteen indeksi.
rindex0	Silmukassa jäljellä olevien kohteiden määrä (length - index), jossa 0 on viimeisen kohteen indeksi.

forums

Mahdollistaa keskustelupalstojen ja keskustelupalstakirjoitusten noutamisen ja näyttämisen. Mahdollisuus käyttää liquidia keskustelupalstan tietojen hahmontamiseen koskee myös viestejä, mutta uuden viestin tai kommenttiketjun luontia varten on käytettävä monivaiheisten ASP.NET-lomakkeiden sivumallia, joka sisältää kyseisen toiminnallisuuden (kuten oletusarvoiset Keskustelupalstan kommenttiketju- ja Keskustelupalstan viestisivu -mallit).

Voit valita keskustelupalstan tai palstan kommenttiketjuja forums-objektin avulla:

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

forums-objekti

forums-objektin avulla voit käyttää mitä tahansa portaalin keskustelupalstaa tai kaikkia portaalin palstojen kommenttiketjuja (palstasta huolimatta).

Forum-objektin avulla voit käsitellä yhtä keskustelupalstaa ja kyseisen palstan kommenttiketjuja.

forumthreads-objektin avulla voit käyttää forumthread-objektikokoelmaa. Voit järjestää ja sivuttaa palstan kommenttiketjuja sekä käyttää Liquid-suodatusta.

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

Yksittäinen keskustelupalstan kommenttiketju

forumposts-objektin avulla voit käyttää forumpost-objektikokoelmaa.

Määritteet

Määrite	Kuvaus
threads	Palauttaa forumthreads-objektin, joka sisältää kaikki portaalin forumthread-objektit.
Kaikki	Palauttaa portaalin forum-objektit. Huomaa, että website.forums on myös vastaava.
thread_count	Palauttaa koko sivuston kommenttiketjujen määrän kokonaislukuna.
post_count	Palauttaa portaalin viestien kokonaismäärän kokonaislukuna.
[keskustelupalstan nimi tai tunnus]	Voit käyttää mitä tahansa keskustelupalstaa sen nimen tai tunnuksen perusteella. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

forum-objekti

Määritteet

Muistiinpano

kohteet

Määrite	Description
threads	Palauttaa forumthreads-objektin, joka sisältää kaikki keskustelupalstan kommenttiketjut.
Name	Keskustelupalstan nimi.
thread_count	Palauttaa keskustelupalstan kommenttiketjujen määrän kokonaislukuna.
post_count	Palauttaa koko sivuston viestien määrän kokonaislukuna.

forumthreads-objekti

Määritteet

Määrite	Kuvaus
Kaikki	Palauttaa kaikki kokoelman forumthread-objektit.

forumthread-objekti

Määritteet

Muistiinpano

kohteet

Määrite	Description
posts	Palauttaa forumposts-objektin, joka sisältää kaikki kommenttiketjun viestit.
author	Palauttaa kommenttiketjun tekijän (joka on yksinkertaisesti yhteyshenkilötaulukon objekti).
latest_post	Palauttaa kommenttiketjun uusimman viestin.
first_post	Palauttaa kommenttiketjun ensimmäisen viestin.
post_count	Palauttaa kommenttiketjun viestin määrän kokonaislukuna.
is_answered	Onko kommenttiketjussa vastaus?
is_sticky	Onko kommenttiketju kiinnitetty?

forumposts-objekti

Määritteet

Määrite	Kuvaus
Kaikki	Palauttaa kaikki kokoelman forumthread-objektit.

Yksittäinen keskustelupalstan viesti

Määritteet

Muistiinpano

kohteet

Määrite	Description
author	Palauttaa kirjoituksen tekijän (eli yksinkertaisesti yhteyshenkilötaulukon objektin).
sisältö	Viestin sisältö.
is_answer	Onko viesti kommenttiketjun vastaus?

tietämys

Sen avulla voi käyttää Dataverse tietoartikkelin ja luokan taulukkotietueita artikkeleiden ja luokkien hahmontamiseen portaalissa.

Määritteet

Määrite	Kuvaus
artikkelit	Palauttaa artikkelit-objektin, joka sisältää artikkeliobjekteja portaalissa käytettäville knowledgearticle-taulukkotietueille.
luokat	Palauttaa luokat-objektin, joka sisältää luokkaobjekteja portaalissa käytettäville luokkataulukkotietueille.

articles-objekti

Articles-objektin avulla voit käyttää artikkeliobjektikokoelmaa. Voit järjestää ja sivuttaa artikkeleja myös käyttämällä Liquid-suodatusta.

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

Määritteet

Määrite	Kuvaus
suosituimmat	Palauttaa artikkelin objektien eniten näkymiä sisältävän kokoelman. {% assign popular_articles = knowledge.articles.popular %}
äskettäiset	Palauttaa artikkelin objektien kokoelman, jota on päivitetty kaikkein äskettäin. {% assign recent_articles = knowledge.articles.recent %}
ensimmäiset	Palauttaa artikkelin objektien parhaiten arvostellun sisältävän kokoelman. {% assign top_articles = knowledge.articles.top %}

Suodattimet

Seuraavat suodattimet voivat hyväksyä sivun koon ja kielen mukaan valinnaisen parametrin. Ensimmäisenä parametrina on numero tai tietueet, joita haetaan. Sivun oletuskoko on 5. Toinen parametri on kielikoodi, jos haluat hakea artikkeleita tietyllä kielellä. Suodattimia voi yhdistää muiden kanssa muilla Liquid-suodattimilla.

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

Määrite	Description
suosituimmat	Palauttaa artikkelin objektien eniten näkymiä sisältävän kokoelman. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
äskettäiset	Palauttaa artikkelin objektien kokoelman, jota on päivitetty kaikkein äskettäin. {% assign recent_articles = knowledge.articles \| recent: 5 %}
ensimmäiset	Palauttaa artikkelin objektien parhaiten arvostellun sisältävän kokoelman. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

categories-objekti

Categories-objektin avulla voit käyttää luokka-objektikokoelmaa. Voit järjestää luokkia ja sivuttaa kirjoitukset myös käyttämällä Liquid-suodatusta.

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

Määritteet

Määrite	Kuvaus
äskettäiset	Palauttaa luokkaobjektien kokoelman, jota on päivitetty kaikkein äskettäin.
top_level	Palauttaa luokkaobjektien kokoelman, jolla ei ole ylätason luokkaa.

Suodattimet

Seuraavat suodattimet voivat hyväksyä sivun koon mukaisen valinnaisen parametrin. Sivun oletuskoko on 5. Suodattimia voi yhdistää muiden kanssa muilla Liquid-suodattimilla.

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

Määrite	Description
äskettäiset	Palauttaa luokkaobjektien kokoelman, jota on päivitetty kaikkein äskettäin. Voit tarjota parametrit {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level	Palauttaa luokkaobjektien kokoelman, jolla ei ole ylätason luokkaa. {% assign root_categories = knowledge.categories \| top_level %}

article Object

Artikkeli-objektin avulla voit käyttää yksittäistä knowledgearticlea näyttämään kyseisen artikkelin tiedot portaalissa.

Määritteet

Artikkeli on entiteetti-objekti, jolla on kaikki samat määritteet seuraavien määritteiden lisäksi:

Määrite	Description
article_public_number	Artikkelin julkinen numero.
comment_count	Kokonaislukuna ilmaistu kirjoitukselle annettujen kommenttien määrä.
sisältö	Artikkelin sisältö.
current_user_can_comment	Palauttaa totuusarvon, joka ilmaisee, voiko käyttäjä lisätä kommentteja artikkeliin.
is_rating_enabled	Palauttaa totuusarvon, joka ilmaisee, onko artikkelin luokitus otettu käyttöön.
keywords	Artikkelin avainsanat.
Nimi	Artikkelin otsikon vaihtoehtoinen tunnus.
rating	Artikkelin desimaaliluokitusarvo.
title	Artikkelin otsikko.
view_count	Artikkelin katselukertojen määrä kokonaislukuna.

category Object

Luokkaobjektin avulla voit käyttää yksittäistä luokkaa näyttämään tietonsa portaalissa.

Määritteet

Luokka on entiteetti-objekti, jolla on kaikki samat määritteet seuraavien määritteiden lisäksi:

Määrite	Description
categorynumber	Luokan numero.
Nimi	Luokan otsikon vaihtoehtoinen tunnus.
otsikko	Luokan otsikko.

language

Antaa nykyisen kielen nimen ja kielikoodin, jos usean kielen tuki on käytössä.

Määritteet

Määrite	Kuvaus
url-osoite	Nykyisen pyynnön URL-osoite, jonka etuliite on nykyinen kielikoodi.
url_substitution	Nykyisen pyynnön URL-osoite, jonka etuliite on nykyinen kielikoodi ohittaen sivun tulosvälimuistin.
Nimi	Nykyisen kielen otsikko.
koodi	Kielen kielikoodi.

Esimerkiksi kielipudotusvalikon verkkomalli näyttää käytettävissä olevat kielet oletusarvoisesti tämän Liquid-objektin avulla, kun käytettävissä on useita kieliä.

loki

Tekijät voivat lisätä Liquid-koodiinsa lokilausekkeita. Kun Power Pages -sivusto on käynnissä, tekijän Liquid-koodilla lisäämät lokit näytetään Power Pagesin kehittäjien työkalujen laajennuksessa. Nämä tekijän upottamat lokit näytetään kehittäjien työkalujen laajennuksessa, kun diagnostiikka-asetus on käytössä.

Seuraavaa syntaksia voidaan käyttää Liwuid-koodissa mukautettujen sanomien kirjaamiseen:

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

Lokimääritteet

Määrite	Description
loki	Liquid-objektin nimi
message	Merkkijono, joka edustaa kirjattavia mukautettuja sanomia
taso	Sanoman kirjaaminen muodossa Tieto, Varoitus tai Virhe

Esimerkki:

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

sivun

Viittaa nykyiseen portaalin pyyntösivuun. Tässä objektissa yhdistetään sitemap-määritteet ja nykyisen pyynnön entities (yleensä sivusto).

Sivuobjekti mahdollistaa pääsyn esimerkiksi nykyisen sivun navigointipolkuun tai otsikkoon sekä muihin taustalla olevan Dataverse -tietueen määritteisiin ja liittyviin entiteetteihin.

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

Sivun määritteet

Muistiinpano

kohteet

Määrite	Description
breadcrumbs	Palauttaa sivun navigointipolun sivustokartan solmuobjekteille, alkaen sivustokartan pääsolmusta ja päättyen päätasoon.
children	Palauttaa sivun sivustokartan alitason solmuobjektit.
parent	Palauttaa sivun sivustokartan ylätason solmuobjektit. Jos sivu on kotisivu, päätaso on tyhjäarvoinen.
otsikko	Sivun otsikko.
url-osoite	Sivun URL-osoite.
[määritteen tai suhteen nimi]	Voit käyttää mitä tahansa sivun pohjana olevaa Dataverse -tietuetta loogisen nimen perusteella. {{ page.createdon }} {% assign attribute_name = 'name' %} {{ page[attribute_name] }} Useimmat taulukkomääritteiden arvot yhdistetään suoraan Liquid-tyypit-objektiin: kahden asetuksen kentät yhdistyvät totuusarvoihin, tekstikentät merkkijonoihin, numero- ja valuuttakentät lukuihin sekä päivämäärä ja aikakentät päivämääräobjekteihin. Jotkin määritetyypit palautetaan kuitenkin objekteina: Valintakentät (liitetty taulukkoviittaus) palautetaan liitettyjen taulukon viiteobjekteina. Asetusjoukko/valintaluettelokentät palautetaan asetusjoukon arvo-objekteina. Voit myös ladata minkä tahansa liittyvän entiteetin suhderakenteen nimen mukaan. {{ page.adx_webpage_entitylist.adx_name }} Siinä tapauksessa, että suhde on refleksiivinen (eli itseensä viittaava), palautetaan entiteetit-objekti. (Muussa tapauksessa tulos olisi epäselvä.){{ page.adx_webpage_webpage.referencing.adx_name }} Huomautus: Jos lataat suuren määrän liittyviä entiteettejä tai käytät suurta määrää suhteita yhdessä mallissa, mallin hahmontamisen suorituskyky voi heikentyä. Vältä liittyvien entiteettien lataamista jokaisessa matriisin kohteessa silmukan sisällä. Entiteettikokoelmien lataamiseen kannattaa käyttää mahdollisuuksien mukaan Dataverse-taulukkotunnisteita.

polls

Mahdollistaa kyselyn noutamisen ja näyttämisen.

polls-objektin avulla voit valita tietyn kyselyn tai kyselysijoittelun:

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

Kyselyiden määritteet

Määrite	Description
placements	Palauttaa pollplacements-objektin.
[kyselyn nimi tai tunnus]	Voit käyttää mitä tahansa kyselyä sen nimen tai tunnuksen perusteella. {% assign poll = polls[Poll Name] %} {% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Kyselysijoittelujen määritteet

Määrite	Description
[kyselysijoittelun nimi tai tunnus]	Voit käyttää mitä tahansa kyselysijoittelua sen nimen tai tunnuksen perusteella.{% assign placement = polls.placements[Placement Name or Id] %} {% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Kyselysijoittelun määritteet

Muistiinpano

kohteet

Määrite	Description
Name	Palauttaa kyselysijoittelun nimikentän.
placement_url	URL-osoite, jonka avulla mallin täysin hahmontama kyselysijoittelu voidaan noutaa.
polls	Palauttaa kokoelman sijoitteluun liittyviä kyselyobjekteja. Iterointitunnisteita ja matriisin suodattimia voi käyttää tässä kokoelmassa.
random_url	URL-osoite, jonka avulla mallin täysin hahmontamasta kyselysijoittelusta voidaan noutaa satunnainen kysely.
submit_url	URL-osoite, johon valmis kysely lähetetään.

Kyselyn määritteet

Muistiinpano

kohteet

Määrite	Description
has_user_voted	Palauttaa arvon tosi, jos nykyinen käyttäjä (kirjautunut tai anonyymi) on jo antanut äänensä tähän kyselyyn.
Nimi	Palauttaa kyselyn nimikentän.
options	Palauttaa kokoelman kyselyyn liittyviä poll option -objekteja. Iterointitunnisteita ja entiteettejä voi käyttää tässä kokoelmassa.
poll_url	URL-osoite, jonka avulla mallin täysin hahmontama kysely voidaan noutaa.
-kysymys	Palauttaa kyselyn Kysymys-kentän.
submit_button_label	Palauttaa merkkijonon, jonka avulla voidaan kyselyn Lähetä-painikkeen otsikko voidaan ohittaa.
submit_url	URL-osoite, johon valmis kysely lähetetään.
user_selected_option	Palauttaa (jo äänestäneen) käyttäjän valitseman polloption-objektin.
votes	Palauttaa kyselyyn taulukoitujen äänien määrän.

Kyselyasetuksen määritteet

Muistiinpano

kohteet

Määrite	Description
answer	Palauttaa kyselyn Vastaus-kentän.
percentage	Palauttaa kyselyn äänten prosenttiosuuden vaihtoehdolle kokonaislukuna väliltä 0–100.
votes	Palauttaa vaihtoehdolle taulukoitujen äänien määrän.

pyyntö

Sisältää tietoja nykyisestä HTTP-pyynnöstä.

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

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

Muistiinpano

• Voit luoda URL-osoitteet dynaamisesti Liquidin URL-suodattimien avulla.
• request.url-arvona käytetty URL-osoite voi olla mikä tahansa arvo ja se tallennetaan välimuistiin seuraavia pyyntöjä varten. Oikean request.url-arvon voi varmistaa esimerkiksi käyttämällä korvaustunnistetta, osittaista URL-osoitetta, kuten ~{WebFile-polku}, tai portaalin URL-osoitteen tallentamista sivustoasetuksiin.
• Power Pagesin julkaisuversiosta 9.3.8.x eteenpäin on oletusarvoisesti escape Liquid -suodatin, jota käyttäjien on pakko käyttää, ja request Liquid -objekteja. Lisätietoja tämän oletusmäärityksen poistamisesta käytöstä ja näiden Liquid-objektien sallimisesta ilman Liquid-ohjausmerkkisuodatinta on kohdassa Portaalisivuston asetukset – Site/EnableDefaultHtmlEncoding.

Määritteet

Määrite	Kuvaus
params	Nykyisen pyynnön nimettyjen parametrien arvot. params on yhdistelmä URL-osoitteen kyselymerkkijonon parametreja, lomakkeen lähetysparametreja ja evästeitä.
Path	Nykyisen pyynnön URL-osoitteen polku. /profile/
path_and_query	Nykyisen pyynnön URL-osoitteen polku ja kysely. /profile/?foo=1&bar=something
kysely	Nykyisen pyynnön URL-osoitteen kyselyosa. ?foo=1&bar=something
url-osoite	Nykyisen pyynnön täysi URL-osoite. https://www.example.com/profile/?foo=1&bar=something

searchindex

Searchindex-objektia käytetään Dataverse-taulukkotunnisteissa ja antaa mahdollisuuden käyttää kyselyn tuloksia.

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

Määritteet

Määrite	Description
approximate_total_hits	Palauttaa indeksin kyselyä vastaavien osumien arvioidun määrän. Tämä luku on vain arvio johtuen hakuindeksin toiminnasta suojaavan suodatuksen ja muiden suunnittelunäkökohtien osalta, eikä se välttämättä vastaa täysin tulosten todellista määrää, joka on käyttäjän käytettävissä tietyissä tilanteissa.
Sivu	Palauttaa nykyisen kyselyn sivunumeron.
page_size	Palauttaa nykyisen kyselyn sivun enimmäiskoon. Jos haluat nykyiseltä sivulta tulosten todellisen määrän (koska tämä voi olla pienempi kuin määritetty sivun enimmäiskoko), käytä results.size-objektia.
Tulokset	Palauttaa kyselyn tulossivun hakuindeksin tulosobjekteina.

Hakuindeksin tulokset

Määrite	Kuvaus
entiteetti	Tuloksen taustalla olevat entiteetit-objektit.
fragment	Asiaankuuluva lyhyt teksti tuloksesta, jossa kyselyn ehtoja vastaavat sanat ovat korostettuna <em>-HTML-tunnisteen avulla. Tietyntyyppiset kyselyt eivät tue korostettuja palasia, kuten sumeat- (~) ja yleismerkkikyselyt (*). Tämän ominaisuuden arvo on tyhjä näissä tapauksissa.
Id	Tuloksen pohjalla olevan tietueen Dataverse -taulukon tunnus merkkijonona. Esimerkki: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Tuloksen pohjalla olevan tietueen Dataverse -entiteetin looginen nimi. Esimerkki: adx_webpage
luku	Tuloksen järjestysnumero sivuilla, alkaen numerosta 1. Esimerkiksi kun sivun koko on 10, ensimmäinen tulos toisella tulossivulla on 11.
score	Tuloksen Lucene-arvo liukulukuna. Tulokset palautetaan tämän arvon mukaisesti järjestettynä.
otsikko	Tuloksen otsikko.
url-osoite	Tuloksen URL-osoite. Tämä on yleensä – mutta ei välttämättä – absoluuttinen polku nykyiseen sovellukseen täydellisen URL-osoitteen sijasta. Esimerkiksi: /articles/article1/

asetukset

Sallii minkä tahansa sivustoasetuksen lataamisen nimen perusteella. Jos nimeä vastaavaa asetusta ei löydy, tyhjäarvo palautetaan.

Muistiinpano

Asetukset palautetaan merkkijonoina, mutta voit muuntaa ne muiksi tyypeiksi käyttämällä tyyppisuodattimia.

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

Muistiinpano

Sivuston otsikon ja ensisijaisen siirtymispalkin hahmontaminen

sivustokartta

Antaa oikeudet portaalin sivustokartan tarkasteluun.

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

Sivustokartan määritteet

Määrite	Kuvaus
Nykyinen	Palauttaa nykyisen sivun sivustokarttasolmun objektin.
Päätaso	Palauttaa sivuston pääsivun sivustokarttasolmun objektin.

Sivustokartan solmun määritteet

Määrite	Kuvaus
Navigointipolku	Palauttaa solmun navigointipolun sivustokartan solmuobjekteille, alkaen sivustokartan pääsolmusta ja päättyen päätasoon.
Alikohteet	Palauttaa solmun sivustokartan alasolmuobjektit.
Kuvaus	Solmun kuvaus/yhteenveto. (Tämä kenttä voi sisältää HTML-koodia.)
Entity	Palauttaa solmun pohjana olevat entiteetit. Jos solmulla ei ole pohjana olevaa taulukkoa, tämä arvo on tyhjäarvo.
is_sitemap_ancestor	Palautusarvo on Tosi, jos sivustokartan solmu on nykyistä solmua ylemmällä tasolla, muuten palautusarvo on Epätosi.
is_sitemap_current	Palautusarvo on Tosi, jos sivustokartan solmu on nykyinen solmu, muuten palautusarvo on Epätosi.
Päätaso	Palauttaa solmun sivustokartan ylätason solmuobjektit. Jos solmu on juurisolmu, pääsolmu on tyhjäarvo.
Title	Solmun otsikko.
url-osoite	Solmun URL-osoite.

Sivustomerkinnät

Mahdollistaa minkä tahansa sivustomerkinnän lataamisen nimen perusteella. Jos sivustomerkintä on olemassa, sitemarker-objekti palautetaan. Jos nimeä vastaavaa sivustomerkintää ei löydy, tyhjäarvo palautetaan.

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

Muistiinpano

Sivuston otsikon ja ensisijaisen siirtymispalkin hahmontaminen

Sivustomerkinnän määritteet

Määrite	Description
url-osoite	Sivustomerkinnän kohteen URL-osoite.
[määritteen looginen nimi]	Voit käyttää mitä tahansa sivustomerkinnän kohteena olevaa Dataverse -tietuetta loogisen nimen perusteella. Esimerkki: {{ sitemarker.adx_name }}

snippets

Mahdollistaa minkä tahansa sisältökatkelman lataamisen nimen perusteella. Jos nimeä vastaavaa koodikatkelmaa ei löydy, tyhjäarvo palautetaan.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Sisältää ominaisuudet, jotka ovat hyödyllisiä Iterointitunnisteita-silmukan lohkossa.

Muistiinpano

Tablerowloop-objektia voi käyttää vain iterointitunnisteet-tunnisteen kanssa.

Määritteet

Määrite	Kuvaus
Col	Palauttaa nykyisen rivin indeksin aloittaen kohdasta a.
col0	Palauttaa nykyisen rivin indeksin aloittaen kohdasta 0.
col_first	Palauttaa Tosi-arvon, jos nykyinen sarake on rivin ensimmäinen sarake, ja Epätosi-arvon, jos se ei ole.
col_last	Palauttaa Tosi-arvon, jos nykyinen sarake on rivin viimeinen sarake, ja Epätosi-arvon, jos se ei ole.
Ensimmäinen	Palauttaa Tosi-arvon, jos se on silmukan ensimmäinen iteraatio. Palauttaa Epätosi-arvon, jos se ei ole ensimmäinen iteraatio.
Indeksi	Nykyisen kohteen sijainti kokoelmassa, jossa ensimmäisen kohteen sijainti on 1.
index0	Nykyisen kohteen sijainti kokoelmassa, jossa ensimmäisen kohteen sijainti on 0.
Viimeinen	Palauttaa Tosi-arvon, jos se on silmukan viimeinen iteraatio. Palauttaa Epätosi-arvon, jos se ei ole viimeinen iteraatio.
Pituus	Palauttaa silmukan iteraatioiden määrän ߝ kokoelman nimikkeiden määrä, joita iteroidaan.
Rindex	Silmukassa jäljellä olevien kohteiden määrä (length - index), jossa 1 on viimeisen kohteen indeksi.
rindex0	Silmukassa jäljellä olevien kohteiden määrä (length - index), jossa 0 on viimeisen kohteen indeksi.

User

Viittaa portaalin nykyiseen käyttäjään ja sallii kaikkien taustalla olevan Dataverse:n yhteyshenkilötietueen määritteiden käytön. Jos kirjautunutta käyttäjää ei ole, tämän muuttuja on tyhjäarvo.

Käyttäjä on entiteetti-objekti.

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

Muistiinpano

Power Pagesin julkaisuversiosta 9.3.8.x eteenpäin on oletusarvoisesti escape Liquid -suodatin, jota käyttäjien on pakko käyttää, ja request Liquid -objekteja. Lisätietoja tämän oletusmäärityksen poistamisesta käytöstä ja näiden Liquid-objektien sallimisesta ilman Liquid-ohjausmerkkisuodatinta on kohdassa Portaalisivuston asetukset – Site/EnableDefaultHtmlEncoding.

Määritteet

Sen lisäksi että sillä on kaikki entiteetti-objektin määritteet, käyttäjällä on seuraavat määritteet.

Määrite	Kuvaus
roolit	Palauttaa roolit, joihin käyttäjä kuuluu, kuten matriisi. {% if user.roles contains 'Administrators' %} User is an administrator. {% endif %} Huomautus: voit myös käyttää has_role-suodatinta yksittäisten roolien jäsenyyden testaamiseen.
basic_badges_url	Palauttaa palvelun url-osoitteen, jolla käyttäjän tunnukset haetaan. Käyttäjän tunnusten hahmonnusta on sisällettävä tunniste, jossa on määritteet data-badge ja data-uri. Nykyisen käyttäjän tunnusten hahmontaminen: <div data-badge data-uri='{{user.basic_badges_url }}'></div> Käyttäjän tunnusten hahmontaminen tunnuksen mukaan (muuttuja userid): `<div data-badge data-uri='{{user.basic_badges_url

Verkkolinkit

Mahdollistaa minkä tahansa verkkolinkin lataamisen nimen tai tunnuksen perusteella.

Jos verkkolinkkijoukko on olemassa, palautetaan verkkolinkkijoukon objekti. Jos verkkolinkkijoukkoa ei löydy nimen tai tunnuksen perusteella, palautetaan tyhjäarvo.

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

Muistiinpano

Sivuston otsikon ja ensisijaisen siirtymispalkin hahmontaminen |

Verkkolinkkijoukkojen määritteet

Muistiinpano

Verkkolinkkijoukko on entiteetti-objekti, jolla on kaikki samat määritteet seuraavien määritteiden lisäksi:

Määrite	Description
Kopioi	Verkkolinkkijoukon HTML-kopio.
Nimi	Verkkolinkkijoukon nimi.
Ammattinimike	Verkkolinkkijoukon otsikko.
Verkkolinkit	Verkkolinkkijoukkoon liittyvä verkkolinkkiobjektien matriisi.
[määritteen looginen nimi]	Voit käyttää mitä tahansa verkkolinkkijoukon Dataverse -tietuetta loogisen nimen perusteella. Esimerkki: {{ weblinkset.createdon }}

Verkkolinkkien määritteet

Muistiinpano

Verkkolinkki on entiteetti-objekti, jolla on kaikki samat määritteet seuraavien määritteiden lisäksi:

Määrite	Description
Description	Verkkolinkin HTML-kuvaus.
display_image_only	Totuusarvo, joka ilmaisee, tuleeko verkkolinkki näyttää vain kuvana ilman linkin tekstiä.
display_page_child_links	Totuusarvo, joka ilmaisee, näytetäänkö verkkolinkissä linkitetyn sivun sitemap-alisivut alilinkkeinä.
Image	Linkin verkkolinkin kuvaobjekti. Tämä määrite on tyhjä, jos kuvaa ei ole.
is_external	Totuusarvo, joka ilmaisee, onko verkkolinkin kohteen URL-osoite ulkoisessa sivustossa (sisäisen portaalisivun sijaan).
is_sitemap_ancestor	Palautusarvo on Tosi, jos verkkolinkin URL-osoite viittaa sivustokartan nykyistä solmua ylemmälle tasolle. Muuten palautusarvo on Epätosi.
is_sitemap_current	Palautusarvo on Tosi, jos verkkolinkin URL-osoite viittaa sivustokartan nykyiseen solmuun. Muuten palautusarvo on Epätosi.
Nimi	Verkkolinkin nimi/otsikko.
Nofollow	Totuusarvo, joka ilmaisee, tulisiko verkkolinkki merkitä näin: rel=nofollow.
open_in_new_window	Totuusarvo, joka ilmaisee, avautuuko verkkolinkki uuteen selainikkunaan/-välilehteen valittaessa.
Työkaluvihje	Verkkolinkin työkaluvihjeen teksti.
URL-osoite	Verkkolinkin URL-osoite.
Verkkolinkit	Verkkolinkkijoukkoon liittyvä verkkolinkkien aliobjektien matriisi.
[määritteen looginen nimi]	Voit käyttää mitä tahansa verkkolinkin Dataverse -tietuetta loogisen nimen perusteella. Esimerkki: {{ weblink.createdon }}

Verkkolinkin kuvien määritteet

alternate_text	Kuvan vaihtoehtoinen teksti.
Height	Kokonaisluku, joka sisältää kuvan korkeuden. Jos korkeusarvoa ei ole annettu, määritteen arvo on tyhjä.
url-osoite	Kuvan URL-osoite.
Width	Kokonaisluku, joka sisältää kuvan leveyden. Jos leveysarvoa ei ole annettu, määritteen arvo on tyhjä.

sivusto

Viittaa portaalin sivustoon ja sallii portaalin kaikkien Dataverse-sivuston (adx_website) määritteiden käytön.

Muistiinpano

Sivusto on entiteetti-objekti, jossa on kaikki samat määritteet.

Koodi

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

Tuloste

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

Määritteet

Seuraavassa taulukossa on esitetty tämän tunnisteen määritteet, joita voidaan käyttää korvaamaan oletusarvot välimuistin välttämiseksi.

Oletus	Korvaava (välttää välimuistin)	Esimerkiksi
sign_in_url	sign_in_url_substitution	Oletus: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F Korvaava (välttää välimuistin): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F (Tässä esimerkissä "substitute-page" korvaa oletusarvoisen välimuistissa olevan URL-osoitteen.)
sign_out_url	sign_out_url_substitution	Oletus: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F Korvaava (välttää välimuistin): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F (Tässä esimerkissä "substitute-page" korvaa oletusarvoisen välimuistissa olevan URL-osoitteen.)

Katso myös

Liquid-tyypit
Liquid-tunnisteet
Liquid Filters