Dataverse Liquid тегтері

Microsoft Dataverse Liquid тегтері Dataverse деректерін жүктеу және көрсету үшін пайдаланылады немесе Power Pages сайты арқаулық жүйесінің басқа қызметтерін пайдаланыңыз. Бұл тегтер — Liquid тіліндегі Dataverse жүйесіне тән кеңейтімдер.

Диаграмма

Веб-бетке Power Apps модельге негізделген бағдарлама диаграммасын қосады. Диаграмма тегін веб-беттегі Көшіру өрісіне немесе веб-үлгіге Көз өрісіне қосуға болады. Веб-бетке Power Apps модельге негізделген бағдарлама диаграммасын қосу қадамдарын Power Pages сайтындағы веб-бетке диаграмма қосу бөлімінде қараңыз.

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

Параметрлер

Диаграмма тегінде екі параметрді көрсету керек: chart id және viewid.

диаграмма идентификаторы

Диаграмманың көрнекілендіру идентификаторы. Диаграмманы экспорттау арқылы идентификаторды алуға болады.

көру идентификаторы

Көрініс өңдегішінде ашылған кездегі кесте идентификаторы.

powerbi

Power BI бақылау тақталарын және есептерді беттерге қосады. Тегті веб-беттегі Көшіру өрісіне немесе веб-үлгідегі Деректер көзі өрісіне қосуға болады. Power Pages сайтындағы веб-бетке Power BI есебін немесе бақылау тақтасын қосу қадамдары үшін, Power Pages сайтындағы веб-бетке Power BI есебін немесе бақылау тақтасын қосу бөлімін қараңыз.

Параметрлер

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

аутентификация_түрі

Power BI есебі немесе бақылау тақтасы үшін қажет түпнұсқалық растама түрі. Осы параметрдің жарамды мәндері:

• Анонимді: Вебке жариялау Power BI есептерді ендіруге мүмкіндік береді. Әдепкі аутентификация түрі - жасырын. "Анонимді" түпнұсқалық растама түрін пайдаланған кезде, Power BI қызметін келесі бөлімде сипатталғандай алуыңыз қажет: Power BI қызметінен вебке жариялау

• AAD: Қауіпсіз Power BI есептерді немесе бақылау тақталарын Power BI Microsoft Entra ID аутентификациясы бар пайдаланушылармен бөлісуге мүмкіндік береді.

• powerbiembedded: Қауіпсіз 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 айнымалысы туралы қосымша ақпарат: Айнымалы тегтері

тақтайша

Бақылау тақтасының көрсетілген қатарын көрсетеді. Идентификатордың қатарын көрсету керек.

{% 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 рөлдерді анықтасаңыз және оларды есептерге тағайындасаңыз, powerbi Сұйықтық тегінде сәйкес рөлдерді көрсетуіңіз керек. Рөлдер есепте көрсетілетін деректерді сүзгілеуге мүмкіндік береді. Үтірмен бөлінген бірнеше рөлді көрсете аласыз. Power BI ішіндегі рөлдерді анықтау туралы қосымша ақпаратты Power BI есебімен қатар деңгейіндегі қауіпсіздігін (RLS) бөлімінен қараңыз.

{% 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 төлсипатының мәнін көрсетеді.

әдепкі

Өңделетін элементтің мәні жоқ жағдайда көрсетілетін әдепкі мән.

қашу

Бұл тег арқылы көрсетілетін мәннің HTML кодталғанын көрсететін логикалық мән. Әдепкі бойынша бұл мән – жалған.

сұйықтық

Осы тег арқылы көрсетілетін мәтін мәнінің ішінде табылған кез келген Liquid үлгі кодын өңдеу керек пе көрсететін логикалық мән. Әдепкі бойынша бұл мән – шынайы.

тег

Осы тег арқылы көрсетілетін контейнер HTML тегтерінің атауы. Бұл тег әдепкі бойынша div элементтерін көрсетеді. Осы параметрдің мәнін div немесе span арасынан таңдау ұсынылады.

Осы тег арқылы көрсетілетін контейнер HTML тегтерінің атауы. Бұл тег әдепкі бойынша div элементтерді көрсетеді. Бұл параметр үшін div немесе span арасында таңдау ұсынылады.

тақырып

Мазмұн өңдеу интерфейсінен осы өңделетін элемент белгісін көрсетеді. Ешқайсысы берілмесе, түсінікті белгі автоматты түрде жасалады.

түрі

Көрсетілетін өңдеу интерфейсі түрін көрсететін жол мәні өңделетін мәтіндік мәндерге арналған. Осы параметрдің жарамды мәндері: html немесе text. html — әдепкі мән.

нысан тізімі

Берілген кестені аты немесе идентификаторы бойынша жүктейді. Содан кейін тізімнің сипаттарына тег блогында қол жетімді entitylist нысаны пайдалануға болады. Тізімнің нақты нәтиже жазбаларын көрсету үшін блоктағы entityview тегін пайдаланыңыз.

Тізім сәтті жүктелсе, блок ішіндегі мазмұн көрсетіледі. Тізім табылмаса, блок мазмұны көрсетілмейді.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Әдепкі бойынша, entitylist нысанына entitylist айнымалы атауы беріледі. Оған қоса, басқа айнымалы ат берілуі мүмкін.

{% entitylist my_list = name:My List %}

Loaded list {{ my_list.adx_name }}.

{% endentitylist %}

Параметрлер

Жүктелетін тізімді таңдау үшін идентификатор, атауы немесе кілт параметрлерінің тек біреуін көрсетіңіз.

идентификатор

GUID идентификаторы бойынша тізімді жүктейді. id GUID ретінде талдауға болатын жол болуы керек.

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

Әдетте, GUID литералды жолдары пайдаланылмайды. Оның орнына идентификатор басқа айнымалының GUID сипаты арқылы көрсетіледі.

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

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

аты

Тізімді атауы бойынша жүктейді.

{% entitylist name:My List %}

Loaded list {{ entitylist.adx_name }}.

{% endentitylist %}

кілт

Тізімді идентификатор немесе атауы бойынша жүктейді. Берілген кілт мәнін a GUID ретінде талдауға болатын болса, тізім 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 көрінісін атау немесе идентификатор бойынша жүктейді. Көріністің  көру бағанының метадеректері, беттелген нәтиже жазбалары және т.б. сипаттарына кейін тег блогында қолжетімді entityview нысаны пайдалануға болады.

Көрініс сәтті жүктелсе, блок ішіндегі мазмұн көрсетіледі. Көрініс табылмаса, блок мазмұны көрсетілмейді.

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

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

{% endentityview %}

Әдепкі бойынша, entityview нысанына entityview айнымалы атауы беріледі. Оған қоса, басқа айнымалы ат берілуі мүмкін.

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

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

{% endentityview %}

Егер entityview нысан тізімі блогында кірістірілген болса, ол тізімнен өзінің әдепкі конфигурациясын (нәтиже бетінің өлшемі, сүзгі опциялары, т.б.) иеленеді. Ешбір көрініс идентификаторы немесе атау параметрлері entityview үшін берілмесе, ол қоршалған нысандар тізімінен әдепкі көріністі жүктейді.

{% 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 көрінісін таңдау үшін көрсетіңіз. Ешқайсысы да берілмесе және entityview тегі нысандар тізімі тегінде кірістірілген болса, қоршалған нысандар тізімінің әдепкі көрінісі жүктеледі.

идентификатор

id GUID ретінде талдауға болатын жол болуы керек.

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

Loaded entity view {{ entityview.name }}.

{% endentityview %}

Әдетте, GUID литералды жолдары пайдаланылмайды. Оның орнына идентификатор басқа айнымалының GUID сипаты арқылы көрсетіледі.

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

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

{% endentityview %}

логикалық_атауы

Жүктелетін көріністің Dataverse нысанының логикалық атауы. Атаумен бірге пайдаланылуы қажет.

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

Жиі пайдаланылатын жағдай — осы параметрді request негізінде орнату.

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

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

{% endentityview %}

метасүзгі

Көрініс нәтижелері сүзгіленетін тізім метадеректері сүзгісінің өрнегін көрсетеді. Бұл параметр нысандар тізімімен бірге entityview пайдаланылған кезде ғана жарамды. Жағдайлардың көпшілігінде бұл параметр request параметріне негізделеді.

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

тапсырыс

Көрініс нәтижелерін реттеуге арналған сұрыптау өрнегін көрсетеді. Сұрыптау өрнегінде бір немесе бірнеше нысан төлсипатының логикалық атаулары, одан кейін ASC немесе DESC сұрыптау бағыты болуы мүмкін.

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

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

{% endentityview %}

Жиі пайдаланылатын жағдай — осы параметрді request негізінде орнату.

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

Жиі пайдаланылатын жағдай — осы параметрді request негізінде орнату.

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

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

{% endentityview %}

бет_өлшемі

Ағымдағы нәтиже беті жүктелетін нәтижелер санын көрсетеді. Бұл параметр үшін мән берілмесе және entityview entitylist блокта пайдаланылса, тізім бетінің өлшемі пайдаланылады. Егер нысандар тізімі блогында болмаса, әдепкі 10 мәні пайдаланылады.

Бұл параметр бүтін мәннен немесе бүтін ретінде талданған жол болып өтуі қажет. Бұл параметр үшін мән берілген болса, бірақ мән бос болса немесе басқаша бүтін сан ретінде талдау мүмкін болмаса, әдепкі бет өлшемі пайдаланылады.

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

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

{% endentityview %}

Жиі пайдаланылатын жағдай — осы параметрді request негізінде орнату.

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

Жиі пайдаланылатын жағдайы — іздеу сүзгісін пайдаланушының енгізгенінің негізінде орнату мүмкін болуы үшін осы параметрді request негізінде орнату.

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

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

{% endentityview %}

тіл_коды

Жүктелетін нысан көрінісінің локализацияланған белгілерін (баған тақырыбы белгілері, т.б.) таңдауға арналған Dataverse бүтін тіл коды. Тіл_коды берілмесе, веб-сайт қолданбасының Dataverse қосылымының әдепкі тілі пайдаланылады.

Егер entityview нысан тізімі блогында пайдаланылса, entityview өзінің тіл коды конфигурациясын нысандар тізімінен мұраға алады.

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

Loaded entity view {{ entityview.name }}.

{% endentitylist %}

searchindex

Веб-сайтта іздеу индексі бойынша сұрау орындалады. Сәйкес нәтижелерге кейін тег блогында қолжетімді іздеу индексі пайдалануға болады.

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

Әдепкі бойынша іздеу индексінің нысанына searchindex айнымалы атауы беріледі. Оған қоса, басқа айнымалы ат берілуі мүмкін.

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

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

...

{% endif %}

{% endsearchindex %}

Параметрлер

searchindex тегі келесі параметрлерді қабылдайды.

сұрау

Нәтижелерді сәйкестендіруге пайдаланылатын сұрау. Бұл параметр пайдаланушы көрсеткен индекс сұрауы бөлігін қабылдауға арналған (бар болғанда).

{% searchindex query: 'support' %}

...

{% endsearchindex %}

Жиі пайдаланылатын жағдай — осы параметрді request негізінде орнату.

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

Жиі пайдаланылатын жағдай — осы параметрді request негізінде орнату.

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

...

{% endsearchindex %}

бет_өлшемі

Қайтарылатын нәтиже бетінің өлшемі. Берілмеген болса, әдепкі өлшем 10 пайдаланылады.

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

...

{% endsearchindex %}

entityform

Пішінді атауы немесе идентификаторы бойынша толығымен көрсетеді.

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

Параметрлер

аты

Жүктеу керек негізгі пішін атауы.

{% entityform name:My Basic Form %}

webform

Көп сатылы пішінді атауы немесе идентификаторы бойынша толығымен көрсетеді. webform тегі веб-үлгі негізіндегі бет үлгісінде көрсетілетін мазмұнда пайдалануға ғана қолжетімді. Қайта жазуға негізделген бет үлгісінің ішіндегі тегті пайдалануға әрекеттену ештеңені көрсетпейді. Әр бет үшін тек бір нысан пішінін немесе веб-пішін тегін көрсете аласыз. Біріншіден кейінгі Entityform немесе веб-пішін тегтері көрсетілмейді.

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

Параметрлер

аты

Жүктеу керек көп сатылы пішін атауы.

{% webform name:My Multistep Form %}

код құрамдасы

Liquid тегін пайдаланып код құрамдастарын ендіруге мүмкіндік береді. Мысалы, веб-бетке карта дисплейінің реттелетін басқару элементін қосу.

Параметрлер

аты

Код компонентінің идентификаторы немесе аты.

мүлік

Код құрамдас бөлігі күтетін сипаттар мәндері қос нүкте (:) арқылы бөлінген кілт/мән жұбы ретінде берілуі керек, мұндағы кілт сипат атауы және мән JSON жолының мәні болып табылады.

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

Код құрамдастарының Liquid үлгі тегін пайдалану бөлімін қараңыз,

Сонымен қатар қараңыз

• Басқару ағынының тегтері
• Итерация тегтері
• Айнымалы тегтер
• Үлгі тегтері