Galimi „Liquid“ objektai
„Liquid” objektų sudėtyje yra atributų, skirtų išvesti dinaminį turinį į puslapį. Pavyzdžiui, puslapio objektas turi atributą, pavadintą title, kurį galima naudoti norint išvesti dabartinio puslapio pavadinimą.
Norėdami prieiti prie objekto atributo pagal vardą, naudokite laikotarpį (.). Norėdami pateikti objekto atributą šablone, rašykite jį naudodami skliaustelius {{ and }}.
Svarbu
Kad išvengtumėte galimų kelių svetainių scenarijų (XSS) problemų, visada naudokite pabėgimo filtrą HTML atkodavimo duomenims, kai naudojant Skysčio objektus skaitomi vartotojo pateikti nepatikimi duomenys.
{{ page.title }}
Objekto atributus taip pat galima rasti naudojant eilutės pavadinimą ir []. Šis formatas naudingas tada, kai reikia atributą nustatyti dinamiškai ar atributo varde yra ženklų, tarpų, ypatingų ženklų ir panašiai, kurie negalios naudojimo laikotarpio metu (.) sintaksėje.
{{ page[title] }}
{% assign attribute_name = Name with spaces %}
{{ object[attribute_name] }}
Toliau nurodytus objektus galima naudoti ir rasti bet kur, bet kuriame šablone.
Objektas | Aprašą |
---|---|
objektai | Leidžia jums įkelti bet kurią „Microsoft Dataverse” lentelę pagal ID. Daugiau informacijos: Veiklos objektai |
dabar | Objektas data / laikas, kuriame nurodomas dabartinis UTC laikas, tuo metu, kai pateikiamas šablonas. Pastaba: portalo žiniatinklio programoje ši reikšmė saugoma talpykloje ir ji nėra atnaujinama kiekvieną kartą. Daugiau informacijos: Datos filtrai |
puslapis | Nurodomas dabartinis portalo užklausos puslapis. Objektas page suteikia prieigą, pavyzdžiui, prie dabartinio puslapio naršymo kelių, dabartinio puslapio pavadinimo arba URL ir prie bet kurių kitų esamo „Dataverse‟ įrašo atributų arba susijusių objektų. Daugiau informacijos: puslapis |
params | Patogi nuoroda į request.params. Daugiau informacijos: prašymas |
užklausa | Yra informacijos apie dabartinę HTTP užklausą. Daugiau informacijos: prašymas |
parametrai | Galite įkelti bet kurį svetainės parametrą pagal pavadinimą. Daugiau informacijos: Parametrai |
svetainės struktūra | Leidžia pasiekti portalo svetainės struktūrą. Daugiau informacijos: Vietos svetainė |
svetainės žymekliai | Galite įkelti bet kurį svetainės žymeklį pagal pavadinimą. Daugiau informacijos: Vietos žymės |
snippets (fragmentai) | Galite įkelti bet kurį turinio fragmentą pagal pavadinimą. Daugiau informacijos: Nuokarpos |
vartotojas | Nurodo dabartinį portalo vartotoją ir suteikia prieigą prie visų esamo Dataverse kontakto įrašo atributų. Jei nė vienas vartotojas nėra prisijungęs, šis kintamasis yra nulinis. Daugiau informacijos: naudotojas |
weblinks | Leidžia jums įkelti bet kurį Žiniatinklio saitų rinkinį pagal pavadinimą arba ID. Daugiau informacijos: Žiniatinkliai |
website (svetainė) | Nurodomas portalo žiniatinklio svetainės įrašas, suteikiantis prieigą prie visų portalo Dataverse Svetainės (adx_website) įrašas portalui. Daugiau informacijos: Žiniatinklis |
ads (reklamos)
Įgalina skelbimo paiešką ir rodymą.
Naudodami objektą ads galite pasirinkti konkrečią reklamą arba reklamos vietą:
<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>
Reklamų atributai
Atributas | Aprašą |
---|---|
placements | Pateikiamas adplacements (reklamos vietų) objektas. |
[ad pavadinimas ar id] | Bet kurią reklamą galite peržiūrėti pagal jos pavadinimą arba ID ypatybes. {% assign ad = ads[Ad Name] %} {% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Reklamos vietų atributai
Atributas | Aprašą |
---|---|
[reklamos vietos pavadinimas ar id] | Bet kurią adplacement (reklamos vietą) galite peržiūrėti pagal jos pavadinimą arba ID ypatybes.{% assign placement = ads.placements[Placement Name or Id] %} {% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %} |
Reklamos vietos atributai
Skelbimo paskirties vieta yra lentelės objektas su tais pačiais bendraisiais atributais ir toliau nurodytais atributais.
Atributas | Aprašą |
---|---|
Reklama | Pateikiamas su vieta susijusių reklamos objektų rinkinys. Su šiuo rinkiniu galima naudoti iteracijos žymes ir masyvo filtrus . |
Pavadinimą | Pateikiamas reklamos vietos laukas Pavadinimas. |
placement_url | URL, kuris gali būti naudojamas norint gauti šablone pateikiamą visą reklamos vietą. |
random_url | URL, kuris gali būti naudojamas norint gauti atsitiktinę reklamą iš šablone pateikiamos visos reklamos vietos. |
Reklamos atributai
Pastaba.
Skelbimas yra lentelės objektas, turintis visus tuos pačius atributus, be šių:
Atributas | Aprašą |
---|---|
ad_url | URL, kuris gali būti naudojamas norint gauti šablone pateikiamą visą reklamą. |
Kopijuoti | Pateikiamas reklamos laukas Kopija. |
image | Pateikiamas reklamos vaizdo objektas (jei yra). |
Pavadinimą | Pateikiamas reklamos laukas Pavadinimas. |
open_in_new_window | Pateikiama reikšmė true, jeigu redirect_url nurodytas URL turėtų būti atidarytas naujame lange. |
redirect_url | URL, į kurį naudotojas nukreipiamas pasirinkus skelbimą. |
Reklamos vaizdo atributai
Atributas | Aprašą |
---|---|
alternate_text | Pateikiamas tekstas, kuris turėtų būti rodomas žymės atribute alt. |
aukštis | Pateikiamas vaizdo aukštis pikseliais |
URL | Pateikiamas vaizdo URL šaltinis. |
plotis | Pateikiamas vaizdo plotis pikseliais |
interneto dienoraščiai
Įgalina internetinių dienoraščių ir internetinio dienoraščio skelbiamų pranešimų paiešką ir rodymą.
Objektas blogs leidžia pasirinkti konkretų tinklaraštį ar tinklaraščio įrašus.
{% 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>
Objektas blogs
TInklaraščių objektai leidžia jums prieiti prie konkretaus tinklaraščio portale arba prieiti prie visų įrašų portale.
Toliau pateiktoje lentelėje paaiškinami atributai, susieti su objektu blogs.
Atributas | Aprašas |
---|---|
posts | Pateikia objektą blogposts, kuriame yra visi tinklaraščių įrašai, esantys portale. |
[tinklaraščio pavadinimas arba ID] | Bet kurį tinklaraštį galite peržiūrėti pagal jo pavadinimą arba ID ypatybes. |
{% assign blog = blogs["Blog Name"] %}
{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Objektas blog
Objektas blog leidžia dirbti su vienu tinklaraščiu, leisdamas pasiekti to tinklaraščio įrašus.
Toliau pateiktoje lentelėje paaiškinami įvairūs atributai, susieti su objektu blog.
Atributas | Aprašas |
---|---|
posts | Pateikia objektą blogposts, kuriame yra visi to tinklaraščio įrašai. |
Pavadinimas | Interneto dienoraščio pavadinimas. |
title | Interneto dienoraščio antraštė. |
URL | Interneto dienoraščio URL. |
Objektas blogposts
Blogposts objektas leidžia pasiekti interneto dienoraščio skelbimų objektų rinkinį. Galite tvarkyti interneto dienoraščio skelbimus ir taikyti laužymą puslapiais, taip pat naudoti „Liquid“ filtrus.
{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}
Kitos galimos parinktys:
blogs.posts.all
(norėdami gauti visus tinklaraščio įrašus)blogs.posts | from\_index: 0 | take: 2
Toliau pateiktoje lentelėje paaiškinami įvairūs atributai, susieti su objektu blogposts.
Atributas | Aprašas |
---|---|
Vis. | Pateikia visus rinkinyje esančius objektus blogpost. |
Objektas blogpost
Nurodo vieną interneto dienoraščio skelbimą.
Toliau pateiktoje lentelėje paaiškinami įvairūs atributai, susieti su objektu blogpost.
Atributas | Aprašymas |
---|---|
url | Skelbimo URL. |
turinys | Grąžina skelbimo lauką Turinys. |
author | Grąžina įrašo autorius (kurie tiesiog yra kontaktų lentelės objektas). |
pavadinimas | Skelbimo antraštė. |
comment_count | Pateikia sveikojo skaičiaus reikšmę – tam tikro skelbimo komentarų skaičių. |
publish_date | Data, kada skelbimas buvo paskelbtas. |
objektai
Perspėjimas
Kad išvengtumėte galimų kelių svetainių scenarijų (XSS) problemų, visada naudokite pabėgimo filtrą HTML atkodavimo eilutės duomenims, kai naudojant subjektų „Liquid“ objektus skaitomi vartotojo pateikti duomenys, kuriais negalima pasitikėti.
Pastaba.
Pakeistos kai kurios Dataverse pavadinimų suteikimo sąlygos, pavyzdžiui, Dataverse subjektai dabar vadinami lentelėmis. Pavadinimo pakeitimai netaikomi „Liquid“ objektams. „Liquid“ subjektų objektai ir toliau bus vadinami subjektais.
Leidžia jums įkelti bet kurią „Dataverse” lentelę pagal ID. Jei lentelė yra, grąžinamas lentelės objektas. Jei lentelė su nurodytu ID nerasta, pateikiama nulinė reikšmė.
{% assign account = entities.account['936DA01F-9ABD-4d9d-80C7-02AF85C822A8'] %}
{% if account %}
{{ account.name | escape }} ({{ account.statecode.label | escape }})
{% endif %}
{% assign entity_logical_name = 'contact' %}
{% assign contact = entities[entity_logical_name][request.params.contactid] %}
{% if contact %}
{{ contact.fullname | escape }} ({{ contact.parentcustomerid.name | escape }})
{% endif %}
Entity
Objekto objektas suteikia prieigą prie lentelės įrašo atributų Dataverse .
Atributas | Aprašas |
---|---|
Id | Lentelės GUID ID kaip eilutė. Pavyzdžiui, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
logical_name | Loginis „Dataverse” lentelės pavadinimas. |
Pastabos | Įkelia visas su lentele susijusias pastabas (komentaras), išdėstytas nuo seniausios iki naujausios (createdon ). Pastabos grąžinamos kaip pastabos objektai. |
teisės | Įkeliami Lentelės teisės apsaugos rezultatai lentelei. Rezultatai bus grąžinti kaip teisių objektas. |
url | Pateikia lentelės Power Pages portalų turinio valdymo sistemos URL kelią. Jei lentelė neturi galiojančio URL dabartinėje svetainėje, pateikiama nulinė reikšmė. Paprastai tai grąžina tik tam tikrų lentelių tipų, kurie buvo integruoti į portalo TVS, reikšmę, nebent savo programoje tinkinote URL teikėją. |
[atributo arba ryšio pavadinimas] | Galite pasiekti bet kurį „Dataverse” lentelės atributą pagal loginį pavadinimą. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Daugumos lentelių atributų reikšmės susieja tiesiogiai su „Liquid” tipais: Dviejų parinkčių laukai susieja su Bulio logika, o teksto laukai – su eilute, skaitiniai/valiutos laukai – su skaičiais, datos/laiko laukai – su datos objektais. Tačiau kai kurie atributų tipai pateikiami kaip objektai.
{{ page.adx_webpage_entitylist.adx_name }} Tuo atveju, kai santykiai yra refleksyvūs (tai yra, savęs referentiniai), grąžinamas refleksyvus santykių objektas. (Priešingu atveju rezultatas būtų neaiškus.){{ page.adx_webpage_webpage.referencing.adx_name }} Pastaba: didelio susijusių objektų skaičiaus įkėlimas arba prieiga prie didelio ryšių skaičiaus viename šablone gali turėti neigiamos įtakos šablono generavimo našumui. Venkite įkelti kiekvieno masyvo elemento susijusius objektus per vieną ciklą. Jei įmanoma, naudokite „Dataverse” lentelių žymas objektų rinkiniams įkelti. |
Susietosios lentelės nuoroda
Peržvalgos atributo reikšmės yra grąžinamos kaip susietosios lentelės nuorodos objektai su toliau nurodytais atributais.
Atributas | Aprašas |
---|---|
Id | Nurodytosios lentelės GUID ID kaip eilutė. Pavyzdžiui, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
logical_name | „Dataverse” loginis nurodančios lentelės pavadinimas. |
Pavadinimą | Pirminis nurodančios lentelės pavadinimo atributas. |
Pastaba.
Pastaba yra lentelė, suteikianti prieigą prie anotacijos įrašo atributų ir ryšių. Be visų lentelės objekto atributų, pastaba turi šiuos papildomus atributus.
Atributas | Aprašą |
---|---|
documentbody | Įkelia pastabos anotacijos įrašo atributą documentbody kaip eilutę, koduotą naudojant Base64. Kadangi šio atributo turinys gali būti didelis, jis nėra įkeltas su likusiais užrašo atributais, jis įkeliamas tik pagal poreikį. Pastaba: dokumento korpuso atributo naudojimas gali turėti neigiamos įtakos šablono atvaizdavimo našumui, todėl tai reikia daryti atsargiai. Jei įmanoma, geriau naudokite atributą url saitui su pastabos priedu pateikti. |
URL | Grąžina įtaisytosios URL portalo komentaro priedo apdorojimo programos kelią. Jei vartotojas turi teisę ir pastaba turi pridėtą failą, užklausa šiuo URL atsisiunčia pastabos failo priedą. |
Pastaba.
Parinkčių rinkinio reikšmė
Parinkčių rinkinio/išrinkimo sąrašo reikšmės yra grąžinamos kaip susietosios lentelės nuorodos objektai su toliau nurodytais atributais.
Atributas | Aprašas |
---|---|
Žyma | Lokalizuota parinkčių rinkinio / išrinkimo sąrašo atributo reikšmės žymė. Pavyzdžiui, Aktyvus |
Reikšmė | Parinkčių rinkinio / išrinkimo sąrašo atributo reikšmės sveikoji reikšmė. Pavyzdžiui, 0 |
Lentelės teisės
Lentelės teisių objektas suteikia prieigą prie agreguotos lentelės teisės apsaugos rezultatų.
Atributas | Aprašą |
---|---|
can_append | Pateikia „teisinga”, jei dabartinis vartotojas turi teisę pridėti įrašų prie šio įrašo ryšių. Kitu atveju pateikia „klaidinga”. |
can_append_to | Pateikia „teisinga”, jei dabartinis vartotojas turi teisę pridėti šį įrašą prie kitos lentelės ryšio. Kitu atveju pateikia „klaidinga”. |
can_create | Pateikia „teisinga”, jei dabartinis vartotojas turi teisę kurti naujus šio lentelės tipo įrašus. Kitu atveju pateikia „klaidinga”. |
can_delete | Pateikia „teisinga”, jei dabartinis vartotojas turi teisę panaikinti šį įrašą. Kitu atveju pateikia „klaidinga”. |
can_read | Pateikia „teisinga”, jei dabartinis vartotojas turi teisę skaityti šį įrašą. Kitu atveju pateikia „klaidinga”. |
can_write | Pateikia „teisinga”, jei dabartinis vartotojas turi teisę naujinti šį įrašą. Kitu atveju pateikia „klaidinga”. |
rules_exist | Pateikia „true“, jei teisių rezultatai, žymimi šio objekto, yra aiškiai apibrėžtų teisių taisyklių rezultatas. Grąžina klaidingą, jei tai yra numatytieji rezultatai, kai nėra aiškiai apibrėžtų teisių. |
Refleksinis ryšys
Bandant įkelti refleksinius (t. y. nurodančius į save) ryšius objektuose, pateikiami objektai su toliau nurodytais atributais.
Atributas | Aprašą |
---|---|
is_reflexive | Pateikia true. Gali būti naudojama patikrinti, ar ryšio pateiktas objektas yra refleksinis ryšio objektas. |
referenced | Grąžina tam tikro ryšio nurodytųjų objektų masyvą. |
referencing | Grąžina tam tikro ryšio nurodančiąją lentelę. Pateikia nulinę reikšmę, jei nėra nurodančiosios lentelės. Jei ryšys yra „daugelis su daugeliu“ (N:N), grąžina nurodančiųjų objektų masyvą. |
entitylist
Objektų sąrašo objektas yra naudojamas Dataverse lentelės žymėse. Jis suteikia prieigą prie visų pateikto sąrašo atributų.
Atributai
Pastaba.
Atributas | Aprašą |
---|---|
create_enabled | Pateikia „teisinga”, jei naujų įrašų kūrimas yra sukonfigūruotas sąrašui. Kitu atveju pateikia „klaidinga”. |
create_url | Pateikia sukonfigūruotą URL kelią, skirtą sąrašo kūrimo saitui/mygtukui. |
detail_enabled | Pateikia „teisinga”, jei atskirų įrašų išsamios informacijos rodinys yra sukonfigūruotas sąrašui. Kitu atveju pateikia „klaidinga”. |
detail_id_parameter | Pateikia užklausos eilutės parametro pavadinimą, naudotiną įrašo ID, kai sudaromas įrašo išsamios informacijos rodinio URL. Informacijos apie „Liquid“ filtrus, naudojamus URL sudaryti, žr. URL filtrai. Pavyzdžiui, id |
detail_label | Pateikia sukonfigūruotą lokalizuotą žymą, skirtą sąrašo išsamios informacijos rodinio saitams/mygtukams. |
detail_url | Pateikia sukonfigūruotą URL kelią, skirtą sąrašo išsamios informacijos rodinio saitams/mygtukams. |
empty_list_text | Pateikia sukonfigūruotą lokalizuotą tekstą, kuris rodomas, kai sąrašo rodinys nepateikia jokių rezultatų. |
enable_entity_permissions | Pateikia „teisinga”, jei šiam sąrašui įgalintas Lentelės teisių filtravimas. Kitu atveju pateikia „klaidinga”. |
entity_logical_name | Pateikia „Dataverse” lentelės loginį pavadinimą, skirtą įrašams rodyti šiame sąraše. Pavyzdžiui, kontaktas |
filter_account_attribute_name | Grąžina atributo loginį pavadinimą peržvalgai į klientą, kuris naudojamas rezultatų įrašams filtruoti pagal dabartinio portalo vartotojo pirminis klientas. Pavyzdžiui, accountid |
filter_apply_label | Pateikia sukonfigūruotą lokalizuotą žymą, naudotiną saitui/mygtukui, kuris taiko išplėstinį atributo filtrą sąrašo rezultatams. |
filter_definition | Pateikia JSON atributo filtro aprašą sąrašui. Informacijos apie tai, kaip šio aprašo apdorojimui naudoti metafiltrų „Liquid“ filtrą, ieškokite Sąrašo filtrai. |
filter_enabled | Pateikia „teisinga”, jei sąrašui įgalinta išplėstinio atributų filtravimo funkcija. Kitu atveju pateikia „klaidinga”. |
filter_portal_user_attribute_name | Grąžina kontakto peržvalgos atributo loginį pavadinimą, naudojamą rezultatų įrašams filtruoti pagal dabartinio portalo vartotojo kontaktą. Pavyzdžiui, contactid |
filter_website_attribute_name | Grąžina atributo loginį peržvalgos pavadinimą adx_website, kuris naudojamas rezultatų įrašams filtruoti dabartinėje portalo svetainėje. Pavyzdžiui, adx_websiteid |
kalbos_kodas | Pateikia „Dataverse” sveikojo skaičiaus kalbos kodą, kuris bus naudojamas visoms šio sąrašo lokalizuotoms žymoms pasirinkti. |
page_size | Pateikia sąrašui sukonfigūruotą rezultatų puslapio dydį. |
primary_key_name | Pateikia pirminio rakto atributo loginį pavadinimą, skirtą įrašams rodyti šiame sąraše. |
search_enabled | Pateikia „teisinga”, jei įgalinta šio sąrašo ieška. Kitu atveju pateikia „klaidinga”. |
search_placeholder | Pateikia sukonfigūruotą lokalizuotą tekstą, skirtą sąrašo ieškos lauko rezervavimo ženklui. |
search_tooltip | Pateikia sukonfigūruotą lokalizuotą tekstą, skirtą sąrašo ieškos patarimui. |
rodiniai | Pateikia galimus sąrašo rodinius kaip sąrašo rodinių objektus. |
[attribute logical name] | Bet kurį įrašų sąrašo (adx_entitylist) Dataverse atributą galite rasti pagal loginį pavadinimą, taip pat kaip ir lentelės objektus. Pavyzdžiui, {{ entitylist.adx_name }} |
Rodinio atributų sąrašas
Atributas | Aprašą |
---|---|
stulpeliai | Pateikia rodinio stulpelius kaip sąrašo rodinio stulpelių objektus. |
entity_logical_name | Pateikia „Dataverse” lentelės loginį pavadinimą, skirtą į rodinį įtrauktiems įrašams. Pavyzdžiui, kontaktas |
Id | Pateikia rodinio GUID ID. |
kalbos_kodas | Grąžina sveikojo skaičiaus kalbos kodą, Dataverse naudojamą visoms lokalizuotoms rodinio etiketėms (stulpelių antraštėms ir kt.) pasirinkti. |
Pavadinimą | Pateikia rodinio „Dataverse” rodomą pavadinimą. |
primary_key_logical_name | Pateikia „Dataverse” lentelės pirminio rakto pavadinimą, skirtą į rodinį įtrauktiems įrašams. Pavyzdžiui, contactid |
sort_expression | Pateikia numatytąją rodinio rūšiavimo išraišką. Pavyzdžiui, name ASC, createdon DESC |
Sąrašo rodinio stulpelių atributai
Atributas | Aprašą |
---|---|
attribute_type | Pateikia stulpelio „Dataverse‟ atributo tipo pavadinimą kaip eilutę. Pavyzdžiui, Peržvalga, Išrinkimo sąrašas, Eilutė, Bulio logika, Data ir laikas |
logical_name | Pateikia stulpelio „Dataverse‟ atributo loginį pavadinimą. Pavyzdžiui, createdon |
Pavadinimas | Pateikia stulpelio lokalizuotą „Dataverse‟ rodomą pavadinimą. Pavyzdžiui, Sukurta |
sort_ascending | Pateikia rūšiavimo išraiškos eilutę, skirtą stulpeliui didėjimo tvarka rūšiuoti. Pavyzdžiui, createdon ASC |
sort_descending | Pateikia rūšiavimo išraiškos eilutę, skirtą stulpeliui mažėjimo tvarka rūšiuoti. Pavyzdžiui, createdon DESC |
sort_disabled | Pateikia true, jei išjungta stulpelio rūšiavimo funkcija. Kitu atveju pateikia „klaidinga”. |
sort_enabled | Pateikia true, jei įjungta stulpelio rūšiavimo funkcija. Kitu atveju pateikia „klaidinga”. |
plotis | Pateikia sukonfigūruotą stulpelio plotį pikseliais. |
entityview
Objektas entityview naudojamas naudojant žymę entityview ir suteikia prieigą prie rodinio metaduomenų, taip pat prie rodinio rezultato įrašų.
Atributai
Atributas | Aprašas |
---|---|
stulpeliai | Pateikia rodinio stulpelius kaip lentelės rodinio stulpelio objektus. |
entity_permission_denied | Grąžinama „teisinga”, jei prieiga peržiūrėti rezultatus buvo uždrausta dabartiniam vartotojui dėl nepakankamų lentelės teisių. Jei buvo suteikta skaitymo prieiga peržiūrėti rezultatus, rodoma false. |
entity_logical_name | Rodinio rezultatų įrašų „Dataverse” lentelės loginis pavadinimas. Pavyzdžiui, kontaktas |
first_page | Rodinio rezultatų pirmojo puslapio numeris. Tai yra 1, nebent nebuvo grąžinti rezultatai, tokiu atveju jis yra niekinis. |
Id | Šį entityview apibrėžiančio „Dataverse“ rodinio GUID ID. |
kalbos_kodas | „Dataverse‟ sveikojo skaičiaus kalbos kodas, kuris naudojamas norint įkelti dabartinio rodinio lokalizuotas žymas. |
last_page | Rodinio rezultatų paskutinio puslapio numeris. Jei rezultatų nepateikta, ši reikšmė yra nulinė. |
pavadinimas / vardas ir pavardė | Šį entityview apibrėžiančio „Dataverse‟ rodinio pavadinimas, pavyzdžiui, Aktyvieji kontaktai. |
next_page | Rodinio rezultatų kito puslapio numeris. Jei nėra kito rezultatų puslapio, ši reikšmė yra neapibrėžta. |
Puslapis | Rodinio rezultatų dabartinio puslapio numeris. |
puslapiai | Pateikiamas puslapių numerių masyvas, apimantis visus dabartinio rodinio rezultatų puslapius. |
page_size | Dabartinio rodinio kiekviename puslapyje pateikiamų rezultatų skaičius. |
previous_page | Rodinio rezultatų kito puslapio numeris. Jei nėra ankstesnio rezultatų puslapio, tai yra nulinė. |
primary_key_logical_name | Šio rodinio rezultatų lentelės pirminio pagrindinio atributo „Dataverse” loginis pavadinimas. Pvz., contactid. |
įrašai | Rodinio rezultato įrašų, pavyzdžiui lentelės objektų, dabartinis puslapis. |
sort_expression | Numatytoji rodinio rūšiavimo išraiška. Pavyzdžiui, nameASC, createdon DESC. |
total_pages | Bendras rodinio rezultato puslapių skaičius. |
total_records | Bendras rodinio rezultatų skaičius (visuose puslapiuose). |
renginiai
Įgalina įvykių paiešką ir rodymą. Naudodami objektą events galite pasirinkti konkretų įvykį arba visus įvykius.
Objektas events
Objektas events leidžia pasiekti bet kurį konkretų įvykį portale arba visus įvykius portale (neatsižvelgiant į įvykį).
Objektas events turi toliau nurodytus atributus.
Atributas | Aprašą |
---|---|
pasikartojim. | Grąžina įvykio atsitikimo objektą su visais atsitikusiais įvykiais portale |
[įvykio pavadinimas arba ID] | Bet kurį įvykį galite peržiūrėti pagal jo pavadinimą arba ID ypatybes. {% assign event = events["Event Name"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Objektas event
Objektas event leidžia dirbti su vienu įvykiu, leisdamas pasiekti to įvykio grafikus ir atvejus.
Objektas event turi toliau nurodytus atributus.
Atributas | Aprašo |
---|---|
pasikartojim. | Grąžina įvykio atsitikimo objektą su visais atsitikusiais įvykiais įvykiui. |
pavadinimas | Įvykio pavadinimą. |
URL | Įvykio URL. |
Objektas eventoccurences
Objektas eventoccurrences leidžia pasiekti įvykio atvejų objektų rinkinį. Galite užsisakyti įvykių pasikartojimus ir nurodyti įvykių seką, kurią norite gauti, taip pat pasiekti puslapių numeraciją naudodami skysčių filtrus:
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
Taip pat galima ši parinktis:
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
Šie atributai yra susieti su objektu eventoccurrences
Atributas | Aprašas |
---|---|
Vis. | Pateikia visus rinkinyje esančius objektus eventoccurance. |
Objektas eventoccurence
Rodo vieną įvykio atvejį. Toliau pateikiami susiję atributai:
Atributas | Aprašą |
---|---|
url | Atvejo URL. |
is_all_day_event | Ar tai visos dienos įvykis? |
start_time | Įvykio pradžios laikas. |
end_time | Įvykio pabaigos laikas. |
besąlygis ciklas
Turi ypatybių, kurios naudingos ciklo bloke skirta.
Pastaba.
„forloop“ galima naudoti tik tarp žymės skirta.
Kodas
{% for child in page.children %}
{% if forloop.first %}
This is the first child page!
{% else %}
This is child page number {{ forloop.index }}.
{% endif %}
{% endfor %}
Išvesties
This is the first child page!
This is child page number 2.
This is child page number 3.
Atributai
Atributas | Aprašas |
---|---|
pirmas | Pateikia true, jei ciklas kartojamas pirmą kartą. Pateikia false, jei ciklas kartojamas ne pirmą kartą. |
index | Dabartinio elemento padėtis rinkinyje, kai pirmojo elemento padėtis yra 1. |
index0 | Dabartinio elemento padėtis rinkinyje, kai pirmojo elemento padėtis yra 0. |
Paskutinis | Pateikia true, jei ciklas kartojamas paskutinį kartą. Pateikia false, jei ciklas kartojamas ne paskutinį kartą. |
length | Grąžina ciklo pakartojimų skaičių ߝ skaičių rinkinio elementų kuriuose kartojama. |
rindex | Likusių ciklo elementų skaičius (ilgis – rodyklė), kur 1 yra paskutinio elemento rodyklė. |
rindex0 | Likusių ciklo elementų skaičius (ilgis – rodyklė), kur 0 yra paskutinio elemento rodyklė. |
forumai
Įgalina forumų ir forumo gijų paiešką ir rodymą. Galimybė generuoti forumo duomenis naudojant „liquid“ galioja ir skelbimams, tačiau norėdami sukurti naują skelbimą arba giją, turite naudoti ASP.NET kelių žingsnių formų puslapio šabloną su integruota minėta funkcija (pavyzdžiui, numatytieji forumo gijų ir forumo skelbimų puslapio šablonai).
Forumo objektas leidžia jums pasirinkti forumą ar forumo įrašų juostas:
<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>
Forumų objektas
Forumų objektas leidžia pasiekti bet kurį konkretų forumą portale arba visas forumo gijas portale (neatsižvelgiant į forumą).
Objektas forum leidžia dirbti su vienu forumu ir pasiekti to forumo gijas.
forumthreads objektas leidžia pasiekti forumthread objektų rinkinį. Galite rikiuoti forumo gijas, taikyti laužymą puslapiais bei naudoti „Liquid“ filtrus.
{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}
Viena forumo gija
forumposts objektas leidžia pasiekti forumpost objektų rinkinį.
Atributai
Atributas | Aprašas |
---|---|
threads | Pateikia objektą forumthreads, kuriame yra visi objektai forumthread, esantys portale. |
Vis. | Pateikia visus portale esančius objektus forum. Atkreipkite dėmesį, kad website.forums taip pat yra atitikmuo. |
thread_count | Pateikia reikšmę sveikojo skaičiaus, nurodančio, kiek gijų yra visoje svetainėje. |
post_count | Pateikia reikšmę sveikojo skaičiaus, nurodančio bendrą įrašų skaičių portale. |
[forumo pavadinimas ar ID] | Bet kurį forumą galite peržiūrėti pagal jo pavadinimą arba ID ypatybes. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %} |
Objektas forum
Atributai
Pastaba.
Atributas | Aprašą |
---|---|
threads | Pateikia objektą forumthreads, kuriame yra visos forumo gijos. |
Pavadinimą | Forumo pavadinimas. |
thread_count | Pateikia reikšmę sveikojo skaičiaus, nurodančio, kiek gijų yra forume. |
post_count | Pateikia reikšmę sveikojo skaičiaus, nurodančio, kiek visame forume yra įrašų. |
Objektas forumthreads
Atributai
Atributas | Aprašas |
---|---|
Vis. | Pateikia visus rinkinyje esančius objektus forumthread. |
Objektas forumthread
Atributai
Pastaba.
Atributas | Aprašą |
---|---|
posts | Pateikia objektą forumposts, kuriame yra visi forumo gijos įrašai. |
author | Grąžina gijos autorių (kuris yra tiesiog kontaktų lentelės objektas). |
latest_post | Pateikia naujausią gijos skelbimą. |
first_post | Pateikia pirmą gijos skelbimą. |
post_count | Pateikia reikšmę sveikojo skaičiaus, nurodančio, kiek įrašų yra gijoje. |
is_answered | Ar gija atsakyta ar ne? |
is_sticky | Ar gija fiksuota? |
Objektas forumposts
Atributai
Atributas | Aprašas |
---|---|
Vis. | Pateikia visus rinkinyje esančius objektus forumthread. |
Vienas forumo skelbimas
Atributai
Pastaba.
Atributas | Aprašą |
---|---|
author | Grąžina įrašo autorių (kuris yra tiesiog kontaktų lentelės objektas). |
turinys | Skelbimo turinys. |
is_answer | Ar šis įrašas yra gijos atsakymas? |
žinių bazė
Suteikia prieigą prie „Dataverse“ informacinių straipsnių ir kategorijų lentelių įrašų, kad straipsniai ir kategorijos būtų atvaizduoti portale.
Atributai
Atributas | Aprašas |
---|---|
straipsniai | Grąžina straipsnių objektą, kuriame yra portale prieinami informacinių straipsnių lentelės įrašų straipsnio objektai. |
kategorijos | Grąžina kategorijų objektą, kuriame yra portale prieinami kategorijų lentelės įrašų kategorijų objektai. |
straipsnių objektas
Straipsnių objektas leidžia pasiekti straipsnių objektų rinkinį. Galite rikiuoti straipsnius, taikyti laužymą puslapiais bei naudoti „Liquid“ 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 %}
Atributai
Atributas | Aprašas |
---|---|
populiarūs | Pateikia straipsnio objektų, turinčių daugiausia peržiūrų, rinkinį. {% assign popular_articles = knowledge.articles.popular %} |
naujausi | Pateikia straipsnio objektų, kurių naujausia modifikavimo data, rinkinį. {% assign recent_articles = knowledge.articles.recent %} |
viršuje | Pateikia straipsnio objektų, turinčių geriausią įvertinimą, rinkinį. {% assign top_articles = knowledge.articles.top %} |
Filtrai
Šie filtrai gali priimti neprivalomus puslapio dydžio ir kalbos parametrus. Pirmasis parametras yra gautinų įrašų skaičius. Numatytasis puslapio dydis – 5. Antrasis parametras yra kalbos kodas, jei reikia, kad straipsniai būtų pateikiami tam tikra kalba. Filtrai gali būti derinami su kitais skysčių filtrais.
{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Atributas | Aprašą |
---|---|
populiarūs | Pateikia straipsnio objektų, turinčių daugiausia peržiūrų, rinkinį. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %} |
naujausi | Pateikia straipsnio objektų, kurių naujausia modifikavimo data, rinkinį. {% assign recent_articles = knowledge.articles \| recent: 5 %} |
viršuje | Pateikia straipsnio objektų, turinčių geriausią įvertinimą, rinkinį. {% assign top_articles = knowledge.articles \| top: 3, en-US %} |
kategorijų objektas
Kategorijų objektas leidžia pasiekti kategorijų objektų rinkinį. Galite rikiuoti kategorijas ir taikyti laužymą puslapiais, taip pat naudoti „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 %}
Atributai
Atributas | Aprašas |
---|---|
naujausi | Pateikia kategorijos objektų, kurių naujausia modifikavimo data, rinkinį. |
top_level | Grąžina kategorijos objektų kolekciją, kurios neturite valdančioje kategorijoje. |
Filtrai
Šie filtrai gali priimti neprivalomus puslapio dydį nurodančius parametrus. Numatytasis puslapio dydis – 5. Filtrai gali būti derinami su kitais skysčių filtrais.
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Atributas | Aprašą |
---|---|
naujausi | Pateikia kategorijos objektų, kurių naujausia modifikavimo data, rinkinį. Galite teikti parametrus {% assign recent_categories = knowledge.categories \| recent: 10 %} |
top_level | Grąžina kategorijos objektų kolekciją, kurios neturite valdančioje kategorijoje. {% assign root_categories = knowledge.categories \| top_level %} |
straipsnių objektas
Straipsnių objektas leidžia dirbti su vienu knowledgearticle ir parodyti išsamią informaciją apie šį straipsnį portale.
Atributai
Straipsnis yra objekto objektas su visais tais pačiais atributais, be šių atributų:
Atributas | Aprašą |
---|---|
article_public_number | Viešasis straipsnio numeris. |
comment_count | Sveikojo skaičiaus reikšmė, rodanti, kiek komentarų yra tam tikrame straipsnyje. |
turinys | Straipsnio turinys. |
current_user_can_comment | Pateikia Bulio logikos reikšmę, nurodančią, ar dabartinis vartotojas gali komentuoti straipsnį. |
is_rating_enabled | Pateikia Bulio logikos reikšmę, nurodančią, ar įjungtas straipsnio reitingas. |
raktažodžiai | Straipsnio raktažodžiai. |
pavadinimas | Alternatyvus straipsnio pavadinimas. |
įvertinimas | Straipsnio reitingo vertė dešimtainėje sistemoje. |
title | Straipsnio pavadinimas. |
view_count | Sveikojo skaičiaus, rodančio, kiek kartų straipsnis buvo peržiūrėtas, reikšmė. |
kategorijų objektas
Kategorijų objektas leidžia dirbti su viena kategorija ir parodyti išsamią informaciją apie ją portale.
Atributai
Kategorija yra objekto objektas, turintis visus tuos pačius atributus, be šių atributų:
Atributas | Aprašą |
---|---|
categorynumber | Kategorijos numeris. |
pavadinimas | Alternatyvus kategorijos pavadinimas. |
pareigos | Kategorijos pavadinimas. |
kalba
Suteikia esamą kalbos pavadinimą ir kalbos kodą, jei kelios palaikomos kalbos įjungtos.
Atributai
Atributas | Aprašas |
---|---|
url | Dabartinės užklausos numatytasis URL su esamos kalbos kodu. |
url_keitimas | Dabartinės užklausos numatytasis URL su esamos kalbos kodu apeina puslapio siuntimo žymą. |
pavadinimas | Esamos kalbos pavadinimas. |
code | Kalbos kodas. |
Pavyzdžiui, Kalbų iškrentantis meniu žiniatinklio šablonas pagal nutylėjimą naudoja šį „Liquid” objektą į sąrašą esamose kalbose, kai kelios kalbos yra prieinamos.
Žurnalo
Kūrėjai turi galimybę įtraukti žurnalo teiginius į savo skystąjį kodą. Kai veikia "Power pages" svetainė, žurnalai, kuriuos kūrėjas įtraukė į "Liquid" kodą, rodomi kūrėjo įrankio plėtinyje Power Pages . Šie žurnalo įdėtieji žurnalai rodomi kūrėjo įrankio plėtinyje, kai įjungtas diagnostikos parametras .
Toliau nurodytą sintaksę galima naudoti "Liquid" kode, kad būtų galima registruoti pasirinktinius pranešimus:
{% log message:'Custom message' level:'Warning' %}
Žurnalo atributai
Atributas | Aprašą |
---|---|
Žurnalo | Skysto objekto pavadinimas |
message | Eilutė, nurodanti visus pasirinktinius pranešimus, kuriuos reikia registruoti |
lygis | Užregistruokite pranešimą kaip informaciją, įspėjimą arba klaidą |
Pavyzdys:
{% 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 %}
puslapis
Nurodomas dabartinis portalo užklausos puslapis. Šis objektas sujungia svetainės struktūros ir dabartinės užklausos objektų (paprastai tinklalapio) atributus.
Objektas page suteikia prieigą, pavyzdžiui, prie dabartinio puslapio naršymo kelių, dabartinio puslapio pavadinimo arba URL ir prie bet kurių kitų esamo „Dataverse‟ įrašo atributų arba susijusių objektų.
<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 }}. -->
Puslapio atributai
Pastaba.
Atributas | Aprašą |
---|---|
breadcrumbs | Pateikia puslapio naršymo kelio svetainės struktūros objektus pradedant svetainės struktūros šakniniu mazgu ir baigiant pirminiu. |
children | Pateikia puslapio antrinius svetainės struktūros mazgo objektus. |
parent | Pateikia puslapio pirminį svetainės struktūros mazgą. Jei puslapis yra pagrindinis puslapis, pirminis yra neapibrėžtas. |
pavadinimas | Puslapio pavadinimas. |
url | Puslapio URL. |
[atributo arba ryšio pavadinimas] | Bet kurį esamą puslapio „Dataverse‟ įrašo atributą galite surasti pagal loginį pavadinimą.{{ page.createdon }} {% assign attribute_name = 'name' %} {{ page[attribute_name] }} Daugumos lentelių atributų reikšmės susieja tiesiogiai su „Liquid” tipais: Dviejų parinkčių laukai susieja su Bulio logika, o teksto laukai – su eilute, skaitiniai/valiutos laukai – su skaičiais, datos/laiko laukai – su datos objektais. Tačiau kai kurie atributų tipai pateikiami kaip objektai.
{{ page.adx_webpage_entitylist.adx_name }} Tuo atveju, kai santykis yra refleksyvus (t. y. savęs nurodymas), grąžinamas subjekto objektas. (Priešingu atveju rezultatas būtų neaiškus.) {{ page.adx_webpage_webpage.referencing.adx_name }} Pastaba: didelio susijusių objektų skaičiaus įkėlimas arba prieiga prie didelio ryšių skaičiaus viename šablone gali turėti neigiamos įtakos šablono generavimo našumui. Venkite įkelti kiekvieno masyvo elemento susijusius objektus per vieną ciklą. Jei įmanoma, geriau naudokite Dataverse lentelių žymas objektų rinkiniams įkelti. |
apklausos
Įgalina apklausos nuskaitymą ir rodymą.
Naudodami objektą polls galite pasirinkti konkrečią apklausą arba apklausos vietą:
<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>
Apklausų atributai
Atributas | Aprašą |
---|---|
placements | Pateikia objektą pollplacements. |
[apklausos pavadinimas arba ID] | Bet kurią apklausą galite peržiūrėti pagal jos pavadinimą arba ID ypatybes. {% assign poll = polls[Poll Name] %} {% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %} |
Apklausos vietų atributai
Atributas | Aprašą |
---|---|
[apklausos vietos pavadinimas arba ID] | Bet kurią apklausos vietą galite peržiūrėti pagal jos pavadinimą arba ID ypatybes.{% assign placement = polls.placements[Placement Name or Id] %} {% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %} |
Apklausos vietų atributai
Pastaba.
Atributas | Aprašą |
---|---|
Pavadinimą | Pateikia apklausos vietos lauką „Pavadinimas“. |
placement_url | URL, kuris gali būti naudojamas norint gauti šablone pateikiamą visą apklausos vietą. |
apklausos | Pateikia su vieta susijusių apklausos objektų rinkinį. Su šiuo rinkiniu galima naudoti iteracijos žymes ir masyvo filtrus . |
random_url | URL, kuris gali būti naudojamas norint gauti atsitiktinę apklausą iš šablone pateikiamos visos apklausos vietos. |
submit_url | URL, kuriame pateikiama baigta apklausa. |
Apklausų atributai
Pastaba.
Atributas | Aprašą |
---|---|
has_user_voted | Pateikia „true“, jei dabartinis vartotojas (prisijungęs ar anoniminis) šioje apklausoje jau balsavo. |
Pavadinimas | Pateikia apklausos lauką „Pavadinimas“. |
options | Pateikia su apklausa susijusių apklausos parinkčių objektų rinkinį. Su šiuo rinkiniu galima naudoti iteracijos žymes ir objektus . |
poll_url | URL, kuris gali būti naudojamas norint gauti visą šablono sugeneruotą apklausą. |
klausimas | Pateikia apklausos lauką „Klausimas“. |
submit_button_label | Pateikia eilutę, kurią galima naudoti norint perrašyti apklausos pateikimo mygtuko etiketę. |
submit_url | URL, kuriame pateikiama baigta apklausa. |
user_selected_option | Grąžina vartotojo pasirinktą apklausos objektą (jei jis jau balsavo). |
balsai | Grąžina lentelėje pateiktų apklausos balsų skaičių. |
Apklausos parinkčių atributai
Pastaba.
Atributas | Aprašą |
---|---|
atsakymas | Pateikia apklausos lauką „Atsakymas“. |
procentas | Pateikia apklausos parinkties balsų procentą dešimtainiu skaičiumi nuo 0 iki 100. |
balsai | Grąžina balsų, kurie pateikiami lentelėje dėl parinkties, skaičių. |
užklausa
Yra informacijos apie dabartinę HTTP užklausą.
{% assign id = request.params['id'] | escape %}
<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>
Pastaba.
- Galite dinamiškai kurti kintamus URL naudodami URL filtrus.
- URL, naudojamas request.url, gali būti bet kokia reikalinga reikšmė, ir vėlesnėms užklausoms leidžia gauti saugomas reikšmes. Tam, kad request.url būtų naudojama teisinga reikšmė, galite naudoti pakaitinę žymę, dalinį URL, pvz., ~{WebFile path} arba išsaugoti portalo URL Svetainės parametruose.
- Power Pages portalų leidimo versija 9.3.8.x ar vėlesnis bus pabėgimo likvidų filtrą įjungtą vartotojo ir užklausos likvidžius objektus. Norėdami išjungti šią numatytąją konfigūraciją ir leisti naudoti šiuos Likvdižius objektus, žr portalo saito nustatymai - Site/EnableDefaultHtmlEncoding.
Atributai
Atributas | Aprašymas |
---|---|
params | Dabartinės užklausos parametrų reikšmės, kurioms suteiktas pavadinimas. params yra URL užklausos eilutės parametrų formos, formos registravimo parametrų ir slapukų derinys. |
Kelias | Dabartinės užklausos URL kelias. /profile/ |
path_and_query | Dabartinės užklausos URL kelias ir užklausa./profile/?foo=1&bar=something |
užklausa | Dabartinės užklausos URL dalis su užklausa. ?foo=1&bar=something |
url | Visas dabartinės užklausos URL.https://www.example.com/profile/?foo=1&bar=something |
searchindex
Ieškos rodyklės objektas („searchindex”) naudojamas tarp Dataverse lentelės žymų, ir suteikia prieigą prie užklausos rezultatų.
{% 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 %}
Atributai
Atributas | Aprašą |
---|---|
approximate_total_hits | Pateikiamas apytikslis visų rodyklės užklausą atitinkančių paspaudimų skaičius. Dėl to, kaip veikia paieškos indeksas, atsižvelgiant į saugos filtravimą ir kitus dizaino veiksnius, šis skaičius yra tik apytikslis ir kai kuriose situacijose gali tiksliai neatitikti bendro dabartiniam vartotojui pasiekiamų rezultatų skaičiaus. |
Puslapis | Nurodomas dabartinės užklausos puslapio numeris. |
page_size | Nurodomas maksimalus dabartinės užklausos puslapio dydis. Jei norite, kad būtų pateiktas faktinis dabartinio puslapio rezultatų skaičius (nes jis gali būti mažesnis už nurodytą maksimalų puslapio dydį), naudokite results.size. |
Rezultatai | Pateikiamas užklausos rezultatų puslapis kaip paieškos rodyklės rezultato objektai. |
Paieškos rodyklės rezultatai
Atributas | Aprašas |
---|---|
objektas | Esami rezultato objektai. |
fragment | Atitinkamas trumpas rezultato teksto fragmentas, kuriame nurodytos sąlygos, atitinkančios nurodytą užklausą, paryškintą naudojant HTML žymę <em>. Tam tikrų tipų užklausos nepalaiko paryškintų fragmentų, pvz., neaiškių užklausų (~) ir pakaitos simbolių užklausų (*). Tokiais atvejais ši savybė yra niekinė. |
Id | Esamo rezultato įrašo „Dataverse” lentelės ID kaip eilutė. Pavyzdžiui, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
logical_name | Esamo rezultato įrašo „Dataverse” lentelės loginis pavadinimas. Pavyzdžiui, adx_webpage |
Skaičius | Rezultato numeris visuose rezultatų puslapiuose, pradedant nuo 1. Pavyzdžiui, pirmojo antrojo rezultatų puslapio rezultato, kurio puslapio dydis yra 10, ši reikšmė yra 11. |
rezultatas | Rezultato „Lucene“ taškų skaičius kaip slankiojo kablelio reikšmė. Rezultatai pateikiami pagal šią reikšmę. |
pavadinimas | Rezultato pavadinimas. |
url | Rezultato URL. Tai dažniausiaibet nebūtinai yra dabartinės programos absoliutusis kelias, o ne visas URL. Pavyzdžiui: /articles/article1/ |
parametrai
Galite įkelti bet kurį svetainės parametrą pagal pavadinimą. Jei nustatymas su duotu vardu nerastas nėra jis grąžinamas.
Pastaba.
Parametrai pateikiami kaip eilutės, bet naudodami Tipų filtrus galite konvertuoti juos į kitus tipus.
{{ 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 %}
svetainės struktūra
Leidžia pasiekti portalo svetainės struktūrą.
<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 %}
Svetainės struktūros atributai
Atributas | Aprašas |
---|---|
Dabartinis | Grąžina dabartinio puslapio svetainės struktūros mazgo objektą. |
Šaknis | Grąžina šakninio (pagrindinio) puslapio svetainės žemėlapio mazgo objektą. |
Svetainės struktūros mazgo atributai
Atributas | Aprašas |
---|---|
Naršymo kelias | Pateikia mazgo naršymo kelio svetainės struktūros objektus pradedant svetainės struktūros šakniniu mazgu ir baigiant pirminiu. |
Antriniai | Grąžina mazgo antrinius svetainės struktūros mazgo objektus. |
Aprašas | Mazgo aprašas / santraukos turinys. (Šiame lauke gali būti HTML.) |
Entity | Pateikia esamus mazgo objektus. Jei mazge nėra pagrindinės lentelės, ši reikšmė yra neapibrėžta. |
is_sitemap_ancestor | Jei svetainės struktūros mazgas yra dabartinio mazgo prototipas, pateikia true, kitais atvejais pateikia false. |
is_sitemap_current | Jei svetainės struktūros mazgas yra dabartinis mazgas, pateikia true, kitais atvejais pateikia false. |
Pirminis | Grąžina mazgo pirminį svetainės struktūros mazgą. Jei mazgas yra šakninis mazgas, pirminis yra nulinis. |
Antraštė | Mazgo pavadinimas. |
url | Mazgo URL. |
svetainės žymekliai
Galite įkelti bet kurį svetainės žymeklį pagal pavadinimą. Jei svetainės žymeklis yra, grąžinamas svetainės žymeklio objektas. Jei svetainės žymeklis su nurodytu pavadinimu nerastas, nulis grąžinamas.
{{ 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 %}
Svetainės žymeklio atributai
Atributas | Aprašą |
---|---|
url | Svetainės žymeklio paskirties URL. |
[attribute logical name] | Bet kurį svetainės žymeklio paskirties „Dataverse‟ įrašo atributą galite surasti pagal loginį pavadinimą. Pavyzdžiui, {{ sitemarker.adx_name }} |
snippets (fragmentai)
Galite įkelti bet kuriuos turinio fragmentus pagal pavadinimą. Jei fragmentas su duotu pavadinimu nerastas, grąžinamas nulinis .
{{ snippets[Header] }}
{% assign footer = snippets[Footer] %}
{% if footer %}
{{ footer }}
{% else %}
No footer snippet was found.
{% endif %}
tablerowloop
Turi ypatybių, kurios naudingos iteracijos žymiųciklo bloke.
Pastaba.
„tablerowloop“ galima naudoti tik tarp iteracijos žymių.
Atributai
Atributas | Aprašas |
---|---|
Col | Pateikia dabartinės eilutės rodyklę, pradedant nuo 1. |
col0 | Pateikia dabartinės eilutės rodyklę, pradedant nuo 0. |
col_first | Grąžina teisingą, jei esamas laukelis yra pirmasis eilutėje, grąžina neteisingą jei taip nėra. |
col_last | Grąžina teisingą, jei esamas laukelis yra paskutinis eilutėje, grąžina neteisingą jei taip nėra. |
Pirmas | Pateikia true, jei ciklas kartojamas pirmą kartą. Pateikia false, jei ciklas kartojamas ne pirmą kartą. |
Rodyklė | Dabartinio elemento padėtis rinkinyje, kai pirmojo elemento padėtis yra 1. |
index0 | Dabartinio elemento padėtis rinkinyje, kai pirmojo elemento padėtis yra 0. |
Paskutinis | Pateikia true, jei ciklas kartojamas paskutinį kartą. Pateikia false, jei ciklas kartojamas ne paskutinį kartą. |
Ilgis | Grąžina ciklo pakartojimų skaičių ߝ skaičių rinkinio elementų kuriuose kartojama. |
Rindex | Likusių ciklo elementų skaičius (ilgis – rodyklė), kur 1 yra paskutinio elemento rodyklė. |
rindex0 | Likusių ciklo elementų skaičius (ilgis – rodyklė), kur 0 yra paskutinio elemento rodyklė. |
User
Nurodo dabartinį portalo vartotoją ir suteikia prieigą prie visų esamo Dataverse kontakto įrašo atributų. Jei nė vienas vartotojas nėra prisijungęs, šis kintamasis yra nulinis.
Vartotojas yra objekto objektas.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
Pastaba.
Power Pages portalų leidimo versija 9.3.8.x ar vėlesnis bus pabėgimo likvidų filtrą įjungtą vartotojo ir užklausos likvidžius objektus. Norėdami išjungti šią numatytąją konfigūraciją ir leisti naudoti šiuos Likvdižius objektus, žr portalo saito nustatymai - Site/EnableDefaultHtmlEncoding.
Atributai
Be to, kad vartotojas turi visus objektas objekto atributus, jis taip pat turi ir šiuos atributus.
Atributas | Aprašas |
---|---|
vaidmenys | Pateikia vaidmenis, kuriems vartotojas priklauso, kaip masyvą.{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %} Pastaba: filtrą has_role taip pat galite naudoti norėdami išbandyti atskiras vaidmenų narystes. |
basic_badges_url | Pateikia tarnybos URL vartotojo ženkleliams generuoti. Norėdami generuoti ženklelius vartotojui, turite įtraukti žymą su atributais "data-badge" ir "data-uri". Norint generuoti esamo vartotojo ženklelius: <div data-badge data-uri='{{user.basic_badges_url }}'></div> Norint sugeneruoti vartotojo ženklelius pagal ID (kintamasis „userid“): `<div data-badge data-uri='{{user.basic_badges_url |
weblinks
Leidžia jums įkelti bet kurį žiniatinklio saitą pagal pavadinimą arba ID.
Jei žiniatinklio saitų rinkinys yra, grąžinamas žiniatinklio saitų rinkinys objektas . Jei žiniatinklio saitų rinkinys su nurodytu vardu arba ID nerastas, nulis grąžinamas.
<!-- 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 %}
Žiniatinklio saitų rinkinio atributai
Pastaba.
žiniatinklio saitų rinkinys yra objekto objektas, turintis visus tuos pačius atributus, be šių atributų:
Atributas | Aprašą |
---|---|
Kopijavimas | Žiniatinklio saitų rinkinio HTML kopija. |
Pavadinimas | Žiniatinklio saitų rinkinio pavadinimas. |
Pareigos | Žiniatinklio saitų rinkinio antraštė. |
Weblinks | Su žiniatinklio saitų rinkiniu susietų žiniatinklio saito objektų masyvas. |
[attribute logical name] | Bet kurį žiniatinklio saitų rinkinio „Dataverse‟ įrašo atributą galite surasti pagal loginį pavadinimą. Pavyzdžiui, {{ weblinkset.createdon }} |
Žiniatinklio saito atributai
Pastaba.
Žiniatinklio susieti yra objekto objektas, turintis visus tuos pačius atributus, be šių atributų:
Atributas | Aprašą |
---|---|
Aprašą | Žiniatinklio saito HTML aprašas. |
display_image_only | Bulio funkcijos atributas, nurodantis, ar žiniatinklio saitas turėtų būti rodomas tik kaip vaizdas, be jokio nuorodos teksto. |
display_page_child_links | Bulio logikos atributas, nurodantis, ar žiniatinklio saite turėtų būti rodomos nuorodos į susieto puslapio svetainės struktūros antrinius puslapius kaip antrines nuorodas. |
Image | Šios nuorodos žiniatinklio saito vaizdo objektas. Šis atributas yra niekinis, jei nėra vaizdo. |
is_external | Bulio funkcijos atributas, nurodantis, ar žiniatinklio saito paskirties URL yra nuoroda į išorinę svetainę (o ne į vidinį portalo puslapį). |
is_sitemap_ancestor | Jei žiniatinklio saito URL yra nuoroda į dabartinio svetainės struktūros mazgo prototipą, rodoma true, kitais atvejais rodoma false. |
is_sitemap_current | Jei žiniatinklio saito URL yra nuoroda į dabartinį svetainės struktūros mazgą, rodoma true, kitais atvejais rodoma false. |
Pavadinimas | Žiniatinklio saito pavadinimas / antraštė. |
Nofollow | Bulio logikos atributas, nurodantis, ar žiniatinklio saitas turėtų būti pažymėtas kaip rel=nofollow. |
open_in_new_window | Bulio funkcijos atributas, nurodantis, ar žiniatinklio saitas jį pasirinkus turėtų būti atidaromas naujame naršyklės lange / skirtuke. |
Įrankio patarimas | Žiniatinklio saito patarimo tekstas. |
URL | Žiniatinklio saito URL. |
Weblinks | Su žiniatinklio saitu susietų antrinio žiniatinklio saito objektų masyvas. |
[attribute logical name] | Bet kurį žiniatinklio saito „Dataverse‟ įrašo atributą galite surasti pagal loginį pavadinimą. Pavyzdžiui, {{ weblink.createdon }} |
Žiniatinklio saito vaizdo atributai
alternate_text | Alternatyvusis vaizdo tekstas. |
---|---|
Aukštis | Sveikasis skaičius, apimantis nurodytą vaizdo aukštį. Jei aukščio reikšmė nepateikta, šis atributas yra neapibrėžtas (null). |
url | Vaizdo URL. |
Plotis | Sveikasis skaičius, apimantis nurodytą vaizdo plotį. Jei pločio reikšmė nepateikta, šis atributas yra neapibrėžtas (null). |
website (svetainė)
Nurodoma portalo svetainė, suteikiant prieigą prie visų portalo Dataverse svetainės (adx_website) įrašo atributų.
Pastaba.
Žiniatinklio svetainė yra objekto objektas, su visais tais pačiais atributais.
Kodas
{{ website.adx_name }} ({{ website.id }})
Išvesties
Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)
Atributai
Tolesnė lentelė išvardija atributus šiai žymai, kuri gali būti naudojama keičiant nustatytuosius siekiant išvengti žymėjimo.
Numatytoji reikšmė | Keitimai (vengia žymėjimo) | Pavyzdžiui |
---|---|---|
sign_in_url | sign_in_url_substitution | Numatytoji reikšmė: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F Pakeitimas (vengiama talpyklos): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("substitute-page" šiame pavyzdyje pakeičia numatytąją žymą URL.) |
sign_out_url | sign_out_url_substitution | Numatytoji reikšmė: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F Pakeitimas (vengiama kaupti talpykloje): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("substitute-page" šiame pavyzdyje pakeičia numatytąją žymą URL.) |