Dostupné objekty Liquid

Objekty jazyka Liquid obsahují atributy pro výstup dynamického obsahu na stránku. Objekt má například page atribut, title který můžete použít k výstupu názvu aktuální stránky.

Pokud chcete získat přístup k atributu objektu podle názvu, použijte tečku (.). Pokud chcete v šabloně vykreslit atribut objektu, zabalte ho do {{ a }}.

Important

Abyste se vyhnuli potenciálním problémům se skriptováním mezi weby (XSS), vždy použijte řídicí filtr pro kódování dat HTML pokaždé, když použijete objekty Liquid ke čtení nedůvěryhodných dat, která uživatel poskytuje.

{{ 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 můžete používat a přistupovat k následujícím objektům kdekoli v libovolné šabloně.

Object	Description
entities	Umožňuje načíst tabulku Microsoft Dataverse podle 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 page poskytuje přístup k věcem, jako je popis cesty pro aktuální stránku, název nebo adresa URL aktuální stránky a všechny další atributy nebo související entity podkladového záznamu Dataverse. Další informace: stránka
parametry	Pohodlný zástupce pro request.params. More information: žádost
žádost	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
uživatel	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
web	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

Reklamy

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

Vlastnost	Description
placements	Vrátí objekt umístění.
[název nebo id reklamy]	K libovolné reklamě můžete přistupovat pomocí vlastností názvu nebo ID. {% assign ad = ads[Ad Name] %} {% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Atributy umístění reklamy

Vlastnost	Description
[název nebo id umístění reklamy]	Můžete získat přístup k jakémukoli umístění 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í reklam

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

Vlastnost	Description
Reklamy	Vrátí kolekci objektů reklam přidružených k umístění. V této kolekci použijte značky iterace a filtry polí .
název	Vrátí název pole pro umístění reklamy.
placement_url	Adresa URL, kterou můžete použít k načtení umístění reklamy plně vykreslené šablonou.
random_url	Adresa URL, kterou můžete použít k načtení náhodné reklamy z umístění plně vykresleného šablonou.

Atributy reklamy

Note

Ad je objekt tabulky se všemi stejnými atributy, kromě následujících atributů:

Vlastnost	Description
ad_url	Adresa URL, kterou můžete použít k načtení reklamy plně vykreslené šablonou.
Kopírovat	Vrátí pole Kopírovat pro reklamu.
bitová kopie	Vrátí objekt obrázku (pokud existuje) reklamy.
název	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ázků reklam

Vlastnost	Description
alternate_text	Vrátí text, který se zobrazí v alternativním atributu značky.
height	Vrátí výšku v pixelech obrázku.
Adresa URL	Vrátí zdroj adresy URL obrázku.
width	Vrátí šířku v pixelech obrázku.

blogs

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

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

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

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

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

Vlastnost	Description
posts	Vrátí objekt příspěvků blogu obsahující všechny blogové příspěvky na portálu.
[název nebo id blogu]	K libovolnému blogu můžete přistupovat podle jeho názvu nebo vlastností ID.

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

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

Objekt blog

Objekt blogu funguje s jedním blogem, abyste měli přístup k příspěvkům pro tento blog.

Následující tabulka vysvětluje různé atributy přidružené k objektu blogu.

Vlastnost	Description
posts	Vrátí objekt příspěvků blogu obsahující všechny blogové příspěvky pro blog.
název	Název blogu.
název	Nadpis blogu.
Adresa URL	Adresa URL blogu.

Objekt blogposts

Objekt blogposts umožňuje přístup k kolekci objektů blogového příspěvku. Blogové příspěvky si můžete objednat a dosáhnout stránkování pomocí filtrů liquid.

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

Mezi další možné možnosti patří:

• 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 vysvětluje různé atributy přidružené k objektu blogposts.

Vlastnost	Description
Všechno	Vrátí všechny objekty blogpostu v kolekci.

Objekt blogpost

Odkazuje na jeden příspěvek blogu.

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

Vlastnost	Description
Adresa URL	Adresa URL příspěvku.
obsah	Vrátí pole obsahu příspěvku.
autor	Autoři příspěvku, což je objekt tabulky kontaktů.
název	Název příspěvku.
comment_count	Celočíselná hodnota počtukomentářůch
publish_date	Datum publikování příspěvku.

entities

Caution

Abyste se vyhnuli potenciálním problémům se skriptováním mezi weby (XSS), vždy používejte řídicí filtr k kódování řetězcových dat HTML vždy, když použijete objekt Liquid ke čtení dat poskytovaných uživatelem, kterému nemůžete důvěřovat.

Note

Některé zásady vytváření názvů služby Dataverse se změnily. Entity Dataverse se teď například označují jako tabulky. Změny názvu se nevztahují na objekty Liquid. Objekt entit Liquid se nadále označuje jako entity.

Tento objekt slouží k načtení libovolné tabulky Dataverse podle ID. Pokud tabulka existuje, vrátí objekt tabulky. Pokud se tabulka s daným ID nenajde, vrátí hodnotu 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 %}

entita

Objekt entity poskytuje přístup k atributům záznamu tabulky aplikace Dataverse.

Vlastnost	Description
ID	Identifikátor GUID tabulky jako řetězec. Například 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Logický název Dataverse tabulky.
Poznámky	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 URL systému správy 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.

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

Note

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.

Vlastnost	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.
Adresa 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.

Note

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.

Vlastnost	Description
Popisek	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 tabulce

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.

Vlastnost	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í.

Reflexní vztah

Pokusí se načíst reflexivní relace (tj. odkazující na sebe) u entit, které se vrátí jako objekty s následujícími atributy.

Vlastnost	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

Pomocí objektu entitylist v rámci značek tabulky Dataverse získejte přístup ke všem atributům daného seznamu.

Note

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

Atributy

Note

entities

Vlastnost	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 URL pro odkaz nebo tlačítko pro vytvoření seznamu.
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 odkazy nebo tlačítka pro zobrazení podrobností seznamu.
detail_url	Vrátí nakonfigurovanou cestu URL pro odkazy nebo tlačítka pro zobrazení podrobností seznamu.
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 nebo tlačítko, které použije 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í kód celočíselného jazyka Dataverse, který slouží k výběru všech lokalizovaných popisků pro tento seznam.
velikost stránky	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.
views	Vrátí dostupná zobrazení pro seznam, jako objekty zobrazení seznamu.
[logický název atributu]	Můžete přistupovat k jakémukoli atributu záznamu (adx_entitylist) Dataverse v rámci seznamu (adxentitylist) podle logického názvu, a to stejným způsobem jako k objektu tabulky. Například {{ entitylist.adx_name }}

Atributy zobrazení seznamu

Vlastnost	Description
columns	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í kód celočíselného jazyka Dataverse, který slouží k výběru všech lokalizovaných popisků (záhlaví sloupců a dalších popisků) pro zobrazení.
název	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

Vlastnost	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
název	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

Použijte objekt entityview ve značce entityview. Kromě zobrazení záznamů výsledků poskytuje přístup k metadatům zobrazení.

Atributy

Vlastnost	Description
columns	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.
název	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í.
stránky	Vrátí pole čísel stránek obsahující všechny stránky výsledků pro aktuální zobrazení.
velikost stránky	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í.
celkový počet záznamů	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

events Objekt použijte pro přístup ke konkrétní události na portálu nebo pro přístup ke všem událostem na portálu.

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

Vlastnost	Description
occurrences	eventoccurrences Vrátí objekt obsahující všechny výskyty událostí na portálu.
[název nebo ID události]	Přístup k jakékoli události pomocí vlastností názvu nebo ID {% assign event = events["Název události"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

objekt události

Pomocí objektu event můžete pracovat s jednou událostí. K plánům a výskytům této události můžete přistupovat.

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

Vlastnost	Description
occurrences	Vrátí objekt eventoccurrencesobject, který obsahuje všechny výskyty pro událost.
název	Název události.
Adresa 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] %}

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

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

Vlastnost	Description
Všechno	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:

Vlastnost	Description
Adresa URL	Adresa URL výskytu.
is_all_day_event	Jedná se o celodenní událost?
čas_startu	Čas začátku události.
čas ukončení	Čas konce události.

forloop

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

Note

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

Output

This is the first child page!

This is child page number 2.

This is child page number 3.

Atributy

Vlastnost	Description
first	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 formulářů ASP.NET s více kroky 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>

forums object

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 fóra umožňuje pracovat s jedním fórum, takže můžete přistupovat k vláknům pro toto fórum.

Objekt forumthreads umožňuje získat přístup ke kolekci objektů forumthread. Můžete si objednat vlákna fóra a dosáhnout 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

Vlastnost	Description
threads	Vrátí objekt forumthreads, který obsahuje všechny objekty forumthread na portálu.
Všechno	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]	K libovolnému fóru můžete přistupovat pomocí jeho vlastností Název nebo ID. '{% assign forum = forums[Forum Name] %} {% přiřadit fórum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Objekt forum

Atributy

Note

entities

Vlastnost	Description
threads	Vrátí objekt forumthreads, který obsahuje všechna vlákna fóra v daném fóru.
název	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

Vlastnost	Description
Všechno	Vrátí všechny objekty forumthread v kolekci.

Objekt forumthread

Atributy

Note

entities

Vlastnost	Description
posts	Vrátí objekt forumposts, který obsahuje všechny příspěvky fóra ve vlákně.
autor	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

Vlastnost	Description
Všechno	Vrátí všechny objekty forumthread v kolekci.

Jeden příspěvek fóra

Atributy

Note

entities

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

znalosti

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

Atributy

Vlastnost	Description
články	Vrací objekt článků obsahující objekty článků pro záznamy tabulky knowledgearticle, které jsou k dispozici v portálu.
categories	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

Vlastnost	Description
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 %}
top	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 %}

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

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

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

Vlastnost	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.
klíčová slova	Klíčová slova pro tento článek.
název	Alternativní alias pro název článku.
hodnocení	Hodnota desítkového hodnocení článku.
název	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:

Vlastnost	Description
categorynumber	Číslo kategorie.
název	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

Vlastnost	Description
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ů.

protokol

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 kódu Liquid se zobrazí v rozšíření nástroje pro vývojáře Power Pages. 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

Vlastnost	Description
protokol	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

Note

entities

Vlastnost	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.
nadřazený objekt	Vrátí nadřazený objekt uzlu mapy webu v rámci stránky. Pokud je stránkou domovská stránka, atribut parent je null.
název	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í

Vlastnost	Description
placements	Vrátí objekt umístění hlasování.
[název nebo id hlasování]	K libovolnému hlasování můžete přistupovat prostřednictvím názvu nebo vlastnosti ID. {% assign poll = polls[Poll Name] %} {% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Atributy umístění hlasování

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

Note

entities

Vlastnost	Description
název	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í

Note

entities

Vlastnost	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.
název	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.
otázka	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).
hlasy	Vrátí počet hlasů, které jsou zahrnuty do tabulky pro hlasování.

Atributy možností hlasování

Note

entities

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

žádost

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>

Note

• 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

Vlastnost	Description
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.
Cesta	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
dotaz	Čá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

Vlastnost	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.
velikost stránky	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í

Vlastnost	Description
entita	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.
skóre	Skóre Lucene výsledku jako hodnota s plovoucí desetinnou čárkou. Pomocí této hodnoty jsou vráceny seřazené výsledky.
název	Název výsledku.
Adresa URL	Adresa URL pro výsledek. Tato adresa URL je obvykle (ale nemusí nutně) absolutní cestou pro aktuální aplikaci, nikoli úplnou adresu URL. Příklad: /articles/article1/

serverlogic

Během vykreslování šablon Liquid značka serverlogic vyvolá operaci logiky serveru. Parametr output značky serverlogic vytvoří objekt. Objekt není k dispozici jako globální objekt Liquid.

Syntax

{% serverlogic name: 'server-logic-name', operation: 'operation-name', input: inputData, output: result %}

Parameters

Parametr	Required	Description
name	Ano	Název záznamu logiky serveru, který se má vyvolat.
operation	Ano	Název funkce JavaScriptu, která se má vyvolat v záznamu logiky serveru.
input	Ne	Řetězec, který značka předá operaci logiky serveru. K předání strukturovaných dat použijte řetězec JSON. Operace má přístup k hodnotě prostřednictvím Server.Context.Input.
output	Ano	Název proměnné Liquid, která přijímá objekt výsledku logiky serveru.

Následující příklad předá vstup JSON do operace logiky serveru:

{% assign inputData = '{"category":"active","maximumResults":5}' %}

{% serverlogic name: 'customer-summary', operation: 'getSummary', input: inputData, output: result %}

{% if result.success %}
  <p>{{ result.data.message | escape }}</p>
{% else %}
  <p>The customer summary couldn't be retrieved.</p>
{% endif %}

V operaci logiky serveru použijte Server.Context.Input ke čtení vstupu:

function getSummary() {
    var input = JSON.parse(Server.Context.Input || "{}");

    return JSON.stringify({
        message: "Summary retrieved",
        category: input.category,
        maximumResults: input.maximumResults
    });
}

Další informace najdete v logice volání serveru z liquidu.

Atributy

Vlastnost	Description
success	Vrátí true , když se operace logiky serveru úspěšně dokončí; v opačném případě vrátí falsehodnotu .
status_code	Vrátí stavový kód pro operaci logiky serveru. Chyba spuštění vrátí stavový kód 500.
data	Vrátí analyzovanou hodnotu JSON, kterou vytvoří operace logiky serveru. K vnořeným objektům a polím můžete přistupovat pomocí standardní syntaxe Liquid.
raw_result	Vrátí neparsovanou odpověď vytvořenou operací logiky serveru. Tento atribut použijte, pokud odpověď není platná ve formátu JSON nebo když potřebujete zkontrolovat původní odpověď.

Important

Zachází se vstupy a hodnotami vrácenými logikou serveru jako nedůvěryhodnými daty. Před vykreslením vrácených řetězců v HTML ověřte vstup v operaci logiky serveru a použijte escape filtr.

nastavení

Tento objekt slouží k načtení libovolného nastavení webu podle názvu. Pokud portál nemůže najít nastavení s daným názvem, vrátí hodnotu null.

Note

Portál vrátí nastavení jako řetězce, ale pomocí filtrů typu je můžete převést 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 %}

Note

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

sitemap

Tento objekt použijte pro přístup k mapě portálového webu.

<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

Vlastnost	Description
Aktuální	Vrátí objekt uzlu mapy webu pro aktuální stránku.
Kořen	Vrátí objekt uzlu mapy webu pro kořenovou (domovskou) stránku webu.

Atributy uzlů mapy webu

Vlastnost	Description
Popisy 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.
Děti	Vrátí podřízené objekty uzlu mapy webu uzlu.
Description	Popis nebo shrnutí obsahu uzlu. (Toto pole může obsahovat HTML).
entita	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.
Rodič	Vrátí nadřazený objekt uzlu mapy webu uzlu. Pokud je uzel kořenový uzel, atribut parent je null.
Druh práce	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 %}

Note

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

Atributy sitemarkeru

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

Note

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

Atributy

Vlastnost	Description
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.
Rejstřík	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.
Délka	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.

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.

User je objekt entity.

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

Note

Power Pages verze 9.3.8.x nebo novější vynucuje řídicí filtr Liquid ve výchozím nastavení pro objekty Liquid apožaduje. Pokud chcete tuto výchozí konfiguraci zakázat a povolit tyto objekty Liquid bez řídicího filtru Liquid, podívejte se na nastavení portálového webu – Site/EnableDefaultHtmlEncoding.

Atributy

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

Vlastnost	Description
roles	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> Vykreslení odznáček uživatele podle ID (variable 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 %}

Note

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

Atributy sady webových odkazů

Note

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

Vlastnost	Description
Kopírovat	Kopie HTML sady webových odkazů.
název	Název sady webových odkazů.
Druh práce	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ého odkazu

Note

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

Vlastnost	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.
Obrázek	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.
název	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.
Tooltip	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 záznamu Dataverse webového odkazu 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.

web

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

Note

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

Kód

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

Output

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.

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

Tekuté typy
Značky jazyka Liquid
Kapalinové filtry