Kopīgot, izmantojot

Pieejamie Liquid objekti

  • Raksts

Liquid objekti satur atribūtus, lai izvadītu dinamisku lapas saturu. Piemēram, lappuses objektam ir atribūts ar nosaukumu virsraksts, ko var izmantot, lai izvadītu pašreizējās lapas virsrakstu.

Lai piekļūtu objekta atribūtam pēc nosaukuma, izmantojiet daudzpunkti (.). Lai atveidotu objekta atribūtu veidnē, ietiniet to {{ and }}.

Svarīgi

Lai izvairītos no iespējamām starpvietņu skriptēšanas (XSS) problēmām, vienmēr izmantojiet Izejas filtru, lai HTML kodētu datus ikreiz, kad izmantojat Sējas objektus, lai nolasītu lietotāja sniegtos neuzticamos datus.

{{ page.title }}

Objekta atribūtiem var piekļūt arī, izmantojot virknes nosaukumu un []. Šis formāts noder gadījumos, kad vajadzīgais atribūts tiek noteikts dinamiski, vai atribūta nosaukums satur rakstzīmes, atstarpes, speciālās rakstzīmes u.c., kas būtu nederīgas, lietojot punktu (.) sintaksē.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Šos objektus var izmantot, un tiem var piekļūt jebkurā vietā, jebkurā veidnē.

Objekts Apraksts
entities Ļauj ielādēt jebkuru Microsoft Dataverse entītiju pēc ID. Papildinformācija: entītijas
tūlīt Datuma/laika objekts, kas attiecas uz pašreizējo UTC laiku, laikā, kad veidne tiek atveidota.
Piezīme. Portāla tīmekļa programma nodrošina šīs vērtības kešdarbi, un tā netiek katru reizi atsvaidzināta. Papildinformācija: Datumu filtri
Lapa Atsaucas uz pašreizējo portāla pieprasījuma lapu. Objekts page nodrošina pieeju tādiem elementiem kā, piemēram, pašreizējās lapas atpakaļceļi, pašreizējās lapas virsraksts vai URL, kā arī daudzi citi pamata Dataverse ieraksta atribūti vai saistītās entītijas. Papildinformācija: lapa
params Ērta request.params saīsne. Papildinformācija: pieprasījums
pieprasījums Satur informāciju par pašreizējo HTTP pieprasījumu. Papildinformācija: pieprasījums
iestatījumi Ļauj jums ielādēt jebkuru Vietnes iestatījumu pēc nosaukuma. Papildinformācija: iestatījumi
vietnes karte Ļauj piekļūt portāla vietnes kartei. Papildinformācija: vietnes karte
vietnes marķieri Ļauj ielādēt jebkuru vietnes marķieri pēc nosaukuma. Papildinformācija: vietnes marķieri
fragmenti Ļauj jums ielādēt jebkura satura fragmentu pēc nosaukuma. Papildinformācija: fragmenti
user Atsaucas uz pašreizējo portāla lietotāju, atļaujot piekļuvi visiem pamata Dataverse kontaktpersonas ieraksta atribūtiem. Ja nav pierakstījies neviens lietotājs, šis mainīgais ir null. Papildinformācija: lietotājs
weblinks Ļauj ielādēt jebkuru tīmekļa saišu kopu pēc nosaukuma vai ID. Papildinformācija: tīmekļa saites
tīmekļa vietne Atsaucas uz portāla tīmekļa vietnes ierakstu, atļaujot piekļuvi visiem Dataverse tīmekļa vietnes (adx_website) ieraksta atribūtiem portālā. Papildinformācija: tīmekļa vietne

ads

Nodrošina iespēju piekļūt un atveidot reklāmu.

Objekts ads ļauj jums izvēlēties konkrētu reklāmu vai reklāmas novietojumu:

<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>

Reklāmu atribūti

Atribūts Apraksts
novietojumi Atgriež reklāmas novietojuma objektu.
[ad name or ID] Var piekļūt jebkurai reklāmai pēc nosaukuma vai Id rekvizītiem.
{% assign ad = ads[Ad Name] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Reklāmas novietojuma atribūti

Atribūts Apraksts
[reklāmas novietojuma name nosaukuma vai ID] Var piekļūt jebkuram reklāmas novietojumam pēc nosaukuma vai Id rekvizītiem.
{% assign placement = ads.placements[Placement Name or Id] %}
{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Reklāmas novietojuma atribūti

Reklāmas novietojums ir tabulas objekts ar vienādiem vispārējiem atribūtiem un tālāk minētajiem atribūtiem.

Atribūts Apraksts
Reklāmas Atgriež reklāmas objektu kolekciju, kas ir saistīta ar izvietojumu. Šajā kolekcijā var izmantot iterācijas atzīmes un masīva filtrus.
Nosaukums/vārds Atgriež lauka nosaukumu reklāmas novietojumam.
placement_url URL, ko var izmantot, lai izgūtu reklāmas novietojumu, ko pilnībā atveido veidne.
random_url URL, ko var izmantot, lai izgūtu nejaušu reklāmu no novietojumu, ko pilnībā atveido veidne.

Reklāmas atribūti

Piezīme

Reklāma ir entītijas objekts ar tādiem pašiem atribūtiem (vēl papildus tiem, kas uzskaitīti zemāk).

Atribūts Apraksts
ad_url URL, ko var izmantot, lai izgūtu reklāmu, ko pilnībā atveido veidne.
Copy Atgriež reklāmai lauku Kopēt.
image Atgriež reklāmai attēla objektu (ja tādi ir).
Nosaukums/vārds Atgriež reklāmai lauku Nosaukums.
open_in_new_window Atgriež vērtību Patiess, ja vietrādis URL, kas ir norādīts ar redirecturl, jāatver jaunā logā.
redirect_url URL, uz kuru tiks novirzīti lietotāji, atlasot reklāmu.

Reklāmas attēla atribūti

Atribūts Apraksts
alternate_text Atgriež tekstu, kam jābūt redzamam taga alt atribūtā.
height Atgriež attēla augstumu pikseļos
url Atgriež attēla URL avotu.
width Atgriež attēla platumu pikseļos

blogs

Nodrošina iespēju piekļūt emuāriem un emuāru ierakstiem un atveidot tos.

Objekts blogs ļauj jums atlasīt konkrētu emuāru vai emuāra ierakstu.

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

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

<div class=panel-heading>

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

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

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

<h4>

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

{{ snippet.adx_value }}

</h4>

</div>

<ul class=list-group>

{% for post in posts.all %}

<li class=list-group-item >

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

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

</a>

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

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

</h4>

<div class=content-metadata>

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

&ndash;

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

&ndash;

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

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

</a>

</div>

</li>

{% endfor %}

</ul>

</div>

Objekts blogs

Objekts blogs ļauj piekļūt jebkuram konkrētam emuāram portālā vai piekļūt visiem emuāru ierakstiem portālā.

Tālāk esošajā tabulā ir aprakstīti atribūti, kas saistīti ar objektu blogs.

Atribūts Apraksts
posts Atgriež objektu blogposts, kas satur visus emuāru ierakstus portālā.
[emuāra nosaukums vai ID] Varat piekļūt jebkuram emuāram pēc nosaukuma vai ID rekvizītiem. 
{% assign blog = blogs["Blog Name"] %}                             

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

Objekts blog

Objekts blog ļauj strādāt ar vienu emuāru, kas ļauj jums piekļūt šī emuāra ierakstiem.

Tālāk esošajā tabulā ir aprakstīti dažādi atribūti, kas saistīti ar objektu blog.

Atribūts Apraksts
posts Atgriež objektu blogposts, kas satur visus šī emuāra ierakstus.
Name Emuāra nosaukums.
title Emuāra virsraksts.
url Emuāra vietrādis URL.

Objekts blogposts

Objekts blogposts ļauj piekļūt emuāru ierakstu objektu kolekcijai. Var izveidot emuāru ierakstu secību un lappušu numerāciju, kā arī izmantot Liquid filtrus:

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

Citas iespējamās opcijas:

  • blogs.posts.all (lai iegūtu visus emuāra ierakstus)
  • blogs.posts | from\_index: 0 | take: 2

Tālāk esošajā tabulā ir aprakstīti dažādi atribūti, kas saistīti ar objektu blogposts.

Atribūts Apraksts
All Atgriež visus blogpost objektus kolekcijā.

Objekts blogpost

Attiecas uz vienu emuāra ierakstu.

Tālāk esošajā tabulā ir aprakstīti dažādi atribūti, kas saistīti ar objektu blogpost.

Atribūts Apraksts
url Ieraksta vietrādis URL.
saturs Atgriež emuāra lauku Saturs.
author Atgriež ieraksta objektu autorus (kas ir vienkārši kontaktpersonas entītijas objekts.
nosaukums Emuāra virsraksts.
comment_count Atgriež konkrēta ieraksta komentāru skaitu kā veselu skaitli.
publish_date Datums, kurā ieraksts tika publicēts.

entities

Uzmanību

Lai izvairītos no iespējamām starpvietņu skriptēšanas (XSS) problēmām, vienmēr izmantojiet Izejas filtru, lai HTML kodētu virkņu datus ikreiz, kad izmantojat entītiju Liquid objektus, lai nolasītu lietotāja sniegtos neuzticamos datus.

Piezīme

Daži no Dataverse nosaukumdošanas nosacījumiem ir mainīti, piemēram, Dataverse entītijas tagad tiek sauktas par tabulām. Nosaukumu izmaiņas neattiecas uz Liquid objektiem. Liquid entītiju objekts turpmāk tiks saukts par entītijām.

Ļauj ielādēt jebkuru Dataverse entītiju pēc ID. Ja entītija pastāv, tiks atgriezts entītijas objekts. Ja entītija ar doto ID nav atrasta, tiek atgriezta vērtība nulle.

{% 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 %}

Elements

Entītijas objekts nodrošina piekļuvi Dataverse entītijas ieraksta atribūtiem.

Atribūts Apraksts
ID Entītijas GUID ID kā virkne. Piemēram, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Dataverse entītijas loģiskais nosaukums.
Notes Ielādē jebkuras piezīmes (annotation), kas saistītas ar entītiju, kārtojot tās no vecākās līdz jaunākajai (createdon). Piezīmes tiek atgrieztas kā piezīmes objekti.
atļaujas Ielādē Entītijas atļaujas apliecināšanas rezultātus entītijai. Rezultāti tiek atgriezti kā atļauju objekts.
url Atgriež Power Pages portālu satura pārvaldības sistēmas vietrāža URL ceļu entītijai. Ja entītijai nav derīga URL pašreizējā vietnē, atgriež vērtību nulle. Vispār, tas atgriezīs tikai vērtību noteiktiem entītiju tipiem, kas ir integrēti portāla CMS , ja vien neesat pielāgojis URL nodrošinātāju savā lietojumprogrammā.
[atribūta vai relāciju nosaukums] Jūs varat piekļūt jebkuram Dataverse entītijas atribūtam pēc loģiskā nosaukuma. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
Vairumam entītiju atribūtu vērtības kartē tieši uz Liquid tipiem: divu opciju lauki kartē uz Būla vērtībām, teksta lauki — uz virknēm, skaitliskie/valūtas lauki — uz skaitļiem, datuma/laika lauki — uz datumu objektiem. Taču daži atribūtu tipi tiek atgriezti kā objekti.
  • Uzmeklēšanas (saistītās tabulas atsauce) lauki tiek atgriezti kā saistītie tabulu atsauces objekti.
  • Opciju kopas/salasīšanas saraksta lauki tiek atgriezti kā opciju kopas vērtības objekti.
  • Visas saistītās entītijas var ielādēt pēc relācijas shēmas nosaukuma.
    • {{ page.adx_webpage_entitylist.adx_name }}Ja relācija ir refleksīva (t.i. attiecināta uz sevi), tiks atgriezts refleksīvas relācijas objekts. (Pretējā gadījumā vēlamais rezultāts būtu neskaidrs.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Piezīme: Daudzu saistīto entītiju ielāde vai piekļūšana lielam relāciju skaitam vienā veidnē var negatīvi ietekmēt veidnes atveidošanas veiktspēju. Izvairieties no saistīto entītiju ielādes katram vienumam masīvā cikla ietvaros. Ja iespējams, izmantojiet Dataverse entītiju atzīmes, lai ielādētu entītiju kolekcijas.

Saistītās tabulas atsauce

Uzmeklēšanas atribūtu vērtības tiek atgrieztas kā saistītās entītijas atsauces objekti ar sekojošiem atribūtiem.

Atribūts Apraksts
ID Atsauces entītijas GUID ID kā virkne.
Piemēram, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Dataverse atsauces entītijas loģiskais nosaukums.
Nosaukums/vārds Entītijas, uz kuru atsaucas, primārā nosaukuma atribūts.

Piezīme

Piezīme ir entītijas objekts, kas nodrošina piekļuvi atribūtiem un ieraksta anotācijas relācijām. Papildus visiem entītijas objekta atribūtiem, piezīmei ir šādi papildu atribūti.

Atribūts Apraksts
documentbody Ielādē piezīmes annotation ieraksta atribūtu documentbody kā Base64 kodēto virkni. Tā kā šī atribūta saturs var būt liels, tas netiek ielādēts kopā ar pārējiem piezīmes atribūtiem un tiek ielādēts tikai pēc pieprasījuma.
Piezīme. Atribūta pamata dokumenta izmantošana varētu negatīvi ietekmēt veidnes atveidošanas veiktspēju, un tas jāveic piesardzīgi.
Izmantojiet atribūtu url, lai tā vietā nodrošinātu saiti uz piezīmes pielikumu, ja iespējams.
url Atgriež URL ceļu iebūvētajam portāla anotācijas pielikuma apdarinātājam. Ja lietotājam ir atļauja, un piezīmei ir pievienots fails, pieprasījums uz šo URL lejupielādēs piezīmes faila pielikumu.

Piezīme

Papildu filtri

Opciju kopas vērtība

Opciju kopas/salasīšanas saraksta atribūtu vērtības tiek atgrieztas kā entītijas atsauces objekti ar sekojošiem atribūtiem.

Atribūts Apraksts
Label Opciju kopas/salasīšanas saraksta atribūta vērtības lokalizēta etiķete. Piemēram, Aktīvs
Value Opciju kopas/salasīšanas saraksta atribūta vērtības vesela skaitļa vērtība. Piemēram, 0

Tabulas atļaujas

Entītijas atļauju objekts nodrošina piekļuvi apkopotiem atļaujas apliecināšanas rezultātiem entītijai.

Atribūts Apraksts
can_append Atgriež vērtību Patiess, ja pašreizējam lietotājam ir atļauts pievienot ierakstus šī ieraksta relācijām. Citādi atgriež vērtību Aplams.
can_append_to Atgriež vērtību Patiess, ja pašreizējam lietotājam ir atļauts pievienot šo ierakstu citas entītijas relācijai. Citādi atgriež vērtību Aplams.
can_create Atgriež vērtību Patiess, ja pašreizējam lietotājam ir atļauts izveidot šī entītijas tipa jaunus ierakstus. Citādi atgriež vērtību Aplams.
can_delete Atgriež vērtību Patiess, ja pašreizējam lietotājam ir atļauts dzēst šo ierakstu. Citādi atgriež vērtību Aplams.
can_read Atgriež vērtību Patiess, ja pašreizējam lietotājam ir atļauts lasīt šo ierakstu. Citādi atgriež vērtību Aplams.
can_write Atgriež vērtību Patiess, ja pašreizējam lietotājam ir atļauts atjaunināt šo ierakstu. Citādi atgriež vērtību Aplams.
rules_exist Atgriež vērtību Patiess, ja atļaujas rezultāti, ko pārstāv šis objekts, ir tieši definētu atļaujas noteikumu rezultāts. Atgriež vērtību Aplams, ja tie ir noklusējuma rezultāti, kad nav tieši definēto atļauju.

Refleksīva relācija

Mēģinājumi ielādēt refleksīvas (t.i. attiecinātas uz sevi) relācijas uz entītijām tiek atgriezti kā objekti ar sekojošiem atribūtiem.

Atribūts Apraksts
is_reflexive Atgriež vērtību Patiess. Var izmantot, lai testētu, vai objekts, ko atgriež relācija, ir refleksīvas relācijas objekts.
referenced Atgriež entītiju, uz kurām atsaucas, masīvu dotajai relācijai.
referencing Atgriež entītiju, uz kuru atsaucas, dotajai relācijai. Atgriež vērtību nulle, ja entītija, uz kuru atsaucas, neeksistē. Ja ir relācija daudzas pret daudzām (N:N), atgriež entītiju, uz kurām atsaucas, masīvu.

elementu saraksts

Entītiju saraksta objekts tiek lietots Dataverse entītiju atzīmēs. Tas nodrošina piekļuvi visiem attiecīgā entītiju saraksta atribūtiem.

Piezīme

Atveidot vienību sarakstu, kas ir saistīts ar esošo lapu

Atribūti

Piezīme

entītijas

Atribūts Apraksts
create_enabled Atgriež vērtību Patiess, ja entītiju sarakstam ir konfigurēta jaunu ierakstu izveidošana. Citādi atgriež vērtību Aplams.
create_url Atgriež konfigurēto vietrāža URL ceļu entītiju saraksta izveides saitei/pogai.
detail_enabled Atgriež vērtību Patiess, ja entītiju sarakstam ir konfigurēts detalizēts skats atsevišķiem ierakstiem. Citādi atgriež vērtību Aplams.
detail_id_parameter Atgriež vaicājuma virknes parametra nosaukumu, ko izmantot ieraksta ID, kad tiek veidots ieraksta detalizētā skata vietrādis URL. Papildinformāciju par Liquid filtru lietošanu, lai veidotu vietrāžus URL, skatiet sadaļā URL filtri. Piemēram, ID
detail_label Atgriež konfigurēto lokalizēto etiķeti entītiju saraksta detalizētā skata saitēm/pogām.
detail_url Atgriež konfigurēto vietrāža URL ceļu entītiju saraksta detalizētā skata saitēm/pogām.
empty_list_text Atgriež konfigurēto lokalizēto tekstu, kas jāparāda, ja entītiju saraksta skats neatgriež nekādus rezultātus.
enable_entity_permissions Atgriež vērtību Patiess, ja šim entītiju sarakstam ir iespējota filtrēšana Entītijas atļauja. Citādi atgriež vērtību Aplams.
entity_logical_name Atgriež Dataverse entītijas loģisko nosaukumu ierakstiem, kurus rādīt pēc šī entītiju saraksta. Piemēram, contact
filter_account_attribute_name Atgriež atribūta loģisko nosaukumu uzmeklēšanai kontā, kas tiks lietots, lai rezultātu ierakstus filtrētu pēc pašreizējā portāla lietotāja galvenā uzņēmuma. Piemēram, konta ID
filter_apply_label Atgriež konfigurēto lokalizēto etiķeti, ko izmantot saitei/pogai, kura entītiju saraksta rezultātiem lieto papildu atribūtu filtru.
filter_definition Atgriež JSON atribūtu filtra definīciju entītiju sarakstam. Papildinformāciju par to, kā lietot Liquid filtru metafilters, lai apstrādātu šo definīciju, skatiet rakstā Entītiju saraksta filtri.
filter_enabled Atgriež vērtību Patiess, ja entītiju sarakstam ir iespējota papildu atribūtu filtrēšana. Citādi atgriež vērtību Aplams.
filter_portal_user_attribute_name Atgriež atribūta loģisko nosaukumu kontaktpersonas uzmeklēšanai, kas tiks lietota, lai rezultātu ierakstus filtrētu pēc pašreizējā portāla lietotāja kontaktpersonas. Piemēram, kontaktpersonas ID
filter_website_attribute_name Atgriež atribūta loģisko nosaukumu uzmeklēšanai uz adx_website, kas tiks lietots, lai rezultātu ierakstus filtrētu pēc pašreizējās portāla vietnes. Piemēram, adx_websiteid
language_code Atgriež Dataverse veselo skaitļu valodas kodu, kas tiks lietots, lai atlasītu visas lokalizētās etiķetes šim entītiju sarakstam.
page_size Atgriež konfigurēto rezultātu lapas lielumu entītiju sarakstam.
primary_key_name Atgriež primārās atslēgas atribūta loģisko nosaukumu ierakstiem, kurus rādīt pēc šī entītiju saraksta.
search_enabled Atgriež vērtību Patiess, ja šim entītiju sarakstam ir iespējota meklēšana. Citādi atgriež vērtību Aplams.
search_placeholder Atgriež konfigurēto lokalizēto tekstu entītiju saraksta meklēšanas lauka vietturim.
search_tooltip Atgriež konfigurēto lokalizēto tekstu entītiju saraksta meklēšanas rīka padomam.
skati Atgriež entītiju sarakstam pieejamos skatus kā entītiju saraksta skata objektus.
[atribūta loģiskais nosaukums] Jebkuram entītiju saraksta (adx_entitylist) Dataverse ieraksta atribūtam varat piekļūt pēc loģiskā nosaukuma, tāpat kā entītijas objektam. Piemēram, {{ entitylist.adx_name }}

Saraksts Skatīt atribūtus

Atribūts Apraksts
kolonnas Atgriež skata kolonnas kā entītiju saraksta skata kolonnas objektus.
entity_logical_name Atgriež Dataverse entītijas loģisko nosaukumu skatā iekļautajiem ierakstiem. Piemēram, contact
ID Atgriež skata GUID ID.
language_code Atgriež Dataverse veselo skaitļu valodas kodu, kas tiks lietots, lai skatā atlasītu visas lokalizētās etiķetes (kolonnu virsrakstus un citas)
Nosaukums/vārds Atgriež skata Dataverse parādāmo nosaukumu.
primary_key_logical_name Atgriež Dataverse entītijas primārās atslēgas loģisko nosaukumu skatā iekļautajiem ierakstiem. Piemēram, kontaktpersonas ID
sort_expression Atgriež skata noklusējuma kārtošanas izteiksmi. Piemēram, nameASC, createdon DESC.

Entītiju saraksta skata kolonnas atribūti

Atribūts Apraksts
attribute_type Atgriež Dataverse atribūta tipa nosaukumu kolonnai kā virkni. Piemēram, Lookup, Picklist, String, Boolean, DateTime
logical_name Atgriež Dataverse atribūta loģisko nosaukumu kolonnai. Piemēram, createdon
Name Atgriež lokalizēto Dataverse parādāmo nosaukumu kolonnai. Piemēram, Created On
sort_ascending Atgriež kārtošanas izteiksmes virkni kolonnu kārtošanai augošā secībā. Piemēram, createdon ASC
sort_descending Atgriež kārtošanas izteiksmes virkni kolonnu kārtošanai dilstošā secībā. Piemēram, createdon DESC
sort_disabled Atgriež vērtību Patiess, ja kolonnai ir atspējota kārtošana. Citādi atgriež vērtību Aplams.
sort_enabled Atgriež vērtību Patiess, ja kolonnai ir iespējota kārtošana. Citādi atgriež vērtību Aplams.
width Atgriež konfigurēto kolonnas platumu, izteiktu pikseļos.

entityview

Objekts entityview tiek izmantots tagā entityview un nodrošina piekļuvi skata metadatiem, kā arī skata rezultātu ierakstiem.

Atribūti

Atribūts Apraksts
kolonnas Atgriež skatā esošās kolonnas kā entītijas skata kolonnas objektus.
entity_permission_denied Atgriež vērtību Patiess, ja tika liegta piekļuve skatīt rezultātus saistībā ar nepietiekamām entītijas atļaujām pašreizējam lietotājam. Atgriež vērtību Aplams, ja tika piešķirta lasīšanas piekļuve, lai skatītu rezultātus.
entity_logical_name Skata rezultāta ierakstu Dataverse entītijas loģiskais nosaukums. Piemēram, contact
first_page Skata rezultātu pirmās lapas numurs. Tas būs 1, ja vien netika atgriezti nekādi rezultāti. Tādā gadījumā vērtība būs null.
Id Dataverse skata GUID ID, kas definē šo entityview.
language_code Dataverse veselo skaitļu valodas kods tiek izmantots, lai ielādētu lokalizētas etiķetes pašreizējam skatam.
last_page Skata rezultātu pēdējās lapas numurs. Ja netika atgriezti nekādi rezultāti, vērtība būs null.
name Dataverse skata nosaukums, kas definē šo entityview., piemēram, Aktīvās kontaktpersonas.
next_page Skata rezultātu nākamās lapas numurs. Ja nākamajā lapā nav rezultātu, tad vērtība būs nulle.
Lapa Skata rezultātu pašreizējās lapas numurs.
lapas Atgriež lapu numuru masīvu, kas satur visas pašreizējā skata rezultātu lapas.
page_size Pašreizējā skata atgriezto rezultātu skaits katrā lapā.
previous_page Skata rezultātu nākamās lapas numurs. Ja iepriekšējā lapā nav rezultātu, vērtība būs null.
primary_key_logical_name Dataverse loģiskais nosaukums, kas ir piešķirts šī skata rezultāta entītijas primārajam atslēgas atribūtam. Piemēram, contactid.
ieraksti Pašreizējā rezultātu lapa skatam kā entītijas objekti.
sort_expression Skata noklusējuma kārtošanas izteiksme. Piemēram, nameASC, createdon DESC.
total_pages Kopējais skata rezultātu lapu skaits.
total_records Kopējais skata rezultātu skaits (visās lapās).

events

Nodrošina iespēju piekļūt notikumiem un atveidot tos. Objekts events ļauj izvēlēties konkrētu notikumu vai visus notikumus.

Objekts events

Objekts events ļauj piekļūt jebkuram konkrētam notikumam portālā vai piekļūt visiem notikumiem portālā (neatkarīgi no notikuma).

Objektam events ir šādi atribūti:

Atribūts Apraksts
occurences Atgriež objektu eventoccurancessobject, kas satur visus notikuma gadījumus portālā
[event name or id] Varat piekļūt jebkuram notikumam pēc nosaukuma vai ID rekvizītiem.
{% assign event = events["Event Name"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Objekts event

Objekts event ļauj strādāt ar vienu notikumu, ļaujot jums piekļūt šī notikuma grafikiem un gadījumiem.

Objektam event ir šādi atribūti:

Atribūts Apraksts
gadījumi Atgriež objektu eventoccurrencesobject, kas satur visus notikuma gadījumus.
name Notikuma nosaukums.
url Notikuma URL.

Objekts eventoccurences

Objekts eventoccurences ļauj piekļūt notikuma gadījumu objektu kolekcijai. Notikuma gadījumus var sakārtot un var norādīt izgūstamo gadījumu datumu diapazonu, kā arī izmantot lapdali un nestingros filtrus

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

ņemiet vērā, ka

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

ir arī iespējams.

Tālāk minētie atribūti ir saistīti ar objektu eventoccurrences

Atribūts Apraksts
All Atgriež visus objektus eventoccurance kolekcijā.

Objekts eventoccurence

Pārstāv vienu notikuma gadījumu. Tālāk doti saistītie atribūti:

Atribūts Apraksts
url Gadījuma URL.
is_all_day_event Vai tas ir visas dienas notikums?
start_time Notikuma sākuma laiks.
end_time Notikuma beigu laiks.

forloop

Ietver rekvizītus, kas ir noderīgi for cikla blokā.

Piezīme

Atribūtu forloop var izmantot tikai tagā for.

Kods

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

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

{% endif %}

{% endfor %}

Izvade

This is the first child page!

This is child page number 2.

This is child page number 3.

Atribūti

Atribūts Apraksts
first Atgriež vērtību Patiess, ja tas ir cikla pirmais atkārtojums. Atgriež vērtību Aplams, ja tas nav cikla pirmais atkārtojums.
index Pašreizējā vienuma pozīcija kolekcijā, kur pirmajam vienumam ir pozīcija 1.
index0 Pašreizējā vienuma pozīcija kolekcijā, kur pirmajam vienumam ir pozīcija 0.
Pēdējais Atgriež vērtību Patiess, ja tas ir cikla pēdējais atkārtojums. Atgriež vērtību Aplams, ja tas nav cikla pēdējais atkārtojums.
length Atgriež atkārtojumu skaitu ciklam ߝ, cik vienumu skaits kolekcijā atkārtojas.
rindex Vienumu skaits, kas atlicis ciklā (length - index), kur 1 ir pēdējā vienuma rādītājs.
rindex0 Vienumu skaits, kas atlicis ciklā (length - index), kur 0 ir pēdējā vienuma rādītājs.

forums

Nodrošina iespēju piekļūt forumiem un forumu pavedieniem un atveidot tos. Ņemiet vērā, ka iespēja izmantot Liquid, lai atveidotu foruma datus, attiecas arī uz ierakstiem, taču, lai izveidotu jaunu ierakstu vai pavedienu, ir jāizmanto ASP.NET vairāku darbību veidlapu lapas veidne ar iebūvētu minēto funkcionalitāti (piemēram, noklusējuma foruma pavediena un foruma ziņas lapas veidnes).

Objekts forums ļauj atlasīt forumu vai foruma pavedienus:

<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>

Objekts forums

Objekts forums ļauj piekļūt jebkuram konkrētam forumam portālā vai piekļūt visiem forumu pavedieniem portālā (neatkarīgi no foruma).

Objekts forum ļauj strādāt ar vienu forumu, kas ļauj jums piekļūt šī foruma pavedieniem.

Objekts forumthreads ļauj piekļūt objektu forumthread kolekcijai. Var izveidot foruma pavedienu secību un lappušu numerāciju, izmantojot arī Liquid filtrus.

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

Viens foruma pavediens

Objekts forumposts ļauj piekļūt objektu forumpost kolekcijai.

Atribūti

Atribūts Apraksts
threads Atgriež objektu forumthreads, kas satur visus objektus forumthread portālā.
All Atgriež visus objektus forum portālā. Ņemiet vērā, ka website.forums arī ir ekvivalents.
thread_count Atgriež pavedienu skaitu visā tīmekļa vietnē, kas izteikts kā vesels skaitlis.
post_count Atgriež ierakstu kopējo skaitu visā portālā, kas izteikts kā vesels skaitlis.
[foruma nosaukums vai ID] Varat piekļūt jebkuram forumam pēc nosaukuma vai ID rekvizītiem.
`{% assign forum = forums[Forum Name] %}
{% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Objekts forum

Atribūti

Piezīme

entītijas

Atribūts Apraksts
threads Atgriež objektu forumthreads, kas satur visus šī foruma pavedienus.
Nosaukums/vārds Foruma nosaukums.
thread_count Atgriež pavedienu skaitu attiecīgajā forumā, kas izteikts kā vesels skaitlis.
post_count Atgriež ierakstu kopējo skaitu visā forumā, kas izteikts kā vesels skaitlis.

Objekts forumthreads

Atribūti

Atribūts Apraksts
All Atgriež visus objektus forumthread kolekcijā.

Objekts forumthread

Atribūti

Piezīme

entītijas

Atribūts Apraksts
posts Atgriež objektu forumposts, kas satur visus foruma ierakstus attiecīgajam pavedienam.
author Atgriež pavediena objektu autoru (kas ir vienkārši kontaktpersonas entītijas objekts).
latest_post Atgriež pēdējo ierakstu pavedienā.
first_post Atgriež pirmo ierakstu pavedienā.
post_count Atgriež ierakstu skaitu attiecīgajā pavedienā, kas izteikts kā vesels skaitlis.
is_answered Vai uz pavedienu ir atbildēts vai nē?
is_sticky Vai attiecīgais pavediens ir piesprausts pavediens?

Objekts forumposts

Atribūti

Atribūts Apraksts
All Atgriež visus objektus forumthread kolekcijā.

Viens ierakstst forumā

Atribūti

Piezīme

entītijas

Atribūts Apraksts
author Atgriež ieraksta autoru (kas ir vienkārši kontaktpersonas entītijas objekts).
saturs Ieraksta saturs.
is_answer Vai šis ieraksts ir atbilde uz pavedienu?

knowledge

Nodrošina piekļuvi Dataverse objektam knowledgearticle un kategoriju entītiju ierakstiem, lai portālā atveidotu rakstus un kategorijas.

Atribūti

Atribūts Apraksts
articles Atgriež objektu articles, kurā ir ietverti portālā pieejamo objektu knowledgearticle entītiju ierakstu ziņu objekti.
categories Atgriež objektu kategorijas, kurā ir ietverti portālā pieejamo kategoriju entītiju ierakstu objekti entity.

Objekts articles

Objekts articles sniedz iespēju piekļūt objektu article kolekcijai. Varat sakārtot rakstus un lietot lappušu numerāciju, izmantojot nestingros filtrus.

{% 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 %}

Atribūti

Atribūts Apraksts
popular Atgriež to objektu article kolekciju, kuriem ir visvairāk skatījumu. {% assign popular_articles = knowledge.articles.popular %}
recent Atgriež to objektu article kolekciju, kuriem ir visagrākais izmaiņu datums. {% assign recent_articles = knowledge.articles.recent %}
top Atgriež to objektu article kolekciju, kuriem ir visaugstākais novērtējums. {% assign top_articles = knowledge.articles.top %}

Filtri

Tālāk norādītajiem filtriem var lietot izvēles lapas lieluma un valodas parametrus. Pirmais parametrs ir izgūstamo ierakstu skaits. Noklusējuma lapas lielums ir 5. Otrais parametrs ir valodas kods, kas sniedz iespēju izgūtu rakstus noteiktā valodā. Filtrus var lietot kopā ar citiem Liquid filtriem.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Atribūts Apraksts
popular Atgriež to objektu article kolekciju, kuriem ir visvairāk skatījumu. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
recent Atgriež to objektu article kolekciju, kuriem ir visagrākais izmaiņu datums. {% assign recent_articles = knowledge.articles \| recent: 5 %}
top Atgriež to objektu article kolekciju, kuriem ir visaugstākais novērtējums. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

Objekts categories

Objekts categories sniedz iespēju piekļūt objektu category kolekcijai. Varat sakārtot kategorijas un lietot lappušu numerāciju, izmantojot Liquid filtrus.

{% 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 %}

Atribūti

Atribūts Apraksts
recent Atgriež to objektu category kolekciju, kuriem ir visagrākais izmaiņu datums.
top_level Atgriež to objektu category kolekciju, kuriem nav galvenās kategorijas.

Filtri

Tālāk norādītajiem filtriem var lietot izvēles parametru, kas norāda lapas lielumu. Noklusējuma lapas lielums ir 5. Filtrus var lietot kopā ar citiem Liquid filtriem.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Atribūts Apraksts
recent Atgriež to objektu category kolekciju, kuriem ir visagrākais izmaiņu datums. Varat nodrošināt parametrus {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level Atgriež to objektu category kolekciju, kuriem nav galvenās kategorijas. {% assign root_categories = knowledge.categories \| top_level %}

Objekts article

Objekts article sniedz iespēju strādāt ar vienu objektu knowledgearticle, lai portālā parādītu detalizētu informāciju par šo rakstu.

Atribūti

Objekts article ir objekta entity veids, kam ir visi tie paši atribūti, kā arī tālāk norādītie.

Atribūts Apraksts
article_public_number Raksta publiskais numurs.
comment_count Vesela skaitļa vērtība, kas norāda konkrētā raksta komentāru skaitu.
content Raksta saturs.
current_user_can_comment Atgriež Būla vērtību, kas norāda to, vai pašreizējais lietotājs var pievienot komentārus rakstam.
is_rating_enabled Atgriež Būla vērtību, kas norāda to, vai rakstam ir iespējota vērtēšana.
keywords Raksta atslēgvārdi.
name Aizstājnosaukums, ko var lietot raksta nosaukuma vietā.
rating Decimāldaļskaitļa vērtība, kas norāda raksta vērtējumu.
title Raksta nosaukums.
view_count Vesela skaitļa vērtība, kas norāda raksta skatījumu skaitu.

Objekts category

Objekts category sniedz iespēju strādāt ar vienu kategoriju, lai portālā parādītu detalizētu informāciju par to.

Atribūti

Objekts category ir objekta entity veids, kam ir visi tie paši atribūti, kā arī tālāk norādītie.

Atribūts Apraksts
categorynumber Kategorijas numurs.
name Aizstājnosaukums, ko var lietot kategorijas nosaukuma vietā.
Nosaukums Kategorijas nosaukums.

valoda

Nodrošina pašreizējo valodas nosaukumu un valodas kodu, ja ir iespējots vairāku valodu atbalsts.

Atribūti

Atribūts Apraksts
url Pašreizējais pieprasījuma URL, kas ir iepriekš noteikts, izmantojot pašreizējo valodas kodu.
url_substitution Pašreizējais pieprasījuma URL ir iepriekš noteikts, izmantojot pašreizējo valodas kodu, apejot lapas izvades kešatmiņu.
nosaukums/vārds, uzvārds Pašreizējās valodas nosaukums.
kods Tērzēšanas valodas valodas kods.

Piemēram, tīmekļa veidne Valodas nolaižamā izvēlne pēc noklusējuma izmanto šo Liquid objektu, lai uzskaitītu pieejamās valodas, kad ir pieejamas vairākas valodas.

Lapa

Atsaucas uz pašreizējo portāla pieprasījuma lapu. Šajā objektā ir apvienoti sitemap un pašreizējā pieprasījuma entities atribūti (parasti tīmekļa lapa).

Objekts page nodrošina pieeju tādiem elementiem kā, piemēram, pašreizējās lapas atpakaļceļi, pašreizējās lapas virsraksts vai URL, kā arī daudzi citi pamata Dataverse ieraksta atribūti vai saistītās entītijas.

<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 }}. -->

Lapas atribūti

Piezīme

entītijas

Atribūts Apraksts
breadcrumbs Atgriež atpakaļceļa vietnes kartes mezgla objektus attiecīgajai lapai, sākot no vietnes kartes saknes mezgla un beidzot ar galveno lapu.
children Atgriež lapas atvasinātās vietnes kartes mezgla objektus.
parent Atgriež lapas galvenās vietnes kartes mezglu. Ja lapa ir sākumlapa, objekta parent vērtība būs null.
nosaukums Lapas nosaukums.
url Lapas URL.
[atribūta vai relāciju nosaukums] Varat piekļūt lapas pamata Dataverse ieraksta jebkuram atribūtam pēc loģiskā nosaukuma.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
Vairumam entītiju atribūtu vērtības kartē tieši uz Liquid tipiem: divu opciju lauki kartē uz Būla vērtībām, teksta lauki — uz virknēm, skaitliskie/valūtas lauki — uz skaitļiem, datuma/laika lauki — uz datumu objektiem. Taču daži atribūtu tipi tiek atgriezti kā objekti.
  • Uzmeklēšanas (saistītās entītijas atsauce) lauki tiek atgriezti kā saistīto entītiju atsauces objekti.
  • Opciju kopas/salasīšanas saraksta lauki tiek atgriezti kā opciju kopas vērtības objekti.
    • Visas saistītās entītijas var ielādēt pēc relācijas shēmas nosaukuma.
    {{ page.adx_webpage_entitylist.adx_name }}
    Ja relācijas ir refleksīvas (t.i., ar atsauci uz sevi), tiek atgriezts objekts entities. (Pretējā gadījumā vēlamais rezultāts būtu neskaidrs.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Piezīme: Daudzu saistīto entītiju ielāde vai piekļūšana lielam relāciju skaitam vienā veidnē var negatīvi ietekmēt veidnes atveidošanas veiktspēju. Izvairieties no saistīto entītiju ielādes katram vienumam masīvā cikla ietvaros. Ja iespējams, izmantojiet Dataverse entītiju atzīmes, lai ielādētu entītiju kolekcijas.

aptaujas

Nodrošina iespēju piekļūt un atveidot aptauju.

Objekts aptaujas ļauj jums izvēlēties konkrētu aptauju vai aptaujas novietojumu:

<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>

Aptaujas atribūti

Atribūts Apraksts
novietojumi Atgriež aptaujas novietojuma objektu.
[aptaujas nosaukums vai ID] Var piekļūt jebkurai aptaujai pēc nosaukuma vai Id rekvizītiem. {% assign poll = polls[Poll Name] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Aptaujas novietojumu atribūti

Atribūts Apraksts
[aptaujas novietojuma nosaukums vai ID] Varat piekļūt jebkuram aptaujas novietojumam pēc nosaukuma vai ID rekvizītiem.{% assign placement = polls.placements[Placement Name or Id] %}
{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Aptaujas novietojuma atribūti

Piezīme

entītijas

Atribūts Apraksts
Nosaukums/vārds Atgriež lauka nosaukumu aptaujas novietojumam.
placement_url URL, ko var izmantot, lai izgūtu aptaujas novietojumu, ko pilnībā atveido veidne.
polls Atgriež aptaujas objektu kolekciju, kas ir saistīta ar izvietojumu. Šajā kolekcijā var izmantot iterācijas atzīmes un masīva filtrus.
random_url URL, ko var izmantot, lai izgūtu nejaušu aptauju no novietojumu, ko pilnībā atveido veidne.
submit_url URL, kurā tiek iesniegta aizpildītā aptauja.

Aptaujas atribūti

Piezīme

entītijas

Atribūts Apraksts
has_user_voted Atgriež vērtību Patiess, ja pašreizējais lietotājs (pieteicies vai anonīms) jau ir balsojis šajā aptaujā.
Name Atgriež nosaukuma lauku attiecīgajai aptaujai.
options Atgriež aptaujas opciju objektu kolekciju, kas ir saistīta ar aptauju. Šajā kolekcijā var izmantot objektus iterācijas atzīmes un entītijas.
poll_url URL, ko var izmantot, lai izgūtu aptauju, ko pilnībā atveido veidne.
question Atgriež jautājuma lauku attiecīgajai aptaujai.
Iesniegšanas pogas etiķete Atgriež virkni, ko var izmantot, lai pārlabotu iesniegšanas pogas etiķeti attiecīgajai aptaujai.
submit_url URL, kurā tiek iesniegta aizpildītā aptauja.
user_selected_option Atgriež aptaujas opciju objektu, ko atlasījis lietotājs (ja tas jau ir nobalsojis).
votes Atgriež balsu skaitu, kas ir tabulēts attiecīgajai aptaujai.

Aptaujas opciju atribūti

Piezīme

entītijas

Atribūts Apraksts
atbilde Atgriež atbildes lauku attiecīgajai aptaujai.
procenti Atgriež balsu procentuālo vērtību aptaujā attiecīgajai opcijai kā decimāldaļskaitļi no 0 līdz 100.
balsis Atgriež balsu skaitu, kas ir tabulēts attiecīgajai opcijai.

pieprasījums

Satur informāciju par pašreizējo HTTP pieprasījumu.

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

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

Piezīme

  • Jūs varat veidot URL dinamiski Liquid, izmantojot URL filtrus.
  • Izmantotais URL request.url var būt jebkura pieprasīta vērtība, un tā tiek kešota turpmākajiem pieprasījumiem. Lai nodrošinātu pareizu vērtību request.url, apsveriet iespēju izmantot aizstāšanas tagu, daļēju URL, piemēram, ~{tīmekļa faila ceļu} vai glabāt portāla URL Vietnes iestatījumos.
  • Power Pages portālu laidiena versijā 9.3.8.x vai jaunākā pēc noklusējuma ir iespēja izlaist Liquid filtru, kas iespējots lietotājam, un pieprasīt Liquid objektus. Lai atspējotu šo noklusējuma konfigurāciju un atļautu šos Liquid objektus bez Liquid filtra izlaišanas, skatiet sadaļu portāla vietnes iestatījumi - Site/EnableDefaultHtmlEncoding.

Atribūti

Atribūts Apraksts
params Nosaukto parametru vērtības pašreizējam pieprasījumam. Objekts params ir URL vaicājuma virknes parametru, veidlapas ierakstu parametru un sīkfailu kombinācija.
Path Pašreizējā pieprasījuma URL ceļš.
/profile/
path_and_query Pašreizējā pieprasījuma URL ceļš un vaicājums.
/profile/?foo=1&bar=something
vaicājums Pašreizējā pieprasījuma URL vaicājuma daļa.
?foo=1&bar=something
url Pašreizējā pieprasījuma pilns URL.
https://www.example.com/profile/?foo=1&bar=something

searchindex

Objekts searchindex tiek izmantots Dataverse entītiju atzīmju ietvaros, un nodrošina piekļuvi vaicājuma rezultātiem.

{% 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 %}

Atribūti

Atribūts Apraksts
approximate_total_hits Atgriež aptuvenu kopējo trāpījumu skaitu, kas atbilst vaicājumu indeksam. Ņemot vērā veidu, kādā darbojas meklēšanas rādītājs attiecībā uz drošības filtrēšanu un citiem noformējuma faktoriem, šis skaitlis ir tikai aptuvens, un pašreizējam lietotājam dažās situācijās var neatbilst rezultātu kopskaitam.
Lapa Atgriež pašreizējā vaicājuma lapas numuru.
page_size Atgriež pašreizējā vaicājuma lapas maksimālo izmēru. Ja vēlaties, lai pašreizējā lapā tiktu atgriezts faktiskais rezultātu skaits (jo tas var būt mazāks par norādīto maksimāli pieļaujamo lapas izmēru), izmantojiet results.size.
rezultāti Atgriež vaicājuma rezultātu lapu kā meklēšanas rādītāja rezultātu objektus.

Meklēšanas rādītāja rezultāti

Atribūts Apraksts
entītija Pamata entītijas attiecīgajam rezultātam.
fragments Atbilstošs īss teksta fragments rezultātam ar nosacījumiem, kuri atbilst norādītajam vaicājumam, kas ir izcelts, izmantojot HTML tagu <em>. Dažu tipu vaicājumi neatbalsta izceltus fragmentus, piemēram, aptuvenos vaicājumus (~) un aizstājējzīmes vaicājumus (*). Šis rekvizīts šajos gadījumos būs null.
ID Rezultāta pamata ieraksta kā virknes Dataverse entītijas ID. Piemēram, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Rezultāta pamata ieraksta Dataverse entītijas loģiskais nosaukums. Piemēram, adx_webpage
numurs Rezultātu skaits visās rezultātu lapās, sākot no 1. Piemēram, otrās rezultātu lapas pirmajam rezultātam ar lapas izmēru 10 šī vērtība būs 11.
rezultāts Rezultāta Lucene vērtība kā peldošā komata vērtība. Rezultāti tiks atgriezti, sakārtoti pēc šīs vērtības.
nosaukums Rezultāta nosaukums.
url Rezultāta URL. Parasti tas būs, bet ne vienmēr jābūt pašreizējās programmas absolūtam ceļam, nevis pilnam URL. Piemēram: /articles/article1/

iestatījumi

Ļauj jums ielādēt jebkuru vietnes iestatījumu pēc nosaukuma. Ja iestatījums ar šādu nosaukumu nav atrasts, tiek atgriezta vērtība null.

Piezīme

Iestatījumi tiek atgriezti kā virknes, bet varat izmantot tipu filtrus, lai tos konvertētu uz citiem tipiem.

{{ 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 %}

Piezīme

Tīmekļa vietnes galvenes un primārās navigācijas joslas atveide

vietnes karte

Ļauj piekļūt portāla vietnes kartei.

<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 %}

Vietnes kartes atribūti

Atribūts Apraksts
Esošais Atgriež vietnes kartes mezgla objektu pašreizējai lapai.
Sakne Atgriež vietnes kartes mezgla objektu attiecīgajai tīmekļa vietnes saknes lapai (sākumlapai).

Vietnes kartes mezgla atribūti

Atribūts Apraksts
Atpakaļceļa objekti Atgriež atpakaļceļa vietnes kartes mezgla objektus attiecīgajam mezglam, sākot no vietnes kartes saknes mezgla un beidzot ar galveno lapu.
Atvasinātie Atgriež mezgla atvasinātā vietnes kartes mezgla objektus.
Apraksts Mezgla apraksts/kopsavilkuma saturs. (Šis lauks var saturēt HTML).
Entītija Atgriež mezgla pamatā esošos objektus entities. Ja mezglam nav pamatā esošas entītijas, šī vērtība būs null.
is_sitemap_ancestor Atgriež vērtību Patiess, ja vietnes kartes mezgls ir pašreizējā mezgla priekštecis; citādi atgriež vērtību Aplams.
is_sitemap_current Atgriež vērtību Patiess, ja vietnes kartes mezgls ir pašreizējais mezgls; citādi atgriež vērtību Aplams.
Primārais Atgriež mezgla vecāko vietnes kartes mezglu. Ja mezgls ir saknes mezgls, objekta primārā vērtība būs null.
Nosaukums Mezgla nosaukums.
url Mezgla URL.

vietnes marķieri

Ļauj ielādēt jebkuru vietnes marķieri pēc nosaukuma. Ja vietnes marķieris pastāv, objekts tiks atgriezts. Ja atribūts vietnes karte ar šādu nosaukumu nav atrasts, tiek atgriezta vērtība 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 %}

Piezīme

Tīmekļa vietnes galvenes un primārās navigācijas joslas atveide

Vietnes marķiera atribūti

Atribūts Apraksts
url Vietnes marķiera mērķa URL.
[atribūta loģiskais nosaukums] Varat piekļūt vietnes marķiera mērķa Dataverse ieraksta jebkuram atribūtam pēc loģiskā nosaukuma. Piemēram, {{ sitemarker.adx_name }}

fragmenti

Ļauj ielādēt jebkura satura fragmentus pēc nosaukuma. Ja fragments ar šādu nosaukumu nav atrasts, tiek atgriezta vērtība null.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

entītijas rindas bloks

Ietver rekvizītus, kas ir noderīgi cikla blokā iterācijas atzīmes.

Piezīme

Atribūtu entītijas rindas bloks var izmantot tikai tagā Iterācijas atzīmes.

Atribūti

Atribūts Apraksts
Col Atgriež pašreizējās rindas rādītāju, sākot ar 1.
col0 Atgriež pašreizējās rindas rādītāju, sākot ar 0.
col_first Atgriež vērtību Patiess, ja pašreizējā kolonna ir pirmā kolonna rindā; citādi atgriež vērtību Aplams.
col_last Atgriež vērtību Patiess, ja pašreizējā kolonna ir pēdējā kolonna rindā; citādi atgriež vērtību Aplams.
Vārds Atgriež vērtību Patiess, ja tas ir cikla pirmais atkārtojums. Atgriež vērtību Aplams, ja tas nav cikla pirmais atkārtojums.
Index Pašreizējā vienuma pozīcija kolekcijā, kur pirmajam vienumam ir pozīcija 1.
index0 Pašreizējā vienuma pozīcija kolekcijā, kur pirmajam vienumam ir pozīcija 0.
Pēdējais Atgriež vērtību Patiess, ja tas ir cikla pēdējais atkārtojums. Atgriež vērtību Aplams, ja tas nav cikla pēdējais atkārtojums.
Garums Atgriež atkārtojumu skaitu ciklam ߝ, cik vienumu skaits kolekcijā atkārtojas.
Rindex Vienumu skaits, kas atlicis ciklā (length - index), kur 1 ir pēdējā vienuma rādītājs.
rindex0 Vienumu skaits, kas atlicis ciklā (length - index), kur 0 ir pēdējā vienuma rādītājs.

lietotājs

Atsaucas uz pašreizējo portāla lietotāju, atļaujot piekļuvi visiem pamata Dataverse kontaktpersonas ieraksta atribūtiem. Ja nav pierakstījies neviens lietotājs, šis mainīgais ir null.

Atribūts lietotājs ir objekts entītija.

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

Piezīme

Power Pages portālu laidiena versijā 9.3.8.x vai jaunākā pēc noklusējuma ir iespēja izlaist Liquid filtru, kas iespējots lietotājam, un pieprasīt Liquid objektus. Lai atspējotu šo noklusējuma konfigurāciju un atļautu šos Liquid objektus bez Liquid filtra izlaišanas, skatiet sadaļu portāla vietnes iestatījumi - Site/EnableDefaultHtmlEncoding.

Atribūti

Papildus visiem objekta entity atribūtiem lietotājam ir arī tālāk norādītie atribūti.

Atribūts Apraksts
lomas Atgriež lomas, kurām šis lietotājs pieder, kā masīvu.
{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}
Piezīme. Varat arī izmantot filtru has_role, lai testētu dalības atsevišķās lomās.
basic_badges_url Atgriež pakalpojuma vietrādi URL, lai izgūtu lietotāja žetonus.
Lai atveidotu žetonus kādam lietotājam, jums ir jāietver atzīme ar atribūtiem “data-badge” un “data-uri”. Lai atveidotu pašreizējā lietotāja žetonus, izpildiet tālāk aprakstītos norādījumus:
<div data-badge data-uri='{{user.basic_badges_url }}'></div>
Lai atveidotu lietotāja žetonus pēc ID (mainīgā userid):
`<div data-badge data-uri='{{user.basic_badges_url

Ļauj jums ielādēt jebkuru vērtību weblinks pēc nosaukuma vai ID.

Ja tīmekļa saišu kopa pastāv, tiek atgriezts tīmekļa saišu kopas objekts. Ja tīmekļa saišu kopa ar šādu nosaukumu vai ID nav atrasta, tiek atgriezta vērtība 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 %}

Piezīme

Tīmekļa lapas galvenes un primārās navigācijas joslas atveide |

Piezīme

Tīmekļa saišu kopa ir objekts entity, kam ir visi tie paši atribūti, kā arī tālāk norādītie.

Atribūts Apraksts
Kopija Tīmekļa saišu kopas HTML kopija
Nosaukums Tīmekļa saišu kopas nosaukums.
Nosaukums Tīmekļa saišu kopas virsraksts.
Tīmekļa saites Tīmekļa saišu objektu masīvs, kas ir saistīti ar tīmekļa saišu kopu.
[atribūta loģiskais nosaukums] Varat piekļūt tīmekļa saišu kopas Dataverse ieraksta jebkuram atribūtam pēc loģiskā nosaukuma. Piemēram, {{ weblinkset.createdon }}

Piezīme

Tīmekļa saite ir objekts entity, kam ir visi tie paši atribūti, kā arī tālāk norādītie.

Atribūts Apraksts
Apraksts Tīmekļa saites HTML apraksts.
display_image_only Būla atribūts, kas norāda, vai tīmekļa saite ir jāparāda tikai kā attēls bez saites teksta.
display_page_child_links Būla vērtības atribūts, kas norāda, vai tīmekļa saitei jānorāda saites uz saistītās lapas sitemap pakārtotajām lapām kā apakšsaites.
Attēls Tīmekļa saites attēla objekts šai saitei. Ja nav attēla, šis atribūts būs null.
is_external Būla atribūts, kas norāda, vai tīmekļa saites mērķa URL ir uz ārējo vietni (nevis uz iekšējo portāla lapu).
is_sitemap_ancestor Atgriež vērtību Patiess, ja tīmekļa saites URL atsaucas uz pašreizējās vietnes kartes mezgla priekšteci; citādi atgriež vērtību Aplams.
is_sitemap_current Atgriež vērtību Patiess, ja tīmekļa saites URL atsaucas uz pašreizējās vietnes kartes mezglu; citādi atgriež vērtību Aplams.
Nosaukums Tīmekļa saišu kopas nosaukums/virsraksts.
Nofollow Būla vērtības atribūts, kas norāda, vai tīmekļa saite jāmarķē kā rel=nofollow.
open_in_new_window Būla atribūts, kas norāda vai tīmekļa saiti jāatver jaunā pārlūkprogrammas logā/cilnē.
Rīka padoms Tīmekļa saites rīka padoma teksts.
url Tīmekļa saites URL.
Tīmekļa saites Pakārtoto tīmekļa saišu objektu masīvs, kas ir saistīti ar tīmekļa saiti.
[atribūta loģiskais nosaukums] Varat piekļūt tīmekļa saites Dataverse ieraksta jebkuram atribūtam pēc loģiskā nosaukuma. Piemēram, {{ weblink.createdon }}
alternate_text Attēla alternatīvais teksts.
Augstums Vesels skaitlis ar norādītā attēla augstumu. Ja netika norādīta augstuma vērtība, šis atribūts būs null.
url Attēla URL.
Platums Vesels skaitlis ar norādīto attēla platumu. Ja netika norādīta platuma vērtība, šis atribūts būs null.

tīmekļa vietne

Atsaucas uz portāla tīmekļa vietni, ļaujot piekļūt visiem Dataverse tīmekļa vietnes (adxwebsite) ieraksta atribūtiem attiecīgajam portālam.

Piezīme

Tīmekļa vietne ir objekts entity, un tam ir visi tie paši atribūti.

Kods

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

Izvade

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

Atribūti

Šajā tabulā ir uzskaitīti šī taga atribūti, ko var izmantot, aizstājot noklusējuma vērtības, lai izvairītos no kešdarbes.

Noklusētā vērtība Aizstāt (novērš kešdarbi) Piemērs
sign_in_url sign_in_url_substitution Noklusējums: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F
Aizstāšana (tiek novērsta kešdarbe): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F
(šajā piemērā "aizstājošā lapa" aizstāj noklusējuma kešoto URL.)
sign_out_url sign_out_url_substitution Noklusējums: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F
Aizstāšana (tiek novērsta kešdarbe): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F
(šajā piemērā "aizstājošā lapa" aizstāj noklusējuma kešoto URL.)

Skatiet arī

Liquid tipi
Liquid atzīmes
Liquid filtri