Značky šablon

Značky šablon řídí výstup šablony různými způsoby a umožňuje kombinaci více šablon do jednoho výstupu.

Fetchxml

Umožňuje uživateli dotazovat data z Microsoft Dataverse a vykreslit výsledky na stránce.

Poznámka:

Další informace o dotazování na data získáte pomocí fetchxml v části Použití FetchXML k dotazování dat.

{% fetchxml resultVariable %}
<!— Fetchxml query -->
...
{% endfetchxml %}

Při použití fetchxml k dotazování dat se ujistěte, že nepoužíváte samozavírací značky. Například místo<attribute name="title"/> použijte <attribute name="title"></attribute> s explicitní uzavírací značkou </attribute>.

Atribut výsledků

Atribut výsledků v poskytnuté proměnné (například „resultVariable“ v předchozím příkladu) obsahuje výsledky dotazu FetchXML a několik dalších atributů.

• Entity

  Tento atribut obsahuje výsledek dotazu fetchxml. Můžete iterovat výsledek a použít jej ve své webové šabloně.

  <table> 
  {% for entityVariable in resultVariable.results.entities %} 
  <tr> 
  <td>Attribut-1: {{ entityVariable.attribute1 }}</td> 
  <td>Attribut-2: {{ entityVariable.attribute2 }}</td> 
  </tr> 
  {% endfor %} 
  </table> 
  

• TableName

  Získá logický název entity.

• ExtensionData

  Získá strukturu, která obsahuje dodatečná data.

• MinActiveRowVersion

  Získá nejnižší hodnotu aktivní verze řádku.

• MoreRecords

  Zjistí, zda je k dispozici více záznamů.

• PagingCookie

  Získá aktuální informace o stránkování.

• TotalRecordCount

  Získá celkový počet záznamů v kolekci.
  ReturnTotalRecordCount byl true, když byl dotaz spuštěn.

• TotalRecordCountLimitExceeded

  Zjistí, zda výsledky dotazu přesahují celkový počet záznamů.

Atribut XML

Atribut XML v poskytnuté proměnné (například „resultVariable“ v předchozím příkladu) obsahuje výsledný dotaz, který lze použít k získání dat z Microsoft Dataverse. Tento atribut je užitečný pro účely ladění, když chcete pochopit, jak je používáno oprávnění k tabulce na tuto značku fetchxml.

Další podporované prvky a atributy

Značka liquid fetchxml podporuje následující atributy a podřízené prvky.

Prvek / podřízený prvek	Atributy	Podřízený prvek
fetch	mapping version count page paging-cookie utc-offset aggregate distinct min-active-row-version output-format returntotalrecordcount no-lock	order entity
order	attribute alias descending
entity	name all-attributes no-attrs attribute	order filter link-entity
filter	type hint isquickfindfields	condition filter
link-entity	name from to alias link-type visible intersect all-attributes no-attrs attribute	order filter link-entity
condition	column entityname attribute operator aggregate alias uiname uitype uihidden value	value

include

Zahrnuje obsah z jedné šablony do jiné, podle názvu. V Power Pages je zdroj této jiné šablony obecně webovou šablonou. Tento operátor umožňuje opětovné použití fragmentů společné šablony na více místech.

Pokud je jedna šablona zahrnuta v jiné, zahrnutá šablona má přístup k libovolné proměnné definované v nadřazené šabloně.

{% include 'My Template' %}

Je také možné předat libovolný počet pojmenovaných parametrů značky include. Tyto parametry jsou definovány jako proměnné v zahrnuté šabloně.

{% include 'My Template' a:x, b:y %}

block

Používáno s extends za účelem poskytnutí dědičnosti šablon. Informace o použití naleznete v části extends.

extends

Používáno se značkou block za účelem poskytnutí dědičnosti šablon. Tento operátor umožňuje více šablonám použití sdíleného rozložení při přepsání specifických oblastí nadřazeného rozložení.

V Power Pages název nadřazené šablony poskytnutý značce obecně odkazuje na název webové šablony.

Při použití extends musí jít o první obsah v šabloně a může být následován pouze jednou nebo více značkami block.

Pokud blok definovaný v nadřazené šabloně není přepsán, jeho obsah bude vykreslen v nadřazené šabloně (pokud existuje).

komentář

Umožňuje vám ponechat nevykreslený kód uvnitř šablony jazyka Liquid. Žádný obsah v rámci bloku není vykreslen a žádný obsažený kód jazyka Liquid není proveden.

Kód

Hello{% comment %}, {{ user.fullname }}{% endcomment %}. My name is Charles.

Výstup

Hello. My name is Charles.

raw

Tato funkce umožňuje zobrazit kód Liquid na stránce bez jeho analýzy nebo spuštění.

Výstup

Hello, {{ user.fullname }}. My name is Charles.

náhrada

Když povolíte ukládání do mezipaměti záhlaví a zápatí a chcete se vyhnout ukládání do mezipaměti určitého výstupu sekce, můžete použít tuto značku. Tato značka poskytuje blok obsahu v záhlaví nebo zápatí, kde není výstup zabaleného obsahu uložen do mezipaměti. Tento operátor je užitečný ve scénářích, kde uživatel používá objekt, který může být často aktualizován, jako je požadavek, stránka, jazyk a datum. Například viz scénáře aktualizace zdrojového kódu webové šablony záhlaví a zápatí, když je povoleno ukládání záhlaví a zápatí do mezipaměti.

Tip

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.

codecomponent

Viz Popis značky entity Dataverse komponentu kódu, Použití značky šablony Liquid komponentu kódu.

Viz také

Značky toku řízení
Značky iterace
Značky proměnných
Značky Dataverse Liquid
Použití značky šablony Liquid komponent kódu