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

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

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

Маңызды

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

{{ page.title }}

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

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

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

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

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

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

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

Атрибут	Сипаттамасы
Идентификатор	Жол ретіндегі кестенің GUID идентификаторы. Мысалы, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Кестенің Dataverse логикалық атауы.
Ескертпелер	Ең ескіден ең жаңасына (createdon) қарай ретпен орналастырылған кестемен байланысты кез келген ескертпелерді (аннотация) жүктейді. Ескертпелер ескертпе нысандары ретінде қайтарылады.
рұқсаттар	Кесте үшін кесте рұқсатын растау нәтижелерін жүктейді. Нәтижелер рұқсаттар нысаны ретінде қайтарылады.
url	Кесте үшін Power Pages контентін басқару жүйесінің URL жолын қайтарады. Егер кестенің ағымдағы веб-сайтта жарамды URL мекенжайы болмаса, нөл мәні қайтарылады. Негізінде, бағдарламада URL провайдері теңшелмесе, бұл CMS порталына енгізілген белгілі бір кесте түрлерінің мәнін ғана қайтарады.
[атрибуттың немесе қарым-қатынастың атауы]	Dataverse кестенің кез келген төлсипатына логикалық атауы бойынша қатынасуға болады. {{ 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	Анықтамалық кестенің Dataverse логикалық атауы.
Аты	Анықтамалық кестенің негізгі атының төлсипаты.

Ескертпе

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

Атрибут	Сипаттама
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 нысаны 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	Осы тізіммен көрсетілетін жазбалар үшін Dataverse кестесінің логикалық атауын қайтарады. Мысалы: 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	Тізімінің барлық локализацияланған белгілерін таңдауға пайдаланылатын Dataverse бүтін тіл кодын қайтарады.
page_size	Тізім үшін конфигурацияланған нәтиже беті өлшемін қайтарады.
primary_key_name	Осы тізіммен көрсетілетін жазбалардың негізгі кілт төлсипатының логикалық атауын қайтарады.
search_enabled	Егер осы тізім үшін іздеу қосылса, "шын" мәнін қайтарады. Олай болмаса, false мәнін қайтарады.
search_placeholder	Тізімді іздеу өрісінің орнын толтырғыш үшін конфигурацияланған локализацияланған мәтінді қайтарады.
search_tooltip	Тізімді іздеу сөзкөмегі үшін конфигурацияланған локализацияланған мәтінді қайтарады.
көріністер	Тізімнің қолжетімді көріністерін тізім көрінісінің нысандары ретінде қайтарады.
[атрибуттың логикалық атауы]	кесте нысанымен бірдей әдіспен логикалық атауы бойынша тізім (adx_entitylist) Dataverse жазбасының кез келген атрибутына қол жеткізуге болады. Мысалы, {{ entitylist.adx_name }}

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

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

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

Төлсипат	Сипаттама
attribute_type	Жол ретінде баған үшін Dataverse төлсипаты түрінің атауын қайтарады. Мысалы, Lookup, Picklist, String, Boolean, DateTime
logical_name	Баған үшін Dataverse төлсипатының логикалық атауын қайтарады. Мысалы, createdon
Атау	Баған үшін локализацияланған Dataverse көрсетілетін атауын қайтарады. Мысалы, 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	Көрініс нәтижесі жазбаларының Dataverse кестесінің логикалық атауы. Мысалы: contact
first_page	Көрініс нәтижелерінің бірінші бетінің нөмірі. Бұл 1 болады, егер ешбір нәтижелер қайтарылмаса, null болады.
Идентификатор	Осы entityview анықтайтын Dataverse көрінісінің GUID идентификаторы.
language_code	Dataverse бүтін тіл коды ағымдағы көріністің локализацияланған белгілерін жүктеуге пайдаланылады.
last_page	Көрініс нәтижелерінің соңғы бетінің нөмірі. Егер ешбір нәтижелер қайтарылмаса, бұл null болады.
аты	Осы entityview анықтайтын Dataverse көрінісінің атауы, мысалы, белсенді контактілер.
next_page	Көрініс нәтижелерінің келесі бетінің нөмірі. Егер нәтижелердің келесі беті болмаса, бұл null болады.
Бет	Көрініс нәтижелерінің ағымдағы бетінің нөмірі.
беттер	Ағымдағы көрініс үшін барлық нәтижелер беттерінен тұратын бет нөмірлерінің көрсеткісін қайтарады.
page_size	Ағымдағы көрініс үшін әр бетте қайтарылатын нәтижелер саны.
previous_page	Көрініс нәтижелерінің келесі бетінің нөмірі. Егер нәтижелердің алдыңғы беті болмаса, бұл null болады.
primary_key_logical_name	Осы көрініс үшін нәтиже кестесінің негізгі кілт төлсипатының Dataverse логикалық атауы. Мысалы: contactid.
жазбалар	Кесте нысандары ретіндегі көріністің нәтиже жазбаларының ағымдағы беті.
sort_expression	Көріністің әдепкі сұрыптау өрнегі. Мысалы, nameASC, createdon DESC.
total_pages	Көрініс нәтижесі беттерінің жалпы саны.
total_records	Көрініс нәтижелерінің жалпы саны (барлық беттер бойынша).

оқиғалар

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

events нысаны

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

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

Атрибут	Сипаттамасы
occurences	Порталдағы барлық оқиға қайталануларын қамтитын eventoccurancessobject нысанын қайтарады
[оқиға атауы немесе идентификаторы]	Name немесе Id сипаттары арқылы кез келген оқиғаға қатынасуға болады. {% assign event = events["Event Name"] %} {% 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 нысаны

Төлсипаттар

Ескертпе

нысандар

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

forumposts нысаны

Төлсипаттар

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

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

Төлсипаттар

Ескертпе

нысандар

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

knowledge

Порталда мақалалар мен санаттарды көрсету үшін Dataverse 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 мекенжайы және кез келген басқа төлсипаттар немесе негізгі Dataverse жазбасының қатысты нысандары сияқты нәрселерге қатынасты береді.

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

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

Ескертпе

нысандар

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

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

Ескертпе

нысандар

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

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

Ескертпе

нысандар

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

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

Ескертпе

нысандар

Төлсипат	Сипаттама
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 Pages порталдарының 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 нысаны 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 тегі арқылы белгіленген, көрсетілген сұрауға сәйкес шарттар бар нәтиженің қатысты қысқа мәтін бөлігі. Сұраулардың белгілі бір түрлерінде анық емес сұраулар (~) және алмастырылатын сұраулар (*) сияқты бөлектелген фрагменттерге қолдау көрсетілмейді. Бұл сипат осы жағдайларда бос мән болады.
Идентификатор	Жол түріндегі нәтиженің негізгі жазбасының Dataverse кестесінің идентификаторы. Мысалы, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Нәтиженің негізгі жазбасының Dataverse кестесінің логикалық атауы. Мысалы, 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 мекенжайы.
[атрибуттың логикалық атауы]	Сайт белгісінің мақсатты Dataverse жазбасының кез келген төлсипатына логикалық атауы бойынша қатынасуға болады. Мысалы, {{ 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 — соңғы элементтің индексі.

пайдаланушы

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

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

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

Ескертпе

Power Pages порталдарының 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 көшірмесі.
Атау	Веб-сілтеме жинағының аты.
Лауазымы	Веб-сілтеме жинағының атауы.
Веб-сілтемелер	Веб-сілтеме жинағымен байланысты веб-сілтеме нысандарының көрсеткісі.
[атрибуттың логикалық атауы]	Веб-сілтеме жинағының Dataverse жазбасының кез келген төлсипатына логикалық атауы бойынша қатынасуға болады. Мысалы, {{ 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 мекенжайы.
Веб-сілтемелер	Веб-сілтеме жинағымен байланысты еншілес веб-сілтеме нысандарының көрсеткісі.
[атрибуттың логикалық атауы]	Веб-сілтеменің Dataverse жазбасының кез келген төлсипатына логикалық атауы бойынша қатынасуға болады. Мысалы, {{ weblink.createdon }}

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

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

веб-сайт

Порталдың Dataverse веб-сайты (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 сүзгілері