Tilgængelige Liquid-objekter
Bemærk
Fra 12. oktober 2022 bliver Power Apps-portaler til Power Pages. Flere oplysninger: Microsoft Power Pages er nu generelt tilgængelig (blog)
Vi overfører og fletter snart dokumentationen til Power Apps-portalerne med Power Pages-dokumentationen.
Liquid-objekter indeholder attributter til at producere dynamisk indhold til siden. For eksempel har sideobjektet har en attribut med navnet title, der kan bruges til at udskrive titlen på den aktuelle side.
Brug et punktum (.) til at få adgang til en objektattribut efter navn. For at gengive et objekts attribut i en skabelon skal du ombryde den i {{ and }}.
Vigtigt
Hvis du vil undgå problemer med scripter på tværs af websteder (XSS), skal du altid bruge escape-filteret til HTML-kodedata, når du bruger Liquid-objekter til at læse data, der ikke er tillid til, som brugeren har angivet.
{{ 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] }}
Følgende objekter kan bruges og bruges overalt i enhver skabelon.
| Objekt | Beskrivelse |
|---|---|
| entities | Gør det muligt at indlæse enhver Power Apps-tabel efter id. Flere oplysninger: -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: Datofiltre |
| side | Refererer til den aktuelle anmodningsside i portalen. 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 Power Apps-post. Flere oplysninger: -side |
| params | En nem genvej til request.params. Flere oplysninger: -anmodning |
| request | 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: webstedsoversigt |
| sitemarkers | Gør det muligt at indlæse webstedsmærker efter navn. Flere oplysninger: sitemarkers |
| 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 Power Apps. 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å Power Apps-webstedsposten (adx_website) for portalen. Flere oplysninger: websted |
ads
Giver mulighed for at få adgang til og gengive en reklame.
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
| Attribut | Beskrivelse |
|---|---|
| placements | Returnerer objektet adplacements. |
| [ad-navn eller -id] | Du kan få adgang til enhver reklame ud fra dens navn eller id-egenskaber. {% assign ad = ads[Ad Name] %}{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Attributter for reklameplaceringer
| Attribut | Beskrivelse |
|---|---|
| [ad placement-navn eller -id] | Du kan få adgang til en adplacement ud fra dets navn eller id-egenskaber.{% assign placement = ads.placements[Placement Name or Id] %}{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %} |
Attributter for reklameplacering
En reklameplacering er et tabelobjekt med de samme generelle attributter og de attributter, der er angivet nedenfor.
| Attribut | Beskrivelse |
|---|---|
| Reklamer | Returnerer samlingen af reklameobjekter, der er knyttet til placeringen. Gentagelsesmærker og Matrixfiltre kan bruges sammen med denne samling. |
| Name | Returnerer feltet Navn for reklameplaceringen. |
| placement_url | Den URL-adresse, der kan bruges til at hente reklameplaceringen fuldt gengivet af en skabelon. |
| random_url | Den URL-adresse, der kan bruges til at hente en vilkårlig reklame fra placeringen, der er fuldt gengivet af en skabelon. |
Attributter for reklame
Bemærk
En reklame er et tabelobjekt med de samme attributter samt dem, der er angivet nedenfor.
| Attribut | Beskrivelse |
|---|---|
| ad_url | Den URL-adresse, der kan bruges til at hente reklamen fuldt gengivet af en skabelon. |
| Kopier | Returnerer feltet Kopiér for reklamen. |
| image | Returnerer billedobjektet (hvis relevant) for reklamen. |
| Navn | Returnerer feltet Navn for reklamen. |
| open_in_new_window | Returnerer true, hvis den URL-adresse, der er angivet af redirect_url, skal åbnes i et nyt vindue. |
| redirect_url | Den URL-adresse, som brugeren videresendes til ved at vælge reklamen. |
Attributter for reklamebillede
| Attribut | Beskrivelse |
|---|---|
| alternate_text | Returnerer den tekst, der skal vises i mærkets alt-attribut. |
| height | Returnerer højden i pixel på billedet |
| url | Returnerer URL-adressen på kilden til billedet. |
| width | Returnerer bredden i pixel på billedet |
blogs
Giver mulighed for at få adgang til og gengive Blogs og Blogopslag.
Med blogs-objektet kan du vælge en bestemt blog eller blogopslag.
{% 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>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<a href={{ post.application_path }}#comments>
<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}
</a>
</div>
</li>
{% endfor %}
</ul>
</div>
Objektet blogs
Objektet blogs giver dig adgang til en bestemt blog på portalen eller til alle blogopslag på portalen.
I følgende tabel beskrives de attributter, der er knyttet til blogs-objektet.
| Attribut | Beskrivelse |
|---|---|
| posts | Returnerer et blogposts-objekt, der indeholder alle blogopslag på portalen. |
| [blog-navn eller -id] | Du kan få adgang til enhver blog ud fra dens navn eller id-egenskaber. |
{% assign blog = blogs["Blog Name"] %}
{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Objektet blog
Objektet blog gør det muligt at arbejde med en enkelt blog, så du kan få adgang til opslagene for denne blog.
I følgende tabel beskrives de forskellige attributter, der er knyttet til blog-objektet.
| Attribut | Beskrivelse |
|---|---|
| posts | Returnerer et blogposts-objekt, der indeholder alle blogopslag for bloggen. |
| Name | Navnet på bloggen. |
| title | Titlen på bloggen. |
| url | URL-adressen til bloggen. |
Objektet blogposts
Objektet blogposts giver dig adgang til en samling af blogopslagsobjekter. Du kan bestille blogopslagene og gennemføre sideinddeling ud over at bruge Liquid-filtre:
{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}
Andre mulige indstillinger:
blogs.posts.all(for at hente alle blogindlæg)blogs.posts | from\_index: 0 | take: 2
I følgende tabel beskrives de forskellige attributter, der er knyttet til blogposts-objektet.
| Attribut | Beskrivelse |
|---|---|
| All | Returnerer alle blogpost-objekter i samlingen. |
Objektet blogposts
Refererer til et enkelt blogopslag.
I følgende tabel beskrives de forskellige attributter, der er knyttet til blogpost-objektet.
| Attribut | Beskrivelse |
|---|---|
| url-adresse | Opslagets URL-adresse. |
| indhold | Returnerer feltet Indhold for opslaget. |
| author | Returnerer forfattere til opslaget (som blot er et objekt af typen kontakttabel). |
| titel | Titlen på opslaget. |
| comment_count | Returnerer heltalsværdien for optællingen af, hvor mange kommentarer der er for et givet opslag. |
| publish_date | Den dato, hvor opslaget blev publiceret. |
entities
Forsigtigt
Hvis du vil undgå problemer med scripter på tværs af websteder (XSS), skal du altid bruge escape-filteret til at HTML-kode strengdata, hver gang du bruger objekterne Liquid-objekt til at læse data fra den bruger, der ikke er tillid til.
Bemærk
Nogle af navngivningskonventionerne for Dataverse er ændret, f.eks. hedder Dataverse-objekter nu tabeller. Navneændringerne gælder ikke for Liquid-objekter. Liquid-objekterne til fortsat omtales som objekter.
Gør det muligt at indlæse enhver Power Apps-tabel efter id. Hvis tabellen findes, returneres der et tabelobjekt. Hvis en tabel med det angivne id ikke blev fundet, 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 %}
Enhed
Et enhedsobjekt giver adgang til attributterne for en tabelpost i Power Apps.
| Attribut | Beskrivelse |
|---|---|
| Id | GUID-id'et for en tabel som en streng. F.eks. 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | Det logiske Power Apps-navn på tabellen. |
| Noter | 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-adresse | Returnerer URL-stien til indholdsstyringssystemet på Power Apps-portaler 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. |
| [navn på attribut eller relation] | Du kan få adgang til en attribut i Power Apps-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:
{{ 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.
| Attribut | Beskrivelse |
|---|---|
| Id | GUID-id'et for en tabel, der refereres til, som en streng. F.eks. 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | Det logiske navn i Power Apps på den tabel, der refereres til. |
| Navn | Den primære navneattribut for referencetabellen. |
Bemærk!
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 yderligere attributter.
| Attribut | Beskrivelse |
|---|---|
| documentbody | 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ærk
Værdi for grupperet indstilling
Attributværdier for grupperet indstilling/valglister returneres som tilknyttede tabelreferenceobjekter med følgende attributter.
| Attribut | 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.
| Attribut | Beskrivelse |
|---|---|
| can_append | Returnerer true, hvis den aktuelle bruger har tilladelse til at føje poster til relationer for denne post. Ellers returneres 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 returneres false. |
| can_create | Returnerer true, hvis den aktuelle bruger har tilladelse til at oprette nye poster for denne tabeltype. Ellers returneres false. |
| can_delete | Returnerer true, hvis den aktuelle bruger har tilladelse til at slette denne post. Ellers returneres false. |
| can_read | Returnerer true, hvis den aktuelle bruger har tilladelse til at læse denne post. Ellers returneres false. |
| can_write | Returnerer true, hvis den aktuelle bruger har tilladelse til at opdatere denne post. Ellers returneres false. |
| rules_exist | 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øg på at indlæse refleksive relationer (dvs. relationer, der refererer til sig selv) i objekter returneres som objekter med følgende attributter.
| Attribut | Beskrivelse |
|---|---|
| is_reflexive | Returnerer true. Kan bruges til at afprøve, om et objekt, der returneres af en relation, er et refleksivt relationsobjekt. |
| referenced | Returnerer en matrix af refererede objekter for den angivne relation. |
| referencing | Returnerer en referencetabel for den angivne relation. Returnerer null, hvis der ikke findes en tabel, der refereres til. Hvis forholdet er mange-til-mange (N:N), returneres en matrix af referenceobjekter. |
entitylist
Objektlisteobjektet bruges i Power Apps Dataverse-tabelmærkerne. Det giver adgang til alle attributterne for en bestemt liste.
Attributter
Bemærk
| Attribut | Beskrivelse |
|---|---|
| create_enabled | Returnerer true, hvis oprettelse af nye poster er konfigureret til listen. Ellers returneres false. |
| create_url | Returnerer den konfigurerede URL-adresse for et oprettelseslink/-knap til listen. |
| detail_enabled | Returnerer true, hvis en detaljeret visning til de enkelte poster er konfigureret for listen. Ellers returneres false. |
| detail_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 |
| detail_label | Returnerer den konfigurerede lokaliserede etiket for detaljevisningslinks/-knapper til listen. |
| detail_url | Returnerer den konfigurerede URL-adresse for detaljevisningslinks/-knapper til listen. |
| empty_list_text | Returnerer den konfigurerede oversatte tekst, der skal vises, når listevisningen ikke returnerer nogen resultater. |
| enable_entity_permissions | Returnerer true, hvis filtrering af tabeltilladelser er aktiveret for denne liste. Ellers returneres false. |
| entity_logical_name | Returnerer Power Apps-tabellens logiske navn for poster, der skal vises af denne liste. For eksempel contact |
| filter_account_attribute_name | Returnerer det logiske attributnavnet for det opslag i account, der skal bruges til at filtrere resultatposter efter den aktuelle portalbrugers overordnede firma, For eksempel accountid |
| filter_apply_label | Returnerer den konfigurerede oversatte etiket, der skal bruges til linket/knappen, der anvender et avanceret attributfilter på listens resultater. |
| 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_enabled | Returnerer true, hvis avanceret attributfiltrering er aktiveret for listen. Ellers returneres false. |
| filter_portal_user_attribute_name | Returnerer det logiske attributnavnet for det opslag i contact, 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 Power Apps-sprogkode i heltal, der skal bruges til at vælge alle oversatte etiketter for denne liste. |
| page_size | Returnerer størrelsen på den konfigurerede resultatside for listen. |
| primary_key_name | Returnerer den primær nøgleattributs logiske navn for poster, der skal vises af denne liste. |
| search_enabled | Returnerer true, hvis søgning er aktiveret for denne liste. Ellers returneres false. |
| search_placeholder | Returnerer den konfigurerede oversatte tekst til listens søgefeltpladsholder. |
| search_tooltip | Returnerer den konfigurerede oversatte tekst til listens søgeværktøjstip. |
| visninger | Returnerer de tilgængelige visninger for listen som visningsobjekter for listen. |
| [logisk navn for attribut] | Du kan få adgang til en hvilken som helst attribut i listens (adx_entitylist) Power Apps-post efter logisk navn på samme måde som et table-objekt. For eksempel {{ entitylist.adx_name }} |
Attributter for listevisning
| Attribut | Beskrivelse |
|---|---|
| kolonner | Returnerer kolonnerne i visningen som listevisningens kolonneobjekter. |
| entity_logical_name | Returnerer Power Apps-tabellens logiske navn for de poster, der er medtaget i visningen. For eksempel contact |
| Id | Returnerer visningens GUID-id. |
| language_code | Returnerer den Power Apps-sprogkode i heltal, der skal bruges til at vælge alle oversatte etiketter (kolonneoverskrifter osv.) til visningen. |
| Name | Returnerer det viste Power Apps-navn for visningen. |
| primary_key_logical_name | Returnerer det logiske navn for Power Apps-tabellens primære nøgle for de poster, der er medtaget i visningen, For eksempel contactid |
| sort_expression | Returnerer standardsorteringsudtrykket for visningen. For eksempel name ASC, createdon DESC. |
Attributter for kolonner i listevisning
| Attribut | Beskrivelse |
|---|---|
| attribute_type | Returnerer Power Apps-attributtens typenavn for kolonnen som en streng, For eksempel opslag, valgliste, streng, boolesk værdi, DateTime |
| logical_name | Returnerer Power Apps-attributtens logiske navn for kolonnen, For eksempel createdon |
| Navn | Returnerer det oversatte viste Power Apps-navn for kolonnen, For eksempel Oprettet |
| sort_ascending | Returnerer en sorteringsstreng til sortering af kolonnen i stigende rækkefølge. For eksempel createdon ASC |
| sort_descending | Returnerer en sorteringsstreng til sortering af kolonnen i faldende rækkefølge. For eksempel createdon DESC |
| sort_disabled | Returnerer true, hvis sortering er deaktiveret for kolonnen. Ellers returneres false. |
| sort_enabled | Returnerer true, hvis sortering er aktiveret for kolonnen. Ellers returneres false. |
| bredde | Returnerer den konfigurerede bredde for kolonnen i pixel. |
entityview
Objektet entityview bruges i entityview-mærket og giver adgang til metadataene for visningen ud over at visning af resultatposter.
Attributter
| Attribut | Beskrivelse |
|---|---|
| kolonner | Returnerer kolonnerne i visningen som tabelvisning for kolonneobjekter. |
| entity_permission_denied | 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 Power Apps-tabellen i visningsresultatposter. For eksempel contact |
| first_page | Sidetallet på den første side i visningsresultater. Det er 1, medmindre der blev ikke returneret nogen resultater, og så er det null. |
| Id | GUID-id'et for den Power Apps-visning, der definerer denne entityview. |
| language_code | Sprogkoden for det Power Apps-heltal, der bruges til at indlæse oversatte etiketter for den aktuelle visning. |
| last_page | Sidetallet på den sidste side i visningsresultater. Hvis der blev ikke returneret nogen resultater, er dette null. |
| name | Navnet på den Power Apps-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 dette null. |
| Page | 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. |
| primary_key_logical_name | Det logiske navn i Power Apps på den primære nøgleattribut for resultattabellen for denne visning. For eksempel contactid. |
| poster | Den aktuelle side i resultatposten for visningen, som tabelobjekter. |
| sort_expression | Standardsorteringsudtrykket for visningen. For eksempel nameASC, createdon DESC. |
| total_pages | Det samlede antal sider med resultater for visningen. |
| total_records | Det samlede antal resultater for visningen (på tværs af alle sider). |
events
Giver mulighed for at få adgang til og gengive hændelser. Med objektet events kan du vælge en bestemt hændelse eller alle hændelser.
Objektet events
Objektet events giver dig adgang til en bestemt hændelse på portalen eller til alle hændelser på portalen (uanset hændelsen).
Objektet events har følgende attributter:
| Attribut | Beskrivelse |
|---|---|
| occurences | Returnerer et eventoccurrences-objekt, der indeholder alle hændelsesforekomster på portalen |
| [hændelsesnavn eller -id] | Du kan få adgang til enhver hændelse ud fra dens navn eller id-egenskaber. {% assign event = events["Hændelsesnavn"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Objektet event
Objektet event gør det muligt at arbejde med en enkelt hændelse, så du kan få adgang til tidsplaner og forekomster for hændelsen.
Objektet event har følgende attributter:
| Attribut | 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] %}
Bemærk, at
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
også er muligt.
Følgende attributter er knyttet til eventoccurrences-objekt
| Attribut | Beskrivelse |
|---|---|
| All | Returnerer alle eventoccurrence-objekter i samlingen. |
Objektet eventoccurrence
Repræsenterer en enkelt hændelsesforekomst. Nedenfor angives de tilknyttede attributter:
| Attribut | Beskrivelse |
|---|---|
| URL-adresse | URL-adressen til forekomsten. |
| is_all_day_event | Er dette en hændelse, der varer hele dagen? |
| start_time | Starttidspunktet for hændelsen. |
| end_time | Sluttidspunktet for hændelsen. |
forloop
Indeholder egenskaber, der er nyttige i en for-løkkeblok.
Bemærk
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 %}
Resultat
This is the first child page!
This is child page number 2.
This is child page number 3.
Attributter
| Attribut | 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. |
| index | 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. |
| Last | Returnerer true, hvis det er den sidste gentagelse af løkken. Returnerer false, hvis det ikke er den sidste gentagelse. |
| length | Returnerer antallet af gentagelser for løkken ߝ, som antallet af elementer i samlingen gentages 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
Giver mulighed for at få adgang til og gengive forummer og forumtråde. Muligheden for at bruge Liquid til at gengive forumdata omfatter også opslag, men hvis du vil oprette et ny opslag eller en ny tråd, skal du bruge en sideskabelon for ASP.NET-formularer med flere trin med de nævnte funktioner indbygget (som standard f.eks. sideskabeloner for forumtråde og forumopslag).
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>
forumobjekt
Objektet forums giver dig adgang til et bestemt forum på portalen eller til alle forumtråde på portalen (uanset forummet).
Objektet forum gør det muligt at arbejde med et enkelt forum, så du kan få adgang til trådene for dette forum.
Objektet forumthreads giver dig adgang til en samling af forumthread-objekter. Du kan bestille forumtråde og gennemføre sideinddeling samt ved hjælp af Liquid-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.
Attributter
| Attribut | Beskrivelse |
|---|---|
| threads | Returnerer et forumthreads-objekt, der indeholder alle forumthread-objekter på portalen. |
| All | 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. |
| post_count | Returnerer heltalsværdien af det samlede antal opslag på portalen. |
| [forumnavn eller -id] | Du kan få adgang til ethvert forum ud fra dets navn eller id-egenskaber. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %} |
Objektet forum
Attributter
Bemærk
| Attribut | Description |
|---|---|
| threads | 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. |
| post_count | Returnerer heltalsværdien af en optælling af, hvor mange opslag i alt der er på hele forummet. |
Objektet forumthreads
Attributter
| Attribut | Beskrivelse |
|---|---|
| Alle | Returnerer alle forumthread-objekter i samlingen. |
Objektet forumthread
Attributter
Bemærk
| Attribut | Beskrivelse |
|---|---|
| posts | Returnerer et forumposts-objekt, der indeholder alle forumopslag for tråden. |
| author | Returnerer forfatteren til tråden (som blot er et objekt af typen kontakttabel). |
| latest_post | Returnerer det nyeste opslag i tråden. |
| first_post | Returnerer det første opslag i tråden. |
| post_count | Returnerer heltalsværdien af en optælling af, hvor mange opslag der er på tråden. |
| is_answered | Er tråden besvaret eller ej? |
| is_sticky | Er tråden selvklæbende? |
Objektet forumposts
Attributter
| Attribut | Beskrivelse |
|---|---|
| Alle | Returnerer alle forumthread-objekter i samlingen. |
Et enkelt forumopslag
Attributter
Bemærk
| Attribut | Beskrivelse |
|---|---|
| author | Returnerer forfatteren til opslaget (som blot er et objekt af typen kontakttabel). |
| content | Opslagets indhold. |
| is_answer | Er dette opslag et svar til tråden? |
knowledge
Giver adgang til tabelposter af typen knowledgearticle og category i Power Apps til gengivelse af artikler og kategorier i en portal.
Attributter
| Attribut | Beskrivelse |
|---|---|
| articles | Returnerer et articles-objekt, der indeholder artikelobjekter for de tabelposter af typen videnbaseartikel, der er tilgængelige på portalen. |
| categories | 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 %}
Attributter
| Attribut | Beskrivelse |
|---|---|
| popular | Returnerer den samling article-objekter, der indeholder de fleste visninger. {% assign popular_articles = knowledge.articles.popular %} |
| recent | 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 %}
| Attribut | Beskrivelse |
|---|---|
| popular | Returnerer den samling article-objekter, der indeholder de fleste visninger. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %} |
| recent | 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 %} |
Objektet categories
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 %}
Attributter
| Attribut | Beskrivelse |
|---|---|
| recent | Returnerer den samling kategoriobjekter, der indeholder den seneste ændrede dato. |
| top_level | 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 %}
| Attribut | Beskrivelse |
|---|---|
| recent | Returnerer den samling kategoriobjekter, der indeholder den seneste ændrede dato. Du kan angive parametre {% assign recent_categories = knowledge.categories \| recent: 10 %} |
| top_level | 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.
Attributter
article er et objekt af typen entity med de samme attributter som dem, der er angivet nedenfor.
| Attribut | Beskrivelse |
|---|---|
| article_public_number | Det offentlige artikelnummer for artiklen. |
| comment_count | Heltalsværdien for optællingen af, hvor mange kommentarer der er for en given artikel. |
| content | Indholdet af artiklen. |
| current_user_can_comment | Returnerer en boolesk værdi, der angiver, om den aktuelle bruger kan indsætte kommentarer til artiklen. |
| is_rating_enabled | 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. |
| rating | Artiklens decimalklassificeringsværdi. |
| title | Titlen på artiklen. |
| view_count | Heltalsværdien for det antal gange, artiklen er blevet vist. |
Objektet category
Objektet category giver dig mulighed at arbejde med en enkelt kategori for at vise dens detaljer på portalen.
Attributter
category er et objekt af typen entity med de samme attributter som dem, der er angivet nedenfor.
| Attribut | Beskrivelse |
|---|---|
| categorynumber | 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.
Attributter
| Attribut | Beskrivelse |
|---|---|
| url-adresse | 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, som springer sideoutputcachen over. |
| navn | 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.
side
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 Power Apps-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ærk
| Attribut | Beskrivelse |
|---|---|
| breadcrumbs | Returnerer brødkrummenodeobjekter for oversigt over websted for siden, og starter fra rodnoden i webstedsoversigten og slutter ved den overordnede node. |
| children | Returnerer de underordnede nodeobjekter i webstedsoversigten for siden. |
| parent | Returnerer den overordnede node i webstedsoversigten for siden. Hvis siden er startsiden, er parent null. |
| title | Titlen på siden. |
| url | ULR-adressen for siden. |
| [navn på attribut eller relation] | Du kan få adgang til en attribut for sidens underliggende Power Apps-post efter logisk 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:
{{ 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 Power Apps Dataverse-tabelmærker til at indlæse samlinger af objekter. |
polls
Giver mulighed for at få adgang til og gengive 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
| Attribut | Beskrivelse |
|---|---|
| placements | Returnerer objektet pollplacements. |
| [afstemningsnavn eller -id] | Du kan få adgang til en afstemning ud fra dens navn eller id-egenskaber. {% assign poll = polls[Poll Name] %}{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %} |
Attributter for afstemningssteder
| Attribut | Beskrivelse |
|---|---|
| [navn eller id for afstemningssted] | Du kan få adgang til et afstemningssted ud fra dets navn eller id-egenskaber.{% assign placement = polls.placements[Placement Name or Id] %}{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %} |
Attributter for afstemningssted
Bemærk
| Attribut | Beskrivelse |
|---|---|
| Name | Returnerer feltet Navn for afstemningsstedet. |
| placement_url | Den URL-adresse, der kan bruges til at hente afstemningsstedet fuldt gengivet af en skabelon. |
| polls | Returnerer samlingen af afstemningsobjekter, der er knyttet til stedet. Gentagelsesmærker og Matrixfiltre kan bruges sammen med denne samling. |
| random_url | Den URL-adresse, der kan bruges til at hente en vilkårlig afstemning fra stedet, der er fuldt gengivet af en skabelon. |
| submit_url | Den URL-adresse, som en fuldført afstemning sendes til. |
Afstemningsattributter
Bemærk
| Attribut | Beskrivelse |
|---|---|
| has_user_voted | Returnerer true, hvis den aktuelle bruger (logget ind eller anonym) allerede har stemt ved denne afstemning. |
| Navn | Returnerer feltet Navn for afstemningen. |
| options | Returnerer samlingen af poll option-objekter, der er knyttet til afstemningen. Gentagelsesmærker og entities kan bruges sammen med denne samling. |
| poll_url | Den URL-adresse, der kan bruges til at hente afstemningen fuldt gengivet af en skabelon. |
| question | Returnerer feltet Spørgsmål for afstemningen. |
| submit_button_label | 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. |
| user_selected_option | Returnerer objektet polloption, der er valgt af brugeren (hvis de har allerede stemt). |
| votes | Returnerer antallet af stemmer, der har været i tabelformat ved afstemningen. |
Attributter for afstemningsmulighed
Bemærk
| Attribut | Beskrivelse |
|---|---|
| answer | Returnerer feltet Svar for afstemningen. |
| percentage | Returnerer procentdelen af stemmer i afstemningen for valgmuligheden som et decimaltal fra 0 til 100. |
| votes | Returnerer antallet af stemmer, der har været i tabelformat for valgmuligheden. |
request
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ærk
- 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 Apps-portaludgivelse version 9.3.8.x eller nyere gennemtvinges som standard af escape Liquid-filteret af den udløsende kraft for objekter afgivet af bruger og anmodning om Liquid-objekter. Hvis du vil deaktivere denne standardkonfiguration og tillade, at disse styringsobjekter slippes fra filteret, skal du se webstedsindstillinger for portal - Websted/EnableDefaultHtmlEncoding.
Attributter
| Attribut | Beskrivelse |
|---|---|
| params | Navngivne parameterværdier for den aktuelle anmodning. params er en kombination af URL-forespørgselsstrengparametre, formularopslagsparametre og cookies. |
| Path | 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 |
| query | Forespørgselsdelen af den aktuelle URL-adresse til anmodningen. ?foo=1&bar=something |
| URL-adresse | Den fuldstændige URL-adresse til den aktuelle anmodning. https://www.example.com/profile/?foo=1&bar=something |
searchindex
Objektet searchindex bruges i Power Apps Dataverse-objektmærker 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 %}
Attributter
| Attribut | 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. |
| Page | 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. |
| results | Returnerer forespørgslens resultatside som resultatobjekter for søgeindekset. |
Søgeindeksresultater
| Attribut | Beskrivelse |
|---|---|
| entity | De underliggende entities 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 | Power Apps-tabellens id for den underliggende post for resultatet, som en streng, F.eks. 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logical_name | Power Apps-tabellens logiske navn for den underliggende post for resultatet, For eksempel 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. |
| score | Lucene-scoren af resultatet, som en flydende værdi. Resultaterne bliver returneret i rækkefølge efter denne værdi. |
| title | Titlen på resultatet. |
| URL-adresse | URL-adressen for resultatet. Dette vil som regel – men ikke nødvendigvis – være en absolut sti til det aktuelle program i stedet for en fuldstændig URL-adresse. For eksempel: /articles/article1/ |
indstillinger
Gør det muligt at indlæse en webstedsindstilling efter navn. Hvis en indstilling med det angivne navn ikke blev fundet, returneres null.
Bemærk
Indstillinger returneres som strenge, men du kan bruge Type-filtre 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 %}
sitemap
Giver 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 %}
Attributter for oversigt over websted
| Attribut | Beskrivelse |
|---|---|
| Current | Returnerer nodeobjektet for oversigten over webstedet for den aktuelle side. |
| Root | Returnerer nodeobjektet for oversigten over webstedet for rodsiden (startsiden) på webstedet. |
Nodeattributter for oversigt over websted
| Attribut | Beskrivelse |
|---|---|
| Breadcrumbs | 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. |
| Description | Beskrivelse/resume af indholdet af noden. (Feltet kan indeholde HTML). |
| Entity | Returnerer de underliggende entities for noden. Hvis noden ikke har en underliggende tabel, bliver 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 den overordnede node i webstedsoversigten for noden. Hvis noden er rodnoden, bliver parent null. |
| Title | 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 %}
Sitemarker-attributter
| Attribut | Beskrivelse |
|---|---|
| url | URL-adressen på sitemarker-målet. |
| [logisk navn for attribut] | Du kan få adgang til en attribut for sitemarker-målets Power Apps-post efter logisk navn, For eksempel, {{ 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ærk
tablerowloop kan kun bruges i et mærke af typen Gentagelsesmærker.
Attributter
| Attribut | 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. |
| col_last | 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. |
| Index | 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. |
| Last | Returnerer true, hvis det er den sidste gentagelse af løkken. Returnerer false, hvis det ikke er den sidste gentagelse. |
| Length | Returnerer antallet af gentagelser for løkken ߝ, som antallet af elementer i samlingen gentages 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. |
user
Refererer til den aktuelle portalbruger og giver adgang til alle attributter i den underliggende kontaktpersonpost i Power Apps. Hvis ingen bruger er logget på, er denne variabel null.
brugeren er et entity-objekt.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
Bemærk
Power Apps-portaludgivelse version 9.3.8.x eller nyere gennemtvinges som standard af escape Liquid-filteret af den udløsende kraft for objekter afgivet af bruger og anmodning om Liquid-objekter. Hvis du vil deaktivere denne standardkonfiguration og tillade, at disse styringsobjekter slippes fra filteret, skal du se webstedsindstillinger for portal - Websted/EnableDefaultHtmlEncoding.
Attributter
Ud over at have alle attributterne for et entity-objekt har bruger følgende attributter.
| Attribut | 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>Hvis du vil gengive en brugers badges efter id (variabel 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 %}
Attributter for weblinksæt
Bemærk
Et weblinksæt er et objekt af typen entity med alle de samme attributter som dem, der er angivet nedenfor.
| Attribut | Beskrivelse |
|---|---|
| Kopi | HTML-teksten i weblinksættet. |
| Name | Navnet på weblinksættet. |
| Title | Titlen på weblinksættet. |
| Weblinks | Den matrix af weblinkobjekter, der er tilknyttet weblinksættet. |
| [logisk navn for attribut] | Du kan få adgang til en attribut i weblinksættets Power Apps-post efter logisk navn, F.eks. {{ weblinkset.createdon }} |
Attributter for weblink
Bemærk
Et weblink er et objekt af typen entity med alle de samme attributter foruden dem, der er angivet nedenfor.
| Attribut | Beskrivelse |
|---|---|
| Beskrivelse | HTML-beskrivelsen af weblinket. |
| display_image_only | 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. |
| is_external | 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. |
| Navn | Navnet eller titlen på weblinket. |
| Nofollow | Booleske attributter, der angiver, om weblinket skal markeres som rel=nofollow. |
| open_in_new_window | 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-adresse | URL-adressen for weblinket, |
| Weblinks | Den matrix af underordnede weblinkobjekter, der er tilknyttet weblinket. |
| [logisk navn for attribut] | Du kan få adgang til en attribut i weblinkets Power Apps-post efter logisk navn, F.eks. {{ weblink.createdon }} |
Attributter for weblinkbillede
| alternate_text | 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å Power Apps-webstedsposten (adx_website) for portalen.
Bemærk
Webstedet er et objekt objekt med alle de samme attributter.
Kode
{{ website.adx_name }} ({{ website.id }})
Output
Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)
Attributter
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
Liquid-mærker
Liquid-filtre
Bemærk
Kan du fortælle os om dine sprogpræferencer for dokumentation? Tag en kort undersøgelse. (bemærk, at denne undersøgelse er på engelsk)
Undersøgelsen tager ca. syv minutter. Der indsamles ingen personlige data (erklæring om beskyttelse af personlige oplysninger).
Feedback
Kommer snart: I hele 2024 udfaser vi GitHub-problemer som feedbackmekanisme for indhold og erstatter det med et nyt feedbacksystem. Du kan få flere oplysninger under: https://aka.ms/ContentUserFeedback.
Indsend og få vist feedback om