Sjabloontags

Artikel
01/15/2025

Met sjablooncodes wordt de uitvoer van een sjabloon op verschillende manieren bepaald en is de combinatie van meerdere sjablonen gebruiken in één uitvoer mogelijk.

Fetchxml

Hiermee kan de gebruiker gegevens van Microsoft Dataverse opvragen en de resultaten op een pagina weergeven.

Notitie

Meer informatie over het opvragen van de gegevens met behulp van fetchxml is te vinden op FetchXML gebruiken om gegevens op te vragen.

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

Gebruik geen zelfsluitende tags wanneer u fetchxml gebruikt om gegevens op te vragen. Gebruik <attribute name="title"></attribute> in plaats van <attribute name="title"/> met de expliciete sluitingstag </attribute>.

Resultaatkenmerk

Resultaatkenmerk in opgegeven variabele (zoals 'resultVariable' in het vorige voorbeeld) bevat FetchXML-queryresultaten en een paar andere kenmerken.

Entiteiten

Dit kenmerk bevat het resultaat van de fetchxml-query. U kunt het resultaat herhalen en gebruiken in uw websjabloon.

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

TableName

Hiermee word de logische naam van de entiteit opgehaald.
ExtensionData

Hiermee wordt de structuur die de extra gegevens bevat opgehaald.
MinActiveRowVersion

Hiermee wordt de laagste actieve rijversiewaarde opgehaald.
MoreRecords

Hiermee wordt bepaald of er meer records beschikbaar zijn.
PagingCookie

Hiermee wordt de huidige oproepinformatie opgehaald.
TotalRecordCount

Hiermee wordt het totale aantal kolommen in de verzameling opgehaald.
ReturnTotalRecordCount was waar toen de query werd uitgevoerd.
TotalRecordCountLimitExceeded

Hiermee wordt bepaald of de resultaten van de query het totale aantal records overschrijden.

XML-kenmerk

XML-kenmerk in opgegeven variabele (zoals 'resultVariable' in het vorige voorbeeld) bevat de resulterende query die kan worden gebruikt om gegevens op te halen vanuit Microsoft Dataverse. Dit attribuut is handig voor het opsporen van fouten als u wilt begrijpen hoe de tabelmachtiging wordt toegepast op de fetchxml-code.

Andere ondersteunde elementen en kenmerken

Liquid-code fetchxml ondersteunt de volgende kenmerken en onderliggende elementen.

Element/onderliggend element	Kenmerken	Onderliggend element
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 aflopend
entity	name all-attributes no-attrs kenmerk	order filter link-entity
filter	type hint isquickfindfields	condition filter
link-entity	name from to alias link-type visible intersect all-attributes no-attrs kenmerk	order filter link-entity
voorwaarde	column entityname attribute operator aggregate alias uiname uitype uihidden value	value

opnemen

Hiermee wordt de inhoud van één sjabloon in een andere sjabloon opgenomen op basis van naam. In Power Pages is de bron van deze andere sjabloon over het algemeen een websjabloon. Met deze operator is hergebruik van algemene sjabloonfragmenten op meerdere plaatsen mogelijk.

Wanneer een sjabloon in een andere sjabloon wordt opgenomen, heeft de opgenomen sjabloon toegang tot alle variabelen die in de bovenliggende sjabloon zijn gedefinieerd.

{% include 'My Template' %}

Het is ook mogelijk om een willekeurig aantal benoemde parameters door te geven aan de include-code. Deze parameters worden vervolgens gedefinieerd als variabelen in de opgenomen sjabloon.

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

block

Gebruikt met extends om sjabloonovername te bieden. Zie extends voor gebruik.

extends

Gebruikt met de blokcode om sjabloonovername te bieden. Met deze operator kunnen meerdere sjablonen een gedeelde indeling gebruiken, terwijl specifieke gebieden van de bovenliggende indeling worden genegeerd.

In Power Pages wordt met de naam van de bovenliggende sjabloon die aan de code is verschaft, over het algemeen verwezen naar de naam van een websjabloon.

Wanneer extends wordt gebruikt, moet dit de eerste inhoud van de sjabloon zijn en kan deze door slechts één of meerdere block-codes worden gevolgd.

Als een block gedefinieerd in de bovenliggende sjabloon niet wordt genegeerd, wordt de inhoud ervan in de bovenliggende sjabloon (indien aanwezig) weergegeven.

reactie

Hiermee kunt u niet-weergegeven code in een Liquid-sjabloon achterlaten. Alle inhoud binnen het blok wordt niet weergegeven en alle Liquid-code erin wordt niet uitgevoerd.

Code

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

Uitvoer

Hello. My name is Charles.

raw

Met deze functie kunt u Liquid-code op een pagina weergeven zonder deze te parseren of uit te voeren.

Uitvoer

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

Vervanging

Als u de caching van kop- en voetteksten inschakelt en wilt voorkomen dat bepaalde sectie-uitvoer in de cache wordt opgeslagen, kunt u deze tag gebruiken. Deze tag biedt het inhoudsblok in de kop- of voettekst waar de uitvoer van het ingesloten inhoudsblok niet in de cache wordt opgeslagen. Deze operator is handig in de scenario's waarin de gebruiker een object gebruikt dat regelmatig kan worden bijgewerkt, zoals aanvraag, pagina, taal en datum. Raadpleeg bijvoorbeeld als kop- en voettekstcaching is ingeschakeld de scenario's voor het bijwerken van de broncode voor websjablonen voor kop- en voetteksten.

Fooi

De URL die in request.url wordt gebruikt, kan elke gevraagde waarde zijn en wordt opgehaald in de cache voor volgende aanvragen. Om de juiste waarde bij request.url te garanderen, overweeg dan vervangende tag te gebruiken, een gedeeltelijke URL, zoals ~{WebFile path} of de portal-URL op te slaan in Site-instellingen.

codecomponent

Zie Inzicht krijgen in codeonderdeel Dataverse-entiteitstag, Liquid-sjablooncode voor codeonderdelen gebruiken.

Zie ook

Controlestroomtags
Iteratietags
Variabele tags
Dataverse Liquid-codes
Liquid-sjablooncode voor codeonderdelen gebruiken

Delen via