Қолжетімді тегтер

Мына бөлімдерде әрбір тег түрі сипатталған:

Басқару ағыны тегтері

Басқару ағыны тегтері берілген шарттар негізінде орындалуы керек код блогын және көрсетілуі қажет мазмұнды анықтайды. Шарттар қолжетімді Liquid операторларын пайдаланып немесе жай ғана Conditional негізінде құрастырылады.

if

Берілген шартқа сәйкес болса, код блогын орындайды.

{% if user.fullname == 'Dave Bowman' %}

Hello, Dave.

{% endif %}

unless

If сияқты, берілген шартқа сәйкес болмаса, код блогы орындалады.

{% unless page.title == 'Home' %}

This is not the Home page.

{% endunless %}

elsif/else

if немесе unless блогына бірнеше шартты қосады.

{% if user.fullname == 'Dave Bowman' %}

Hello, Dave.

{% elsif user.fullname == 'John Smith' %}

Hello, Mr. Smith.

{% else %}

Hello, stranger.

{% endif %}

case/when

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

{% case user.fullname %}

{% when 'Dave Bowman' %}

Hello, Dave.

{% when 'John Smith' %}

Hello, Mr. Smith.

{% else %}

Hello, stranger.

{% endcase %}

Қайталау тегтері

Қайталау тегтері код блогын іске қосуға/көрсетуге пайдаланылады.

үшін

Код блогын қайта орындайды. Бұл көрсеткіде немесе сөздікте элементтерді қайталауға пайдаланылады.

for тег блогында forloop қолжетімді.

Код

{% for child_page in page.children %}

<a href="{{ child_page.url }}">{{ child_page.title }}</a>

{% endfor %}

Нәтиже

<a href="/parent/child1/">Child 1</a>

<a href="/parent/child2/">Child 2</a>

<a href="/parent/child3/">Child 3</a>

Параметрлер

For операторының осы параметрлерін жеке немесе бірге пайдалануға болады.

limit

Берілген элементтер санынан кейін циклден шығады.

Код

{% for child_page in page.children limit:2 %}

<a href="{{ child_page.url }}">{{ child_page.title }}</a>

{% endfor %}

Нәтиже

<a href="/parent/child1/">Child 1</a>

<a href="/parent/child2/">Child 2</a>

offset

Берілген индексте циклді бастайды.

Код

{% for child_page in page.children offset:1 %}

<a href="{{ child_page.url }}">{{ child_page.title }}</a>

{% endfor %}

Нәтиже

<a href="/parent/child2/">Child 2</a>

<a href="/parent/child3/">Child 3</a>

range

Циклдің сандар ауқымын анықтайды.

Код

{% assign n = 4 %}

{% for i in (2..n) %}

{{ i }}

{% endfor %}

{% for i in (10..14) %}

{{ i }}

{% endfor }}

Нәтиже

2 3 4

10 11 12 14

reversed

Соңғы элементтен бастап циклде кері ретпен қайталайды.

Код

{% for child_page in page.children reversed %}

<a href="{{ child_page.url }}">{{ child_page.title }}</a>

{% endfor %}

Нәтиже

<a href="/parent/child3/">Child 3</a>

<a href="/parent/child2/">Child 2</a>

<a href="/parent/child1/">Child 1</a>

cycle

Жолдар тобы бойынша өңделеді және параметрлер ретінде өткен ретпен шығарылады. Әрбір уақыт циклі шақырылады, параметр ретінде өткен келесі жол шығарылады.

Код

{% for item in items %}

<div class="{% cycle 'red', 'green', 'blue' %}"> {{ item }} </div>

{% end %}

Нәтиже

<div class="red"> Item one </div>

<div class="green"> Item two </div>

<div class="blue"> Item three </div>

<div class="red"> Item four </div>

<div class="green"> Item five</div>

tablerow

HTML кестесін құрады. Ашатын <table> және жабатын </table> HTML тегтерінде оралуы қажет.

tablerow тег блогында tablerowloop қолжетімді.

Код

<table>

{% tablerow child_page in page.children %}

{{ child_page.title }}

{% endtablerow %}

</table>

Нәтиже

<table>

<tr class="row1">

<td class="col1">

Child Page 1

</td>

<td class="col2">

Child Page 2

</td>

<td class="col3">

Child Page 3

</td>

<td class="col4">

Child Page 4

</td>

</tr>

</table>

Параметрлер

tablerowcan тегінің осы параметрлерін жеке немесе бірге пайдалануға болады.

Нәтиже

<table>

<tr class="row1">

<td class="col1">

Child Page 1

</td>

<td class="col2">

Child Page 2

</td>

</tr>

<tr class="row2">

<td class="col3">

Child Page 3

</td>

<td class="col4">

Child Page 4

</td>

</tr>

</table>

Код

<table>

{% tablerow child_page in page.children cols:2 %}

{{ child_page.title }}

{% endtablerow %}

</table>

Кестеде құрылуы керек қатарлар санын көрсетеді.

cols

limit

Берілген элементтер санынан кейін циклден шығады.

Код

<table>

{% tablerow child_page in page.children limit:2 %}

{{ child_page.title }}

{% endtablerow %}

</table>

Нәтиже

<table>

<tr class="row1">

<td class="col1">

Child Page 1

</td>

<td class="col2">

Child Page 2

</td>

</tr>

</table>

offset

Берілген индексте циклді бастайды.

Код

<table>

{% tablerow child_page in page.children offset:2 %}

{{ child_page.title }}

{% endtablerow %}

</table>

Нәтиже

<table>

<tr class="row1">

<td class="col1">

Child Page 3

</td>

<td class="col2">

Child Page 4

</td>

</tr>

</table>

range

Циклдің сандар ауқымын анықтайды.

Код

<table>

{% tablerow i in (1..3) %}

{{ i }}

{% endtablerow %}

</table>

Айнымалы тегтер

Айнымалы тегтер жаңа Liquid айнымалыларын жасауға пайдаланылады.

assign

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

Код

{% assign is_valid = true %}

{% if is_valid %}

It is valid.

{% endif %}

{% assign name = "dave bowman' | upcase %}

{{ name }}

Нәтиже

It is valid.

DAVE BOWMAN

capture

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

Код

{% capture hello %}Hello, {{ user.fullname }}.{% endcapture %}

{{ hello }}

{{ hello }}

Нәтиже

Hello, DAVE BOWMAN.

Hello, DAVE BOWMAN.

Үлгі тегтері

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

include

Бір үлгі мазмұнын басқасына аты бойынша қосады. Dynamics 365 порталдарында осы басқа үлгінің көзі әдетте веб-үлгі болады. Бұл жалпы үлгі фрагменттерін бірнеше орынға қайта пайдалануға мүмкіндік береді.

Үлгі басқасына қосылған кезде қосылған үлгі негізгі үлгіде анықталған айнымалыларға кіреді.

{% include 'My Template' %}

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

{% include 'My Template' a:x, b:y %}

block

Үлгіні иеленуді қамтамасыз ету үшін extends тегімен бірге пайдаланылады. Пайдаланылуын extends бөлімінде қараңыз.

extends

Блоктер тегімен бірге пайдаланылады, үлгіні иеленуді қамтамасыз етеді. Бұл негізгі орналасудың белгілі бір аймақтарын қайта анықтау кезінде бірнеше пайдаланушының ортақ орналасуды пайдалануына мүмкіндік береді.

In Dynamics 365 порталдарында тегке берілген негізгі үлгі атауы әдетте веб-үлгі атауын білдіреді.

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

Егер негізгі үлгіде анықталған блок қайта анықталмаса, негізгі үлгідегі мазмұн (бар болса) көрсетіледі.

comment

Көрсетілмеген кодты Liquid үлгісінде қалдыруға мүмкіндік береді. Блоктағы мазмұн көрсетілмейді және Liquid коды орындалмайды.

Код

Hello{% comment %}, {{ user.fullname }}{% endcomment %}. My name is Charles.

Нәтиже

Hello. My name is Charles.

raw

Талдаусыз және орындаусыз бетте Liquid кодын шығаруға мүмкіндік береді.

Нәтиже

Hello, {{ user.fullname }}. My name is Charles.

Dynamics 365 нысаны тегтері

Dynamics 365 нысан тегтері Dynamics 365 деректерін жүктеу және көрсету үшін пайдаланылады немесе Dynamics 365 порталдары арқаулық жүйесінің басқа қызметттерін пайдаланыңыз. Бұл тегтер — Liquid тіліндегі Dynamics 365 жүйесіне тән кеңейтімдер.

editable

Нысанға мазмұнды өңдеу рұқсаты бар пайдаланушылар үшін қарастырылып отырған Dynamics 365 порталдарының CMS нысанын Мазмұнды жариялау үшін алдыңғы жақтан өңдеу механизмін пайдалану ретінде көрсетеді. Өңделетін нысандарға бет, бөліктер және веб-сілтемелер кіреді.

{% editable page 'adx_copy' type: 'html', title: 'Page Copy', escape: false, liquid: true %}

{% editable snippets "Header" type: 'html' %}

<!--

An editable web link set required a specific DOM structure, with

certain classes on the containing element, as demonstrated here.

-->

{% assign primary_nav = weblinks["Primary Navigation"] %}

{% if primary_nav %}

<div {% if primary_nav.editable %}class="xrm-entity xrm-editable-adx_weblinkset"{% endif %}>

<ul>

<!-- Render weblinks... -->

</ul>

{% editable primary_nav %}

</div>

{% endif %}

Параметрлер

editable үшін қамтамасыз етілетін бірінші параметр — өңделетін нысан. Мысалы, бұл веб-сілтеме жинағы, бөліктер немесе ағымдағы бет болуы мүмкін. Қосымша екінші параметр — көрсетілетін және өңделетін нысандағы төлсипат атын немесе кілтін көрсету. Бұл нысан төлсипатының аты немесе бөлік аты болуы мүмкін.

Осы бастапқы параметрлерден кейін тегте қосымша атаулы параметрлер санына қолдау көрсетіледі.

class

Осы тег көрсететін түбірлік элементтің class төлсипатының мәнін көрсетеді.

default

Мәнсіз өңделетін элемент болып табылатын істе көрсетілетін әдепкі мән.

escape

Осы тег HTML кодталып көрсетілетін мәнді көрсететін логикалық мән. Мұның әдепкі мәні — false.

liquid

Осы тегпен көрсетілетін мәтіндік мәннен табылған Liquid үлгісін өңдеу мүмкіндігін көрсететін логикалық мән. Мұның әдепкі мәні — true.

tag

Осы тегпен көрсетілетін контейнер HTML тегтерінің аты. Бұл тег әдепкі бойынша div элементтерін көрсетеді. Негізінде, осы параметрдің мәнін div немесе span арасынан таңдау ұсынылады.

title

Мазмұн өңдеу интерфейсінен осы өңделетін элемент белгісін көрсетеді. Егер ешқайсысы берілмесе, таныс белгі автоматты түрде құрылады.

type

Көрсетілетін өңдеу интерфейсі түрін көрсететін жол мәні өңделетін мәтіндік мәндерге арналған. Осы параметрдің жарамды мәндері: html немесе text. html — әдепкі мән.

entitylist

Берілген нысан тізімін аты немесе ИД бойынша жүктейді. Содан кейін нысандар тізімінің сипаттарына тег блогында қолжетімді болатын entitylist арқылы қатынасуға болады. Нысандар тізімінің іс жүзіндегі нәтиже жазбаларын көрсету үшін блоктағы entityview тегін пайдаланыңыз.

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

{% entitylist name:"My Entity List" %}

Loaded entity list {{ entitylist.adx_name }}.

{% endentitylist %}

Әдепкі бойынша entitylist нысанына entitylist айнымалы атауы беріледі. Оған қоса, басқа айнымалы ат берілуі мүмкін.

{% entitylist my_list = name:"My Entity List" %}

Loaded entity list {{ my_list.adx_name }}.

{% endentitylist %}

Параметрлер

Жүктелетін нысандар тізімін таңдау үшін id, name немесе key параметрлерінің тек біреуін көрсетіңіз.

id

Нысандар тізімін GUID идентификаторы бойынша жүктейді. id GUID ретінде талдауға болатын жол болуы керек.

{% entitylist id:"936DA01F-9ABD-4d9d-80C7-02AF85C822A8" %}

Loaded entity list {{ entitylist.adx_name }}.

{% endentitylist %}

Негізінде, литерал GUID жолдары пайдаланылмайды. Оның орнына, id басқа айнымалының GUID сипаты арқылы көрсетіледі.

{% entitylist id:page.adx_entitylist.id %}

Loaded entity list {{ entitylist.adx_name }}.

{% endentitylist %}

name

Нысан тізімін аты бойынша жүктейді.

{% entitylist name:"My Entity List" %}

Loaded entity list {{ entitylist.adx_name }}.

{% endentitylist %}

key

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

<!-- key_variable can hold an ID or name -->

{% entitylist key:key_variable %}

Loaded entity list {{ entitylist.adx_name }}.

{% endentitylist %}

language_code

Жүктелетін нысандар тізімінің локализацияланған белгілерін таңдауға арналған Dynamics 365 бүтін тіл коды. Тіл_коды көрсетілмеген болса, портал қолданбасының Dynamics 365 байланысының әдепкі тілі пайдаланылады.

{% entitylist name:"My Entity List", language_code:1033 %}

Loaded entity list {{ entitylist.adx_name }}.

{% endentitylist %}

entityview

Көрсетілген Dynamics 365 көрінісін атау немесе идентификатор бойынша жүктейді. Көрініс сипаттары ߝ көрініс бағаны метадеректері, беттелген нәтиже жазбалары, т.б. кейін тег блогында қолжетімді entityview арқылы қол жеткізуге болады.

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

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Әдепкі бойынша entityview нысанына entityview айнымалы атауы беріледі. Оған қоса, басқа айнымалы ат берілуі мүмкін.

{% entityview my_view = logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ my_view.total_records }} total records.

{% endentityview %}

Егер entityview тегі entitylist блогына кірістірілсе, ол өзінің әдепкі конфигурациясын (нәтиже бетінің өлшемі, сүзгі опциялары, т.б.) нысандар тізімінен иеленеді. entityview тегі үшін көрініс идентификаторы немесе атау параметрлері көрсетілмеген болса, ол әдепкі көрінісін қамтитын entitylist ішінен жүктейді.

{% entitylist id:page.adx_entitylist.id %}

{% entityview %}

Loaded default view of the entity list associated with the current page, with {{ entityview.total_records }} total records.

{% endentityview %}

{% endentitylist %}

Параметрлер

id немесе атау бар logical_name параметрін жүктелетін Dynamics 365 көрінісін таңдау үшін көрсетіңіз. Егер ештеңе берілмесе және entityview тегі entitylist тегіне кірістірілсе, entitylist жабылуының әдепкі көрінісі жүктеледі.

id

id GUID ретінде талдауға болатын жол болуы керек.

{% entityview id:"936DA01F-9ABD-4d9d-80C7-02AF85C822A8" %}

Loaded entity view {{ entityview.name }}.

{% endentityview %}

Негізінде, литерал GUID жолдары пайдаланылмайды. Оның орнына, id басқа айнымалының GUID сипаты арқылы көрсетіледі.

{% entityview id:request.params.view %}

Loaded entity view {{ entityview.name }} using "view" query string request parameter.

{% endentityview %}

logical_name

Жүктелетін көріністің Dynamics 365 нысанының логикалық атауы. Атаумен бірге пайдаланылуы қажет.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

name

Жүктелетін көріністің Dynamics 365 атауы. logical_name параметрімен бірге пайдаланылуы қажет.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

filter

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

{% entityview id:request.params.view, filter:'user' %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Жиі пайдаланылатын жағдай — осы параметрді request негізінде орнату.

{% entityview id:request.params.view, filter:request.params.filter %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

metafilter

Көрініс нәтижелері сүзгіленетін нысан тізімі метадеректері сүзгісін көрсетеді. Бұл параметр нысандар тізімімен бірге entityview пайдаланылған кезде ғана жарамды. Жағдайлардың көпшілігінде бұл параметр request параметріне негізделеді.

{% entitylist id:page.adx_entitylist.id %}

{% entityview id:request.params.view, metafilter:request.params.mf %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

{% endentitylist %}

order

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

{% entityview id:request.params.view, order:'name ASC, createdon DESC' %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Жиі пайдаланылатын жағдай — осы параметрді request негізінде орнату.

{% entityview id:request.params.view, order:request.params.order %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

page

Жүктелетін көрініс нәтижесі бетін көрсетеді. Егер осы параметр көрсетілмесе, нәтижелердің бірінші беті жүктеледі.

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

{% entityview id:request.params.view, page:2 %}

Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Жиі пайдаланылатын жағдай — осы параметрді request негізінде орнату.

{% entityview id:request.params.view, page:request.params.page %}

Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.

{% endentityview %}

page_size

Ағымдағы нәтиже беті жүктелетін нәтижелер санын көрсетеді. Егер осы параметр үшін ешбір мән көрсетілмеген болса және entitylist блогында entityview пайдаланылса, нысандар тізімі бетінің өлшемі пайдаланылады. Егер entitylist блогында болмаса, 10 әдепкі мәні пайдаланылады.

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

{% entityview id:request.params.view, page_size:20 %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Жиі пайдаланылатын жағдай — осы параметрді request негізінде орнату.

{% entityview id:request.params.view, page_size:request.params.pagesize %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

search

Көрініс нәтижелері сүзгіленетін іздеу өрнегін көрсетеді. Қарапайым кілт сөз іздеу өрнектері кілт сөзбен басталатын төлсипаттарды сүзгілейді. Сонымен қатар, * арнайы таңбалары өрнекке қосылуы мүмкін.

{% entityview id:request.params.view, search:'John\*' %}

Loaded entity view with {{ entityview.total_records }} total matching records.

{% endentityview %}

Жиі пайдаланылатын жағдайы — іздеу сүзгісін пайдаланушының енгізгенінің негізінде орнату мүмкін болуы үшін осы параметрді request негізінде орнату.

{% entityview id:request.params.view, search:request.params.search %}

Loaded entity view with {{ entityview.total_records }} total matching records.

{% endentityview %}

enable_entity_permissions

Көрініс нәтижелерінде нысан рұқсаты сүзгілеуін қолдану мүмкіндігін көрсетеді. Бұл параметрдің әдепкі мәні — false. Егер entitylist блогында entityview пайдаланылса, осы параметрдің мәні нысандар тізімінің конфигурациясынан иеленіледі.

Бұл параметрге Liquid түрлері мәнін немесе логикалық мән («true», «false») ретінде талдауға болатын жолды беру керек. Егер осы параметр үшін мән көрсетілген болса, бірақ мәні бос мән болса немесе логикалық мән ретінде талданбаса, false әдепкі мәні пайдаланылады.

{% entityview id:request.params.view, enable_entity_permissions:true %}

Loaded entity view with {{ entityview.total_records }} total records to which the user has read permission.

{% endentityview %}

language_code

Жүктелетін нысан көрінісінің локализацияланған белгілерін (баған тақырыбы белгілері, т.б.) таңдауға арналған Dynamics 365 бүтін тіл коды. Тіл_коды көрсетілмеген болса, портал қолданбасының Dynamics 365 байланысының әдепкі тілі пайдаланылады.

entitylist блогының ішінде entityview пайдаланылса, entityview өзінің тіл коды конфигурациясын entitylist блогынан иеленеді.

{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}

Loaded entity view {{ entityview.name }}.

{% endentitylist %}

searchindex

Порталда іздеу индексі бойынша сұрау орындалады. Содан кейін сәйкес нәтижелерге тег блогында қолжетімді болатын searchindex арқылы қатынасуға болады.

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

Әдепкі бойынша іздеу индексі нысанына searchindex айнымалы атауы беріледі. Оған қоса, басқа айнымалы ат берілуі мүмкін.

{% searchindex liquid_search = query: 'support', page: params.page, page_size: 10 %}

{% if liquid_search.results.size > 0 %}

...

{% endif %}

{% endsearchindex %}

Параметрлер

searchindex тегі келесі параметрлерді қабылдайды.

query

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

{% searchindex query: 'support' %}

...

{% endsearchindex %}

Жиі пайдаланылатын жағдай — осы параметрді request негізінде орнату.

{% searchindex query: request.params.query %}

...

{% endsearchindex %}

Бұл параметрде Lucene сұрау талдау құралы синтаксисіне қолдау көрсетіледі.

filter

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

{% searchindex query: request.params.query, filter: '+statecode:0' %}

...

{% endsearchindex %}

Бұл параметрде Lucene сұрау талдау құралы синтаксисіне қолдау көрсетіледі.

Ескерім

filter және query арасындағы айырмашылық — екеуі де Lucene сұрау талдау құралы синтаксисін қабылдайды, query осы синтаксисті талдау жолына қатысты онша қатал болмауға арналған ߝ өйткені соңғы пайдаланушылардың көпшілігі осы синтаксис туралы білмейді деп күтіледі. Сол себепті, осы синтаксиске сәйкес query параметрін талдау сәтсіз болған жағдайда бүкіл сұрау өткізіп жіберіліп, сұрау мәтіні ретінде жіберіледі. Ал filter параметрі болса қатаң түрде талданады және жарамсыз синтаксис жағдайында қатені қайтарады.

logical_names

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

{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}

...
>
{% endsearchindex %}

page

Қайтарылатын іздеу нәтижесінің беті. Егер берілмесе, бірінші бет (1) қайтарылады.

{% searchindex query: request.params.query, page: 2 %}

...

{% endsearchindex %}

Жиі пайдаланылатын жағдай — осы параметрді request негізінде орнату.

{% searchindex query: request.params.query, page: request.params.page %}

...

{% endsearchindex %}

page_size

Қайтарылатын нәтиже бетінің өлшемі. Егер берілмесе, 10 әдепкі өлшемі пайдаланылады.

{% searchindex query: request.params.query, page_size: 20 %}

...

{% endsearchindex %}

provider

Пайдаланылатын теңшелген іздеу провайдерінің атын көрсетеді. Егер көрсетілмесе, әдепкі іздеу провайдері пайдаланылады.

Бірнеше іздеу провайдерінің болуы — көптеген орталарға қолданылмайтын кеңейтілген конфигурация. Негізінде, осы параметрді көрсету міндетті емес.

{% searchindex query: request.params.query, provider: 'AlternateIndex' %}

...

{% endsearchindex %}

entityform

Dynamics 365 конфигурациялаған Dynamics 365 порталында нысан пішіндерін және теңшелетін логиканы анықтау атау немесе идентификатор бойынша толығымен бейнелейді.

Ескерім

entityform тегі веб-үлгі негізіндегі бет үлгісінде көрсетілетін мазмұнда пайдалануға ғана қолжетімді. Қайта жазу негізіндегі бет үлгісінде тегті пайдалану ештеңе көрсетпейді. Әрбір бет үшін тек бір entityform немесе webform тегін көрсетуге болады. Біріншісінен кейінгі entityform немесе webform тегтері көрсетілмейді.

{% entityform name: 'My Entity Form' %}

Параметрлер

name

Жүктеу керек нысан пішінінің аты.

{% entityform name:"My Entity Form" %}

{% webform name:"My Web Form" %}

Жүктеу керек веб-пішінінің аты.

name

Параметрлер

webform

Dynamics 365 конфигурациялаған веб-пішінді атауы немесе идентификаторы бойынша толығымен көрсетеді. webform тегі веб-үлгі негізіндегі бет үлгісінде көрсетілетін мазмұнда пайдалануға ғана қолжетімді. Қайта жазу негізіндегі бет үлгісінде тегті пайдалану ештеңе көрсетпейді. Әрбір бет үшін тек бір entityform немесе webform тегін көрсетуге болады. Біріншісінен кейінгі entityform немесе webform тегтері көрсетілмейді.
{% webform name: 'My Web Form' %}

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

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