Kopīgot, izmantojot


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>

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

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

Vienības

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

Vienības

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

Vienības

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

Vienības

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

Vienības

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

Vienības

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

Vienības

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

Vienības

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

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

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

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

Skatiet arī

Šķidruma veidi
Šķidrie tagi
Šķidrie filtri