Značky šablon

Poznámka

S účinností od 12. října 2022 jsou portály Power Apps Power Pages. Další informace: Služba Microsoft Power Pages je nyní obecně dostupná (blog)
Zanedlouho migrujeme a sloučíme dokumentaci k portálům Power Apps s dokumentací k Power Pages.

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 použijte 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“ ve výše uvedené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 pravdivý, když byl dotaz spuštěn.

• TotalRecordCountLimitExceeded

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

Atribut XML

Atribut XML v poskytnuté proměnné (například „resultVariable“ ve výše uvedené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 portálech aplikace Power Apps bude zdroj této jiné šablony obecně webovou šablonou. To umožňuje opětovné použití fragmentů společné šablony na více místech.

Pokud je jedna šablona zahrnuta v jiné, zahrnutá šablona bude mít 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. Ty pak budou definovány jako proměnné v zahrnuté šabloně.

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

block

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

extends

Používáno ve spojení se značkou block za účelem poskytnutí dědičnosti šablon. To 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 portálech aplikace Power Apps bude název nadřazené šablony poskytnutý značce obecně odkazovat 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 v nadřazené šabloně (pokud existuje) bude vykreslen.

komentář

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

Kód

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

Výstup

Hello. My name is Charles.

raw

Umožňuje výstup kódu jazyka Liquid na stránce bez nutnosti jej analyzovat a provádět.

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. To 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 entit Power Apps Dataverse
Použití značky šablony Liquid komponent kódu

Poznámka

Můžete nám sdělit, jaké máte jazykové preference pro dokumentaci? Zúčastněte se krátkého průzkumu. (upozorňujeme, že tento průzkum je v angličtině)

Průzkum bude trvat asi sedm minut. Nejsou shromažďovány žádné osobní údaje (prohlášení o zásadách ochrany osobních údajů).