Skabelonmærker

Skabelonmærker styrer outputtet fra en skabelon på forskellige måder og giver mulighed for kombinationen af flere skabeloner til et enkelt output.

fetchxml

Giver brugeren mulighed for at forespørge om data fra Microsoft Dataverse og gengive resultaterne på en side.

Bemærk

Du kan få mere at vide om, hvordan du forespørger på data ved hjælp af fetchxml, under bruge FetchXML til at forespørge på data.

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

Når du bruger Fetchxml til at forespørge om data, skal du sikre dig, at du ikke bruger selvlukkende koder. Brug i stedet for <attribute name="title"/> f.eks. <attribute name="title"></attribute> med eksplicit lukkekode </attribute>.

Attribut for resultater

Attributten for resultater i den angivne variabel (f.eks. ' resultVariable' i ovenstående eksempel) indeholder FetchXML-forespørgselsresultater og et par andre attributter.

• Objekter

  Denne attribut indeholder resultatet af fetchxml-forespørgslen. Du kan gentage resultatet og bruge det i din webskabelon.

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

• TableName

  Henter det logiske navn på objektet.

• ExtensionData

  Henter den struktur, der indeholder ekstra data.

• MinActiveRowVersion

  Henter den laveste aktive rækkeversionsværdi.

• MoreRecords

  Henter, om der er flere tilgængelige poster.

• PagingCookie

  Henter de aktuelle oplysninger om sideinddeling.

• TotalRecordCount

  Henter det samlede antal poster i samlingen.
  ReturnTotalRecordCount var sand, da forespørgslen blev kørt.

• TotalRecordCountLimitExceeded

  Henter, om resultaterne af forespørgslen overstiger det samlede antal poster.

XML-attribut

XML-attributten i den angivne variabel (f eks. ' resultVariable' i ovenstående eksempel) indeholder den resulterende forespørgsel, som kan bruges til at hente data fra Microsoft Dataverse. Denne attribut er nyttig til fejlfindingsformål, når du vil forstå, hvordan tabeltilladelser anvendes på denne fetchxml-kode.

Andre understøttede elementer og attributter

fetchxml liquid-kode understøtter følgende attributter og underordnede elementer.

Element/Underordnet element	Attributter	Underordnet element
hent	tilknytning version antal side sideopdelingscookie utc-forskydning samle distinct min-active-row-version output-format returntotalrecordcount no-lock	rækkefølge objekt
sortér	attribut alias faldende
objekt	navn all-attributes no-attrs attribut	rækkefølge filter link-entity
filter	skriv hint isquickfindfields	betingelse filter
link-entity	navn fra til alias linktype visible overlap all-attributes no-attrs attribut	rækkefølge filter link-entity
betingelse	kolonne objektnavn attribut operator samle alias uiname uitype uihidden værdi	værdi

include

Medtager indholdet af én skabelon i en anden efter navn. i Power Pages vil kilden til denne anden skabelon generelt være en webskabelon. Denne operator giver mulighed for genbrug af fælles skabelonfragmenter på forskellige steder.

Når en skabelon er medtaget i en anden, har den medtagede skabelon adgang til alle variabler, der er defineret i den overordnede skabelon.

{% include 'My Template' %}

Det er også muligt at sende et hvilket som helst antal navngivne parametre til det medtagede mærke. Disse parametre bliver så defineret som variabler i den medfølgende skabelon.

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

bloker

Bruges med extends til at levere skabelonnedarvning. Se extends om anvendelsen.

extends

Bruges med block-mærker og leverer skabelonnedarvning. Dette giver mulighed for, at flere skabeloner kan bruge et delt layout og samtidig tilsidesætte bestemte områder af det overordnede layout.

I Power Pages refererer det overordnede skabelonnavn, der leveres til mærket, generelt til navnet på en webskabelon.

Når extends bruges, skal det være det første indhold i skabelonen og kan kun efterfølges af et eller flere block-mærker.

Hvis en blok, der er defineret i den overordnede skabelon, ikke er tilsidesat, gengives dens indhold i den overordnede skabelon (hvis relevant).

kommentar

Gør det muligt for dig at lade ikke-gengivet kode stå i en Liquid-skabelon. Indhold i blokken gengives ikke, og Liquid-kode i den bliver ikke udført.

Kode

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

Output

Hello. My name is Charles.

raw

Giver mulighed for output fra en Liquid-kode på en side, uden at det fortolkes og udføres.

Output

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

erstatning

Når du aktiverer cachelagringen af sidehoved og sidefod, og du vil undgå cachelagring af et bestemt sektionsoutput, kan du bruge denne kode. Dette mærke angiver indholdsblokken i sidehovedet eller sidefoden, hvor output af den ombrudte indholdsblok ikke bliver cachelagret. Denne operator er nyttig i de situationer, hvor brugeren har et objekt, som ofte kan opdateres, f.eks. anmodning, side, sprog og dato. Du kan f.eks. referere til opdateringsscenarier for kildekode i sidehoved- og sidefodswebskabeloner, når cachelagring af sidehoveder og sidefødder er aktiveret.

Tip

Den URL-adresse, der bruges i request.url, kan have en hvilken som helst værdi og blive cachelagret for efterfølgende anmodninger. Du kan sikre, at den rigtige værdi bruges i request.url, ved at bruge erstatningskode, delvis URL-adresse, f.eks ~{WebFile-sti} eller lagre portalens URL-adresse i Indstillinger for websted.

codecomponent

Se Forstå kodekomponent Dataverse-objektkoden, , Brug kodekomponenterne Skabelonkodemærke

Se også

Mærker for kontrolflow
Gentagelsesmærker
Variabelmærker
Dataverse Liquid-mærker
Bruge kodekomponenter til Liquid-skabelonmærke