Zdieľať cez


Dostupné objekty Liquid

Menlivé objekty obsahujú atribúty na dynamický výstup obsahu na stránku. Napríklad objekt page object má atribút s názvom názov, ktorý možno použiť na výstup názvu aktuálnej stránky.

Na prístup k atribútu objektu podľa názvu použite bodku (.). Na vykreslenie atribútu objektu v šablóne ju ohraničte {{ and }}.

Dôležité

Aby ste sa vyhli potenciálnym problémom so skriptovaním medzi webmi (XSS), vždy používajte ukončovací filter na kódovanie údajov HTML, keď sa používajú objekty Liquid na čítanie nedôveryhodných údajov poskytnutých používateľom.

{{ page.title }}

Atribúty objektu možno otvoriť aj pomocou názvu reťazca a []. Tento formát je užitočný v prípade, ak požadovaný atribút určuje dynamicky, alebo názov atribútu obsahuje znaky, medzery, špeciálne znaky, atď., ktoré by boli neplatné pri použití bodky (.) vnútri syntaxe.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Tieto objekty môžu byť použité a prístupná odkiaľkoľvek, v šablóne.

Object Popis
entity Umožňuje načítať akúkoľvek tabuľku Microsoft Dataverse podľa ID. Ďalšie informácie: entity
teraz Dátum a čas objekt, ktorý sa týka aktuálneho času UTC v čase vykresľovania šablóny.
Poznámka: Webová aplikácia portálu ukladá túto hodnotu do vyrovnávacej pamäte a neobnovuje sa zakaždým. Ďalšie informácie: Filtre údajov
stránka Odkazuje na aktuálnej stránke portál žiadosť. Objekt stránky poskytuje prístup k veciam, akými sú prvky breadcrumbs na aktuálnej stránke, názov alebo adresa URL aktuálnej stránky a akékoľvek ďalšie atribúty alebo súvisiace entity príslušného záznamu Dataverse. Ďalšie informácie: stránka
parametre Pohodlný odkaz pre request.params. Ďalšie informácie: žiadosť
žiadosť Obsahuje informácie o aktuálnych žiadostiach HTTP. Ďalšie informácie: žiadosť
nastavenia Umožňuje načítať akúkoľvek značku lokality podľa názvu. Ďalšie informácie: nastavenia
Mapa lokality Umožňuje prístup k mape lokality portálu. Ďalšie informácie: mapa lokality
značky lokalít Umožňuje načítať akúkoľvek značku lokality podľa názvu. Ďalšie informácie: sitemarkers
zlomky Umožňuje načítať akýkoľvek zlomok obsahu podľa názvu. Ďalšie informácie: fragmenty kódu
používateľ Odkazuje na aktuálneho používateľa portálu, pričom umožňuje prístup k všetkým atribútom pod záznamom kontaktu Dataverse. Ak nie je prihlásený žiadny používateľ, táto premenná je null. Ďalšie informácie: používateľ
webové prepojenia Umožňuje vám skúsiť sadu webových prepojení podľa názvu alebo ID. Ďalšie informácie: webové odkazy
webová lokalita Odkazuje na záznam webovej lokality portálu umožňujúci prístup k všetkým atribútom záznamu webovej lokality Dataverse (adx_website) na portáli. Ďalšie informácie: webová lokalita

Reklamy

Umožňuje načítanie a zobrazenie reklamy.

Objekt reklamy umožňuje vybrať konkrétnu reklamu alebo umiestnenie reklamy:

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

Atribúty reklamy

Atribút Popis
umiestnenia Vráti objekt umiestnenia reklamy.
[názov alebo id reklamy] Môžete otvoriť akúkoľvek reklamu podľa vlastností názvu alebo identifikácie.
{% assign ad = ads[Ad Name] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Atribúty umiestnenia reklamy

Atribút Popis
[názov alebo id umiestnenia reklamy] Môžete otvoriť akékoľvek umiestnenie reklamy podľa vlastností názvu alebo identifikácie.
{% assign placement = ads.placements[Placement Name or Id] %}
{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Atribúty umiestnenia reklamy

Umiestnenie reklamy je objekt tabuľky s rovnakými všeobecnými atribútmi a nasledujúcimi atribútmi:

Atribút Description
Reklamy Vráti zbierku objektov reklamy prepojených s umiestnením reklamy. V tejto kolekcii možno použiť iteračné značky a Filtre polí .
Name Vráti pole názvu pre umiestnenie reklamy.
placement_url Adresa URL, ktoré možno použiť na získanie umiestnenie reklamy v plnom rozsahu poskytovaných šablóny.
random_url Adresa URL, ktoré možno použiť na získanie náhodnej reklamy z umiestnenia v plnom rozsahu poskytovaných šablóny.

Atribúty reklamy

Poznámka

Reklama je objekt tabuľky so všetkými rovnakými atribútmi okrem nasledujúcich:

Atribút Description
ad_url Adresa URL, ktoré možno použiť na získanie reklamy v plnom rozsahu poskytovaných šablóny.
Kopírovanie Vráti pole Kopírovať pre reklamu.
obrázok Vráti obraz objektu (ak existuje) pre reklamu.
Name Vráti pole Názov pre reklamu.
open_in_new_window Vráti hodnotu true, ak by sa adresa URL zadaná ako redirect_url mala otvoriť v novom okne.
redirect_url Adresa URL, na ktorú je používateľ presmerovaný výberom reklamy.

Atribúty obrázku reklamy

Atribút Popis
alternate_text Vráti text, ktorý je určený na zobrazenie sa v alternatívnom atribúte značky.
výška Vráti výšku v pixeloch pre obrázok
Adresa URL Vráti zdrojovú adresu URL obrázka.
šírka Vráti šírku v pixeloch pre obrázok

Blogy

Umožňuje načítanie a zobrazenie blogov a blogových príspevkov.

Objekty blogov vám umožňujú vybrať si konkrétny blog alebo blogové príspevky.

{% assign posts = blogs.posts | paginate: 0,4 %}

<div class=content-panel panel panel-default>

<div class=panel-heading>

{% assign sitemarker = sitemarkers["Blog Home"] %}

{% assign snippet = snippets[Home Blog Activity Heading] %}

<a class=pull-right href={{sitemarker.url}}> All Blogs </a>

<h4>

<a class=feed-icon fa fa-rss-square href={{ blogs.feedpath }} />

{{ snippet.adx_value }}

</h4>

</div>

<ul class=list-group>

{% for post in posts.all %}

<li class=list-group-item >

<a class=user-avatar href={{ post.author_url }}>

<img src={{ post.user_image_url }} />

</a>

<h4 class=list-group-item-heading>

<a href={{ post.app_relative_path }}>{{ post.title }}</a>

</h4>

<div class=content-metadata>

<abbr class=timeago>{{ post.publish_date }}</abbr>

&ndash;

<a href={{ post.author_url }}> {{ post.author_name }} </a>

&ndash;

<a href={{ post.application_path }}#comments>

<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}

</a>

</div>

</li>

{% endfor %}

</ul>

</div>

objekty blogov

Objekt blogu umožňuje prístup ku ktorémukoľvek blogu portálu alebo získať prístup k blogovým príspevkom na portáli.

Nasledujúca tabuľka vysvetľuje atribúty spojené s objektom blogov.

Atribút Popis
príspevky Vracia objekt blogposts obsahujúci všetky blogové príspevky na portáli.
[názov alebo ID blogu] Môžete otvoriť akýkoľvek blog podľa jeho názvu alebo ID vlastností.
{% assign blog = blogs["Blog Name"] %}                             

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

objekt blogu

Objekt blogu umožňuje pracovať s jedným blogom, pričom umožňuje prístup k príspevkom tohto blogu.

Nasledujúca tabuľka vysvetľuje rôzne atribúty spojené s objektom blogu.

Atribút Popis
príspevky Vracia objekt blogového príspevku obsahujúci všetky blogové príspevky blogu.
Meno Názov blogu.
názov Pomenovanie blogu.
Adresa URL Adresa URL blogu.

Objekt blogového príspevku

Objekt blogového príspevku umožňuje prístup a zber objektov blogových príspevkov. Blogové príspevky si môžete usporiadať a dosiahnuť stránkovanie navyše pomocou menlivých filtrov:

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

Ďalšie možné možnosti:

  • blogs.posts.all (na získanie všetkých blogových príspevkov)
  • blogs.posts | from\_index: 0 | take: 2

Nasledujúca tabuľka vysvetľuje rôzne atribúty spojené s objektom blogových príspevkov.

Atribút Popis
Všetky Vráti všetky objekty blogových príspevkov portálu v zbierke.

Objekt blogového príspevku

Odkazuje na jeden blogový príspevok.

Nasledujúca tabuľka vysvetľuje rôzne atribúty spojené s objektom blogového príspevku.

Atribút Popis
URL adresa Adresa URL príspevku.
obsah Vráti pole obsahu post.
autor Vracia autorov pre príspevok (ktorí predstavujú jednoduchý objekt tabuľky kontaktu).
nadpis Pomenovanie príspevku.
comment_count Vráti celočíselnú hodnotu počtu celkového počtu komentárov pre daný príspevok.
publish_date Dátum, kedy bol príspevok zverejnený.

entity

Upozornenie

Aby ste sa vyhli potenciálnym problémom so skriptovaním medzi webmi (XSS), vždy používajte ukončovací filter na kódovanie údajov reťazca HTML, keď sa používajú entity objektu Liquid na čítanie údajov poskytnutých používateľom, ktorým sa nedá dôverovať.

Poznámka

Niektoré z konvencií pomenovania Dataverse sa zmenili napr. entity Dataverse sa teraz nazývajú tabuľky. Zmeny názvu sa nevzťahujú na objekty Liquid. Objekt entít Liquid sa bude naďalej označovať ako entity.

Umožňuje načítať akúkoľvek tabuľku Dataverse podľa ID. Ak tabuľka existuje, vráti sa objekt tabuľky. Ak sa tabuľka s daným ID nenájde, vráti sa 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

Objekt entity poskytuje prístup k atribútom záznamu tabuľky Dataverse .

Atribút Popis
Identifikátor Identifikátor GUID tabuľky vo forme reťazca. Napríklad 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Logický názov tabuľky Dataverse.
Poznámky Načíta všetky poznámky (poznámka) spojené s tabuľkou, zoradené od najstarších po najnovšie (createdon). Poznámky sa vrátia ako objekty poznámky.
povolení Načíta výsledky povolení tabuľky pre tabuľku. Výsledky sa zobrazia ako objekt povolení.
URL adresa Vráti cestu adresy URL systému na správu obsahu Power Pages pre tabuľku. Ak tabuľka neobsahuje žiadne platné adresy URL aktuálnej webovej stránky, vráti sa hodnota null. Vo všeobecnosti to vráti hodnotu len pre určité typy tabuliek, ktoré boli integrované do portálového CMS, pokiaľ ste vo svojej aplikácii neprispôsobili poskytovateľa URL.
[názov atribútu alebo vzťahu] Ku každému atribútu tabuľky Dataverse môžete pristupovať podľa logického názvu. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
Hodnoty väčšiny atribútov tabuľky sa mapujú priamo do typov dynamických prvkov: polia dvoch možností sa mapujú do poľa s dvomi možnosťami, textové polia na reťazce, polia čísel/meny k číslam, polia dátumu/času na objekty dátumu. Ale niektoré typy atribútov sa vrátia ako objekty:
  • Polia Lookup (Odkaz na priradenú tabuľku) sa vrátia ako priradené referenčné objekty tabuľky.
  • Množina možností/polia zoznamu možností sa vrátia ako množina možností hodnoty objektu.
  • Môžete tiež nahrať akékoľvek súvisiace entity podľa názvu schémy vzťahu.
  • {{ page.adx_webpage_entitylist.adx_name }}V prípade, že vzťah je reflexívny (čiže sebareferenčný), vráti sa reflexívny objekt vzťahu. (V opačnom prípade by bol výsledok dvojzmyselný.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Poznámka: Načítanie veľkého počtu súvisiacich entít alebo prístup k veľkému počtu vzťahov v jednej šablóne môže mať negatívny vplyv na výkon vykresľovania šablón. Vyhnite sa načítavaniu súvisiacich entít pre každú položku v poli v rámci slučky Ak je to možné, použite označenia tabuľky Dataverse na načítanie kolekcie entít.

Odkaz na priradenú tabuľku

Hodnoty atribútov vyhľadávania sa vrátia ako referenčné objekty priradenej tabuľky s nasledujúcimi atribútmi.

Atribút Popis
Identifikátor Identifikátor GUID referenčnej tabuľky vo forme reťazca.
Napríklad 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Logický názov Dataverse referenčnej tabuľky.
Name Atribút primárneho názvu referenčnej tabuľky.

Poznámka

Poznámka je objekt tabuľky, ktorá poskytuje prístup k atribútom a vzťahom záznamu anotácie. Okrem všetkých atribútov objektu tabuľky má poznámka nasledujúce extra atribúty.

Atribút Description
documentbody Načíta sa atribút documentbody poznámky anotácie záznamu, ako reťazec s kódovaním Base64. Pretože obsah tohto atribútu môže byť veľký, nenačítava sa so zvyškom atribútov poznámky, načítava sa iba na požiadanie.
Poznámka: Použitie atribútu documentbody môže mať negatívny vplyv na výkon vykresľovania šablóny a malo by sa vykonávať opatrne.
Použite atribút URL na poskytnutie odkazu na prílohu poznámky, ak je to možné.
Adresa URL Vráti cestu adresy URL vstavaného popisovača príloh. Ak má používateľ povolenie a poznámka má pripojený súbor, žiadosť na túto adresu URL stiahne prílohu súboru poznámky.

Poznámka

Dodatočné filtre

Hodnota množiny možností

Hodnoty atribútu množiny možností/zoznamu sa vrátia ako referenčné objekty priradenej tabuľky s nasledujúcimi atribútmi.

Atribút Popis
Označenie Lokalizované označenie hodnoty atribútu množiny možností/zoznamu. Napríklad Aktívny
Hodnota Celočíselná hodnota atribútu množiny možností/zoznamu. Napríklad 0

Povolenia tabuľky

Objekt povolenia tabuľky poskytuje prístup k výsledkom súhrnného povolenia pre tabuľku.

Atribút Popis
can_append Vracia hodnotu true, ak aktuálny používateľ nemá povolenie na pripojenie záznamov do vzťahov tohto záznamu. V opačnom prípade vráti hodnotu False.
can_append_to Vracia hodnotu pravda, ak aktuálny používateľ má povolenie na pripojenie záznamov do vzťahov inej tabuľky. V opačnom prípade vráti hodnotu False.
can_create Vracia hodnotu pravda, ak aktuálny používateľ má povolenie na vytvorenie nového záznamu tohto typu tabuľky. V opačnom prípade vráti hodnotu False.
can_delete Vracia hodnotu true, ak aktuálny používateľ nemá povolenie na odstránenie tohto záznamu. V opačnom prípade vráti hodnotu False.
can_read Vracia hodnotu true, ak aktuálny používateľ nemá povolenie na čítanie tohto záznamu. V opačnom prípade vráti hodnotu False.
can_write Vracia hodnotu true, ak aktuálny používateľ nemá povolenie na aktualizáciu tohto záznamu. V opačnom prípade vráti hodnotu False.
rules_exist Vracia hodnotu true, ak sú výsledky povolení, ktorý tento objekt predstavuje, výsledkom explicitne definovaných pravidiel povolení. Vráti hodnotu false, ak ide o predvolené výsledky pri absencii explicitne definovaných povolení.

Reflexívny vzťah

Vrátia sa pokúša načítať zvratné (t. j. samoreferenčných) vzťahov entít ako objekty s nasledovnými atribútmi.

Atribút Popis
is_reflexive Vráti hodnotu true. Možno otestovať, či objektu vráteného vzťahom predstavujú objekt s reflexívnym vzťahom.
odkazované Vráti pole odkazovaných entít pre zadaný vzťah.
odkazovanie Vráti pole referenčnej tabuľky pre zadaný vzťah. Vracia hodnotu null, ak neexistuje referenčná tabuľka. Ak je vzťah many-to-many (n), vráti sa pole referenčných entít.

zoznam entít

Objekt entitylist sa používa v rámci označení tabuľky Dataverse. Poskytuje prístup k všetkým atribútom daného zoznamu.

Atribúty

Poznámka

subjektov

Atribút Popis
create_enabled Vracia hodnotu pravda, ak vytváranie nových záznamov je nakonfigurované pre zoznam. V opačnom prípade vráti hodnotu False.
create_url Vráti nakonfigurovanú cestu adresy URL na vytvorenie odkazu/tlačidla pre zoznam.
detail_enabled Vracia hodnotu pravda, ak podrobné zobrazenie jednotlivých záznamov je nakonfigurované pre zoznam. V opačnom prípade vráti hodnotu False.
detail_id_parameter Vráti hodnotu názvu parametra reťazca dotazu pre záznam ID pri vytváraní adresy URL podrobného zobrazenia záznamu. Pozrite si Filtre adresy URL, kde nájdete podrobnosti o spôsobe využitia menlivých filtrov na vytváranie adries URL. Príklad: id
detail_label Vráti nakonfigurované lokalizované označenie pre odkazy/tlačidlá podrobného zobrazenia pre zoznam.
detail_url Vráti nakonfigurovanú cestu URL pre odkazy/tlačidlá podrobného zobrazenia pre zoznam.
empty_list_text Vráti nakonfigurovaný lokalizovaný text na zobrazenie v prípade, že zobrazenie zoznamu nevráti žiadne výsledky.
enable_entity_permissions Vracia hodnotu pravda, ak je pre tento zoznam povolené filtrovanie povolení tabuľky. V opačnom prípade vráti hodnotu False.
entity_logical_name Vráti logický názov tabuľky systému Dataverse pre záznamy, ktoré sa zobrazia týmto zoznamom. Príklad: kontakt
filter_account_attribute_name Vráti logický názov atribútu pre vyhľadávanie účtu, ktorý sa používa na filtrovanie výsledkových záznamov podľa nadradený obchodný vzťah aktuálneho užívateľa portálu. Príklad: accountid
filter_apply_label Vráti nakonfigurované lokalizované označenie na odkaz/tlačidlo, ktoré využíva na výsledky zoznamu entít rozšírený filter atribútov.
filter_definition Vráti pre zoznam definíciu filtra atribútu JSON. Pozrite si filtre zoznamov, kde nájdete podrobnosti o spôsobe používania metafiltrov dynamických filtrov pri spracovaní tejto definície.
filter_enabled Vracia hodnotu pravda, ak je pre zoznam povolené rozšírené filtrovanie atribútov. V opačnom prípade vráti hodnotu False.
filter_portal_user_attribute_name Vráti logický názov atribútu pre vyhľadávanie kontaktu, ktorý sa používa na filtrovanie výsledkových záznamov podľa kontaktu aktuálneho užívateľa portálu. Príklad: id kontaktu
filter_website_attribute_name Vráti logický názov atribútu pre vyhľadávanie adx_website, ktorý sa používa na filtrovanie záznamov výsledkov podľa aktuálnej webovej lokality portálu. Príklad: adx_websiteid
language_code Vráti celé číslo kódu jazyka Dataverse, ktorý sa bude používať na výber všetkých lokalizovaných označení pre tento zoznam.
page_size Vráti nakonfigurovanú výslednú veľkosť stránky pre zoznam.
primary_key_name Vráti logický názov hlavného kľúčového atribútu pre záznamy, ktoré sa zobrazia týmto zoznamom.
search_enabled Vracia hodnotu pravda, ak je pre tento zoznam povolené hľadanie. V opačnom prípade vráti hodnotu False.
search_placeholder Vráti nakonfigurovaný lokalizovaný text pre zástupný symbol poľa hľadania zoznamu.
search_tooltip Vráti nakonfigurovaný lokalizovaný text pre popisy hľadania zoznamu.
zobrazenia Vráti dostupné zobrazenia pre zoznam ako objekty zobrazenia zoznamu.
[logický názov atribútu] Môžete pristupovať k akémukoľvek atribútu záznamu zoznamu (adx_entitylist) Dataverse podľa logického názvu rovnakým spôsobom ako objekt tabuľky. Napríklad: {{ entitylist.adx_name }}

Atribúty zobrazenia zoznamu

Atribút Popis
stĺpce Vráti stĺpce zobrazenia vo forme objektov stĺpcov zobrazenia zoznamu.
entity_logical_name Vráti logický názov tabuľky systému Dataverse pre záznamy zahrnuté v zobrazení. Príklad: kontakt
Id Vráti identifikátor GUID zobrazenia.
language_code Vráti Dataverse celočíselný kód jazyka, ktorý sa používa na výber všetkých lokalizovaných označení (hlavičky stĺpcov atď.) pre zobrazenie.
Name Vráti zobrazovaný názov Dataverse zobrazenia.
primary_key_logical_name Vráti primárny kľúčový logický názov tabuľky systému Dataverse pre záznamy zahrnuté v zobrazení. Príklad: id kontaktu
sort_expression Vráti výraz predvolené zoradenie zobrazenia. Príklad: name ASC, createdon DESC

Atribúty zobrazenia stĺpca zoznamu

Atribút Popis
attribute_type Vráti atribút typu názvu Dataverse pre stĺpec vo forme reťazca. Príklad: vyhľadávanie, zoznam možností, reťazec, boolean, DateTime
logical_name Vráti atribút logického názvu Dataverse pre stĺpec vo forme reťazca. Príklad: createdon
Meno Vráti lokalizovaný zobrazovaný názov Dataverse pre stĺpec. Príklad: Vytvorené
sort_ascending Vráti vyjadrenie zoradenie reťazca pre zoradenie stĺpca vo vzostupnom poradí. Príklad: createdon ASC
sort_descending Vráti vyjadrenie zoradenie reťazca pre zoradenie stĺpca v zostupnom poradí. Príklad: createdon DESC
sort_disabled Vracia hodnotu true, ak je triedenie vypnuté pre stĺpec. V opačnom prípade vráti hodnotu False.
sort_enabled Vracia hodnotu true, ak je triedenie zapnuté pre stĺpec. V opačnom prípade vráti hodnotu False.
šírka Vráti nakonfigurovaný šírku stĺpca v pixeloch.

zobrazenie entity

Objekt entityview sa používa v označení zobrazenia entity a ponúka prístup k metaúdajom tohto zobrazenia, ako aj k výsledkom záznamov.

Atribúty

Atribút Popis
stĺpce Vráti stĺpce v zobrazení vo forme stĺpcových objektov zobrazenia tabuľky.
entity_permission_denied Vracia hodnotu pravda, ak prístup na zobrazenie výsledkov bol odmietnutý z dôvodu nedostatočných povolení tabuľky pre aktuálneho používateľa. Vracia hodnotu false, ak prístup na čítanie zobrazenia výsledkov bol poskytnutý.
entity_logical_name Logický názov tabuľky Dataverse záznamov výsledku zobrazenia. Príklad: kontakt
first_page Číslo strany na prvej strane zobrazenie výsledkov. Toto je 1, pokiaľ neboli vrátené žiadne výsledky, v takom prípade je null.
Id Identifikátor GUID zobrazenia Dataverse, ktorý definuje toto zobrazenie entity.
language_code Celé číslo kódu jazyka Dataverse použité na načítane lokalizovaných označení aktuálneho zobrazenia.
last_page Číslo strany na poslednej strane zobrazenie výsledkov. Ak neboli vrátené žiadne výsledky, táto hodnota je null.
name Názov zobrazenia Dataverse, ktorý definuje toto zobrazenie entity, napr. Aktívne kontakty.
next_page Číslo strany na ďalšej strane zobrazenie výsledkov. Ak neexistuje žiadna ďalšia stránka s výsledkami, táto hodnota je nulová.
Page Číslo strany na aktuálnej strane zobrazenie výsledkov.
stránky Vráti čísla strán, obsahujúce všetky stránky výsledkov pre aktuálne zobrazenie.
page_size Počet výsledkov vrátených na stránku aktuálneho zobrazenia.
previous_page Číslo strany na ďalšej strane zobrazenie výsledkov. Ak neexistuje žiadna predchádzajúca stránka s výsledkami, toto je nulové.
primary_key_logical_name Logický názov Dataverse atribútu primárneho kľúča výsledku tabuľky tohto zobrazenia. Príklad: id kontaktu.
záznamy Aktuálna strana záznamov výsledku pre zobrazenie v podobe objektov tabuľky.
sort_expression Predvolené vyjadrenie zoradenia zobrazenia. Napríklad nameASC, createdon DESC.
total_pages Celkový počet stránok s výsledkami pre zobrazenie.
total_records Celkový počet výsledkov pre zobrazenie (naprieč všetkými stránkami).

udalosti

Umožňuje načítanie a zobrazenie udalostí. Objekt udalosti umožňuje vybrať konkrétnu udalosť alebo všetky udalosti.

Objekt udalosti

Objekt udalosti umožňuje prístup k akejkoľvek udalosti v portáli alebo prístup ku všetkým udalostiam v portáli (bez ohľadu na udalosť).

Objekt udalosti má tieto atribúty:

Atribút Description
opakovaniach Vracia objekt eventoccurancessobject obsahujúci všetky výskyty udalosti na portáli
[názov alebo id udalosti] Môžete otvoriť akúkoľvek udalosť podľa jej názvu alebo ID vlastností.
{% assign event = events["Event Name"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Objekt udalosti

Objekt udalosť umožňuje pracovať s jednou udalosťou, pričom umožňuje prístup plánom a výskytom tejto udalosti.

Objekt udalosť má tieto atribúty:

Atribút Popis
opakovaniach Vracia objekt eventoccurrencesobject obsahujúci všetky výskyty pre udalosť.
meno Názov udalosti.
Adresa URL Adresa URL udalosti.

eventoccurences objekt

Objekt eventoccurrences umožňuje prístup ku kolekcii výskytov objektov udalostí. Môžete si objednať výskyty udalostí a určiť rozsah dátumov pre výskyty, ktoré sa majú načítať, a tiež dosiahnuť stránkovanie pomocou kvapalinových filtrov:

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

Je možná aj nasledujúca možnosť:

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

Nasledujúce atribúty sú spojené s objektom eventoccurrences

Atribút Popis
Všetky Vráti všetky objekty eventoccurance v zbierke.

eventoccurences objekt

Predstavuje výskyt jednej udalosti. Nasledujú súvisiace atribúty:

Atribút Description
URL adresa Adresa URL výskytu.
is_all_day_event Ide o celodennú udalosť?
start_time Čas začiatku udalosti.
end_time Čas ukončenia udalosti.

forloop

Obsahuje vlastnosti, ktoré sú užitočné v rámci bloku slučky for.

Poznámka

forloop môže byť použitý len v rámci značky for.

kód

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

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

{% endif %}

{% endfor %}

Výstup

This is the first child page!

This is child page number 2.

This is child page number 3.

Atribúty

Atribút Opis
1\. Vracia hodnotu true, ak ide o prvé opakovanie v rámci slučky. Vracia hodnotu false, ak nejde o prvé opakovanie v rámci slučky.
index Aktuálna poloha položky v zbierke, kde má prvá položka polohu 1.
index0 Aktuálna poloha položky v zbierke, kde má prvá položka polohu 0.
Posledná Vracia hodnotu true, ak ide o posledné opakovanie v rámci slučky. Vracia hodnotu false, ak nejde o posledné opakovanie v rámci slučky.
dĺžka Vráti počet opakovaní pre slučku ߝ počet položiek v zbierke sa zopakuje.
rindex Počet zostávajúcich položiek v slučke (dĺžka - index) kde 1 predstavuje index poslednej položky.
rindex0 Počet zostávajúcich položiek v slučke (dĺžka - index) kde 0 predstavuje index poslednej položky.

fóra

Umožňuje načítanie a zobrazenie fór a vlákien fóra. Možnosť použiť dynamické prvky na zobrazenie údajov fóra sa vzťahuje na príspevky, no na vytvorenie nového príspevku alebo vlákna musíte použiť šablónu stránky viackrokového formulára ASP.NET s danou funkciou vytvárania (predvolene vlákno fóra a šablóny stránky príspevkov fóra).

Objekt fóra umožňuje vybrať fórum alebo vlákna fóra:

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

Fórum objektu

Fórum objektu umožňuje prístup ku ktorémukoľvek fóru portálu alebo získať prístup k všetkým vláknam fór na portáli (bez ohľadu na fórum).

Objekt fórum umožňuje pracovať s jedným fórom, pričom umožňuje prístup k vláknam tohto fóra.

Objekt forumthreads umožňuje prístup ku kolekcii objektov forumthread. Vlákna fóra si môžete usporiadať a dosiahnuť tiež stránkovanie pomocou menlivých filtrov.

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

Fórum s jedným vláknom

Objekt forumposts umožňuje prístup ku kolekcii objektov forumpost.

Atribúty

Atribút Popis
vlákna Vráti objekt forumthreads obsahujúci všetky objekty forumthread portálu.
Všetky Vráti všetky objekty fóra v portáli. Všimnite si, že website.forums je tiež rovnocenný.
thread_count Vráti celočíselnú hodnotu počtu celkového počtu vlákien na celej webovej stránke.
post_count Vráti celočíselnú hodnotu celkového počtu príspevkov na portáli.
[názov alebo ID fóra] Môžete otvoriť akékoľvek fórum podľa jeho názvu alebo ID vlastností.
`{% assign forum = forums[Forum Name] %}
{% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Objekt fórum

Atribúty

Poznámka

subjektov

Atribút Popis
vlákna Vracia objekt forumthreads obsahujúci všetky vlákna fóra na fóre.
Name Názov fóra.
thread_count Vráti celočíselnú hodnotu počtu celkového počtu vlákien vyskytujúcich sa vo fóre.
post_count Vráti celočíselnú hodnotu počtu celkového počtu príspevkov na celom fóre.

forumthreads objekt

Atribúty

Atribút Popis
Všetky Vráti všetky objekty forumthread v zbierke.

forumthread objekt

Atribúty

Poznámka

subjektov

Atribút Popis
príspevky Vracia objekt forumposts obsahujúci všetky príspevky fóra vo vlákne.
autor Vracia autora pre vlákno (ktorý predstavujú jednoduchý objekt kontaktu tabuľky).
latest_post Vráti posledný príspevok vo vlákne.
first_post Vráti prvý príspevok vo vlákne.
post_count Vráti celočíselnú hodnotu počtu celkového počtu príspevkov vyskytujúcich sa vo vlákne.
is_answered Je vlákno zodpovedané alebo nie?
is_sticky Ide o pripnuté vlákno?

objekt príspevkov vo fóre

Atribúty

Atribút Popis
Všetky Vráti všetky objekty forumthread v zbierke.

Jednotlivý príspevok na fórum

Atribúty

Poznámka

subjektov

Atribút Popis
autor Vracia autora pre príspevok (ktorí predstavuje jednoduchý objekt tabuľky kontaktu).
obsah Obsah príspevku.
is_answer Je tento príspevok odpoveďou na vlákno?

vedomosti

Poskytuje prístup k Dataverse knowledgearticle a záznamom tabuľky kategórie na vykreslenie článkov a kategórií v portáli.

Atribúty

Atribút Popis
články Vráti objekt článkov obsahujúci objekty článkov pre záznamy tabuľky knowledgearticle k dispozícii na portáli.
ocenení Vráti objekty kategórií, ktoré obsahujú objekty kategórií pre záznamy tabuľky kategórie, ktorá je dostupná na portáli.

články objektu

Objekty článkov umožňujú prístup ku kolekcii objektov článkov. Články si môžete usporiadať a dosiahnuť tiež stránkovanie pomocou menlivých filtrov.

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

Atribúty

Atribút Popis
populárne Vráti zbierku článku predmetov obsahujúcich čo najviac názorov. {% assign popular_articles = knowledge.articles.popular %}
nedávne Vráti zbierku článku predmetov obsahujúcich posledný dátum úpravy. {% assign recent_articles = knowledge.articles.recent %}
top Vráti zbierku článku predmetov obsahujúcich najvyššie hodnotenie. {% assign top_articles = knowledge.articles.top %}

Filtre

Tieto filtre môžu prijímať voliteľné parametre pre veľkosť stránky a jazyk. Prvý parameter je číslo alebo záznamov na načítanie. Predvolená veľkosť stránky je 5. Druhý parameter je kód jazyka na získanie článkov pre daný jazyk. Filtre je možné kombinovať s ďalšími Kvapalinovými filtrami.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Atribút Description
populárne Vráti zbierku článku predmetov obsahujúcich čo najviac názorov. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
nedávne Vráti zbierku článku predmetov obsahujúcich posledný dátum úpravy. {% assign recent_articles = knowledge.articles \| recent: 5 %}
top Vráti zbierku článku predmetov obsahujúcich najvyššie hodnotenie. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

Kategórie objektu

Objekt kategórií umožňuje prístup a zber objektov kategórie. Kategórie si môžete usporiadať a dosiahnuť tiež stránkovanie pomocou menlivých filtrov.

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

Atribúty

Atribút Popis
nedávne Vráti zbierku objektov kategórie obsahujúcich posledný dátum úpravy.
top_level Vráti zbierku objektov kategórie, ktoré nemajú nadradenú kategóriu.

Filtre

Tieto filtre môžu prijímať voliteľné parametre určujúce veľkosť stránky. Predvolená veľkosť stránky je 5. Filtre je možné kombinovať s ďalšími Kvapalinovými filtrami.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Atribút Description
nedávne Vráti zbierku objektov kategórie obsahujúcich posledný dátum úpravy. Môžete zadať parametre {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level Vráti zbierku objektov kategórie, ktoré nemajú nadradenú kategóriu. {% assign root_categories = knowledge.categories \| top_level %}

objekt článku

Článok objektov umožňuje pracovať s jedným knowledgearticle na zobrazenie podrobností daného článku v portáli.

Atribúty

Článok je entita objekt so všetkými rovnakými atribútmi, okrem nasledujúcich atribútov:

Atribút Description
article_public_number Verejné číslo článku článku.
comment_count Celočíselná hodnota počtu komentárov k danému článku.
obsah Obsah článku.
current_user_can_comment Vráti hodnotu typu Boolean označujúcu, či aktuálny používateľ môže pridávať komentáre k článku alebo nie.
is_rating_enabled Vráti hodnotu typu boolean označujúca, či je povolené rating na článok.
kľúčové slová Kľúčové slová v článku.
meno Alternatívna prezývka pre názov článku.
hodnotenie Hodnotenieo na desatinné čísla článku.
názov Názov článku.
view_count Celočíselná hodnota počtu zobrazení článku.

Kategórie objektu

Článok objektov umožňuje pracovať s jedným knowledgearticle na zobrazenie podrobností daného článku v portáli.

Atribúty

Kategória je entita objekt so všetkými rovnakými atribútmi, okrem nasledujúcich atribútov:

Atribút Description
Číslo kategórie Číslo kategórie.
meno Alternatívna prezývka pre názov kategórie.
nadpis Názov kategórie.

jazyk

Poskytuje názov aktuálneho jazyka a kód jazyka, ak podpora viacerých jazykov je aktivovaná.

Atribúty

Atribút Popis
URL adresa Adresa URL aktuálnej požiadavky má predponu kódu aktuálneho jazyka.
url_substitution Adresa URL aktuálnej požiadavky s predponou kódu aktuálneho jazyka obchádza výstupnú vyrovnávaciu pamäť stránky.
meno Názov aktuálneho jazyka.
kód Kód jazyka.

Napríklad Rozbaľovací zoznam jazykov webová šablóna v predvolenom nastavení používa tento tekutý objekt na zoznam dostupných jazykov, ak je k dispozícii viac jazykov.

log

Tvorcovia majú možnosť začleniť protokoly do svojho Liquid kódu. Keď je spustená stránka Power pages, denníky pridané výrobcom v kóde Liquid sa zobrazujú v Power Pages rozšírení nástroja pre vývojárov. Tieto denníky vložené výrobcom sa zobrazujú v rozšírení nástroja pre vývojárov, keď je povolené diagnostické nastavenie .

Nasledujúca syntax môže byť použitá v Liquid kóde na zaznamenávanie vlastných správ:

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

Atribúty denníka

Atribút Description
log Názov tekutého objektu
správa Reťazec predstavujúci akékoľvek vlastné správy, ktoré sa majú prihlásiť
úroveň Zaznamenajte správu ako Info, Varovanie alebo Chyba

Príklad:

{% log message: 'Log from Home page' %}

{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}

{% assign contacts = query.results.entities %}

{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %} 
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}

stránka

Odkazuje na aktuálnej stránke portál žiadosť. Objekt kombinuje atribúty mapy lokality a aktuálnej požiadavky entity (obyčajne ide o webovú stránku).

Objekt stránky poskytuje prístup k veciam, akými sú prvky breadcrumbs na aktuálnej stránke, názov alebo adresa URL aktuálnej stránky a akékoľvek ďalšie atribúty alebo súvisiace entity príslušného záznamu 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 }}. -->

Atribúty stránky

Poznámka

subjektov

Atribút Popis
Navigačné prvky breadcrumb Vráti objekt uzla mapy lokality navigačného prvku breadcrumb pre stránku, ktorá začína v koreňovom uzle mapy lokality a končí v nadradenej časti.
podradené položky Vráti podradenú stránku uzla mapy lokality stránky.
nadradený prvok Vráti uzol nadradenej mapy lokality stránky. Ak je stránka domovskou stránkou, rodič má hodnotu null.
nadpis Názov stránky.
URL adresa Adresa URL stránky.
[názov atribútu alebo vzťahu] Každý atribút stránky patriacej záznamu Dataverse podľa logického názvu.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
Hodnoty väčšiny atribútov tabuľky sa mapujú priamo do typov dynamických prvkov: polia dvoch možností sa mapujú do poľa s dvomi možnosťami, textové polia na reťazce, polia čísel/meny k číslam, polia dátumu/času na objekty dátumu. Ale niektoré typy atribútov sa vrátia ako objekty:
  • Polia Lookup (Odkaz na priradenú tabuľku) sa vrátia ako priradené referenčné objekty tabuľky.
  • Množina možností/polia zoznamu možností sa vrátia ako množina možností hodnoty objektu.
  • Môžete tiež nahrať akékoľvek súvisiace entity podľa názvu schémy vzťahu.
    {{ page.adx_webpage_entitylist.adx_name }}
    V prípade, že vzťah je reflexívny (čiže sebareferenčný), vráti sa objekt entít . (V opačnom prípade by bol výsledok dvojzmyselný.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Poznámka: Načítanie veľkého počtu súvisiacich entít alebo prístup k veľkému počtu vzťahov v jednej šablóne môže mať negatívny vplyv na výkon vykresľovania šablón. Vyhnite sa načítavaniu súvisiacich entít pre každú položku v poli v rámci slučky Ak je to možné, uprednostnite použitie značiek tabuľky Dataverse na načítanie kolekcie entít.

Hlasovania

Umožňuje načítanie a zobrazenie ankety.

Objekt ankety umožňuje vybrať konkrétne hlasovanie alebo umiestnenie hlasovania:

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

Atribúty hlasovania

Atribút Popis
umiestnenia Vráti objekt umiestnenia hlasovania.
[názov alebo ID ankety] Môžete otvoriť akékoľvek hlasovanie podľa vlastností názvu alebo identifikácie. {% assign poll = polls[Poll Name] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Atribúty umiestnenia hlasovania

Atribút Popis
[názov alebo ID umiestnenia ankety] Môžete otvoriť akékoľvek umiestnenie hlasovania podľa vlastností názvu alebo identifikácie.{% assign placement = polls.placements[Placement Name or Id] %}
{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Atribúty umiestnenia hlasovania

Poznámka

subjektov

Atribút Popis
Name Vráti pole názvu pre umiestnenie hlasovania.
placement_url Adresa URL, ktoré možno použiť na získanie umiestnenia hlasovania v plnom rozsahu poskytovaných šablóny.
Hlasovania Vráti zbierku objektov hlasovania prepojených s umiestnením. V tejto kolekcii možno použiť iteračné značky a Filtre polí .
random_url Adresa URL, ktoré možno použiť na získanie náhodného hlasovania z umiestnenia v plnom rozsahu poskytovaných šablóny.
submit_url Adresa URL, na ktorú sa odosiela vyplnené hlasovanie.

Atribúty hlasovania

Poznámka

subjektov

Atribút Popis
has_user_voted Vráti hodnotu true, ak aktuálny používateľ (prihlásený alebo anonymný) už v hlasovaní hlasoval.
Meno Vráti pole názvu pre hlasovanie.
možnosti Vráti zbierku objektov hlasovania prepojených s hlasovaním. V tejto kolekcii možno použiť iteračné značky a entity .
poll_url Adresa URL, ktoré možno použiť na získanie hlasovania v plnom rozsahu poskytovaných šablóny.
otázka Vráti pole otázky pre hlasovanie.
submit_button_label Vráti hodnotu typu reťazca, ktorý možno použiť na potlačenie označenia tlačidla odoslať hlasovania.
submit_url Adresa URL, na ktorú sa odosiela vyplnené hlasovanie.
user_selected_option Vráti objekt polloption vybraný používateľom (ak už hlasoval).
hlasy Vráti počet hlasov, ktoré sú uvedené v tabuľke pre prieskum.

Atribúty možnosti hlasovania

Poznámka

subjektov

Atribút Popis
odpoveď Vráti pole odpovede pre hlasovanie.
percento Vráti percentá hlasov v hlasovaní pre možnosť vo forme desatinného čísla od 0 do 100.
hlasy Vráti počet hlasov, ktoré sú uvedené v tabuľke pre možnosť.

žiadosť

Obsahuje informácie o aktuálnych žiadostiach HTTP.

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

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

Poznámka

Atribúty

Atribút Popis
parametre Hodnoty pomenovaného parametra pre aktuálnu požiadavku. parametre sú kombináciou adresy URL parametrov reťazca dotazu, parametrov zverejnenie formuláru a súborov cookies.
Path Cesta aktuálnej adresy URL požiadavky.
/profile/
path_and_query Cesta aktuálnej adresy URL požiadavky a dotazu.
/profile/?foo=1&bar=something
dotaz Časť dotazu aktuálnej požiadavky URL.
?foo=1&bar=something
URL adresa Celá adresa URL aktuálnej požiadavky.
https://www.example.com/profile/?foo=1&bar=something

index vyhľadávania

Objekt searchindex sa používa v rámci značiek tabuľky Dataverse a poskytuje prístup k výsledkom dotazu.

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

Atribúty

Atribút Popis
approximate_total_hits Vráti približný počet celkových výsledkov vyhľadaných indexu. Vzhľadom na spôsob, akým index vyhľadávania funguje s ohľadom na bezpečnostné filtrovanie a ďalšie konštrukčné faktory, je toto číslo len približné a nemusí sa presne zhodovať s celkovým počtom výsledkov dostupných pre aktuálneho používateľa v niektorých situáciách.
Page Vráti číslo strany z aktuálneho dotazu.
page_size Vráti maximálnu veľkosť strany aktuálneho dotazu. Ak chcete, aby sa pre aktuálnu stránku vrátil skutočný počet výsledkov (pretože môže byť menší ako zadaná maximálna veľkosť stránky), použite results.size.
Výsledky Vráti stránku výsledkov dotazu, ako hľadať index výsledok objektov.

Vyhľadať výsledky indexu

Atribút Popis
entita Základné entity na výsledok.
fragment Relevantné krátky text fragment na výsledok s podmienkami zodpovedajúce zadaný dotaz zvýraznený použitím <em> HTML značky. Určité typy dotazov nepodporujú zvýraznené fragmenty, ako sú fuzzy dotazy (~) a dotazy so zástupnými znakmi (*). Táto vlastnosť je v týchto prípadoch nulová.
Id ID tabuľky Dataverse príslušného záznamu pre výsledok vo forme reťazca. Napríklad 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Logický názov tabuľky systému Dataverse základného záznamu pre výsledok. Príklad: adx_webpage
Číslo Počet výsledok, cez všetky stránky s výsledkami, počnúc 1. Napríklad pre prvý výsledok druhej strany výsledkov s veľkosťou strany 10 je táto hodnota 11.
skóre Lucene skóre, výsledku, ako hodnotu s pohyblivou desatinnou čiarkou. Výsledky sa vrátia zoradené podľa tejto hodnoty.
nadpis Názov výsledku.
URL adresa Adresa URL výsledku. Toto sa zvyčajne – ale nie nevyhnutne – stane absolútnou cestou pre aktuálnu aplikáciu, a nie úplnou adresou URL. Napríklad: /articles/article1/

nastavenia

Umožňuje načítať akúkoľvek značku lokality podľa názvu. Ak sa nastavenie so zadaným názvom nenájde, vráti sa null.

Poznámka

Nastavenia sa vracajú ako reťazce, no môžete použiť filtre typov na ich konverziu na iné typy.

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

Mapa lokality

Umožňuje prístup k mape lokality portálu.

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

Atribúty mapy lokality

Atribút Popis
Aktuálne Vráti objekt uzol mapy lokality pre aktuálnu stránku.
Koreň Uzol mapy objektu pre koreň (domáci) stránku webovej stránky sa vracia.

Atribúty uzlu mapy lokality

Atribút Popis
Navigačné prvky Breadcrumb Vráti objekt uzla mapy lokality navigačného prvku breadcrumb pre uzol, ktorá začína v koreňovom uzle mapy lokality a končí v nadradenej časti.
Podradené položky Vráti podradenú stránku Mapa uzol objekty uzla.
Popis Popis/zhrnutie obsahu pre uzol. (Toto pole môže obsahovať HTML.)
Entity Vráti príslušné entity uzla. Ak uzol nemá žiadnu podkladovú tabuľku, táto hodnota je null.
is_sitemap_ancestor Vracia hodnotu true, ak uzol mapy lokality odkazuje na predka aktuálneho uzla mapy lokality, v opačnom prípade pôjde o hodnotu false.
is_sitemap_current Vracia hodnotu true, ak uzol mapy lokality predstavuje aktuálny uzol, v opačnom prípade pôjde o hodnotu false.
Nadradený prvok Vráti nadradenú stránku Mapa uzol objekty uzla. Ak je uzol koreňovým uzlom, rodič má hodnotu null.
Title Názov uzla.
URL adresa Adresa URL uzla.

značky lokalít

Umožňuje načítať akúkoľvek značku lokality podľa názvu. Ak značka stránky existuje, vráti sa objekt značky stránky. Ak sa značka webu s daným názvom nenájde, vráti sa 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 %}

Atribúty značky lokality

Atribút Popis
URL adresa Adresa URL cieľovej značky lokality.
[logický názov atribútu] Každý atribút značky lokality cieľového záznamu Dataverse podľa logického názvu. Napríklad: {{ sitemarker.adx_name }}

zlomky

Umožňuje načítať akékoľvek obsahové zlomky podľa názvu. Ak sa úryvok s daným názvom nenájde, vráti sa null .

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Obsahuje vlastnosti užitočné pre blok slučky Značky iterácie.

Poznámka

tablerowloop môže byť použitý len v rámci značky značiek iterácie.

Atribúty

Atribút Popis
Stĺpec Vráti index aktuálneho riadku začínajúci na 1.
col0 Vráti index aktuálneho riadku začínajúci na 0.
col_first Vráti hodnotu true, ak je aktuálny stĺpec prvým stĺpcom v rade, vráti hodnotu false, ak nie je.
col_last Vráti hodnotu true, ak je aktuálny stĺpec prvým stĺpcom v rade, vráti hodnotu false, ak nie je.
Prvé Vracia hodnotu true, ak ide o prvé opakovanie v rámci slučky. Vracia hodnotu false, ak nejde o prvé opakovanie v rámci slučky.
Index Aktuálna poloha položky v zbierke, kde má prvá položka polohu 1.
index0 Aktuálna poloha položky v zbierke, kde má prvá položka polohu 0.
Posledná Vracia hodnotu true, ak ide o posledné opakovanie v rámci slučky. Vracia hodnotu false, ak nejde o posledné opakovanie v rámci slučky.
Dĺžka Vráti počet opakovaní pre slučku ߝ počet položiek v zbierke sa zopakuje.
Rindex Počet zostávajúcich položiek v slučke (dĺžka - index) kde 1 predstavuje index poslednej položky.
rindex0 Počet zostávajúcich položiek v slučke (dĺžka - index) kde 0 predstavuje index poslednej položky.

User

Odkazuje na aktuálneho používateľa portálu, pričom umožňuje prístup k všetkým atribútom pod záznamom kontaktu Dataverse. Ak nie je prihlásený žiadny používateľ, táto premenná je null.

Používateľ je entita objekt.

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

Poznámka

Verzia vydania Power Pages 9.3.8.x alebo neskoršia bude mať štandardne vynechaný filter Liquid vynútený pre používateľa a objekty Liquid žiadosti. Ak chcete zakázať túto predvolenú konfiguráciu a povoliť tieto objekty Liquid bez vynechania filtra Liquid, pozrite si časť nastavenia portálovej lokality – Site/EnableDefaultHtmlEncoding.

Atribúty

Okrem toho, že má používateľ všetky atribúty objektu entity, má aj nasledovné atribúty.

Atribút Opis
roly Vráti roly, do ktorých používateľ patrí, vo forme poľa.
{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}
Poznámka: Môžete tiež použiť filter has_role na testovanie členstiev jednotlivých rolí.
basic_badges_url Vráti adresu url služby na získanie odznakov používateľa.
Ak chcete používateľovi vykresliť odznaky, musíte zahrnúť značku s atribútmi „data-badge“ a „data-uri“. Vykreslenie odznakov aktuálneho používateľa:
<div data-badge data-uri='{{user.basic_badges_url }}'></div>
Vykreslenie odznakov používateľa podľa ID (premenlivé userid):
`<