Razpoložljivi predmeti Liquid
Predmeti Liquid vključujejo atribute za izpis dinamične vsebine na strani. Predmet strani ima na primer atribut »title«, ki se lahko uporabi za zapis naslova trenutne strani.
Za dostop do atributa predmeta po imenu uporabite piko (.). Za upodobitev atributa predmeta v predlogi ga obdajte z znakoma {{ and }}.
Pomembno
Če se želite izogniti potencialnim težavam s skriptnim izvajanjem na več mestih (XSS), za kodiranje podatkov s HTML vedno, ko uporabljate predmete Liquid za branje podatkov uporabnika, ki niso vredni zaupanja, uporabite ubežni filter.
{{ page.title }}
Do atributov predmeta lahko dostopate tudi tako, da uporabite ime niza in []. Ta oblika zapisa je uporabna v primerih, v katerih je zahtevani atribut določen dinamično ali ime atributa med drugim vsebuje znake, presledke ali posebne znake itd., ki bi vrnili neveljavno vrednost, če bi uporabili piko (.) v sintaksi.
{{ page[title] }}
{% assign attribute_name = Name with spaces %}
{{ object[attribute_name] }}
Naslednji predmeti se lahko uporabljajo in so dostopni kjerkoli v kateri koli predlogi.
Predmet | Opis |
---|---|
entities | Omogoča, da naložite tabelo Microsoft Dataverse po ID-ju. Več informacij: entitete |
zdaj | Predmet datum/ura, ki se navezuje na trenutni čas UTC v času upodabljanja predloge. Opomba: Ta vrednost se shrani v predpomnilnik spletne aplikacije portala in se ne osveži vsakič. Več informacij: Filtri datumov |
stran | Navezuje se na trenutno stran z zahtevo portala. Predmet strani omogoča dostop do elementov, kot so sledi poti za trenutno stran, naslov ali URL trenutne strani in kateri koli drugi atributi ali povezane entitete temeljnih zapisov programa Dataverse. Več informacij: stran |
parametri | Priročna bližnjica za request.params. Več informacij: zahteva |
request | Vključuje podatke o trenutni zahtevi HTTP. Več informacij: zahteva |
nastavitve | Omogoča, da naložite poljubne nastavitve mesta po imenu. Več informacij: nastavitve |
zemljevid mesta | Omogoča dostop do zemljevida mesta portala. Več informacij: zemljevid mesta |
oznake spletnih mest | Omogoča, da naložite poljubne oznake spletnih mest po imenu. Več informacij: oznake spletnih mest |
snippets | Omogoča, da naložite poljubni izrezek vsebine po imenu. Več informacij: izrezki |
uporabnik | Navezuje se na trenutnega uporabnika portala in omogoča dostop do vseh atributov temeljnega zapisa o stiku v programu Dataverse. Če noben uporabnik ni prijavljen, bo ta spremenljivka nična. Več informacij: uporabnik |
spletne povezave | Omogoča, da naložite poljubni nabor spletnih povezav po imenu ali ID-ju. Več informacij: spletne povezave |
spletno mesto | Navezuje se na zapis spletnega mesta portala in omogoča dostop do vseh atributov zapisa spletnega mesta storitve Dataverse (adx_website) za portal. Več informacij: spletno mesto |
ads
Omogoča dostop za upodabljanje oglasa.
Predmet oglasov omogoča izbiro določenega oglasa ali postavitve oglasa:
<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>
Atributi oglasov
Atribut | Opis |
---|---|
placements | Vrne predmet »adplacements«. |
[ime ali id oglasa] | Za vsak oglas je omogočen dostop prek imena ali lastnosti ID-ja. {% assign ad = ads[Ad Name] %} {% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Atributi postavitev oglasov
Atribut | Opis |
---|---|
[ime ali id postavitve oglasa] | Za vsako postavitev oglasa je omogočen dostop prek imena ali lastnosti ID-ja.{% assign placement = ads.placements[Placement Name or Id] %} {% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %} |
Atributi postavitve oglasov
Umestitev oglasa je predmet tabele z enakimi splošnimi atributi in spodaj navedenimi atributi.
Atribut | Opis |
---|---|
Oglasi | Vrne zbirko predmetov oglasa, povezanih s postavitvijo. S to zbirko se lahko uporabljajo oznake za ponovitev in filtri polj. |
Imenu | Vrne polje z imenom za postavitev oglasa. |
placement_url | URL, ki se lahko uporablja za pridobivanje postavitve oglasa, v celoti upodobljenega s predlogo. |
random_url | URL, ki se lahko uporablja za pridobivanje naključnega oglasa iz postavitve, v celoti upodobljene s predlogo. |
Atributi oglasa
opomba,
Oglas je predmet tabele z vsemi enakimi atributi poleg spodaj navedenih atributov.
Atribut | Opis |
---|---|
ad_url | URL, ki se lahko uporablja za pridobivanje oglasa, v celoti upodobljenega s predlogo. |
Copy | Vrne polje s kopijo za oglas. |
image | Vrne slikovni predmet (če obstaja) za oglas. |
Imenu | Vrne polje z imenom za oglas. |
open_in_new_window | Vrne vrednost »true«, če se mora URL, ki ga določa redirect_url, odpreti v novem oknu. |
redirect_url | URL, na katerega bo usmerjen uporabnik, ki izbere oglas. |
Atributi slike oglasa
Atribut | Opis |
---|---|
alternate_text | Vrne besedilo, ki je namenjeno za prikaz v nadomestnem atributu oznake. |
height | Vrne višino v slikovnih pikah za sliko. |
url | Vrne URL vira slike. |
width | Vrne širino v slikovnih pikah za sliko. |
spletni dnevniki
Zagotavlja omogočen dostop do in upodabljanje spletnih dnevnikov in objav v spletnih dnevnikih.
Predmet spletnih dnevnikov omogoča izbiro določenega spletnega dnevnika ali objave v spletnem dnevniku.
{% 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>
Predmet »blogs«
Predmet spletnih dnevnikov omogoča dostop do katerega koli določenega spletnega dnevnika v portalu ali do vseh objav v spletnih dnevnikih v portalu.
Spodnja tabela pojasnjuje atribute, povezane s predmetom spletnih dnevnikov.
Atribut | Opis |
---|---|
posts | Vrne predmet objav v spletnem dnevniku, ki vsebuje vse objave v spletnem dnevniku na portalu. |
[ime ali id spletnega dnevnika] | Do vsakega spletnega dnevnika lahko dostopate prek njegovih lastnosti imena ali ID-ja. |
{% assign blog = blogs["Blog Name"] %}
{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Predmet »blog«
Predmet »blog« vam omogoča delo z enim spletnim dnevnikom in dostop do objav za ta spletni dnevnik.
Spodnja tabela pojasnjuje različne atribute, povezane s predmetom spletnega dnevnika.
Atribut | Opis |
---|---|
posts | Vrne predmet objav v spletnem dnevniku, ki vsebuje vse objave v spletnem dnevniku za spletni dnevnik. |
Ime | Ime spletnega dnevnika. |
title | Naslov spletnega dnevnika. |
url | URL spletnega dnevnika. |
Predmet »blogposts«
Predmet objav v spletnem dnevniku omogoča dostop do zbirke predmetov objav v spletnih dnevnikih. V objavah v spletnem dnevniku lahko uporabljate filtre Liquid ter objave tudi razvrstite in zagotovite oštevilčevanje strani:
{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}
Druge razpoložljive možnosti:
blogs.posts.all
(za pridobitev vseh objav v spletnem dnevniku)blogs.posts | from\_index: 0 | take: 2
Spodnja tabela pojasnjuje različne atribute, povezane s predmetom objav v spletnem dnevniku.
Atribut | Opis |
---|---|
Vsa | Vrne vse predmete objav v spletnem dnevniku v zbirki. |
Predmet »blogpost«
Se nanaša na eno objavo v spletnem dnevniku.
Spodnja tabela pojasnjuje različne atribute, povezane s predmetom objave v spletnem dnevniku.
Atribut | Opis |
---|---|
url | URL objave. |
vsebina | Vrne polje vsebine za objavo. |
author | Vrne avtorje za objavo (ki je preprosto predmet tabele stika). |
naslov | Naslov objave. |
comment_count | Vrne celoštevilsko vrednost za število vseh komentarjev za dano objavo. |
publish_date | Datum, ko je bila objava objavljena. |
entities
Pozor
Če se želite izogniti potencialnim težavam s skriptnim izvajanjem na več mestih (XSS), za kodiranje podatkov niza s HTML vedno, ko uporabljate predmet Liquid za entitete za branje podatkov uporabnika, ki niso vredni zaupanja, uporabite ubežni filter.
opomba,
Nekatere konvencije poimenovanja v okolju Dataverse so se spremenile, npr. entitete Dataverse se zdaj imenujejo tabele. Spremembe imena ne veljajo za predmete Liquid. Entitete predmetov Liquid se še vedno imenujejo entitete.
Omogoča, da naložite tabelo Dataverse po ID-ju. Če tabela obstaja, bo vrnjen predmet tabele. Če tabela s podanim ID-jem ni najdena, bo vrnjena vrednost null.
{% assign account = entities.account['936DA01F-9ABD-4d9d-80C7-02AF85C822A8'] %}
{% if account %}
{{ account.name | escape }} ({{ account.statecode.label | escape }})
{% endif %}
{% assign entity_logical_name = 'contact' %}
{% assign contact = entities[entity_logical_name][request.params.contactid] %}
{% if contact %}
{{ contact.fullname | escape }} ({{ contact.parentcustomerid.name | escape }})
{% endif %}
Entity
Predmet entitete zagotavlja dostop do atributov zapisa tabele Dataverse.
Atribut | Opis |
---|---|
ID | ID GUID-a tabele, kot niz. Na primer »936DA01F-9ABD-4d9d-80C7-02AF85C822A8«. |
logical_name | Logično ime Dataverse tabele. |
Beležke | Naloži vse opombe (annotation), povezane s tabelo, razvrščene od najstarejše do najnovejše (createdon). Opombe so vrnjene kot predmeti opomb. |
dovoljenja | Naloži rezultate izjav dovoljenj za tabelo za tabelo. Rezultati so vrnjeni kot predmet dovoljenj. |
url | Vrne pot URL sistema za upravljanje vsebin portalov Power Pages za tabelo. Če tabela nima veljavnega URL-ja na trenutnem spletnem mestu, je vrnjena vrednost »null«. Na splošno to vrne samo vrednost za določene vrste tabel, ki so bile integrirane v portal CMS, razen če ste prilagodili ponudnika URL-jev v programu. |
[ime atributa ali odnosa] | Do vseh atributov tabele Dataverse lahko dostopate po logičnem imenu. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Vrednosti večine atributov tabel se neposredno preslikajo v vrste Liquid: polja z dvema možnostma se preslikajo v logične vrednosti, besedilna polja v nize, numerična polja/polja valut v številke, polja datuma/časa v datumske predmete. Toda nekatere vrste atributov so vrnjene kot predmeti:
{{ page.adx_webpage_entitylist.adx_name }} V primeru, da je odnos povraten (tj. samoreferenčen), bo vrnjen predmet povratnega odnosa. (Sicer bi bil rezultat dvoumen.){{ page.adx_webpage_webpage.referencing.adx_name }} Opomba: nalaganje večjega števila povezanih entitet ali dostop do večjega števila odnosov v eni predlogi lahko negativno vpliva na učinkovitost upodabljanja predloge. Izogibajte se nalaganju entitet za vsak element v polju, v zanki. Kjer je mogoče, za nalaganje zbirk entitet uporabite oznake tabele za Dataverse. |
Povezani sklic tabele
Vrednosti atributa iskanja so vrnjene kot predmeti reference povezane tabele, z naslednjimi atributi.
Atribut | Opis |
---|---|
ID | ID GUID-a povezane tabele, kot niz. Na primer »936DA01F-9ABD-4d9d-80C7-02AF85C822A8«. |
logical_name | Logično ime Dataverse referenčne tabele. |
Imenu | Primarni atribut imena za tabelo, na katero se sklicuje. |
Opomba
Opomba je predmet tabele, ki zagotavlja dostop do atributov in odnosov za zapis pripombe. Poleg vseh atributov predmeta tabele ima opomba naslednje dodatne atribute.
Atribut | Opis |
---|---|
documentbody | Naloži atribut »documentbody« zapisa pripombe za opombo kot niz, kodiran v obliki Base64. Vsebina tega atributa je lahko velika, zato se ne naloži z ostalimi atributi opombe, ampak samo na zahtevo. Opomba: uporaba atributa »documentbody« lahko negativno vpliva na učinkovitost upodabljanja predloge, zato je potrebna previdnost. Če je mogoče, za zagotavljanje povezave do priloge v obliki opombe raje uporabite atribut »url«. |
Spletni naslov | Vrne pot URL-ja za vgrajeno rutino za obravnavo prilog opomb na portalu. Če ima uporabnik dovoljenje in ima opomba priloženo datoteko, bo zahteva temu URL-ju prenesla prilogo datoteke opombe. |
opomba,
Vrednost nabora možnosti
Vrednosti nabora možnosti/seznama aktualnih podatkov so vrnjeni kot predmeti reference povezane tabele, z naslednjimi atributi.
Atribut | Opis |
---|---|
Oznaka | Lokalizirana oznaka vrednosti nabora možnosti/seznama aktualnih podatkov. Na primer »Dejavno«. |
Vrednost | Celoštevilska vrednost vrednosti nabora možnosti/seznama aktualnih podatkov. Na primer »0«. |
Dovoljenja za tabelo
Predmet dovoljenj za tabelo zagotavlja dostop do združevalnih rezultatov izjav dovoljenj za tabelo.
Atribut | Opis |
---|---|
can_append | Vrne vrednost »true«, če ima trenutni uporabnik dovoljenje za prilaganje zapisov k odnosom tega zapisa. V nasprotnem primeru vrne vrednost »false«. |
can_append_to | Vrne vrednost »true«, če ima trenutni uporabnik dovoljenje za prilaganje tega zapisa k odnosu druge tabele. V nasprotnem primeru vrne vrednost »false«. |
can_create | Vrne vrednost »true«, če ima trenutni uporabnik dovoljenje za ustvarjanje novih zapisov te vrste tabele. V nasprotnem primeru vrne vrednost »false«. |
can_delete | Vrne vrednost »true«, če ima trenutni uporabnik dovoljenje za brisanje tega zapisa. V nasprotnem primeru vrne vrednost »false«. |
can_read | Vrne vrednost »true«, če ima trenutni uporabnik dovoljenje za branje tega zapisa. V nasprotnem primeru vrne vrednost »false«. |
can_write | Vrne vrednost »true«, če ima trenutni uporabnik dovoljenje za posodobitev tega zapisa. V nasprotnem primeru vrne vrednost »false«. |
rules_exist | Vrne vrednost »true«, če so rezultati dovoljenja, ki jih predstavlja ta predmet, rezultat izrecno določenih pravil dovoljenja. Vrne vrednost »false«, če so to privzeti rezultati, ko ni izrecno določenih dovoljenj. |
Povraten odnos
Poskusi naložiti povratne (tj. samoreferenčne) odnose za entitete, ki so vrnjene kot predmeti z naslednjimi atributi.
Atribut | Opis |
---|---|
is_reflexive | Vrne vrednost »true«. Se lahko uporabi za preskus, ali je predmet, ki ga vrne odnos, predmet povratnega odnosa. |
referenced | Vrne polje entitet, na katere se sklicuje, za dani odnos. |
referencing | Vrne referenčno tabelo za dani odnos. Vrne vrednost »null«, če referenčna tabela ne obstaja. Če je odnos »mnogo proti mnogo« (N:N), vrne polje entitet, ki se sklicujejo. |
Seznam entitet »entitylist«
Objekt entitylist se uporablja znotraj oznak tabele storitve Dataverse. Omogoča dostop do vseh atributov danega seznama.
Atributi
opomba,
Atribut | Opis |
---|---|
create_enabled | Vrne vrednost »true«, če je ustvarjanje novih zapisov konfigurirano za seznam. V nasprotnem primeru vrne vrednost »false«. |
create_url | Vrne konfigurirano pot URL za povezavo/gumb za ustvarjanje za seznam. |
detail_enabled | Vrne vrednost »true«, če je podroben prikaz za posamezne zapise konfiguriran za seznam. V nasprotnem primeru vrne vrednost »false«. |
detail_id_parameter | Vrne ime parametra niza poizvedbe za uporabo za ID zapisa pri izdelovanju URL-ja podrobnega prikaza zapisa. Za podrobnosti o uporabi filtrov Liquid pri izdelavi URL-jev glejte Filtri URL. Na primer »ID«. |
detail_label | Vrne konfigurirano lokalizirano oznako za povezave/gumbe podrobnega pogleda za seznam. |
detail_url | Vrne konfigurirano pot URL za povezave/gumbe podrobnega pogleda za seznam. |
empty_list_text | Vrne konfigurirano lokalizirano besedilo, ki bo prikazano, ko pogled seznama ne vrne rezultatov. |
enable_entity_permissions | Vrne vrednost »true«, če je za ta seznam omogočeno filtriranje po dovoljenjih za tabele. V nasprotnem primeru vrne vrednost »false«. |
entity_logical_name | Vrne logično ime tabele Dataverse za zapise, ki so prikazani na tem seznamu. Na primer »contact« |
filter_account_attribute_name | Vrne logično ime atributa za iskanje kupca, ki bo uporabljeno za filtriranje zapisov rezultatov po trenutnem nadrejenem računu uporabnika portala. Na primer »accountid«. |
filter_apply_label | Vrne konfigurirano lokalizirano oznako za uporabo pri povezavi/gumbu, ki uporabi napredno filtriranje atributov pri rezultatih seznama. |
filter_definition | Vrne definicijo filtra atributov v obliki zapisa JSON za seznam. Za podrobnosti o uporabi filtra Liquid »metafilters« za obdelavo te definicije glejte Filtri seznama. |
filter_enabled | Vrne vrednost »true«, če je za seznam omogočeno napredno filtriranje atributov. V nasprotnem primeru vrne vrednost »false«. |
filter_portal_user_attribute_name | Vrne logično ime atributa za iskanje stika, ki bo uporabljeno za filtriranje zapisov rezultatov po trenutnem stiku uporabnika portala. Na primer »contactid«. |
filter_website_attribute_name | Vrne logično ime atributa za iskanje za »adx_website«, ki bo uporabljeno za filtriranje zapisov rezultatov po trenutnemu spletnemu mestu portala. Na primer »adx_websiteid« |
language_code | Vrne celoštevilsko jezikovno kodo v programu Dataverse, ki bo uporabljena pri izbiri vseh lokaliziranih oznak za ta seznam. |
page_size | Vrne konfigurirano velikost strani rezultatov za seznam. |
primary_key_name | Vrne logično ime atributa primarnega ključa za zapise, ki so prikazani v tem seznamu. |
search_enabled | Vrne vrednost »true«, če je za ta seznam omogočeno iskanje. V nasprotnem primeru vrne vrednost »false«. |
search_placeholder | Vrne konfigurirano lokalizirano besedilo za označbo mesta polja za iskanje v seznamu. |
search_tooltip | Vrne konfigurirano lokalizirano besedilo za opis orodja polja za iskanje v seznamu. |
pogledi | Vrne poglede, ki so na voljo za seznam, kot predmete pogleda seznama. |
[logično ime atributa] | Dostopate lahko do katerega koli atributa zapisa na seznamu (adx_entitylist) storitve Dataverse po logičnem imenu na enak način, kot dostopate do predmeta tabele. Na primer {{ entitylist.adx_name }}. |
Atributi pogleda seznama
Atribut | Opis |
---|---|
stolpci | Vrne stolpce pogleda kot predmete stolpca pogleda seznama. |
entity_logical_name | Vrne logično ime tabele Dataverse za zapise, vključene v pogled. Na primer »contact« |
ID | Vrne ID identifikatorja GUID pogleda. |
language_code | Vrne celoštevilsko jezikovno kodo v programu Dataverse, ki bo uporabljena pri izbiri vseh lokaliziranih oznak (glav stolpca itd.) za pogled. |
Imenu | Vrne prikazano ime pogleda v programu Dataverse. |
primary_key_logical_name | Vrne logično ime primarnega ključa tabele Dataverse za zapise, vključene v pogled. Na primer »contactid«. |
sort_expression | Vrne privzeti izraz razvrščanja za pogled. Na primer »name ASC«, »createdon DESC«. |
Atributi stolpčnega pogleda seznama
Atribut | Opis |
---|---|
attribute_type | Vrne ime vrste atributa Dataverse za stolpec v obliki niza. Na primer Lookup, Picklist, String, Boolean, DateTime. |
logical_name | Vrne logično ime atributa Dataverse za stolpec. Na primer »createdon«. |
Ime | Vrne lokalizirano prikazano ime za stolpec v programu Dataverse. Na primer »Ustvarjeno dne«. |
sort_ascending | Vrne niz izraza razvrščanja za razvrščanje stolpca po naraščajočem vrstnem redu. Na primer »createdon ASC«. |
sort_descending | Vrne niz izraza razvrščanja za razvrščanje stolpca po padajočem vrstnem redu. Na primer »createdon DESC«. |
sort_disabled | Vrne vrednost »true«, če je razvrščanje za stolpec onemogočeno. V nasprotnem primeru vrne vrednost »false«. |
sort_enabled | Vrne vrednost »true«, če je razvrščanje za stolpec omogočeno. V nasprotnem primeru vrne vrednost »false«. |
width | Vrne konfigurirano širino stolpca v slikovnih pikah. |
entityview
Predmet »entityview« se uporablja v oznaki »entityview« ter omogoča dostop do metapodatkov za pogled in tudi ogled zapisov rezultatov.
Atributi
Atribut | Opis |
---|---|
stolpci | Vrne stolpce v pogledu kot predmete stolpca pogleda tabele. |
entity_permission_denied | Vrne vrednost »true«, če je bil dostop do rezultatov pogleda zavrnjen zaradi nezadostnih dovoljenj za tabele za trenutnega uporabnika. Vrne vrednost »false«, če je bil dostop za branje do rezultatov pogleda odobren. |
entity_logical_name | Logično ime tabele Dataverse za zapise z rezultati pogleda. Na primer »contact« |
first_page | Številka strani prve strani rezultatov pogleda. Uporabi se vrednost 1, razen če ni bilo vrnjenih nobenih rezultatov. V tem primeru bo vrednost »null«. |
Id | GUID ID pogleda programa Dataverse, ki določa ta predmet pogleda entitete. |
language_code | Celoštevilska jezikovna koda v programu Dataverse, ki se uporablja za nalaganje lokaliziranih oznak za trenutni pogled. |
last_page | Številka strani zadnje strani rezultatov pogleda. Če ni bilo vrnjenih nobenih rezultatov, se uporabi vrednost »null«. |
name | Ime pogleda programa Dataverse, ki določa ta pogled entitete, na primer »Dejavni stiki«. |
next_page | Številka strani naslednje strani rezultatov pogleda. Če ni nobene naslednje strani z rezultati, se uporabi vrednost »null«. |
Stran | Številka strani trenutne strani rezultatov pogleda. |
pages | Vrne niz številk strani, ki vključuje vse strani rezultatov za trenutni pogled. |
page_size | Število rezultatov, vrnjenih na stran, za trenutni pogled. |
previous_page | Številka strani naslednje strani rezultatov pogleda. Če ni nobene prejšnje strani z rezultati, se uporabi vrednost »null«. |
primary_key_logical_name | Logično ime programa Dataverse za atribut primarnega ključa, ki se navezuje na tabelo rezultata za ta pogled. Na primer »contactid«. |
zapisi | Trenutna stran z zapisi rezultatov za pogled kot predmetov tabele. |
sort_expression | Privzeti izraz razvrščanja za pogled. Na primer »nameASC«, »createdon DESC«. |
total_pages | Skupno število strani z rezultati za pogled. |
total_records | Skupno število rezultatov za pogled (prek vseh strani). |
events
Omogoča dostop do dogodkov in upodabljanje dogodkov. Predmet »events« omogoča izbiranje določenega dogodka ali vseh dogodkov.
Predmet »events«
Predmet »events« omogoča dostop do katerega koli določenega dogodka v portalu ali do vseh dogodkov v portalu (ne glede na dogodek).
Predmet dogodkov ima te atribute:
Atribut | Opis |
---|---|
occurences | Vrne predmet »eventoccurancessobject«, ki vsebuje vse pojavitve dogodka v portalu |
[ime ali id dogodka] | Do vsakega dogodka lahko dostopate prek njegovih lastnosti imena ali ID-ja. {% assign event = events["Event Name"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Predmet »event«
Predmet »event« omogoča delo z enim samim dogodkom, pri čemer lahko dostopate do urnikov in pojavitev za ta dogodek.
Predmet »event« ima te atribute:
Atribut | Opis |
---|---|
ponovitvah | Vrne predmet »eventoccurrencesobject«, ki vsebuje vse pojavitve za dogodek. |
ime | Ime dogodka. |
url | URL dogodka. |
Predmet »eventoccurences«
Predmet »eventoccurrences« omogoča dostop do zbirke predmetov pojavitev dogodka. Z uporabo filtrov Liquid lahko pojavitve dogodka razvrstite in določite datumski obseg za pojavitve, ki jih želite pridobiti, ter dosežete tudi oštevilčevanje strani.
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
upoštevajte, da
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
je možno tudi to.
Spodnji atributi so povezani s predmetom »eventoccurrences«
Atribut | Opis |
---|---|
Vsa | Vrne vse predmete »eventoccurance« v zbirki. |
Predmet »eventoccurence«
Predstavlja eno pojavitev dogodka. Spodaj so navedeni povezani atributi:
Atribut | Opis |
---|---|
url | Spletni naslov pojavitve. |
is_all_day_event | Ali je to celodnevni dogodek? |
start_time | Začetni čas dogodka. |
end_time | Končni čas dogodka. |
forloop
Vsebuje lastnosti, uporabne znotraj bloka zanke for.
opomba,
»forloop« se lahko uporablja samo v oznaki for.
Koda
{% for child in page.children %}
{% if forloop.first %}
This is the first child page!
{% else %}
This is child page number {{ forloop.index }}.
{% endif %}
{% endfor %}
Rezultat
This is the first child page!
This is child page number 2.
This is child page number 3.
Atributi
Atribut | Opis |
---|---|
Prvi | Vrne vrednost »true«, če gre za prvo ponovitev zanke. Vrne vrednost »false«, če ne gre za prvo ponovitev zanke. |
index | Položaj trenutnega elementa v zbirki, kjer ima prvi element položaj 1. |
index0 | Položaj trenutnega elementa v zbirki, kjer ima prvi element položaj 0. |
Zadnja | Vrne vrednost »true«, če gre za zadnjo ponovitev zanke. Vrne vrednost »false«, če ne gre za zadnjo ponovitev zanke. |
length | Vrne število ponovitev za zanko ߝ število elementov v zbirki, ki se ponavlja. |
rindex | Število elementov, ki ostanejo v zanki (dolžina – kazalo), kjer je 1 kazalo zadnjega elementa. |
rindex0 | Število elementov, ki ostanejo v zanki (dolžina – kazalo), kjer je 0 kazalo zadnjega elementa. |
forumi
Zagotavlja omogočen dostop do forumov in njihovo ustvarjanje ter niti foruma. Možnost uporabe jezika Liquid za upodabljanje podatkov foruma sicer zajema objave, vendar morate za ustvarjanje nove objave ali niti uporabiti predlogo strani za obrazce ASP.NET z več koraki in vgrajeno omenjeno funkcijo (kot so privzeta nit foruma in predloge strani za objave v forumu).
Predmet forumov omogoča, da izberete forum ali niti foruma:
<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>
Predmet foruma
Predmet foruma omogoča dostop do katerega koli določenega foruma na portalu ali do vseh niti foruma na portalu (ne glede na forum).
Predmet »forum« omogoča delo z enim forumom in dostop do niti za ta forum.
Predmet niti foruma omogoča dostop do zbirke predmetov niti foruma. Niti foruma lahko naročite ter tako dosežete tudi oštevilčevanje strani z uporabo filtrov Liquid.
{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}
Ena nit foruma
Predmet objav v forumu omogoča dostop do zbirke predmetov objav v forumu.
Atributi
Atribut | Opis |
---|---|
threads | Vrne predmet »forumthreads«, ki vsebuje vse predmete »forumthread« na portalu. |
Vsa | Vrne vse predmete »forum« na portalu. Upoštevajte, da lahko uporabite tudi »website.forums«. |
thread_count | Vrne celoštevilsko vrednost za število niti na celotnem spletnem mestu. |
post_count | Vrne celoštevilsko vrednost skupnega števila objav na portalu. |
[ime ali id foruma] | Do vsakega foruma lahko dostopate prek njegovih lastnosti imena ali ID-ja. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %} |
Predmet »forum«
Atributi
opomba,
Atribut | Opis |
---|---|
threads | Vrne predmet »forumthreads«, ki vsebuje vse niti foruma za forum. |
Imenu | Ime foruma. |
thread_count | Vrne celoštevilsko vrednost za število niti na forumu. |
post_count | Vrne celoštevilsko vrednost za število objav na celotnem forumu. |
Predmet »forumthreads«
Atributi
Atribut | Opis |
---|---|
Vsa | Vrne vse predmete »forumthread« v zbirki. |
Predmet »forumthread«
Atributi
opomba,
Atribut | Opis |
---|---|
posts | Vrne predmet »forumposts«, ki vsebuje vse objave foruma za nit. |
author | Vrne avtorja za nit (ki je preprosto predmet tabele stika). |
latest_post | Vrne zadnjo objavo v niti. |
first_post | Vrne prvo objavo v niti. |
post_count | Vrne celoštevilsko vrednost za število objav v niti. |
is_answered | Ali obstaja odgovor na nit ali ne? |
is_sticky | Ali je nit na vrhu? |
Predmet »forumposts«
Atributi
Atribut | Opis |
---|---|
Vsa | Vrne vse predmete »forumthread« v zbirki. |
Ena objava v forumu
Atributi
opomba,
Atribut | Opis |
---|---|
author | Vrne avtorja za objavo (ki je preprosto predmet tabele stika). |
vsebina | Vsebina objave. |
is_answer | Ali je ta objava odgovor na nit? |
zbirka znanja
Omogoča dostop do zapisov tabel kategorije in knowledgearticle v storitvi Dataverse za upodabljanje člankov in kategorij na portalu.
Atributi
Atribut | Opis |
---|---|
članki | Vrne predmet članka, ki vsebuje predmete članka za zapise tabele knowledgearticle, ki so na voljo na portalu. |
categories | Vrne predmet kategorije, ki vsebuje predmete kategorije za zapise tabele kategorije, ki so na voljo na portalu. |
Predmet »articles«
Predmet »articles« omogoča dostop do zbirke predmetov članka. Z uporabo filtrov Liquid lahko članke razvrstite in zagotovite tudi oštevilčevanje strani.
{% 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 %}
Atributi
Atribut | Opis |
---|---|
priljubljeno | Vrne zbirko predmetov članka, ki vsebujejo največ pogledov. {% assign popular_articles = knowledge.articles.popular %} |
nedavno | Vrne zbirko predmetov članka, ki vsebujejo datum zadnje spremembe. {% assign recent_articles = knowledge.articles.recent %} |
najboljše | Vrne zbirko predmetov članka, ki so ocenjeni z najvišjo oceno. {% assign top_articles = knowledge.articles.top %} |
Filtri
Naslednji filtri lahko sprejmejo izbirne parametre za velikost strani in jezik. Prvi parameter je število zapisov za pridobitev. Privzeta velikost strani je 5. Drugi parameter je jezikovna koda za pridobivanje člankov za posamezni jezik. Filtre je mogoče združiti z drugimi filtri Liquid.
{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Atribut | Opis |
---|---|
priljubljeno | Vrne zbirko predmetov članka, ki vsebujejo največ pogledov. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %} |
nedavno | Vrne zbirko predmetov članka, ki vsebujejo datum zadnje spremembe. {% assign recent_articles = knowledge.articles \| recent: 5 %} |
najboljše | Vrne zbirko predmetov članka, ki so ocenjeni z najvišjo oceno. {% assign top_articles = knowledge.articles \| top: 3, en-US %} |
predmet kategorije
Predmet kategorije omogoča dostop do zbirke predmetov kategorije. Z uporabo filtrov Liquid lahko kategorije razvrstite in zagotovite tudi oštevilčevanje strani.
{% 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 %}
Atributi
Atribut | Opis |
---|---|
nedavno | Vrne zbirko predmetov kategorije, ki vsebujejo datum zadnje spremembe. |
top_level | Vrne zbirko predmetov kategorije, ki nimajo nadrejene kategorije. |
Filtri
Naslednji filtri lahko sprejmejo izbirni parameter, ki označuje velikost strani. Privzeta velikost strani je 5. Filtre je mogoče združiti z drugimi filtri Liquid.
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Atribut | Opis |
---|---|
nedavno | Vrne zbirko predmetov kategorije, ki vsebujejo datum zadnje spremembe. Navedete lahko parametre {% assign recent_categories = knowledge.categories \| recent: 10 %} |
top_level | Vrne zbirko predmetov kategorije, ki nimajo nadrejene kategorije. {% assign root_categories = knowledge.categories \| top_level %} |
predmet članka
Predmet članka omogoča delo z eno entiteto knowledgearticle za prikaz podrobnosti tega članka na portalu.
Atributi
članek je predmet entitete z vsemi enakimi atributi poleg spodaj navedenih atributov.
Atribut | Opis |
---|---|
article_public_number | Javna številka članka. |
comment_count | Celoštevilska vrednost za število vseh komentarjev, podanih za posamezni članek. |
content | Vsebina članka. |
current_user_can_comment | Vrne logično vrednost, ki označuje, ali trenutni uporabnik lahko v članek dodaja komentarje. |
is_rating_enabled | Vrne logično vrednost, ki označuje, ali je ocenjevanje članka omogočeno. |
ključne besede | Ključne besede članka. |
ime | Nadomestni vzdevek za naslov članka. |
ocena | Decimalna vrednost ocene članka. |
title | Naslov članka. |
view_count | Celoštevilska vrednost, ki označuje število ogledov članka. |
predmet kategorije
Predmet kategorije omogoča delo z eno kategorijo za prikaz podrobnosti te kategorije na portalu.
Atributi
kategorija je predmet entitete z vsemi enakimi atributi poleg spodaj navedenih atributov.
Atribut | Opis |
---|---|
categorynumber | Številka kategorije. |
ime | Nadomestni vzdevek za naslov kategorije. |
naziv | Naslov kategorije. |
jezik
Navaja ime trenutnega jezika in jezikovno kodo, če je omogočena podpora za več jezikov.
Atributi
Atribut | Opis |
---|---|
url | URL trenutne zahteve s predpono kode trenutno izbranega jezika. |
url_substitution | URL trenutne zahteve s predpono kode trenutno izbranega jezika, ki obide izhodni predpomnilnik strani. |
ime | Naziv trenutnega jezika. |
koda | Jezikovna koda jezika. |
Spletna predloga Spustni seznam jezikov privzeto uporablja ta tekoči predmet za navedbo razpoložljivih jezikov, ko je na voljo več jezikov.
stran
Navezuje se na trenutno stran z zahtevo portala. Ta predmet združuje atribute zemljevida mesta in entitete trenutne zahteve (običajno je to spletna stran).
Predmet strani omogoča dostop do elementov, kot so sledi poti za trenutno stran, naslov ali URL trenutne strani in kateri koli drugi atributi ali povezane entitete temeljnih zapisov programa Dataverse.
<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 }}. -->
Atributi strani
opomba,
Atribut | Opis |
---|---|
breadcrumbs | Vrne predmete vozlišča zemljevida mesta s potjo za stran z začetkom pri korenskem vozlišču zemljevida mesta in s koncem pri nadrejenem vozlišču. |
children | Vrne predmete podrejenega vozlišča zemljevida mesta za stran. |
parent | Vrne nadrejeno vozlišče zemljevida mesta za stran. Če je stran domača stran, ima nadrejeno vozlišče vrednost »null«. |
naslov | Naslov strani. |
url | URL strani. |
[ime atributa ali odnosa] | Do vseh atributov temeljnega zapisa Dataverse strani lahko dostopate prek logičnega imena.{{ page.createdon }} {% assign attribute_name = 'name' %} {{ page[attribute_name] }} Vrednosti večine atributov tabel se neposredno preslikajo v vrste Liquid: polja z dvema možnostma se preslikajo v logične vrednosti, besedilna polja v nize, numerična polja/polja valut v številke, polja datuma/časa v datumske predmete. Toda nekatere vrste atributov so vrnjene kot predmeti:
{{ page.adx_webpage_entitylist.adx_name }} V primeru, da je odnos povraten (tj. samoreferenčen), bo vrnjen predmet entitet. (Sicer bi bil rezultat dvoumen.) {{ page.adx_webpage_webpage.referencing.adx_name }} Opomba: nalaganje večjega števila povezanih entitet ali dostop do večjega števila odnosov v eni predlogi lahko negativno vpliva na učinkovitost upodabljanja predloge. Izogibajte se nalaganju entitet za vsak element v polju, v zanki. Kjer je mogoče, za nalaganje zbirk entitet uporabite oznake tabele storitve Dataverse. |
ankete
Zagotavlja dostop do ankete in ustvarjanje ankete.
Predmet »polls« omogoča izbiro določene ankete ali postavitev ankete:
<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>
Atributi anket
Atribut | Opis |
---|---|
placements | Vrne predmet postavitve anket. |
[ime ali id ankete] | Do vsake ankete lahko dostopate prek imena ali lastnosti ID-ja. {% assign poll = polls[Poll Name] %} {% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %} |
Atributi postavitve anket
Atribut | Opis |
---|---|
[ime ali id postavitve ankete] | Do vsake postavitve anket lahko dostopate prek imena ali lastnosti ID-ja.{% assign placement = polls.placements[Placement Name or Id] %} {% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %} |
Atributi postavitve anket
opomba,
Atribut | Opis |
---|---|
Imenu | Vrne polje z imenom za postavitev ankete. |
placement_url | URL, ki se lahko uporablja za pridobivanje postavitve ankete, v celoti ustvarjene s predlogo. |
ankete | Vrne zbirko predmetov anket, povezanih s postavitvijo. S to zbirko se lahko uporabljajo oznake za ponovitev in filtri polj. |
random_url | URL, ki se lahko uporablja za pridobivanje naključne ankete iz postavitve, v celoti ustvarjene s predlogo. |
submit_url | URL, kateremu je predložena izpolnjena anketa. |
Atributi ankete
opomba,
Atribut | Opis |
---|---|
has_user_voted | Vrne vrednost »true«, če je trenutni uporabnik (vpisani ali anonimni) že glasoval v tej anketi. |
Ime | Vrne polje z imenom za anketo. |
options | Vrne zbirko predmetov možnosti anket, povezanih z anketo. S to zbirko se lahko uporabljajo oznake za ponovitev in entitete. |
poll_url | URL, ki se lahko uporablja za pridobivanje ankete, v celoti ustvarjene s predlogo. |
Vprašanje programa | Vrne polje z vprašanjem za anketo. |
submit_button_label | Vrne niz, ki se lahko uporablja za preglasitev oznake gumba za pošiljanje za anketo. |
submit_url | URL, kateremu je predložena izpolnjena anketa. |
user_selected_option | Vrne predmet ankete, ki ga izbere uporabnik (če je že glasoval). |
votes | Vrne število glasov, ki so bili tabelirani za anketo. |
Atributi možnosti ankete
opomba,
Atribut | Opis |
---|---|
answer | Vrne polje z odgovorom za anketo. |
percentage | Vrne odstotek glasov v anketi za možnost kot decimalno število od 0 do 100. |
votes | Vrne število glasov, ki so bili tabelirani za možnost. |
request
Vključuje podatke o trenutni zahtevi HTTP.
{% assign id = request.params['id'] | escape %}
<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>
opomba,
- S filtri URL lahko dinamično ustvarjate URL-je v okolju Liquid.
- URL, uporabljen v »request.url« ima lahko poljubno zahtevano vrednost in se shrani v predpomnilnik za nadaljnje zahteve. Da zagotovite pravilno vrednost v »request.url«, razmislite o uporabi nadomestne oznake oziroma delnega URL-ja, kot je ~{pot WebFile}, ali shranjevanju URL-ja portala v Nastavitve spletnega mesta.
- Za različico izdaje platforme Power Pages 9.3.8.x ali novejše različice bodo za uporabnika privzeto uveljavljeni ubežni filter Liquid in predmeti Liquid za zahtevek. Če želite onemogočiti privzeto konfiguracijo in omogočiti predmete Liquid brez ubežnega filtra Liquid, si oglejte nastavitve mesta portala – Site/EnableDefaultHtmlEncoding.
Atributi
Atribut | Opis |
---|---|
parametri | Poimenovane vrednosti parametrov za trenutno zahtevo. »params« je kombinacija parametrov niza poizvedbe URL, parametrov za objavo obrazca ter piškotkov. |
Pot | Pot URL-ja trenutne zahteve. /profile/ |
path_and_query | Pot in poizvedba URL-ja trenutne zahteve./profile/?foo=1&bar=something |
poizvedba | Del poizvedbe URL-ja trenutne zahteve. ?foo=1&bar=something |
url | Celoten URL trenutne zahteve.https://www.example.com/profile/?foo=1&bar=something |
searchindex
Predmet »searchindex« se uporablja v oznakah tabele storitve Dataverse in zagotavlja dostop do rezultatov poizvedbe.
{% 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 %}
Atributi
Atribut | Opis |
---|---|
approximate_total_hits | Vrne približno število vseh zadetkov, ki se ujemajo s poizvedbo po kazalu. Zaradi načina delovanja kazala, kar zadeva varnostno filtriranje in druge dejavnike oblikovanja, je ta številka samo približek in se morda ne ujema čisto s celotnim številom rezultatov, ki so na voljo trenutnemu uporabniku v nekaterih primerih. |
Stran | Vrne številko strani trenutne poizvedbe. |
page_size | Vrne največjo velikost strani trenutne poizvedbe. Če želite, da je za trenutno stran vrnjeno dejansko število rezultatov (ker je to lahko manjše od največje določene velikosti strani), uporabite »results.size«. |
results | Vrne stran z rezultati poizvedbe kot predmete rezultate kazala iskanja. |
Rezultati kazala iskanja
Atribut | Opis |
---|---|
entiteta | Temeljne entitete za rezultat |
fragment | Fragment zadevnega kratkega besedila za rezultat, pri čemer se izrazi ujemajo z določeno poizvedbo, označeno z oznako HTML <em>. Nekatere vrste poizvedb ne podpirajo označenih fragmentov, na primer mehke poizvedbe (~) in poizvedbe z nadomestnimi znaki (*). V takšnih primerih bo ta lastnost ničelna. |
ID | ID tabele Dataverse temeljnega zapisa za rezultat kot niz. Na primer »936DA01F-9ABD-4d9d-80C7-02AF85C822A8«. |
logical_name | Logično ime tabele Dataverse temeljnega zapisa za rezultat. Na primer »adx_webpage« |
število | Število rezultata, po vseh straneh z rezultati, z začetkom pri 1. Za prvi rezultat na drugi strani rezultatov pri velikosti strani 10 bo ta vrednost na primer 11. |
score | Zadetek Lucene za rezultat, kot vrednost s premično vejico. Rezultati se vrnejo razvrščeni po tej vrednosti. |
title | Naslov rezultata. |
url | URL rezultata. To je običajno – ne pa nujno – absolutna pot za trenutno aplikacijo, in ne celoten URL. Na primer: /articles/article1/ |
nastavitve
Omogoča, da naložite poljubne nastavitve mesta po imenu. Če nastavitev s podanim imenom ni najdena, je vrnjeno null.
opomba,
Nastavitve so vrnjene kot nizi, vendar pa lahko uporabite filtre vrst, da jih pretvoriti v druge vrste.
{{ 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 %}
zemljevid mesta
Omogoča dostop do zemljevida mesta portala.
<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 %}
Atributi zemljevida mesta
Atribut | Opis |
---|---|
Trenutno | Vrne predmet vozlišča zemljevida mesta za trenutno stran. |
Koren | Vrne predmet vozlišča zemljevida mesta za korensko (domačo) stran spletnega mesta. |
Atributi vozlišča zemljevida mesta
Atribut | Opis |
---|---|
Pot | Vrne predmete vozlišča zemljevida mesta s potjo za vozlišče z začetkom pri korenskem vozlišču zemljevida mesta in s koncem pri nadrejenem vozlišču. |
Podrejeni elementi | Vrne predmete podrejenega vozlišča zemljevida mesta za vozlišče. |
Opis | Vsebina opisa/povzetka za vozlišče. (To polje lahko vsebuje HTML.) |
Entiteta | Vrne temeljne entitete vozlišča. Če vozlišče nima temeljne tabele, bo ta vrednost »null«. |
is_sitemap_ancestor | Če je vozlišče zemljevida mesta prednik trenutnega vozlišča, vrne »true«, sicer pa »false«. |
is_sitemap_current | Če je vozlišče zemljevida mesta trenutno vozlišče, vrne »true«, sicer pa »false«. |
Nadrejeno | Vrne nadrejeno vozlišče zemljevida mesta za vozlišče. Če je vozlišče korensko vozlišče, bo nadrejeno vozlišče imelo vrednost »null«. |
Naziv | Naslov vozlišča. |
Spletni naslov | Naslov URL vozlišča. |
oznake spletnih mest
Omogoča, da naložite poljubne oznake spletnih mest po imenu. Če obstaja oznaka spletnega mesta, bo predmet oznake spletnega mesta vrnjen. Če oznaka spletnega mesta s podanim imenom ni najdena, je vrnjeno null.
{{ sitemarkers[Login].url }}
{% assign my_sitemarker = sitemarkers["My Site Marker"] %}
{% if my_sitemarker %}
<a href={{ my_sitemarker.url }}>{{ my_sitemarker.adx_name }}</a>
{% else %}
Site marker My Site Marker does not exist.
{% endif %}
Atributi oznak spletnih mest
Atribut | Opis |
---|---|
url | URL cilja oznake spletnega mesta. |
[logično ime atributa] | Do vseh atributov cilja oznake spletnega mesta zapisa Dataverse lahko dostopate prek logičnega imena. Na primer {{ sitemarker.adx_name }}. |
snippets
Omogoča, da naložite poljubne izrezke vsebine po imenu. Če izrezka s podanim imenom ni mogoče najti, je vrnjena vrednost null.
{{ snippets[Header] }}
{% assign footer = snippets[Footer] %}
{% if footer %}
{{ footer }}
{% else %}
No footer snippet was found.
{% endif %}
zanka vrstice tabele
Vsebuje lastnosti, uporabne znotraj bloka zanke oznak za ponovitev.
opomba,
»tablerowloop« se lahko uporablja samo v oznaki oznake za ponovitev.
Atributi
Atribut | Opis |
---|---|
Col | Vrne kazalo trenutne vrstice in začne pri 1. |
col0 | Vrne kazalo trenutne vrstice in začne pri 0. |
col_first | Vrne vrednost »true«, če je trenutni stolpec prvi stolpec v vrstici, sicer vrne vrednost »false«. |
col_last | Vrne vrednost »true«, če je trenutni stolpec zadnji stolpec v vrstici, sicer vrne vrednost »false«. |
Ime | Vrne vrednost »true«, če gre za prvo ponovitev zanke. Vrne vrednost »false«, če ne gre za prvo ponovitev zanke. |
Indeks | Položaj trenutnega elementa v zbirki, kjer ima prvi element položaj 1. |
index0 | Položaj trenutnega elementa v zbirki, kjer ima prvi element položaj 0. |
Zadnja | Vrne vrednost »true«, če gre za zadnjo ponovitev zanke. Vrne vrednost »false«, če ne gre za zadnjo ponovitev zanke. |
Length | Vrne število ponovitev za zanko ߝ število elementov v zbirki, ki se ponavlja. |
Rindex | Število elementov, ki ostanejo v zanki (dolžina – kazalo), kjer je 1 kazalo zadnjega elementa. |
rindex0 | Število elementov, ki ostanejo v zanki (dolžina – kazalo), kjer je 0 kazalo zadnjega elementa. |
uporabnik
Navezuje se na trenutnega uporabnika portala in omogoča dostop do vseh atributov temeljnega zapisa o stiku v programu Dataverse. Če noben uporabnik ni prijavljen, bo ta spremenljivka nična.
Uporabnik je predmet entitete.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
opomba,
Za različico izdaje platforme Power Pages 9.3.8.x ali novejše različice bodo za uporabnika privzeto uveljavljeni ubežni filter Liquid in predmeti Liquid za zahtevek. Če želite onemogočiti privzeto konfiguracijo in omogočiti predmete Liquid brez ubežnega filtra Liquid, si oglejte nastavitve mesta portala – Site/EnableDefaultHtmlEncoding.
Atributi
Poleg tega, da ima uporabnik vse atribute predmeta entitete, ima tudi spodnje atribute.
Atribut | Opis |
---|---|
vloge | Vrne vloge, ki jim uporabnik pripada kot polje.{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %} Opomba: uporabite lahko filter has_role za preskus za posamezna članstva vlog. |
basic_badges_url | Vrne URL storitve za pridobivanje značke uporabnika. Če želite upodobiti značke za uporabnika, morate vključiti oznako z atributoma »data-badge« in »data-uri«. Za upodobitev značk trenutnega uporabnika: <div data-badge data-uri='{{user.basic_badges_url }}'></div> Za prikaz značke uporabnika z ID (spremenljiv ID uporabnika): `<div data-badge data-uri='{{user.basic_badges_url |
spletne povezave
Omogoča, da naložite spletne povezave po imenu ali ID-ju.
Če obstaja nabor spletnih povezav, bo vrnjen predmet nabora spletnih povezav. Če nabor spletnih povezav s podanim imenom ali ID-jem ni najden, je vrnjeno null.
<!-- Load web link set by ID -->
{{ weblinks[page.adx_navigation.id].name }}
<!-- Load web link set by name -->
{% assign nav = weblinks[Primary Navigation] %}
{% if nav %}
<h1>{{ nav.title | escape }}</h1>
<ul>
{% for link in nav.weblinks %}
<li>
<a href={{ link.url | escape }} title={{ link.tooltip | escape }}>
{% if link.image %}
<img src={{ link.image.url | escape }} alt={{ link.image.alternate_text | escape }} />
{% endif %}
{{ link.name | escape }}
</a>
</li>
{% endfor %}
</ul>
{% endif %}
Atributi nabora spletnih povezav
opomba,
Nabor spletnih povezav je predmet entitete z vsemi enakimi atributi poleg spodaj navedenih atributov.
Atribut | Opis |
---|---|
Besedilo | Besedilo HTML nabora spletnih povezav. |
Ime | Ime nabora spletnih povezav. |
Naziv | Naslov nabora spletnih povezav. |
Weblinks | Polje predmetov spletnih povezav, povezano z naborom spletnih povezav. |
[logično ime atributa] | Do vseh atributov zapisa Dataverse nabora spletnih povezav lahko dostopate po logičnem imenu. Na primer {{ weblinkset.createdon }}. |
Atributi spletnih povezav
opomba,
Spletna povezava je predmet entitete z vsemi enakimi atributi poleg spodaj navedenih atributov.
Atribut | Opis |
---|---|
Opis | Opis HTML spletne povezave. |
display_image_only | Atribut logične vrednosti, ki označuje, ali naj bo spletna povezava prikazana samo kot slika, brez besedila povezave. |
display_page_child_links | Atribut logične vrednosti, ki označuje, ali naj spletna povezava prikazuje povezave do podrejenih strani zemljevida mesta za povezano stran v obliki podpovezav. |
Slika | Predmet slike spletne povezavo za to povezavo. Ta atribut bo ničen, če slika ni prisotna. |
is_external | Atribut logične vrednosti, ki označuje, ali ciljni URL spletne povezave vodi do zunanjega mesta (in ne na notranjo stran portala). |
is_sitemap_ancestor | Vrne vrednost »true«, če se URL spletne povezave sklicuje na prednika trenutnega vozlišča zemljevida mesta, sicer pa »false«. |
is_sitemap_current | Vrne vrednost »true«, če se URL spletne povezave sklicuje na trenutno vozlišče zemljevida mesta, sicer pa »false«. |
Ime | Ime/naslov spletne povezave. |
Nofollow | Atribut logične vrednosti, ki označuje, ali naj bo spletna povezava označena kot »rel=nofollow«. |
open_in_new_window | Atribut logične vrednosti, ki označuje, ali naj se izbrana spletna povezava odpre v novem oknu/zavihku brskalnika. |
Opis orodja | Besedilo opisa orodja za spletno povezavo. |
Spletni naslov | URL spletne povezave. |
Weblinks | Polje predmetov podrejenih spletnih povezav, povezano s spletno povezavo. |
[logično ime atributa] | Do vseh atributov zapisa Dataverse spletne povezave lahko dostopate po logičnem imenu. Na primer {{ weblink.createdon }}. |
Atributi slik spletnih povezav
alternate_text | Nadomestno besedilo za sliko. |
---|---|
Višina | Celo število, ki vsebuje določeno višino slike. Če vrednost višine ni zagotovljena, bo ta atribut ničen. |
Spletni naslov | URL slike. |
Širina | Celo število, ki vsebuje določeno širino slike. Če vrednost širine ni zagotovljena, bo ta atribut ničen. |
spletno mesto
Navezuje se na spletno mesto portala in omogoča dostop do vseh atributov zapisa spletnega mesta storitve Dataverse (adx_website) za portal.
opomba,
Spletno mesto je predmet entitete z vsemi enakimi atributi.
Koda
{{ website.adx_name }} ({{ website.id }})
Rezultat
Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)
Atributi
V naslednji tabeli so navedeni atributi za to oznako, ki jih lahko uporabite za nadomestitev privzetih vrednosti, da se izognete predpomnjenju.
Default | Nadomestek (v izogib predpomnjenju) | Primer |
---|---|---|
sign_in_url | sign_in_url_substitution | Privzeto: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F Zamenjava (izogibanje predpomnjenju): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F (v tem primeru "substitute-page" nadomesti privzeti predpomnjeni URL.) |
sign_out_url | sign_out_url_substitution | Privzeto: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F Zamenjava (izogibanje predpomnjenju): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F (v tem primeru "substitute-page" nadomesti privzeti predpomnjeni URL.) |