Налични обекти на 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>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<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
Бележка
Можете ли да ни споделите повече за езиковите си предпочитания за документацията? Попълнете кратко проучване. (имайте предвид, че това проучване е на английски език)
Проучването ще отнеме около седем минути. Не се събират лични данни (декларация за поверителност).