Jaa

Käytettävissä olevat Liquid-objektit

  • Artikkeli

Huomautus

Power Apps -portaaleja kutsutaan 12. lokakuuta 2022 alkaen nimellä Power Pages. Lisätietoja: Microsoft Power Pages on nyt yleisesti saatavilla (blogi)
Siirrämme ja yhdistämme Power Apps -portaalien dokumentaation pian Power Pagesin dokumentaatioon.

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.

Objekti Kuvaus
kohteet Antaa mahdollisuuden ladata minkä tahansa Power Apps -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 Power Apps -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 Power Apps: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 Power Apps -sivuston (adx_website) portaalitietueen määritteiden käytön. Lisätietoja: sivusto

ads

Tarjoaa mahdollisuuden käyttää ja hahmontaa mainoksia.

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 Kuvaus
sijoittelut 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 Kuvaus
[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 alla mainitut määritteet.

Määrite Kuvaus
Mainokset Palauttaa kokoelman sijoitteluun liittyviä mainosobjekteja. Iterointitunnisteita ja matriisin suodattimia voi käyttää tässä kokoelmassa.
Nimi 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

Huomautus

Mainos on taulukko-objekti, jolla on kaikki samat määritteet alla olevien määritteiden lisäksi.

Määrite Kuvaus
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).
Nimi 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 Kuvaus
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.
width Palauttaa kuvan leveyden kuvapisteinä

blogs

Tarjoaa mahdollisuuden käyttää ja hahmontaa blogeja ja blogikirjoituksia.

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

Huomautus

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.

Huomautus

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 Power Apps -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ää Power Apps -taulukkotietueen määritteitä.

Määrite Kuvaus
Tunniste Taulukon GUID-tunnus merkkijonona. Esimerkki: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Taulukon looginen Power Apps -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 Apps -portaalien 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 Power Apps -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 Power Apps.
Nimi 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 Kuvaus
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.

Huomautus

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 Kuvaus
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 Kuvaus
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 Power Apps Dataverse -taulukkotunnisteissa. Sen avulla voi käyttää kaikkia annetun luettelon määritteitä.

Huomautus

Nykyiseen sivuun liittyvän luettelon hahmontaminen

Määritteet

Huomautus

kohteet

Määrite Kuvaus
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 Power Apps -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_website-haulle , jota käytetään suodattamaan tulostietueet nykyisen portaalin käyttäjän sivuston perusteella. Esimerkki: adx_websiteid
language_code Palauttaa Power Apps 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) Power Apps -tietueen määritettä voi käyttää loogisen nimen perusteella samalla tavalla kuin taulukko-objektin kanssa. Esimerkiksi, {{ entitylist.adx_name }}

Luettelonäkymän määritteet

Määrite Kuvaus
sarakkeet Palauttaa näkymän sarakkeet luettelon näkymän sarakeobjekteina.
entity_logical_name Palauttaa Power Apps -taulukon loogisen nimen näkymässä oleville tietueille. Esimerkiksi contact
Tunniste Palauttaa näkymän GUID-tunnuksen.
language_code Palauttaa Power Apps:n kokonaislukumuotoisen kielikoodin, jota käytetään valitsemaan kaikki näkymän lokalisoidut otsikot (sarakkeen otsikot jne.).
Nimi Palauttaa näkymän Power Apps -näyttönimen.
primary_key_logical_name Palauttaa Power Apps -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 Kuvaus
attribute_type Palauttaa sarakkeen Power Apps -määritteen tyyppinimen merkkijonona. Esimerkki:, Valinta, Valintaluettelo, Merkkijono, Totuusarvo, Päivämäärä ja aika
logical_name Palauttaa sarakkeen Power Apps -määritteen loogisen nimen. Esimerkki: createdon
Nimi Palauttaa sarakkeen lokalisoidun Power Apps -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 Power Apps -taulukon looginen nimi. Esimerkiksi contact
first_page Tulosarvojen ensimmäisen sivun sivunumero. Tämä on 1, ellei tuloksia ollut, jolloin se on tyhjäarvo.
Tunniste Sen Power Apps -näkymän GUID-tunnus, joka määrittää tämän entityview-tunnisteen.
language_code Power Apps: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ä on tyhjäarvo.
Nimi Power Apps: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ä on tyhjäarvo.
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ä on tyhjäarvo.
primary_key_logical_name Näkymän tulostaulukon perusavaimen määritteen looginen nimi Power Apps. 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

Tarjoaa mahdollisuuden käyttää ja hahmontaa tapahtumia. 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 Kuvaus
occurences 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] %}

huomaa, että

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

on myös mahdollista.

Seuraavat määritteet liittyvät eventoccurrences-objektiin

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

eventoccurence-objekti

Edustaa yhden tapahtuman esiintymää. Liittyvät ominaisuudet ovat seuraavat:

Määrite Kuvaus
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.

Huomautus

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

Tarjoaa mahdollisuuden käyttää ja hahmontaa keskustelupalstoja ja keskustelupalstan kommenttiketjuja. 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

Huomautus

kohteet

Määrite Description
threads Palauttaa forumthreads-objektin, joka sisältää kaikki keskustelupalstan kommenttiketjut.
Nimi 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

Huomautus

entities

Määrite Kuvaus
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

Huomautus

entities

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

tietämys

Sen avulla voi käyttää Power Apps 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 Kuvaus
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 Kuvaus
ä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 alla olevien määritteiden lisäksi.

Määrite Kuvaus
article_public_number Artikkelin julkinen numero.
comment_count Kokonaislukuna ilmaistu kirjoitukselle annettujen kommenttien määrä.
content 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 alla olevien määritteiden lisäksi.

Määrite Kuvaus
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ä.

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

Huomautus

entities

Määrite Kuvaus
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äarvo.
title Sivun otsikko.
URL-osoite Sivun URL-osoite.
[määritteen tai suhteen nimi] Voit käyttää mitä tahansa sivun pohjana olevaa Power Apps -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 Power Apps Dataverse -taulukkotunnisteita.

polls

Tarjoaa mahdollisuuden käyttää ja hahmontaa kyselyjä.

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

Huomautus

kohteet

Määrite Kuvaus
Nimi 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

Huomautus

entities

Määrite Kuvaus
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

Huomautus

entities

Määrite Kuvaus
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>

Huomautus

  • 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 Apps -portaalien julkaisuversiosta 9.3.8.x 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ä.
Polku 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 Power Apps 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 Kuvaus
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 nolla näissä tapauksissa.
Tunniste Tuloksen pohjalla olevan tietueen Power Apps -taulukon tunnus merkkijonona. Esimerkki: 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Tuloksen pohjalla olevan tietueen Power Apps -entiteetin looginen nimi. Esimerkki: adx_webpage
Numero 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ä.
title 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.

Huomautus

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

Huomautus

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.)
Entiteetti 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.
Ammattinimike 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 %}

Huomautus

Sivuston otsikon ja ensisijaisen siirtymispalkin hahmontaminen

Sivustomerkinnän määritteet

Määrite Kuvaus
URL-osoite Sivustomerkinnän kohteen URL-osoite.
[määritteen looginen nimi] Voit käyttää mitä tahansa sivustomerkinnän kohteena olevaa Power Apps -tietuetta loogisen nimen perusteella. Esimerkiksi {{ 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.

Huomautus

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.

käyttäjä

Viittaa portaalin nykyiseen käyttäjään ja sallii kaikkien taustalla olevan Power Apps: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 %}

Huomautus

Power Apps -portaalien julkaisuversiosta 9.3.8.x 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 %}

Huomautus

Sivuston otsikon ja ensisijaisen siirtymispalkin hahmontaminen |

Verkkolinkkijoukkojen määritteet

Huomautus

Verkkolinkkijoukko on entiteetti-objekti, jolla on kaikki samat määritteet alla olevien määritteiden lisäksi.

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

Verkkolinkkien määritteet

Huomautus

Verkkolinkki on entiteetti-objekti, jolla on kaikki samat määritteet alla olevien määritteiden lisäksi.

Määrite Kuvaus
Kuvaus 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ä.
Kuva 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 Power Apps -tietuetta loogisen nimen perusteella. Esimerkki: {{ weblink.createdon }}

Verkkolinkin kuvien määritteet

alternate_text Kuvan vaihtoehtoinen teksti.
Korkeus Kokonaisluku, joka sisältää kuvan korkeuden. Jos korkeusarvoa ei ole annettu, määritteen arvo on nolla.
URL-osoite Kuvan URL-osoite.
Leveys Kokonaisluku, joka sisältää kuvan leveyden. Jos leveysarvoa ei ole annettu, määritteen arvo on nolla.

sivusto

Viittaa portaalin sivustoon ja sallii portaalin kaikkien Power Apps:n sivuston (adx_website) määritteiden käytön.

Huomautus

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

Huomautus

Voitko kertoa meille dokumentaatiota koskevan kielimäärityksesi? Vastaa lyhyeen kyselyyn. (Huomaa, että tämä kysely on englanninkielinen.)

Kyselyyn vastaaminen kestää noin seitsemän minuuttia. Henkilökohtaisia tietoja ei kerätä (tietosuojatiedot).