Pieejamie Liquid objekti
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 lietotne kešatmiņā saglabā šo vērtību, un tā netiek atsvaidzināta katru reizi. 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 neviens lietotājs nav pieteicies, šis mainīgais ir nulle. 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
Iespējo reklāmas izgūšanu un rādīšanu.
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 izvietojums ir tabulas objekts ar vienādiem vispārīgiem atribūtiem un tālāk norādī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 tagus 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 tabulas objekts ar visiem tiem pašiem atribūtiem papildus tālāk norādītajam.
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 lietotājs tiek novirzīts, 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. |
platums | Atgriež attēla platumu pikseļos |
blogs
Iespējo emuāru un emuāra ziņu izgūšanu un parādīšanu.
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>
–
<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>
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 tabula pastāv, tiek atgriezts tabulas objekts. Ja tabula ar norādīto ID netiek atrasta, tiek atgriezta vērtība Null .
{% assign account = entities.account['936DA01F-9ABD-4d9d-80C7-02AF85C822A8'] %}
{% if account %}
{{ account.name | escape }} ({{ account.statecode.label | escape }})
{% endif %}
{% assign entity_logical_name = 'contact' %}
{% assign contact = entities[entity_logical_name][request.params.contactid] %}
{% if contact %}
{{ contact.fullname | escape }} ({{ contact.parentcustomerid.name | escape }})
{% endif %}
Tabula
Entītijas objekts nodrošina piekļuvi tabulas ieraksta atribūtiem Dataverse .
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ē visas ar tabulu saistītās piezīmes (anotācija), kas sakārtotas no vecākās uz jaunāko (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. Parasti tas atgriež vērtību tikai noteiktiem tabulu tipiem, kas ir integrēti portāla SPS, ja vien savā lietojumprogrammā neesat pielāgojis URL nodrošinātāju. |
[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.
{{ page.adx_webpage_entitylist.adx_name }} Gadījumā, ja attiecības ir refleksīvas (tas ir, pašreferencējošas), tiek atgriezts refleksīvs attiecību objekts. (Pretējā gadījumā vēlamais rezultāts būtu neskaidrs.){{ page.adx_webpage_webpage.referencing.adx_name }} Piezīme: liela skaita saistīto entītiju ielāde vai piekļuve 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 tabulas 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īmju atribūtiem, tas tiek ielādēts tikai pēc pieprasījuma. Piezīme: atribūta documentbody izmantošana var negatīvi ietekmēt veidnes atveidošanas veiktspēju, un tas jādara 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, pieprasot šo vietrādi URL, tiek lejupielādēts piezīmju faila pielikums. |
Piezīmes
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ž aplamus, ja tie ir noklusējuma rezultāti, ja nav skaidri definētu 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.
Atribūti
Piezīme
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ž konta uzmeklēšanas atribūta loģisko nosaukumu, kas tiek izmantots, lai filtrētu rezultātu ierakstus pēc pašreizējā portāla lietotāja galvenais uzņēmums. 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ž uzmeklēšanas kontaktpersonas atribūta loģisko nosaukumu, kas tiek izmantots, lai filtrētu rezultātu ierakstus pēc pašreizējā portāla lietotāja kontaktpersonas. Piemēram, kontaktpersonas ID |
filter_website_attribute_name | Atgriež uzmeklēšanas atribūta loģisko nosaukumu adx_website, kas tiek izmantots rezultātu ierakstu filtrēšanai pēc pašreizējās portāla tīmekļa 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 vesela skaitļa valodas kodu, kas tiek izmantots, lai skatam atlasītu visas lokalizētās etiķetes (kolonnu galvenes utt.). |
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 ir 1, ja vien nav atgriezti rezultāti, un tādā gadījumā tas ir nulle. |
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 rezultāti netika atgriezti, šī vērtība ir nulle. |
nosaukums/vārds, uzvārds | Dataverse skata nosaukums, kas definē šo entityview., piemēram, Aktīvās kontaktpersonas. |
next_page | Skata rezultātu nākamās lapas numurs. Ja nav nākamās rezultātu lapas, šī vērtība ir Null. |
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 nav iepriekšējās rezultātu lapas, tā ir nulle. |
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
Iespējo notikumu izgūšanu un parādīšanu. 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 |
---|---|
gadījumi | 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. Varat pasūtīt notikumu atgadījumus un norādīt datumu diapazonu, no kura atgūstamie gadījumi, kā arī panākt lapošanu, izmantojot šķidruma filtrus:
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
Ir iespējama arī šāda iespēja:
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
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. Saistītie atribūti ir šādi:
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 %}
Izvades
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
Iespējo forumu un forumu pavedienu izgūšanu un parādīšanu. Ņ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
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
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
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 kombinēt ar citiem šķidruma 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 kombinēt ar citiem šķidruma 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
Raksts ir entītijas objekts ar visiem tiem pašiem atribūtiem papildus šādiem atribūtiem:
Atribūts | Apraksts |
---|---|
article_public_number | Raksta publiskais numurs. |
comment_count | Vesela skaitļa vērtība skaitam, cik komentāru ir konkrētam rakstam. |
saturs | 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 tam, cik reižu raksts tika skatīts. |
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
Kategorija ir entītijas objekts ar visiem tiem pašiem atribūtiem papildus šādiem atribūtiem:
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.
Žurnāla
Veidotājiem ir iespēja iekļaut žurnāla paziņojumus savā šķidruma kodā. Kad Power pages vietne darbojas, žurnāli, ko šķidrā kodā pievienojis veidotājs, tiek parādīti izstrādātāja rīka paplašinājumā Power Pages . Šie žurnāli, ko iegulst veidotājs, tiek parādīti izstrādātāja rīka paplašinājumā, kad ir iespējots diagnostikas iestatījums .
Tālāk norādīto sintaksi var izmantot šķidrajā kodā, lai reģistrētu pielāgotus ziņojumus:
{% log message:'Custom message' level:'Warning' %}
Žurnāla atribūti
Atribūts | Apraksts |
---|---|
Žurnāla | Šķidrā objekta nosaukums |
ziņojums | Virkne, kas attēlo visus pielāgotos ziņojumus, lai reģistrētu |
līmenis | Reģistrējiet ziņojumu kā informāciju, brīdinājumu vai kļūdu |
Piemērs:
{% log message: 'Log from Home page' %}
{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}
{% assign contacts = query.results.entities %}
{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %}
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}
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
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, vecākelements ir nulle. |
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.
{{ page.adx_webpage_entitylist.adx_name }} Gadījumā, ja attiecības ir refleksīvas (tas ir, pašreferencējošas), tiek atgriezts entītijas objekts. (Pretējā gadījumā vēlamais rezultāts būtu neskaidrs.) {{ page.adx_webpage_webpage.referencing.adx_name }} Piezīme: liela skaita saistīto entītiju ielāde vai piekļuve 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
Iespējo aptaujas izgūšanu un parādīšanu.
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
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 tagus 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
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. Ar šo kolekciju var izmantot iterācijas tagus 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ž lietotāja atlasīto polloption objektu (ja viņš jau ir balsojis). |
balsis | Atgriež aptaujas tabulā norādīto balsu skaitu. |
Aptaujas opciju atribūti
Piezīmes
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ž opciju tabulā norādīto balsu skaitu. |
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ā to, kā meklēšanas indekss darbojas attiecībā uz drošības filtrēšanu un citiem dizaina faktoriem, šis skaitlis ir tikai tuvinājums un dažās situācijās var precīzi neatbilst kopējam pašreizējam lietotājam pieejamo rezultātu skaitam. |
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 tiktu atgriezts faktiskais pašreizējās lapas rezultātu skaits (jo tas var būt mazāks par norādītajiem maksimālajiem lappuses izmēriem), 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>. Noteikti vaicājumu tipi neatbalsta iezīmētos fragmentus, piemēram, izplūdušus vaicājumus (~) un aizstājējzīmju vaicājumus (*). Šādos gadījumos šī īpašība nav spēkā. |
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, rezultātu otrās lapas pirmajam rezultātam, kura lappuses izmērs ir 10, šī vērtība ir 11. |
rezultāts | Rezultāta Lucene vērtība kā peldošā komata vērtība. Rezultāti tiek atgriezti secībā 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 %}
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. (Šajā laukā var būt HTML.) |
Tabula | Atgriež mezgla pamatā esošos objektus entities. Ja mezglam nav pamatā esošās tabulas, šī vērtība ir nulle. |
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, vecākelements ir nulle. |
Amats | 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, tiek atgriezts vietnes marķiera objekts. Ja vietnes marķieris ar doto nosaukumu netiek 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 %}
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 doto vārdu netiek 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. |
User
Atsaucas uz pašreizējo portāla lietotāju, atļaujot piekļuvi visiem pamata Dataverse kontaktpersonas ieraksta atribūtiem. Ja neviens lietotājs nav pieteicies, šis mainīgais ir nulle.
Lietotājs ir entītijas objekts.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
Piezīmes
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: filtru var arī izmantot has_role , lai pārbaudītu atsevišķu dalību lomās. |
basic_badges_url | Atgriež pakalpojuma vietrādi URL, lai izgūtu lietotāja žetonus. Lai lietotājam atveidotu emblēmas, ir jāiekļauj 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 |
weblinks
Ļ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 kopa objekts . Ja tīmekļa saišu kopa ar vārdu vai ID netiek atrasts, 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 %}
Tīmekļa saišu kopas atribūti
Piezīme
Tīmekļa saišu kopa ir entītijas objekts ar visiem tiem pašiem atribūtiem papildus šādiem atribūtiem:
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 }} |
Tīmekļa saites atribūti
Piezīme
Tīmekļa saistīt ir entītijas objekts ar visiem tiem pašiem atribūtiem papildus šādiem atribūtiem:
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. |
Image | Tīmekļa saites attēla objekts šai saitei. Šis atribūts ir nulle, ja nav attēla. |
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 }} |
Tīmekļa saites attēla atribūti
alternate_text | Attēla alternatīvais teksts. |
---|---|
Augstums | Vesels skaitlis ar norādītā attēla augstumu. Ja augstuma vērtība nav norādīta, šis atribūts ir nulle. |
url | Attēla URL. |
Platums | Vesels skaitlis ar norādīto attēla platumu. Ja platuma vērtība netika norādīta, šis atribūts ir 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 }})
Izvades
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 Aizvietošana (novērš kešdarbi): 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 Aizvietošana (izvairīšanās no kešatmiņas saglabāšanas): 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.) |