Galimi „Liquid“ objektai
Pastaba
Nuo 2022 m. spalio 12 d. „Power Apps“ portalai tampa „Power Pages“. Daugiau informacijos: „Microsoft Power Pages“ dabar yra visuotinai prieinama (tinklaraštis)
Greitai perkelsime ir suliesime „Power Apps“ portalų dokumentaciją su „Power Pages“ dokumentacija.
„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šas |
---|---|
objektai | Leidžia jums įkelti bet kurią „Power Apps” lentelę pagal ID. Daugiau informacijos: objektai |
dabar | Objektas data / laikas, kuriame nurodomas dabartinis UTC laikas, tuo metu, kai pateikiamas šablonas. Pastaba: Ši vertė yra paimama portalo žiniatinklio programos ir nėra naujinama kas 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 „Power Apps‟ įrašo atributų arba susijusių objektų. Daugiau informacijos: puslapis |
params | Patogi nuoroda į request.params. Daugiau informacijos: užklausa |
užklausa | Yra informacijos apie dabartinę HTTP užklausą. Daugiau informacijos: užklausa |
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: svetainės struktūra |
svetainės žymekliai | Galite įkelti bet kurį svetainės žymeklį pagal pavadinimą. Daugiau informacijos: svetainės žymekliai |
snippets (fragmentai) | Galite įkelti bet kurį turinio fragmentą pagal pavadinimą. Daugiau informacijos: fragmentai |
vartotojas | Nurodo dabartinį portalo vartotoją ir suteikia prieigą prie visų esamo Power Apps kontakto įrašo atributų. Jeigu neprisijungęs nė vienas vartotojas, šis kintamasis bus neapibrėžtas. Daugiau informacijos: vartotojas |
weblinks | Leidžia jums įkelti bet kurį Žiniatinklio saitų rinkinį pagal pavadinimą arba ID. Daugiau informacijos: žiniatinklio saitai |
website (svetainė) | Nurodomas portalo žiniatinklio svetainės įrašas, suteikiantis prieigą prie visų portalo „Power Apps‟ svetainės (adx_website) įrašo atributų. Daugiau informacijos: žiniatinklio svetainė |
ads (reklamos)
Suteikia galimybę pasiekti ir pateikti reklamą.
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šas |
---|---|
placements | Pateikiamas adplacements (reklamos vietų) objektas. |
[reklamos pavadinimas arba 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šas |
---|---|
[reklamos vietos pavadinimas arba 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
Reklamos išdėstymas yra lentelės objektas, turintis tuos pačius bendruosius atributus, taip pat toliau išvardytus atributus.
Atributas | Aprašas |
---|---|
Reklama | Pateikiamas su vieta susijusių reklamos objektų rinkinys. Su šiuo rinkiniu galima naudoti iteracijos žymes ir masyvo filtrus. |
Pavadinimas | 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
Reklama yra lentelės objektas, turintis tuos pačius atributus bei išvardytus toliau.
Atributas | Aprašas |
---|---|
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). |
Pavadinimas | 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į bus nukreiptas vartotojas, pasirinkęs reklamą. |
Reklamos vaizdo atributai
Atributas | Aprašas |
---|---|
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
Suteikia galimybę pasiekti interneto dienoraščius ir interneto dienoraščių skelbimus ir generuoti jų vaizdą.
Objektas blogs leidžia pasirinkti konkretų tinklaraštį ar tinklaraščio įrašus.
{% assign posts = blogs.posts | paginate: 0,4 %}
<div class=content-panel panel panel-default>
<div class=panel-heading>
{% assign sitemarker = sitemarkers["Blog Home"] %}
{% assign snippet = snippets[Home Blog Activity Heading] %}
<a class=pull-right href={{sitemarker.url}}> All Blogs </a>
<h4>
<a class=feed-icon fa fa-rss-square href={{ blogs.feedpath }} />
{{ snippet.adx_value }}
</h4>
</div>
<ul class=list-group>
{% for post in posts.all %}
<li class=list-group-item >
<a class=user-avatar href={{ post.author_url }}>
<img src={{ post.user_image_url }} />
</a>
<h4 class=list-group-item-heading>
<a href={{ post.app_relative_path }}>{{ post.title }}</a>
</h4>
<div class=content-metadata>
<abbr class=timeago>{{ post.publish_date }}</abbr>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<a href={{ post.application_path }}#comments>
<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}
</a>
</div>
</li>
{% endfor %}
</ul>
</div>
Objektas blogs
TInklaraščių objektai leidžia jums prieiti prie konkretaus tinklaraščio portale arba prieiti prie visų įrašų portale.
Toliau pateiktoje lentelėje paaiškinami atributai, susieti su objektu blogs.
Atributas | Aprašas |
---|---|
posts | Pateikia objektą blogposts, kuriame yra visi tinklaraščių įrašai, esantys portale. |
[tinklaraščio pavadinimas arba ID] | Bet kurį tinklaraštį galite peržiūrėti pagal jo pavadinimą arba ID ypatybes. |
{% assign blog = blogs["Blog Name"] %}
{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Objektas blog
Objektas blog leidžia dirbti su vienu tinklaraščiu, leisdamas pasiekti to tinklaraščio įrašus.
Toliau pateiktoje lentelėje paaiškinami įvairūs atributai, susieti su objektu blog.
Atributas | Aprašas |
---|---|
posts | Pateikia objektą blogposts, kuriame yra visi to tinklaraščio įrašai. |
Pavadinimas | Interneto dienoraščio pavadinimas. |
title | Interneto dienoraščio antraštė. |
URL | Interneto dienoraščio URL. |
Objektas blogposts
Blogposts objektas leidžia pasiekti interneto dienoraščio skelbimų objektų rinkinį. Galite tvarkyti interneto dienoraščio skelbimus ir taikyti laužymą puslapiais, taip pat naudoti „Liquid“ filtrus.
{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}
Kitos galimos parinktys:
blogs.posts.all
(norint gauti visus tinklaraščių į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
Dėmesio
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ą „Power Apps” lentelę pagal ID. Jei lentelė egzistuoja, lentelės objektas bus grąžintas. Jei nerandama lentelė su nurodytu ID, bus grąžinta 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 %}
Objektas
Objektas „entity” suteikia prieigą prie „Power Apps” lentelės įrašo atributų.
Atributas | Aprašas |
---|---|
Id | Lentelės GUID ID kaip eilutė. Pavyzdžiui, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
logical_name | Loginis „Power Apps” lentelės pavadinimas. |
Pastabos | Įkelia visas pastabas („annotation”), susijusias su lentele, išrikiuotas 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 Apps” portalų turinio valdymo sistemos URL kelią. Jei lentelė neturi galiojančio URL dabartinėje svetainėje, pateikiama nulinė reikšmė. Paprastai bus grąžinama tik tam tikrų lentelės tipų, kurie buvo integruoti į portalo CMS, reikšmė, nebent tinkinote URL teikėją savo programoje. |
[atributo arba ryšio pavadinimas] | Galite pasiekti bet kurį „Power Apps” lentelės atributą pagal loginį pavadinimą. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Daugumos lentelių atributų reikšmės susieja tiesiogiai su „Liquid” tipais: Dviejų parinkčių laukai susieja su Bulio logika, o teksto laukai – su eilute, skaitiniai/valiutos laukai – su skaičiais, datos/laiko laukai – su datos objektais. Tačiau kai kurie atributų tipai pateikiami kaip objektai.
{{ page.adx_webpage_entitylist.adx_name }} Tais atvejais, kada ryšys yra refleksinis (t. y. nurodantis į save), bus pateiktas refleksinio ryšio objektas. (Priešingu atveju rezultatas būtų neaiškus.){{ page.adx_webpage_webpage.referencing.adx_name }} Pastaba: daugelio susijusių objektų įkėlimas arba daugelio ryšių pasiekimas viename šablone gali turėti neigiamos įtakos šablono laukų vaizdo generavimo efektyvumui. 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 | „Power Apps” loginis nurodančios lentelės pavadinimas. |
Pavadinimas | 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 atributų, pastaba turi šiuos papildomus atributus.
Atributas | Aprašas |
---|---|
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 likusių atributų pastaba, jis įkeliamas į paklausą. Pastaba: atributo documentbody naudojimas gali turėti neigiamos įtakos šablono vaizdo generavimo efektyvumui, todėl tai reikėtų 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ą, pateikus šiam URL užklausą parsiųstas pastabos failo priedas. |
Pastaba
Parinkčių rinkinio reikšmė
Parinkčių rinkinio/išrinkimo sąrašo reikšmės yra grąžinamos kaip susietosios lentelės nuorodos objektai su toliau nurodytais atributais.
Atributas | Aprašas |
---|---|
Žyma | Lokalizuota parinkčių rinkinio / išrinkimo sąrašo atributo reikšmės žymė. Pavyzdžiui, Aktyvus |
Reikšmė | Parinkčių rinkinio / išrinkimo sąrašo atributo reikšmės sveikoji reikšmė. Pavyzdžiui, 0 |
Lentelės teisės
Lentelės teisių objektas suteikia prieigą prie agreguotos lentelės teisės apsaugos rezultatų.
Atributas | Aprašas |
---|---|
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. Pateikia „false“, jei tai yra numatytieji rezultatai nesant 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šas |
---|---|
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 „Power Apps” „Dataverse” lentelės žymėse. Jis suteikia prieigą prie visų pateikto sąrašo atributų.
Atributai
Pastaba
Atributas | Aprašas |
---|---|
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 „Power Apps” lentelės loginį pavadinimą, skirtą įrašams rodyti šiame sąraše. Pavyzdžiui, kontaktas |
filter_account_attribute_name | Pateikia paskyros peržvalgos atributo loginį pavadinimą. Pavadinimas naudojamas rezultato įrašams filtruoti pagal dabartinį portalo vartotojo pirminį klientą. 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 | Pateikia kontakto peržvalgos atributo loginį pavadinimą. Pavadinimas naudojamas rezultato įrašams filtruoti pagal dabartinį portalo vartotojo kontaktą. Pavyzdžiui, contactid |
filter_website_attribute_name | Pateikia adx_website peržvalgos atributo loginį pavadinimą. Pavadinimas naudojamas rezultato įrašams filtruoti pagal dabartinę portalo svetainę. Pavyzdžiui, adx_websiteid |
language_code | Pateikia „Power Apps” 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. |
[atributo loginis pavadinimas] | Bet kurį „Power Apps” įrašų sąrašo (adx_entitylist) 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šas |
---|---|
stulpeliai | Pateikia rodinio stulpelius kaip sąrašo rodinio stulpelių objektus. |
entity_logical_name | Pateikia „Power Apps” lentelės loginį pavadinimą, skirtą į rodinį įtrauktiems įrašams. Pavyzdžiui, kontaktas |
Id | Pateikia rodinio GUID ID. |
language_code | Pateikia „Power Apps” sveikojo skaičiaus kalbos kodą, kuris bus naudojamas visoms rodinio lokalizuotoms žymoms (stulpelių antraštėms ir pan.). |
Pavadinimas | Pateikia rodinio „Power Apps” rodomą pavadinimą. |
primary_key_logical_name | Pateikia „Power Apps” 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šas |
---|---|
attribute_type | Pateikia stulpelio „Power Apps‟ atributo tipo pavadinimą kaip eilutę. Pavyzdžiui, Peržvalga, Išrinkimo sąrašas, Eilutė, Bulio logika, Data ir laikas |
logical_name | Pateikia stulpelio „Power Apps‟ atributo loginį pavadinimą. Pavyzdžiui, createdon |
Pavadinimas | Pateikia stulpelio lokalizuotą „Power Apps‟ 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 false. |
sort_enabled | Pateikia true, jei įjungta stulpelio rūšiavimo funkcija. Kitu atveju pateikia false. |
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šų „Power Apps” lentelės loginis pavadinimas. Pavyzdžiui, kontaktas |
first_page | Rodinio rezultatų pirmojo puslapio numeris. Jis bus 1, nebent nebuvo pateikta jokių rezultatų, nes tokiu atveju jis bus null. |
Id | Šį entityview apibrėžiančio „Power Apps“ rodinio GUID ID. |
language_code | „Power Apps‟ sveikojo skaičiaus kalbos kodas, kuris naudojamas norint įkelti dabartinio rodinio lokalizuotas žymas. |
last_page | Rodinio rezultatų paskutinio puslapio numeris. Jei nebuvo pateikta jokių rezultatų, jis bus null. |
pavadinimas | Šį entityview apibrėžiančio „Power Apps‟ rodinio pavadinimas, pavyzdžiui, Aktyvieji kontaktai. |
next_page | Rodinio rezultatų kito puslapio numeris. Jei nėra kito rezultatų puslapio, jis bus null. |
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, jis bus null. |
primary_key_logical_name | Šio rodinio rezultatų lentelės pirminio pagrindinio atributo „Power Apps” 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
Suteikia galimybę pasiekti ir pateikti įvykius. 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šas |
---|---|
occurences | 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["Įvykio pavadinimas"] %} {% 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 tvarkyti įvykio atvejus ir nurodyti datos diapazoną atvejams gauti, taip pat taikyti laužymą puslapiais ir naudoti kintamus filtrus.
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
Atkreipkite dėmesį, kad
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
taip pat galima.
Š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 susieti atributai.
Atributas | Aprašas |
---|---|
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švestis
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
Suteikia galimybę naudotis ir generuoti forumus ir forumų gijas. 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 arba ID] | Bet kurį forumą galite peržiūrėti pagal jo pavadinimą arba ID ypatybes. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %} |
Objektas forum
Atributai
Pastaba
Atributas | Aprašą |
---|---|
threads | Pateikia objektą forumthreads, kuriame yra visos forumo gijos. |
Pavadinimas | Forumo pavadinimas. |
thread_count | Pateikia reikšmę sveikojo skaičiaus, nurodančio, kiek gijų yra forume. |
post_count | Pateikia reikšmę sveikojo skaičiaus, nurodančio, kiek visame forume yra įrašų. |
Objektas forumthreads
Atributai
Atributas | Aprašas |
---|---|
Vis. | Pateikia visus rinkinyje esančius objektus forumthread. |
Objektas forumthread
Atributai
Pastaba
Atributas | Aprašas |
---|---|
posts | Pateikia objektą forumposts, kuriame yra visi forumo gijos įrašai. |
author | Grąžina gijos autorių (kuris yra tiesiog kontaktų lentelės objektas). |
latest_post | Pateikia naujausią gijos skelbimą. |
first_post | Pateikia pirmą gijos skelbimą. |
post_count | Pateikia reikšmę sveikojo skaičiaus, nurodančio, kiek įrašų yra gijoje. |
is_answered | Ar gija atsakyta ar ne? |
is_sticky | Ar gija fiksuota? |
Objektas forumposts
Atributai
Atributas | Aprašas |
---|---|
Vis. | Pateikia visus rinkinyje esančius objektus forumthread. |
Vienas forumo skelbimas
Atributai
Pastaba
Atributas | Aprašas |
---|---|
author | Grąžina įrašo autorių (kuris yra tiesiog kontaktų lentelės objektas). |
content | Skelbimo turinys. |
is_answer | Ar šis įrašas yra gijos atsakymas? |
žinių bazė
Suteikia prieigą prie „Power Apps“ 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. Filtrus galima derinti su kitais „Liquid“ filtrais.
{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Atributas | Aprašas |
---|---|
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. Filtrus galima derinti su kitais „Liquid“ filtrais.
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Atributas | Aprašas |
---|---|
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, turintis tuos pačius atributus, be išvardytų toliau.
Atributas | Aprašas |
---|---|
article_public_number | Viešasis straipsnio numeris. |
comment_count | Sveikojo skaičiaus reikšmė – tam tikro straipsnio komentarų skaičius. |
content | 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 reikšmė, nurodanti, kiek kartų straipsnis buvo peržiūrėtas. |
kategorijų objektas
Kategorijų objektas leidžia dirbti su viena kategorija ir parodyti išsamią informaciją apie ją portale.
Atributai
kategorija yra objekto objektas, turintis tuos pačius atributus, be išvardytų toliau.
Atributas | Aprašas |
---|---|
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.
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 „Power Apps‟ įrašo atributų arba susijusių objektų.
<ul class=breadcrumb>
{% for crumb in page.breadcrumbs %}
<li><a href={{ crumb.url | escape }}>{{ crumb.title | escape }}</a></li>
{% endfor %}
<li class=active>{{ page.title | escape }}</li>
</ul>
<div class=page-header>
<h1>{{ page.title | escape }}</h1>
</div>
<div class=page-copy>
{{ page.adx_copy }}
</div>
<div class=list-group>
{% for child in page.children %}
<a class=list-group-item href={{ child.url | escape }}>
{{ child.title | escape }}
</a>
{% endfor %}
</div>
<!-- Page {{ page.id }} was last modified on {{ page.modifiedon }}. -->
Puslapio atributai
Pastaba
Atributas | Aprašas |
---|---|
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, parent bus null. |
title | Puslapio pavadinimas. |
URL | Puslapio URL. |
[atributo arba ryšio pavadinimas] | Bet kurį esamą puslapio „Power Apps‟ įrašo atributą galite surasti pagal loginį pavadinimą.{{ page.createdon }} {% assign attribute_name = 'name' %} {{ page[attribute_name] }} Daugumos lentelių atributų reikšmės susieja tiesiogiai su „Liquid” tipais: Dviejų parinkčių laukai susieja su Bulio logika, o teksto laukai – su eilute, skaitiniai/valiutos laukai – su skaičiais, datos/laiko laukai – su datos objektais. Tačiau kai kurie atributų tipai pateikiami kaip objektai.
{{ page.adx_webpage_entitylist.adx_name }} Jei ryšys grįžtamasis (t. y., nurodantis į save), bus pateikiamas objektas objektai. (Priešingu atveju rezultatas būtų neaiškus.) {{ page.adx_webpage_webpage.referencing.adx_name }} Pastaba: daugelio susijusių objektų įkėlimas arba daugelio ryšių pasiekimas viename šablone gali turėti neigiamos įtakos šablono laukų vaizdo generavimo efektyvumui. Venkite įkelti kiekvieno masyvo elemento susijusius objektus per vieną ciklą. Jei įmanoma, geriau naudokite „Power Apps” „Dataverse” lentelių žymas objektų rinkiniams įkelti. |
apklausos
Suteikia galimybę pasiekti ir sugeneruoti apklausą.
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šas |
---|---|
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šas |
---|---|
[apklausos vietos pavadinimas arba ID] | Bet kurią apklausos vietą galite peržiūrėti pagal jos pavadinimą arba ID ypatybes.{% assign placement = polls.placements[Placement Name or Id] %} {% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %} |
Apklausos vietų atributai
Pastaba
Atributas | Aprašas |
---|---|
Pavadinimas | Pateikia apklausos vietos lauką „Pavadinimas“. |
placement_url | URL, kuris gali būti naudojamas norint gauti šablone pateikiamą visą apklausos vietą. |
apklausos | Pateikia su vieta susijusių apklausos objektų rinkinį. Su šiuo rinkiniu galima naudoti iteracijos žymes ir masyvo filtrus. |
random_url | URL, kuris gali būti naudojamas norint gauti atsitiktinę apklausą iš šablone pateikiamos visos apklausos vietos. |
submit_url | URL, kuriame pateikiama baigta apklausa. |
Apklausų atributai
Pastaba
Atributas | Aprašas |
---|---|
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 | Pateikia objektą polloption, kurį pažymėjo vartotojas (jei jau balsavo). |
balsai | Pateikia balsų skaičių, kurie buvo sutraukti į apklausos lentelę. |
Apklausos parinkčių atributai
Pastaba
Atributas | Aprašas |
---|---|
atsakymas | Pateikia apklausos lauką „Atsakymas“. |
procentas | Pateikia apklausos parinkties balsų procentą dešimtainiu skaičiumi nuo 0 iki 100. |
balsai | Pateikia balsų skaičių, kurie buvo sutraukti į parinkties lentelę. |
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 Apps“ portalų leidimo versija 9.3.8.x ar vėlesnis bus pabėgimo likvidų filtrą įjungtą vartotojo ir užklausos likvidžius objektus. Norėdami išjungti šią numatytąją konfigūraciją ir leisti naudoti šiuos Likvdižius objektus, žr portalo saito nustatymai - Site/EnableDefaultHtmlEncoding.
Atributai
Atributas | Aprašymas |
---|---|
params | Dabartinės užklausos parametrų reikšmės, kurioms suteiktas pavadinimas. params yra URL užklausos eilutės parametrų formos, formos registravimo parametrų ir slapukų derinys. |
Kelias | Dabartinės užklausos URL kelias. /profile/ |
path_and_query | Dabartinės užklausos URL kelias ir užklausa. /profile/?foo=1&bar=something |
užklausa | Dabartinės užklausos URL dalis su užklausa. ?foo=1&bar=something |
URL | Visas dabartinės užklausos URL. https://www.example.com/profile/?foo=1&bar=something |
searchindex
Ieškos rodyklės objektas („searchindex”) naudojamas tarp „Power Apps” „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šas |
---|---|
approximate_total_hits | Pateikiamas apytikslis visų rodyklės užklausą atitinkančių paspaudimų skaičius. Dėl būdo, kuriuo paieškos indeksas veikia susijęs su saugumo filtravimu ir kitais sukurtais faktoriais, šis skaičius yra tik apibendrintas ir negali tiksliai atitikti bendro rezultatų skaičius prieinamo konkrečiam vartotojui kai kuriose situacijose. |
Puslapis | Nurodomas dabartinės užklausos puslapio numeris. |
page_size | Nurodomas maksimalus dabartinės užklausos puslapio dydis. Jei norite realaus rezultatų skaičiaus grąžininmo į esamą puslapį (dėl to, kad jis gali būti mažesnis nei nurodytas maksimalių puslapių dydis), naudokite rezultatų.dydį. |
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>. Kai kurie užklausų tipai nepalaiko paryškintų fragmentų, tokių kaip susiliejusių užklausų (~) ir nestandartinių užklausų (*). Tais atvejais ši ypatybė bus nulinė. |
Id | Esamo rezultato įrašo „Power Apps” lentelės ID kaip eilutė. Pavyzdžiui, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
logical_name | Esamo rezultato įrašo „Power Apps” lentelės loginis pavadinimas. Pavyzdžiui, adx_webpage |
Skaičius | Rezultato numeris visuose rezultatų puslapiuose, pradedant nuo 1. Pvz., antrojo rezultatų puslapio, kurio puslapio dydis 10, pirmojo rezultato reikšmė bus 11. |
rezultatas | Rezultato „Lucene“ taškų skaičius kaip slankiojo kablelio reikšmė. Bus pateikiami pagal šią vertę užsakyti rezultatai. |
pavadinimas | Rezultato pavadinimas. |
URL | Rezultato URL. Tai dažniausiai—bet 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.) |
Objektas | Pateikia esamus mazgo objektus. Jei mazge nėra pamatinės lentelės, ši reikšmė bus nulinė. |
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, parent bus null. |
Pareigos | Mazgo pavadinimas. |
URL | Mazgo URL. |
svetainės žymekliai
Galite įkelti bet kurį svetainės žymeklį pagal pavadinimą. Jei svetainės žymeklis egzistuoja, bus pateiktas svetainės žymeklio objektas. Jei saito žymeklis su duotu vardu nerastas nėra jis 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šas |
---|---|
URL | Svetainės žymeklio paskirties URL. |
[atributo loginis pavadinimas] | Bet kurį svetainės žymeklio paskirties „Power Apps‟ į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 vardu nerastas nėra jis grąžinamas.
{{ 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ė. |
vartotojas
Nurodo dabartinį portalo vartotoją ir suteikia prieigą prie visų esamo Power Apps kontakto įrašo atributų. Jeigu neprisijungęs nė vienas vartotojas, šis kintamasis bus neapibrėžtas.
vartotojas yra objektas objektas.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
Pastaba
„Power Apps“ 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 individualaus vaidmens narystėms išbandyti. |
basic_badges_url | Pateikia tarnybos URL vartotojo ženkleliams generuoti. Norėdami generuoti ženklelius vartotojui, turite įtraukti žymą su atributais „duomenų ženklelis“ ir "duomenų URI". Norint generuoti esamo vartotojo ženklelius: <div data-badge data-uri='{{user.basic_badges_url }}'></div> Norint sugeneruoti vartotojo ženklelius pagal ID (kintamasis „userid“): `<div data-badge data-uri='{{user.basic_badges_url |
weblinks
Leidžia jums įkelti bet kurį žiniatinklio saitą pagal pavadinimą arba ID.
Jei egzistuoja žiniatinklio saitų rinkinys, bus pateikiamas žiniatinklio saitų rinkinio objektas. Jei žiniatinklio nuorodos rinkinys su duotu vardu ar ID nerastas nėra jis grąžinamas.
<!-- Load web link set by ID -->
{{ weblinks[page.adx_navigation.id].name }}
<!-- Load web link set by name -->
{% assign nav = weblinks[Primary Navigation] %}
{% if nav %}
<h1>{{ nav.title | escape }}</h1>
<ul>
{% for link in nav.weblinks %}
<li>
<a href={{ link.url | escape }} title={{ link.tooltip | escape }}>
{% if link.image %}
<img src={{ link.image.url | escape }} alt={{ link.image.alternate_text | escape }} />
{% endif %}
{{ link.name | escape }}
</a>
</li>
{% endfor %}
</ul>
{% endif %}
Žiniatinklio saitų rinkinio atributai
Pastaba
Žiniatinklio saitų rinkinys yra objekto objektas, turintis tuos pačius atributus, be išvardytų toliau.
Atributas | Aprašas |
---|---|
Kopija | Ž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. |
[atributo loginis pavadinimas] | Bet kurį žiniatinklio saitų rinkinio „Power Apps‟ įrašo atributą galite surasti pagal loginį pavadinimą. Pavyzdžiui, {{ weblinkset.createdon }} |
Žiniatinklio saito atributai
Pastaba
Žiniatinklio saitas yra objekto objektas, turintis tuos pačius atributus, be išvardytų toliau.
Atributas | Aprašas |
---|---|
Aprašas | Ž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. |
Vaizdas | Šios nuorodos žiniatinklio saito vaizdo objektas. Jei nebus vaizdo, šio atributo reikšmė bus nulinė. |
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. |
[atributo loginis pavadinimas] | Bet kurį žiniatinklio saito „Power Apps‟ įrašo atributą galite surasti pagal loginį pavadinimą. Pavyzdžiui, {{ weblink.createdon }} |
Žiniatinklio saito vaizdo atributai
alternate_text | Alternatyvusis vaizdo tekstas. |
---|---|
Aukštis | Sveikasis skaičius, apimantis nurodytą vaizdo aukštį. Jei aukščio reikšmė nebuvo pateikta, šio atributo reikšmė bus nulis. |
URL | Vaizdo URL. |
Plotis | Sveikasis skaičius, apimantis nurodytą vaizdo plotį. Jei pločio reikšmė nebuvo pateikta, šio atributo reikšmė bus nulis. |
website (svetainė)
Nurodoma portalo svetainė, suteikiant prieigą prie visų portalo „Power Apps‟ 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švestis
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 | Numatytasis: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F Keitimas (vengia žymėjimo): 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 | Numatytasis: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F Keitimas (vengia žymėjimo): 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.
„Liquid” tipai
„Liquid“ žymės
„Liquid” filtrai
Pastaba
Ar galite mums pranešti apie dokumentacijos kalbos nuostatas? Atlikite trumpą apklausą. (atkreipkite dėmesį, kad ši apklausa yra anglų kalba)
Apklausą atliksite per maždaug septynias minutes. Asmeniniai duomenys nėra renkami (privatumo nuostatos).