Dostupné objekty Liquid

Objekty jazyka Liquid obsahují atributy pro výstup dynamického obsahu na stránku. Například objekt stránky obsahuje atribut nazvaný title, který lze využít pro výstup názvu aktuální stránky.

Pro přístup k atributu objektu podle názvu použijte tečku (.). K vykreslení atributu objektu v šabloně jej uzavřete {{ and }} .

Důležité

Abyste se vyhnuli potenciálním problémům se skriptováním mezi weby (XSS), vždy používejte únikový filtr pro HTML kódování dat kdykoli pomocí Liquid objektů ke čtení nedůvěryhodných dat poskytnutých uživatelem.

{{ page.title }}

K atributům objektu lze také přistupovat pomocí názvu řetězce a []. Tento formát je užitečný v případech, kde je požadovaný atribut určen dynamicky, nebo název atributu obsahuje znaky, mezery, speciální znaky atd., které by při použití tečky (.) uvnitř syntaxe.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Následující objekty lze použít a přistupovat k nim kdekoli, z libovolné šablony.

Object	Description
entities	Umožňuje vám načíst libovolnou tabulku aplikace Microsoft Dataverse pomocí ID. Další informace: entity
nyní	Objekt data a času, který odkazuje na aktuální čas UTC, v době vykreslení šablony. Poznámka:: Webová aplikace portálu ukládá tuto hodnotu do mezipaměti a není pokaždé aktualizována. Další informace: Filtry dat
page	Odkazuje na aktuální stránku požadavku portálu. Objekt stránka poskytuje přístup k objektům, jako jsou popis cesty pro aktuální stránku, název nebo adresa URL aktuální stránky a jakékoli jiné atributy nebo související entity základního záznamu aplikace Dataverse. Další informace: stránka
parametry	Praktický zástupce pro request.params. More information: žádost
request	Obsahuje informace o aktuálním požadavku HTTP. More information: žádost
nastavení	Umožňuje načíst libovolné nastavení webu podle názvu. Další informace: nastavení
sitemap	Umožňuje přístup k mapě webu portálu. Další informace: mapa webu
sitemarkers	Umožňuje načíst libovolné označení webů podle názvu. Další Informace: sitemarkers
snippets	Umožňuje načíst libovolné fragmenty kódu obsahu podle názvu. Další informace: fragmenty kódu
user	Odkazuje na aktuálního uživatele portálu, což umožňuje přístup ke všem atributům základního záznamu kontaktu aplikace Dataverse. Pokud není přihlášen žádný uživatel, tato proměnná je null. Další informace: uživatel
weblinks	Umožňuje načíst libovolnou sadu webových odkazů podle názvu nebo ID. Další informace: odkazy na weby
website	Odkazuje na záznam webu, což umožňuje přístup ke všem atributům záznamu webu Dataverse (adx_website) pro portál. Další informace: web

ads

Umožňuje načtení a zobrazení reklamy.

Objekt ads umožňuje vybrat konkrétní reklamu nebo umístění 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>

Atributy reklam

Atribut	Description
placements	Vrátí objekt adplacements.
[název nebo id reklamy]	Můžete získat přístup k jakékoli reklamě podle jejího názvu nebo ID. {% assign ad = ads[Ad Name] %} {% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Atributy umístění reklamy

Atribut	Description
[název nebo id umístění reklamy]	Můžete získat přístup k jakémukoli umístění reklamy podle jejího názvu nebo ID. {% assign placement = ads.placements[Placement Name or Id] %} {% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Atributy umístění reklamy

Umístění reklamy je objekt tabulky se stejnými obecnými atributy a následujícími atributy:

Atribut	Description
Reklamy	Vrátí kolekci objektů reklam přidružených k umístění. S touto kolekcí lze používat značky interakcí a filtry polí.
Name	Vrátí název pole pro umístění reklamy.
placement_url	Adresa URL, kterou lze použít k načtení umístění reklamy, plně vykresleného pomocí šablony.
random_url	Adresa URL, kterou lze použít k načtení náhodné reklamy z umístění, plně vykresleného pomocí šablony.

Atributy reklamy

Poznámka:

Reklama je objekt tabulky s úplně stejnými atributy (navíc k těm následujícím).

Atribut	Description
ad_url	Adresa URL, kterou lze použít k načtení reklamy, plně vykreslené pomocí šablony.
Copy	Vrátí pole Kopírovat pro reklamu.
image	Vrátí objekt obrázku (pokud existuje) reklamy.
Name	Vrátí pole Název pro reklamu.
open_in_new_window	Vrátí hodnotu true, pokud se má adresa URL určená v redirect_url otevírat v novém okně.
redirect_url	Adresa URL, na kterou je uživatel přesměrován při výběru reklamy.

Atributy obrázku reklamy

Atribut	Description
alternate_text	Vrátí text, který se má zobrazit v atributu alt značky.
height	Vrátí výšku obrázku v pixelech
url	Vrátí zdroj adresy URL obrázku.
šířka	Vrátí šířku obrázku v pixelech

blogs

Umožňuje načítání a zobrazování blogů a blogových příspěvků.

Objekt blogs umožňuje vybrat konkrétní blog nebo příspěvky blogu.

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

Objekt blogs

Objekt blogs umožňuje přístup k jakémukoli konkrétnímu blogu na portálu nebo přístup ke všem příspěvkům blogu na portálu.

Následující tabulka popisuje atributy přidružené k objektu blogs.

Atribut	Popis
posts	Vrátí objekt blogposts, který obsahuje všechny příspěvky blogu na portálu.
[název nebo id blogu]	Můžete získat přístup k jakémukoli blogu podle jeho názvu nebo vlastností ID.

{% assign blog = blogs["Blog Name"] %}                             

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

Objekt blog

Objekt blog umožňuje pracovat s jedním blogem a poskytuje přístup k příspěvkům na tomto blogu.

Následující tabulka popisuje různé atributy přidružené k objektu blog.

Atribut	Popis
posts	Vrátí objekt blogposts, který obsahuje všechny příspěvky na daném blogu.
Name	Název blogu.
title	Nadpis blogu.
url	Adresa URL blogu.

Objekt blogposts

Objekt blogposts umožňuje získat přístup ke kolekci objektů příspěvků blogu. Kromě používání filtrů Liquid můžete také řadit příspěvky blogu a využívat stránkování:

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

Další možnosti:

• blogs.posts.all (pro získání všech blogových příspěvků)
• blogs.posts | from\_index: 0 | take: 2

Následující tabulka popisuje různé atributy přidružené k objektu blogposts.

Atribut	Popis
All	Vrátí všechny objekty blogpost v kolekci.

Objekt blogpost

Odkazuje na jeden příspěvek blogu.

Následující tabulka popisuje různé atributy přidružené k objektu blogpost.

Atribut	Popis
url	Adresa URL příspěvku.
obsah	Vrátí pole obsahu příspěvku.
autor	Vrátí autory příspěvku (což je jednoduše objekt tabulky kontaktu).
nadpis	Název příspěvku.
comment_count	Vrátí celočíselnou hodnotu počtu komentářů k danému příspěvku.
publish_date	Datum publikování příspěvku.

entities

Upozornění

Chcete-li se vyhnout potenciálním problémům se skriptováním mezi weby (XSS), vždy používejte řídicí filtr a kódujte řetězcová data HTML při každém použití objektu Liquid entity pro čtení dat poskytnutých uživatelem, kterým nelze důvěřovat.

Poznámka:

Některé z konvencí tvorby názvů v Dataverse se změnily, např. entity Dataverse se nyní jmenují tabulky. Změny názvu se nevztahují na objekty Liquid. Objekt entity Liquid bude nadále označován jako entita.

Umožňuje vám načíst libovolnou tabulku aplikace Dataverse pomocí ID. Pokud tabulka existuje, je vrácen objekt tabulky. Pokud není tabulka s daným ID nalezena, je vrácena hodnota 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 přístup k atributům záznamu tabulky aplikace Dataverse.

Atribut	Popis
ID	Identifikátor GUID tabulky jako řetězec. Například 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Logický název Dataverse tabulky.
Notes	Načte všechny poznámky (annotation) přidružené k tabulce, seřazené od nejstarší po nejnovější (createdon). Poznámky jsou vráceny jako objekty poznámek.
oprávnění	Načte výsledky kontrolního výrazu oprávnění pro tabulku. Výsledky jsou vráceny jako objekt oprávnění.
adresa URL	Vrátí cestu adresy URL systému pro správu obsahu Power Pages pro tabulku. Pokud tabulka nemá v aktuálním webu žádné platné adresy URL, vrátí null. Obecně toto vrátí hodnotu pro určité typy tabulky, které byly začleněny do portálu CMS , pokud nemáte ve své aplikaci vlastního poskytovatele adres URL.
[název atributu nebo vztahu]	K jakémukoli atributu tabulky aplikace Dataverse můžete přistupovat podle logického názvu. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Hodnoty většiny atributů tabulky se mapují přímo na typy jazyka Liquid: pole se dvěma možnostmi se mapují na logické hodnoty, textová pole na řetězce, pole numerických hodnot / měny na čísla, pole data a času na objekty data. Avšak některé typy atributů jsou vráceny jako objekty: Vyhledávací pole (přidružený odkaz na tabulku) jsou vrácena jako referenční objekty přidružené tabulky. Pole Sada možností / Rozevírací seznam jsou vrácena jako objekty s hodnotou sady možností. Všechny související entity také můžete načíst podle názvu schématu vztahu. {{ page.adx_webpage_entitylist.adx_name }}V případě, že je vztah reflexivní (tj. odkazující sám na sebe), je vrácen objekt reflexního vztahu. (Jinak bude výsledek dvojznačný.){{ page.adx_webpage_webpage.referencing.adx_name }} Poznámka: Načítání velkého množství souvisejících entit nebo přístup k velkému počtu vztahů v jedné šabloně může mít negativní dopad na výkon vykreslování šablony. Vyhněte se načítání souvisejících entit pro každou položku v poli, ve smyčce. Pokud je to možné, raději k načtení kolekcí entit používejte značky tabulky Dataverse.

Odkaz na související tabulku

Hodnoty vyhledávacího atributu jsou vráceny jako referenční objekty přidružené tabulky, s následujícími atributy.

Atribut	Popis
ID	Identifikátor GUID odkazované tabulky jako řetězec. Například 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Logický název Dataverse odkazované tabulky.
Name	Primární název atributu odkazované tabulky.

Poznámka

Poznámka je objekt tabulky, který poskytuje přístup k atributům a vztahům v záznamu typu annotation. Kromě všech atributů objektu tabulky mám poznámka rovněž následující dodatečné atributy.

Atribut	Description
documentbody	Načítá atribut documentbody záznamu annotation poznámky, jako řetězec s kódováním Base64. Jelikož může být obsah tohoto atributu velký, nenačítá se společně s ostatními atributy poznámky, ale načítá se pouze na požádání. Poznámka: Použití atributu documentbody může mít negativní vliv na výkon vykreslování šablony a mělo by být prováděno s opatrností. Pokud je to možné, používejte místo toho k propojení s přílohou poznámky atribut url.
url	Vrátí cestu adresy URL pro vestavěnou obslužnou rutinu přílohy poznámky portálu. Pokud má uživatel oprávnění a poznámka obsahuje připojený soubor, stáhne žádost na tuto adresu URL přílohu souboru poznámky.

Poznámka:

Další filtry

Hodnota sady možností

Atribut Sada možností / Rozevírací seznam jsou vráceny jako referenční objekty přidružené tabulky s následujícími atributy.

Atribut	Popis
Label	Lokalizovaný popisek hodnoty atributu sady možností / rozevíracího seznamu. Například Aktivní
Hodnota	Celočíselná hodnota atributu sady možností / rozevíracího seznamu. Například 0

Oprávnění k tabulkám

Objekt Oprávnění k tabulkám poskytuje přístup k souhrnným výsledkům kontrolního výrazu oprávnění pro tabulku.

Atribut	Description
can_append	Vrací hodnotu true, pokud aktuální uživatel má oprávnění k přidání záznamů do vztahů tohoto záznamu. V opačném případě vrátí hodnotu false.
can_append_to	Vrací hodnotu true, pokud aktuální uživatel má oprávnění k přidání tohoto záznamu do vztahu jiné tabulky. V opačném případě vrátí hodnotu false.
can_create	Vrací hodnotu true, pokud aktuální uživatel má oprávnění k vytváření nových záznamů tohoto typu tabulky. V opačném případě vrátí hodnotu false.
can_delete	Vrací hodnotu true, pokud aktuální uživatel má oprávnění k odstranění tohoto záznamu. V opačném případě vrátí hodnotu false.
can_read	Vrací hodnotu true, pokud aktuální uživatel má oprávnění ke čtení tohoto záznamu. V opačném případě vrátí hodnotu false.
can_write	Vrací hodnotu true, pokud aktuální uživatel má oprávnění k aktualizaci tohoto záznamu. V opačném případě vrátí hodnotu false.
rules_exist	Vrací hodnotu true, pokud výsledky oprávnění reprezentované tímto objektem jsou výsledkem explicitně definovaných pravidel oprávnění. Vrací hodnotu false, pokud jde o výchozí výsledky v případě nepřítomnosti explicitně definovaných oprávnění.

Reflexivní vztah

Pokusy o načtení reflexivních (tj. odkazujících na sebe) vztahů na entity jsou vráceny jako objekty s následujícími atributy.

Atribut	Description
is_reflexive	Vrací hodnotu true. Slouží k testování, zda objekt vrácený vztahem je objektem reflexivního vztahu.
referenced	Vrací pole odkazovaných entit pro daný vztah.
referencing	Vrací odkazující tabulku pro daný vztah. Vrací hodnotu null, pokud neexistuje žádná odkazující tabulka. Pokud jde o vztah N : N, vrací pole odkazující entity.

entitylist

Objekt entitylist se používá ve značkách tabulky Dataverse. Poskytuje přístup ke všem atributům daného seznamu.

Poznámka:

Zobrazení seznamu přidruženého k aktuální stránce

Atributy

Poznámka:

entities

Atribut	Description
create_enabled	Vrátí hodnotu true, je-li nakonfigurováno vytváření nových záznamů pro seznam. V opačném případě vrátí hodnotu false.
create_url	Vrátí nakonfigurovanou cestu adresy URL pro odkaz/tlačítko vytvoření pro seznam.
detail_enabled	Vrátí hodnotu true, je-li nakonfigurováno zobrazení podrobností u jednotlivých záznamů pro seznam. V opačném případě vrátí hodnotu false.
detail_id_parameter	Vrátí název parametru řetězce dotazu, který bude použit pro ID záznamu při vytváření adresy URL pro zobrazení podrobností záznamu. Podrobnosti o používání filtrů Liquid k vytváření adres URL naleznete v tématu Filtry adres URL f. Například id
detail_label	Vrátí nakonfigurovaný lokalizovaný popisek pro odkaz/tlačítka zobrazení podrobností pro seznam.
detail_url	Vrátí nakonfigurovanou cestu adresy URL pro odkaz/tlačítka zobrazení podrobností pro seznam.
empty_list_text	Vrátí nakonfigurovaný lokalizovaný text, který se zobrazí, pokud zobrazení seznamu nevrátí žádné výsledky.
enable_entity_permissions	Vrátí hodnotu true, je-li povoleno filtrování oprávnění k tabulkám pro tento seznam. V opačném případě vrátí hodnotu false.
entity_logical_name	Vrátí logický název tabulky Dataverse pro záznamy, které mají být zobrazeny tímto seznamem. Například contact
filter_account_attribute_name	Vrátí logický název atributu pro vyhledání prvku account, který se použije pro filtrování záznamů výsledků podle nadřazeného obchodního vztahu aktuálního uživatele portálu. Například accountid
filter_apply_label	Vrátí nakonfigurovaný lokalizovaný popisek, který se použije pro odkaz/tlačítko, jež uplatňuje rozšířený filtr atributů na výsledky seznamu.
filter_definition	Vrátí definici filtru atributů JSON pro seznam. V tématu Filtry seznamu naleznete podrobnosti o způsobu používání filtru Liquid typu metafilters pro zpracování této definice.
filter_enabled	Vrátí hodnotu true, je-li povoleno rozšířené filtrování atributů pro seznam. V opačném případě vrátí hodnotu false.
filter_portal_user_attribute_name	Vrátí logický název atributu pro vyhledání prvku contact, který se použije pro filtrování záznamů výsledků podle kontaktu aktuálního uživatele portálu. Například contactid
filter_website_attribute_name	Vrátí logický název atributu pro vyhledání prvku adx_website, který se použije pro filtrování záznamů výsledků podle aktuálního portálového webu. Například adx_websiteid
language_code	Vrátí celočíselný kód jazyka aplikace Dataverse, který se použije k výběru všech lokalizovaných popisků pro tento seznam.
page_size	Vrátí nakonfigurovanou velikost stránky s výsledky pro seznam.
primary_key_name	Vrátí logický název atributu primárního klíče pro záznamy, které mají být zobrazeny tímto seznamem.
search_enabled	Vrátí hodnotu true, je-li povoleno vyhledávání pro tento seznam. V opačném případě vrátí hodnotu false.
search_placeholder	Vrátí nakonfigurovaný lokalizovaný text pro zástupný symbol pole hledání v seznamu.
search_tooltip	Vrátí nakonfigurovaný lokalizovaný text pro popisek hledání v seznamu.
zobrazení	Vrátí dostupná zobrazení pro seznam, jako objekty zobrazení seznamu.
[logický název atributu]	Můžete přistupovat k jakémukoli atributu záznamu Dataverse v rámci seznamu (adx_entitylist) podle logického názvu, a to stejným způsobem jako k objektu tabulky. Například {{ entitylist.adx_name }}

Atributy zobrazení seznamu

Atribut	Description
sloupce	Vrátí sloupce zobrazení jako objekty sloupců zobrazení seznamu.
entity_logical_name	Vrátí logický název tabulky Dataverse pro záznamy obsažené v zobrazení. Například contact
ID	Vrátí GUID identifikátor zobrazení.
language_code	Vrátí celočíselný kód jazyka aplikace Dataverse, který se použije k výběru všech lokalizovaných popisků (záhlaví sloupců atd.) pro zobrazení.
Name	Vrátí název zobrazení používaný aplikací Dataverse.
primary_key_logical_name	Vrátí logický název primárního klíče tabulky Dataverse pro záznamy obsažené v zobrazení. Například contactid
sort_expression	Vrátí výchozí výraz řazení pro zobrazení. Například name ASC, createdon DESC

Atributy sloupců zobrazení seznamu

Atribut	Description
attribute_type	Vrátí název typu atributu aplikace Dataverse pro sloupec, jako řetězec. Například Lookup, Picklist, String, Boolean, DateTime
logical_name	Vrátí logický název atributu aplikace Dataverse pro sloupec. Například createdon
Jméno	Vrátí lokalizovaný název zobrazení aplikace Dataverse pro sloupec. Například Created On
sort_ascending	Vrátí řetězec výrazu řazení pro řazení sloupců ve vzestupném pořadí. Například createdon ASC
sort_descending	Vrátí řetězec výrazu řazení pro řazení sloupců v sestupném pořadí. Například createdon DESC
sort_disabled	Vrátí hodnotu true, je-li řazení sloupců zakázáno. V opačném případě vrátí hodnotu false.
sort_enabled	Vrátí hodnotu true, je-li řazení sloupců povoleno. V opačném případě vrátí hodnotu false.
width	Vrátí nakonfigurovanou šířku sloupce v pixelech.

entityview

Objekt entityview se používá v rámci značky entityview a poskytuje kromě záznamů výsledků zobrazení přístup i k metadatům pro zobrazení.

Atributy

Atribut	Popis
sloupce	Vrátí sloupce v zobrazení, jako objekty sloupců zobrazení tabulky.
entity_permission_denied	Vrátí hodnotu true, pokud byl odepřen přístup k zobrazení výsledků z důvodu nedostatečných oprávnění k tabulce pro aktuálního uživatele. Vrátí hodnotu false, pokud byl udělen přístup pro čtení za účelem zobrazení výsledků.
entity_logical_name	Logický název tabulky Dataverse pro záznamy výsledků zobrazení. Například contact
first_page	Číslo stránky na první stránce výsledků zobrazení. Tato hodnota je 1, pokud nebyly vráceny žádné výsledky, v tom případě je null.
ID	Identifikátor GUID zobrazení aplikace Dataverse, který definuje tento objekt entityview.
language_code	Celočíselný kód jazyka aplikace Dataverse použitý k načtení lokalizovaných popisků pro aktuální zobrazení.
last_page	Číslo stránky na poslední stránce výsledků zobrazení. Pokud nebyly vráceny žádné výsledky, tato hodnota je null.
jméno	Název zobrazení aplikace Dataverse, který definuje tento objekt entityview, například Active Contacts.
next_page	Číslo stránky na další stránce výsledků zobrazení. Pokud žádná další stránka výsledků neexistuje, tato hodnota je null.
Stránka	Číslo stránky na aktuální stránce výsledků zobrazení.
pages	Vrátí pole čísel stránek obsahující všechny stránky výsledků pro aktuální zobrazení.
page_size	Počet výsledků vrácených na stránku pro aktuální zobrazení.
previous_page	Číslo stránky na další stránce výsledků zobrazení. Pokud žádná předchozí stránka výsledků neexistuje, tato hodnota je null.
primary_key_logical_name	Logický název v aplikaci Dataverse pro atribut primárního klíče tabulky výsledků pro toto zobrazení. Například contactid.
záznamů	Aktuální stránka záznamů výsledků pro zobrazení, jako objektů tabulky.
sort_expression	Výchozí výraz řazení pro zobrazení. Například nameASC, createdon DESC.
celkem stránek	Celkový počet stránek výsledků pro zobrazení.
total_records	Celkový počet výsledků pro zobrazení (napříč všemi stránkami).

events

Umožňuje načtení a zobrazení událostí. Objekt events umožňuje vybrat konkrétní událost nebo všechny události.

Objekt events

Objekt events umožňuje přístup k jakékoli konkrétní události na portálu nebo přístup ke všem událostem na portálu (bez ohledu na událost).

Objekt events má následující atributy:

Atribut	Description
výskytech	Vrátí objekt eventoccurancessobject, který obsahuje všechny výskyty událostí na portálu.
[název nebo id události]	Můžete získat přístup k jakékoli události podle jejího názvu nebo vlastností ID. {% assign event = events["Event Name"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Objekt event

Objekt event umožňuje pracovat s jednou událostí a poskytuje přístup k plánům a výskytům této události.

Objekt event má následující atributy:

Atribut	Popis
výskytech	Vrátí objekt eventoccurrencesobject, který obsahuje všechny výskyty pro událost.
name	Název události.
url	Adresa URL události.

Objekt eventoccurences

Objekt eventoccurrences umožňuje získat přístup ke kolekci objektů výskytů událostí. Výskyty událostí můžete uspořádat a také lze zadat rozsah dat pro získání výskytů. Pomocí filtrů jazyka Liquid lze rovněž dosáhnout stránkování:

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

Je také možná následující možnost:

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

Následující atributy jsou spojené s objektem eventoccurrences.

Atribut	Popis
All	Vrátí všechny objekty eventoccurance v kolekci.

Objekt eventoccurence

Představuje výskyt jedné události. Má následující přidružené atributy:

Atribut	Description
adresa URL	Adresa URL výskytu.
is_all_day_event	Jedná se o celodenní událost?
start_time	Čas začátku události.
end_time	Čas konce události.

forloop

Obsahuje vlastnosti, které jsou užitečné v bloku smyčky pro.

Poznámka:

forloop lze použít pouze 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.

Atributy

Atribut	Popis
1\.	Vrátí hodnotu true, pokud se jedná o první iteraci smyčky. Vrátí hodnotu false, pokud se nejedná o první iteraci.
index	Aktuální umístění položky v kolekci, kde má první položka pozici 1.
index0	Aktuální umístění položky v kolekci, kde má první položka pozici 0.
Last	Vrátí hodnotu true, pokud se jedná o poslední iteraci smyčky. Vrátí hodnotu false, pokud se nejedná o poslední iteraci.
length	Vrátí počet iterací smyčky ߝ počet položek v kolekci, kde probíhají iterace.
rindex	Počet položek, které zbývají ve smyčce (délka – index), kde 1 je index poslední položky.
rindex0	Počet položek, které zbývají ve smyčce (délka – index), kde 0 je index poslední položky.

forums

Umožňuje načítání a zobrazování fór a diskusních vláken. Možnost používat jazyk Liquid k zobrazení dat fóra platí i pro příspěvky, ale pro vytvoření nového příspěvku nebo vlákna je nutné použít šablonu stránky vícekrokových formulářů ASP.NET s uvedenou funkcí, která musí být integrována (jako například výchozí šablony stránek vláken fóra a příspěvků fóra).

Objekt forums umožňuje vybrat fórum nebo 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>

Objekt forums

Objekt forums umožňuje přístup k jakémukoli konkrétnímu fóru na portálu nebo přístup ke všem vláknům fóra na portálu (bez ohledu na fórum).

Objekt forum umožňuje pracovat s jedním fórem a poskytuje přístup k vláknům tohoto fóra.

Objekt forumthreads umožňuje získat přístup ke kolekci objektů forumthread. Můžete řadit vlákna fóra a rovněž využívat stránkování pomocí filtrů Liquid.

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

Jedno vlákno fóra

Objekt forumposts umožňuje získat přístup ke kolekci objektů forumpost.

Atributy

Atribut	Popis
threads	Vrátí objekt forumthreads, který obsahuje všechny objekty forumthread na portálu.
All	Vrátí všechny objekty forum na portálu. Uvědomte si, že website.forums je rovněž ekvivalent.
thread_count	Vrátí celočíselnou hodnotu počtu vláken na celém webu.
post_count	Vrátí celočíselnou hodnotu celkového počtu příspěvků na portálu.
[název nebo id fóra]	Můžete získat přístup k jakémukoli fóru podle jeho názvu nebo vlastností ID. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Objekt forum

Atributy

Poznámka:

entities

Atribut	Description
threads	Vrátí objekt forumthreads, který obsahuje všechna vlákna fóra v daném fóru.
Name	Název fóra.
thread_count	Vrátí celočíselnou hodnotu počtu vláken ve fóru.
post_count	Vrátí celočíselnou hodnotu počtu příspěvků v celém fóru.

Objekt forumthreads

Atributy

Atribut	Popis
All	Vrátí všechny objekty forumthread v kolekci.

Objekt forumthread

Atributy

Poznámka:

entities

Atribut	Description
posts	Vrátí objekt forumposts, který obsahuje všechny příspěvky fóra ve vlákně.
author	Vrátí autora vlákna (což je jednoduše objekt tabulky kontaktu).
latest_post	Vrátí poslední příspěvek ve vláknu.
first_post	Vrátí první příspěvek ve vláknu.
post_count	Vrátí celočíselnou hodnotu počtu příspěvků ve vláknu.
is_answered	Je vlákno zodpovězeno nebo ne?
is_sticky	Je vlákno vždy na vrchu?

Objekt forumposts

Atributy

Atribut	Popis
All	Vrátí všechny objekty forumthread v kolekci.

Jeden příspěvek fóra

Atributy

Poznámka:

entities

Atribut	Description
autor	Vrátí autora příspěvku (což je jednoduše objekt tabulky kontaktu).
obsah	Obsah příspěvku.
is_answer	Je tento příspěvek odpovědí na vlákno?

knowledge

Poskytuje přístup k záznamům tabulky knowledgearticle a category Dataverse za účelem vykreslení článků a kategorií v portálu.

Atributy

Atribut	Popis
články	Vrací objekt článků obsahující objekty článků pro záznamy tabulky knowledgearticle, které jsou k dispozici v portálu.
kategorie	Vrací objekt categories obsahující objekty category pro záznamy tabulky category, které jsou k dispozici v portálu.

objekt articles

Objekt articles umožňuje získat přístup ke kolekci objektů článků. Můžete řadit články a rovněž využívat stránkování pomocí filtrů Liquid.

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

Atributy

Atribut	Popis
popular	Vrátí kolekci objektů článků obsahující nejvíce zobrazení. {% assign popular_articles = knowledge.articles.popular %}
recent	Vrátí kolekci objektů článků obsahující datum poslední změny. {% assign recent_articles = knowledge.articles.recent %}
nejlepší	Vrátí kolekci objektů článků obsahující nejvyšší hodnocení. {% assign top_articles = knowledge.articles.top %}

Filtry

Následující filtry mohou přijímat volitelné parametry pro velikost stránky a jazyk. První parametr je číslo nebo záznamy, které chcete načíst. Výchozí velikost stránky je 5. Druhý parametr je kód jazyka k načtení článků pro daný jazyk. Filtry mohou být kombinovány s jinými filtry Liquid.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}

Atribut	Description
popular	Vrátí kolekci objektů článků obsahující nejvíce zobrazení. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
recent	Vrátí kolekci objektů článků obsahující datum poslední změny. {% assign recent_articles = knowledge.articles \| recent: 5 %}
nejlepší	Vrátí kolekci objektů článků obsahující nejvyšší hodnocení. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

objekt categories

Objekt categories umožňuje získat přístup ke kolekci objektů kategorie. Kategorie můžete řadit a rovněž využívat stránkování pomocí filtrů Liquid.

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

Atributy

Atribut	Popis
recent	Vrátí kolekci objektů kategorie obsahující datum poslední změny.
top_level	Vrací kolekci objektů kategorie, které nemají nadřazené kategorie.

Filtry

Následující filtry mohou přijímat volitelný parametr pro velikost stránky. Výchozí velikost stránky je 5. Filtry mohou být kombinovány s jinými filtry Liquid.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}

Atribut	Description
recent	Vrátí kolekci objektů kategorie obsahující datum poslední změny. Můžete zadat parametry {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level	Vrací kolekci objektů kategorie, které nemají nadřazené kategorie. {% assign root_categories = knowledge.categories \| top_level %}

Objekt article

Objekt article vám umožňuje pracovat s jedinou knowledgearticle, chcete-li zobrazit podrobnosti tohoto článku na portálu.

Atributy

Article je objekt entity s úplně stejnými atributy, kromě následujících:

Atribut	Description
article_public_number	Veřejné číslo článku.
comment_count	Celočíselná hodnota počtu komentářů k danému článku.
obsah	Obsahu článku.
current_user_can_comment	Vrací logickou hodnotu označující, zda aktuální uživatel může přidávat k článku komentáře.
is_rating_enabled	Vrací hodnotu typu boolean označující, zda je povoleno hodnocení článku.
keywords	Klíčová slova pro tento článek.
Jméno	Alternativní alias pro název článku.
rating	Hodnota desítkového hodnocení článku.
title	Název článku.
view_count	Celočíselná hodnota udávající počet případů zobrazení článku.

Objekt category

Objekt category vám umožňuje pracovat s jedinou kategorií, chcete-li zobrazit její podrobnosti na portálu.

Atributy

Category je objekt entity s úplně stejnými atributy, kromě následujících:

Atribut	Description
categorynumber	Číslo kategorie.
Jméno	Alternativní alias pro název kategorie.
název	Název kategorie.

jazyk

Poskytuje název aktuálního jazyka a kód jazyka, pokud je povolena podpora více jazyků.

Atributy

Atribut	Popis
adresa URL	Aktuální adresa URL požadavku s předponou v podobě kódu aktuálního jazyka.
url_substitution	Aktuální adresa URL požadavku s předponou v podobě kódu aktuálního jazyka obcházející výstupní mezipaměť stránky.
název	Název aktuálního jazyka.
kód	Kód jazyka.

Například webová šablona Rozevírací seznam jazyků ve výchozím nastavení používá tento tekutý objekt k vypsání dostupných jazyků, pokud je k dispozici více jazyků.

protokolovat

Tvůrci mají možnost začlenit příkazy protokolu do svého Liquid kódu. Když je web Power pages spuštěn, protokoly přidané tvůrcem v Liquid kódu jsou zobrazeny v rozšíření Power Pages pro vývojáře. Tyto protokoly vložené tvůrcem se zobrazí v rozšíření vývojářského nástroje, když je povoleno diagnostické nastavení.

K protokolování vlastních zpráv lze v Liquid kódu použít následující syntaxi:

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

Atributy protokolu

Atribut	Description
protokolovat	Název objektu Liquid
zpráva	Řetězec představující jakékoli vlastní zprávy k protokolování
úroveň	Protokolujte zprávu jako Info, Varování nebo Chyba

Pří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 %}

page

Odkazuje na aktuální stránku požadavku portálu. Tento objekt spojuje atributy sitemap a aktuální požadavek na entities (obvykle webová stránka).

Objekt stránka poskytuje přístup k objektům, jako jsou popis cesty pro aktuální stránku, název nebo adresa URL aktuální stránky a jakékoli jiné atributy nebo související entity základního záznamu aplikace 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 }}. -->

Atributy stránky

Poznámka:

entities

Atribut	Description
breadcrumbs	Vrátí popis cesty objektů uzlu mapy webu pro stránku, počínaje kořenovým uzlem mapy webu a konče nadřazeným.
children	Vrátí podřízené objekty uzlu mapy webu v rámci stránky.
parent	Vrátí nadřazený objekt uzlu mapy webu v rámci stránky. Pokud je stránkou domovská stránka, atribut parent je null.
nadpis	Název stránky.
adresa URL	Adresa URL stránky.
[název atributu nebo vztahu]	K jakémukoli atributu základního záznamu aplikace Dataverse na stránce můžete přistupovat podle logického názvu. {{ page.createdon }} {% assign attribute_name = 'name' %} {{ page[attribute_name] }} Hodnoty většiny atributů tabulky se mapují přímo na typy jazyka Liquid: pole se dvěma možnostmi se mapují na logické hodnoty, textová pole na řetězce, pole numerických hodnot / měny na čísla, pole data a času na objekty data. Avšak některé typy atributů jsou vráceny jako objekty: Vyhledávací pole (přidružený odkaz na tabulku) jsou vrácena jako referenční objekty přidružené tabulky. Pole Sada možností / Rozevírací seznam jsou vrácena jako objekty s hodnotou sady možností.. Všechny související entity také můžete načíst podle názvu schématu vztahu. {{ page.adx_webpage_entitylist.adx_name }} V případě, že je vztah reflexivní (tj. odkazující sám na sebe), je vrácen objekt entities. (Jinak bude výsledek dvojznačný.){{ page.adx_webpage_webpage.referencing.adx_name }} Poznámka: Načítání velkého množství souvisejících entit nebo přístup k velkému počtu vztahů v jedné šabloně může mít negativní dopad na výkon vykreslování šablony. Vyhněte se načítání souvisejících entit pro každou položku v poli, ve smyčce. Pokud je to možné, raději k načtení kolekcí entit používejte značky tabulky Dataverse.

polls

Umožňuje načtení a zobrazení průzkumu.

Objekt polls umožňuje vybrat konkrétní hlasování nebo umístění hlasování:

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

Atributy hlasování

Atribut	Description
placements	Vrátí objekt umístění hlasování.
[název nebo id hlasování]	Můžete získat přístup k jakémukoli hlasování podle jeho názvu nebo vlastností ID. {% assign poll = polls[Poll Name] %} {% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Atributy umístění hlasování

Atribut	Description
[název nebo id umístění hlasování]	Můžete získat přístup k jakémukoli umístění hlasování podle jeho názvu nebo vlastností ID.{% assign placement = polls.placements[Placement Name or Id] %} {% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Atributy umístění hlasování

Poznámka:

entities

Atribut	Description
Name	Vrátí název pole pro umístění hlasování.
placement_url	Adresa URL, kterou lze použít k načtení umístění hlasování, plně vykresleného pomocí šablony.
polls	Vrátí kolekci objektů hlasování přidružené k umístění. S touto kolekcí lze používat značky interakcí a filtry polí.
random_url	Adresa URL, kterou lze použít k načtení náhodného hlasování z umístění, plně vykresleného pomocí šablony.
submit_url	Adresa URL, na kterou se předkládá dokončené dotazování.

Atributy hlasování

Poznámka:

entities

Atribut	Description
has_user_voted	Vrátí hodnotu true, pokud se aktuální uživatel (přihlášený nebo anonymní) již v tomto hlasování vyslovil.
Jméno	Vrátí název pole pro hlasování.
options	Vrátí kolekci objektů možností hlasování přidružených k hlasování. Značky iterace a entity mohou být použity s touto kolekcí.
poll_url	Adresa URL, kterou lze použít k načtení hlasování, plně vykresleného pomocí šablony.
question	Vrátí název pole dotazu pro hlasování.
submit_button_label	Vrátí řetězec, který lze použít k přepsání popisku tlačítka Odeslat pro hlasování.
submit_url	Adresa URL, na kterou se předkládá dokončené dotazování.
user_selected_option	Vrátí objekt možností hlasování vybraný uživatelem (pokud již hlasoval).
votes	Vrátí počet hlasů, které jsou zahrnuty do tabulky pro hlasování.

Atributy možností hlasování

Poznámka:

entities

Atribut	Description
answer	Vrátí název pole odpovědi pro hlasování.
percentage	Vrátí procenta hlasů v hlasování pro možnost jako desetinné číslo od 0 do 100.
votes	Vrátí počet hlasů, které jsou zahrnuty do tabulky pro možnost.

request

Obsahuje informace o aktuálním požadavku HTTP.

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

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

Poznámka:

• Je možné vytvořit adresy URL dynamicky v jazyce Liquid pomocí URL filtrů.
• Adresa URL použitá v request.url může být libovolná požadovaná hodnota a uloží se do mezipaměti pro následné žádosti. Chcete-li zajistit správnou hodnotu v request.url, zvažte použití substituční značky, částečné adresy URL, například ~{Cesta webového souboru} nebo uložení URL portálu do Nastavení webu.
• Power Pages ve verzi vydání 9.3.8.x nebo novější bude mít ve výchozím nastavení zapnutý filtr Liquid escape pro objekty Liquid typu user a request. Chcete-li vypnout tuto výchozí konfiguraci a povolit tyto objekty Liquid bez filtru Liquid escape, návod najdete v nastavení webu portálu - Site/EnableDefaultHtmlEncoding.

Atributy

Atribut	Popis
parametry	Pojmenované hodnoty parametru pro aktuální požadavek. params je kombinací parametrů řetězce dotazu adresy URL, parametrů formuláře příspěvku a souborů cookie.
Path	Cesta aktuálního požadavku na adresu URL. /profile/
path_and_query	Cesta a dotaz aktuálního požadavku na adresu URL. /profile/?foo=1&bar=something
query	Část dotazu aktuálního požadavku na adresu URL. ?foo=1&bar=something
adresa URL	Plná adresa URL aktuálního požadavku. https://www.example.com/profile/?foo=1&bar=something

searchindex

Objekt searchindex se používá ve značkách tabulek Dataverse a poskytuje přístup k výsledkům 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 %}

Atributy

Atribut	Description
approximate_total_hits	Vrací přibližný celkový počet výsledků odpovídající dotazu indexu. Z důvodu způsobu fungování vyhledávacího indexu v souvislosti s filtrováním zabezpečení a s jinými faktory návrhu je číslo pouze přibližný odhad a v některých situacích nemusí přesně odpovídat celkovému počtu výsledků dostupných pro aktuálního uživatele.
Stránka	Vrátí číslo stránky aktuálního dotazu.
page_size	Vrátí maximální velikost stránky aktuálního dotazu. Pokud chcete skutečný počet výsledků vrácených pro aktuální stránku (protože může být menší než zadaná maximální velikost stránky), použijte results.size.
results	Vrátí stránku výsledků dotazu jako objekty výsledků indexu hledání.

Výsledky indexu hledání

Atribut	Popis
entity	Základní entity pro výsledek.
fragment	Odpovídající krátký fragment textu pro výsledek, s podmínkami odpovídajícími zadanému dotazu zvýrazněnému pomocí značky HTML <em>. Určité typy dotazů nepodporují zvýrazněné fragmenty, například přibližné dotazy (~) a dotazy se zástupnými znaky (*). V těchto případech má tato vlastnost hodnotu null.
ID	ID tabulky Dataverse základního záznamu pro výsledek, jako řetězec. Například 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Logický název tabulky Dataverse základního záznamu pro výsledek. Například adx_webpage
Číslo	Počet výsledků napříč všemi stránkami výsledků, počínaje 1. Například pro první výsledek druhé stránky výsledků, s velikostí stránky 10, tato hodnota je 11.
score	Skóre Lucene výsledku jako hodnota s plovoucí desetinnou čárkou. Pomocí této hodnoty jsou vráceny seřazené výsledky.
nadpis	Název výsledku.
adresa URL	Adresa URL pro výsledek. Toto bude obvykle – ale ne nezbytně – absolutní cesta pro aktuální aplikaci, nikoli úplná adresa URL. Příklad: /articles/article1/

nastavení

Umožňuje načíst libovolné nastavení webu podle názvu. Pokud není nastavení se zadaným názvem nalezeno, bude vrácena hodnota null.

Poznámka:

Nastavení jsou vrácena jako řetězce, ale můžete použít filtry typu k převedení na jiné 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 %}

Poznámka:

Zobrazení záhlaví webu a primárního navigačního panelu

sitemap

Umožňuje přístup k mapě webu 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 %}

Atributy mapy webu

Atribut	Popis
Current	Vrátí objekt uzlu mapy webu pro aktuální stránku.
Root	Vrátí objekt uzlu mapy webu pro kořenovou (domovskou) stránku webu.

Atributy uzlu mapy webu

Atribut	Popis
Popis cesty	Vrátí popis cesty objektů uzlu mapy webu pro uzel, počínaje kořenovým uzlem mapy webu a konče nadřazeným.
Children	Vrátí podřízené objekty uzlu mapy webu uzlu.
Description	Popis nebo shrnutí obsahu uzlu. (Toto pole může obsahovat HTML).
Entity	Vrátí základní entity uzlu. Pokud uzel nemá žádnou základní tabulku, tato hodnota je null.
is_sitemap_ancestor	Vrátí hodnotu true, pokud uzel mapy webu je nadřazený prvek aktuálního uzlu, jinak false.
is_sitemap_current	Vrátí hodnotu true, pokud uzel mapy webu je aktuální uzel, jinak false.
Nadřazený prvek	Vrátí nadřazený objekt uzlu mapy webu uzlu. Pokud je uzel kořenový uzel, atribut parent je null.
Titulek	Název uzlu.
adresa URL	Adresa URL uzlu.

sitemarkers

Umožňuje načíst libovolné označení webu podle názvu. Existuje-li označení webu, je vrácen objekt sitemarker. Pokud není tvůrce webu se zadaným názvem nalezen, je vrácena hodnota 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 %}

Poznámka:

Zobrazení záhlaví webu a primárního navigačního panelu

Atributy označení webu

Atribut	Description
adresa URL	Adresa URL cíle označení webu.
[logický název atributu]	K jakémukoli atributu cíle označení webu v rámci záznamu aplikace Dataverse můžete přistupovat podle logického názvu. Například {{ sitemarker.adx_name }}

snippets

Umožňuje načíst libovolné fragmenty kódu obsahu podle názvu. Pokud není fragment kódu se zadaným názvem nalezen, je vrácena hodnota null.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Obsahuje vlastnosti, které jsou užitečné v rámci bloku smyčky Iteration tags.

Poznámka:

tablerowloop lze použít pouze v rámci značky značek iterace.

Atributy

Atribut	Popis
Col	Vrátí index aktuálního řádku počínaje 1.
col0	Vrátí index aktuálního řádku počínaje 0.
col_first	Vrátí hodnotu true, pokud je aktuální sloupec první v řádku; vrátí hodnotu false, pokud není.
col_last	Vrátí hodnotu true, pokud je aktuální sloupec poslední v řádku; vrátí hodnotu false, pokud není.
První	Vrátí hodnotu true, pokud se jedná o první iteraci smyčky. Vrátí hodnotu false, pokud se nejedná o první iteraci.
Index	Aktuální umístění položky v kolekci, kde má první položka pozici 1.
index0	Aktuální umístění položky v kolekci, kde má první položka pozici 0.
Last	Vrátí hodnotu true, pokud se jedná o poslední iteraci smyčky. Vrátí hodnotu false, pokud se nejedná o poslední iteraci.
Length	Vrátí počet iterací smyčky ߝ počet položek v kolekci, kde probíhají iterace.
Rindex	Počet položek, které zbývají ve smyčce (délka – index), kde 1 je index poslední položky.
rindex0	Počet položek, které zbývají ve smyčce (délka – index), kde 0 je index poslední položky.

Uživatelská

Odkazuje na aktuálního uživatele portálu, což umožňuje přístup ke všem atributům základního záznamu kontaktu aplikace Dataverse. Pokud není přihlášen žádný uživatel, tato proměnná je null.

User je objekt entity.

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

Poznámka:

Power Pages ve verzi vydání 9.3.8.x nebo novější bude mít ve výchozím nastavení zapnutý filtr Liquid escape pro objekty Liquid typu user a request. Chcete-li vypnout tuto výchozí konfiguraci a povolit tyto objekty Liquid bez filtru Liquid escape, návod najdete v nastavení webu portálu - Site/EnableDefaultHtmlEncoding.

Atributy

Kromě všech atributů objektu entity má objekt user rovněž následující atributy.

Atribut	Popis
role	Vrátí role, do kterých uživatel patří, jako pole. {% if user.roles contains 'Administrators' %} User is an administrator. {% endif %} Poznámka:: můžete použít také filtr has_role k testování členství v jednotlivých rolích.
basic_badges_url	Vrátí adresu url služby k načtení odznaků uživatele. K vykreslení odznaků pro uživatele musíte zahrnout značku s atributy „data-badge“ a „data-uri“. Vykreslení odznaků aktuálního uživatele: <div data-badge data-uri='{{user.basic_badges_url }}'></div> K vykreslení odznaků uživatele pomocí id (variabilní userid): <div data-badge data-uri='{{user.basic_badges_url

weblinks

Umožňuje načíst libovolné webové odkazy podle názvu nebo ID.

Sada webových odkazů existuje, je vrácen objekt sady webových odkazů. Pokud sada webových odkazů se zadaným názvem nebo ID není nalezena, je vrácena hodnota null.

<!-- Load web link set by ID -->

{{ weblinks[page.adx_navigation.id].name }}

<!-- Load web link set by name -->

{% assign nav = weblinks[Primary Navigation] %}

{% if nav %}

<h1>{{ nav.title | escape }}</h1>

<ul>

{% for link in nav.weblinks %}

<li>

<a href={{ link.url | escape }} title={{ link.tooltip | escape }}>

{% if link.image %}

<img src={{ link.image.url | escape }} alt={{ link.image.alternate_text | escape }} />

{% endif %}

{{ link.name | escape }}

</a>

</li>

{% endfor %}

</ul>

{% endif %}

Poznámka:

Zobrazení záhlaví webu a primárního navigačního panelu |

Atributy sady webových odkazů

Poznámka:

Sada webových odkazů je objekt entity s úplně stejnými atributy kromě následujících.

Atribut	Description
Kopírování	Kopie HTML sady webových odkazů.
Name	Název sady webových odkazů.
Title	Nadpis sady webových odkazů.
Weblinks	Pole objektů webových odkazů přidružených k sadě webových odkazů.
[logický název atributu]	K jakémukoli atributu sady webových odkazů v rámci záznamu aplikace Dataverse můžete přistupovat podle logického názvu. Například {{ weblinkset.createdon }}

Atributy webových odkazů

Poznámka:

Webový odkaz je objekt entity s úplně stejnými atributy kromě následujících.

Atribut	Description
Description	Popis HTML webového odkazu.
display_image_only	Logický atribut určující, zda má být webový odkaz zobrazen jen jako obrázek, bez textu odkazu.
display_page_child_links	Logický atribut určující, zda by měl webový odkaz zobrazovat odkazy na podřízené stránky mapy webu propojené stránky jako dílčí odkazy.
Image	Objekt obrázku webového odkazu pro tento odkaz. Tento atribut má hodnotu null, pokud není k dispozici žádný obrázek.
is_external	Logický atribut určující, zda cílová adresa URL webového odkazu vede na externí web (nikoli na vnitřní stránku portálu).
is_sitemap_ancestor	Vrátí hodnotu true, pokud reference adresy URL odkazují na nadřazený prvek aktuálního uzlu mapy webu, jinak false.
is_sitemap_current	Vrátí hodnotu true, pokud reference adresy URL odkazují na aktuální uzel mapy webu, jinak false.
Jméno	Název/nadpis webového odkazu.
Nofollow	Logický atribut určující, zda má být webový odkaz označen jako rel=nofollow.
open_in_new_window	Logický atribut určující, zda se má webový odkaz po výběru otevírat v novém okně / na nové kartě prohlížeče.
Popisek	Text popisku pro webový odkaz.
Adresa URL	Adresa URL webového odkazu.
Weblinks	Pole podřízených objektů webových odkazů přidružených k webovému odkazu.
[logický název atributu]	K jakémukoli atributu webového odkazu v rámci záznamu aplikace Dataverse můžete přistupovat podle logického názvu. Například {{ weblink.createdon }}

Atributy obrázků webových odkazů

alternate_text	Alternativní text obrázku.
Výška	Celé číslo obsahující zadanou výšku obrázku. Pokud nebyla zadána žádná hodnota výšky, tento atribut je null.
adresa URL	Adresa URL obrázku.
Šířka	Celé číslo obsahující zadanou šířku obrázku. Pokud nebyla zadána žádná hodnota šířky, tento atribut je null.

website

Odkazuje na web portálu, což umožňuje přístup ke všem atributům záznamu webu Dataverse Website (adx_website) pro portál.

Poznámka:

Web je objekt entity se všemi stejnými atributy.

Kód

{{ website.adx_name }} ({{ website.id }})

Výstup

Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)

Atributy

Následující tabulka uvádí atributy této značky, které lze použít k nahrazení výchozích hodnot, aby nedocházelo k ukládání do mezipaměti.

Výchozí	Náhrada (vyhýbá se ukládání do mezipaměti)	Příklad
sign_in_url	sign_in_url_substitution	Výchozí: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F Náhrada (vyhýbá se ukládání do mezipaměti): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F („substitute-page“ v tomto příkladu nahrazuje výchozí URL uloženou v mezipaměti.)
sign_out_url	sign_out_url_substitution	Výchozí: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F Náhrada (vyhýbá se ukládání do mezipaměti): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F („substitute-page“ v tomto příkladu nahrazuje výchozí URL uloženou v mezipaměti.)

Viz také

Typy jazyka Liquid
Značky jazyka Liquid
Filtry jazyka Liquid