Galimi „Liquid“ objektai

„Liquid” objektų sudėtyje yra atributų, skirtų išvesti dinaminį turinį į puslapį. Pavyzdžiui, objekte page yra atributas, kurį title galite naudoti išvesdami dabartinio puslapio pavadinimą.

Norėdami pasiekti objekto atributą pagal pavadinimą, naudokite tašką (.). Norėdami sugeneruoti objekto atributą šablone, suvyniokite jį į {{ ir }}.

Svarbu

Norėdami išvengti galimų scenarijų vykdymo keliose svetainėse (XSS) problemų, visada naudokite kaitos filtrą HTML duomenims koduoti, kai naudojate "Liquid" objektus, kad perskaitytumėte nepatikimus duomenis, kuriuos pateikia vartotojas.

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

Bet kurioje šablono vietoje galite naudoti ir pasiekti toliau nurodytus objektus.

Objektas Aprašą
objektai Leidžia įkelti bet kurią "Microsoft Dataverse" lentelę pagal ID. Daugiau informacijos: Veiklos objektai
Nwo 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ą prie dabartinio puslapio naršymo kelio, dabartinio puslapio pavadinimo arba URL ir kitų esamo "Dataverse" įrašo atributų ar susijusių objektų. Daugiau informacijos: puslapis
params Patogus spartusis klavišas , skirtas 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
naudotojas 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
puslapis 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 Grąžina paskirties vietų objektą.
[ad pavadinimas ar id] Bet kurį skelbimą galite pasiekti pagal jo pavadinimo 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ą paskirties vietą galite pasiekti pagal jos pavadinimo arba ID ypatybes.
{% assign placement = ads.placements[Placement Name or Id] %}
{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Skelbimų paskirties 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. Šiame rinkinyje naudokite iteracijos žymes ir masyvo filtrus .
Pavadinimas / vardas ir pavardė Pateikiamas reklamos vietos laukas Pavadinimas.
placement_url URL, kurį galite naudoti, kad gautumėte pagal šabloną visiškai sugeneruotą skelbimo vietą.
random_url URL, kurį galite naudoti norėdami gauti atsitiktinį skelbimą iš paskirties vietos, visiškai sugeneruotą pagal šabloną.

Reklamos atributai

Pastaba.

Skelbimas yra lentelės objektas su visais tais pačiais atributais, be šių atributų:

Atributas Aprašą
ad_url URL, kurį galite naudoti, kad gautumėte visą šablono sugeneruotą skelbimą.
Kopijuoti Pateikiamas reklamos laukas Kopija.
atvaizdas Pateikiamas reklamos vaizdo objektas (jei yra).
Pavadinimas / vardas ir pavardė 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ą.

Skelbimo vaizdo atributai

Atributas Aprašą
alternate_text Grąžina tekstą, kuris rodomas žymės alternatyviajame atribute.
aukštis Grąžina vaizdo aukštį pikseliais.
URL Pateikiamas vaizdo URL šaltinis.
plotis Grąžina vaizdo plotį pikseliais.

interneto dienoraščiai

Įgalina interneto dienoraščių ir interneto dienoraščių įrašų nuskaitymą ir rodymą.

Naudodami tinklaraščių objektą galite pasirinkti konkretų interneto dienoraštį arba interneto dienorašč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>

tinklaraščių objektas

Interneto dienoraščių objektas leidžia pasiekti bet kurį konkretų portalo tinklaraštį arba pasiekti visus interneto dienoraščio įrašus portale.

Toliau pateiktoje lentelėje paaiškinami atributai, susieti su objektu blogs.

Atributas Aprašą
posts Pateikia tinklaraščio skelbimų objektą, kuriame yra visi portalo tinklaraščio skelbimai.
[tinklaraščio pavadinimas arba ID] Bet kurį tinklaraštį galite pasiekti pagal jo pavadinimo arba ID ypatybes.
{% assign blog = blogs["Blog Name"] %}                             

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

Objektas blog

Tinklaraščio objektas veikia su vienu interneto dienoraščiu, todėl galite pasiekti to interneto dienoraščio įrašus.

Šioje lentelėje paaiškinami įvairūs atributai, susiję su interneto dienoraščio objektu.

Atributas Aprašą
posts Pateikia tinklaraščio skelbimų objektą, kuriame yra visi tinklaraščio skelbimai.
Pavadinimas / vardas ir pavardė Interneto dienoraščio pavadinimas.
pavadinimas Interneto dienoraščio antraštė.
URL Interneto dienoraščio URL.

Objektas blogposts

Objektas blogposts suteikia prieigą prie interneto dienoraščio įrašo objektų rinkinio. Galite užsisakyti tinklaraščio įrašus ir pasiekti puslapių numeraciją naudodami skystus 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

Šioje lentelėje paaiškinami įvairūs atributai, susiję su objektu blogposts.

Atributas Aprašą
Viskas Grąžina visus rinkinyje esančius tinklaraščio įrašo objektus.

Objektas blogpost

Nurodo vieną interneto dienoraščio skelbimą.

Šioje lentelėje paaiškinami įvairūs atributai, susiję su blogpost objektu.

Atributas Aprašą
URL Skelbimo URL.
turinys Grąžina skelbimo lauką Turinys.
autorius Įrašo, kuris yra kontaktų lentelės objektas, autoriai.
pavadinimas Skelbimo antraštė.
comment_count Nurodyto įrašo komentarų skaičiaus sveikoji reikšmė.
publish_date Data, kada skelbimas buvo paskelbtas.

objektai

Perspėjimas

Norėdami išvengti galimų kelių svetainių scenarijų (XSS) problemų, visada naudokite kaitos filtrą HTML eilutės duomenims koduoti, kai naudojate objektus "Liquid" ir skaitote vartotojo pateiktus duomenis, kuriais negalite pasitikėti.

Pastaba.

Pasikeitė kai kurios "Dataverse" vardų suteikimo konvencijos. Pavyzdžiui, "Dataverse" objektai dabar vadinami lentelėmis. Pavadinimo pakeitimai netaikomi "Liquid" objektams. Likvidus objektų objektas ir toliau vadinamas objektais.

Naudokite šį objektą, jei norite įkelti bet kokią "Dataverse" lentelę pagal ID. Jei lentelė yra, ji pateikia lentelės objektą. Jei lentelė su nurodytu ID nerasta, ji grąžina neapibrėžtą 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 %}

Subjektas

Objekto objektas suteikia prieigą prie lentelės įrašo atributų Dataverse .

Atributas Aprašą
ID Lentelės GUID ID kaip eilutė. Pavyzdžiui, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Loginis „Dataverse” lentelės pavadinimas.
Pastabos Įkelia visas pastabas (komentarus), susietas su lentele, 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" 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šą
ID Nurodytosios lentelės GUID ID kaip eilutė.
Pavyzdžiui, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name „Dataverse” loginis nurodančios lentelės pavadinimas.
Pavadinimas / vardas ir pavardė 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šą
Ž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

Bandymai įkelti objektų refleksinius (t. y. savarankiškus nuorodų) ryšius grąžinami kaip objektai su šiais atributais.

Atributas Aprašą
is_reflexive Grąžina true (teisinga). 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), pateikite nuorodų objektų masyvą.

entitylist

Naudokite objektą entitylist"Dataverse" lentelės žymėse , kad pasiektumėte visus pateikto sąrašo atributus.

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 konfigūruotą sąrašo kūrimo saito arba mygtuko URL kelią.
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ą išsamios informacijos rodinio saitų arba sąrašo mygtukų žymą.
detail_url Pateikia sukonfigūruotą sąrašo išsamios informacijos rodinio saitų arba mygtukų URL kelią.
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 pirminį klientą. Pavyzdžiui, accountid
filter_apply_label Pateikia sukonfigūruotą lokalizuotą žymą, kuri bus naudojama saitui arba mygtukui, kuris sąrašo rezultatams pritaiko išplėstinį atributų filtrą.
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 naudojamas visoms lokalizuotoms šio sąrašo ž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.
[atributo loginis pavadinimas] 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 }}

Sąrašo rodinio atributai

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 "Dataverse" sveikojo skaičiaus kalbos kodą, naudojamą pasirinkti visas rodinio lokalizuotas žymas (stulpelių antraštes ir kitas žymas).
Pavadinimas / vardas ir pavardė 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 stulpelio 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 / vardas ir pavardė 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

Naudokite entityview objektą žyme entityview. Ji suteikia prieigą prie rodinio metaduomenų, taip pat peržiūrėti rezultatų įrašus.

Atributai

Atributas Aprašą
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.

events object

Naudokite objektą events norėdami pasiekti konkretų įvykį portale arba pasiekti visus portalo įvykius.

Objektas events turi šiuos atributus:

Atributas Aprašą
pasikartojim. Pateikia objektą, eventoccurrences kuriame yra visi įvykio atvejai portale.
[įvykio pavadinimas arba ID] Pasiekite bet kurį įvykį pagal jo pavadinimo arba ID ypatybes.
{% priskirti įvykį = events["Event Name"] %}
{% priskirti įvykį = įvykiai["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

įvykio objektas

Naudokite objektą event norėdami dirbti su vienu įvykiu. Galite pasiekti to įvykio tvarkaraščius ir pasikartojimus.

Objektas event turi šiuos atributus:

Atributas Aprašą
pasikartojim. Grąžina įvykio atsitikimo objektą su visais atsitikusiais įvykiais įvykiui.
pavadinimas / vardas ir pavardė Į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] %}
{% assign occurances = event.occurrences.min[today].max[advance_date] %}

Šie atributai yra susieti su objektu eventoccurrences

Atributas Aprašą
Viskas 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šą
pirmas Pateikia true, jei ciklas kartojamas pirmą kartą. Pateikia false, jei ciklas kartojamas ne pirmą kartą.
kurti 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.
Last 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ė naudoti skystį forumo duomenims atvaizduoti apima ir įrašus, tačiau norėdami sukurti naują įrašą ar giją, turite naudoti ASP.NET kelių žingsnių formų puslapio šabloną su minėtomis funkcijomis (pvz., numatytuosius forumo gijos ir forumo įrašų puslapio šablonus).

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

Forumo objektas leidžia jums dirbti su vienu forumu, kad galėtumėte pasiekti to forumo gijas.

forumthreads objektas leidžia pasiekti forumthread objektų rinkinį. Galite užsisakyti forumo temas ir pasiekti numeraciją naudodami "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šą
threads Pateikia objektą forumthreads, kuriame yra visi objektai forumthread, esantys portale.
Viskas 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] Galite pasiekti bet kurį forumą pagal jo pavadinimo arba ID ypatybes.
'{% priskirti forumą = forumai[Forumo pavadinimas] %}
{% priskirti forumą = forumai[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Objektas forum

Atributai

Pastaba.

Subjektai

Atributas Aprašą
threads Pateikia objektą forumthreads, kuriame yra visos forumo gijos.
Pavadinimas / vardas ir pavardė 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šą
Viskas 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.
autorius 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šą
Viskas Pateikia visus rinkinyje esančius objektus forumthread.

Vienas forumo skelbimas

Atributai

Pastaba.

Subjektai

Atributas Aprašą
autorius Grąžina įrašo autorių (kuris yra tiesiog kontaktų lentelės objektas).
turinys Skelbimo turinys.
is_answer Ar šis įrašas yra gijos atsakymas?

informacija

Suteikia prieigą prie „Dataverse“ informacinių straipsnių ir kategorijų lentelių įrašų, kad straipsniai ir kategorijos būtų atvaizduoti portale.

Atributai

Atributas Aprašą
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šą
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 %}

Objektas Categories

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šą
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 / vardas ir pavardė Alternatyvus straipsnio pavadinimas.
įvertinimas Straipsnio reitingo vertė dešimtainėje sistemoje.
pavadinimas 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 / vardas ir pavardė Alternatyvus kategorijos pavadinimas.
pavadinimas Kategorijos pavadinimas.

kalba

Suteikia esamą kalbos pavadinimą ir kalbos kodą, jei kelios palaikomos kalbos įjungtos.

Atributai

Atributas Aprašą
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 / vardas ir pavardė Esamos kalbos pavadinimas.
kodas 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.

įrašyti

Kūrėjai turi galimybę įtraukti žurnalo teiginius į savo skystąjį kodą. Kai veikia Power pages svetainė, kūrėjo pridėti žurnalai į "Liquid" kodą rodomi kūrėjo įrankio plėtinyje Power Pages / c0>. Š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šą
įrašyti Skysto objekto pavadinimas
pranešimas 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.
pirminis Pateikia puslapio pirminį svetainės struktūros mazgą. Jei puslapis yra pagrindinis puslapis, pirminis puslapis 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 pasiekti pagal jos pavadinimo 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 pasiekti pagal jos pavadinimo 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šą
Pavadinimas / vardas ir pavardė 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 / vardas ir pavardė 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.

  • 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 leidimo versijoje 9.3.8.x arba naujesnėje versijoje pagal numatytuosius nustatymus bus escapeuser ir request Liquid objektams. 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šą
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šą
esybė 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. Šis URL paprastai (bet nebūtinai) yra absoliutus dabartinės programos kelias, o ne visas URL. Pavyzdžiui: /articles/article1/

serverio logika

Generuojant "Liquid" šabloną, serverlogic žymė iškviečia serverio logikos operaciją. Žymės output parametras serverlogic sukuria objektą. Objektas nepasiekiamas kaip visuotinis "Liquid" objektas.

Sintaksė

{% serverlogic name: 'server-logic-name', operation: 'operation-name', input: inputData, output: result %}

Parametrai

Parametras Privalomas Aprašą
name Taip Iškviečiamo serverio logikos įrašo pavadinimas.
operation Taip "JavaScript" funkcijos, iškviečiamos serverio logikos įraše, pavadinimas.
input No Eilutė, kuri pereina į serverio logikos operaciją. Naudokite JSON eilutę, kad perduotumėte struktūrinius duomenis. Operacija gali pasiekti reikšmę per Server.Context.Input.
output Taip Skysčio kintamojo, gaunančio serverio logikos rezultato objektą, pavadinimas.

Toliau pateiktame pavyzdyje JSON įvestis perduodama į serverio logikos operaciją:

{% assign inputData = '{"category":"active","maximumResults":5}' %}

{% serverlogic name: 'customer-summary', operation: 'getSummary', input: inputData, output: result %}

{% if result.success %}
  <p>{{ result.data.message | escape }}</p>
{% else %}
  <p>The customer summary couldn't be retrieved.</p>
{% endif %}

Serverio logikos operacijoje naudokite Server.Context.Input norėdami skaityti įvestį:

function getSummary() {
    var input = JSON.parse(Server.Context.Input || "{}");

    return JSON.stringify({
        message: "Summary retrieved",
        category: input.category,
        maximumResults: input.maximumResults
    });
}

Sužinokite daugiau skambučių serverio logiką iš "Liquid".

Atributai

Atributas Aprašą
success Grąžina, kai serverio logikos operacija sėkmingai baigiama true ; kitu atveju pateikia false.
status_code Grąžina serverio logikos operacijos būsenos kodą. Vykdymo klaida pateikia būsenos kodą 500.
data Grąžina analizuojamą JSON reikšmę, kurią sukuria serverio logikos operacija. Įdėtuosius objektus ir masyvus galite pasiekti naudodami standartinę "Liquid" sintaksę.
raw_result Grąžina neanalizuotą atsakymą, gautą atliekant serverio logikos operaciją. Naudokite šį atributą, kai atsakymas negalioja JSON arba kai reikia patikrinti pradinį atsakymą.

Svarbu

Laikyti įvestį ir reikšmes, kurias pateikia serverio logika, kaip nepatikimus duomenis. Patikrinkite įvestį serverio logikos operacijoje ir taikykite escape filtrą prieš generuojant pateiktas eilutes HTML formatu.

parametrai

Naudokite šį objektą, jei norite įkelti bet kurį svetainės parametrą pagal pavadinimą. Jei portalas negali rasti parametro su pateiktu pavadinimu, jis grąžina neapibrėžtą reikšmę.

Pastaba.

Portalas grąžina parametrus kaip eilutes, tačiau galite naudoti tipo filtrus , kad konvertuotumėte 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

Naudokite šį objektą, jei norite 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šą
Dabartinė Grąžina dabartinio puslapio svetainės struktūros mazgo objektą.
Šaknis Grąžina šakninio (pagrindinio) puslapio svetainės žemėlapio mazgo objektą.

Svetainės schemos mazgo atributai

Atributas Aprašą
Naršymas 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šą Mazgo aprašas / santraukos turinys. (Šiame lauke gali būti HTML.)
Subjektas 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.
Parent Grąžina mazgo pirminį svetainės struktūros mazgą. Jei mazgas yra šakninis mazgas, tėvas 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 %}

Sitemarker atributai

Atributas Aprašą
URL Svetainės žymeklio paskirties URL.
[atributo loginis pavadinimas] 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 nurodytu pavadinimu nerastas, grąžinamas nulis (null ).

{{ 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šą
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.
Pirma 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.
Last 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 leidimo 9.3.8.x arba naujesnė versija įgalina "Escape Liquid" filtrą pagal numatytuosius parametrus vartotojui ir prašo "Liquid" objektų. Norėdami išjungti šią numatytąją konfigūraciją ir leisti šiuos "Liquid" objektus be "Liquid" filtro, žr. portalo svetainės parametrai – Site/EnableDefaultHtmlEncoding.

Atributai

Be to, kad vartotojas turi visus objektas objekto atributus, jis taip pat turi ir šiuos atributus.

Atributas Aprašą
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>
Jei norite pateikti naudotojo ženklelius pagal ID (kintamąjį userid), atlikite toliau nurodytus veiksmus.
'<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ų rinkinio objektas . Jei žiniatinklio saitų rinkinys su nurodytu pavadinimu 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šą
Kopijuoti Žiniatinklio saitų rinkinio HTML kopija.
Pavadinimas / vardas ir pavardė Žiniatinklio saitų rinkinio pavadinimas.
Antraštė Žiniatinklio saitų rinkinio antraštė.
Weblinks Su žiniatinklio saitų rinkiniu susietų žiniatinklio saito objektų masyvas.
[atributo loginis pavadinimas] Bet kurį žiniatinklio saitų rinkinio „Dataverse‟ įrašo atributą galite surasti pagal loginį pavadinimą. Pavyzdžiui, {{ weblinkset.createdon }}

Pastaba.

Žiniatinklio saitas 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.
Nuotrauka Š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 / vardas ir pavardė Ž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.
Patarimas Žiniatinklio saito patarimo tekstas.
URL Žiniatinklio saito URL.
Weblinks Su žiniatinklio saitu susietų antrinio žiniatinklio saito objektų masyvas.
[atributo loginis pavadinimas] 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).

puslapis

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) Pavyzdys
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 žiūrėkite

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