Қолжетімді Liquid нысандары

  • Мақала

Ескерім

2022 жылдың 12 қазанынан бастап күшіне енеді, Power Apps порталдары — Power Pages. Қосымша ақпарат: Microsoft Power Pages енді жалпыға қолжетімді (блог)
Жақында Power Apps порталдары құжаттамасын Power Pages құжаттамасымен көшіреміз және біріктіреміз.

Liquid нысандарында динамикалық мазмұнды бетке шығаратын төлсипаттар бар. Мысалы, page нысанында ағымдағы бет атын шығаруға пайдаланылатын title атты төлсипат бар.

Нысан төлсипатына аты бойынша кіру үшін бөлгішті (.) пайдаланыңыз. Үлгіде нысанның төлсипатын көрсету үшін, оны {{ and }} алыңыз.

Маңызды

Сайт аралық сценарий (XSS) ықтимал мәселелерін болдырмау мақсатында пайдаланушы ұсынған сенімсіз деректерді оқу үшін Liquid нысандарын пайдаланған кезде деректерді HTML кодтау үшін әрқашан болдырмау сүзгісін пайдаланыңыз.

{{ page.title }}

Сонымен қатар нысан төлсипаттарына жол аты және [] арқылы қатынасуға болады. Бұл пішім қажетті төлсипат динамикалық түрде анықталатын жағдайларда пайдалы немесе төлсипат атында синтаксис ішінде бөлгішті (.) пайдалану кезінде жарамсыз болуы мүмкін таңбалар, бос орындар, арнайы таңбалар және т.с.с болады.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Келесі нысандар үлгіде пайдалануға және кіруге болады.

Нысан Сипаттамасы
нысандар Кез келген Power Apps кестесіне идентификатор бойынша жүктеуге мүмкіндік береді. Қосымша ақпарат: нысандар
қазір Үлгі көрсетілген уақытта ағымдағы UTC уақытына қатысты күн/уақыт нысаны.
Ескертпе: бұл мәнді портал веб-бағдарламасы кэштейді және әр уақытта жаңартылмайды. Қосымша ақпарат: Күн сүзгілері
бет Ағымдағы портал сұрауы бетіне қатысты. page нысаны ағымдағы бет түйірлері, ағымдағы беттің аты немесе URL мекенжайы және кез келген басқа төлсипаттар немесе негізгі Power Apps жазбасының қатысты нысандары сияқты нәрселерге қатынасты береді. Қосымша ақпарат: бет
params request.params үшін ыңғайлы таңбаша. Қосымша ақпарат: сұрау
сұрау Ағымдағы HTTP сұрауы туралы ақпараттан тұрады. Қосымша ақпарат: сұрау
параметрлері Кез келген сайт параметрін аты бойынша жүктеу мүмкіндігін береді. Қосымша ақпарат: параметрлері
торап картасы Порталдың торап картасына кіру құқығын береді. Қосымша ақпарат: торап картасы
cайт белгілері Кез келген Сайт таңбалауыштарын аты бойынша жүктеуге мүмкіндік береді. Қосымша ақпарат: сайт таңбалаушылары
бөліктер Кез келген Мазмұн бөлігін аты бойынша жүктеуге мүмкіндік береді. Қосымша ақпарат: бөліктері
пайдаланушы Негізгі Power Apps контакт жазбасының барлық төлсипаттарына қатынас беретін ағымдағы портал пайдаланушысын білдіреді. Егер пайдаланушы жүйеге кірмесе, осы айнымалы мән нөл болады. Қосымша ақпарат: пайдаланушысы
веб-сілтемелер Кез келген Веб-сілтеме жиынын аты немесе идентификаторы бойынша жүктеу мүмкіндігін береді. Қосымша ақпарат: веб-сілтемелері
веб-сайт Порталдың Power Apps веб-сайт (adx_website) жазбасының барлық төлсипаттарына қатынасты беретін порталдың Веб-сайт жазбасын білдіреді. Қосымша ақпарат: веб-сайты

жарнамалар

Жарнамаға кіру және көрсету мүмкіндігін береді.

ads нысаны белгілі бір жарнаманы немесе жарнама орнын таңдауға мүмкіндік береді:

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

Ads төлсипаттары

Төлсипат Сипаттама
орындар Жарнама орындары нысанын қайтарады.
[жарнама атауы немесе идентификаторы] Ат немесе ИД сипаттары арқылы жарнамаға кіруге болады.
{% assign ad = ads[Ad Name] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Ad Placements төлсипаттары

Төлсипат Сипаттама
[жарнама орнының атауы немесе идентификаторы] Ат немесе ИД сипаттары арқылы жарнама орнына кіруге болады.
{% assign placement = ads.placements[Placement Name or Id] %}
{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Ad Placement төлсипаттары

Жарнаманы орналастыру — бұл жалпы төлсипаттары бар кесте нысаны және төлсипаттар төменде келтірілген.

Атрибут Сипаттамасы
Жарнамалар Орынмен байланысты жарнама нысандарының жинағын қайтарады. Қайталау тегтерін және Көрсеткі сүзгілерін осы жинақпен бірге пайдалануға болады.
Атау Жарнама орны үшін Ат өрісін қайтарады.
placement_url Жарнама орнын қайтаруға пайдаланылатын URL толығымен үлгі бойынша көрсетіледі.
random_url Орыннан кездейсоқ жарнаманы қайтаруға пайдаланылатын URL толығымен үлгі бойынша көрсетіледі.

Ad төлсипаттары

Ескерім

Жарнама — төменде тізілгендерге қоса бірдей барлық төлсипаттары бар кесте.

Төлсипат Сипаттама
ad_url Жарнаманы қайтаруға пайдаланылатын URL толығымен үлгі бойынша көрсетіледі.
Көшіру Жарнама үшін Көшіру өрісін қайтарады.
image Жарнама үшін кескін нысанын (бар болса) қайтарады.
Атау Жарнама үшін Ат өрісін қайтарады.
open_in_new_window redirect_url көрсететін URL мекенжайы жаңа терезеде ашылуы керек болса, true мәнін қайтарады.
redirect_url Пайдаланушы жарнаманы таңдау арқылы бағытталатын URL мекенжайы.

Ad Image төлсипаттары

Төлсипат Сипаттама
alternate_text Тегтің alt төлсипатында көрсетілуі керек мәтінді қайтарады.
биіктігі Кескін пиксельдері биіктігін қайтарады
URL Кескіннің URL көзін қайтарады.
ені Кескін пиксельдері енін қайтарады

блогтар

Блогтар мен блог хабарларына кіру және көрсету мүмкіндігін береді.

blogs нысаны белгілі бір блогты немесе блог хабарларын таңдауға мүмкіндік береді.

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

blogs нысаны

Блогтар нысаны порталдағы белгілі бір блогқа кіруге немесе порталдағы барлық блог хабарларына кіруге мүмкіндік береді.

Келесі кестеде blogs нысанымен байланысты төлсипаттар түсіндіріледі.

Төлсипат Сипаттама
posts Порталдағы барлық блог хабарларын қамтитын blogposts нысанын қайтарады.
[блог атауы немесе идентификаторы] Name немесе Id сипаттары арқылы кез келген блогқа қатынасуға болады. 
{% assign blog = blogs["Blog Name"] %}                             

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

blog нысаны

blog нысаны бір блогпен жұмыс істеуге және осы блог хабарларына қатынасуға мүмкіндік береді.

Келесі кестеде blog нысанымен байланысты әртүрлі төлсипаттар түсіндіріледі.

Төлсипат Сипаттама
posts Блогтағы барлық блог хабарларынан тұратын blogposts нысанын қайтарады.
Атау Блог атауы.
title Блог тақырыбы.
URL Блог URL мекенжайы.

blogposts нысаны

Блог хабарлары нысаны блог хабары нысандары жинағына кіруге мүмкіндік береді. Блог хабарлары мен мұрағат беттеуін liquid сүзгілерімен реттеуге болады:

{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}

Басқа мүмкін нұсқалар:

  • blogs.posts.all(барлық блог хабарларын алу үшін)
  • blogs.posts | from\_index: 0 | take: 2

Келесі кестеде blogposts нысанымен байланысты әртүрлі төлсипаттар түсіндіріледі.

Төлсипат Сипаттама
Барлық Жинақтағы барлық blogpost нысандарын қайтарады.

blogpost нысаны

Жалғыз блог хабарына қатысты.

Келесі кестеде blogpost нысанымен байланысты әртүрлі төлсипаттар түсіндіріледі.

Атрибут Сипаттамасы
url Хабардың URL мекенжайы.
мазмұн Хабар үшін мазмұн өрісі қайтарады.
author Хабардың авторын қайтарады (бұл кәдімгі контакт кесте нысаны.
атау Хабар атауы.
comment_count Берілген хабардың түсініктемелер саны үшін бүтін мәнді қайтарады.
publish_date Хабар жарияланған күн.

нысандар

Назар аударыңыз!

Сайт аралық сценарий (XSS) ықтимал мәселелерін болдырмау мақсатында пайдаланушы ұсынған сенімсіз деректерді оқу үшін нысандардың Liquid нысанын пайдаланған сайын жол деректерін HTML кодтау үшін әрқашан болдырмау сүзгісін пайдаланыңыз.

Ескерім

Dataverse платформасының кейбір атау конвенциялары өзгерді, мысалы, Dataverse нысандары енді кестелер деп аталады. Атау өзгерістері Liquid нысандарына қолданылмайды. Liquid нысандарының объектісі Нысандар деп атала береді.

Кез келген Power Apps кестесіне идентификатор бойынша жүктеуге мүмкіндік береді. Егер кесте бар болса, кесте нысаны қайтарылады. Егер берілген идентификаторы бар кесте табылмаса, нөл мәні қайтарылады.

{% assign account = entities.account['936DA01F-9ABD-4d9d-80C7-02AF85C822A8'] %}

{% if account %}

{{ account.name | escape }} ({{ account.statecode.label | escape }})

{% endif %}

{% assign entity_logical_name = 'contact' %}

{% assign contact = entities[entity_logical_name][request.params.contactid] %}

{% if contact %}

{{ contact.fullname | escape }} ({{ contact.parentcustomerid.name | escape }})

{% endif %}

Entity

Нысан нысаны Power Apps кесте жазбасының төлсипаттарына қатынасуды қамтамасыз етеді.

Атрибут Сипаттамасы
Идентификатор Жол ретіндегі кестенің GUID идентификаторы. Мысалы, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Кестенің Power Apps логикалық атауы.
Ескертпелер Ең ескіден ең жаңасына (createdon) қарай ретпен орналастырылған кестемен байланысты кез келген ескертпелерді (аннотация) жүктейді. Ескертпелер ескертпе нысандары ретінде қайтарылады.
рұқсаттар Кесте үшін кесте рұқсатын растау нәтижелерін жүктейді. Нәтижелер рұқсаттар нысаны ретінде қайтарылады.
url Кесте үшін Power Apps порталдары мазмұнын басқару жүйесі URL жолын қайтарады. Егер кестенің ағымдағы веб-сайтта жарамды URL мекенжайы болмаса, нөл мәні қайтарылады. Негізінде, бағдарламада URL провайдері теңшелмесе, бұл CMS порталына енгізілген белгілі бір кесте түрлерінің мәнін ғана қайтарады.
[төлсипаттың немесе қатынастың атауы] Power Apps кестенің кез келген төлсипатына логикалық атауы бойынша қатынасуға болады. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
Кесте төлсипаттарының көпшілігінің мәндері тікелей Liquid түрлерімен салыстырылады: екі параметр өрісін логикалық мәндермен, мәтіндік өрістерді жолдармен, сандық/валюта өрістерін сандармен, күн/уақыт өрістерін күн нысандарымен салыстыру. Дегенмен, кейбір төлсипат түрлері нысандар ретінде қайтарылады:
  • Іздеу (байланыстырылған кесте анықтамасы) өрістері байланысты кестенің анықтама нысандары ретінде қайтарылады.
  • Параметрлер жиыны/таңдау тізімі өрістері параметрлер жиыны мәні нысандары ретінде қайтарылады.
  • Сонымен қатар қатынас схемасы аты бойынша қатысты нысандарды жүктеуге болады.
    • {{ page.adx_webpage_entitylist.adx_name }}Қарым-қатынас әсерлі болған жағдайда (яғни, жеке әсерлі) әсерлі қатынас нысаны қайтарылады. (Болмаса, қажетті нәтиже анық емес болуы мүмкін.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Ескертпе: қатысты нысандардың үлкен санын жүктеу немесе жалғыз үлгіде қатынастардың үлкен санына қатынасу үлгіні көрсету өнімділігіне теріс әсер етуі мүмкін. Циклдегі көрсеткінің әрбір элементіне қатысты нысандарды жүктемеңіз. Мүмкін болған жерде нысандардың жинақтарын жүктеу үшін Dataverse кестесінің тегтерін пайдаланыңыз.

Байланысты кесте сілтемесі

Іздеу төлсипатының мәндері келесі төлсипаттармен байланысты кестенің анықтамалық нысандары ретінде қайтарылады.

Атрибут Сипаттамасы
Идентификатор Жол ретіндегі анықтамалық кестенің GUID идентификаторы.
Мысалы, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Анықтамалық кестенің Power Apps логикалық атауы.
Атауы Анықтамалық кестенің негізгі атының төлсипаты.

Ескертпе

Ескертпе — аннотация жазбасының төлсипаттары мен қатынастарына қатынасуды қамтамасыз ететін кесте нысаны. Кесте нысанының барлық төлсипаттарына қоса, ескертпеде келесі қосымша төлсипаттар бар.

Атрибут Сипаттама
documentbody Ескертпе аннотациясы жазбасының documentbody төлсипатын Base64 кодталған жол түрінде жүктейді. Осы төлсипаттың мазмұны үлкен болғандықтан, қалған ескертпе төлсипаттарымен жүктелмейді, ол қажет болғанда ғана жүктеледі.
Ескертпе: documentbody төлсипатын пайдалану үлгіні көрсету өнімділігіне кері әсер етуі мүмкін және сақтықпен орындалуы керек.
Мүмкін болғанда ескертпе тіркемесіне сілтеме беру үшін url төлсипатын пайдаланыңыз.
URL Кірістірілген портал аңғартпасы тіркемесін өңдеу құралына URL жолын қайтарады. Егер пайдаланушының рұқсаты болса және ескертпеде тіркелген файл болса, осы URL сұрауы ескертпе файлы тіркемесін жүктеп алады.

Ескерім

Қосымша өрістер

параметрлер жиыны мәні

Параметрлер жиыны/таңдау тізімі төлсипаттары келесі төлсипаттармен байланысты кестенің анықтамалық нысандары ретінде қайтарылады.

Атрибут Сипаттама
Белгі Параметрлер жиыны/таңдау тізімі төлсипаты мәнінің жергіліктендірілген белгісі. Мысалы, Active
Мән Параметрлер жиыны/таңдау тізімі төлсипаты мәнінің бүтін мәні. Мысалы, 0

Кесте рұқсаттары

Кесте рұқсаттары кесте үшін біріктірілген рұқсатты растау нәтижелеріне қатынасуды қамтамасыз етеді.

Атрибут Сипаттамасы
can_append Егер ағымдағы пайдаланушыда жазбаларды осы жазбаның қатынасына үстеу рұқсаты болса, true мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
can_append_to Егер ағымдағы пайдаланушыда осы жазбаны басқа кесте қатынасына үстеу рұқсаты болса, "шын" мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
can_create Егер ағымдағы пайдаланушының осы кесте түрінің жаңа жазбаларын жасау рұқсаты болса, "шын" мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
can_delete Егер ағымдағы пайдаланушының осы жазбаны өшіру рұқсаты болса, true мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
can_read Егер ағымдағы пайдаланушының осы жазбаны оқу рұқсаты болса, true мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
can_write Егер ағымдағы пайдаланушының осы жазбаны жаңарту рұқсаты болса, true мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
rules_exist Егер осы нысанмен көрсетілген рұқсат нәтижелері анықталған рұқсат ережелерінің нәтижесі болса, true мәнін қайтарады. Егер нақты анықталған рұқсаттардағы әдепкі нәтижелер болса, false мәнін қайтарады.

Қайталама қатынас

Нысандарға әсерлі (яғни, өзіне сілтеме жасайтын) қатынастарды жүктеу әрекеттері келесі төлсипаттардан тұратын нысандар ретінде қайтарылады.

Төлсипат Сипаттама
is_reflexive true мәнін қайтарады. Қатынаспен қайтарылған нысан әсерлі болса, сынаққа пайдалануға болады.
referenced Берілген қатынас үшін анықтамалық нысандар көрсеткісін қайтарады.
referencing Берілген қатынас үшін анықтамалық кестені қайтарады. Егер анықтамалық кесте болмаса, нөл мәнін қайтарады. Егер қатынас көп (N:N) болса, анықтамалық нысандар көрсеткісін қайтарады.

нысан тізімі

Entitylist нысаны Power Apps Dataverse кестесінің тегтерінде пайдаланылады. Бұл берілген тізімнің барлық төлсипаттарына қатынасуды қамтамасыз етеді.

Ескерім

Ағымдағы бетпен байланыстырылған тізімді көрсету

Төлсипаттар

Ескерім

нысандар

Төлсипат Сипаттама
create_enabled Тізім үшін жаңа жазбалар жасау конфигурацияланған болса, "шын" мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
create_url Тізімнің жасау сілтемесі/түймешігі үшін конфигурацияланған URL жолын қайтарады.
detail_enabled Егер тізім үшін жеке жазбалардың толық көрінісі конфигурацияланса, "шын" мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
detail_id_parameter Жазбаның толық көрінісі URL құрастыру кезінде жазба ИД үшін пайдаланылатын сұрау жолы параметрінің атын қайтарады. URL мекенжайларын құрастыру үшін Liquid сүзгілері қолданысы туралы мәліметтер үшін URL сүзгілері бөлімін көріңіз. Мысалы, id
detail_label Тізімнің толық көрініс сілтемелері/түймешіктері үшін конфигурацияланған локализацияланған белгіні қайтарады.
detail_url Тізімнің толық көрініс сілтемелері/түймешіктері үшін конфигурацияланған URL жолын қайтарады.
empty_list_text Тізім көрінісі нәтижелер бермеген кезде көрсетілетін конфигурацияланған локализацияланған мәтінді қайтарады.
enable_entity_permissions Осы тізім үшін кесте рұқсатын қосылған болса, "шын" мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
entity_logical_name Осы тізіммен көрсетілетін жазбалар үшін Power Apps кестесінің логикалық атауын қайтарады. Мысалы: contact
filter_account_attribute_name Ағымдағы портал пайдаланушысының тектік тіркелгісі бойынша нәтиже жазбаларын сүзгілеуге пайдаланылатын тіркелгіге іздеуге арналған төлсипаттың логикалық атауын қайтарады. Мысалы, accountid
filter_apply_label Кеңейтілген төлсипат сүзгісін тізім нәтижелеріне қолданатын сілтеме/түймешік үшін пайдаланылатын конфигурацияланған локализацияланған белгіні қайтарады.
filter_definition Тізім үшін JSON төлсипаты сүзгісінің анықтамасын қайтарады. Осы анықтаманы өңдеу үшін метасүзгілердің Liquid сүзгісін пайдалану әдісі туралы қосымша мәліметтерді Тізім сүзгілері бөлімінен қараңыз.
filter_enabled Тізім үшін кеңейтілген төлсипат сүзгілеуі қосылса, "шын" мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
filter_portal_user_attribute_name Ағымдағы портал пайдаланушысының контактісі бойынша нәтиже жазбаларын сүзгілеуге пайдаланылатын контактіге іздеуге арналған төлсипаттың логикалық атауын қайтарады. Мысалы, contactid
filter_website_attribute_name Ағымдағы портал веб-сайты бойынша нәтиже жазбаларын сүзгілеуге пайдаланылатын adx_website іздеуге арналған төлсипаттың логикалық атауын қайтарады. Мысалы, adx_websiteid
language_code Тізімінің барлық локализацияланған белгілерін таңдауға пайдаланылатын Power Apps бүтін тіл кодын қайтарады.
page_size Тізім үшін конфигурацияланған нәтиже беті өлшемін қайтарады.
primary_key_name Осы тізіммен көрсетілетін жазбалардың негізгі кілт төлсипатының логикалық атауын қайтарады.
search_enabled Егер осы тізім үшін іздеу қосылса, "шын" мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
search_placeholder Тізімді іздеу өрісінің орнын толтырғыш үшін конфигурацияланған локализацияланған мәтінді қайтарады.
search_tooltip Тізімді іздеу сөзкөмегі үшін конфигурацияланған локализацияланған мәтінді қайтарады.
көріністер Тізімнің қолжетімді көріністерін тізім көрінісінің нысандары ретінде қайтарады.
[төлсипаттың логикалық атауы] Кесте сияқты бірдей әдіспен логикалық атауы бойынша Power Apps жазбасы (adx_entitylist) тізімінің кез келген төлсипатына қатынасуға болады. Мысалы, {{ entitylist.adx_name }}

Тізім көрінісінің төлсипаттары

Атрибут Сипаттамасы
бағандар Көріністегі бағандарды тізім көрінісі бағанының нысандары ретінде қайтарады.
entity_logical_name Көріністегі жазбалар үшін Power Apps кестесінің логикалық атауын қайтарады. Мысалы: contact
Идентификатор Көріністің GUID ИД қайтарады.
language_code Барлық локализацияланған белгілерді таңдауға пайдаланылатын Power Apps бүтін тіл кодын (баған тақырыптары, т.б.) қайтарады.
Атау Көріністің Power Apps көрсетілетін атауын қайтарады.
primary_key_logical_name Көріністегі жазбалар үшін Power Apps кестесінің негізгі кілтінің логикалық атауын қайтарады. Мысалы, contactid
sort_expression Көріністің әдепкі сұрыптау өрнегін қайтарады. Мысалы, name ASC, createdon DESC

Тізімі көрінісі бағанының төлсипаттары

Атрибут Сипаттамасы
attribute_type Жол ретінде баған үшін Power Apps төлсипаты түрінің атауын қайтарады. Мысалы, Lookup, Picklist, String, Boolean, DateTime
logical_name Баған үшін Power Apps төлсипатының логикалық атауын қайтарады. Мысалы, createdon
Атау Баған үшін локализацияланған Power Apps көрсетілетін атауын қайтарады. Мысалы, Created On
sort_ascending Баған сұрыптауға арналған сұрыптау өрнегі жолын өсу ретімен қайтарады. Мысалы, createdon ASC
sort_descending Баған сұрыптауға арналған сұрыптау өрнегі жолын кему ретімен қайтарады. Мысалы, createdon DESC
sort_disabled Егер сұрыптау баған үшін өшірілген болса, true мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
sort_enabled Егер сұрыптау баған үшін қосулы болса, true мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
ені Бағанның теңшелген енін пиксельдерде қайтарады.

нысан көрінісі

entityview нысаны entityview тегінде пайдаланылады және көрініс метадеректеріне қатынас және көріністің нәтиже жазбаларын береді.

Төлсипаттар

Атрибут Сипаттамасы
бағандар Көріністегі бағандарды кесте көрінісі бағанының нысандары түрінде қайтарады.
entity_permission_denied Ағымдағы пайдаланушының жеткіліксіз кесте рұқсаттарына байланысты көрініс нәтижелеріне қатынасуға тыйым салынса, "шын" мәні қайтарылады. Егер көрініс нәтижелерін оқу рұқсаты берілсе, false мәні қайтарылады.
entity_logical_name Көрініс нәтижесі жазбаларының Power Apps кестесінің логикалық атауы. Мысалы: contact
first_page Көрініс нәтижелерінің бірінші бетінің нөмірі. Бұл 1 болады, егер ешбір нәтижелер қайтарылмаса, null болады.
Идентификатор Осы entityview анықтайтын Power Apps көрінісінің GUID идентификаторы.
language_code Power Apps бүтін тіл коды ағымдағы көріністің локализацияланған белгілерін жүктеуге пайдаланылады.
last_page Көрініс нәтижелерінің соңғы бетінің нөмірі. Егер ешбір нәтижелер қайтарылмаса, бұл null болады.
аты Осы entityview анықтайтын Power Apps көрінісінің атауы, мысалы, белсенді контактілер.
next_page Көрініс нәтижелерінің келесі бетінің нөмірі. Егер нәтижелердің келесі беті болмаса, бұл null болады.
Бет Көрініс нәтижелерінің ағымдағы бетінің нөмірі.
беттер Ағымдағы көрініс үшін барлық нәтижелер беттерінен тұратын бет нөмірлерінің көрсеткісін қайтарады.
page_size Ағымдағы көрініс үшін әр бетте қайтарылатын нәтижелер саны.
previous_page Көрініс нәтижелерінің келесі бетінің нөмірі. Егер нәтижелердің алдыңғы беті болмаса, бұл null болады.
primary_key_logical_name Осы көрініс үшін нәтиже кестесінің негізгі кілт төлсипатының Power Apps логикалық атауы. Мысалы: contactid.
жазбалар Кесте нысандары ретіндегі көріністің нәтиже жазбаларының ағымдағы беті.
sort_expression Көріністің әдепкі сұрыптау өрнегі. Мысалы, nameASC, createdon DESC.
total_pages Көрініс нәтижесі беттерінің жалпы саны.
total_records Көрініс нәтижелерінің жалпы саны (барлық беттер бойынша).

оқиғалар

Оқиғаларға кіру және көрсету мүмкіндігін береді. events нысаны белгілі бір оқиғаны немесе барлық оқиғаларды таңдауға мүмкіндік береді.

events нысаны

events нысаны порталдағы белгілі бір оқиғаға қатынасуға немесе порталдағы барлық оқиғаларға қатынасуға мүмкіндік береді (оқиғаға қарамастан).

events нысанында келесі төлсипаттар бар:

Атрибут Сипаттамасы
occurences Порталдағы барлық оқиға қайталануларын қамтитын eventoccurancessobject нысанын қайтарады
[оқиға атауы немесе идентификаторы] Name немесе Id сипаттары арқылы кез келген оқиғаға қатынасуға болады.
{% assign event = events["Оқиға атауы"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

event нысаны

event нысаны жалпы оқиғамен жұмыс істеуге және осы оқиғаның кестелері мен қайталануларына қатынасуға мүмкіндік береді.

event нысанында келесі төлсипаттар бар:

Атрибут Сипаттамасы
кейін аяқтау Оқиғаның барлық қайталануларын қамтитын eventoccurrencesobject нысанын қайтарады.
аты Оқиға атауы.
URL Оқиғаның URL мекенжайы.

eventoccurences нысаны

eventoccurrences нысаны оқиға қайталанулары нысандарының жинағына қатынасуға мүмкіндік береді. Liquid сүзгілерін пайдаланып оқиғаның қайталануларын реттеуге және шығарып алынатын қайталанулардың күндер ауқымын көрсетуге, сонымен бірге беттеуге болады.

{% assign occurances = event.occurrences.from[today].to[advance_date] %}

сондай-ақ

{% assign occurances = event.occurrences.min[today].max[advance_date] %}

мүмкін екендігін ескеріңіз.

Келесі төлсипаттар eventoccurrences нысанымен байланысты

Төлсипат Сипаттама
Барлық Жинақтағы барлық eventoccurance нысандарын қайтарады.

eventoccurence нысаны

Жалпы оқиға қайталануын көрсетеді. Байланысты төлсипаттар төменде берілген:

Төлсипат Сипаттама
URL Қайталанудың URL мекенжайы.
is_all_day_event Бұл бір күндік оқиға ма?
start_time Оқиғаның басталу уақыты.
end_time Оқиғаның аяқталу уақыты.

forloop

Цикл блогында пайдалы сипаттардан тұрады.

Ескерім

forloop шартын тек тег ішінде пайдалануға болады.

Код

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

This is child page number {{ forloop.index }}.

{% endif %}

{% endfor %}

Нәтиже

This is the first child page!

This is child page number 2.

This is child page number 3.

Төлсипаттар

Атрибут Сипаттама
Бірінші Циклдің бірінші қайталануы болса, true мәнін қайтарады. Бұл бірінші қайталау болмаса, false мәнін қайтарады.
индекс Бірінші элементтің орны 1 болатын жинақтағы ағымдағы элемент орны.
index0 Бірінші элементтің орны 0 болатын жинақтағы ағымдағы элемент орны.
Соңғы Циклдің соңғы қайталануы болса, true мәнін қайтарады. Бұл соңғы қайталау болмаса, false мәнін қайтарады.
length Цикл қайталаулары санын қайтарады ߝ жинақтағы элементтер саны қайталанады.
rindex Циклде қалған элементтер саны (ұзындық - индекс), мұндағы 1 — соңғы элементтің индексі.
rindex0 Циклде қалған элементтер саны (ұзындық - индекс), мұндағы 0 — соңғы элементтің индексі.

форумдар

Форумдар мен форум тізбектеріне кіру және көрсету мүмкіндігін береді. Форум деректерін көрсету үшін, liquid нысандарын пайдалану мүмкіндігі хабарларға да қолданылады, бірақ жаңа хабарды немесе тізбекті жасау мақсатында кірістірілген функциялы ASP.NET көп сатылы пішіндерінің бет үлгісін пайдалану қажет (әдепкі форум тізбегі және форум хабарының бет үлгілері сияқты).

Форумдар нысаны форумды немесе форум тізбектерін таңдауға мүмкіндік береді:

<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 нысаны бір форуммен жұмыс істеуге арналған және осы форум тізбектеріне қатынасуға мүмкіндік береді.

Форум тізбектері нысаны форум тізбегі нысандары жинағына кіруге мүмкіндік береді. Liquied сүзгілерін пайдалана отырып форум тізбектерін реттеуге және беттеуге болады.

{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}

Жалғыз форум тізбегі

Форум хабарлары нысаны форум хабары нысандары жинағына кіруге мүмкіндік береді.

Төлсипаттар

Төлсипат Сипаттама
threads Порталдағы барлық forumthread нысандарын қамтитын forumthreads нысанын қайтарады.
Барлық Порталдағы барлық forum нысандарын қайтарады. Сондай-ақ website.forums Is деген балама бар екенін ескеріңіз.
thread_count Толық веб-сайттағы тізбек саны ретінде бүтін мәнді қайтарады.
post_count Порталдағы хабарлардың жалпы санының бүтін мәнін қайтарады.
[форум атауы немесе идентификаторы] Name немесе Id сипаттары арқылы кез келген форумға қатынасуға болады.
`{% assign forum = forums[Forum Name] %}
{% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

forum нысаны

Төлсипаттар

Ескерім

нысандар

Төлсипат Сипаттама
threads Барлық форум тізбектерін қамтитын forumthreads нысанын қайтарады.
Атау Форум атауы.
thread_count Форумдағы тізбек саны ретінде бүтін мәнді қайтарады.
post_count Толық форумдағы хабарлар саны ретінде бүтін мәнді қайтарады.

forumthreads нысаны

Төлсипаттар

Төлсипат Сипаттама
Барлық Жинақтағы барлық forumthread нысандарын қайтарады.

forumthread нысаны

Төлсипаттар

Ескерім

entities

Төлсипат Сипаттама
posts Тізбектің барлық форум хабарларын қамтитын forumposts нысанын қайтарады.
author Тізбектің авторын қайтарады (бұл кәдімгі контакт кестесінің нысаны).
latest_post Тізбектегі ең соңғы хабарды қайтарады.
first_post Тізбектегі бірінші хабарды қайтарады.
post_count Тізбектегі хабарлар саны ретінде бүтін мәнді қайтарады.
is_answered Тізбек жауап берді ме немесе жоқ па?
is_sticky Тізбек жабысқақ па?

forumposts нысаны

Төлсипаттар

Төлсипат Сипаттама
Барлық Жинақтағы барлық forumthread нысандарын қайтарады.

Жалғыз форум хабары

Төлсипаттар

Ескерім

entities

Төлсипат Сипаттама
author Хабардың авторын қайтарады (бұл кәдімгі контакт кесте нысаны).
content Хабар мазмұны.
is_answer Бұл хабар тізбек жауабы ма?

knowledge

Порталда мақалалар мен санаттарды көрсету үшін Power Apps knowledgearticle және санат кесте жазбаларына қатынасуды қамтамасыз етеді.

Төлсипаттар

Төлсипат Сипаттама
мақалалар Порталда қолжетімді knowledgearticle кестесінің жазбалары үшін мақала нысандарын қамтитын мақалалар нысанын қайтарады.
categories Порталда қолжетімді санат кестесінің жазбалары үшін санат нысандарын қамтитын санаттар нысанын қайтарады.

articles нысаны

articles нысаны article нысандары жинағына қатынасуға мүмкіндік береді. Liquid сүзгілерін пайдаланып та мақалаларды ретпен орналастыруға және беттеуге жетуге болады.

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

Төлсипаттар

Төлсипат Сипаттама
popular Ең көп көрулерді қамтитын article нысандарының жинағын қайтарады. {% assign popular_articles = knowledge.articles.popular %}
recent Соңғы өзгертілген күнді қамтитын article нысандарының жинағын қайтарады. {% assign recent_articles = knowledge.articles.recent %}
үстіңгі Ең жоғары бағаны қамтитын article нысандарының жинағын қайтарады. {% assign top_articles = knowledge.articles.top %}

Сүзгілер

Келесі сүзгілер бет өлшемі және тіл үшін қосымша параметрлерді қабылдай алады. Бірінші параметр — шығарып алатын жазбалардың саны. Әдепкі бет өлшемі — 5. Екінші параметр — осы тіл үшін мақалаларды шығарып алатын тілдің коды. Сүзгілерді басқа Liquid сүзгілерімен бірге пайдалануға болады.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Төлсипат Сипаттама
popular Ең көп көрулерді қамтитын article нысандарының жинағын қайтарады. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
recent Соңғы өзгертілген күнді қамтитын article нысандарының жинағын қайтарады. {% assign recent_articles = knowledge.articles \| recent: 5 %}
үстіңгі Ең жоғары бағаны қамтитын article нысандарының жинағын қайтарады. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

categories нысаны

categories нысаны санат нысандарының жинағына қатынасуға мүмкіндік береді. Liquid сүзгілерін пайдаланып та санаттарды ретпен орналастыруға және беттеуге жетуге болады.

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

Төлсипаттар

Төлсипат Сипаттама
recent Соңғы өзгертілген күнді қамтитын санат нысандарының жинағын қайтарады.
top_level Негізгі санаты жоқ санат нысандарының жинағын қайтарады.

Сүзгілер

Келесі сүзгілер бет өлшемін көрсететін қосымша параметрді қабылдайды. Әдепкі бет өлшемі — 5. Сүзгілерді басқа Liquid сүзгілерімен бірге пайдалануға болады.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Төлсипат Сипаттама
recent Соңғы өзгертілген күнді қамтитын санат нысандарының жинағын қайтарады. {% assign recent_categories = knowledge.categories \| recent: 10 %} параметрлерін көрсетуге болады
top_level Негізгі санаты жоқ санат нысандарының жинағын қайтарады. {% assign root_categories = knowledge.categories \| top_level %}

article нысаны

article нысаны порталда мәліметтерін көрсету үшін бір білім мақаласымен жұмыс істеуге мүмкіндік береді.

Төлсипаттар

article — төменде тізілгендерге қоса барлық бірдей төлсипаттар бар entity нысаны.

Төлсипат Сипаттама
article_public_number Мақаланың қоғамдық нөмірі.
comment_count Осы мақалаға қалдырылған пікірлер санының бүтін мәні.
content Мақаланың мазмұны.
current_user_can_comment Ағымдағы пайдаланушы мақалаға пікірлер қоса алатын-алмайтынын көрсететін логикалық мәнді қайтарады.
is_rating_enabled Мақалада баға беру қосылған-қосылмағанын көрсететін логикалық мәнді қайтарады.
keywords Мақаладағы кілтсөздер.
аты Мақала атауының баламалы бүркеншік аты.
rating Мақаладағы ондық баға мәні.
title Мақаланың атауы.
view_count Мақаланы көрулер санының бүтін мәні.

category Object

category нысаны порталда мәліметтерін көрсету үшін бір санатпен жұмыс істеуге мүмкіндік береді.

Төлсипаттар

category — төменде тізілгендерге қоса барлық бірдей төлсипаттары бар entity нысаны.

Төлсипат Сипаттама
categorynumber Санаттың санат нөмірі.
аты Санат атауының баламалы бүркеншік аты.
Тақырып Санаттың атауы.

тіл

Ағымдағы тіл атауын және егер бірнеше тілді қолдау қосылған болса, тіл кодын қамтамасыз етеді.

Төлсипаттар

Атрибут Сипаттамасы
url Ағымдағы тіл кодымен префикстелген ағымдағы сұраныстың URL мекенжайы.
url_substitution Беттің шығыс кэшін айналып өтетін, ағымдағы тіл кодымен префикстелген ағымдағы сұраныстың URL мекенжайы.
атау Ағымдағы тілдің атауы.
код Тілдің тілдік коды.

Мысалы, Тілдердің ашылмалы веб-үлгісі бірнеше тілдер қолжетімді болған кезде қолжетімді тілдерді көрсету үшін әдепкі бойынша liquid нысанын пайдаланады.

бет

Ағымдағы портал сұрауы бетіне қатысты. Бұл нысан sitemap төлсипаттарын және ағымдағы сауалнаманың entities нысанын (әдетте веб-бет) біріктіреді.

page нысаны ағымдағы бет түйірлері, ағымдағы беттің аты немесе URL мекенжайы және кез келген басқа төлсипаттар немесе негізгі Power Apps жазбасының қатысты нысандары сияқты нәрселерге қатынасты береді.

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

Бет төлсипаттары

Ескерім

entities

Төлсипат Сипаттама
breadcrumbs Бет үшін сайт картасы түбірлік түйінінен басталатын және тектік элементте аяқталатын түйір сайт картасы түйінінің нысандарын қайтарады.
children Беттің еншілес сайт картасы түйінінің нысандарын қайтарады.
parent Беттің негізгі сайт картасы түйінін қайтарады. Егер бұл бет басты бет болса, тектік элемент мәні null болады.
title Бет атауы.
URL Бет URL мекенжайы.
[төлсипаттың немесе қатынастың атауы] Беттің негізіндегі Power Apps жазбасының кез келген төлсипатына логикалық атауы бойынша қатынасуға болады.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
Кесте төлсипаттарының көпшілігінің мәндері тікелей Liquid түрлерімен салыстырылады: екі параметр өрісін логикалық мәндермен, мәтіндік өрістерді жолдармен, сандық/валюта өрістерін сандармен, күн/уақыт өрістерін күн нысандарымен салыстыру. Дегенмен, кейбір төлсипат түрлері нысандар ретінде қайтарылады:
  • Іздеу (байланыстырылған кесте анықтамасы) өрістері байланысты кестенің анықтама нысандары ретінде қайтарылады.
  • Параметрлер жиыны/таңдау тізімі өрістері параметрлер жиыны мәні нысандары ретінде қайтарылады.
    • Сонымен қатар қатынас схемасы аты бойынша қатысты нысандарды жүктеуге болады.
    {{ page.adx_webpage_entitylist.adx_name }}
    Қарым-қатынас әсерлі болған жағдайда (яғни, жеке анықтамалық) нысандар нысаны қайтарылады. (Болмаса, қажетті нәтиже анық емес болуы мүмкін.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Ескертпе: қатысты нысандардың үлкен санын жүктеу немесе жалғыз үлгіде қатынастардың үлкен санына қатынасу үлгіні көрсету өнімділігіне теріс әсер етуі мүмкін. Циклдегі көрсеткінің әрбір элементіне қатысты нысандарды жүктемеңіз. Мүмкін болған жерде нысандардың жинақтарын жүктеу үшін Power Apps Dataverse кесте тегтерін пайдаланыңыз.

cұраулар

Сұрауға кіру және көрсету мүмкіндігін береді.

polls нысаны белгілі бір сауалнаманы немесе сауалнама орнын таңдауға мүмкіндік береді:

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

Сауалнама төлсипаттары

Төлсипат Сипаттама
орындар Сұрау орындары нысанын қайтарады.
[сауалнама атауы немесе идентификаторы] Ат немесе ИД сипаттары арқылы сұрауға кіруге болады. {% assign poll = polls[Poll Name] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Сауалнама орындарының төлсипаттары

Төлсипат Сипаттама
[сауалнама орнының атауы немесе идентификаторы] Кез келген сауалнама орнына Name немесе Id сипаттары арқылы қатынасуға болады.{% assign placement = polls.placements[Placement Name or Id] %}
{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Сауалнама орнының төлсипаттары

Ескерім

entities

Төлсипат Сипаттама
Атау Сұрау орны үшін Ат өрісін қайтарады.
placement_url Сұрау орнын қайтаруға пайдаланылатын URL толығымен үлгі бойынша көрсетіледі.
cұраулар Орынмен байланысты сұрау нысандарының жинағын қайтарады. Қайталау тегтерін және Көрсеткі сүзгілерін осы жинақпен бірге пайдалануға болады.
random_url Орыннан кездейсоқ сұрауды қайтаруға пайдаланылатын URL толығымен үлгі бойынша көрсетіледі.
submit_url Сұрау орындалған URL жіберіледі.

Сұрау төлсипаттары

Ескерім

entities

Төлсипат Сипаттама
has_user_voted Ағымдағы пайдаланушы (кірген немесе анонимді) осы сұрауда дауыс берілгенде true мәні қайтарылады.
Атау Сұрау үшін Ат өрісін қайтарады.
options Сауалнамамен байланысты poll option нысандарының жинағын қайтарады. Осы жинақпен бірге Қайталау тегтерін және entities нысанын пайдалануға болады.
poll_url Сұрау қайтаруға пайдаланылатын URL толығымен үлгі бойынша көрсетіледі.
сұрағы Сұрау үшін Сұрақ өрісін қайтарады.
submit_button_label Сұраудың жіберу түймесі белгісін алдын ала анықтауға пайдаланылатын жолды қайтарады.
submit_url Сұрау орындалған URL жіберіледі.
user_selected_option Пайдаланушымен таңдалған сұрау опциясы нысанын қайтарады (әлдеқашан дауыс берілген жағдайда).
votes Сұрау үшін тізімделген дауыстар санын қайтарады.

Сұрау опциясы төлсипаттары

Ескерім

entities

Төлсипат Сипаттама
answer Сұрау үшін Жауап өрісін қайтарады.
percentage Опция сұрауында дауыстар пайызын 0–100 ауқымындағы ондық сан ретінде қайтарады.
votes Опция үшін тізімделген дауыстар санын қайтарады.

сұрау

Ағымдағы HTTP сұрауы туралы ақпараттан тұрады.

{% assign id = request.params['id'] | escape %}

<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>

Ескерім

  • URL сүзгілерін пайдалана отырып Liquid үлгісінде URL динамикалық түрде құрастыруға болады.
  • Request.url мекен-жайы бойынша пайдаланылатын URL мекен-жайы кез келген сұралған мән бола алады және келесі сұраныстар үшін кэштеледі. Request.url сайтында дұрыс мәнді қамтамасыз ету үшін ауыстыру тегін пайдалануды қарастырыңыз, мысалы, ішінара URL мекенжайы {WebFile жолы}немесе Сайт параметрлері тармағындағы порталдың URL мекенжайын сақтау.
  • Power Apps порталдарының 9.3.8.x немесе одан кейінгі шығарылым нұсқасында әдепкі бойынша пайдаланушыға қолданылатын Liquid сүзгісін болдырмау және Liquid нысандарын сұрау опциялары болады. Бұл әдепкі конфигурацияны өшіру және осы Liquid нысандарына Liquid сүзгісінен шықпай рұқсат беру үшін, портал сайтының параметрлері - Site/EnableDefaultHtmlEncoding бөлімін қараңыз.

Төлсипаттар

Атрибут Сипаттамасы
params Ағымдағы сұрауға арналған атауы бар параметрдің мәндері. params — URL сұрау жолы параметрлері, пішін хабары параметрлері және cookie файлдары тіркесімі.
Жол Ағымдағы сұрау URL жолы.
/profile/
path_and_query Ағымдағы сұрау URL жолы және сұрауы.
/profile/?foo=1&bar=something
сұрау Ағымдағы сұрау URL сұрау бөлігі.
?foo=1&bar=something
URL Ағымдағы сұраудың толық URL.
https://www.example.com/profile/?foo=1&bar=something

searchindex

Searchindex нысаны Power Apps Dataverse кесте тегтері ішінде пайдаланылады және сұрау нәтижелеріне қатынасуды қамтамасыз етеді.

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

Төлсипаттар

Төлсипат Сипаттама
approximate_total_hits Индекс сұрауына сәйкес жалпы сәйкестіктердің шамамен санын қайтарады. Қауіпсіз сүзгілеуге және басқа дизайн факторларына байланысты іздеу индексі жұмыс істеу жолына байланысты осы сан тек жуық сан болып табылады әрі кейбір жағдайларда ағымдағы пайдаланушыға қолжетімді нәтижелердің жалпы санына сәйкес келмеуі мүмкін.
Бет Ағымдағы сұраудың бет нөмірін қайтарады.
page_size Ағымдағы сұраудың максималды бет өлшемін қайтарады. Ағымдағы бет үшін қайтарылатын нәтижелердің іс жүзіндегі саны керек болса (себебі бұл максималды бет өлшемінен аз болуы мүмкін), results.size пайдалану керек.
Нәтижелер Сұрау нәтижесі бетін қайтарады, себебі іздеу индексі нысандар береді.

Іздеу индексі нәтижелері

Төлсипат Сипаттама
нысан Нәтижеге арналған негізінде жатқан нысандар.
fragment <em> HTML тегі арқылы белгіленген, көрсетілген сұрауға сәйкес шарттар бар нәтиженің қатысты қысқа мәтін бөлігі. Сұраулардың белгілі бір түрлерінде ұқсас сұраулар (~) және қойылмалы сұраулар (*) сияқты бөлектелген фрагменттерге қолдау көрсетілмейді. Бұл сипат осы жағдайларда бос мән болады.
Идентификатор Жол түріндегі нәтиженің негізгі жазбасының Power Apps кестесінің идентификаторы. Мысалы, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Нәтиженің негізгі жазбасының Power Apps кестесінің логикалық атауы. Мысалы, adx_webpage
Сан 1-ден бастап барлық нәтиже беттері бойынша нәтиже нөмірі. Мысалы, 10 бет өлшемі бар нәтижелердің екінші бетінің бірінші нәтижесі үшін осы мән 11 болады.
score Қалқымалы нүкте мәні ретінде нәтиженің Lucene көрсеткіші. Нәтижелер осы мәнмен қайтарылады.
title Нәтиженің тақырыбы.
URL Нәтиженің URL мекенжайы. Бұл әдетте толық URL емес, ағымдағы бағдарламаның абсолютті жолы болады, —бірақ міндетті түрде емес—. Мысалы: /articles/article1/

параметрлері

Кез келген сайт параметрін аты бойынша жүктеу мүмкіндігін береді. Егер берілген атты параметр табылмаса, нөл қайтарылады.

Ескерім

Параметрлер жолдар түрінде қайтарылады, бірақ басқа түрлерге түрлендіру үшін Түр сүзгілерін пайдалануға болады.

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

Ескерім

Веб-сайт тақырыбын және негізгі навигация тақтасын көрсету

торап картасы

Порталдың торап картасына кіру құқығын береді.

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

Сайт картасының төлсипаттары

Төлсипат Сипаттама
Ағымдағы Ағымдағы бет үшін торап картасы түйіні нысанын қайтарады.
Түбір Веб-сайттың түбірлік (басты) беті үшін торап картасы түйінінің нысанын қайтарады.

Сайт картасы түйінінің төлсипаттары

Төлсипат Сипаттама
Түйірлер Түйін үшін сайт картасы түбірлік түйінінен басталатын және тектік элементте аяқталатын түйір сайт картасы түйінінің нысандарын қайтарады.
Балалар Түйіннің еншілес торап картасы түйінінің нысандарын қайтарады.
Сипаттама Түйіннің сипаттамасы/қорытынды мазмұны. (Бұл өрісте HTML болуы мүмкін.)
Нысан Түйіннің негізгі нысандарын қайтарады. Егер түйінде негізгі кесте болмаса, бұл мән нөл болады.
is_sitemap_ancestor Егер сайт картасының түйіні ағымдағы түйіннің тектік түйіні болса, true мәнін қайтарады, олай болмаса, false мәнін қайтарады.
is_sitemap_current Егер сайт картасының түйіні ағымдағы түйін болса, true мәнін қайтарады, олай болмаса, false мәнін қайтарады.
Басты Түйіннің негізгі торап картасы түйінін қайтарады. Егер түйін түбірлік түйін болса, тектік түйіннің мәні null болады.
Лауазымы Түйіннің тақырыбы.
URL Түйіннің URL мекенжайы.

cайт белгілері

Сайт белгісін ат бойынша жүктеуге мүмкіндік береді. Егер сайт белгісі болса, сайт белгісі нысаны қайтарылады. Егер берілген атты сайт таңбалаушысы табылмаса, нөл қайтарылады.

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

Ескерім

Веб-сайт тақырыбын және негізгі навигация тақтасын көрсету

Сайт белгісінің төлсипаттары

Төлсипат Сипаттама
URL Сайт белгісі нысанының URL мекенжайы.
[төлсипаттың логикалық атауы] Сайт белгісінің мақсатты Power Apps жазбасының кез келген төлсипатына логикалық атауы бойынша қатынасуға болады. Мысалы, {{ sitemarker.adx_name }}

бөліктер

Мазмұн бөліктерін ат бойынша жүктеуге мүмкіндік береді. Егер берілген атты бөлік табылмаса, нөл мәні қайтарылады.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Қайталау тегтері цикл блогында пайдалы сипаттарды қамтиды.

Ескерім

tablerowloop шартын тек Қайталау тегтері тегінің ішінде пайдалануға болады.

Төлсипаттар

Төлсипат Сипаттама
Col 1-ден басталатын ағымдағы жол индексін қайтарады.
col0 0-ден басталатын ағымдағы жол индексін қайтарады.
col_first Егер ағымдағы баған жолдағы бірінші баған болса, шын мәнін қайтарады, ал егер болмаса, жалған мәнін қайтарады.
col_last Егер ағымдағы баған жолдағы соңғы баған болса, шын мәнін қайтарады, ал егер болмаса, жалған мәнін қайтарады.
Бірінші Циклдің бірінші қайталануы болса, true мәнін қайтарады. Бұл бірінші қайталау болмаса, false мәнін қайтарады.
Индекс Бірінші элементтің орны 1 болатын жинақтағы ағымдағы элемент орны.
index0 Бірінші элементтің орны 0 болатын жинақтағы ағымдағы элемент орны.
Соңғы Циклдің соңғы қайталануы болса, true мәнін қайтарады. Бұл соңғы қайталау болмаса, false мәнін қайтарады.
Length Цикл қайталаулары санын қайтарады ߝ жинақтағы элементтер саны қайталанады.
Rindex Циклде қалған элементтер саны (ұзындық - индекс), мұндағы 1 — соңғы элементтің индексі.
rindex0 Циклде қалған элементтер саны (ұзындық - индекс), мұндағы 0 — соңғы элементтің индексі.

пайдаланушы

Негізгі Power Apps контакт жазбасының барлық төлсипаттарына қатынас беретін ағымдағы портал пайдаланушысын білдіреді. Егер пайдаланушы жүйеге кірмесе, осы айнымалы мән нөл болады.

пайдаланушы — нысан нысаны.

{% if user %}
 
Hello, {{ user.fullname | escape }}!
 
{% else %}
 
Hello, anonymous user!
 
{% endif %}

Ескерім

Power Apps порталдарының 9.3.8.x немесе одан кейінгі шығарылым нұсқасында әдепкі бойынша пайдаланушыға қолданылатын Liquid сүзгісін болдырмау және Liquid нысандарын сұрау опциялары болады. Бұл әдепкі конфигурацияны өшіру және осы Liquid нысандарына Liquid сүзгісінен шықпай рұқсат беру үшін, портал сайтының параметрлері - Site/EnableDefaultHtmlEncoding бөлімін қараңыз.

Төлсипаттар

Нысан нысаны төлсипаттарының барлығының болуына қоса, пайдаланушыда келесі төлсипаттар бар.

Атрибут Сипаттама
рөлдер Пайдаланушы тиесілі рөлдерді көрсеткі ретінде қайтарады.
{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}
Ескертпе: жеке рөл мүшеліктерін сынауға has_role сүзгісін де пайдалана аласыз.
basic_badges_url Пайдаланушы белгілерін алу үшін қызметтік url мекенжайын қайтарады.
Пайдаланушы белгілерін көрсету үшін, "data-badge" және "data-uri" төлсипаттары бар тегті қосуыңыз керек. Ағымдағы пайдаланушы белгілерін көрсету үшін:
<div data-badge data-uri='{{user.basic_badges_url }}'></div>
Пайдаланушы белгілерін ИД бойынша көрсету үшін (userid айнымалысы):
`<div data-badge data-uri='{{user.basic_badges_url

веб-сілтемелер

Кез келген веб-сілтемелерді атауы немесе идентификаторы бойынша жүктеуге мүмкіндік береді.

Егер веб-сілтеме жинағы болса, веб-сілтеме жинағының нысаны қайтарылады. Егер берілген атаумен немесе идентификатормен веб-сілтемелер жинағы табылмаса, нөл қайтарылады.

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

Ескерім

Веб-сайттың үстіңгі деректемесін және негізгі навигация тақтасын көрсету |

Веб-сілтеме жинағы төлсипаттары

Ескерім

Веб-сілтеме жинағы — төменде тізілгендерге қоса барлық бірдей төлсипаттары бар нысан нысаны.

Атрибут Сипаттама
Көшіру Веб-сілтеме жинағының HTML көшірмесі.
Атау Веб-сілтеме жинағының аты.
Лауазымы Веб-сілтеме жинағының атауы.
Веб-сілтемелер Веб-сілтеме жинағымен байланысты веб-сілтеме нысандарының көрсеткісі.
[төлсипаттың логикалық атауы] Веб-сілтеме жинағының Power Apps жазбасының кез келген төлсипатына логикалық атауы бойынша қатынасуға болады. Мысалы, {{ weblinkset.createdon }}

Веб-сілтеме төлсипаттары

Ескерім

Веб-сілтеме — төменде тізілгендерге қоса барлық бірдей төлсипаттары бар нысан нысаны.

Атрибут Сипаттама
Сипаттама Веб-сілтеменің HTML сипаттамасы.
display_image_only Логикалық төлсипат ешбір сілтеме мәтінінсіз тек кескін ретінде көрсетілуі керек веб-сілтемені көрсетеді.
display_page_child_links Байланыстырылған беттің sitemap еншілес беттеріне сілтемелерді қосымша сілтемелер түрінде көрсету-көрсетпеуі керектігін көрсететін логикалық төлсипат.
Сурет Осы сілтеменің веб-сілтеме кескіні нысаны. Егер ешбір кескін болмаса, осы төлсипат бос болады.
is_external Логикалық төлсипат веб-сілтеменің мақсатты URL мекенжайы сыртқы торапқа байланысын көрсетеді (ішкі портал бетінен басқа).
is_sitemap_ancestor Егер веб-сілтеме URL мекенжайы ағымдағы сайт картасы түйінінің тектік түйініне сілтеме жасаса, true мәнін қайтарады, олай болмаса, false мәнін қайтарады.
is_sitemap_current Егер веб-сілтеменің URL мекенжайы ағымдағы сайт картасы түйініне сілтеме жасаса, true мәнін қайтарады, олай болмаса, false мәнін қайтарады.
Атау Веб-сілтеме жинағының аты/атауы.
Nofollow Веб-сілтемені rel=nofollow ретінде белгілеу керек немесе керек еместігін көрсететін логикалық төлсипат.
open_in_new_window Логикалық төлсипат таңдалған кезде жаңа браузер терезесінде/қойыншасында ашылуы керек веб-сілтемені көрсетеді.
Сөзкөмек Веб-сілтеменің сөзкөмек мәтіні.
URL Веб-сілтеменің URL мекенжайы.
Веб-сілтемелер Веб-сілтеме жинағымен байланысты еншілес веб-сілтеме нысандарының көрсеткісі.
[төлсипаттың логикалық атауы] Веб-сілтеменің Power Apps жазбасының кез келген төлсипатына логикалық атауы бойынша қатынасуға болады. Мысалы, {{ weblink.createdon }}

Веб-сілтеме кескінінің төлсипаттары

alternate_text Суретке арналған балама мәтін.
Биіктік Бүтін санда кескіннің көрсетілген биіктігі бар. Егер ешбір биіктік мәні берілмесе, осы төлсипат бос болады.
URL Кескіннің URL мекенжайы.
Ені Кескіннің көрсетілген енін қамтитын бүтін сан. Егер ешбір ен мәні берілмесе, осы төлсипат бос болады.

веб-сайт

Порталдың Power Apps веб-сайты (adx_website) жазбасының барлық төлсипаттарына қатынасты беретін порталдың веб-сайтын білдіреді.

Ескерім

Веб-сайт — барлық төлсипаттары бірдей нысан нысаны.

Код

{{ website.adx_name }} ({{ website.id }})

Шығыс

Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)

Төлсипаттар

Келесі кестеде кэштеуді болдырмау үшін әдепкі параметрлерді ауыстыруға болатын осы тегтің төлсипаттары келтірілген.

Әдепкі Ауыстыру (кэштеуді болдырмайды) Мысал
sign_in_url sign_in_url_substitution Әдепкі: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F
Ауыстыру (кэштеуді болдырмайды): website.sign_in_url_subststit :/en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F
(осы мысалдағы «substitute-page» әдепкіде кэштелген URL мекенжайын ауыстырады.)
sign_out_url sign_out_url_substitution Әдепкі: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F
Ауыстыру (кэштеуді болдырмайды): website.sign_out_url_substitution :/en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F
(осы мысалдағы «substitute-page» әдепкіде кэштелген URL мекенжайын ауыстырады.)

Сондай-ақ келесіні қараңыз

Liquid түрлері
Liquid тегтері
Liquid сүзгілері

Ескерім

Сіз құжат тіліңіздің артықшылықтары туралы айта аласыз ба? Қысқа сауалнамаға қатысыңыз. (бұл сауалнама ағылшын тілінде екеніне назар аударыңыз)

Сауалнама шамамен жеті минут уақытыңызды алады. Жеке деректер жиналмайды (құпиялылық туралы мәлімдеме).