Tillgängliga Liquid-objekt
Anteckning
Från och med den 12 oktober 2022 byter Power Apps-portaler namn till Power Pages. Mer information: Microsoft Power Pages är nu allmänt tillgänglig (blogg)
Vi kommer snart migrera och sammanfoga dokumentationen för Power Apps-portaler med Power Pages-dokumentationen.
Preliminär objekt innehåller attribut om du vill spara dynamiskt innehåll på sidan. Sidobjektet har exempelvis ett attribut som kallas "rubrik" (title) som kan användas för att visa rubriken för den aktuella sidan.
Använd ett objektattribut efter namn, använd en punkt (.). Om du vill återge ett objekts attribut i en mall omsluter du attributet i {{ and }}.
Viktigt
Använd alltid för att undvika potentiella Cross Site Scripting (XSS) problem, använd alltid escape filter till HTML-kodning av data när du använder Liquid-objekt för att läsa otillförlitlig data från användaren.
{{ page.title }}
Attribut för ett objekt kan också användas med ett strängnamn och []. Detta format är användbart när det önskade attributet bestäms dynamiskt eller attributets namn innehåller tecken, blanksteg, specialtecken o.s.v. som skulle vara ogiltiga om du använder en punkt (.) inne i syntaxen.
{{ page[title] }}
{% assign attribute_name = Name with spaces %}
{{ object[attribute_name] }}
Följande objekt kan användas och kommas åt var som helst, i alla mallar.
| Objekt | Beskrivning |
|---|---|
| entiteter | Låter dig läsa in valfri Power Apps-tabellen efter ID. Mer information: entiteter |
| nu | Ett datum/tid-objekt som refererar till den aktuella UTC-tiden när mallen återges. Obs! Det här värdet är cachelagrat av portalens webbapp och uppdateras inte varje gång. Mer information: Datumfilter |
| sida | Refererar till den aktuella portalbegäransidan. Sidobjektet ger tillgång till exempelvis spåren för den aktuella sidan, rubrik eller URL för den aktuella sidan, samt andra attribut och entiteter relaterade till underliggande Power Apps-post. Mer information: sida |
| parametrar | En praktiskt genväg för request.params. Mer information: begäran |
| begäran | Innehåller information om den aktuella HTTP-posten. Mer information: begäran |
| inställningar | Låter dig läsa in alla webbplatsinställningar efter namn. Mer information: inställningar |
| webbkarta | Tillåter åtkomst till portalwebbplatsen. Mer information: webbplatsöversikt |
| webbplatsmarkörer | Låter dig läsa in alla webbplatsmarkörer efter namn. Mer information: webbplatsmarkörer |
| kodavsnitt | Låter dig läsa in alla innehållskodavsnitt efter namn. Mer information: kodavsnitt |
| användare | Refererar till den aktuella portalanvändaren, tillåter åtkomst till alla attribut för den underliggande Power Apps-kontaktposten. Om ingen användare är inloggad, den här variabeln kommer att vara noll. Mer information: användare |
| webblänkar | Låter dig läsa in alla Webblänksuppsättning efter namn och ID. Mer information: webblänkar |
| webbplats | Avser portalens webbplatspost, som ger åtkomst till alla attribut på Power Apps-webbplatsens (adx_website) post för portalen. Mer information: webbplats |
annonser
Ger dig möjlighet att komma åt och återge en annons.
Annonsobjektet låter dig markera en viss annons eller annonsplaceringen:
<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>
Annonsattribut
| Attribut | Beskrivning |
|---|---|
| placeringar | Returnerar annonsplaceringsobjekt. |
| [annonsnamn eller -ID] | Du kan komma åt annonser genom dess namn eller Id-egenskaper. {% assign ad = ads[Ad Name] %}{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Annonsplaceringsattribut
| Attribut | Beskrivning |
|---|---|
| [annonsplaceringsnamn eller -ID] | Du kan komma åt alla annonsplaceringar genom dess namn eller Id-egenskaper.{% assign placement = ads.placements[Placement Name or Id] %}{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %} |
Annonsplaceringsattribut
En annonsplacering är ett tabellobjekt med samma allmänna attribut och de attribut som visas nedan.
| Attribut | Beskrivning |
|---|---|
| Annonser | Returnerar samlingen med annonsobjekt som är associerade med placeringen. upprepningstaggar och matrisfilter kan användas för den här samlingen. |
| Namn | Returnerar namnfältet för annonsplacering. |
| placering_url | Den URL som kan användas för att hämta annonsplacering återges helt av en mall. |
| slumpmässig_url | Den URL som kan användas för att hämta en slumpannons från placering återges helt av en mall. |
Annonsattribut
Anteckning
En annons är ett tabellobjekt med samma attribut förutom dem som anges nedan.
| Attribut | Beskrivning |
|---|---|
| annons_url | Den URL som kan användas för att hämta annonsen återges helt av en mall. |
| Kopiera | Returnerar fältet Kopiera för annonsen. |
| bild | Returnerar bildobjektet (om några) för annonsen. |
| Namn | Returnerar fältet Namn för annonsen. |
| öppna_i_nytt_fönster | Returnerar "sant" (sant) om den URL som angavs av URL:en omdirigera_ ska öppnas i ett nytt fönster. |
| omdirigera_url | Den URL som användaren omdirigeras till genom att välja annonsen. |
Annonsbildattribut
| Attribut | Beskrivning |
|---|---|
| alternativ_text | Returnerar den text som ska visas i taggens alt-attribut. |
| height | Returnerar höjden i bildpunkter för bilden |
| URL | Returnerar bildens URL-källa. |
| width | Returnerar bredden i bildpunkter för bilden |
bloggar
Ger dig möjlighet att komma åt och återge bloggar och blogginlägg.
Blogg-objektet låter dig markera en viss blogg eller ett visst blogginlägg.
{% 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>
bloggobjekt
Bloggobjekt låter dig komma åt alla specifika bloggar på portalen eller om du vill komma åt alla blogginlägg i portalen.
I följande tabell beskrivs de attribut som associeras med bloggobjektet.
| Attribut | Beskrivning |
|---|---|
| poster | Returnerar ett -loggpostobjekt som innehåller alla blogginlägg i portalen. |
| [bloggnamn eller -ID] | Du kan få åtkomst till valfri blogg genom dess namn eller Id-egenskaper. |
{% assign blog = blogs["Blog Name"] %}
{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
bloggobjekt
Bloggobjektet låter dig arbeta med en enda blogg, så att du kan komma åt inläggen för den bloggen.
I följande tabell beskrivs de olika attribut som associeras med bloggobjekt.
| Attribut | Beskrivning |
|---|---|
| poster | Returnerar ett blogginläggsobjekt som innehåller alla blogginlägg i bloggen. |
| Namn | Bloggens namn. |
| title | Bloggens titel. |
| URL | Bloggens URL |
blogginläggsobjekt
Blogginläggobjekt låter dig komma åt en samling med blogginläggobjekt. Du kan beställa blogginlägg och få sidnumrering samt även använda flytande filter:
{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}
Andra möjliga alternativ:
blogs.posts.all(för att få alla blogginlägg)blogs.posts | from\_index: 0 | take: 2
I följande tabell beskrivs de olika attribut som associeras med blogginläggsobjekt.
| Attribut | Beskrivning |
|---|---|
| Alla | Returnerar alla blogginläggsobjekt i samlingen |
blogginläggsobjekt
Hänvisar till ett enda blogginlägg.
I följande tabell beskrivs de olika attribut som associeras med blogginläggsobjekt.
| Attribut | Beskrivning |
|---|---|
| url | Inläggets URL. |
| content | Returnerar innehållsfältet för inlägget. |
| författare | Returnerar författaren till inlägget som helt enkelt är ett kontakttabellobjekt. |
| rubrik | Inläggets titel. |
| kommentar_värde | Returnerar ett heltalsvärde för beräkning av hur många kommentarer det finns för ett visst inlägg. |
| publicera_datum | Det datum då inlägget publicerades. |
entiteter
Varning
För att undvika problem med skriptkörning över flera webbplatser (XSS) bör du alltid använda flyktfilter för HTML-kodsträngsdata när du använder entitetsobjekt för Liquid för att läsa data som användaren tillhandahållit men som inte är pålitliga.
Anteckning
En del namnkonventioner har ändrats Dataverse, till exempel Dataverse entiteter kallas nu tabeller. Namnändringarna gäller inte för Liquid-objekt. Liquid-entitetsobjekt fortsätter att refereras till som entiteter.
Låter dig läsa in valfri Power Apps-tabellen efter ID. Om tabellen finns, returneras ett tabellobjekt. Om det gick inte att hitta en tabell med det angivna namnet, kommer noll att returneras.
{% 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 %}
Entity
Ett enhetsobjekt ger åtkomst till attributen för en Power Apps-tabellpost.
| Attribut | Beskrivning |
|---|---|
| Id | GUID-ID för tabellen som en sträng. Till exempel 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logiskt_namn | Power Apps logiska namnet på tabellen. |
| Kommentarer | Läser in alla anteckningar (annotation) som är associerade med tabellen, ordnade från äldsta till nyaste (createdon). Anteckningar returneras som anteckningsobjekt. |
| behörigheter | Läser in tabellens framställning av tabellbehörighetsresultat. Resultatet returneras som ett behörighetsobjekt. |
| url | Returnerar Power Apps-portalernas URL-sökväg för innehållshanteringssystem för tabellen. Om tabellen inte har en giltig URL på den aktuella webbplatsen returneras "null". I allmänhet returneras bara ett värde för vissa typer av tabellen som har integrerats i portal-CMS , såvida du inte har anpassade URL-Provider i programmet. |
| [attribut eller relationsnamn] | Du kan komma åt alla attribut för Power Apps-tabellen via logiskt namn. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Värdena för de flesta tabellattribut mappar direkt till Liquid-typer: två alternativfält motsvarar booleska värden, textfält till strängar, numeriska/valutafält till tal, datum/tid-fält till datumobjekt. Men, vissa attributtyper returneras som objekt:
{{ page.adx_webpage_entitylist.adx_name }}I det fall att en relation är reflexiv (d.v.s. självrefererande), kommer ett reflexivt relationsobjekt att returneras. (Annars kan resultatet bli tvetydigt.){{ page.adx_webpage_webpage.referencing.adx_name }} OBS: Att läsa in ett stort antal relaterade entiteter eller använda stora mängder relationer i en enda mall kan ha en negativ inverkan på mallens återgivningsprestanda. Undvik att ladda relaterade entiteter för varje element i en matris i en loop. Om möjligt använder du tabelltaggarna för Dataverse för att hämta entitetssamlingar. |
Associerad tabellreferens
Värdena för uppslagsattributet returneras som associerat tabellreferensobjekt med följande attribut.
| Attribut | Beskrivning |
|---|---|
| Id | GUID-ID för refererade tabellen som en sträng. Till exempel 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logiskt_namn | Power Apps logiska namnet på refererade tabellen. |
| Namn | Det primära attributnamnet på den refererade tabellen. |
Anteckning
En anteckning är ett tabellobjekt som ger åtkomst till attribut och relationer för en anteckningspost. Förutom alla attribut av ett tabellobjekt har en anteckning följande ytterligare attribut.
| Attribut | Beskrivning |
|---|---|
| documentbody | Läser in attributet "documentbody" för anteckningsposten som en Base64-kodad sträng. Eftersom innehållet i det här attributet kan vara stort, läses det inte in med resten av anteckningsattributen utan kan bara läsas in på begäran. OBS: Användning av attributet documentbody kan ha en negativ inverkan på mallåtergivningsprestandan och bör ske med försiktighet. Använd url-attributet för att om möjligt tillhandahålla en länk till anteckningsbilagan istället. |
| URL | Returnerar URL-sökvägen för inbyggda portalanteckningens bifogad fil-hanterare. Om användaren har behörighet och anteckningen har en bifogad fil, kommer en begäran till URL:en hämta en anteckning som bifogad fil. |
Anteckning
Alternativuppsättningsvärde
Attributvärdena alternativuppsättning/pocklista returneras som associerad tabellreferensobjekt med följande attribut.
| Attribut | Beskrivning |
|---|---|
| Etikett | Lokaliserade etiketter för attributvärde för alternativuppsättning/plocklista. Exempel: aktiv |
| Värde | Heltalsvärdet för atttributvärdet alternativuppsättning/plocklista. Exempel: 0 |
Tabellbehörigheter
Tabellbehörighetsobjektet ger åtkomst till aggregerat resultat för behörighetsframställning för en tabell.
| Attribut | Beskrivning |
|---|---|
| kan_tillägg | Returnerar "sant" om den aktuella användaren har behörighet att lägga till poster i relationer för den här posten. Annars returneras "falsk". |
| kan_lägga till_i | Returnerar "sant" om den aktuella användaren har behörighet att lägga till relationer för en annan tabell. Annars returneras "falsk". |
| kan_skapa | Returnerar "sant" om den aktuella användaren har behörighet att skapa nya poster med denna tabelltyp. Annars returneras "falsk". |
| kan_ta bort | Returnerar "sant" om den aktuella användaren har behörighet att ta bort den här posten. Annars returneras "falsk". |
| kan_läsa | Returnerar sant om den aktuella användaren har behörighet att läsa den här posten. Annars returneras "falsk". |
| kan_skriva | Returnerar "sant" om den aktuella användaren har behörighet att uppdatera den här posten. Annars returneras "falsk". |
| regler_finns | Returnerar "sant" om behörighetsresultaten som representeras av det här objektet är resultatet av de behörighetsregler som uttryckligen har definierats. Returnerar "falsk" om de är standardresultaten i avsaknad av uttryckligen definierade behörigheter. |
Reflexiv relation
Försök att hämta reflexiva (d.v.s. självrefererande) relationer på entiteter returneras som objekt med följande attribut.
| Attribut | Beskrivning |
|---|---|
| är_reflexiv | Returnerar "sant". Kan användas för att testa om ett objekt som returnerades av en relation är ett reflexivt relationsobjekt. |
| refererad | Returnerar en matris med refererade enheter för relationen. |
| refererar | Returnerar en refererad tabell för relationen. Returnerar "null" om det inte finns några refererade tabeller. Om relationen är många-till-många (n till n), returneras en matris med refererade entiteter. |
entitetslista
Entitetslisteobjektet används i Power Apps Dataverse tabelltaggarna. Den ger åtkomst till alla attribut för en given lista.
Attribut
Anteckning
| Attribut | Beskrivning |
|---|---|
| skapa_aktiverad | Returnerar "sant" om skapandet av nya poster har konfigurerats för listan. Annars returneras "falsk". |
| skapa_url | Returnerar den konfigurerade URL-sökvägen för en skapa-länk/knapp för listan. |
| detalj_aktiverad | Returnerar "sant" om en detaljerad vy för enskilda poster är konfigurerad för listan. Annars returneras "falsk". |
| detalj_id_parameter | Returnerar parameternamnet för frågesträng som ska användas för post-ID när du konssantrar en postdetalj för visnings-URL. Se URL-filter för mer information om hur du använder Liquid-filter för att skapa URL:er. Exempel: id |
| detalj_etikett | Returnerar den konfigurerade lokaliserade etiketten för en detaljvisnings-länk/knapp för listan. |
| detalj_url | Returnerar den konfigurerade URL-sökvägen för en detalvisnings-länk/knapp för listan. |
| tom_lista_text | Returnerar den konfigurerade lokaliserade texten som ska visas när listans vy inte returnerar några resultat. |
| aktivera_entitet_behörigheter | Returnerar "sant" om tabellbehörighetsfiltrering är aktiverad för den här listan. Annars returneras "falsk". |
| entitet_logiskt_namn | Returnerar Power Apps-tabell logiska namn för poster som ska visas i listan. Till exempel: Kontakt |
| filtrera_konto_attribut_namn | Returnerar uppslagsattributets logiska namn till det konto som ska användas för att filtrera resultatposter efter den aktuella portalanvändarens överordnade konto. Exempel: accountid |
| filtrera_tillämpa_etikett | Returnerar den konfigurerade lokaliserade etikett som ska användas för länken/knappen som gäller ett avancerat attributfilter till listans resultat. |
| filtrera_definition | Returnerar filterdefinitionen för JSON-attributet för listan. Se Filter för lista för mer information om hur du använder metafilter Liquid-filter för att bearbeta denna definition. |
| filtrera_aktiverat | Returnerar "sant" om avancerad attributfiltrering är aktiverad för listan. Annars returneras "falsk". |
| filtrera_portal_användare_attribut_namn | Returnerar attributets logiska namn för uppslag till kontakten som används för att filtrera resultatposter efter den aktuella portalanvändarens kontakt. Exempel: contactid |
| filtrera_webbplats_attribut_namn | Returnerar attributets logiska namn för uppslaget till adx_webbplats som används för att filtrera resultatposter efter den aktuella portalens webbplats. Exempel: adx_websiteid |
| språk_kod | Returnerar Power Apps-språkkoden för heltal som kommer att användas för att markera alla lokaliserade etiketter för den här listan. |
| sida_storlek | Returnerar den konfigurerade resultatsidan för listan. |
| primärt_nyckel-_namn | Returnerar det primära huvudattributets logiska namn för poster som ska visas i listan. |
| sökning_aktiverad | Returnerar "sant" om sökning är aktiverad för den här listan. Annars returneras "falsk". |
| sök_platshållare | Returnerar den konfigurerade lokaliserade texten för listans sökfältplatshållare. |
| sök_knappbeskrivning | Returnerar den konfigurerade lokaliserade texten för listans sökknappbeskrivning. |
| vyer | Returnerar de tillgängliga vyerna för listan som t.ex. listans visningsobjekt. |
| [attributets logiska namn] | Du kan komma åt alla attribut i listan (adx_entitylist) Power Apps-post efter logiskt namn på samma sätt som ett tabell. Exempel, {{ entitylist.adx_name }} |
Lista med visaattribut
| Attribut | Beskrivning |
|---|---|
| kolumner | Returnerar kolumnerna i vyn eftersom listan visar kolumnobjekt. |
| entitet_logiskt_namn | Returnerar Power Apps-tabell logiska namn för posterna i vyn. Till exempel: Kontakt |
| ID | Returnerar GUIG ID för vyn |
| språk_kod | Returnerar Power Apps-språkkoden för heltal som kommer att användas för att markera alla lokaliserade etiketter (kolumnrubriker, osv.). |
| Namn | Returnerar Power Apps-visningsnamn för vyn. |
| primär_nyckel_logiskt_namn | Returnerar Power Apps-tabellens logiska namn för primär nyckel i vyn. Exempel: contactid |
| sortera_uttryck | Returnerar det standardinställda sorteringsuttrycket för vyn. Exempel: name ASC, createdon DESC |
Kolumnattribut för listans vy
| Attribut | Beskrivning |
|---|---|
| attributet_typ | Returnerar Power Apps-attributtypnamnet för kolumnen som en sträng. Exempel: Lookup, Picklist, String, Boolean, DateTime |
| logiskt_namn | Returnerar Power Apps-attributets logiska namn för kolumnen. Exempel: createdon |
| Namn | Returnerar det lokaliserade Power Apps-visningsnamnet för kolumnen. Exempel: Created On |
| sortera_stigande | Returnerar en sorteringsuttrycksträng för att sortera kolumnen i stigande ordning. Exempel: createdon ASC |
| sortera_fallande | Returnerar en sorteringsuttrycksträng för att sortera kolumnen i fallande ordning. Exempel: createdon DESC |
| sortera_avaktiverad | Returnerar "sant" om sortering är inaktiverad för kolumnen. Annars returneras "falsk". |
| sortera_aktiverat | Returnerar "sant" om sortering är aktiverad för kolumnen. Annars returneras "falsk". |
| width | Returnerar den konfigurerade bredden för kolumnen i bildpunkter. |
entitetsvy
Entitetsvyobjektet används inom entitetsvytaggen och ger tillgång till metadata för vyn, samt poster för resultatvisning.
Attribut
| Attribut | Beskrivning |
|---|---|
| kolumner | Returnerar kolumnerna i vyn som tabellobjekt för entitetsvisning. |
| entitet_behörighet_nekades | Returnerar "sant" om du vill visa resultat som nekades på grund av otillräckliga tabellbehörigheter för den aktuella användaren. Returnerar "falsk" om läsåtkomst till att visa resultaten beviljades. |
| entitet_logiskt_namn | Power Apps-tabellens logiska namn för vyresultatposterna. Till exempel: Kontakt |
| första_sidan | Sidnumret på den första sidan för visa resultat. Detta kommer att vara "1" om det inte returneras några resultat, då det blir "null". |
| ID | GUID ID för Power Apps-vyn som definierar denna entitetsvy. |
| språk_kod | Power Apps-språkkoden för heltal som används för att hämta lokaliserade etiketter för den aktuella vyn. |
| sista_sidan | Sidnumret på den sista sidan för visa resultat. Om inga resultat returneras är detta "null". |
| namn | Namnet på den Power Apps-vy som definierar denna entitetsvy, till exempel aktiva kontaktpersoner. |
| nästa_sida | Sidnumret på nästa sida för visa resultat. Om det inte finns någon nästa sida med resultat, är detta "null". |
| Sida | Sidnumret på den aktuella sidan för visa resultat. |
| sidor | Returnerar en matris med sidnummer som innehåller alla sidor av resultaten för den aktuella vyn. |
| sida_storlek | Antalet resultat som returneras per sida för den aktuella vyn. |
| föregående_sida | Sidnumret på nästa sida för visa resultat. Om det inte finns någon föregående sida med resultat, är detta "null". |
| primär_nyckel_logiskt_namn | Det logiska Power Apps-namnet för resultattabellen primära nyckelattribut för denna vy. Till exempel: contactid. |
| poster | Den aktuella sidan av resultatposter för vyn, som tabellobjekt. |
| sortera_uttryck | Standardsorteringsuttryck för vyn. Till exempel nameASC, createdon DESC. |
| summa_sidor | Det totala antalet sidor med sökresultat för vyn. |
| summa_poster | Det totala antalet resultat för vyn (genom alla sidor). |
händelser
Ger dig möjlighet att komma åt och återge händelser. Händelseobjektet låter dig markera en viss händelse eller alla händelser.
händelseobjekt
Händelseobjektet låter dig komma åt alla specifika händelser eller samtliga händelser i portalen (oavsett händelse).
Händelseobjektet har följande attribut:
| Attribut | Beskrivning |
|---|---|
| förekomster | Returnerar ett eventoccurrences-objekt som innehåller alla händelseförekomster i portalen |
| [händelsenamn eller id] | Du kan få åtkomst till valfri händelse via dess namn eller Id-egenskaper. {% tilldela händelse = händelser["Händelsenamn"] %} {% tilldela händelse = händelser["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
händelseobjekt
Händelseobjektet låter dig arbeta med en enda händelse, så att du kan komma åt den händelsens scheman och förekomster.
Händelseobjektet har följande attribut:
| Attribut | Beskrivning |
|---|---|
| förekomster | Returnerar ett eventoccurrencesobject som innehåller alla förekomster av händelsen. |
| namn | Namnet på händelsen. |
| URL | URL för händelsen. |
eventoccurences-objekt
eventoccurrences-objektet låter dig komma åt en samling händelseförekomstobjekt. Du kan beställa händelseförekomster och ange ett datumintervall för förekomsterna du vill hämta samt även uppnå sidnumrering med hjälp av Liquid-filter
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
notera att
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
är också möjliga.
Följande attribut är associerade med eventoccurences-objekt
| Attribut | Beskrivning |
|---|---|
| Alla | Returnerar alla eventoccurrences-objekt i samlingen. |
eventoccurence-objekt
Representerar en enda händelse. Associerade attribut anges nedan:
| Attribut | Beskrivning |
|---|---|
| URL | URL för förekomsten. |
| är_hel-_dags-_händelse | Är det en heldagshändelse? |
| start-_tid | Starttid för händelse. |
| slut_-tid | Sluttid för händelse. |
forloop
Innehåller egenskaper som är användbar för loopblock.
Anteckning
forloop kan bara användas inom en för-tagg.
Code
{% for child in page.children %}
{% if forloop.first %}
This is the first child page!
{% else %}
This is child page number {{ forloop.index }}.
{% endif %}
{% endfor %}
Utdata
This is the first child page!
This is child page number 2.
This is child page number 3.
Attribut
| Attribut | Beskrivning |
|---|---|
| Första | Returnerar "sant" om det är den första loopupprepningen. Returnerar "falsk" om det inte är den första upprepningen. |
| index | Det aktuella objektets position i samlingen, där det första objektet har positionen 1. |
| index0 | Det aktuella objektets position i samlingen, där det första objektet har positionen 0. |
| Sista | Returnerar "sant" om det är den sista loopupprepningen. Returnerar "falsk" om det inte är den sista upprepningen. |
| längd | Returnerar antalet iterationer för loopen ߝ av antalet objekt i den samling som itereras över. |
| rindex | Antalet artiklar som återstår i loopen (längd – index) där 1 är indexet för det sista objektet. |
| rindex0 | Antalet artiklar som återstår i loopen (längd – index) där 0 är indexet för det sista objektet. |
forum
Ger dig möjlighet att komma åt och återge forum och forumtrådar. Möjligheten att använda Liquid för att återge forumdata sträcker sig till inlägg, men för att skapa ett nytt inlägg eller en ny tråd måste du använda en sidmall för ASP.NET-flerstegsformulär med de nämnda funktionerna (som t.ex. standardsidmallar för forumtråd och foruminlägg).
Forumobjekt låter dig markera ett Forum eller Forumtrådar:
<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
Forumobjekt låter dig komma åt alla specifika forum på portalen eller om du vill komma åt alla forumtrådar i portalen (oavsett forum).
Forumobjektet låter dig arbeta med ett enda forum, så att du kan komma åt trådarna för det forumet.
Forumtrådobjekt låter dig komma åt en samling med forumtrådobjekt. Du kan dessutom beställa forumtrådar och få sidnumrering genom att använda Liquid-filter.
{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}
En enda forumtråd
Foruminlägg låter dig komma åt en samling med foruminläggobjekt.
Attribut
| Attribut | Beskrivning |
|---|---|
| trådar | Returnerar ett forumtrådsobjekt som innehåller alla forumtrådsobjekt i portalen. |
| Alla | Returnerar alla forumobjekt i portalen. Observera att website-forum också är en motsvarighet. |
| tråd_antal | Returnerar heltalsvärdet för beräkning av hur många trådar som finns på hela webbplatsen. |
| inlägg_antal | Returnerar heltalsvärdet för det totala antalet inlägg på portalen. |
| [forumets namn eller id] | Du kan få åtkomst till valfritt forum via dess namn eller Id-egenskaper. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %} |
forumobjekt
Attribut
Anteckning
| Attribut | Description |
|---|---|
| trådar | Returnerar ett forumtrådsobjekt som innehåller alla forumtrådar för forumet. |
| Namn | Namnet på forumet. |
| tråd_antal | Returnerar heltalsvärdet för beräkning av hur många trådar som finns på hela forumet. |
| inlägg_antal | Returnerar heltalsvärdet för beräkning av hur många inlägg som finns på hela forumet. |
forumtrådsobjekt
Attribut
| Attribut | Beskrivning |
|---|---|
| Alla | Returnerar alla forumtrådsobjekt i samlingen. |
forumtrådsobjekt
Attribut
Anteckning
| Attribut | Beskrivning |
|---|---|
| poster | Returnerar ett foruminläggsobjekt som innehåller alla foruminlägg för den tråden. |
| författare | Returnerar författaren för inlägget (som helt enkelt är ett kontakttabellobjekt). |
| senaste_inlägg | Returnerar det senaste inlägget i tråden. |
| första_inlägg | Returnerar det första inlägget i tråden. |
| inlägg_antal | Returnerar heltalsvärdet för beräkning av hur många inlägg som finns i tråden. |
| har_besvarats | Besvaras tråden eller inte? |
| är_fästa | Är tråden en fäst tråd? |
foruminläggsobjekt
Attribut
| Attribut | Beskrivning |
|---|---|
| Alla | Returnerar alla forumtrådsobjekt i samlingen. |
Ett enda foruminlägg
Attribut
Anteckning
| Attribut | Beskrivning |
|---|---|
| författare | Returnerar författaren till inlägget (som helt enkelt är ett kontakttabellobjekt). |
| innehåll | Inläggets innehåll. |
| är_svar | Är det här inlägget ett svar till tråden? |
kunskap
Ger tillgång till Power Apps kunskapsartiklar och kategoritabellposter för rendering av artiklar och kategorier i en portal.
Attribut
| Attribut | Beskrivning |
|---|---|
| artiklar | Returnerar ett artikelobjekt som innehåller artikelobjekt för tabellposter för kunskapsartikeln i portalen. |
| kategorier | Returnerar ett kategoriobjekt som innehåller kategoriobjekt för kategoritabellposter som finns i portalen. |
artikelobjekt
Artikelobjekten låter dig komma åt en samling med artikelobjekt. Du kan beställa artiklar och få sidnumrering samt använda flytande filter.
{% 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 %}
Attribut
| Attribut | Beskrivning |
|---|---|
| populära | Returnerar en samling artikelobjekt som innehåller de flesta vyer. {% assign popular_articles = knowledge.articles.popular %} |
| senaste | Returnerar en samling artikelobjekt som innehåller de senaste modifierade datumet. {% assign recent_articles = knowledge.articles.recent %} |
| top | Returnerar en samling artikelobjekt som innehåller det högsta omdömet. {% assign top_articles = knowledge.articles.top %} |
Filter
Följande filter kan acceptera valfria parametrar för sidstorlek och språk. Den första parametern är numret eller posterna som ska hämtas. Standardstorleken på sidan är 5. Den andra parametern är koden för ett språk för att hämta artiklar för ett visst språk. Filter kan kombineras med andra flytande filter.
{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
| Attribut | Beskrivning |
|---|---|
| populära | Returnerar en samling artikelobjekt som innehåller de flesta vyer. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %} |
| senaste | Returnerar en samling artikelobjekt som innehåller de senaste modifierade datumet. {% assign recent_articles = knowledge.articles \| recent: 5 %} |
| top | Returnerar en samling artikelobjekt som innehåller det högsta omdömet. {% assign top_articles = knowledge.articles \| top: 3, en-US %} |
kategoriobjekt
Kategoriobjekt låter dig komma åt en samling med kategoriobjekt. Du kan beställa kategorier och få sidnumrering samt använda flytande filter.
{% 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 %}
Attribut
| Attribut | Beskrivning |
|---|---|
| senaste | Returnerar en samling kategorier som innehåller de senaste modifierade datumet. |
| högsta_nivå | Returnerar en samling kategoriobjekt som inte har en överordnad kategori. |
Filter
Följande filter kan acceptera en valfri parameter som anger sidstorlek. Standardstorleken på sidan är 5. Filter kan kombineras med andra flytande filter.
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
| Attribut | Beskrivning |
|---|---|
| senaste | Returnerar en samling kategorier som innehåller de senaste modifierade datumet. Du kan ange parametrar {% assign recent_categories = knowledge.categories \| recent: 10 %} |
| högsta_nivå | Returnerar en samling kategoriobjekt som inte har en överordnad kategori. {% assign root_categories = knowledge.categories \| top_level %} |
artikelobjekt
Artikelobjekt låter dig arbeta med en enskild kunskapsartikel för att visa information om den artikeln på portalen.
Attribut
artikel är ett entitetsobjekt med samma attribut förutom de som anges nedan.
| Attribut | Beskrivning |
|---|---|
| offentligt artikelnummer | Det offentliga artikelnumret i artikel. |
| kommentarvärde | Heltalsvärdet för beräkning av hur många kommentarer det finns för en viss artikel. |
| innehåll | Innehållet i artikeln. |
| aktuell_användare_kan_kommentera | Returnerar ett booleskt värde som anger om den aktuella användaren kan lägga till kommentarer i artikeln. |
| är_granskning_aktiverat | Returnerar ett booleskt värde som anger om klassificering i en artikel har aktiverats. |
| sökord | Nyckelorden för artikeln. |
| namn | Alternativa alias för namnet på en artikel. |
| klassificering | Artikelns decimalklassificering. |
| title | Artikelns rubrik. |
| antal_visningar | Heltalsvärdet av det antal gånger som artikeln har visats. |
kategoriobjekt
Kategoriobjekt låter dig arbeta med en enskild kategori för att visa dess information på portalen.
Attribut
kategori är ett entitetsobjekt med samma attribut förutom de som anges nedan.
| Attribut | Beskrivning |
|---|---|
| kategorinummer | Kategorins kategorinummer. |
| namn | Alternativa alias för namnet på en kategori. |
| rubrik | Kategorins rubrik. |
språk
Anger det aktuella språknamnet och språkkoden om stöd för flera språk har aktiverats.
Attribut
| Attribut | Beskrivning |
|---|---|
| URL | Den aktuella förfrågans URL-adress har prefixerats med den aktuella språkkoden. |
| url_substitution | Den aktuella begärans-URL-adressen prefixeras med den aktuella språkkoden som kringgår sidans utdatacachen. |
| namn | Rubrik för det aktuella språket. |
| kod | Språkets språkkod. |
Till exempel listruta med språk webbmall använder som standard detta flytande objekt för att lista tillgängliga språk när flera språk är tillgängliga.
sida
Refererar till den aktuella portalbegäransidan. Detta objekt kombinerar attributen för webbplatskartan och den aktuella begäran entiteter (vanligtvis en webbsida).
Sidobjektet ger tillgång till exempelvis spåren för den aktuella sidan, rubrik eller URL för den aktuella sidan, samt andra attribut och entiteter relaterade till underliggande 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 }}. -->
Sidattribut
Anteckning
| Attribut | Beskrivning |
|---|---|
| spår | Returnerar spårnodobjekt för webbplatsöversikt för sidan, med början från roten från webbplatsöversiktens rotnod och slutar vid överordnad. |
| underordnade | Returnerar underordnade webbplatsöversikts-nodobjekt för sidan. |
| överordnad | Returnerar överordnade webbplatsöversiktsnod för sidan. Om sidan är startsidan, kommer överordnad att vara "null". |
| title | Sidans titel. |
| URL | Sidans URL. |
| [attribut eller relationsnamn] | Du kan komma åt alla attribut för sidans underliggande Power Apps-post efter logiskt namn.{{ page.createdon }}{% assign attribute_name = 'name' %}{{ page[attribute_name] }}Värdena för de flesta tabellattribut mappar direkt till Liquid-typer: två alternativfält motsvarar booleska värden, textfält till strängar, numeriska/valutafält till tal, datum/tid-fält till datumobjekt. Men, vissa attributtyper returneras som objekt:
{{ page.adx_webpage_entitylist.adx_name }}Om en relation är reflexiv (dvs. självrefererande) kommer ett entiteter-objekt att returneras. (Annars kan resultatet bli tvetydigt.) {{ page.adx_webpage_webpage.referencing.adx_name }} OBS: Att läsa in ett stort antal relaterade entiteter eller använda stora mängder relationer i en enda mall kan ha en negativ inverkan på mallens återgivningsprestanda. Undvik att ladda relaterade entiteter för varje element i en matris i en loop. Om möjligt använder du Power Apps Dataverse tabelltaggarna för att hämta entitetssamlingar. |
undersökningar
Ger dig möjlighet att komma åt och återge en undersökning.
Undersökningsobjektet låter dig markera en specifik undersökning eller undersökningsplacering:
<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>
Attribut för undersökningar
| Attribut | Beskrivning |
|---|---|
| placeringar | Returnerar undersökningplaceringsobjekt. |
| [undersökningsnamn eller -ID] | Du kan komma åt undersökning genom dess namn eller Id-egenskaper. {% assign poll = polls[Poll Name] %}{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %} |
Undersökningplaceringsattribut
| Attribut | Beskrivning |
|---|---|
| [undersökningsplaceringsnamn eller -ID] | Du kan komma åt alla undersökningsplaceringar genom dess namn eller Id-egenskaper.{% assign placement = polls.placements[Placement Name or Id] %}{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %} |
Undersökningsplaceringsattribut
Anteckning
| Attribut | Beskrivning |
|---|---|
| Namn | Returnerar namnfältet för undersökningsplacering. |
| placering_url | Den URL som kan användas för att hämta undersökningsplacering återges helt av en mall. |
| undersökningar | Returnerar samlingen med undersökningsobjekt som är associerade med placeringen. upprepningstaggar och matrisfilter kan användas för den här samlingen. |
| slumpmässig_url | Den URL som kan användas för att hämta en undersökning från placering återges helt av en mall. |
| skicka_url | Den URL som slutförda undersökningar skickas in. |
Attribut för undersökning
Anteckning
| Attribut | Beskrivning |
|---|---|
| har_användare_röstat | Returnerar "sant" om den aktuella användaren (inloggad eller anonym) redan har röstat i denna undersökning. |
| Namn | Returnerar namnfältet för undersökningen. |
| alternativ | Returnerar samlingen med undersökningsalternativobjekt som är associerade med undersökningen. Upprepningstaggar och entiteter kan användas för denna samling. |
| undersökning_url | Den URL som kan användas för att hämta undersökningen återges helt av en mall. |
| -fråga | Returnerar frågefältet för undersökningen. |
| skicka_knapp_etikett | Returnerar en sträng som kan användas för att åsidosätta knappen Skicka för undersökningen. |
| skicka_url | Den URL som slutförda undersökningar skickas in. |
| användare_markerade_alternativ | Returnerar undersökningalternativobjekt som valts av användaren (om de redan har röstat). |
| röster | Returnerar antalet röster som har blivit en tabell för att röstning. |
Undersökningsalternativattribut
Anteckning
| Attribut | Beskrivning |
|---|---|
| svar | Returnerar svarsfältet för undersökningen. |
| procentandel | Returnerar procentandelen av rösterna i undersökningen för alternativet som ett decimaltal mellan 0 och 100. |
| röster | Returnerar antalet röster som har blivit en tabell för alternativet. |
begäran
Innehåller information om den aktuella HTTP-posten.
{% assign id = request.params['id'] | escape %}
<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>
Anteckning
- Du kan dynamiskt skapa URL-adresser i Liquid med hjälp av URL-filter.
- URL:en som används i request.url kan vara ett begärt värde och cachelagras för efterföljande begäran. För att säkerställa korrekt värde i request.url bör du använda ersättningstagg, delvis URL t.ex. ~{WebFile path} eller lagra portalens URL i webbplatsinställningar.
- Power Apps portaler version 9.3.8.x eller senare kommer som standard att ha undanta Liquid-filter framtvingad för användare och begäran Liquid-objekt. Om du vill inaktivera denna standardkonfiguration och tillåta dessa Liquid-objekt utan att undanta Liquid-filter, se inställningar för portalwebbplatsen – Site/EnableDefaultHtmlEncoding.
Attribut
| Attribut | Beskrivning |
|---|---|
| params | Namngivna parametervärden för den aktuella begäran. parametrar är en kombination av URL-frågesträngparametrar, formulärinläggsparametrar och cookies. |
| Sökväg | Sökvägen till den aktuella begäran-URL:en. /profile/ |
| sökväg_och_fråga | Sökvägen och frågan till den aktuella begäran-URL:en. /profile/?foo=1&bar=something |
| query | Frågedelen till den aktuella begäran-URL:en. ?foo=1&bar=something |
| URL | Den fullständiga URL:en till den aktuella begäran. https://www.example.com/profile/?foo=1&bar=something |
sökindex
Sökindexobjektet används inom entitetstaggarna för Power Apps Dataverse tabelltaggar och ger åtkomst till frågeresultat.
{% 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 %}
Attribut
| Attribut | Beskrivning |
|---|---|
| ungefärligt_totalantal_träffar | Returnerar ett ungefärligt antal totala träffar som matchar indexfrågan. Beroende på det sätt som sökindexet fungerar med avseende på säkerhetsfiltrering och andra designfaktorer är detta antal endast en uppskattning som kanske inte exakt motsvarar det totala antalet resultat som är tillgängliga för den aktuella användaren i vissa situationer. |
| Sida | Returnerar den aktuella frågans sidnummer. |
| sida_storlek | Returnerar den aktuella frågans maximala sidstorlek. Om du vill ha det faktiska antalet resultat för den aktuella sidan (eftersom detta kan vara mindre än den angivna maximala sidstorleken), använd då results.size. |
| Resultat | Returnerar frågans resultatsida som resultatobjekt i sökindex. |
Sökindexresultat
| Attribut | Beskrivning |
|---|---|
| entitet | Underliggande entiteter för resultatet. |
| fragment | Ett relevant kort textfragment för resultatet, där termerna matchar angiven markerad fråga med hjälp av HTML-tagen <em>. Vissa typer av frågor inte stöder markerade fragment, till exempel oklara frågor (~) och frågor med jokertecken (*). Den här egenskapen är null i dessa fall. |
| Id | Tabell-ID Power Apps för underliggande post för resultatet, som sträng. Till exempel 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
| logiskt_namn | Logiskt Power Apps-tabellnamn för underliggande post för resultatet. Exempel: adx_webpage |
| Nummer | Antalet resultat på alla resultatsidor, med början från 1. Till exempel kommer värdet för det första resultatet på den andra resultatsidan att vara 11 (vid en sidstorlek på 10). |
| poäng | Lucene-poängen på resultatet som ett flyttal. Resultat returneras beställda av detta värde. |
| title | Resultatets titel. |
| URL | URL för resultatet. Detta kommer vanligtvis—men inte nödvändigtvis—att vara en absolut sökväg för det aktuella programmet snarare än en full URL. Till exempel: /artiklar/artikel1 / |
inställningar
Låter dig läsa in alla webbplatsinställningar efter namn. Om en inställning med angivet namn inte hittas kommer noll att returneras.
Anteckning
Inställningar returneras som strängar, men du kan använda Typfilter om du vill konvertera dem till andra 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 %}
webbkarta
Tillåter åtkomst till portalwebbplatsen.
<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 %}
Attribut för webbplatsöversikt
| Attribut | Beskrivning |
|---|---|
| Aktuell | Returnerar nodobjektet för webbplatsöversikt för den aktuella sidan. |
| Rot | Returnerar nodobjektet för webbplatsöversikt för webbplatsens huvudsida (start). |
Nodattribut för webbplatsöversikt
| Attribut | Beskrivning |
|---|---|
| Spår | Returnerar spårnodobjekt för webbplatsöversikt för noden, med början från roten från webbplatsöversiktens rotnod och slutar vid överordnad. |
| Underordnade | Returnerar underordnade webbplatsöversiktobjekt för noden. |
| Beskrivning | Beskrivning/sammanfattningsinnehåll i noden. (Det här fältet kan innehålla HTML.) |
| Enhet | Returnerar underliggande entiteter för noden. Om noden inte har någon underliggande tabell kommer detta värde att vara "null". |
| är_webbplatsöversikt_överordnad | Returnerar "sant" om webbplatsöversiktsnoden är ett överordnat objekt till den aktuella noden, annars är den "falsk". |
| är_webbplatsöversikt_aktuell | Returnerar "sant" om webbplatsöversiktsnoden är den aktuella noden, annars är den "falsk". |
| Överordnat | Returnerar överordnade webbplatsöversiktnod för noden. Om noden är rotnoden kommer den överordnade att vara "null". |
| Befattning | Nodens titel. |
| URL | Nodens URL. |
webbplatsmarkörer
Låter dig läsa in alla webbplatsmarkörer efter namn. Om webbplatsmarkören finns, returneras ett webbplatsmarkörobjekt. Om en platsmarkör med angivet namn inte hittas kommer noll att returneras.
{{ 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 %}
Webbplatsmarkörattribut
| Attribut | Beskrivning |
|---|---|
| URL | Webbplatsmarkörmålets URL |
| [attributets logiska namn] | Du kan komma åt alla attribut för webbplatsmarkörmålets Power Apps-post efter logiskt namn. Exempel, {{ sitemarker.adx_namn }} |
kodavsnitt
Låter dig läsa in alla innehållskodavsnitt efter namn. Om ett textfragment med angivet namn inte hittas kommer noll att returneras.
{{ snippets[Header] }}
{% assign footer = snippets[Footer] %}
{% if footer %}
{{ footer }}
{% else %}
No footer snippet was found.
{% endif %}
tablerowloop
Innehåller egenskaper som är användbara inom ett upprepningstaggar-loopblock.
Anteckning
tablerowloop kan bara användas inom en Upprepningstaggar-tagg.
Attribut
| Attribut | Beskrivning |
|---|---|
| Kol | Returnerar index för den aktuella raden, med början på 1. |
| col0 | Returnerar index för den aktuella raden, med början på 0. |
| kol_första | Returnerar "sant" om den aktuella kolumnen är den första kolumnen i en rad, annars "falsk". |
| kol_sista | Returnerar "sant" om den aktuella kolumnen är den sista kolumnen i en rad, annars "falsk". |
| Första | Returnerar "sant" om det är den första loopupprepningen. Returnerar "falsk" om det inte är den första upprepningen. |
| Index | Det aktuella objektets position i samlingen, där det första objektet har positionen 1. |
| index0 | Det aktuella objektets position i samlingen, där det första objektet har positionen 0. |
| Sista | Returnerar "sant" om det är den sista loopupprepningen. Returnerar "falsk" om det inte är den sista upprepningen. |
| Längd | Returnerar antalet iterationer för loopen ߝ av antalet objekt i den samling som itereras över. |
| Rindex | Antalet artiklar som återstår i loopen (längd – index) där 1 är indexet för det sista objektet. |
| rindex0 | Antalet artiklar som återstår i loopen (längd – index) där 0 är indexet för det sista objektet. |
användare
Refererar till den aktuella portalanvändaren, tillåter åtkomst till alla attribut för den underliggande Power Apps-kontaktposten. Om ingen användare är inloggad, den här variabeln kommer att vara noll.
Användaren är en entitet-objekt.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
Anteckning
Power Apps portaler version 9.3.8.x eller senare kommer som standard att ha undanta Liquid-filter framtvingad för användare och begäran Liquid-objekt. Om du vill inaktivera denna standardkonfiguration och tillåta dessa Liquid-objekt utan att undanta Liquid-filter, se inställningar för portalwebbplatsen – Site/EnableDefaultHtmlEncoding.
Attribut
Förutom samtliga attribut för en entitet-objekt har användaren även följande attribut.
| Attribut | Beskrivning |
|---|---|
| roller | Returnerar de roller som användaren tillhör, som en matris .{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}Obs!: du kan också använda filtret has_role för att testa i enskilda medlemskap. |
| basic_badges_url | Returnerar den tjänst-URL för att hämta en användares namnbricka. Om du vill återge emblem för en användare måste inkludera en tagg med attribut ”data-namnbricka” och ”data-uri". För rendering av den aktuella användarens namnbrickor: <div data-badge data-uri='{{user.basic_badges_url }}'></div>För rendering av en användares namnbrickan via ID (variabeln användar-ID): `<div data-badge data-uri='{{user.basic_badges_url |
webblänkar
Låter dig läsa in alla webblänkar efter namn eller ID.
Om uppsättningen med webblänkar finns kommer ett uppsättningen med webbobjektlänkar att returneras. Om det gick inte att hitta en uppsättningen med webblänkar med det angivna namnet eller ID kommer null att returneras.
<!-- 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 %}
Attribut för uppsättning med webblänkar
Anteckning
En webblänkuppsättning är ett entitetsobjekt med samma attribut förutom de som anges nedan.
| Attribut | Beskrivning |
|---|---|
| Kopiera | HTML-kopian av uppsättningen med webblänkar. |
| Namn | Namnet på uppsättningen med webblänkar. |
| Befattning | Rubriken på uppsättningen med webblänkar. |
| Webblänkar | Matris med webblänkobjekt som associeras med uppsättningen med webblänkar. |
| [attributets logiska namn] | Du kan komma åt alla attribut för webblänkuppsättningens Power Apps-post efter logiskt namn. Till exempel: {{ weblinkset.createdon }} |
Attribut för webblänkar
Anteckning
En webblänk är ett entitetsobjekt med samma attribut förutom de som anges nedan.
| Attribut | Beskrivning |
|---|---|
| Beskrivning | HTML-beskrivning av webblänken. |
| visa_bild_endast | Booleskt attribut som anger om webblänken ska visas som en bild, utan länktext. |
| visa_sida_underordnade_länkar | Booleskt attribut som anger om webblänken ska visa länkar till de webbplatsöversikt underordnade sidorna för den länkade sidan som underordnade länkar. |
| Bild | Weblänkens bildobjekt för den här länken. Det här attributet blir null om ingen bild finns. |
| är_extern | Booleskt attribut som anger om webblänkens mål-URL är en extern webbplats (inte en intern portalsida). |
| är_webbplatsöversikt_överordnad | Returnerar "sant" om webblänkens URL-referens är ett överordnat element av den aktuella webbplatsöversiktnoden, annars "falsk". |
| är_webbplatsöversikt_aktuell | Returnerar "sant" om webblänkens URL-referens är ett överordnat element av den aktuella webbplatsöversiktnoden, annars "falsk". |
| Namn | Namnet/rubriken på webblänkarna. |
| Nofollow | Booleskt attribut som anger om webblänken ska markeras som rel=nofollow. |
| öppna_i_nytt_fönster | Booleskt attribut som anger om webblänken ska öppnas i ett nytt webbläsarfönster/flik när den väljs. |
| Knappbeskrivning | Knappbeskrivning för webblänk. |
| URL | URL för webblänken. |
| Webblänkar | Matris med underordnade webblänkobjekt som associeras med webblänken. |
| [attributets logiska namn] | Du kan komma åt alla attribut för webblänkens Power Apps-post efter logiskt namn. Till exempel: {{ weblink.createdon }} |
Attribut för webblänkbild
| alternativ_text | Alternativ text för bilden. |
|---|---|
| Höjd | Heltal som innehåller den angivna höjden på bilden. Det här attributet blir null om inget höjdvärde angavs. |
| URL | Bildens URL. |
| Bredd | Heltal som innehåller den angivna bredden på bilden. Det här attributet blir null om inget breddvärde angavs. |
webbplats
Avser portalens webbplats som ger åtkomst till samtliga attribut för Power Apps webbplatsposten (adx_website) för portalen.
Anteckning
Webbplatsen är en entiteten objekt med alla samma attribut.
Code
{{ website.adx_name }} ({{ website.id }})
Utdata
Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)
Attribut
I följande tabell visas attributen för den här taggen som kan användas när du ersätter standardvärdena för att undvika cachelagring.
| Standardvärde | Ersättning (undviker cachelagring) | Exempel |
|---|---|---|
| sign_in_url | sign_in_url_substitution | Standard: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F Ersättning (undviker cachelagring): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("ersättningssida" i det här exemplet ersätter standardcachens URL.) |
| sign_out_url | sign_out_url_substitution | Standard: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F Ersättning (undviker cachelagring): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("ersättningssida" i det här exemplet ersätter standardcachens URL.) |
Se även
Liquid-typer
Liquid-taggar
Liquid-filter
Anteckning
Kan du berätta om dina inställningar för dokumentationsspråk? Svara i en kort undersökning. (observera att undersökningen är på engelska)
Undersökningen tar ungefär sju minuter. Inga personuppgifter samlas in (sekretesspolicy).
Feedback
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i: https://aka.ms/ContentUserFeedback.
Skicka och visa feedback för