Поделиться через


Доступные объекты 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 по имени или идентификатору.

Если набор веб-ссылок существует, возвращается объект набора веб-ссылок. Если набор веб-ссылок с указанным именем или идентификатором не найден, возвращается значение 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