Dataverse Liquid ознаке

Microsoft Dataverse Liquid ознаке се користе за учитавање и приказивање Dataverse података или користе друге услуге Power Pages радног оквира. Ове ознаке су додаци специфични за систем Dataverse за Liquid језик.

Додаје Power Apps графикон апликације засноване на моделу на веб-страницу. Ознака графикона може да се дода у поље Копија на веб-страници или у пољу Извор у веб-предлошку. За кораке додавања графикона Power Apps апликације засноване на моделу на веб-страницу, погледајте Додавање графикона на веб-страницу у услузи Power Pages.

{% chart id:"EE3C733D-5693-DE11-97D4-00155DA3B01E" viewid:"00000000-0000-0000-00AA-000010001006" %}

Постоје два параметра која треба да наведете са ознаком графикона: ID графикона и viewid.

Графикон ИД

ID визуелизације графикона. ИД можете добити извозом графикона.

Претраживање

ID табеле када се отвори у уређивачу приказа.

Додаје Power BI контролне табле и извештаје у оквиру странице. Ознака може да се дода у поље Копија на веб-страници или у пољу Извор у веб-предлошку. Кораке за додавање Power BI извештаја или контролне табле веб-страници у услузи Power Pages потражите у чланку Додавање Power BI извештаја или контролне табле веб-страници у услузи Power Pages.

Ознака powerbi прихвата следеће параметре:

Путања

Путања Power BI извештаја или контролне табле. Ако су Power BI извештај или контролна табла безбедни, морате да одредите тип потврде идентитета.

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}

аутхентицатион_тyпе

Тип потврде идентитета је обавезан за Power BI извештај или контролну таблу. Важеће вредности за овај параметар су:

• Анониман : Омогућава вам да уградите #глср_цигибхицз Power BI извештаје. Подразумевани тип потврде идентитета је „Анонимно“. Када користите тип потврде идентитета као Анонимни корисник, морате добити URL адресу Power BI извештаја као што је описано у чланку Објављивање на вебу из услуге Power BI

• ААД : Омогућава вам да делите сигурне Power BI извештаје или контролне табле за Power BI Microsoft Entra идентификацију аутентификованих корисника.

• повербиембеддед : Омогућава вам да делите сигурне Power BI извештаје или контролне табле са спољним корисницима који немају Power BI лиценцу или Microsoft Entra подешавање аутентификације. За информације о подешавању услуге Power BI Embedded, погледајте Омогућавање Power BI Embedded услуге.

Када додате сигуран Power BI извештај или контролну таблу, проверите да ли се дели са Power Pages Microsoft Entra Power BI Embedded или услугама.

{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}

Можете и да Филтерирате извештај према једној или више вредности. Синтакса за Филтерирање извештаја је:

URL?filter=Table/Field eq 'value'

На пример, рецимо да желите да Филтерирате извештај како бисте видели податке за контакт под именом Бане Видић. URL адреси морате да приложите следеће податке:

?filter=Executives/Executive eq 'Bert Hair'

Комплетан код је:

{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq 'Bert Hair'" %}

Још информација за филтрирање извештаја: Филтрирање извештаја користећи параметре ниске упита у URL адреси

Такође можете да креирате динамичку путању коришћењем capture Течна променљива:

{% capture pbi_path %}https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq '{{user.id}}'{% endcapture %}
{% powerbi authentication_type:"AAD" path:pbi_path %}

Још информација о Liquid променљивој: Променљиве ознаке

садржина

Приказује наведену плочицу контролне табле. Морате да наведете ID плочице.

{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/dashboards/00000000-0000-0000-0000-000000000001" tileid:"00000000-0000-0000-0000-000000000002" %}

Улоге

Улоге додељене Power BI извештају. Овај параметар ради само када је параметар authentication_type је подешен на powerbiembedded.

Ако сте дефинисали улоге и Power BI доделили их извештајима, морате навести одговарајуће улоге у ознаци Поверби Ликуид. Улоге вам омогућују да Филтерирате податке који ће се приказати у извештају. Можете навести више улога одвојених зарезом. За још информација о дефинисању улога у Power BI, погледајте Безбедност на нивоу реда (RLS) са Power BI.

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:"Region_East,Region_West" %}

Ако сте доделили улогу извештају Power BI , а нисте специфицирали параметар улога у ознаци Течност или нисте навели улогу у параметру, грешка је приказана.

Визуелизује дати Power Pages CMS објекат као онај који може да се уређује на локацији, за кориснике са дозволом за уређивање садржаја за тај објекат. Објекти који могу да се уређују обухватају страницу, исечке и веб-везе.

{% editable page 'adx_copy' type: 'html', title: 'Page Copy', escape: false, liquid: true %}

{% editable snippets Header type: 'html' %}

<!--

An editable web link set required a specific DOM structure, with

certain classes on the containing element, as demonstrated here.

-->

{% assign primary_nav = weblinks[Primary Navigation] %}

{% if primary_nav %}

<div {% if primary_nav.editable %}class=xrm-entity xrm-editable-adx_weblinkset{% endif %}>

<ul>

<!-- Render weblinks... -->

</ul>

{% editable primary_nav %}

</div>

{% endif %}

Први параметар који се може уређивати је објекат који се може уређивати, као што су скуп веб-веза, исечци или тренутна страница. Опционални други параметар је за навођење имена атрибута или кључа унутар тог објекта који ће се визуелизовати и уређивати. Ова вредност може бити име атрибута табеле, или исечак име, на пример.

Након ових почетних параметара, ознака подржава многе опционално именоване параметре.

Класе

Одређује вредност атрибута class за основни елемент визуелизован овом ознаком.

Подразумевани

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

Побегне

Боолеова вредност која указује да ли је вредност приказана овом ознаком ХТМЛ-кодирана. Подразумевано, та вредност је „нетачно“.

Теиност

Боолеова вредност која указује да ли било који код течног шаблона пронађен у текстуалној вредности коју је изрекла ова ознака треба да буде обрађен. Подразумевано, та вредност је „тачно“.

Ознака

Име контејнерских ХТМЛ ознака које је приказала ова ознака. Ова ознака приказује див елементе подразумевано. Препоручује се да бирате div или span као вредност овог параметра.

Име контејнерских ХТМЛ ознака које је приказала ова ознака. Ова ознака div приказује елементе подразумевано. Препоручује се да изаберете између div или span за овај параметар.

Наслов

Наводи ознаку за ову ставку коју је могуће уређивати у оквиру интерфејса за уређивање садржаја. Ако ниједан није обезбеђен, пријатељски ознака се генерише аутоматски.

Тип

Вредност ниске која наводи тип интерфејса за уређивање који ће бити представљен, за изменљиве текстуалне вредности. Важеће вредности за овај параметар су html или text. Подразумевано подешавање је html.

Учитава дату листу, по имену или ID-у. Својствима листе се затим може приступити помоћу објекта ентитyлист који је доступан унутар блока ознака. Да бисте приказали записе са стварним резултатима листе, користите ознаку entityview унутар блока.

Ако је листа успешно учитана, садржај унутар блока је приказан. Ако листа није пронађена, садржај блока се не приказује.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Подразумевано, ентитетлиста објекат добија променљиву име ентитyлист. Опционално, могуће је навести друго име променљиве.

{% entitylist my_list = name:My List %}

Loaded list {{ my_list.adx_name }}.

{% endentitylist %}

Наведите само један атрибут између ID-а, назива или кључа да бисте изабрали листу за учитавање.

Ид

Учитава листу из GUID ID-а. ID мора да буде ниска коју је могуће рашчланити као GUID.

{% entitylist id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Генерално, буквални ГУИД стрингови се не користе. Уместо тога, ид је специфициран коришћењем ГУИД особине друге променљиве.

{% entitylist id:page.adx_entitylist.id %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Име

Учитава листу према називу.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Кључ

Учитава листу према ID-у или називу. Ако се обезбеђена вредност кључа може парсирати као ГУИД , листа се учитава по ИД-у. У супротном, учитава се по имену.

<!-- key_variable can hold an ID or name -->

{% entitylist key:key_variable %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

лангуаге_цоде

Dataverse целобројни кôд језика за бирање локализованих ознака листе које ће бити учитане. Ако није обезбеђен лангуаге_цоде, користи се подразумевани језик везе са апликацијом Dataverse сајта.

{% entitylist name:"My List", language_code:1033 %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Учитава дати Dataverse приказ, по имену или ID-у. Особине метаподатака приказа колоне приказа, пагинираних записа резултата, итд. могу се приступити помоћу ентитетвиеw објекта који је доступан унутар блока ознака.

Ако је приказ успешно учитан, садржај унутар блока је приказан. Ако приказ није пронађен, садржај блока се не приказује.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Подразумевано, ентитетвиев објекат добија име променљиве ентитyвиеw. Опционално, могуће је навести друго име променљиве.

{% entityview my_view = logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ my_view.total_records }} total records.

{% endentityview %}

Ако је ентитyвиеw угнежђен унутар блока ентитyлист, он наслеђује своју подразумевану конфигурацију (величина странице резултата, опције филтера, итд.) са листе. Ако се ентентивиев-у не обезбеде параметри ИД приказа или имена, он учитава подразумевани приказ са ентитетске листе која га окружује.

{% entitylist id:page.adx_entitylist.id %}

{% entityview %}

Loaded default view of the list associated with the current page, with {{ entityview.total_records }} total records.

{% endentityview %}

{% endentitylist %}

Наведите или ID или logical_name са називом да бисте изабрали Dataverse приказ за учитавање. Ако ни једно ни друго није обезбеђено, а ознака ентентивиев је угнежђена унутар ознаке ентитyлист, подразумевани приказ прилога ентитyлист се учитава.

Ид

id мора да буде ниска коју је могуће рашчланити као GUID.

{% entityview id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}

Loaded entity view {{ entityview.name }}.

{% endentityview %}

Генерално, буквални ГУИД стрингови се не користе. Уместо тога, ид је специфициран коришћењем ГУИД особине друге променљиве.

{% entityview id:request.params.view %}

Loaded entity view {{ entityview.name }} using view query string request parameter.

{% endentityview %}

логицал_наме

Логичко име Dataverse ентитета за приказ који ће се учитати. Мора да се користи у комбинацији са „name“.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Име

Dataverse име за приказ који ће се учитати. Мора да се користи у комбинацији са logical_name.

{% entityview logical_name:'contact', name:"Active Contacts" %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Филтер

Наводи да се приказ резултата Филтерира према кориснику или налогу. Мора да има вредност ниске „корисник“ или „налог“.

{% entityview id:request.params.view, filter:'user' %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Уобичајени случај коришћења јесте подешавање овог параметра на основу захтева.

{% entityview id:request.params.view, filter:request.params.filter %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Сортирај

Наводи израз за филтер метаподатака листе ентитета према којем се филтрира приказ резултата. Овај параметар је важећи само када се користи entityview у комбинацију са entitylist. У већини случајева, овај параметар се заснива на захтеву.

{% entitylist id:page.adx_entitylist.id %}

{% entityview id:request.params.view, metafilter:request.params.mf %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

{% endentitylist %}

Поруџбине

Наводи израз сортирања за распоређивање резултата приказа. Израз сортирања може да садржи један или више логичких имена атрибута ентитета, праћених смером сортирања растуће или опадајуће.

{% entityview id:request.params.view, order:'name ASC, createdon DESC' %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Уобичајени случај коришћења јесте подешавање овог параметра на основу захтева.

{% entityview id:request.params.view, order:request.params.order %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

страница

Наводи страницу са резултатима странице за учитавање. Ако овај параметар није наведен, учитава се прва страница резултата.

Овај параметар мора бити прослеђен као целобројна вредност или као ниска коју је могуће рашчланити као цео број. Ако је вредност обезбеђена за овај параметар, али вредност је нулл или на други начин не може бити обрађена као цео број, прва страница резултата се учитава.

{% entityview id:request.params.view, page:2 %}

Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Уобичајени случај коришћења јесте подешавање овог параметра на основу захтева.

{% entityview id:request.params.view, page:request.params.page %}

Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.

{% endentityview %}

паге_сизе

Наводи број резултата за учитавање за тренутну страницу са резултатима. Ако за овај параметар није обезбеђена никаква вредност, а ентитетприказ се користи унутар блока ентитyлист , користи се величина странице листе. Ако није у блоку ентитyлист, користи се подразумевана вредност 10.

Овај параметар мора бити прослеђен као целобројна вредност или као ниска коју је могуће рашчланити као цео број. Ако је обезбеђена вредност за овај параметар, али вредност је нулл или на други начин не може бити обрађена као цео број, подразумевана величина странице се користи.

{% entityview id:request.params.view, page_size:20 %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Уобичајени случај коришћења јесте подешавање овог параметра на основу захтева.

{% entityview id:request.params.view, page_size:request.params.pagesize %}

Loaded entity view with {{ entityview.total_records }} total records.

{% endentityview %}

Претраге

Наводи израз претраге према којем ће се Филтерирати резултати приказа. Једноставни изрази за претрагу кључних речи филтрирају по томе да ли атрибути почињу са кључном речју. У израз је могуће укључити и џокер знакове *.

{% entityview id:request.params.view, search:'John\*' %}

Loaded entity view with {{ entityview.total_records }} total matching records.

{% endentityview %}

Уобичајени случај коришћена јесте подешавање овог параметра на основу захтева, тако да филтер претраге може поставити на основу уноса корисника.

{% entityview id:request.params.view, search:request.params.search %}

Loaded entity view with {{ entityview.total_records }} total matching records.

{% endentityview %}

лангуаге_цоде

Dataverse целобројни код језика за бирање локализованих ознака приказа ентитета (ознаке за заглавље колоне итд.) који ће се учитати. Ако није обезбеђен лангуаге_цоде, користи се подразумевани језик везе са апликацијом Dataverse за веб сајт.

Ако се ентитyвиеw користи унутар блока ентитyлист, ентитyвиеw наслеђује конфигурацију кода језика из ентитyлист.

{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}

Loaded entity view {{ entityview.name }}.

{% endentitylist %}

Извршава упит према индексу претраге преко веб-локације. Одговарајућим резултатима се затим може приступити помоћу индекса претраге који је доступан унутар блока ознака.

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

<style>

    .highlight {background-color: #FFFCAC;}

</style>

Подразумевано, објекат индекса претраге добија име променљиве сеарцхиндеx. Опционално, могуће је навести друго име променљиве.

{% searchindex liquid_search = query: 'support', page: params.page, page_size: 10 %}

{% if liquid_search.results.size > 0 %}

...

{% endif %}

{% endsearchindex %}

Ознака searchindex прихвата следеће параметре.

Упит

Упит који се користи за упаривање резултата. Овај параметар је намењен да прихвата кориснички дефинисани део упита индекса (ако постоји).

{% searchindex query: 'support' %}

...

{% endsearchindex %}

Уобичајени случај коришћења јесте подешавање овог параметра на основу захтева.

{% searchindex query: request.params.query %}

...

{% endsearchindex %}

Овај параметар подржава синтаксу Lucene анализатора упита.

Филтер

Још један упит који се користи за подударање резултата. Овај параметар намењен је да прихвати филтер којег је навео програмер за резултате, ако то жели.

{% searchindex query: request.params.query, filter: '+statecode:0' %}

...

{% endsearchindex %}

Овај параметар подржава синтаксу Lucene анализатора упита.

логицал_намес

Ентитетска Dataverse логичка имена на која су подударање резултата ограничена, као низ раздвојен зарезима. Ако није обезбеђен, враћају се сви одговарајући ентитети.

{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}

...
>
{% endsearchindex %}

страница

Страница са резултатима претраге која се враћа. Ако није наведено, прва страна (1) се враћа.

{% searchindex query: request.params.query, page: 2 %}

...

{% endsearchindex %}

Уобичајени случај коришћења јесте подешавање овог параметра на основу захтева.

{% searchindex query: request.params.query, page: request.params.page %}

...

{% endsearchindex %}

паге_сизе

Величина странице са резултатима која се враћа. Ако није наведено, подразумевана величина 10 се користи.

{% searchindex query: request.params.query, page_size: 20 %}

...

{% endsearchindex %}

У потпуности визуелизује образац, по називу или ID-у.

{% entityform name: 'My Basic Form' %}

Име

Назив основног обрасца који желите да учитате.

{% entityform name:My Basic Form %}

У потпуности визуелизује образац са више корака, по називу или ID-у. Ознака webform је доступна само за коришћење у садржају приказаном унутар предлошка странице засноване на веб-предлошку. Покушај коришћења ознаке унутар шаблона странице заснованог на преписивању не доноси ништа. Можете приказати само једну ентитетску или вебформу ознаку по страници. Ентитетформ или вебформ ознаке након првог нису приказане.

{% webform name: 'My Multistep Form' %}

Име

Назив обрасца са више корака који желите да учитате.

{% webform name:My Multistep Form %}

Дозвољава вам да уградите компоненте кода користећи Liquid ознаку. На пример, додавање мапе приказује прилагођену контролу на веб-страници.

Име

ИД или име компоненте кода.

Својство

Вредности особина које компонента кода очекује треба да буду прослеђене као пар кључ/вредност раздвојен двотачком (:), где је кључ име особине, а вредност је вредност ЈСОН стринга.

{% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}

Погледајте Коришћење Liquid ознаке предлошка компоненти кода.

• Контролне ознаке протока
• Ознаке итерације
• Променљиве ознаке
• Ознаке шаблона