Доступные объекты Liquid

Объекты Liquid содержат атрибуты для вывода динамического содержимого на страницу. Например, объект page имеет атрибут с именем title, который можно использовать для вывода заголовка текущей страницы.

Чтобы получить доступ с атрибуту объекта по имени, используйте точку (.). Для отображения атрибута объекта в шаблоне заключите его в {{ and }}.

Внимание

Чтобы избежать потенциальных проблем с использованием сценариев между сайтов (XSS), всегда используйте escape-фильтр, чтобы кодировать HTML-данные всякий раз, когда используются объекты Liquid для чтения ненадежных данных, предоставленных пользователем.

{{ page.title }}

Доступ к атрибутам объекта также можно получить с использованием имени строки []. Этот формат удобен в случаях, когда необходимый атрибут определяется динамически или имя атрибута содержит символы , пробелы, специальные символы и т. д,, недопустимые при использовании синтаксиса точки (.) в синтаксисе.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Следующие объекты могут использоваться и доступны в любом месте, в любом шаблоне.

Object	Описание:
Объекты	Позволяет загрузить любую таблица Microsoft Dataverse по идентификатору. Дополнительные сведения: сущности.
сейчас	Объект даты и времени, который указывает текущее время UTC во время обработки шаблона для отображения. Примечание. Это значение кэшируется веб-приложением портала и не обновляется каждый раз. Больше информации: Фильтры по дате
page	Указывает на текущую страницу запроса портала. Объект page предоставляет доступ к таким вещам, как навигационные цепочки для текущей страницы, заголовок или URL-адрес текущей страницы и все другие атрибуты или связанные сущности основной записи Dataverse. Дополнительная информация: страница
Параметры	Удобное сокращение для request.params. Дополнительные сведения: запрос
запрос	Содержит сведения о текущем HTTP-запросе. Дополнительные сведения: запрос
параметры	Позволяет загружать любые параметры сайта по имени. Дополнительные сведения: параметры
карта сайта	Предоставляет доступ к карте сайта портала. Дополнительные сведения: карта сайта
sitemarkers	Позволяет загружать любые маркеры сайта по имени. Дополнительные сведения: маркеры сайта
snippets	Позволяет загружать любые фрагменты кода содержимого по имени. Дополнительные сведения: фрагменты
Пользователь	Указывает на текущего пользователя портала, обеспечивая доступ ко всем атрибутам базовой записи контакта Dataverse. Если нет пользователя, выполнившего вход, эта переменная будет иметь значение null. Дополнительные сведения: пользователь
weblinks	Позволяет загрузить любой набор веб-ссылок по имени или идентификатору. Дополнительные сведения: веб-ссылки
website	Указывает на запись веб-сайта портала, обеспечивая доступ ко всем атрибутам записи веб-сайта Dataverse (adx_website) для портала. Дополнительные сведения: веб-сайт

ads

Предоставляет возможность получить доступ к рекламному объявлению и обработать его для отображения.

Объект 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>

Атрибуты рекламных объявлений

Атрибут	Описание:
placements	Возвращает объект adplacements.
[имя или идентификатор рекламного объявления]	Можно получить доступ к любому рекламному объявлению по его свойствам "Имя" или "Идентификатор". {% assign ad = ads[Ad Name] %} {% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Атрибуты размещений рекламных объявлений

Атрибут	Описание:
[имя или идентификатор размещения рекламного объявления]	Можно получить доступ к любому объекту adplacement по его свойствам "Имя" или "Идентификатор". {% assign placement = ads.placements[Placement Name or Id] %} {% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Атрибуты размещения рекламных объявлений

Место размещения рекламных объявлений — это табличный объект с такими же общими атрибутами и атрибутами, перечисленными ниже.

Атрибут	Описание
Рекламные объявления	Возвращает коллекцию связанных объектов рекламных объявлений с размещением. С этой коллекцией можно использовать теги итерирования и фильтры массива.
Полное имя	Возвращает поле имени для размещения рекламных объявлений.
placement_url	URL-адрес, который может использоваться для извлечения размещения рекламного объявления, полностью отображаемого шаблоном.
random_url	URL-адрес, который может использоваться для извлечения случайного рекламного объявления из размещения, полностью отображаемого шаблоном.

Атрибуты рекламного объявления

Заметка

Рекламное объявление — это объект таблицы, со всеми теми же атрибутами в дополнение к перечисленным ниже.

Атрибут	Описание:
ad_url	URL-адрес, который может использоваться для извлечения рекламного объявления, полностью отображаемого шаблоном.
Копировать	Возвращает поле копии для рекламного объявления.
image	Возвращает объект изображения (если имеется) для рекламного объявления.
Полное имя	Возвращает поле имени для рекламного объявления.
open_in_new_window	Возвращает значение true, если URL-адрес, указанный в redirect_url, должен открываться в новом окне.
redirect_url	URL-адрес, на который будет направлен пользователь при выборе объявления.

Атрибуты изображения рекламного объявления

Атрибут	Описание:
alternate_text	Возвращает текст, который должен появляться в атрибуте alt тега.
height	Возвращает высоту в пикселях для изображения
URL-адрес	Возвращает источник URL-адреса изображения.
width	Возвращает ширину в пикселях для изображения

блоги

Предоставляет возможность получить доступ и отображать блоги и записи блогов.

Объект 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 позволяет получить доступ к любому определенным блогу на портале или получить доступ ко всем записям блога на портале.

В следующей таблице поясняются атрибуты, связанные с объектом blogs.

Атрибут	Описание
posts	Возвращает объект blogposts, содержащий все записи блога на портале.
[имя или идентификатор блога]	Можно получить доступ к любому блогу по его свойствам "Имя" или "Идентификатор".

{% assign blog = blogs["Blog Name"] %}                             

{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}  |

Объект blog

Объект blog позволяет работать с одним блогом для получения доступа к записям для этого блога.

В следующей таблице поясняются различные атрибуты, связанные с объектом blog.

Атрибут	Описание
posts	Возвращает объект blogposts, содержащий все записи блога для блога.
Полное имя	Имя блога.
title	Заголовок блога.
URL-адрес	URL-адрес блога.

Объект blogposts

Объект 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-адрес записи.
контент	Возвращает поле содержимого для записи.
автор	Возвращает авторов для записи (представляет собой просто объект таблицы контакта.
название	Заголовок записи.
comment_count	Возвращает целое число, означающее количество комментариев для определенной записи.
publish_date	Дата публикации записи.

Объекты

Внимание

Чтобы избежать потенциальных проблем с межсайтовыми сценариями (XSS), всегда используйте фильтр escape в HTML, чтобы кодировать строковые данные при использовании объекта Liquid сущностей для чтения данных, предоставленных пользователем, которым нельзя доверять.

Заметка

Некоторые соглашения об именах Dataverse изменились, например, сущности Dataverse теперь называются таблицами. Изменения имени не применяются к объектам Liquid. Объект сущностей Liquid по-прежнему будет называться сущностями.

Позволяет загрузить любую таблица Dataverse по идентификатору. Если таблица существует, возвращается объект таблицы. Если таблица с указанным идентификатором не найдена, возвращается значение null.

{% 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 таблицы.
Примечания.	Загружает все примечания (annotation), связанные с таблицей, в порядке от более старых до более новых (createdon). Примечания возвращается как объекты примечания.
разрешения	Загружает результаты утверждения разрешения таблицы для таблицы. Результаты возвращаются как объект разрешений.
url-адрес	Возвращает путь URL-адреса системы управления содержимым порталов Power Pages для таблицы. Если таблица не имеет допустимого URL-адреса на текущем веб-сайте, возвращается значение NULL. Обычно возвращается только значение для определенных типов таблицы, которые были интегрированы в портал CMS, если только вы не настроили поставщика URL-адреса в вашем приложении.
[имя атрибута или отношения]	Можно получить доступ к любому атрибуту таблицы 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 для ссылочной таблицы.
Полное имя	Атрибут основного имени ссылочной таблицы.

Заметка

Примечание представляет собой объект таблицы, который предоставляет доступ к атрибутам и отношениям записи annotation. В дополнение ко всем атрибутам объекта таблицы, примечание имеет следующие дополнительные атрибуты.

Атрибут	Описание
documentbody	Загружает атрибут documentbody записи примечания annotation в виде строки с кодировкой Base64. Так как содержимое этого атрибута может быть большим, он не загружается с остальными атрибутами примечания, а загружается только по запросу. Примечание. Использование атрибута documentbody может иметь отрицательное влияние на производительность обработки шаблона, и его следует использовать с осторожностью. Вместо этого по возможности используйте атрибут url для предоставления ссылки на вложение примечания.
URL-адрес	Возвращает URL-путь для встроенного обработчика вложений примечаний портала. Если у пользователя есть разрешения и примечание содержит вложенный файл, запрос по этому URL-адресу приводит к загрузке вложенного файла примечания.

Заметка

Дополнительные фильтры

Значение набора параметров

Значения атрибута набора параметров/списка выбора возвращается как объекты ссылки связанной таблицы со следующими атрибутами.

Атрибут	Описание
Название	Локализованная надпись значения набора параметров или списка выбора. Например, "Активный"
Значение	Целое значение значения набора параметров или списка выбора. Например, 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

Объект entitylist используется внутри тегов таблицы Dataverse. Он предоставляет доступ ко всем атрибутам определенного списка.

Заметка

Обработка списка, связанного с текущей страницей

Атрибуты

Заметка

entities

Атрибут	Описание:
create_enabled	Возвращает значение true, если для списка настроено создание новых записей. В противном случае возвращает значение false.
create_url	Возвращает настроенный URL-путь для ссылки или кнопки создания для списка.
detail_enabled	Возвращает значение true, если для списка настроено представление сведений для отдельных записей. В противном случае возвращает значение false.
detail_id_parameter	Возвращает имя параметра строки запроса для использования идентификатора записи при создании URL-адреса представления сведений о записи. Сведения по использованию фильтров Liquid для создания URL-адресов см. в разделе Фильтры URL-адресов. Например, id
detail_label	Возвращает настроенную локализованную подпись для ссылок или кнопок представления сведений для списка.
detail_url	Возвращает настроенный URL-путь для ссылок или кнопок представления сведений для списка.
empty_list_text	Возвращает настроенный локализованный текст, который отображается, когда представление списка не возвращает никаких результатов.
enable_entity_permissions	Возвращает значение true, если включена фильтрация разрешения таблицы для данного списка. В противном случае возвращает значение false.
entity_logical_name	Возвращает логическое имя таблицы Dataverse для записей, которые будет отображаться этим списком. Например, 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	Возвращает код языка Dataverse в виде целого числа, который будет использоваться для выбора всех локализованных подписей для данного списка.
page_size	Возвращает настроенный размер страницы результатов для списка.
primary_key_name	Возвращает логическое имя атрибута первичного ключа для записей, которые будет отображаться этим списком.
search_enabled	Возвращает значение true, если включен поиск для данного списка. В противном случае возвращает значение false.
search_placeholder	Возвращает настроенный локализованный текст для местозаполнителя поля поиска списка.
search_tooltip	Возвращает настроенный локализованный текст для подсказки поиска списка.
просмотров	Возвращает доступные представления для списка в виде объектов представления списка.
[логическое имя атрибута]	Доступ к любому атрибуту записи Dataverse списка (adx_entitylist) можно получить по логическому имени, таким же образом, как к объекту таблица. Например: {{ 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 для столбца. Например, "Когда создано"
sort_ascending	Возвращает строку выражения сортировки для сортировки столбца в порядке возрастания. Например, createdon ASC
sort_descending	Возвращает строку выражения сортировки для сортировки столбца в порядке убывания. Например, createdon DESC
sort_disabled	Возвращает значение true, если сортировка отключена для столбца. В противном случае возвращает значение false.
sort_enabled	Возвращает значение true, если сортировка включена для столбца. В противном случае возвращает значение false.
width	Возвращает настроенную ширину столбца в пикселях.

entityview

Объект entityview используется в теге entityview и предоставляет доступ к метаданным для представления, в дополнение к записям результата представления.

Атрибуты

Атрибут	Описание
столбцы	Возвращает столбцы в представлении в виде объектов столбцов представления таблицы.
entity_permission_denied	Возвращает true, если в доступе к результатам представления было отказано из-за недостаточных разрешений таблицы для текущего пользователя. Возвращает false, если доступ на чтение результатов представления был предоставлен.
entity_logical_name	Логическое имя таблицы Dataverse записей результатов представления. Например, contact
first_page	Номер первой страницы результатов представления. Это будет 1, кроме случая, когда никакие результаты не возвращены, тогда это будет NULL.
Артикул	Идентификатор GUID представления Dataverse, который задает этот объект entityview.
language_code	Целый код языка Dataverse, используемого для загрузки локализованных меток для текущего представления.
последняя страница	Номер последней страницы результатов представления. Если нет возвращенных результатов, это будет NULL.
имя	Имя представления Dataverse, которое определяет данный объект entityview, например "Активные контакты".
next_page	Номер следующей страницы результатов представления. Если следующая страница результатов отсутствует, это будет NULL.
Страница	Номер текущей страницы результатов представления.
pages	Возвращает массив номеров страниц, содержащий все страницы результатов для текущего представления.
page_size	Количество результатов, возвращенных на каждой странице для текущего представления.
previous_page	Номер следующей страницы результатов представления. Если предыдущая страница результатов отсутствует, это будет NULL.
primary_key_logical_name	Логическое имя Dataverse основного ключевого атрибута таблицы результата для этого представления. Например, contactid.
записи	Текущая страница записей результатов для представления, как объекты таблиц.
sort_expression	Выражение сортировки по умолчанию для представления. Например, name ASC, createdon DESC.
total_pages	Общее число страниц результатов для представления.
total_records	Общее число результатов для представления (на всех страницах).

события

Предоставляет возможность получить доступ и обработать события. Объект events позволяет выбрать конкретное событие или все события.

Объект events

Объект events позволяет получить доступ к любому определенным событию на портале или получить доступ ко всем событиям на портале (независимо от события).

Объект events имеет следующие атрибуты:

Атрибут	Описание
occurences	Возвращает объект eventoccurances, содержащий все случаи событий на портале
[имя или идентификатор события]	Можно получить доступ к любому событию по его свойствам "Имя" или "Идентификатор". {% assign event = events["Event Name"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Объект event

Объект event позволяет работать с одним событием для получения доступа к расписаниям и случаям для этого события.

Объект event имеет следующие атрибуты:

Атрибут	Описание
повторений	Возвращает объект eventoccurances, содержащий все случаи для этого события.
имя	Имя события.
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

Содержит свойства, полезные в блоке цикла for.

Заметка

forloop может использоваться только в теге for.

Код

{% 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, если это не первая итерация цикла.
index	Расположение текущего элемента в коллекции, где первый элемент имеет расположение 1.
index0	Расположение текущего элемента в коллекции, где первый элемент имеет расположение 0.
Последняя	Возвращает true, если это последняя итерация цикла. Возвращает false, если это не последняя итерация цикла.
length	Возвращает число итераций для цикла ߝ число элементов в коллекции, по которой производится итерация.
rindex	Число элементов, оставшихся в цикле (длина - индекс), где 1 — это индекс последнего элемента.
rindex0	Число элементов, оставшихся в цикле (длина - индекс), где 0 — это индекс последнего элемента.

forums

Предоставляет возможность получить доступ и отображать форумы и дискуссии форумов. Возможность использовать Liquid для отображения данных форума расширяется на записи, но для создания новой записи или дискуссии необходимо использовать шаблон страницы многошаговых форм ASP.NET со встроенной указанной возможностью (например, шаблоны страниц дискуссии форума и записи форума по умолчанию).

Объект forums позволяет выбрать форум или дискуссии форума:

<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

Объект forums позволяет получить доступ к любому определенного форуму на портале или получить доступ ко всем дискуссиям форума на портале (независимо от форума).

Объект forum позволяет работать с одним форумом для получения доступа к дискуссиям для этого форума.

Объект forumthreads позволяет получить доступ к коллекции объектов forumthread. Можно упорядочивать дискуссии форума и достигать разбиения на страницы также с помощью фильтров Liquid.

{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}

Одна дискуссия форума

Объект forumposts позволяет получить доступ к коллекции объектов forumpost.

Атрибуты

Атрибут	Описание
threads	Возвращает объект forumthreads, содержащий все объекты forumthread на портале.
Все	Возвращает все объекты forum на портале. Обратите внимание, что website.forums также эквивалентен.
thread_count	Возвращает целое значение числа дискуссий, которые имеются на всем веб-сайте.
post_count	Возвращает общее количество записей на портале в виде целого значения.
[имя или идентификатор форума]	Можно получить доступ к любому форуму по его свойствам "Имя" или "Идентификатор". `{% 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

Атрибут	Описание:
автор	Возвращает автора для записи (представляет собой просто объект таблицы контакта).
контент	Содержимое записи.
is_answer	Является ли эта запись ответом для дискуссии?

знание

Предоставляет доступ к записям таблиц knowledgearticle и category Dataverse для отрисовки статей и категорий на портале.

Атрибуты

Атрибут	Описание
articles	Возвращает объект articles, содержащий объекты статей для записей таблиц knowledgearticle, доступных на портале.
categories	Возвращает объект categories, содержащий объекты категорий для записей таблицы категорий, доступных на портале.

объект articles

Объект articles позволяет получить доступ к коллекции объектов статей. Можно упорядочивать статьи и достигать разбиения на страницы также с помощью фильтров 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 %}

Атрибуты

Атрибут	Описание
популярные	Возвращает коллекцию объектов статей с самым большим числом просмотров. {% assign popular_articles = knowledge.articles.popular %}
последние	Возвращает коллекцию объектов статей с самой последней датой изменения. {% assign recent_articles = knowledge.articles.recent %}
популярное	Возвращает коллекцию объектов статей с наивысшей оценкой. {% 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 %}

Атрибут	Описание
популярные	Возвращает коллекцию объектов статей с самым большим числом просмотров. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
последние	Возвращает коллекцию объектов статей с самой последней датой изменения. {% assign recent_articles = knowledge.articles \| recent: 5 %}
популярное	Возвращает коллекцию объектов статей с наивысшей оценкой. {% 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 %}

Атрибуты

Атрибут	Описание
последние	Возвращает коллекцию объектов категорий с самой последней датой изменения.
top_level	Возвращает коллекцию объектов категорий, не имеющих родительскую категорию.

Фильтры

Следующие фильтры могут принимать дополнительный параметр, указывающий размер страницы. Размер страницы по умолчанию — 5. Фильтры могут быть объединены с другими фильтрами Liquid.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}

Атрибут	Описание
последние	Возвращает коллекцию объектов категорий с самой последней датой изменения. Можно указать параметры {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level	Возвращает коллекцию объектов категорий, не имеющих родительскую категорию. {% assign root_categories = knowledge.categories \| top_level %}

объект article

Объект article позволяет работать с одной сущностью knowledgearticle для отображения сведений этой статьи на портале.

Атрибуты

article — это объект entity со всеми теми же атрибутами в дополнение к перечисленным ниже.

Атрибут	Описание
article_public_number	Общий номер статьи.
comment_count	Целое число, означающее количество комментариев для определенной статьи.
content	Содержания статьи.
current_user_can_comment	Возвращает логическое значение, указывающее, может ли текущий пользователь добавлять комментарии в статье.
is_rating_enabled	Возвращает логическое значение, указывающее, включена ли оценка в статье.
ключевые слова	Ключевые слова в статье.
имя	Альтернативный псевдоним для заголовка статьи.
оценка	Десятичное значение оценки в статье.
title	Заголовок статьи.
view_count	Целое значение количества просмотров статьи.

объект category

Объект category позволяет работать с одной сущностью category для отображения ее сведений на портале.

Атрибуты

category — это объект entity со всеми теми же атрибутами в дополнение к перечисленным ниже.

Атрибут	Описание
categorynumber	Номер категории.
имя	Альтернативный псевдоним для заголовка категории.
заголовок	Заголовок категории.

язык

Предоставляет текущее имя языка и код языка, если включена поддержка нескольких языков.

Атрибуты

Атрибут	Описание
url	URL-адрес текущего запроса с префиксом текущего кода языка.
url_substitution	URL-адрес текущего запроса с префиксом текущего кода языка в обход кэша выходных данных страницы.
name	Название текущего языка.
code	Код языка.

Например, веб-шаблон Раскрывающийся список языков по умолчанию использует этот объект Liquid для вывода списка доступных языков, если доступно несколько языков.

страница

Указывает на текущую страницу запроса портала. Данный объект объединяет атрибуты sitemap и entities текущего запроса (обычно webpage).

Объект 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 }}. -->

Атрибуты страницы

Заметка

entities

Атрибут	Описание:
breadcrumbs	Возвращает объекты навигации узла карты сайта для страницы, начиная с корневого узла карты сайта и заканчивая на родительском узле.
children	Возвращает дочерние объекты узла карты сайта для страницы.
parent	Возвращает родительский узел карты сайта для страницы. Если страница является домашней, parent будет иметь значение NULL.
название	Заголовок страницы.
url-адрес	URL-адрес страницы.
[имя атрибута или отношения]	Можно получить доступ к любому атрибуту страницы базовой записи Dataverse по логическому имени. {{ page.createdon }} {% assign attribute_name = 'name' %} {{ page[attribute_name] }} Значения большинства атрибутов таблицы сопоставляются непосредственно с типами Liquid: поля типа "Два параметра" сопоставляются логическим значениям, текстовые поля сопоставляются строкам, числовые/валютные поля сопоставляются числам, поля даты и времени сопоставляются объектам даты. Однако некоторые типы атрибутов возвращается как объекты: Поля подстановки (ссылка на связанную таблицу) возвращаются как объекты ссылки на связанную таблицу. Поля набора параметров или списка выбора возвращаются как объекты значения набора параметров. Также можно загрузить все связанные сущности по имени схемы отношения. {{ page.adx_webpage_entitylist.adx_name }} В случае, если отношение рефлексивно (т. е., ссылается на себя), возвращается объект entities. (В противном случае результат будет неоднозначным.){{ page.adx_webpage_webpage.referencing.adx_name }} Примечание. Загрузка большого числа связанных сущностей или доступ к большому количеству отношений в одном шаблоне могут иметь отрицательное влияние на производительность обработки шаблона. Избегайте загрузку связанных сущностей для каждого элемента в массиве в цикле. По возможности старайтесь использовать теги таблиц Dataverse для загрузки коллекций сущностей.

polls

Предоставляет возможность получить доступ к опросу и обработать его для отображения.

Объект 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>

Атрибуты опросов

Атрибут	Описание:
placements	Возвращает объект pollplacements.
[имя или идентификатор опроса]	Можно получить доступ к любому опросу по его свойствам "Имя" или "Идентификатор". {% assign poll = polls[Poll Name] %} {% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Атрибуты размещений опросов

Атрибут	Описание:
[имя или идентификатор размещения опроса]	Можно получить доступ к любому размещению опросов по его свойствам "Имя" или "Идентификатор".{% assign placement = polls.placements[Placement Name or Id] %} {% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Атрибуты размещения опроса

Заметка

entities

Атрибут	Описание:
Полное имя	Возвращает поле имени для размещения опроса.
placement_url	URL-адрес, который может использоваться для извлечения размещения опроса, полностью отображаемого шаблоном.
polls	Возвращает коллекцию связанных объектов опроса с размещением. С этой коллекцией можно использовать теги итерирования и фильтры массива.
random_url	URL-адрес, который может использоваться для извлечения случайного опроса из размещения, полностью отображаемого шаблоном.
submit_url	URL-адрес, по которому отправляется заполненный опрос.

Атрибуты опроса

Заметка

entities

Атрибут	Описание:
has_user_voted	Возвращает значение true, если текущий пользователь (вошедший в систему или анонимный) уже голосовал в этом опросе.
Полное имя	Возвращает поле имени для опроса.
options	Возвращает коллекцию объектов параметров опроса, связанных с опросом. С этой коллекцией можно использовать теги итерации и сущности.
poll_url	URL-адрес, который может использоваться для извлечения опроса, полностью отображаемого шаблоном.
question	Возвращает поле "Вопрос" для опроса.
submit_button_label	Возвращает строку, которую можно использовать для переопределения подписи на кнопке отправки для опроса.
submit_url	URL-адрес, по которому отправляется заполненный опрос.
user_selected_option	Возвращает объект polloption, выбранный пользователем (если они уже голосовали).
votes	Возвращает число голосов, которые были включены в таблицу для опроса.

Атрибуты варианта в опросе

Заметка

entities

Атрибут	Описание:
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-фильтров.
• URL-адрес, используемый в request.url, может иметь любое запрошенное значение и становится кэширован для последующих запросов. Чтобы обеспечить правильное значение в request.url, рассмотрите возможность использования тега замены, частичный URL-адрес, такой как ~{WebFile path} или сохранения URL-адреса портала в Параметры сайта.
• Версия выпуска Power Pages 9.3.8.x или позднее по умолчанию будет принудительно применять фильтр Liquid escape для объектов Liquid user и request. Чтобы отключить эту конфигурацию по умолчанию и разрешить эти Liquid-объекты без Liquid-фильтра escape, см. параметры сайта портала — Site/EnableDefaultHtmlEncoding.

Атрибуты

Атрибут	Описание
Параметры	Именованные значения параметров для текущего запроса. params представляют собой сочетание параметров строки запроса URL-адреса, параметров формы записи и файлов cookie.
Path	Путь URL-адрес текущего запроса. /profile/
path_and_query	Путь и запрос URL-адреса текущего запроса. /profile/?foo=1&bar=something
query	Часть запроса 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.
Результаты	Возвращает страницу результата запроса в виде объектов результатов индекса поиска.

Результаты индекса поиска

Атрибут	Описание
Сущность	Базовый объект entities для результата.
fragment	Соответствующий короткий текстовый фрагмент для результата, с терминами, соответствующие указанному запросу, выделенными с помощью HTML-тега <em>. Некоторые типы запросов не поддерживают выделенные фрагменты, например нечеткие запросы (~) и запросы с подстановочными символами (*). В этих случаях данное свойство будет иметь значение NULL.
ИД	Идентификатор таблицы Dataverse базовой записи для результата, в виде строки. Например, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Логическое имя таблицы Dataverse базовой записи для результата. Например, adx_webpage
Номер	Номер результата, в рамках всех страниц результатов, начиная с 1. Например, для первого результата второй страницы результатов с размером страницы 10 это значение будет равно 11.
score	Балл Lucene результата, в виде значения с плавающей точкой. Результаты будут возвращены упорядоченными по этому значению.
title	Заголовок результата.
url-адрес	URL-адрес для результата. Обычно – но не обязательно – это будет абсолютный путь для текущего приложения, а не полный URL-адрес. Например: /articles/article1/

параметры

Позволяет загружать любые параметры сайта по имени. Если настройка с указанным именем не найдена, возвращается значение null.

Заметка

Настройки возвращаются как strings, но можно использовать Фильтры типов для преобразования их в другие типы.

{{ 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.
is_sitemap_current	Возвращает значение true, если узел карты сайта является текущим узлом; в противном случае возвращает значение false.
Родительский объект	Возвращает родительский узел карты сайта для узла. Если узел является корневым, parent будет иметь значение NULL.
Должность	Заголовок узла.
URL-адрес	URL-адрес узла.

sitemarkers

Позволяет загружать любые маркеры сайта по имени. Если маркер сайта существует, возвращается объект sitemarker. Если маркер сайта sitemarker с указанным именем не найден, возвращается значение null.

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

Заметка

Отображение заголовка веб-сайта и основной навигационной панели

Атрибуты Sitemarker

Атрибут	Описание:
url-адрес	URL-адрес цели маркера сайта.
[логическое имя атрибута]	Можно получить доступ к любому атрибуту записи Dataverse цели маркера сайта по логическому имени. Например: {{ sitemarker.adx_name }}

snippets

Позволяет загружать любые фрагменты кода содержимого по имени. Если фрагмент кода с указанным именем не найден, возвращается значение 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, если это не последняя итерация цикла.
Длина	Возвращает число итераций для цикла ߝ число элементов в коллекции, по которой производится итерация.
Rindex	Число элементов, оставшихся в цикле (длина - индекс), где 1 — это индекс последнего элемента.
rindex0	Число элементов, оставшихся в цикле (длина - индекс), где 0 — это индекс последнего элемента.

Пользователь

Указывает на текущего пользователя портала, обеспечивая доступ ко всем атрибутам базовой записи контакта Dataverse. Если нет пользователя, выполнившего вход, эта переменная будет иметь значение null.

пользователь является объектом entity.

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

Заметка

Версия выпуска Power Pages 9.3.8.x или позднее по умолчанию будет принудительно применять фильтр Liquid escape для объектов Liquid user и request. Чтобы отключить эту конфигурацию по умолчанию и разрешить эти Liquid-объекты без Liquid-фильтра escape, см. параметры сайта портала — Site/EnableDefaultHtmlEncoding.

Атрибуты

Помимо всех атрибутов объекта entity, user имеет следующие атрибуты.

Атрибут	Описание
roles	Возвращает роли, к которым пользователь принадлежит, в виде array. {% 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

weblinks

Позволяет загрузить любой объект weblinks по имени или идентификатору.

Если набор веб-ссылок существует, возвращается объект набора веб-ссылок. Если набор веб-ссылок с указанным именем или идентификатором не найден, возвращается значение null.

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

Заметка

Отображение заголовка веб-сайта и основной навигационной панели |

Атрибуты набора веб-ссылок

Заметка

Набор веб-ссылок — это объект entity со всеми теми же атрибутами в дополнение к перечисленным ниже.

Атрибут	Описание
Копировать	HTML-копия набора веб-ссылок.
Полное имя	Имя набора веб-ссылок.
Должность	Заголовок набора веб-ссылок.
Weblinks	Массив объектов веб-ссылок, связанный с набором веб-ссылок.
[логическое имя атрибута]	Можно получить доступ к любому атрибуту записи Dataverse набора веб-ссылок по логическому имени. Например: {{ weblinkset.createdon }}

Атрибуты веб-ссылки

Заметка

Веб-ссылка — это объект entity со всеми теми же атрибутами в дополнение к перечисленным ниже.

Атрибут	Описание:
Описание:	HTML-описание веб-ссылки.
display_image_only	Логический атрибут, указывающий, должна ли веб-ссылка отображаться только как изображение, без текста ссылки.
display_page_child_links	Логический атрибут, указывающий, должна ли веб-ссылка показывать ссылки на дочерние страницы sitemap связанной страницы в виде вложенных ссылок.
Изображение	Объект изображения веб-ссылки для этой ссылки. Этот атрибут будет иметь значение NULL, если изображение отсутствует.
is_external	Логический атрибут, указывающий, ведет ли целевой URL-адрес веб-ссылки на внешний сайт (а не на внутреннюю страницу портала).
is_sitemap_ancestor	Возвращает значение true, если URL-адрес веб-ссылки ссылается на предка текущего узла карты сайта; в противном случае возвращает значение false.
is_sitemap_current	Возвращает значение true, если URL-адрес веб-ссылки ссылается на текущий узел карты сайта; в противном случае возвращает значение false.
Полное имя	Имя/заголовок веб-ссылки.
Nofollow	Логический атрибут, указывающий, должна ли веб-ссылка быть отмечена как rel=nofollow.
open_in_new_window	Логический атрибут, указывающий, должна ли веб-ссылка при выборе открываться в новом окне или вкладке браузера.
Подсказка	Текст подсказки для веб-ссылки.
URL-адрес	URL-адрес веб-ссылки.
Weblinks	Массив дочерних объектов веб-ссылки, связанный с веб-ссылкой.
[логическое имя атрибута]	Можно получить доступ к любому атрибуту записи Dataverse веб-ссылки по логическому имени. Например: {{ weblink.createdon }}

Атрибуты изображения веб-ссылки

alternate_text	Альтернативный текст для изображения.
Height	Целое число, содержащее указанную высоту изображения. Если значение высоты не указано, этот атрибут имеет значение NULL.
URL-адрес	URL-адрес изображения.
Ширина	Целое число, содержащее указанную ширину изображения. Если значение ширины не указано, этот атрибут имеет значение NULL.

website

Указывает на веб-сайт портала, обеспечивая доступ ко всем атрибутам записи веб-сайта Dataverse (adx_website) для портала.

Заметка

Веб-сайт — это объект entity, со всеми теми же атрибутами.

Код

{{ 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_substitution: /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