Tilgængelige Liquid-objekter

Liquid-objekter indeholder attributter til at producere dynamisk indhold til siden. Objektet har f.eks page . en attribut kaldet title , som du kan bruge til at skrive titlen på den aktuelle side.

Hvis du vil have adgang til en objektattribut efter navn, skal du bruge et punktum (.). Hvis du vil gengive et objekts attribut i en skabelon, skal du ombryde den i {{ og }}.

Vigtigt!

Hvis du vil undgå potentielle problemer med krydswebstedsscripting (XSS), skal du altid bruge escape-filteret til HTML-kodedata, når du bruger Flydende objekter til at læse data, som en bruger ikke har tillid til.

{{ page.title }}

Du kan også få adgang til attributterne for et objekt ved hjælp af et strengnavn og []. Dette format er nyttigt i tilfælde, hvor den ønskede attribut bestemmes dynamisk, eller attributnavnet indeholder tegn, mellemrum, specialtegn osv., der ville være ugyldige ved brug af et punktum (.) i syntaksen.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Du kan bruge og få adgang til følgende objekter overalt i en hvilken som helst skabelon.

Objekt	Beskrivelse
Enheder	Giver dig mulighed for at indlæse en hvilken som helst Microsoft Dataverse tabel efter id. Du kan finde flere oplysninger under: objekter
nu	Dato og klokkeslætsobjekt, der refererer til den aktuelle UTC-tid, på tidspunktet, hvor skabelonen blev gengivet. Bemærk: Denne værdi er cachelagret af portalwebappen og opdateres ikke hver gang. Flere oplysninger: Datafiltre
page	Refererer til den aktuelle anmodningsside i portalen. Objektet page giver adgang til ting som brødkrumme for den aktuelle side, titlen eller URL-adressen på den aktuelle side og alle andre attributter eller relaterede objekter for den underliggende Dataverse-post. Flere oplysninger: side
params	En praktisk genvej til request.params. Flere oplysninger: anmodning
anmodning	Indeholder oplysninger om den aktuelle HTTP-anmodning. Flere oplysninger: anmodning
indstillinger	Gør det muligt at indlæse en webstedsindstilling efter navn. Flere oplysninger: Indstillinger
sitemap	Giver adgang til oversigten over portalwebstedet. Flere oplysninger: websteder
sitemarkers	Gør det muligt at indlæse webstedsmærker efter navn. Flere oplysninger: webstedsmarkører
snippets	Gør det muligt at indlæse alle indholdskodestykker efter navn. Flere oplysninger: snippets
bruger	Refererer til den aktuelle portalbruger og giver adgang til alle attributter i den underliggende kontaktpersonpost i Dataverse. Hvis ingen bruger er logget på, er denne variabel null. Flere oplysninger: bruger
weblinks	Gør det muligt at indlæse et weblinksæt efter navn eller id. Flere oplysninger: weblinks
website	Refererer til portalens webstedspost og giver adgang til alle attributter på Dataverse-webstedsposten (adx_website) for portalen. Flere oplysninger: websted

ads

Gør det muligt at hente og få vist en annonce.

Med ads-objektet kan du vælge en bestemt reklame eller reklameplacering.

<div>

{% assign ad = ads[Ad Name] %}

<h4>{{ ad.title }}</h4>

<a href={{ ad.redirect_url }}>

<img src={{ ad.image.url }} alt={{ ad.image.alternate_text }} />

</a>

</div>

Reklameattributter

Egenskab	Beskrivelse
placeringer	Returnerer placeringsobjektet.
[ad name eller id]	Du kan få adgang til en hvilken som helst annonce ved hjælp af egenskaberne Name eller ID. {% assign ad = ads[Ad Name] %} {% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Attributter for reklameplaceringer

Egenskab	Beskrivelse
[ad placement name eller id]	Du kan få adgang til enhver placering ved hjælp af egenskaberne Navn eller Id. {% assign placement = ads.placements[Placement Name or Id] %} {% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Attributter for annonceplacering

En reklameplacering er et tabelobjekt med de samme generelle attributter og følgende attributter:

Egenskab	Beskrivelse
Reklamer	Returnerer samlingen af reklameobjekter, der er knyttet til placeringen. Brug iterationskoder og matrixfiltre sammen med denne samling.
Name	Returnerer feltet Navn for reklameplaceringen.
placement_url	Den URL-adresse, du kan bruge til at hente annonceplaceringen gengivet fuldt ud af en skabelon.
random_url	Den URL-adresse, du kan bruge til at hente en tilfældig annonce fra den placering, der er gengivet fuldt ud af en skabelon.

Annonceattributter

Bemærkning

En annonce er et tabelobjekt med alle de samme attributter ud over følgende attributter:

Egenskab	Beskrivelse
ad_url	Den URL-adresse, du kan bruge til at hente den annonce, der er gengivet fuldt ud af en skabelon.
Kopiér	Returnerer tekstfeltet for annoncen.
afbildning	Returnerer billedobjektet (hvis relevant) for reklamen.
Name	Returnerer feltet Navn for reklamen.
åbn_i_nyt_vindue	Returnerer true, hvis den URL-adresse, der er angivet af redirect_url, skal åbnes i et nyt vindue.
omdirigeringsadresse (redirect_url)	Den URL-adresse, som brugeren videresendes til ved at vælge reklamen.

Attributter for annoncebilleder

Egenskab	Beskrivelse
alternativ_tekst	Returnerer den tekst, der vises i kodens alt-attribut.
højde	Returnerer højden i pixel for billedet.
url	Returnerer URL-adressen på kilden til billedet.
bredde	Returnerer bredden i pixel for billedet.

blogs

Aktiverer hentning og visning af blogge og blogindlæg.

Med blogobjektet kan du vælge en bestemt blog eller blogindlæg.

{% assign posts = blogs.posts | paginate: 0,4 %}

<div class=content-panel panel panel-default>

<div class=panel-heading>

{% assign sitemarker = sitemarkers["Blog Home"] %}

{% assign snippet = snippets[Home Blog Activity Heading] %}

<a class=pull-right href={{sitemarker.url}}> All Blogs </a>

<h4>

<a class=feed-icon fa fa-rss-square href={{ blogs.feedpath }} />

{{ snippet.adx_value }}

</h4>

</div>

<ul class=list-group>

{% for post in posts.all %}

<li class=list-group-item >

<a class=user-avatar href={{ post.author_url }}>

<img src={{ post.user_image_url }} />

</a>

<h4 class=list-group-item-heading>

<a href={{ post.app_relative_path }}>{{ post.title }}</a>

</h4>

<div class=content-metadata>

<abbr class=timeago>{{ post.publish_date }}</abbr>

&ndash;

<a href={{ post.author_url }}> {{ post.author_name }} </a>

&ndash;

<a href={{ post.application_path }}#comments>

<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}

</a>

</div>

</li>

{% endfor %}

</ul>

</div>

blogs-objekt

Med blogobjektet kan du få adgang til en hvilken som helst bestemt blog på portalen eller få adgang til alle blogindlæg på portalen.

I følgende tabel beskrives de attributter, der er knyttet til blogs-objektet.

Egenskab	Beskrivelse
posts	Returnerer et blogindlægsobjekt, der indeholder alle blogindlæg på portalen.
[blognavn eller -id]	Du kan få adgang til en hvilken som helst blog ved hjælp af egenskaberne Navn eller Id.

{% assign blog = blogs["Blog Name"] %}                             

{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}  |

Objektet blog

Blogobjektet fungerer sammen med en enkelt blog, så du kan få adgang til indlæggene for den pågældende blog.

I følgende tabel forklares forskellige attributter, der er knyttet til blogobjektet.

Egenskab	Beskrivelse
posts	Returnerer et blogindlægsobjekt, der indeholder alle blogindlæg til bloggen.
Name	Navnet på bloggen.
titel	Titlen på bloggen.
url	URL-adressen til bloggen.

Blogposts-objektet

Objektet blogposts giver dig adgang til en samling af blogindlægobjekter. Du kan bestille blogindlæg og opnå sideinddeling ved hjælp af flydende filtre.

{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}

Andre mulige indstillinger omfatter:

• blogs.posts.all (for at hente alle blogindlæg)
• blogs.posts | from\_index: 0 | take: 2

I følgende tabel forklares forskellige attributter, der er knyttet til blogpostobjektet.

Egenskab	Beskrivelse
Alle	Returnerer alle blogpostobjekter i samlingen.

Objektet blogpost

Refererer til et enkelt blogopslag.

I følgende tabel forklares forskellige attributter, der er knyttet til blogpostobjektet.

Egenskab	Beskrivelse
url	Opslagets URL-adresse.
indhold	Returnerer feltet Indhold for opslaget.
forfatter	Forfatterne til indlægget, som er et objekt i en kontakttabel.
titel	Titlen på opslaget.
comment_count	Heltalsværdien for antallet af kommentarer for et bestemt indlæg.
udgivelsesdato	Den dato, hvor opslaget blev publiceret.

Enheder

Forsigtigt

Hvis du vil undgå potentielle problemer med krydswebstedsscripting (XSS), skal du altid bruge escape-filteret til HTML-kodestrengdata, når du bruger objektet Liquid til at læse data, som brugeren ikke har tillid til.

Bemærkning

Nogle af navngivningskonventionerne for Dataverse er ændret. Dataverse-enheder kaldes f.eks. nu tabeller. Navneændringerne gælder ikke for Flydende objekter. Objektet Liquid-objekter kaldes fortsat objekter.

Brug dette objekt til at indlæse en hvilken som helst Dataverse-tabel efter id. Hvis tabellen findes, returneres et tabelobjekt. Hvis en tabel med det angivne id ikke findes, returneres null.

{% assign account = entities.account['936DA01F-9ABD-4d9d-80C7-02AF85C822A8'] %}

{% if account %}

{{ account.name | escape }} ({{ account.statecode.label | escape }})

{% endif %}

{% assign entity_logical_name = 'contact' %}

{% assign contact = entities[entity_logical_name][request.params.contactid] %}

{% if contact %}

{{ contact.fullname | escape }} ({{ contact.parentcustomerid.name | escape }})

{% endif %}

Objekt

Et enhedsobjekt giver adgang til attributterne for en tabelpost i Dataverse.

Egenskab	Beskrivelse
id	GUID-id'et for en tabel som en streng. F.eks. 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logisk_navn	Det logiske Dataverse-navn på tabellen.
Bemærkninger	Indlæser noter (anmærkninger), der er knyttet til tabellen, sorteret fra ældste til nyeste (createdon). Noter returneres som noteobjekter.
tilladelser	Indlæser tabeltilladelsens assertionsresultater for tabellen. Resultaterne returneres som et tilladelsesobjekt.
url	Returnerer URL-stien til Power Pages til indholdsstyringssystemet for tabellen. Hvis tabellen ikke har en gyldig URL-adresse på det aktuelle websted, returneres null. Generelt returnerer dette kun en værdi for bestemte tabeltyper, som er blevet integreret i portal-CMS, medmindre du har tilpasset URL-provideren i programmet.
[attribut eller relationsnavn]	Du kan få adgang til en attribut i Dataverse-tabellen efter logisk navn. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Værdierne for de fleste tabelattributter knyttes direkte til Liquid-typer: To grupperede felter knyttes til booleske værdier, tekstfelter til strenge og numeriske felter/valutafelter til tal, dato og klokkeslæt-felter til dato-objekter. Men nogle attributtyper returneres som objekter: Opslagsfelter (tilknyttet tabelreference) returneres som tilknyttede tabelreferenceobjekter. Felter for grupperede indstillinger/valglistefelter returneres som værdiobjekter af typen grupperet indstilling. Du kan også indlæse relaterede objekter efter relationsskemanavn. {{ page.adx_webpage_entitylist.adx_name }}I tilfælde af, at en relation er refleksiv (dvs. refererer til sig selv), returneres et refleksivt relationsobjekt. (Ellers ville resultatet være flertydigt).{{ page.adx_webpage_webpage.referencing.adx_name }} Bemærk! Indlæsning af et stort antal relaterede objekter eller åbning af et stort antal relationer i en enkelt skabelon kan have en negativ indvirkning på skabelonens gengivelsesydeevne. Undgå at indlæse relaterede objekter for hvert element i en matrix i en løkke. Hvor det er muligt, skal du bruge Dataverse-tabelmærker til at indlæse samlinger af objekter.

Tilknyttet tabelreference

Opslagsattributværdier returneres som tilknyttede tabelreferenceobjekter med følgende attributter.

Egenskab	Beskrivelse
id	GUID-id'et for en tabel, der refereres til, som en streng. F.eks. 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logisk_navn	Det logiske navn i Dataverse på den tabel, der refereres til.
Name	Den primære navneattribut for referencetabellen.

Bemærkning

En note er en tabel, der giver adgang til attributter og relationer i en anmærkningspost. Ud over alle attributterne for en tabel har en note følgende ekstra attributter.

Egenskab	Beskrivelse
dokumentindhold	Indlæser attributten documentbody for noteanmærkningsposten som en Base64-kodet streng. Eftersom indholdet af denne attribut kan være omfattende, indlæses det ikke med resten af noteattributterne. Det indlæses kun på anmodning. Bemærk: Brug af documentbody-attributten kan have en negativ effekt på skabelonens ydeevne og skal ske med forsigtighed. Brug url-attributten til at angive et link til den fil, der er vedhæftet noten, i stedet, hvis det er muligt.
url	Returnerer URL-sti til den indbyggede portalfunktion til håndtering af vedhæftet filer i anmærkninger. Hvis brugeren har tilladelse, og noten har en vedhæftet fil, henter en anmodning til denne URL-adresse den vedhæftede fil til noten.

Bemærkning

Flere filtre

Værdi for valgmulighedssæt

Attributværdier for grupperet indstilling/valglister returneres som tilknyttede tabelreferenceobjekter med følgende attributter.

Egenskab	Beskrivelse
Label	Den lokaliserede etiket for attributværdien for grupperet indstilling/valgliste. Et eksempel er Aktiv
Værdi	Heltalsværdien for attributværdien for grupperet indstilling/valgliste. For eksempel 0

Tabeltilladelser

Objektet Tabeltilladelser giver adgang til samlede tilladelsesassertionsresultater for en tabel.

Egenskab	Beskrivelse
can_append	Returnerer true, hvis den aktuelle bruger har tilladelse til at føje poster til relationer for denne post. Ellers returnerer den false.
can_append_to	Returnerer true, hvis den aktuelle bruger har tilladelse til at føje denne post til en relation for en anden tabel. Ellers returnerer den false.
kan_oprette	Returnerer true, hvis den aktuelle bruger har tilladelse til at oprette nye poster for denne tabeltype. Ellers returnerer den false.
kan_slette	Returnerer true, hvis den aktuelle bruger har tilladelse til at slette denne post. Ellers returnerer den false.
kan_læse	Returnerer true, hvis den aktuelle bruger har tilladelse til at læse denne post. Ellers returnerer den false.
kan_skrive	Returnerer true, hvis den aktuelle bruger har tilladelse til at opdatere denne postering. Ellers returnerer den false.
regler_findes	Returnerer true, hvis tilladelsesresultaterne, som repræsenteres af dette objekt, er resultatet af de udtrykkeligt definerede tilladelsesregler. Returnerer false, hvis de er standardresultaterne, og der ikke foreligger eksplicit definerede tilladelser.

Refleksiv relation

Forsøger at indlæse refleksive (dvs. selvrefererende) relationer på objekter, der returneres som objekter med følgende attributter.

Egenskab	Beskrivelse
is_reflexive	Returnerer true. Kan bruges til at afprøve, om et objekt, der returneres af en relation, er et refleksivt relationsobjekt.
refereret til	Returnerer en matrix af refererede objekter for den angivne relation.
henvisning	Returnerer en referencetabel for den angivne relation. Returnerer null, hvis der ikke findes en tabel, der refereres til. Hvis relationen er mange til mange (N:N), skal du returnere en matrix af refererende objekter.

entitetsliste

Brug objektet entitylist i dataverse-tabelkoderne til at få adgang til alle attributterne på en given liste.

Bemærkning

Gengive listen, der er tilknyttet den aktuelle side

Egenskaber

Bemærkning

entities

Egenskab	Beskrivelse
create_enabled	Returnerer true, hvis oprettelse af nye poster er konfigureret til listen. Ellers returnerer den false.
create_url	Returnerer den konfigurerede URL-sti til et oprettelseslink eller en knap til listen.
detalje_aktiveret	Returnerer true, hvis en detaljeret visning til de enkelte poster er konfigureret for listen. Ellers returnerer den false.
detalje_id_parameter	Returnerer forespørgselsstrengens parameternavn, som skal bruges til post-id'et under oprettelsen af en URL-adresse til en postdetaljevisning. Se URL-filtre for at få oplysninger om brug af Liquid-filtre til konstruktion af URL-adresser. F.eks. ID
detaljeetiket	Returnerer det konfigurerede oversatte navn for links til detaljevisning eller knapper for listen.
detail_url	Returnerer den konfigurerede URL-sti for links eller knapper til detaljevisning for listen.
tom_listetekst	Returnerer den konfigurerede oversatte tekst, der skal vises, når listevisningen ikke returnerer nogen resultater.
aktiver_enhedstilladelser	Returnerer true, hvis filtrering af tabeltilladelser er aktiveret for denne liste. Ellers returnerer den false.
entity_logical_name	Returnerer Dataverse-tabellens logiske navn for poster, der skal vises af denne liste. For eksempel kontakt
filter_konto_attribut_navn	Returnerer det logiske attributnavnet for det opslag i konto, der skal bruges til at filtrere resultatposter efter den aktuelle portalbrugers overordnede konto. For eksempel accountid
filter_apply_label	Returnerer den konfigurerede oversatte etiket, der skal bruges til linket eller knappen, der anvender et avanceret attributfilter på listeresultaterne.
filter_definition	Returnerer JSON-attributtens filterdefinitionen til listen. Se Listefiltre for at få oplysninger om, hvordan du kan bruge metafilter Liquid-filtrene til at behandle denne definition.
filter_aktiveret	Returnerer true, hvis avanceret attributfiltrering er aktiveret for listen. Ellers returnerer den false.
filter_portal_bruger_attribut_navn	Returnerer det logiske attributnavn for det opslag i kontakt, der skal bruges til at filtrere resultatposter af den aktuelle portalbrugers kontaktperson. For eksempel contactid
filter‑website‑attribute‑name	Returnerer det logiske attributnavn for opslaget i adx_website, der skal bruges til at filtrere resultatposter af det aktuelle portalwebsted, For eksempel adx_websiteid
language_code	Returnerer den sprogkode for heltalssproget Dataverse, der bruges til at vælge alle oversatte navne til denne liste.
page_size	Returnerer størrelsen på den konfigurerede resultatside for listen.
primary_key_name	Returnerer den primære nøgleattributs logiske navn for poster, der skal vises af denne liste.
søgning_aktiveret	Returnerer true, hvis søgning er aktiveret for denne liste. Ellers returnerer den false.
search_placeholder	Returnerer den konfigurerede oversatte tekst til listens søgefeltpladsholder.
søgeværktøjstip	Returnerer den konfigurerede oversatte tekst til listens søgeværktøjstip.
visninger	Returnerer de tilgængelige visninger for listen som visningsobjekter for listen.
[attribut logisk navn]	Du kan få adgang til en hvilken som helst attribut i listens (adx_entitylist) Dataverse-post efter logisk navn på samme måde som et tabel-objekt. F.eks. {{ entitylist.adx_name }}

Attributter for listevisning

Egenskab	Beskrivelse
kolonner	Returnerer kolonnerne i visningen som listevisningens kolonneobjekter.
entity_logical_name	Returnerer Dataverse-tabellens logiske navn for de poster, der er medtaget i visningen. For eksempel kontakt
id	Returnerer visningens GUID-id.
language_code	Returnerer den sprogkode for heltalssproget Dataverse, der bruges til at vælge alle oversatte navne (kolonneoverskrifter og andre navne) til visningen.
Name	Returnerer det viste Dataverse-navn for visningen.
primær_nøgle_logisk_navn	Returnerer det logiske navn for Dataverse-tabellens primære nøgle for de poster, der er medtaget i visningen, For eksempel contactid
Sorteringsudtryk	Returnerer standardsorteringsudtrykket for visningen. For eksempel name ASC, createdon DESC.

Kolonneattributter for listevisning

Egenskab	Beskrivelse
attribute_type	Returnerer Dataverse-attributtens typenavn for kolonnen som en streng, For eksempel opslag, valgliste, streng, boolesk værdi, DateTime
logisk_navn	Returnerer Dataverse-attributtens logiske navn for kolonnen, For eksempel createdon
Name	Returnerer det oversatte viste Dataverse-navn for kolonnen, For eksempel Oprettet den
sortér_stigende	Returnerer en sorteringsstreng til sortering af kolonnen i stigende rækkefølge. For eksempel createdon ASC
sortér_faldende	Returnerer en sorteringsstreng til sortering af kolonnen i faldende rækkefølge. For eksempel createdon DESC
sortering_deaktiveret	Returnerer true, hvis sortering er deaktiveret for kolonnen. Ellers returnerer den false.
sortering_aktiveret	Returnerer true, hvis sortering er aktiveret for kolonnen. Ellers returnerer den false.
bredde	Returnerer den konfigurerede bredde for kolonnen i pixel.

entityview

Brug objektet entityview i entityview-koden. Den giver adgang til metadataene for visningen ud over at få vist resultatposter.

Egenskaber

Egenskab	Beskrivelse
kolonner	Returnerer kolonnerne i visningen som tabelvisning for kolonneobjekter.
entity_tilladelse_nægtet	Returnerer true, hvis der blev nægtet adgang til at få vist resultater på grund af utilstrækkelige tabeltilladelser for den aktuelle bruger. Returnerer false, hvis der er givet læseadgang til visningsresultater.
entity_logical_name	Det logiske navn for Dataverse-tabellen for visningsresultatposter. For eksempel kontakt
first_page	Sidetallet på den første side i visningsresultater. Det er 1, medmindre der ikke blev returneret nogen resultater, og så er det null.
id	GUID-id for den Dataverse-visning, der definerer denne entitetsvisning.
language_code	Sprogkoden for det Dataverse-heltal, der bruges til at indlæse oversatte etiketter for den aktuelle visning.
last_page	Sidetallet på den sidste side i visningsresultater. Hvis der ikke blev returneret nogen resultater, er værdien null.
name	Navnet på den Dataverse-visning, der definerer denne entityview, f.eks. Aktive kontakter.
next_page	Sidetallet på den næste side i visningsresultater. Hvis der ikke er nogen næste side med resultater, er værdien null.
Side	Sidetallet på den aktuelle side i visningsresultater.
pages	Returnerer en matrix af sidetal, der indeholder alle sider med resultater for den aktuelle visning.
page_size	Antallet af resultater, der returneres pr. side for den aktuelle visning.
previous_page	Sidetallet på den næste side i visningsresultater. Hvis der ikke er nogen forrige side med resultater, er dette null.
primær_nøgle_logisk_navn	Det logiske navn i Dataverse på den primære nøgleattribut for resultattabellen for denne visning. For eksempel contactid.
optegnelser	Den aktuelle side med resultatoptegnelser for visningen, som tabelobjekter.
Sorteringsudtryk	Standardsorteringsudtrykket for visningen. For eksempel nameASC, createdon DESC.
antal_sider	Det samlede antal sider med resultater for visningen.
total_records	Det samlede antal resultater for visningen (på tværs af alle sider).

Begivenheder

Gør det muligt at hente og vise hændelser. Med objektet events kan du vælge en bestemt hændelse eller alle hændelser.

hændelsesobjekt

Brug objektet events til at få adgang til en bestemt hændelse på portalen eller til at få adgang til alle hændelser på portalen.

Objektet events har følgende attributter:

Egenskab	Beskrivelse
forekomster	Returnerer et eventoccurrences objekt, der indeholder alle hændelsesforekomster på portalen.
[hændelsesnavn eller -id]	Få adgang til en hvilken som helst hændelse ved hjælp af egenskaberne Name eller ID. {% tildele hændelse = hændelser["Hændelsesnavn"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

hændelsesobjekt

Brug objektet event til at arbejde med en enkelt hændelse. Du kan få adgang til tidsplaner og forekomster for den pågældende hændelse.

Objektet event har følgende attributter:

Egenskab	Beskrivelse
forekomster	Returnerer et eventoccurrences-objekt, der indeholder alle forekomster for hændelsen.
name	Navnet på hændelsen.
url	URL-adressen for hændelsen.

Objektet eventoccurrences

Objektet eventoccurrences giver dig adgang til en samling af hændelsesforekomstobjekter. Du kan ændre rækkefølgen af hændelsesforekomster og angive et datointerval for de hændelser, der skal hentes, og gennemføre sideinddeling samt bruge Liquid-filtre:

{% assign occurances = event.occurrences.from[today].to[advance_date] %}

{% assign occurances = event.occurrences.min[today].max[advance_date] %}

Følgende attributter er knyttet til eventoccurrences-objekt

Egenskab	Beskrivelse
Alle	Returnerer alle eventoccurrence-objekter i samlingen.

Objektet eventoccurrence

Repræsenterer en enkelt hændelsesforekomst. Der er følgende tilknyttede attributter:

Egenskab	Beskrivelse
url	URL-adressen til forekomsten.
er_heldagsbegivenhed	Er dette en hændelse, der varer hele dagen?
starttid	Starttidspunktet for hændelsen.
sluttidspunkt	Sluttidspunktet for hændelsen.

forloop

Indeholder egenskaber, der er nyttige i en for-løkkeblok.

Bemærkning

forloop kan kun bruges i et mærke af typen for.

Kode

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

This is child page number {{ forloop.index }}.

{% endif %}

{% endfor %}

output

This is the first child page!

This is child page number 2.

This is child page number 3.

Egenskaber

Egenskab	Beskrivelse
Første	Returnerer true, hvis det er den første gentagelse af løkken. Returnerer false, hvis det ikke er den første gentagelse.
indeks	Det aktuelle elements position i samlingen, hvor det første element har positionen 1.
index0	Det aktuelle elements position i samlingen, hvor det første element har positionen 0.
Sidste	Returnerer true, hvis det er den sidste gentagelse af løkken. Returnerer false, hvis det ikke er den sidste gentagelse.
længde	Returnerer antallet af gentagelser i løkken ߝ svarende til antallet af elementer i samlingen, der itereres over.
rindex	Antallet af elementer, der er tilbage i løkken (længde - indeks), hvor 1 er indekset for det sidste element.
rindex0	Antallet af elementer, der er tilbage i løkken (længde - indeks), hvor 0 er indekset for det sidste element.

forums

Gør det muligt at hente og få vist fora og forumtråde. Muligheden for at bruge væske til at gengive forumdata omfatter indlæg, men hvis du vil oprette et nyt indlæg eller en ny tråd, skal du bruge en ASP.NET sideskabelon med flere trin med den funktionalitet, der er indbygget (f.eks. standardskabelonerne forumtråd og forumindlægsside).

Med objektet forum kan du vælge et forum eller forumtråde:

<div class=content-panel panel panel-default>

<div class=panel-heading>

<h4>

<span class=fa fa-comments aria-hidden=true></span>

{{ snippets[Home Forum Activity Heading] | default: Forum Activity | h }}

</h4>

</div>

{% for forum in website.forums %}

<ul class=list-group>

<li class=list-group-item>

<div class=row>

<div class=col-sm-6>

<h4 class=list-group-item-heading><a href="{{ forum.url | h }}"> {{ forum.name | h }}</a></h4>

<div class=list-group-item-text content-metadata>{{ forum.adx_description | h }}</div>

</div>

<div class=col-sm-3 content-metadata>{{ forum.thread_count }} threads</div>

<div class=col-sm-3 content-metadata>{{ forum.post_count }} posts</div>

</div>

</li>

</ul>

{% endfor %}

</div>

objekt for forummer

Objektet forums giver dig adgang til et bestemt forum på portalen eller til alle forumtråde på portalen (uanset forummet).

Forumobjektet giver dig mulighed for at arbejde med et enkelt forum, så du kan få adgang til trådene til dette forum.

Objektet forumthreads giver dig adgang til en samling af forumthread-objekter. Du kan bestille forumtråde og opnå sideinddeling ved hjælp af flydende filtre.

{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}

En enkelt forumtråd

Objektet forumposts giver dig adgang til en samling af forumposts-objekter.

Egenskaber

Egenskab	Beskrivelse
tråde	Returnerer et forumthreads-objekt, der indeholder alle forumthread-objekter på portalen.
Alle	Returnerer alle forum-objekter på portalen. Bemærk, at website.forums også er en ækvivalent.
thread_count	Returnerer heltalsværdien af en optælling af, hvor mange tråde der er på hele webstedet.
antal_indlæg	Returnerer heltalsværdien af det samlede antal opslag på portalen.
[forumnavn eller -id]	Du kan få adgang til et hvilket som helst forum ved hjælp af dets navn eller id-egenskaber. {% assign forum = forums[Forum Name] %} {% tildel forum = fora[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Objektet forum

Egenskaber

Bemærkning

entities

Egenskab	Beskrivelse
tråde	Returnerer et forumthreads-objekt, der indeholder alle forumtråde for forummet.
Name	Navnet på forummet.
thread_count	Returnerer heltalsværdien af en optælling af, hvor mange tråde der er på forummet.
antal_indlæg	Returnerer heltalsværdien af en optælling af, hvor mange opslag i alt der er på hele forummet.

Objektet Forumthreads

Egenskaber

Egenskab	Beskrivelse
Alle	Returnerer alle forumthread-objekter i samlingen.

Objektet forumthread

Egenskaber

Bemærkning

entities

Egenskab	Beskrivelse
posts	Returnerer et forumposts-objekt, der indeholder alle forumopslag for tråden.
forfatter	Returnerer forfatteren til tråden (som blot er et objekt af typen kontakttabel).
seneste_indlæg	Returnerer det nyeste opslag i tråden.
første_indlæg	Returnerer det første opslag i tråden.
antal_indlæg	Returnerer heltalsværdien af en optælling af, hvor mange opslag der er på tråden.
er_besvaret	Er tråden besvaret eller ej?
is_sticky	Er tråden selvklæbende?

Objektet forumposts

Egenskaber

Egenskab	Beskrivelse
Alle	Returnerer alle forumthread-objekter i samlingen.

Et enkelt forumopslag

Egenskaber

Bemærkning

entities

Egenskab	Beskrivelse
forfatter	Returnerer forfatteren til opslaget (som blot er et objekt af typen kontakttabel).
indhold	Opslagets indhold.
er_svar	Er dette opslag et svar til tråden?

viden

Giver adgang til tabelposter af typen knowledgearticle og category i Dataverse til gengivelse af artikler og kategorier i en portal.

Egenskaber

Egenskab	Beskrivelse
artikler	Returnerer et articles-objekt, der indeholder artikelobjekter for de tabelposter af typen videnbaseartikel, der er tilgængelige på portalen.
kategorier	Returnerer et categories-objekt, der indeholder kategoriobjekter for de kategoritabelposter, der er tilgængelige på portalen.

Objektet articles

Objektet articles giver dig adgang til en samling af article-objekter. Du kan arrangere artiklerne og gennemføre sideinddeling ved hjælp af Liquid-filtre.

{% assign count = count | default: 3 %}
{% assign languagecode = website.selected_language.code %}
{% assign popular_articles = knowledge.articles | popular: count,languagecode  %}
{% if popular_articles %}
    <div class=list-group>
    {% for article in popular_articles %}
      <div class=list-group-item clearfix>
        <a class=title href={{ article.url | escape }}>{{ article.title | escape }}</a>
        <p class=description>{{ article.description | escape }}</p>
      </div>
    {% endfor %}
    </div>
{% endif %}

Egenskaber

Egenskab	Beskrivelse
populær	Returnerer den samling article-objekter, der indeholder de fleste visninger. {% assign popular_articles = knowledge.articles.popular %}
seneste	Returnerer den samling article-objekter, der indeholder den seneste ændrede dato. {% assign recent_articles = knowledge.articles.recent %}
top	Returnerer den samling article-objekter, der indeholder den højeste bedømmelse. {% assign top_articles = knowledge.articles.top %}

Filtre

Følgende filtre kan acceptere valgfrie parametre for størrelse og sprog. Den første parameter er det tal eller de poster, der skal hentes. Standardsidestørrelsen er 5. Den anden parameter er koden for et sprog, der bruges til at hente artikler på et bestemt sprog. Filtre kan kombineres med andre Liquid-filtre.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}

Egenskab	Beskrivelse
populær	Returnerer den samling article-objekter, der indeholder de fleste visninger. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
seneste	Returnerer den samling article-objekter, der indeholder den seneste ændrede dato. {% assign recent_articles = knowledge.articles \| recent: 5 %}
top	Returnerer den samling article-objekter, der indeholder den højeste bedømmelse. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

Kategoriobjekt

Objektet categories giver dig adgang til en samling af kategoriobjekter. Du kan arrangere kategorierne og gennemføre sideinddeling ved hjælp af Liquid-filtre.

{% assign category_url = sitemarkers['Category'].url %}
  {% assign count = count | default: 0 %}  
  {% assign categories = knowledge.categories | top_level: count %}
  {% if categories %}
    <div class=list-group unstyled>
    {% for category in categories %}
      <a href={{ category_url | add_query: 'id', category.categorynumber }} class=list-group-item>
        {{ category.title }}
      </a>
    {% endfor %}
    </div>
  {% endif %}

Egenskaber

Egenskab	Beskrivelse
seneste	Returnerer den samling kategoriobjekter, der indeholder den seneste ændrede dato.
topniveau	Returnerer en samling af kategoriobjekter, der ikke har en overordnet kategori.

Filtre

Følgende filtre kan acceptere en valgfri parameter, som angiver sidestørrelse. Standardsidestørrelsen er 5. Filtre kan kombineres med andre Liquid-filtre.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}

Egenskab	Beskrivelse
seneste	Returnerer den samling kategoriobjekter, der indeholder den seneste ændrede dato. Du kan angive parametre {% assign recent_categories = knowledge.categories \| recent: 10 %}
topniveau	Returnerer en samling af kategoriobjekter, der ikke har en overordnet kategori. {% assign root_categories = knowledge.categories \| top_level %}

Objektet article

Objektet article giver dig mulighed at arbejde med en enkelt videnartikel for at få vist detaljerne for denne artikel på portalen.

Egenskaber

Article er et objekt af typen entity med de samme attributter foruden følgende attributter:

Egenskab	Beskrivelse
artikel_offentligt_nummer	Det offentlige artikelnummer for artiklen.
comment_count	Heltalsværdien for optællingen af, hvor mange kommentarer der er for en given artikel.
indhold	Indholdet af artiklen.
current_user_can_comment	Returnerer en boolesk værdi, der angiver, om den aktuelle bruger kan indsætte kommentarer til artiklen.
er_vurdering_aktiveret	Returnerer en boolesk værdi, der angiver, om klassificering for en artikel er aktiveret.
keywords	Nøgleordene i artiklen.
name	Et alternativ alias for titlen på artiklen.
bedømmelse	Artiklens decimalklassificeringsværdi.
titel	Titlen på artiklen.
visningstæller	Heltalsværdien for det antal gange, artiklen er blevet vist.

Kategori objekt

Objektet category giver dig mulighed at arbejde med en enkelt kategori for at vise dens detaljer på portalen.

Egenskaber

category er et objekt af typen entity med de samme attributter foruden følgende attributter:

Egenskab	Beskrivelse
kategorinummer	Kategoriens kategorinummer.
name	Et alternativ alias for titlen på kategorien.
titel	Titlen på kategorien.

sprog

Angiver det aktuelle sprognavn og den aktuelle sprogkode, hvis understøttelse af flere sprog er aktiveret.

Egenskaber

Egenskab	Beskrivelse
url	URL-adressen til den aktuelle forespørgsel med præfikset for den aktuelle sprogkode.
url_substitution	URL-adressen til den aktuelle forespørgsel med præfikset for den aktuelle sprogkode, idet den omgår sideoutputcachen.
name	Titel på det aktuelle sprog.
kode	Sprogkoden for sproget.

Webskabelonen Rulleliste med sprog bruger f.eks. som standard dette liquid-objekt til at angive de tilgængelige sprog, når der er flere sprog.

log

Udviklere har mulighed for at indarbejde logsætninger i deres Liquid-kode. Når det Power pages websted kører, vises de logge, der er tilføjet af en udvikler i flydende kode, i udvidelsen Power Pages udviklerværktøj. Disse logge, der er integreret af udvikleren, vises i udviklerværktøjsudvidelsen, når diagnosticeringsindstillingen er aktiveret.

Følgende syntaks kan bruges i Liquid-kode til at logføre brugerdefinerede meddelelser:

{% log message:'Custom message' level:'Warning' %}

Logattributter

Egenskab	Beskrivelse
log	Navn på Liquid-objekt
meddelelse	En streng, der repræsenterer brugerdefinerede meddelelser, der skal logføres
niveau	Log meddelelsen som info, advarsel eller fejl

Eksempel:

{% log message: 'Log from Home page' %}

{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}

{% assign contacts = query.results.entities %}

{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %} 
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}

page

Refererer til den aktuelle anmodningsside i portalen. Dette objekt kombinerer attributterne for sitemap og den aktuelle anmodning om entities (normalt en webside).

Objektet page giver adgang til ting som brødkrummerne for den aktuelle side, titel eller URL-adresse på den aktuelle side og eventuelle andre attributter eller relaterede objekter i den underliggende Dataverse-post.

<ul class=breadcrumb>

{% for crumb in page.breadcrumbs %}

<li><a href={{ crumb.url | escape }}>{{ crumb.title | escape }}</a></li>

{% endfor %}

<li class=active>{{ page.title | escape }}</li>

</ul>

<div class=page-header>

<h1>{{ page.title | escape }}</h1>

</div>

<div class=page-copy>

{{ page.adx_copy }}

</div>

<div class=list-group>

{% for child in page.children %}

<a class=list-group-item href={{ child.url | escape }}>

{{ child.title | escape }}

</a>

{% endfor %}

</div>

<!-- Page {{ page.id }} was last modified on {{ page.modifiedon }}. -->

Sideattributter

Bemærkning

entities

Egenskab	Beskrivelse
brødkrummer	Returnerer brødkrummenodeobjekter for oversigt over websted for siden, og starter fra rodnoden i webstedsoversigten og slutter ved den overordnede node.
børn	Returnerer de underordnede nodeobjekter i webstedsoversigten for siden.
overordnet	Returnerer den overordnede node i webstedsoversigten for siden. Hvis siden er startsiden, er parent null.
titel	Titlen på siden.
url	URL-adressen for siden.
[attribut eller relationsnavn]	Du kan få adgang til enhver attribut for sidens underliggende Dataverse-post ved hjælp af det logiske navn. {{ page.createdon }} {% assign attribute_name = 'name' %} {{ page[attribute_name] }} Værdierne for de fleste tabelattributter knyttes direkte til Liquid-typer: To grupperede felter knyttes til booleske værdier, tekstfelter til strenge og numeriske felter/valutafelter til tal, dato og klokkeslæt-felter til dato-objekter. Men nogle attributtyper returneres som objekter: Opslagsfelter (tilknyttet tabelreference) returneres som tilknyttede tabelreferenceobjekter. Felter for grupperede indstillinger/valglistefelter returneres som værdiobjekter af typen grupperet indstilling. Du kan også indlæse relaterede objekter efter relationsskemanavn. {{ page.adx_webpage_entitylist.adx_name }} I tilfælde af, at en relation er refleksiv (dvs. refererer til sig selv), returneres et entities-objekt. (Ellers ville resultatet være flertydigt).{{ page.adx_webpage_webpage.referencing.adx_name }} Bemærk! Indlæsning af et stort antal relaterede objekter eller åbning af et stort antal relationer i en enkelt skabelon kan have en negativ indvirkning på skabelonens gengivelsesydeevne. Undgå at indlæse relaterede objekter for hvert element i en matrix i en løkke. Hvor det er muligt, skal du vælge at bruge Dataverse tabel-tags til at indlæse samlinger af objekter.

afstemninger

Gør det muligt at hente og vise en afstemning.

Med polls-objektet kan du vælge en bestemt afstemning eller afstemningssted.

<div>

{% assign poll = polls[Poll Name] %}

<h4>{{ poll.question }}</h4>

{% for option in poll.options %}

<div>

<input type=radio name={{ poll.name }} id={{ option.id }} />

<label for={{ option.id }}>{{ option.answer }}</label>

</div>

{% endfor %}

<button type=button>{{ poll.submit_button_label }}</button>

</div>

Afstemningsattributter

Egenskab	Beskrivelse
placeringer	Returnerer objektet pollplacements.
[forespørgselsnavn eller -id]	Du kan få adgang til en hvilken som helst afstemning ved hjælp af egenskaberne Name eller ID. {% assign poll = polls[Poll Name] %} {% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Attributter for afstemningssteder

Egenskab	Beskrivelse
[navn eller id for afstemningsplacering]	Du kan få adgang til alle afstemningsplaceringer ved hjælp af egenskaberne Navn eller Id.{% assign placement = polls.placements[Placement Name or Id] %} {% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Attributter for afstemningssted

Bemærkning

entities

Egenskab	Beskrivelse
Name	Returnerer feltet Navn for afstemningsstedet.
placement_url	Den URL-adresse, der kan bruges til at hente afstemningsstedet fuldt gengivet af en skabelon.
afstemninger	Returnerer samlingen af afstemningsobjekter, der er knyttet til stedet. Gentagelsesmærker og Matrixfiltre kan bruges sammen med denne samling.
random_url	Den URL, der kan bruges til at hente en vilkårlig afstemning fra en placering fuldt gengivet af en skabelon.
submit_url	Den URL-adresse, som en fuldført afstemning sendes til.

Afstemningsattributter

Bemærkning

entities

Egenskab	Beskrivelse
har_brugeren_stemt	Returnerer true, hvis den aktuelle bruger (logget ind eller anonym) allerede har stemt ved denne afstemning.
Name	Returnerer feltet Navn for afstemningen.
muligheder	Returnerer samlingen af poll option-objekter, der er knyttet til afstemningen. Gentagelsesmærker og objekter kan bruges sammen med denne samling.
poll_url	Den URL-adresse, der kan bruges til at hente afstemningen fuldt gengivet af en skabelon.
spørgsmål	Returnerer feltet Spørgsmål for afstemningen.
indsend_knapmærke	Returnerer en streng, der kan bruges til at tilsidesætte etiketten på afsendelsesknappen for afstemningen.
submit_url	Den URL-adresse, som en fuldført afstemning sendes til.
bruger_valgt_indstilling	Returnerer objektet polloption, der er valgt af brugeren (hvis de har allerede stemt).
stemmer	Returnerer antallet af stemmer, der er optalt i afstemningen.

Attributter for afstemningsmulighed

Bemærkning

entities

Egenskab	Beskrivelse
svar	Returnerer feltet Svar for afstemningen.
procentdel	Returnerer procentdelen af stemmer i afstemningen for valgmuligheden som et decimaltal fra 0 til 100.
stemmer	Returnerer antallet af stemmer, der er i tabelformat for valgmuligheden.

anmodning

Indeholder oplysninger om den aktuelle HTTP-anmodning.

{% assign id = request.params['id'] | escape %}

<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>

Bemærkning

• Du kan oprette URL-adresser dynamisk i Liquid ved hjælp af URL-filtre.
• Den URL-adresse, der bruges i request.url, kan have en hvilken som helst værdi og bliver 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.
• Power Pages version 9.3.8.x eller nyere har som standard Liquid-filteret escape håndhævet for Liquid-objekterne bruger og anmodning. Hvis du vil deaktivere denne standardkonfiguration og tillade, at disse styringsobjekter slippes fra filteret, skal du se webstedsindstillinger for portal - Websted/EnableDefaultHtmlEncoding.

Egenskaber

Egenskab	Beskrivelse
params	Navngivne parameterværdier for den aktuelle anmodning. params er en kombination af URL-forespørgselsstrengparametre, formularopslagsparametre og cookies.
Sti	Stien for den aktuelle URL-adresse til anmodningen. /profile/
path_and_query	Stien og forespørgslen for den aktuelle URL-adresse til anmodningen. /profile/?foo=1&bar=something
forespørgsel	Forespørgselsdelen af den aktuelle URL-adresse til anmodningen. ?foo=1&bar=something
url	Den fuldstændige URL-adresse til den aktuelle anmodning. https://www.example.com/profile/?foo=1&bar=something

søgeindeks

Objektet searchindex bruges i Dataverse-tabeltags og giver adgang til resultaterne af en forespørgsel.

{% searchindex query: 'support', page: params.page, page_size: 10 %}

{% if searchindex.results.size > 0 %}

<p>Found about {{ searchindex.approximate_total_hits }} matches:</p>

<ul>

{% for result in searchindex.results %}

<li>

<h3><a href={{ result.url | escape }}>{{ result.title | escape }}</a></h3>

<p>{{ result.fragment }}</p>

</li>

{% endfor %}

</ul>

{% else %}

<p>Your query returned no results.</p>

{% endif %}

{% endsearchindex %}

Egenskaber

Egenskab	Beskrivelse
approximate_total_hits	Returnerer et omtrentligt samlet antal hit, der stemmer overens med indeksforespørgslen. På grund af den måde, søgeindekset fungerer på med hensyn til sikkerhedsfiltrering og andre designfaktorer, er dette tal er kun omtrentligt og er ikke nødvendigvis identisk med det samlede antal resultater, der er tilgængelige for den aktuelle bruger i nogle situationer.
Side	Returnerer sidetallet for den aktuelle forespørgsel.
page_size	Returnerer den maksimale sidestørrelse for den aktuelle forespørgsel. Hvis du ønsker det faktiske antal resultater returneret for den aktuelle side (fordi det kan være mindre end den angivne maksimale sidestørrelse), skal du bruge results.size.
resultater	Returnerer forespørgslens resultatside som resultatobjekter for søgeindekset.

Søgeindeksresultater

Egenskab	Beskrivelse
enhed	De underliggende enheder for resultatet.
fragment	Et relevant kort tekstfragment for resultatet med betingelser, der svarer til den angivne forespørgsel, der er fremhævet ved hjælp af <em>-HTML-mærket. Visse typer af forespørgsler understøtter ikke fremhævede fragmenter, som f.eks. fuzzy-forespørgsler (~) og forespørgsler med jokertegn (*). Denne egenskab er null i disse tilfælde.
id	Dataverse-tabellens id for den underliggende post for resultatet, som en streng, F.eks. 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logisk_navn	Dataverse-tabellens logiske navn for den underliggende post for resultatet. F.eks. adx_webpage
nummer	Antallet af resultatet på tværs af alle sider med søgeresultater, startende med 1. For eksempel for det første resultat af den anden side med resultater, med en sidestørrelse på 10, er denne værdi 11.
resultat	Lucene-score af resultatet, som en kommatalsværdi. Resultaterne returneres i rækkefølge efter denne værdi.
titel	Titlen på resultatet.
url	URL-adressen for resultatet. Denne URL-adresse er normalt – men ikke nødvendigvis – en absolut sti til det aktuelle program i stedet for en komplet URL-adresse. For eksempel: /articles/article1/

serverlogisk

Under gengivelse af serverlogic flydende skabelon aktiverer koden en serverlogikhandling. Parameteren output for serverlogic koden opretter objektet. Objektet er ikke tilgængeligt som et globalt liquid-objekt.

Syntaks

{% serverlogic name: 'server-logic-name', operation: 'operation-name', input: inputData, output: result %}

Parametre

Parameter	Påkrævet	Beskrivelse
name	Ja	Navnet på den serverlogikpost, der skal aktiveres.
operation	Ja	Navnet på den JavaScript-funktion, der skal aktiveres i serverlogikposten.
input	Nej	En streng, som koden overfører til serverlogikhandlingen. Brug en JSON-streng til at overføre strukturerede data. Handlingen kan få adgang til værdien via Server.Context.Input.
output	Ja	Navnet på variablen Liquid, der modtager resultatobjektet for serverlogik.

I følgende eksempel overføres JSON-input til en serverlogikhandling:

{% assign inputData = '{"category":"active","maximumResults":5}' %}

{% serverlogic name: 'customer-summary', operation: 'getSummary', input: inputData, output: result %}

{% if result.success %}
  <p>{{ result.data.message | escape }}</p>
{% else %}
  <p>The customer summary couldn't be retrieved.</p>
{% endif %}

I handlingen serverlogik skal du bruge Server.Context.Input til at læse inputtet:

function getSummary() {
    var input = JSON.parse(Server.Context.Input || "{}");

    return JSON.stringify({
        message: "Summary retrieved",
        category: input.category,
        maximumResults: input.maximumResults
    });
}

Få mere at vide i Kald serverlogik fra Liquid.

Egenskaber

Egenskab	Beskrivelse
success	Returnerer true , når serverlogikhandlingen fuldføres. Ellers returneres false.
status_code	Returnerer statuskoden for serverlogikhandlingen. En udførelsesfejl returnerer statuskoden 500.
data	Returnerer den fortolkede JSON-værdi, som serverlogikhandlingen producerer. Du kan få adgang til indlejrede objekter og matrixer ved hjælp af flydende standardsyntaks.
raw_result	Returnerer det ikke-parsede svar, der er produceret af serverlogikhandlingen. Brug denne attribut, når svaret ikke er gyldigt JSON, eller når du har brug for at undersøge det oprindelige svar.

Vigtigt!

Behandl input og værdier, der returneres af serverlogik, som data, der ikke er tillid til. Valider input i handlingen serverlogik, og anvend filteret, escape før du gengiver returnerede strenge i HTML.

indstillinger

Brug dette objekt til at indlæse alle webstedsindstillinger efter navn. Hvis portalen ikke kan finde en indstilling med det angivne navn, returneres null.

Bemærkning

Portalen returnerer indstillinger som strenge, men du kan bruge Typefiltre til at konvertere dem til andre typer.

{{ settings[My Setting] }}

{% assign search_enabled = settings[Search/Enabled] | boolean %}

{% if search_enabled %}

Search is enabled.

{% endif %}

{% assign pagesize = settings['page size'] | integer | default: 10 %}

{% if pagesize > 10 %}

Page size is greater than 10.

{% endif %}

Bemærkning

Gengive et websteds sidehoved og primære navigationslinje

sitemap

Brug dette objekt til at få adgang til oversigten over portalwebstedet.

<h1>{{ sitemap.root.title }}</h1>

<ul class=breadcrumb>

{% for crumb in sitemap.current.breadcrumbs %}

<li><a href={{ crumb.title }}>{{ crumb.title }}</a></li>

{% endfor %}

<li class=active>{{ sitemap.current.title }}</li>

</ul>

{% for child in sitemap.current.children %}

<a href={{ child.url }}>{{ child.title }}</a>

{% endfor %}

It's also possible to load a site map node by URL path:

{% assign node = sitemap[/content/page1/] %}

{% if node %}

{% for child in node.children %}

<a href={{ child.url }}>{{ child.title }}</a>

{% endfor %}

{% endif %}

Sitemap-attributter

Egenskab	Beskrivelse
Løbende	Returnerer nodeobjektet for oversigten over webstedet for den aktuelle side.
Rod	Returnerer nodeobjektet for oversigten over webstedet for rodsiden (startsiden) på webstedet.

Nodeattributter for oversigt over websted

Egenskab	Beskrivelse
Brødkrummer	Returnerer brødkrummenodeobjekter for oversigt over websted for noden, og starter fra rodnoden i webstedsoversigten og slutter ved den overordnede node.
Children	Returnerer de underordnede nodeobjekter i webstedsoversigten for noden.
Beskrivelse	Beskrivelse/resume af indholdet af noden. (Feltet kan indeholde HTML).
Objekt	Returnerer de underliggende entiteter af noden. Hvis noden ikke har en underliggende tabel, er denne værdi null.
is_sitemap_ancestor	Returnerer true, hvis noden i webstedsoversigten er et overordnet element til den aktuelle node, ellers false.
is_sitemap_current	Returnerer true, hvis noden i webstedsoversigten er den aktuelle node, ellers false.
Overordnet	Returnerer nodens overordnede webstedsnod. Hvis noden er rodnoden, er parent null.
Stilling	Titlen på noden.
url	URL-adressen til noden.

sitemarkers

Gør det muligt at indlæse ethvert webstedsmærke efter navn. Hvis sitemarker findes, returneres et sitemarker-objekt. Hvis en sitemarker med det angivne navn ikke blev fundet, returneres null.

{{ sitemarkers[Login].url }}

{% assign my_sitemarker = sitemarkers["My Site Marker"] %}

{% if my_sitemarker %}

<a href={{ my_sitemarker.url }}>{{ my_sitemarker.adx_name }}</a>

{% else %}

Site marker My Site Marker does not exist.

{% endif %}

Bemærkning

Gengive et websteds sidehoved og primære navigationslinje

Attributter for webstedsmarkering

Egenskab	Beskrivelse
url	URL-adressen på sitemarker-målet.
[attribut logisk navn]	Du kan få adgang til en attribut for sitemarker-målets Dataverse-post efter logisk navn, F.eks. {{ sitemarker.adx_name }}

snippets

Gør det muligt at indlæse alle indholdskodestykker efter navn. Hvis et kodestykke med det angivne navn ikke blev fundet, returneres null.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Indeholder egenskaber, der er nyttige i en Gentagelsesmærker-løkkeblok.

Bemærkning

tablerowloop kan kun bruges i et mærke af typen Gentagelsesmærker.

Egenskaber

Egenskab	Beskrivelse
Col	Returnerer indekset for den aktuelle række startende ved 1.
col0	Returnerer indekset for den aktuelle række startende ved 0.
col_first	Returnerer true, hvis den aktuelle kolonne er den første i en række. Hvis ikke returneres false.
kolonne_sidste	Returnerer true, hvis den aktuelle kolonne er den sidste i en række. Hvis ikke returneres false.
Første	Returnerer true, hvis det er den første gentagelse af løkken. Returnerer false, hvis det ikke er den første gentagelse.
Indeks	Det aktuelle elements position i samlingen, hvor det første element har positionen 1.
index0	Det aktuelle elements position i samlingen, hvor det første element har positionen 0.
Sidste	Returnerer true, hvis det er den sidste gentagelse af løkken. Returnerer false, hvis det ikke er den sidste gentagelse.
Længde	Returnerer antallet af gentagelser i løkken ߝ svarende til antallet af elementer i samlingen, der itereres over.
Rindex	Antallet af elementer, der er tilbage i løkken (længde - indeks), hvor 1 er indekset for det sidste element.
rindex0	Antallet af elementer, der er tilbage i løkken (længde - indeks), hvor 0 er indekset for det sidste element.

Bruger

Refererer til den aktuelle portalbruger og giver adgang til alle attributter i den underliggende kontaktpersonpost i Dataverse. Hvis ingen bruger er logget på, er denne variabel null.

User er et entity-objekt.

{% if user %}
 
Hello, {{ user.fullname | escape }}!
 
{% else %}
 
Hello, anonymous user!
 
{% endif %}

Bemærkning

Power Pages version 9.3.8.x eller nyere gennemtvinger escape-filteret Liquid som standard for bruger og anmoder om Liquid-objekter. Hvis du vil deaktivere denne standardkonfiguration og tillade disse Liquid-objekter uden escape-filteret Liquid, skal du se indstillinger for portalwebstedet – Site/EnableDefaultHtmlEncoding.

Egenskaber

Ud over at have alle attributterne for et entity-objekt har bruger følgende attributter.

Egenskab	Beskrivelse
Roller	Returnerer de roller, som brugeren er medlem af, som en matrix. {% if user.roles contains 'Administrators' %} User is an administrator. {% endif %} Bemærk: Du kan også bruge has_role-filteret til at teste for individuelle rollemedlemskaber.
basic_badges_url	Returnerer URL-tjenesten til at modtage en brugers badges. Du skal angive et mærke med attributterne "data-badge" og "data-uri" for at gengive badges for en bruger. Hvis du vil gengive den aktuelle brugers badges: <div data-badge data-uri='{{user.basic_badges_url }}'></div> Sådan gengives en brugers badges efter id (variabelt userid): '<div data-badge data-uri='{{user.basic_badges_url

weblinks

Gør det muligt at indlæse alle weblinks efter navn eller id.

Hvis weblinksættet findes, returneres et weblinksætobjekt. Hvis et weblinksæt med det angivne navn eller id ikke blev fundet, returneres null.

<!-- Load web link set by ID -->

{{ weblinks[page.adx_navigation.id].name }}

<!-- Load web link set by name -->

{% assign nav = weblinks[Primary Navigation] %}

{% if nav %}

<h1>{{ nav.title | escape }}</h1>

<ul>

{% for link in nav.weblinks %}

<li>

<a href={{ link.url | escape }} title={{ link.tooltip | escape }}>

{% if link.image %}

<img src={{ link.image.url | escape }} alt={{ link.image.alternate_text | escape }} />

{% endif %}

{{ link.name | escape }}

</a>

</li>

{% endfor %}

</ul>

{% endif %}

Bemærkning

Gengive et websteds sidehoved og primære navigationslinje |

Attributter for weblinksæt

Bemærkning

Et weblinksæt er et objekt af typen entity med alle de samme attributter foruden følgende attributter:

Egenskab	Beskrivelse
Kopiér	HTML-teksten i weblinksættet.
Name	Navnet på weblinksættet.
Stilling	Titlen på weblinksættet.
Weblinks	Den matrix af weblinkobjekter, der er tilknyttet weblinksættet.
[attribut logisk navn]	Du kan få adgang til en attribut i weblinksættets Dataverse-post efter logisk navn, F.eks. {{ weblinkset.createdon }}

Attributter for weblink

Bemærkning

Et weblink er et objekt af typen entity med alle de samme attributter foruden følgende attributter:

Egenskab	Beskrivelse
Beskrivelse	HTML-beskrivelsen af weblinket.
vis_kun_billede	Booleske attributter, der angiver, om weblinket skal vises som et billede uden linktekst.
display_page_child_links	Boolesk attribut, der angiver, om weblinket skal vise links til de underordnede sitemap-sider på den linkede side som underordnede hyperlinks.
Image	Weblinkets billedobjekt for dette link. Denne attribut er null, hvis der intet billede findes.
er_ekstern	Booleske attributter, der angiver, om URL-måladressen på weblinket er til et eksternt websted (i stedet for til en intern portalside).
is_sitemap_ancestor	Returnerer true, hvis weblinkets URL-adresse refererer til et overordnet element i den aktuelle webstedsoversigtsnode, og ellers false.
is_sitemap_current	Returnerer true, hvis weblinkets URL-adresse refererer til den aktuelle webstedsoversigtsnode, og ellers false.
Name	Navnet eller titlen på weblinket.
Nofollow	Booleske attributter, der angiver, om weblinket skal markeres som rel=nofollow.
åbn_i_nyt_vindue	Booleske attributter, der angiver, om weblinket skal åbnes i et nyt browservindue/en ny fane, når det vælges.
Værktøjstip	Værktøjstipteksten til weblinket.
url	URL-adressen for weblinket,
Weblinks	Den matrix af underordnede weblinkobjekter, der er tilknyttet weblinket.
[attribut logisk navn]	Du kan få adgang til enhver attribut i en weblink-Dataverse-post ved hjælp af det logiske navn. F.eks. {{ weblink.createdon }}

Attributter for weblinkbillede

alternativ_tekst	Alternativ tekst til billedet.
Height	Heltal, der indeholder den angivne højde af billedet. Hvis der ikke er angivet en værdi for højde, er denne attribut null.
url	URL-adressen til billedet.
Width	Heltal, der indeholder den angivne bredde af billedet. Hvis der ikke er angivet en værdi for bredde, er denne attribut null.

website

Henviser til portalwebstedet og giver adgang til alle attributter på Dataverse-webstedsposten (adx_website) for portalen.

Bemærkning

Webstedet er et objekt objekt med alle de samme attributter.

Kode

{{ website.adx_name }} ({{ website.id }})

output

Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)

Egenskaber

I følgende tabel vises attributterne for denne kode, der kan bruges til at erstatte standardværdierne for at undgå cachelagring.

Standard	Erstatning (undgår cachelagring)	Eksempel
sign_in_url	sign_in_url_substitution	Standard: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F Erstatning (undgår cachelagring): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("substitute-page" i dette eksempel erstatter den cachelagrede standard-URL-adresse).
sign_out_url	sign_out_url_substitution	Standard: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F Erstatning (undgår cachelagring): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("substitute-page" i dette eksempel erstatter den cachelagrede standard-URL-adresse).

Se også

Liquid-typer
Flydende mærker
Liquid-filtre