Del via


Malmerker

Malkoder kontrollere utdata fra en mal på ulike måter, og tillater kombinasjon av flere maler til én enkelt utdata.

Fetchxml

Gir brukeren mulighet til å etterspørre data fra Microsoft Dataverse og gjengi resultatet på en side.

Merk

Du kan finne ut mer om hvordan du etterspør dataene ved hjelp av fetchxml på Bruk FetchXML til å spørre data.

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

Når du bruker fetchxml til å spørre etter data, må du kontrollere at du ikke bruker selvlukkende merker. I stedet for <attribute name="title"/> kan du for eksempel bruke <attribute name="title"></attribute> med eksplisitt avslutningskode </attribute>.

Resultater-attributt

Resultater-attributtet i den angitte variabelen (for eksempel "resultVariable" i det forrige eksemplet) inneholder FetchXML-spørringsresultater og noen andre attributter.

  • Enheter

    Dette attributtet inneholder resultatet av fetchxml-spørringen. Du kan gjenta resultatet og bruke det i webmalen.

    <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 navnet på enheten.

  • ExtensionData

    Henter strukturen som inneholder ekstra data.

  • MinActiveRowVersion

    Henter den laveste aktive radversjonsverdien.

  • MoreRecords

    Henter om flere oppføringer er tilgjengelige.

  • PagingCookie

    Henter gjeldende sideinformasjon.

  • TotalRecordCount

    Henter totalt antall oppføringer i samlingen.
    ReturnTotalRecordCount var sann da spørringen ble kjørt.

  • TotalRecordCountLimitExceeded

    Henter hvis resultatene av spørringen overskrider det totale antallet oppføringer.

XML-attributt

XML-attributt i angitt variabel (for eksempel 'resultVariable' i det forrige eksemplet) inneholder den resulterende spørringen, som kan brukes til å hente data fra Microsoft Dataverse. Dette attributtet er nyttig for feilsøkingsformål når du vil forstå hvordan tabelltillatelser brukes på denne fetchxml-koden

Andre støttede elementer og attributter

Fetchxml liquid-merket støtter følgende attributter og underordnede elementer.

Element / underordnet element Attributter Underordnet element
hent tilordning
versjon
antall
side
informasjonskapsel for sideveksling
utc-offset
aggregert
distinkt
min-active-row-version
output-format
returntotalrecordcount
no-lock
ordre
enhet
rekkefølge attributt
alias
synkende
enhet navn
all-attributes
no-attrs
attributt
ordre
filter
link-entity
filter type
hint
isquickfindfields
betingelse
filter
link-entity navn
fra
til
alias
link-type
synlig
skjæringspunkt
all-attributes
no-attrs
attributt
ordre
filter
link-entity
betingelse kolonne
entityname
attributt
operator
aggregert
alias
uiname
uitype
uihidden
verdi
verdi

include

Inkluderer innholdet i én mal i en annen, etter navn. I Power Pages vil kilden for denne andre malen vanligvis være en webmal. Denne operatoren muliggjør gjenbruk av felles malfragmenter på flere steder.

Når en mal er inkludert i en annen, har den inkluderte malen tilgang til alle variabler som er definert i den overordnede malen.

{% include 'My Template' %}

Det er også mulig å sende et hvilket som helst antall parametere til include-koden. Disse parameterne defineres som variabler i malen som er inkludert.

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

block

Brukes med extends for å gi malen arv. Se extends for bruk.

extends

Brukes med blokkoden for å gi malen arv. Denne operatoren lar flere maler bruke et delt oppsett og samtidig overstyre bestemte områder i det overordnede oppsettet.

I Power Pages vil navnet på den overordnede malen som er angitt for koden, vanligvis referere til navnet på en webmal.

Når extends brukes, må det være det første innholdet i malen, og kan bare etterfølges av én eller flere blokkoder.

Hvis en blokk som er definert i den overordnede malen ikke er overstyrt, vises innholdet i den overordnede malen (hvis aktuelt).

kommentar

Lar deg forlate den ikke gjengitte koden i en Liquid-mal. Innhold i blokken gjengis ikke, og Liquid-kode i den kjøres ikke.

Kode

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

Utdata

Hello. My name is Charles.

raw

Denne funksjonen lar deg vise Liquid-kode på en side uten å analysere eller utføre den.

Utdata

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

erstatning

Når du aktiverer hurtigbufring for topp- og bunntekster og vil unngå hurtigbufring av bestemte delutdata, kan du bruke dette merket. Dette merket gir innholdsblokken i topp- eller bunnteksten, der utdata for den brutte innholdsblokken ikke blir hurtigbufret. Denne operatoren er nyttig i scenariene der brukeren bruker et objekt som ofte kan oppdateres, for eksempel forespørsel, side, språk og dato. Du kan for eksempel bruke oppdateringsscenarioene for webmalen for topptekst og bunntekst når hurtigbufring av topptekst og bunntekst er aktivert.

Tips

URL-adressen som brukes i request.url kan være en hvilken som helst forespurt verdi, og den blir hurtigbufret for påfølgende forespørsler. For å sikre riktig verdi i request.url, kan du vurdere å bruke erstatningskode, delvis URL-adresse, for eksempel ~{WebFile path} eller lagre portalens URL-adresse i områdeinnstillinger.

codecomponent

Se Forstå Codecomponent Dataverse-enhetskode, Bruke kodekomponenter Liquid-malmerke.

Se også

Kontroller flytmerker
Gjentakelsesmerker
Variabelmerker
Dataverse Liquid-koder
Bruk kodekomponenter til Liquid-malkode