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


Налични обекти на Liquid

Бележка

В сила от 12 октомври 2022 г. „Портали на Power Apps“ става Power Pages. Повече информация: Microsoft Power Pages вече е общодостъпен (блог)
Скоро ще мигрираме и ще обединим документацията на „Портали на Power Apps“ с документацията на Power Pages.

Обектите на Liquid съдържат атрибути за извеждане на динамично съдържание на страницата. Например обектът „Страница” има атрибут, наречен „заглавие”, който може да се използва за извеждане на заглавието на текущата страница.

За достъп до атрибут на обект по име използвайте точка (.). За да рендирате атрибут на обект в шаблон, го оградете в {{ and }}.

Важно

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

{{ page.title }}

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

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Следните обекти могат да бъдат използвани и да се получи достъп до тях навсякъде и във всеки шаблон.

Обект Описание
обекти Позволява ви да заредите всяка таблица на Power Apps по ИД. Допълнителна информация: обекти
сега Обект за дата/час, който препраща към текущия UTC час в момента на рендиране на шаблона.
Забележка: Тази стойност се кешира от уеб приложението на портала и не се обновява всеки път. Допълнителна информация: Филтри за дата
страница Отнася се за текущата страница за заявка в портала. Обектът „Страница” предоставя достъп до неща, като йерархични връзки за текущата страница, заглавието или URL адреса на текущата страница, както и всякакви други атрибути или свързани обекти на подлежащия запис на Power Apps. Допълнителна информация: страница
параметри Удобен пряк път за request.params. Допълнителна информация: заявка
заявка Съдържа информация относно текущата HTTP заявка. Допълнителна информация: заявка
настройки Позволява ви да заредите всяка настройка на сайта по име. Допълнителна информация: настройки
sitemap Позволява достъп до картата на сайта на портала. Допълнителна информация: карта на сайта
маркери на сайт Позволява ви да заредите всякакви маркери на сайт по име. Допълнителна информация: маркери на сайта
фрагменти Позволява ви да заредите всеки фрагмент от съдържание по име. Допълнителна информация: фрагменти
потребител Отнася се за текущия потребител на портала, което позволява достъп до всички атрибути на подлежащия запис на контакт в Power Apps. Ако няма влязъл потребител, тази стойност ще бъде нула. Допълнителна информация: потребител
уеб връзки Позволява ви да заредите всякакъв набор от уеб връзки по име или ИД. Допълнителна информация: уеб връзки
уеб сайт Отнася се за записа на уеб сайта на портала, което позволява достъп до всички атрибути на записа Power Apps Уеб сайт (adx_website) за портала. Допълнителна информация: уеб сайт

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>

Атрибути за реклама

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

Атрибути на разполаганията на реклама

Атрибут Описание
[име или ИД на разполагане на реклама] Можете да получите достъп до всяко разполагане на реклама чрез свойствата за неговото име или ИД.
{% 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 адресът, който може да се използва за извличане на рекламата, изцяло рендирана от шаблон.
Копиране Връща полето „Копиране“ за рекламата.
изображение Връща обекта на изображението (ако има такива) за рекламата.
Име Връща полето „Име“ за рекламата.
open_in_new_window Връща „true“, ако URL адресът от redirect_url трябва да се отвори в нов прозорец.
redirect_url URL адресът, към който ще бъде пренасочен потребителят при избиране на рекламата.

Атрибути за изображение на рекламата

Атрибут Описание
alternate_text Връща текста, който е предназначен да се появи в алтернативния атрибут на етикета.
height Връща височината на изображението в пиксели
URL адрес Връща източника на URL адрес за изображението.
width Връща ширината на изображението в пиксели

блогове

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

Обектът „Блогове” ви позволява да изберете конкретни блог или публикации в блог.

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

обект на блогове

Обектът на блогове ви дава достъп до всеки конкретен блог в портала или до всички публикации в блог в портала.

Таблицата по-долу описва атрибутите, свързани с обекта на блогове.

Атрибут Описание
публикации Връща обект blogposts, съдържащ всички публикации в блог в портала.
[име или ИД на блог] Можете да получите достъп до всеки блог чрез свойствата за неговото име или ИД.
{% assign blog = blogs["Blog Name"] %}                             

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

обект на блог

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

Таблицата по-долу описва различни атрибути, свързани с обекта на блог.

Атрибут Описание
публикации Връща обект на блог, съдържащ всички публикации в блог за блога.
Име Името на блога.
title Заглавието на блога.
URL адрес URL адресът на блога.

обект на публикации в блог

Обектът за публикации в блог ви позволява достъп до колекция от обекти за публикации в блог. Можете да подредите публикациите в блог и да постигне страниране, както и да използвате филтри на Liquid:

{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}

Други възможни опции:

  • blogs.posts.all (за да получите всички публикации в блога)
  • blogs.posts | from\_index: 0 | take: 2

Таблицата по-долу описва различни атрибути, свързани с обекта на публикации в блог.

Атрибут Описание
Всички Връща всички обекти на публикации в блог в колекцията

обект на публикация в блог

Отнася се за единична публикация в блог.

Таблицата по-долу описва различни атрибути, свързани с обекта на публикация в блог.

Атрибут Описание
URL адрес URL адресът на публикацията.
съдържание Връща полето със съдържание за публикацията.
автор Връща авторите за публикацията (които са просто обект за таблица на контакт).
заглавие Заглавието на публикацията.
comment_count Връща целочислената стойност на броя, който показва колко коментара има за дадена публикация.
publish_date Датата, на която е публикувана публикацията.

обекти

Внимание

За да избегнете потенциални проблеми със скриптове между сайтове (XSS), винаги използвайте филтър за превключване в шифроването на HTML данни на низ, когато използвате обекти на Liquid за четене на данни, предоставени от потребител, който не е доверен.

Бележка

Някои от конвенциите за именуване на Dataverse са се променили, напр. Dataverse обекти сега се наричат таблици. Промените в името не се отнасят за обекти Liquid. Обектът Liquid entities ще продължи да се нарича обекти.

Позволява ви да заредите всяка таблица на Power Apps по ИД. Ако таблицата съществува, ще бъде върнат обект на таблица. Ако няма таблица с дадения ИД, ще се върне нула.

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

Обектът на обект предоставя достъп до атрибутите на запис на таблица на Power Apps.

Атрибут Описание
ID ИД на GUID на таблицата като низ. Например 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Логическото име на Power Apps на таблицата.
Бележки Зарежда всички бележки (анотация), свързани с таблицата, подредени от най-стара до най-нова (createdon). Бележките се връщат като обекти на бележки.
разрешения Зарежда резултати от потвърждение на разрешение за таблица за таблицата. Резултатите се извеждат като обект на разрешения.
URL адрес Връща път на URL адрес за системата за управление на съдържанието на портали на Power Apps за таблицата. Ако таблицата няма валиден URL адрес в текущия уеб сайт, връща null. В общия случай това ще върне само стойност за определени типове таблици, които са били интегрирани в CMS на портала , освен ако не сте персонализирали доставчика на URL адрес в приложението си.
[име на атрибут или релация] Можете да отворите всеки атрибут на таблица на Power Apps чрез логическо име. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
Стойностите на повечето атрибути на таблица се нанасят директно върху Типове на Liquid: Полетата с две опции се нанасят до булев израз, текстовите полета до низове, числовите/валутни полетата до числа, полетата за дата/час до обекти на дата. Някои типове атрибути обаче се връщат като обекти:
  • Полетата за справка (препратка към свързана таблица) се връщат като обекти за препратка към свързана таблица.
  • Полетата за набор от опции/списък по избор се връщат като обекти със стойност за задаване на опция.
  • Можете също да заредите всички свързани обекти по име на схема на отношение.
  • {{ page.adx_webpage_entitylist.adx_name }}В случай че връзката е рефлексивна (т.е. самоотносима), ще бъде върнат обект на рефлексивно отношение. (В противен случай, желаният резултат ще бъде неясен.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Забележка: Зареждането на голям брой свързани обекти или достъпът до голям брой отношения в един единствен шаблон могат да имат отрицателно въздействие върху характеристиките на рендиране на шаблона. Избягвайте зареждане на свързаните обекти за всеки елемент в масив в рамките на един цикъл. Когато е възможно, използвайте етикети на таблица на Dataverse, за да заредите колекции от обекти.

Препратка към асоциирана таблица

Стойностите на атрибутите за търсене се връщат като обекти за препратка към свързана таблица със следните атрибути.

Атрибут Описание
ID ИД на GUID на таблицата с препратка като низ.
Например 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Логическото име на таблицата с препратка в Power Apps.
Име Основното име на атрибута на таблицата с препратка.

Забележка

Бележката представлява обект на таблица, който предоставя достъп до атрибути и отношения на запис на анотация. В допълнение към всички атрибути на обект на таблица бележката има следните допълнителни атрибути.

Атрибут Описание
documentbody Зарежда атрибута documentbody на записа на анотацията на бележката във формата на кодиран чрез Base64 низ. Тъй като съдържанието на този атрибут може да е голямо, то не се зарежда с останалата част от атрибутите на бележката, а се зарежда само при поискване.
Забележка: Използването на атрибут documentbody може да има отрицателно влияние върху характеристиките на рендиране на шаблона и трябва да се прави внимателно.
Използвайте атрибута URL адрес, за да предоставите връзка към прикачения файл на бележката, ако е възможно.
URL адрес Връща път на URL адрес за манипулатора за прикачен файл на анотация на вградения портал. Ако потребителят има разрешение и бележката има прикачен файл, заявката към този URL адрес ще изтегли прикачения към бележката файл.

Стойност на набора от опции

Стойностите на атрибута за набор от опции/списък по избор се връщат като обекти за препратка към свързана таблица с атрибутите по-долу.

Атрибут Описание
Етикет Локализираният етикет на стойността на атрибута на набор от опции/списък по избор. Например „активен”
Стойност Целочислената стойност на стойността на атрибута на набор от опции/списък по избор. Например 0

Разрешения за таблица

Обектът на разрешения за таблица предоставя достъп до резултат за потвърждение на обобщено разрешение за дадена таблица.

Атрибут Описание
can_append Връща „true”, ако текущият потребител има разрешение за добавяне на записи към отношения на този запис. В противен случай връща „false”.
can_append_to Връща „вярно”, ако текущият потребител има разрешение за добавяне на този запис към отношения на друга таблица. В противен случай връща „false”.
can_create Връща „вярно”, ако текущият потребител има разрешение за създаване на нов запис за този тип таблица. В противен случай връща „false”.
can_delete Връща „true”, ако текущият потребител има разрешение да изтрие този запис. В противен случай връща „false”.
can_read Връща „true”, ако текущият потребител има разрешение да прочете този запис. В противен случай връща „false”.
can_write Връща „true”, ако текущият потребител има разрешение да актуализира този запис. В противен случай връща „false”.
rules_exist Връща „true”, ако резултатите от разрешение, представени от този обект са резултат от изрично определени правила за разрешение. Връща „true”, ако те са резултатите по подразбиране при липса на изрично определени разрешения.

Рефлексивно отношение

Опитите да се заредят рефлексивни (т.е. самоотносими) взаимоотношения на обекти се връщат като обекти с атрибутите по-долу.

Атрибут Описание
is_reflexive Връща „true”. Може да се използва, за да проверите дали даден обект, върнат от отношение, е обект на рефлексивно отношение.
посочени Връща масив от обекти с препратка за даденото отношение.
препращащи Връща таблица с препратка за дадената релация. Връща null, ако не съществува таблица с препратка. Ако релацията е много-към-много (N:N), връща масив от препращащи обекти.

entitylist

Обектът на списък с обекти се използва в рамките на етикетите на таблица на Power Apps Dataverse. Той осигурява достъп до всички атрибути от даден списък.

Атрибути

Бележка

обекти

Атрибут Описание
create_enabled Връща „вярно”, ако е конфигурирано създаването на нови записи за списъка. В противен случай връща „false”.
create_url Извежда конфигурирания път до URL адреса за връзка/бутон за създаване за списъка.
detail_enabled Връща „вярно”, ако е конфигуриран подробен изглед за отделни записи за списъка. В противен случай връща „false”.
detail_id_parameter Извежда името на параметър на низа за заявката, който да се използва за ИД на записа при конструиране на URL адрес за подробен изглед на запис. Вижте Филтри за URL адреси за подробности за използването на филтри на Liquid за изграждане на URL адреси. Например ИД
detail_label Извежда конфигурирания локализиран етикет за връзки/бутони за подробен изглед за списъка.
detail_url Извежда конфигурирания път до URL адреса за връзки/бутони за подробен изглед за списъка.
empty_list_text Извежда конфигуриран локализиран текст, който да се показва, когато изгледът на списъка не извежда никакви резултати.
enable_entity_permissions Връща „вярно”, ако е активирано филтрирането по разрешение за таблица за този списък. В противен случай връща „false”.
entity_logical_name Връща логическото име на таблицата на Power Apps за записи, което да се показва от този списък. Пример, контакт
filter_account_attribute_name Връща логическото име на атрибут за справката за акаунт, което ще се използва за филтриране на записите на резултат по родителския акаунт на текущия потребител на портала. Например accountid
filter_apply_label Извежда конфигуриран локализиран етикет, който да се използва за връзката/бутона, които прилагат разширен филтър за атрибути към резултатите в списъка.
filter_definition Извежда дефиницията за филтъра за JSON атрибута за списъка. Вижте Филтри за списък за подробности за това как да използвате филтър от метафилтри на Liquid за обработване на тази дефиниция.
filter_enabled Връща „вярно”, ако е активирано разширено филтриране по атрибути за списъка. В противен случай връща „false”.
filter_portal_user_attribute_name Връща логическото име на атрибут за справката за контакт, което ще се използва за филтриране на записите на резултат по контакта на текущия потребител на портала. Например contactid
filter_website_attribute_name Извежда логическото име на атрибут за справката за adx_website, което ще се използва за филтриране на записите на резултат по текущия уеб сайт на портала. Например adx_websiteid
language_code Връща целочисления код за език на Power Apps, който ще се използва за избиране на всички локализирани етикети за списъка.
page_size Извежда конфигурирания размер на страницата с резултати за списъка.
primary_key_name Извежда логическото име на атрибута за първичен ключ, което да се показва от този списък.
search_enabled Връща „вярно”, ако е активирано търсене за този списък. В противен случай връща „false”.
search_placeholder Извежда конфигурирания локализиран текст за контейнера на полето за търсене в списъка.
search_tooltip Извежда конфигурирания локализиран текст за пояснението за търсене в списъка.
изгледи Извежда наличните изгледи за списъка като обекти на изгледи на списъка.
[логическо име на атрибут] Можете да отворите всеки атрибут на списъка на запис на (adx_entitylist) Power Apps по логическо име по същия начин като обекта таблица. Например {{ entitylist.adx_name }}

Атрибути на изгледи на списъци

Атрибут Описание
колони Извежда колоните на изгледа като обектите на колона в изглед на списък.
entity_logical_name Връща логическото име на таблицата на Power Apps за записите, включени в изгледа. Пример, контакт
ID Извежда GUID ID на изгледа.
language_code Връща целочисления код за език на Power Apps, който ще се използва за избиране на всички локализирани етикети (заглавни редове на колони и др.) за изгледа.
Име Връща показваното име в Power Apps на изгледа.
primary_key_logical_name Връща логическото име на първичния ключ на таблицата на Power Apps за записите, включени в изгледа. Например contactid
sort_expression Извежда израза за сортиране по подразбиране за изгледа. Например name ASC, createdon DESC.

Атрибути на колони в изглед на списък

Атрибут Описание
attribute_type Връща името на типа на Power Apps атрибута за колоната като низ. Например справка, списък по избор, низ, булева стойност, DateTime
logical_name Връща логическото име на Power Apps атрибута за колоната. Например createdon
Име Връща локализираното показвано име в Power Apps за колоната. Например „Създаден на”
sort_ascending Извежда низ за израз за сортиране за сортиране на колоната във възходящ ред. Например createdon ASC
sort_descending Извежда низ за израз за сортиране за сортиране на колоната в низходящ ред. Например createdon DESC
sort_disabled Връща „true”, ако сортирането е забранено за колоната. В противен случай връща „false”.
sort_enabled Връща „true”, ако сортирането е разрешено за колоната. В противен случай връща „false”.
width Извежда конфигурираната ширина за колоната в пиксели.

entityview

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

Атрибути

Атрибут Описание
колони Извежда колоните в изгледа като обекти на колона в изглед на таблица.
entity_permission_denied Връща „вярно”, ако е отказан достъп до преглед на резултатите поради недостатъчни разрешения за таблицата за текущия потребител. Връща „false”, ако е бил предоставен достъп за преглед на резултатите.
entity_logical_name Логическото име на таблица на Power Apps за записите на резултат за преглед. Пример, контакт
first_page Номера на страницата на първата страница на прегледа на резултатите. Това ще бъде 1, освен ако не са върнати никакви резултати, в който случай тя ще бъде null.
ID ИД на GUID на изгледа на Power Apps, който дефинира този „entityview”.
language_code Кодът за език на цяло число за Power Apps, който се използва за зареждане на локализирани етикети за текущия изглед.
last_page Номера на страницата на последната страница в прегледа на резултатите. Ако не са върнати никакви резултати, това ще бъде null.
Име Името на изгледа на Power Apps, който дефинира този „entityview”, като например „Активни контакти”.
next_page Номера на страницата на следващата страница в прегледа на резултатите. Ако няма следваща страница в резултатите, това ще бъде null.
Страница Номера на страницата на текущата страница в прегледа на резултатите.
pages Връща масив с номера на страници, съдържащи всички страници с резултати за текущия изглед.
page_size Броят резултати, върнат за страница, за текущия изглед.
previous_page Номера на страницата на следващата страница в прегледа на резултатите. Ако няма предишна страница в резултатите, това ще бъде null.
primary_key_logical_name Логическото име за Power Apps на атрибута за първичен ключ на получената таблица за този изглед. Пример, contactid.
записи Текущата страница със записи на резултати за изгледа като обекти на таблица.
sort_expression Изразът за сортиране по подразбиране за изгледа. Например nameASC, createdon DESC.
total_pages Общият брой на страниците с резултати за изгледа.
total_records Общият брой на резултатите за изгледа (във всички страници).

събития

Предоставя възможност за достъп и рендиране на събития. Обектът „събития” ви позволява да изберете определено събитие или всички събития.

Обект „events“

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

Обектът „събития” има следните атрибути:

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

Обект „event“

Обектът „събитие” ви позволява да работите с единично събитие, което ви позволява да имате достъп до графиците и повторенията за това събитие.

Обектът „събитие” има следните атрибути:

Атрибут Описание
повторения Връща обект „eventoccurrencesobject”, съдържащ всички повторения за събитието.
Име Името на събитието.
URL адрес URL адресът на събитието.

Обект „eventoccurences“

Обектът „eventoccurrences” ви позволява достъп до колекция от обекти на повторения на събития. Можете да подредите повторенията на събитието и да укажете диапазон от дати за извличане на повторения, както и да постигнете страниране с помощта на филтри на liquid

{% assign occurances = event.occurrences.from[today].to[advance_date] %}

обърнете внимание, че

{% assign occurances = event.occurrences.min[today].max[advance_date] %}

също е възможно.

Следните атрибути са свързани с обект „eventoccurrences”

Атрибут Описание
Всички Връща всички обекти „eventoccurrences” в колекцията.

Обект „eventoccurence“

Представлява еднократно повторение на събитие. Свързаните атрибути са дадени по-долу:

Атрибут Описание
URL адрес URL адресът на повторението.
is_all_day_event Целодневно събитие ли е това?
start_time Начален час за събитието.
end_time Краен час за събитието.

forloop

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

Бележка

forloop може да се използва само в рамките на етикет за.

Код

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

Атрибути

Атрибут Описание
първо Връща „вярно”, ако това е първата итерация на цикъла. Връща „false”, ако това не е първата итерация.
показалец Позицията на текущия елемент в колекцията, когато първият елемент има позиция 1.
index0 Позицията на текущия елемент в колекцията, когато първият елемент има позиция 0.
Последно Връща „true”, ако това е последната итерация на цикъла. Връща „false”, ако това не е последната итерация.
дължина Връща броя на итерациите за цикъла ߝ броя на елементите в колекцията, върху които се извършва итерацията.
rindex Брой на елементите, оставащи в цикъла (дължина – индекс), където 1 е индексът на последния елемент.
rindex0 Брой на елементите, оставащи в цикъла (дължина – индекс), където 0 е индексът на последния елемент.

форуми

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

Обектът на форуми ви позволява да изберете форум или нишки от форум:

<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“ ви позволява да получите достъп до всеки конкретен форум в портала или до всички нишки от форум в портала (независимо от форума).

Обектът на форуми ви позволява да работите с единичен форум, което ви позволява да имате достъп до нишките за този форум.

Обектът „forumthreads“ ви позволява да имате достъп до набор от обекти „forumthread“. Можете да подредите нишките от форум и да постигнете страниране и като използвате филтри на Liquid.

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

Единична нишка от форум

Обектът „forumposts“ ви позволява да имате достъп до набор от обекти „forumpost“.

Атрибути

Атрибут Описание
нишки Връща обект forumthreads, съдържащ всички обекти forumthreads в портала.
Всички Връща всички обекти на форуми в портала. Обърнете внимание, че website.forums също е еквивалент.
thread_count Връща целочислената стойност на броя на нишките в целия уеб сайт.
post_count Връща целочислената стойност на общия брой на публикациите в портала.
[име или ИД на форум] Можете да получите достъп до всеки форум чрез свойствата за неговото име или ИД.
`{% assign forum = forums[Forum Name] %}
{% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

обект „форум“

Атрибути

Бележка

обекти

Атрибут Описание
нишки Връща обект „forumthread”, съдържащ всички нишки от форум за форума.
Име Името на форума.
thread_count Връща целочислената стойност на броя на нишките във форума.
post_count Връща целочислената стойност на броя на нишките в целия форум.

Обект „forumthreads“

Атрибути

Атрибут Описание
Всички Връща всички обекти „forumthread” в колекцията.

обект „forumthread“

Атрибути

Бележка

обекти

Атрибут Описание
публикации Връща обект „forumposts”, съдържащ всички публикации във форум за нишката.
автор Връща автора за нишката (който е просто обект за таблица на контакт).
latest_post Връща последната публикация в нишката.
first_post Връща първата публикация в нишката.
post_count Връща целочислената стойност на броя на публикациите в нишката.
is_answered Нишката получила ли е отговор, или не?
is_sticky Нишката лепкава нишка ли е?

Обект „Forumposts“

Атрибути

Атрибут Описание
Всички Връща всички обекти „forumthread” в колекцията.

Единична публикация във форум

Атрибути

Бележка

обекти

Атрибут Описание
автор Връща автора за публикацията (който е просто обект за таблица на контакт).
съдържание Съдържание на публикацията.
is_answer Тази публикация представлява ли отговор на нишката?

знания

Осигурява достъп до knowledgearticle на Power Apps и записи на таблица с категории за рендиране на статии и категории в портал.

Атрибути

Атрибут Описание
статии Връща обект на статии, който съдържа обекти на статии за записите на таблицата knowledgearticle, налични в портала.
награди Връща обект на категории, който съдържа обекти на категория за записите на таблицата „Категория”, налични в портала.

обект на статии

Обектът на статии ви позволява достъп до набор от обекти на статии. Можете да подредите статиите и да постигнете страниране и чрез филтри на 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 %}

обект на категории

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

обект на статия

Обектът на статия ви позволява да работите с една knowledgearticle, за да се покажат подробности за статията в портала.

Атрибути

статията е обект на обект със същите атрибути в допълнение към изброените по-долу.

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

обект на категория

Обектът на категория ви позволява да работите с една категория, за да се покажат подробностите за нея в портала.

Атрибути

категорията е обект на обект със същите атрибути в допълнение към изброените по-долу.

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

език

Предоставя текущото име на езика и езиков код, ако е активирана многоезична поддръжка.

Атрибути

Атрибут Описание
URL адрес URL адресът на текущата заявка с префикс с текущия код на езика.
url_substitution URL адресът на текущата заявка с префикс с текущия езиков код, заобикаляйки кеша на изхода на страницата.
Име Заглавие на текущия език.
код Езиковият код.

Например уеб шаблонът с Падащо меню за езици по подразбиране използва този обект на Liquid, за да изброи наличните езици, когато са налични множество езици.

страница

Отнася се за текущата страница за заявка в портала. Този обект съчетава атрибутите на картата на сайта и текущата заявка обекти (обикновено уеб страница).

Обектът „Страница” предоставя достъп до неща, като йерархични връзки за текущата страница, заглавието или URL адреса на текущата страница, както и всякакви други атрибути или свързани обекти на подлежащия запис на Power Apps.

<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 }}. -->

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

Бележка

обекти

Атрибут Описание
йерархични връзки Връща обектите на възли на картата на сайта за йерархични връзки за страницата, като започва от коренния възел на картата на сайта и завършва с родителския.
дъщерни Връща обектите на възел на картата на дъщерен сайт на страницата.
родител Връща възела на картата на родителския сайт на страницата. Ако страницата е началната страница, родителят ще бъде null.
title Заглавието на страницата.
URL адрес URL адресът на страницата.
[име на атрибут или релация] Можете да получите достъп до всеки атрибут на подлежащия запис на Power Apps за страницата чрез логическо име.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
Стойностите на повечето атрибути на таблица се нанасят директно върху Типове на Liquid: Полетата с две опции се нанасят до булев израз, текстовите полета до низове, числовите/валутни полетата до числа, полетата за дата/час до обекти на дата. Някои типове атрибути обаче се връщат като обекти:
  • Полетата за справка (препратка към свързана таблица) се връщат като обекти за препратка към свързана таблица.
  • Полетата за набор от опции/списък по избор се връщат като обект на стойност на набор от опции.
  • Можете също да заредите всички свързани обекти по име на схема на отношение.
    {{ page.adx_webpage_entitylist.adx_name }}
    В такъв случай релацията е рефлексивна (т.е. самоотносима), ще се върне обект обекти. (В противен случай, желаният резултат ще бъде неясен.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Забележка: Зареждането на голям брой свързани обекти или достъпът до голям брой отношения в един единствен шаблон могат да имат отрицателно въздействие върху характеристиките на рендиране на шаблона. Избягвайте зареждане на свързаните обекти за всеки елемент в масив в рамките на един цикъл. Когато е възможно, избирайте използването на етикетите на таблица на Power Apps Dataverse, за да заредите колекции от обекти.

анкети

Предоставя възможност за достъп и рендиране на анкети.

Обектът „анкети” ви позволява да изберете конкретна анкета или разполагане на анкета:

<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>

Атрибути на анкети

Атрибут Описание
разполагания Връща обекта „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] %}

Атрибути на разполагане на анкета

Бележка

обекти

Атрибут Описание
Име Връща полето „Име“ за разполагането на анкета.
placement_url URL адресът, който може да се използва за извличане на разполагането на анкета, изцяло рендирано от шаблон.
анкети Връща колекцията от обекти на анкета, свързани с разполагането. Етикетите за итерация и филтрите за масив могат да се използват с тази колекция.
random_url URL адресът, който може да се използва за извличане на произволна анкета от разполагане, изцяло рендирано от шаблон.
submit_url URL адресът, към който е подадена приключената анкета.

Атрибути на анкета

Бележка

обекти

Атрибут Описание
has_user_voted Връща „true“, ако текущият потребител (влязъл или анонимен) вече е гласувал в тази анкета.
Име Връща полето „Име“ за анкетата.
опции Връща колекцията от обекти „опция за анкета“, свързани с анкетата. Етикети за итерация и обекти могат да се използват с тази колекция.
анкета_url URL адресът, който може да се използва за извличане на анкета, изцяло рендирана от шаблон.
въпрос Връща полето „Въпрос“ за анкетата.
submit_button_label Връща низ, който може да се използва да игнориране на етикета на бутона за подаване на анкета.
submit_url URL адресът, към който е подадена приключената анкета.
user_selected_option Връща обекта „polloption“, избран от потребителя (ако вече е гласувал).
гласове Връща броя на гласовете, които са били подредени за анкета.

Атрибути на опция за анкета

Бележка

обекти

Атрибут Описание
отговор Връща полето „Отговор“ за анкетата.
процент Връща процента от гласовете в анкетата за опцията като десетично число от 0 до 100.
гласове Връща броя на гласовете, които са били подредени за опцията.

заявка

Съдържа информация относно текущата 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} или съхраняване на URL адреса на портала в Настройки на сайта.
  • Версия на издание на портали на Power Apps 9.3.8.x или по-късна ще има по подразбиране escape филтър на Liquid наложен за потребител и обекти на Liquid request. За да деактивирате тази конфигурация по подразбиране и да разрешите тези обекти на Liquid без изходен филтър Liquid, вижте настройки на сайт - Site/EnableDefaultHtmlEncoding.

Атрибути

Атрибут Описание
параметри Именуваните стойности на параметър за текущата заявка. params е комбинация от параметри на низ на заявка на URL адрес, следващи параметри на формуляр и бисквитки.
Път Пътят на URL адреса на текущата заявка.
/профил/
path_and_query Пътят и заявката на URL адреса на текущата заявка.
/profile/?foo=1&bar=нещо
заявка Частта на заявка на URL адреса на текущата заявка.
?foo=1&bar=нещо
URL адрес Пълният URL адрес на текущата заявка.
https://www.example.com/profile/?foo=1&bar=something

индекс за търсене

Обектът searchindex се използва в рамките на етикети на таблица на Power Apps 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.
Резултати Връща страницата с резултати от заявката във формата на обекти на резултат от индекса за търсене.

Резултати от индекса за търсене

Атрибут Описание
обект Подлежащите обекти за резултата.
фрагмент Свързан кратък текстов фрагмент за резултата с термини, съответстващи на указаната заявка, подчертани с помощта на <em> HTML етикет. Определени типове заявки не поддържат подчертани фрагменти, например размити заявки (~) и търсене чрез заместващ символ (*). Това свойство ще бъде нулево в тези случаи.
ID ИД на таблица на Power Apps на подлежащия запис за резултата във формата на низ. Например 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Логическото име на таблица на Power Apps на подлежащия запис за резултата. Например adx_webpage
Номер Номерът на резултата в рамките на всички страници с резултати, започващи от 1. За първия резултат от втората страница с резултати например при размер на страницата от 10 тази стойност ще бъде 11.
резултат Резултата на Lucene за резултата под формата на стойност с плаваща запетая. Резултатите ще бъдат върнати, подредени по тази стойност.
title Заглавието на резултата.
URL адрес URL адрес за резултата. Това обикновено—но не е задължително—ще е абсолютен път за текущото приложение, а не пълен URL адрес. Например: /articles/article1/

настройки

Позволява ви да заредите всяка настройка на сайта по име. Ако настройка с даденото име не бъде намерена, ще се върне нула.

Бележка

Настройки се връщат като низове, но можете да използвате Филтри за тип, за да ги преобразувате в други типове.

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

sitemap

Позволява достъп до картата на сайта на портала.

<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.)
Обект Връща подлежащите обекти на възела. Ако възелът няма подлежаща таблица, тази стойност ще бъде null.
is_sitemap_ancestor Връща „true”, ако възела на картата на сайта е наследник на текущия възел, в противен случай „false”.
is_sitemap_current Връща „true”, ако възела на картата на сайта е текущия възел, в противен случай „false”.
Родител Връща възела на картата на родителския сайт на възела. Ако възелът е коренен възел, родителят ще бъде null.
Длъжност Заглавието на възела.
URL адрес URL адресът на възела.

маркери на сайт

Позволява ви да заредите всякакви маркери на сайт по име. Ако маркерът на сайт съществува, ще бъде върнат обект на маркер на сайт. Ако създател на сайт с даденото име не бъде намерен, ще се върне нула.

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

Атрибути на маркер на сайт

Атрибут Описание
URL адрес URL адрес на целта на маркера на сайт.
[логическо име на атрибут] Можете да получите достъп до всеки атрибут на целевия запис на маркер на сайт на Power Apps чрез логическо име. Например {{ sitemarker.adx_name }}

фрагменти

Позволява ви да заредите всякакъв фрагмент от съдържанието по име. Ако фрагмент с даденото име не бъде намерен, ще се върне нула.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Съдържа свойства, които са полезни в рамките на блок на цикъл Етикети за итерация.

Бележка

tablerowloop може да се използва само в рамките на етикет етикети за итерация.

Атрибути

Атрибут Описание
Кол Връща индекса на текущия ред, като започва от 1.
col0 Връща индекса на текущия ред, като започва от 0.
col_first Връща „true”, ако текущата колона е първата колона в ред, връща „false”, ако не е.
col_last Връща „true”, ако текущата колона е последната колона в ред, връща „false”, ако не е.
Собствено Връща „вярно”, ако това е първата итерация на цикъла. Връща „false”, ако това не е първата итерация.
Index Позицията на текущия елемент в колекцията, когато първият елемент има позиция 1.
index0 Позицията на текущия елемент в колекцията, когато първият елемент има позиция 0.
Последно Връща „true”, ако това е последната итерация на цикъла. Връща „false”, ако това не е последната итерация.
Дължина Връща броя на итерациите за цикъла ߝ броя на елементите в колекцията, върху които се извършва итерацията.
Rindex Брой на елементите, оставащи в цикъла (дължина – индекс), където 1 е индексът на последния елемент.
rindex0 Брой на елементите, оставащи в цикъла (дължина – индекс), където 0 е индексът на последния елемент.

потребител

Отнася се за текущия потребител на портала, което позволява достъп до всички атрибути на подлежащия запис на контакт в Power Apps. Ако няма влязъл потребител, тази стойност ще бъде нула.

потребителят е обект обект.

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

Бележка

Версия на издание на портали на Power Apps 9.3.8.x или по-късна ще има по подразбиране escape филтър на Liquid наложен за потребител и обекти на Liquid request. За да деактивирате тази конфигурация по подразбиране и да разрешите тези обекти на Liquid без изходен филтър Liquid, вижте настройки на сайт - Site/EnableDefaultHtmlEncoding.

Атрибути

В допълнение към разполагането с всички атрибути на обект обекти потребителят има атрибутите, посочени по-долу.

Атрибут Описание
роли Връща ролите, към която принадлежи потребителят, като масив.
{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}
Забележка: Можете също да използвате филтър has_role, за да проверите за членства с индивидуалната роля.
basic_badges_url Връща URL адреса на услугата за извличане на потребителски значки.
За рендиране на значки за потребител трябва да включите етикет с атрибути „данни-значка” и „данни-uri”. За рендиране на значките на текущия потребител:
<div data-badge data-uri='{{user.basic_badges_url }}'></div>
За рендиране на потребителски значки по ИД (променлив userid):
`<div data-badge data-uri='{{user.basic_badges_url

уеб връзки

Позволява ви да заредите всякакви уеб връзки по име или ИД.

Ако наборът от уеб връзки съществува, ще бъде върнат обект на набор от уеб връзки. Ако няма намерен набор от уеб връзки с даденото име или ИД, ще бъде върната нула.

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

Атрибути на набор от уеб връзки

Бележка

Наборът от уеб връзки е обект на обект със същите атрибути в допълнение към изброените по-долу.

Атрибут Описание
Копиране HTML копието на набора от уеб връзки.
Име Името на набора от уеб връзки.
Длъжност Заглавието на набора от уеб връзки.
Уеб връзки Масивът от обекти на уеб връзки, свързан с набора от уеб връзки.
[логическо име на атрибут] Можете да достигнете до всеки атрибут от записа в Power Apps за набора от уеб връзки по логическо име. Например, {{ weblinkset.createdon }}

Атрибути на уеб връзка

Бележка

Уеб връзката е обект на обект със същите атрибути в допълнение към изброените по-долу.

Атрибут Описание
Описание HTML описанието на уеб връзката.
display_image_only Булев атрибут, указващ дали уеб връзката трябва да бъде показана само като изображение без текст за връзка.
display_page_child_links Булев атрибут, указващ дали уеб връзката трябва да показва връзки към дъщерните страници карта на сайта на свързаната страница като подвръзки.
Изображение Обектът на изображение на уеб връзката за тази връзка. Този атрибут ще бъде нулев, ако няма изображение.
is_external Булев атрибут, указващ дали целевият URL адрес на уеб връзката е към външен сайт (вместо към вътрешна страница на портал).
is_sitemap_ancestor Връща „true”, ако URL адреса на уеб връзката насочва към наследник на текущия възел на карта на сайта, в противен случай „false”.
is_sitemap_current Връща „true”, ако URL адреса на уеб връзката насочва към текущия възел на карта на сайта, в противен случай „false”.
Име Името/заглавието на уеб връзката.
Nofollow Булев атрибут, указващ дали уеб връзката трябва да бъде обозначена като rel=nofollow.
open_in_new_window Булев атрибут, указващ дали уеб връзката трябва да бъде отворена в нов прозорец/раздел на браузъра, когато бъде избрана.
Пояснение Текст на пояснение за уеб връзката.
URL адрес URL адресът на уеб връзката.
Уеб връзки Масивът от дъщерни обекти на уеб връзката, свързана с уеб връзката.
[логическо име на атрибут] Можете да достигнете до всеки атрибут от записа в Power Apps за уеб връзки по логическо име. Например, {{ weblink.createdon }}

Атрибути на изображение на уеб връзка

alternate_text Алтернативен текст за изображението.+
Височина Цяло число, съдържащо указаната височина на изображението. Ако не е предоставена стойност за височината, този атрибут ще бъде нулев.
URL адрес URL адресът на изображението.
Ширина Цяло число, съдържащо указаната ширина на изображението. Ако не е предоставена стойност за ширината, този атрибут ще бъде нулев.

уеб сайт

Отнася се за уеб сайт на портала, което позволява достъп до всички атрибути на записа на уеб сайта Power Apps (adx_website) за портала.

Бележка

Уеб сайтът е обект на обект с всички еднакви атрибути.

Код

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

Бележка

Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)

Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).