Bendrinti naudojant


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>

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

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.
  • Peržvalgos (Susietos lentelės nuorodos) laukai grąžinami kaip susieti lentelės nuorodos objektai.
  • Laukai Parinkčių rinkinys / Išrinkimo sąrašas grąžinami kaip parinkčių rinkinio reikšmės objektai.
  • Taip pat galite įkelti visus susijusius objektus pagal ryšio schemos pavadinimą.
  • {{ 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ą.

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.

Subjektai

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.

Subjektai

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.

Subjektai

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.

Subjektai

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.

Subjektai

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.
  • Peržvalgos (Susietos lentelės nuorodos) laukai grąžinami kaip susieti lentelės nuorodos objektai.
  • Laukai Parinkčių rinkinys / Išrinkimo sąrašas pateikiami kaip parinkčių rinkinio reikšmės objektai.
  • Taip pat galite įkelti visus susijusius objektus pagal ryšio schemos pavadinimą.
    {{ 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.

Subjektai

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.

Subjektai

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.

Subjektai

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.

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

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

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

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

Taip pat žr.

Skysčių tipai
Skystos žymos
Skysčių filtrai