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

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

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

{{ page.title }}

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

{{ page["title"] }}

{% assign attribute_name = "Name with spaces" %}

{{ object[attribute_name] }}

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

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

Барлық Liquid нысандары

ads

blogs

entities

entitylist

entityview

events

forloop

forums

knowledge

page

polls

request

searchindex

settings

sitemap

sitemarkers

snippets

tablerowloop

user

weblinks

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 төлсипаттары

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

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

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

Ескерім

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 мекенжайы.
content Хабар үшін мазмұн өрісі қайтарады.
content Хабар үшін мазмұн өрісі қайтарады.
author Хабар үшін authorf қайтарады (бұл кәдімгі контакт нысаны).
title Хабар атауы.
comment_count Берілген хабардың түсініктемелер саны үшін бүтін мәнді қайтарады.
publish_date Хабар жарияланған күн.

нысандар

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

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

{% if account %}

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

{% endif %}

{% assign entity_logical_name = 'contact' %}

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

{% if contact %}

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

{% endif %}

Entity

entity нысаны Dynamics 365 нысан жазбасының төлсипаттарына қатынасты қамтамасыз етеді.

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

Нысан анықтамасы

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

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

Ескертпе

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

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

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

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

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

Нысан рұқсаттары

Нысан рұқсаттары нысаны біріктірілген рұқсатты растау нәтижелеріне қатынас береді.

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

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

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

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

нысан тізімі

entitylist нысаны Dynamics 365 нысан тегтерінің ішінде пайдаланылады. Бұл берілген нысан тізімінің барлық төлсипаттарына қатынас береді.

Төлсипаттар

Ескерім

entities

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

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

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

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

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

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

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

Төлсипаттар

Төлсипат Сипаттама
columns Көріністегі бағандарды entitylist көрінісі бағанының нысандары түрінде қайтарады.
entity_permission_denied Егер көрініс нәтижелеріне қатынас ағымдағы пайдаланушының жеткіліксіз нысан рұқсаттарына байланысты тыйым салынса, true мәні қайтарылады. Егер көрініс нәтижелерін оқу рұқсаты берілсе, false мәні қайтарылады.
entity_logical_name Көрініс нәтижесі жазбаларының Dynamics 365 нысанының логикалық атауы. Мысалы: contact
first_page Көрініс нәтижелерінің бірінші бетінің нөмірі. Бұл 1 болады, егер ешбір нәтижелер қайтарылмаса, null болады.
Идентификатор Осы entityview анықтайтын Dynamics 365 көрінісінің GUID идентификаторы.
language_code Dynamics 365 бүтін тіл коды ағымдағы көріністің локализацияланған белгілерін жүктеуге пайдаланылады.
last_page Көрініс нәтижелерінің соңғы бетінің нөмірі. Егер ешбір нәтижелер қайтарылмаса, бұл null болады.
аты Осы entityview анықтайтын Dynamics 365 көрінісінің атауы, мысалы, белсенді контактілер.
next_page Көрініс нәтижелерінің келесі бетінің нөмірі. Егер нәтижелердің келесі беті болмаса, бұл null болады.
Бет Көрініс нәтижелерінің ағымдағы бетінің нөмірі.
беттер Ағымдағы көрініс үшін барлық нәтижелер беттерінен тұратын бет нөмірлерінің көрсеткісін қайтарады.
page_size Ағымдағы көрініс үшін әр бетте қайтарылатын нәтижелер саны.
previous_page Көрініс нәтижелерінің келесі бетінің нөмірі. Егер нәтижелердің алдыңғы беті болмаса, бұл null болады.
primary_key_logical_name Осы көрініс үшін нәтиже нысанының бастапқы негізгі төлсипатының Dynamics 365 логикалық атауы. Мысалы: 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 нысанында келесі төлсипаттар бар:

Төлсипат Сипаттама
occurences Оқиғаның барлық қайталануларын қамтитын 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>

forums нысаны

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

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 нысаны

Төлсипаттар

Ескерім

entities

Төлсипат Сипаттама
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

Порталда мақалалар мен санаттарды бейнелеу үшін Dynamics 365 knowledgearticle және category нысандарының жазбаларына қатынасты қамтамасыз етеді.

Төлсипаттар

Төлсипат Сипаттама
мақалалар Порталда қолжетімді knowledgearticle нысанының жазбалары үшін мақала нысандарын қамтитын мақалалар нысанын қайтарады.
categories Порталда қолжетімді category нысанының жазбалары үшін category нысандарын 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 нысаны category нысандарының жинағына қатынасуға мүмкіндік береді. 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 Соңғы өзгертілген күнді қамтитын category нысандарының жинағын қайтарады.
top_level Тектік санаты жоқ category нысандарының жинағын қайтарады.

Сүзгілер

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

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Төлсипат Сипаттама
recent Соңғы өзгертілген күнді қамтитын category нысандарының жинағын қайтарады. `{% assign recent_categories = knowledge.categories \ параметрлерін көрсетуге болады
top_level Тектік санаты жоқ category нысандарының жинағын қайтарады. {% 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 Санаттың санат нөмірі.
аты Санат атауының баламалы бүркеншік аты.
title Санаттың атауы.

бет

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

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

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

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 Ағымдағы пайдаланушы (тіркелген немесе жасырын) осы сұрауда дауыс берілгенде шын күйі қайтарылады.
Атау Сұрау үшін Ат өрісін қайтарады.
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'] %}

<a href="{{ request.url | add_query: 'foo', 1 }}">Link</a>
Ескерім

URL сүзгілерімен Liquid үлгісінде URL динамикалық түрде құрастыруға болады.

Төлсипаттар

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

searchindex

searchindex нысаны Dynamics 365 нысан тегтері ішінде пайдаланылады және сұрау нәтижелеріне қатынасты қамтамасыз етеді.

{% 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 пайдалану керектігін ескеріңіз.
Нәтижелер Сұрау нәтижесі бетін қайтарады, себебі іздеу индексі нысандар береді.

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

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

параметрлер

Кез келген Порталдар үшін сайт параметрлерін конфигурациялауды атауы бойынша жүктеуге мүмкіндік береді. Атауы осындай параметр табылмаса, Liquid түрлері қайтарылады.

Ескерім

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

{{ 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 болуы мүмкін.)
Нысан Түйіннің негізгі entities нысанын қайтарады. Егер түйінде негізгі нысан болмаса, бұл мән null болады.
is_sitemap_ancestor Егер сайт картасының түйіні ағымдағы түйіннің тектік түйіні болса, true мәнін қайтарады, олай болмаса, false мәнін қайтарады. 7.0.0008 қосылды
is_sitemap_current Егер сайт картасының түйіні ағымдағы түйін болса, true мәнін қайтарады, олай болмаса, false мәнін қайтарады. 7.0.0008 қосылды
Басты Түйіннің негізгі торап картасы түйінін қайтарады. Егер түйін түбірлік түйін болса, тектік түйіннің мәні null болады.
Лауазымы Түйіннің тақырыбы.
URL Түйіннің URL мекенжайы.

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

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

{{ 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 мекенжайы.
[төлсипаттың логикалық атауы] Сайт белгісінің мақсатты Dynamics 365 жазбасының кез келген төлсипатына логикалық атауы бойынша қатынасуға болады. мысалы, {{ sitemarker.adx_name }}

бөліктер

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

{{ snippets["Header"] }}

{% assign footer = snippets["Footer"] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

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

Ескерім

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

Төлсипаттар

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

пайдаланушы

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

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

{% if user %}

Hello, {{ user.fullname }}!

{% else %}

Hello, anonymous user!

{% endif %}

Төлсипаттар

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

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

Ескерім

entities

Код

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

Нәтиже

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

веб-сайт

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

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

<!-- 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 %}
Ескерім

entities

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

entities

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

Сонымен қатар, қараңыз

Динамикалық мазмұн қосу және теңшелетін үлгілер жасау
Liquid түрлері
Liquid нысандары
Liquid тегтері
Liquid сүзгілері