Share via

Sjabloontags

  • Artikel

Notitie

Met ingang van 12 oktober 2022 wordt Power Apps-portals hernoemd tot Power Pages. Meer informatie: Microsoft Power Pages is nu algemeen beschikbaar (blog)
We zullen binnenkort de documentatie voor Power Apps-portals migreren en samenvoegen met Power Pages-documentatie.

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 bovenstaande 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 bovenstaande 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
versie
aantal
page
paging-cookie
utc-offset
aggregate
distinct
min-active-row-version
output-format
returntotalrecordcount
no-lock		 order
entity
order kenmerk
alias
aflopend
entity name
all-attributes
no-attrs
kenmerk		 order
filter
link-entity
filter type
hint
isquickfindfields		 voorwaarde
filter
link-entity name
from
tot
alias
link-type
zichtbaar
overlappen
all-attributes
no-attrs
kenmerk		 order
filter
link-entity
voorwaarde kolom
entityname
kenmerk
operator
aggregate
alias
uiname
uittype
uihidden
value		 value

opnemen

Hiermee wordt de inhoud van één sjabloon in een andere sjabloon opgenomen op basis van naam. In Power Apps-portals is de bron van deze andere sjabloon over het algemeen een websjabloon. Hiermee 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 worden vervolgens gedefinieerd als variabelen in de opgenomen sjabloon.

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

block

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

extends

Gebruikt in combinatie met de block-code om sjabloonovername te bieden. Hiermee kunnen meerdere sjablonen een gedeelde indeling gebruiken, terwijl specifieke gebieden van de bovenliggende indeling worden genegeerd.

In Power Apps-portals 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

Hiermee kunt de uitvoer van Liquid-code op een pagina uitvoeren zonder dat deze wordt geparseerd en uitgevoerd.

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. Dit is handig in de scenario's waarin de gebruiker een object gebruikt dat regelmatig kan worden bijgewerkt, zoals verzoek, 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.

Tip

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
Power Apps Dataverse-entity-tags
Liquid-sjablooncode voor codeonderdelen gebruiken

Notitie

Laat ons uw taalvoorkeuren voor documentatie weten! Beantwoord een korte enquête. (houd er rekening mee dat deze in het Engels is)

De enquête duurt ongeveer zeven minuten. Er worden geen persoonlijke gegevens verzameld (privacyverklaring).