Споделяне чрез


Етикети на шаблон

Етикетите на шаблон управляват изхода на шаблон по различни начини и позволяват комбинация от няколко шаблона в единичен изход.

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