Етикети на шаблон
Етикетите на шаблон управляват изхода на шаблон по различни начини и позволяват комбинация от няколко шаблона в единичен изход.
Fetchxml
Позволява на потребителя да заявява данни от Microsoft Dataverse и да рендерира резултатите в страница.
Бележка
Можете да научите повече за заявяването на данните с помощта на fetchxml при използване FetchXML за заявка на данни.
{% fetchxml resultVariable %}
<!— Fetchxml query -->
...
{% endfetchxml %}
Когато използвате fetchxml за заявка за данни, уверете се, че не използвате самозатварящи се етикети. Например вместо <attribute name="title"/>
използвайте <attribute name="title"></attribute>
с изричен етикет за затваряне </attribute>
.
Атрибут на резултати
Атрибутът Results в предоставената променлива (като например "resultVariable" в предишната извадка) съдържа FetchXML резултати от заявка и няколко други атрибута.
Обекти
Този атрибут съдържа резултата от заявка за fetchxml. Можете да повторите резултата и да го използвате в уеб шаблона.
<table> {% for entityVariable in resultVariable.results.entities %} <tr> <td>Attribut-1: {{ entityVariable.attribute1 }}</td> <td>Attribut-2: {{ entityVariable.attribute2 }}</td> </tr> {% endfor %} </table>
Име на таблица
Получава логическото име на обекта.
РазширениеДанни
Получава структурата, която съдържа допълнителни данни.
MinActiveRowVersion
Получава най-ниската стойност на версията на активния ред.
ОщеРекорди
Показва дали има още налични записи.
PagingCookie
Получава текущата информация за страниране.
Общият брой на записите
Получава общия брой на записите в колекцията.
ReturnTotalRecordCount е вярно в момента на изпълнение на заявката.TotalRecordCountLimitExceeded
Показва дали резултатите от заявката надвишават общия брой записи.
XML атрибут
XML атрибутът в предоставената променлива (като 'resultVariable' в предишната извадка) съдържа резултантната заявка, която може да се използва за получаване на данни от Microsoft Dataverse. Този атрибут е полезен за отстраняване на грешки, когато искате да разберете как се прилага разрешение за таблица в този етикет fetchxml.
Други поддържани елементи и атрибути
Течният етикет Fetchxml поддържа следните атрибути и дъщерни елементи.
Елемент/дъщерен елемент | Атрибути | Дъщерен елемент |
---|---|---|
извличане | mapping version count page paging-cookie utc-offset aggregate distinct min-active-row-version output-format returntotalrecordcount no-lock |
order обект |
ред | атрибут alias низходящ ред |
|
обект | name all-attributes no-attrs атрибут |
order filter link-entity |
филтър | type hint isquickfindfields |
condition филтър |
link-entity | name from to alias link-type visible intersect all-attributes no-attrs атрибут |
order filter link-entity |
условие | column entityname атрибут operator aggregate alias uiname uitype uihidden стойност |
стойност |
include
Включва съдържанието на един шаблон в друг по име. Източникът Power Pages на този друг шаблон обикновено е уеб шаблон. Този оператор позволява повторната употреба на фрагменти от общ шаблон на няколко места.
Когато даден шаблон е включен в друг, включеният шаблон има достъп до всички променливи, дефинирани в родителския шаблон.
{% include 'My Template' %}
Възможно е също да се подаде какъвто и да е брой именувани параметри към етикета за включване. Тези параметри са дефинирани като променливи в включения шаблон.
{% include 'My Template' a:x, b:y %}
блок
Използва се с block, за да предостави наследство на шаблон. Вижте „разширява” за употребата.
разширява
При употреба с етикета block предоставя наследство на шаблон. Този оператор позволява множество шаблони да използват споделено оформление, докато игнорират определени области в родителското оформление.
В Power Pages името на родителския шаблон, предоставено на етикета, обикновено се отнася до името на уеб шаблон.
Когато се използва „разширява”, то трябва да бъде първото съдържание в шаблона и може да бъде следвано само от един или повече етикети „блок”.
Ако блок, дефиниран в родителския шаблон, не е заместен, съдържанието му в родителския шаблон (ако има такъв) се изобразява.
коментар
Позволява ви да оставите нерендиран код в шаблон на Liquid. Всяко съдържание в блока не се изобразява и всеки Liquid код в него не се изпълнява.
Код
Hello{% comment %}, {{ user.fullname }}{% endcomment %}. My name is Charles.
Изход
Hello. My name is Charles.
суров
Тази функция ви позволява да показвате Liquid код на страница, без да го анализирате или изпълнявате.
Изход
Hello, {{ user.fullname }}. My name is Charles.
заместване
Когато активирате кеширането на горния и долния колонтитул и искате да избегнете кеширането на изхода на определени секции, можете да използвате този етикет. Този маркер предоставя блока на съдържанието в заглавието или долния колонтитул, където изходът на опакованото съдържание не се кешира. Този оператор е полезен в сценариите, в които потребителят използва обект, който често може да се актуализира, като заявка, страница, език и дата. Например, вижте сценариите за актуализиране на изходния код на уеб шаблона и долния колонтитул, когато кеширането на заглавки и долни колонтитули е активирано.
Съвет
URL адресът, използван в request.url, може да бъде всяка поискана стойност и се кешира за последващи искания. За да осигурите правилната стойност в request.url, помислете за използването на заместващ маркер, частичен URL адрес като ~{Път към WebFile} или съхраняване на URL адреса на портала в Настройки на сайта.
codecomponent
Вижте Разберете компонента на кода етикет на обекта на Dataverse, Използвайте кодови компоненти. Етикет за шаблон на Liquid.
Вижте също
Контролни маркери за потока
Итерационни тагове
Променливи тагове
Dataverse Течни етикети
Използване на компоненти на кода Етикет за шаблон Liquid