Käytettävissä olevat Liquid-objektit
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>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<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:
{{ 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
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ä.
Määritteet
Huomautus
| 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
| 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
| 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
| 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
| 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:
{{ 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
| 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
| 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
| 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 %}
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 %}
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 %}
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).
Palaute
Tulossa pian: Vuoden 2024 aikana poistamme asteittain GitHub Issuesin käytöstä sisällön palautemekanismina ja korvaamme sen uudella palautejärjestelmällä. Lisätietoja on täällä: https://aka.ms/ContentUserFeedback.
Lähetä ja näytä palaute kohteelle