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:: Táto hodnota je uložená vo vyrovnávacej pamäti aplikáciou webového portálu a vždy sa neobnovuje. Ď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á bude mať hodnotu 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
Poskytuje možnosť prístupu a vykreslenie 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 atribútmi uvedenými nižšie.
Atribút | Popis |
---|---|
Reklamy | Vráti zbierku objektov reklamy prepojených s umiestnením reklamy. Značky iterácie a Filtre poľa môžu byť použité s touto kolekciou. |
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 s rovnakými atribútmi okrem tých, ktoré sú uvedené nižšie.
Atribút | Popis |
---|---|
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 | Adresu URL, na ktorú sa používateľ presmeruje 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
Poskytuje možnosť prístupu a zobrazenia 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>
–
<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>
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 so zadaný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čítajú sa všetky poznámky (annotation) priradené k tabuľke, zoradené od najstaršej po najnovšiu (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 iba vráti hodnotu pre určité typy tabuliek, ktoré boli začlenené do portálu CMS, pokiaľ nemáte prispôsobenú adresu URL poskytovateľa v aplikácii. |
[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:
{{ page.adx_webpage_entitylist.adx_name }} V prípade, že vzťah je zvratný (t. j. samoreferenčný), vráti sa zvratný vzťah objektu. (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 prepojených entít, alebo prístup k veľkému množstvu vzťahov v jedinej šablóne, môže mať negatívny vplyv na výkon šablóny vykresľovania. 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 poznámka má aj ďalšie nasledujúce atribúty.
Atribút | Popis |
---|---|
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číta sa so zvyškom atribútov poznámky. Načíta sa len na vyžiadanie. Poznámka: Použitie atribútu documentbody môže mať negatívny vplyv na výkon šablóny vykreslenia a mal by sa vykonávať s opatrnosťou. 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 poznámky. |
Poznámka
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í. Vracia hodnotu false, ak sú predvolené výsledkov pri absencii explicitne definované 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
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 na účet, ktorý sa použije na filtrovanie záznamov výsledok aktuálneho nadradeného účtu použí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 na kontakt, ktorý sa použije na filtrovanie záznamov výsledok aktuálneho kontaktu používateľa portálu. Príklad: id kontaktu |
filter_website_attribute_name | Vráti logický názov atribútu pre vyhľadávanie na lokalite adx_website, ktorý sa použije na filtrovanie záznamov výsledok aktuálnej webovej stránky 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 celé číslo kódu jazyka Dataverse, ktorý sa bude používať na výber všetkých lokalizovaných označení (stĺpce, hlavičky 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. To bude 1 pokým nebudú vrátené žiadne výsledky, v tomto prípade to bude null. |
Identifikácia | 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, bude to hodnota null. |
meno | 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 strana výsledkov, hodnota bude null. |
Strana | Čí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 predošlá strana výsledkov, hodnota bude null. |
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
Poskytuje možnosť prístupu a vykreslenie udalosti. 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 | Popis |
---|---|
opakovania | 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í. Výskyty udalostí si môžete usporiadať a stanoviť dátumový rozsah, počas ktorého chcete získať výskyty. Môžete tiež dosiahnuť stránkovanie pomocou menlivých filtrov
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
všimnite si, že
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
že aj to je možné.
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. Priradené atribúty sú uvedené nižšie:
Atribút | Popis |
---|---|
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
Poskytuje možnosť prístupu a zobrazenia fór a vlákien fór. 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
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
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
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 sa môžu spájať s inými menlivý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 | Popis |
---|---|
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 sa môžu spájať s inými menlivými filtrami.
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Atribút | Popis |
---|---|
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 objekt entity so všetkými rovnakými atribútmi okrem tých, ktoré sú uvedené nižšie.
Atribút | Popis |
---|---|
article_public_number | Verejné číslo článku článku. |
comment_count | Celočíselná hodnota počtu celkového počtu komentárov pre daný článok. |
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 koľkokrát článok bol zobrazený. |
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 objekt entity so všetkými rovnakými atribútmi okrem tých, ktoré sú uvedené nižšie.
Atribút | Popis |
---|---|
Čí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.
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
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ánkou domovská stránka, nadradený prvok bude mať 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:
{{ page.adx_webpage_entitylist.adx_name }} V prípade, že je vzťah reflexívny (t. j. samoreferenčný), vráti sa objekt entity. (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 prepojených entít, alebo prístup k veľkému množstvu vzťahov v jedinej šablóne, môže mať negatívny vplyv na výkon šablóny vykresľovania. 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
Poskytuje možnosť prístupu a vykreslenie hlasovania.
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
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. Značky iterácie a Filtre poľa môžu byť použité s touto kolekciou. |
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
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. Značky iterácie a entity môžu byť použité s touto kolekciou. |
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 možnosti hlasovania označený používateľom (ak už hlasovali). |
hlasy | Vráti počet hlasov, ktoré majú v tabuľkách pre hlasovanie. |
Atribúty možnosti hlasovania
Poznámka
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é majú v tabuľkách 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
- Môžete vytvárať adresy URL dynamicky v menlivom prostredí pomocou filtrov URL.
- URL použitá v request.url môže byť ľubovoľná požadovaná hodnota a ukladá sa do medzipamäte pre následné požiadavky. Ak chcete zaistiť správnu hodnotu v request.url, zvážte použitie substitučného označenia, čiastočnej adresy URL, ako napríklad ~ {Cesta k webovému súboru} alebo uloženie adresy URL portálu v nastaveniach lokality.
- 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
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. V dôsledku toho, ako funguje indexu vyhľadávača ide o Filtrovanie zabezpečenia a ostatné design faktory, toto číslo je len približné a nemusia zodpovedať celkový počet výsledkov, ktoré sú k dispozícii aktuálnemu používateľovi 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 skutočný počet výsledkov vrátených pre aktuálnu stránku (pretože to môže byť menej 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. Niektoré typy dotazov nepodporujú zvýraznené fragmenty, napríklad fuzzy dotazy (~) a dotazy so zástupnými znakmi (*). Táto vlastnosť má hodnotu null v týchto prípadoch. |
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 stránke výsledkov, s stránka veľkosti 10, bude táto hodnota 11. |
skóre | Lucene skóre, výsledku, ako hodnotu s pohyblivou desatinnou čiarkou. Výsledky budú vrátené nariadené túto hodnotu. |
názov | 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.) |
Entita | Vráti príslušné entity uzla. Ak uzol nemá základnú tabuľku, hodnota bude 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 uzol je koreňový, nadradený prvok bude mať hodnotu null. |
Pracovná funkcia | Názov uzla. |
Adresa URL | Adresa URL uzla. |
značky lokalít
Umožňuje načítať akúkoľvek značku lokality podľa názvu. Ak existuje značka lokality, vráti sa objekt značky lokality. Ak sa značka lokality so zadaný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 zlomok so zadaným názvom nenájde, vráti sa hodnota 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. |
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á bude mať hodnotu null.
používateľ je objekt entity.
{% 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 otestovanie rol jednotlivých členstiev. |
basic_badges_url | Vráti adresu url služby na získanie odznakov používateľa. Ak chcete vykresliť odznaky pre používateľa 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): `< |