Sdílet prostřednictvím


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.

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

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

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

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:

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

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