Megosztás a következőn keresztül:


Elérhető Liquid-objektumok

Megjegyzés

  1. október 12-től a Power Apps-portálok a Power Pages nevet kapják. További információ: A Microsoft Power Pages már általánosan elérhető (blog)
    A Power Apps-portál dokumentációját hamarosan áttelepítjük és egyesítjük a Power Pages dokumentációjával.

Folyékony objektumok olyan attribútumokat tartalmaznak, amelyek dinamikus tartalmat küldenek a lapnak. Például az oldalobjektumnak van egy cím nevű attribútuma, amely az aktuális lap címének megjelenítéséhez használható.

Hogy név szerint hozzáférjen egy objektum-attribútumhoz használjon egy pontot (.). Egy objektum attribútumát úgy jelenítheti meg egy sablonban, ha a következők közé helyezi: {{ and }}.

Fontos

A webhelyközi parancsfájlhasználati (XSS) problémák elkerülése érdekében minden esetben használjon escape-szűrőt az adatok HTML kódolásához, valahányszor a Liquid-objektumokkal olvassa el a felhasználó által biztosított nem megbízható adatokat.

{{ page.title }}

Egy objektum attribútumai elérhetőek továbbá egy karakterlánc névvel és [] opcióval. Ez a formátum olyan esetekben hasznos, amikor a szükséges attribútum dinamikusan van meghatározva, vagy az attribútumnév olyan karaktereket, szóközöket, speciális karaktereket stb. tartalmaz, amelyek érvénytelenek lennének a pont (.) használatakor a szintaxison belül.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

A következő objektumok használhatóak és elérhetőek bárhol, bármely sablonban.

Objektum Ismertetés
entitások Lehetővé teszi, hogy bármennyi Power Apps-táblát töltsön be az azonosító szerint. További információ: entitások
most Egy dátum/idő objektum, amely az aktuális UTC időre hivatkozik, abban az időben, amikor a sablon megjelenik.
Megjegyzés: Ezt az értéket gyorsítótárba helyezi a Portál webalkalmazása, és nem frissíti minden alkalommal. További információ: Dátumszűrők
oldal Az aktuális portál lapkérésére hivatkozik. Az oldalobjektum hozzáférést biztosít olyan dolgokhoz, mint az adott laphoz a hivatkozáslánc, az aktuális laphoz tartozó cím vagy URL, és bármely egyéb attribútumhoz vagy az alárendelt Power Apps-rekordhoz kapcsolódó entitásokhoz. További információ: oldal
paraméterek A request.paraméterek kényelmes parancsikonja. További információ: kérés
kérés Az aktuális HTTP-kérelemről tartalmaz információt. További információ: kérés
beállítások Lehetővé teszi, hogy név szerint bármely webhelybeállítást betöltsön. További információ: beállítások
oldaltérkép Hozzáférést biztosít az oldaltérképhez. További információ: oldaltérkép
helyjelzők Lehetővé teszi, hogy név szerint bármely helyjelzőt betöltsön. További információ: helyjelzők
tartalomrészek Lehetővé teszi, hogy név szerint bármely tartalomrészt betöltsön. További információ: tartalomrészek
Felhasználó Az aktuális portálfelhasználóra hivatkozik, hozzáférést biztosítva az alárendelt Power Apps kapcsolattartó rekord minden attribútumához. Ha egy felhasználó sincs bejelentkezve, akkor ez a változó nulla. További információ: felhasználó
Webhivatkozások Lehetővé teszi, hogy név vagy azonosító szerint bármely webes hivatkozás-készletet betöltsön. További információ: webhivatkozások
Webhely A portál Weblap rekordjára hivatkozik, hozzáférést biztosítva a(z) Power Apps Weblap (adx_website) rekord összes attribútumához a portálhoz. További információ: webhely

hirdetések

Lehetővé teszi a hirdetésekhez való hozzáférést és az ábrázolásukat.

A hirdetések objektum lehetővé teszi, hogy kijelöljön egy adott hirdetést vagy hirdetéselhelyezést:

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

Hirdetések attribútumai

Attribútum Leírás
elhelyezések Visszaküld egy hirdetés-elhelyezések objektumot.
[hirdetés neve vagy azonosítója] Hozzáférhet bármelyik hirdetéshez a neve vagy azonosító tulajdonságai alapján.
{% assign ad = ads[Ad Name] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Hirdetés-elhelyezések attribútumai

Attribútum Leírás
[hirdetés elhelyezése vagy azonosítója] Hozzáférhet bármely elhelyezéshez a neve vagy azonosító tulajdonságai alapján.
{% assign placement = ads.placements[Placement Name or Id] %}
{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Hirdetés-elhelyezés attribútumai

A hirdetés elhelyezése egy olyan táblázatobjektum, amely ugyanazokkal az általános attribútumokkal és az alábbiakban felsorolt attribútumokkal rendelkezik.

Attribútum Ismertetés
Hirdetések Visszaküldi az elhelyezéssel társított hirdetésobjektumok gyűjteményét. Az Iterációs címkék és a Tömb szűrők lehetőséget használhatja ezzel a gyűjteménnyel.
Név szerint Visszaküldi a hirdetés-elhelyezés névmezőjét.
placement_url Az URL, amely használható, hogy lekérjen egy sablon által teljesen megjelenített hirdetés-elhelyezést.
random_url Az URL, amely használható, hogy lekérjen egy véletlenszerű hirdetést a sablon által teljesen megjelenített elhelyezésből.

Hirdetésattribútumok

Megjegyzés

A hirdetés egy táblaobjektum, ugyanazon attribútumokkal, továbbá az itt felsoroltakkal.

Attribútum Leírás
ad_url Az URL, amely használható, hogy lekérjen egy sablon által teljesen megjelenített hirdetést.
Másolás Visszaküldi a hirdetés Másolat mezőjét.
kép Visszaküldi a hirdetéshez tartozó képobjektumot (ha létezik).
Név szerint Visszaküldi a hirdetéshez tartozó Név mezőt.
open_in_new_window Igazat küld vissza, ha a redirect_url mezőben megadott URL-nek egy új ablakban kell megnyílnia.
redirect_url Az URL amire a felhasználó irányítva lesz, ha a hirdetést kiválasztva.

Hirdetéskép-attribútumok

Attribútum Leírás
alternate_text Visszaküldi a szöveget, amely a címke alt-attribútumában hivatott megjelenni.
height Visszaküldi a képhez tartozó magasságot pixelekben
URL-cím Visszaküldi a kép URL-forrását.
width Visszaküldi a képhez tartozó szélességet pixelekben.

blogok

Lehetővé teszi a Blogokhoz és Blogbejegyzésekhez való hozzáférést és azok megjelenítését.

A blogok objektum segítségével kiválaszthat adott blogot vagy blogbejegyzéseket.

{% assign posts = blogs.posts | paginate: 0,4 %}

<div class=content-panel panel panel-default>

<div class=panel-heading>

{% assign sitemarker = sitemarkers["Blog Home"] %}

{% assign snippet = snippets[Home Blog Activity Heading] %}

<a class=pull-right href={{sitemarker.url}}> All Blogs </a>

<h4>

<a class=feed-icon fa fa-rss-square href={{ blogs.feedpath }} />

{{ snippet.adx_value }}

</h4>

</div>

<ul class=list-group>

{% for post in posts.all %}

<li class=list-group-item >

<a class=user-avatar href={{ post.author_url }}>

<img src={{ post.user_image_url }} />

</a>

<h4 class=list-group-item-heading>

<a href={{ post.app_relative_path }}>{{ post.title }}</a>

</h4>

<div class=content-metadata>

<abbr class=timeago>{{ post.publish_date }}</abbr>

&ndash;

<a href={{ post.author_url }}> {{ post.author_name }} </a>

&ndash;

<a href={{ post.application_path }}#comments>

<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}

</a>

</div>

</li>

{% endfor %}

</ul>

</div>

blogok Objektum

A blogok objektum segítségével bármely bloghoz, illetve az összes blogbejegyzéshez hozzáférhet a portálban.

A következő táblázat bemutatja a blogok objektummal kapcsolatos attribútumokat.

Attribútum Leírás
bejegyzések Egy blogbejegyzések objektumot jelenít meg, amely a portálon található összes blogbejegyzést tartalmazza.
[blog neve vagy azonosítója] Hozzáférhet bármelyik bloghoz a neve vagy azonosító tulajdonságai alapján.
{% assign blog = blogs["Blog Name"] %}                             

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

blog Objektum

A blog objektum lehetővé teszi, hogy egyetlen bloggal kapcsolatos műveleteket végezzen, hozzáférést biztosítva az adott blog bejegyzéseihez.

A következő táblázat bemutatja a blog Objektummal kapcsolatos különféle attribútumokat.

Attribútum Leírás
bejegyzések Egy blogbejegyzés objektumot jelenít meg, amely az adott blog összes blogbejegyzését tartalmazza.
Név szerint A blog neve.
title A blog címe.
URL-cím A blog URL-címe.

blogbejegyzések Objektum

A blogbejegyzések objektum lehetővé teszi a blogbejegyzés objektumok egy gyűjteményéhez való hozzáférést. Elrendezheti a blogbejegyzéseket, elvégezheti a tördelést, továbbá használhat Liquid szűrőket:

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

Egyéb lehetséges beállítások:

  • blogs.posts.all (az összes blogbejegyzés lekéréséhez)
  • blogs.posts | from\_index: 0 | take: 2

A következő táblázat bemutatja a blogbejegyzések Objektummal kapcsolatos különféle attribútumokat.

Attribútum Leírás
Összes Visszaadja az összes blogbejegyzések objektumot a gyűjteményben.

blogbejegyzés Objektum

Egyetlen blogbejegyzésre hivatkozik.

A következő táblázat bemutatja a blogbejegyzés Objektummal kapcsolatos különféle attribútumokat.

Attribútum Ismertetés
url-cím A bejegyzés URL-címe.
tartalom Megjeleníti a bejegyzés Tartalom mezőjét.
szerző Megadja a bejegyzéshez tartozó szerzőket (amely egy egyszerű kapcsolattartó táblaobjektum).
beosztás A bejegyzés Címe.
comment_count Megadja egy adott bejegyzésre érkezett hozzászólások számát.
publish_date A bejegyzés közzétételének dátuma.

entitások

Figyelemfelhívás

A webhelyek közötti szkripteléssel (XSS) kapcsoltos problémák elkerülése érdekében minden esetben használjon escape-szűrőt az adatok HTML kódolásához, valahányszor a Liquid-objektum entitásokkal olvassa be a felhasználó által biztosított nem megbízható adatokat.

Megjegyzés

A Dataverse elnevezési konvencióinak egy része megváltozott, például a Dataverse entitásokat tábláknak hívják. A névváltozások nem vonatkoznak a Liquid-objektumokra. A Liquid entitások objektumra a továbbiakban is entitások néven hivatkozunk.

Lehetővé teszi, hogy bármennyi Power Apps-táblát töltsön be az azonosító szerint. Ha a tábla létezik, egy táblaobjektum lesz visszaadva. Ha egy tábla a megadott azonosítóval nem található, nulla lesz visszaküldve.

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

Egy entitás objektum hozzáférést biztosít egy Power Apps-táblarekord attribútumaihoz.

Attribútum Ismertetés
Azonosító A tábla GUID azonosítója karakterláncként. Például 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name A Power Apps-tábla logikai neve.
Megjegyzések Bármennyi táblával társított bejegyzést (annotation) betölt, a legrégebbitől a legújabbig rendezve (createdon). A megjegyzéseket Megjegyzés objektumként adják vissza.
engedélyeket A táblára vonatkozó Táblaengedély állítási eredményeket tölti be. A eredményeket engedély objektumként adják vissza.
URL-cím A táblára vonatkozó Power Apps portálok tartalomkezelő rendszerének URL-címének útját adja vissza. Ha az táblának nincs érvényes URL-címe az aktuális webhelyen, null értéket ad vissza. Általában ez csak bizonyos CMS portálra integrált táblatípusra vonatkozó értéket ad vissza , kivéve, ha testreszabták az URL-szolgáltatót az alkalmazásban.
[attribútum vagy kapcsolat neve] Logikai név alapján a(z) Power Apps-tábla bármelyik attribútumát elérheti. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
A táblaattribútumok legtöbb értéke közvetlenül a Liquid-típusok értékhez kapcsolódik: Két Beállítási mező térkép a Boolean-értékekhez, szövegmezők a karakterláncokhoz, numerikus/pénznem mezők a számokhoz, dátum/idő mezők a dátum objektumokhoz. De néhány attribútumtípust objektumként adnak vissza:
  • A Keresés (Társított táblareferencia) mezők társított táblázat-referenciaobjektumként lesznek visszaadva.
  • Az Értékkészletet/Választási listát értékkészlet érték objektumként adnak vissza.
  • A kapcsolati séma neve által bármennyi kapcsolódó entitást betölthet.
  • {{ page.adx_webpage_entitylist.adx_name }}Abban az esetben, ha a kapcsolat reflexív (azaz önhivatkozó), a reflexív kapcsolati objektum fog vissza térni. (Ellenkező esetben egyértelmű lenne az eredmény.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Megjegyzés: Nagyszámú kapcsolódó entitások betöltésekor vagy nagyszámú kapcsolat egyetlen sablonban történő elérésekor negatív hatást gyakorolnak a sablon rendelésénének teljesítményében. Kerülje a cikluson belül a tömbben lévő minden egyes elemére vonatkozó kapcsolódó entitás betöltését. Amennyiben lehetséges, inkább használja a Dataverse-táblacímkék értéket az entitásgyűjtemények betöltésére.

Társított táblareferencia

A keresési attribútum értékeit a társított tábla hivatkozási objektumaiként adják vissza az alábbi attribútumokkal együtt.

Attribútum Ismertetés
Azonosító A hivatkozott tábla GUID azonosítója karakterláncként.
Például 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name A hivatkozott tábla Power Apps logikai neve.
Adatfolyam neve A hivatkozott tábla elsődleges névattribútuma.

Feljegyzés

A megjegyzés egy olyan táblaobjektum, amely hozzáférést biztosít az attribútumokhoz és az annotationrekord kapcsolataihoz. A táblaobjektum összes attribútuma mellett, a megjegyzés az alábbi attribútumokkal is rendelkezik.

Attribútum Leírás
documentbody A megjegyzés annotation rekordja documentbody attribútumát Base64 kódolású karakterláncként tölti be. Az attribútum tartalmaként nagy lehet, amelyet a megjegyzés attribútumok többi részével nem töltenek be, csak igény szerint.
Megjegyzés: A documentbody attribútum használatának negatív hatásai lehetnek a sablon rendelési teljesítményére, és óvatosan kell elvégezni.
Használja az url attribútumot egy a megjegyzés mellékletre vonatkozó hivatkozás biztosításához, ha lehetséges.
URL-cím A beépített portál megjegyzés mellékletkezelőre vonatkozó URL-cím útvonalát adja vissza. Ha a felhasználó nem rendelkezik engedéllyel, és a megjegyzés egy csatolt fájl, akkor ezen URL-címre vonatkozó kérelem megjegyzés fájlmellékletet tölt le.

Megjegyzés

További szűrők

Értékkészlet értéke

Az Értékkészlet/Választási lista attribútum értéket a társított tábla hivatkozási objektumaként adják vissza az alábbi attribútumokkal együtt.

Attribútum Leírás
Felirat A z értékkészlet/választási lista attribútum értékének honosított címkéje. Például: aktív
Érték Az értékkészlet/választási lista attribútum értékének egész értéke. Például: 0

Táblaengedélyek

Az Táblaengedély objektum táblára vonatkozó összesített engedély állítás eredményekhez biztosít hozzáférést.

Attribútum Ismertetés
can_append Igaz értéket ad vissza, ha az aktuális felhasználónak van engedélye ezen rekord kapcsolataihoz rekordot hozzáfűzni. Ellenkező esetben hamis értéket ad vissza.
can_append_to Igaz értéket ad vissza, ha az aktuális felhasználónak van engedélye egy másik tábla kapcsolataihoz rekordot hozzáfűzni. Ellenkező esetben hamis értéket ad vissza.
can_create Igaz értéket ad vissza, ha az aktuális felhasználónak van engedélye ezen táblatípus új rekordjainak létrehozására. Ellenkező esetben hamis értéket ad vissza.
can_delete Igaz értéket ad vissza, ha az aktuális felhasználónak van engedélye a rekord törlésére. Ellenkező esetben hamis értéket ad vissza.
can_read Igaz értéket ad vissza, ha az aktuális felhasználónak van engedélye a rekord olvasására. Ellenkező esetben hamis értéket ad vissza.
can_write Igaz értéket ad vissza, ha az aktuális felhasználónak van engedélye a rekord frissítésére. Ellenkező esetben hamis értéket ad vissza.
rules_exist Igaz értéket ad vissza, ha az objektum által képviselt engedély eredménye az egyértelműen meghatározott engedély szabályok eredménye. Hamis értéket ad vissza, ha az explicit módon megadott engedélyek hiányában alapértelmezett eredmények.

Reflexív kapcsolat

Az alábbi attribútumokkal ellátott objektumokként próbálja meg betölteni az entitásokon a reflexív (azaz önhivatkozó) kapcsolatokat.

Attribútum Leírás
is_reflexive Igaz értéket ad vissza. Ha a kapcsolat által visszaküldött objektum egy reflexív kapcsolat objektuma felhasználható tesztelésre.
hivatkozott Az adott kapcsolatra vonatkozó hivatkozott entitások tömbjét adja vissza.
hivatkozó Az adott kapcsolatra vonatkozó hivatkozó táblát adja vissza. Null értéket ad vissza, ha nem létezik hivatkozó tábla. Több-a-többhöz (N:N) kapcsolat esetén a hivatkozó entitások tömbjét adják vissza.

Entitáslista

Az entitylist objektum a Power Apps Dataverse táblacímkékben használható. Egy adott lista összes attribútumához hozzáférést biztosít.

Attribútumok

Megjegyzés

entitások

Attribútum Leírás
create_enabled Igaz értéket ad vissza, ha az új rekordok létrehozása a lista számára konfigurálva van. Ellenkező esetben hamis értéket ad vissza.
create_url Visszatér a konfigurált URL-cím útvonal a listára vonatkozó hivatkozás/gomb létrehozása számára.
detail_enabled Igaz értéket ad vissza, ha az egyéni rekordok részletes nézete konfigurálva van a listára. Ellenkező esetben hamis értéket ad vissza.
detail_id_parameter Visszatér a rekord azonosítóhoz használható lekérdezési karakterlánc paraméterneve a rekord részletes nézetének URL-címének létrehozásakor. Lásd: URL-szűrők az URL-címek létrehozásához használó Liquid-szűrők részleteiért. Például: id
detail_label Visszatér a konfigurált honosított címke a listára vonatkozó részletes nézet hivatkozására/gombjára vonatkozóan.
detail_url Visszatér a konfigurált URL-cím útvonal a listára vonatkozó részletes nézet hivatkozására/gombjára vonatkozóan.
empty_list_text Visszatér a megjelenítendő konfigurált honosított szöveg a listanézet eredménytelen megjelenítenítésekor.
enable_entity_permissions Igaz értéket ad vissza, ha az entitáslistára vonatkozóan az Táblaengedély-szűrés engedélyezve van. Ellenkező esetben hamis értéket ad vissza.
entity_logical_name Visszaküldi az Power Apps-tábla logikai nevét a táblalista által megjelenítendő rekordokra vonatkozóan. Például kapcsolattartó
filter_account_attribute_name Visszaküldi az attribútum logikai nevét a fiókra történő keresés során, amelyet a jelenlegi portál felhasználó fölérendelt fiókja által történő eredményrekordok szűréséhez használnak. Például: accountid
filter_apply_label Visszaküldi a hivatkozáshoz/gombhoz használandó konfigurált honosított címkét, amely egy speciális attribútum szűrőt használt az táblalista eredményeihez.
filter_definition Visszaküldi a JSON attribútum szűrő definícióját az táblalistára vonatkozóan. Lásd: Lista-szűrők az információkért azzal kapcsolatban, hogy hogyan lehet a metaszűrők Liquid-szűrőt ezen meghatározás feldolgozásához használni.
filter_enabled Igaz értéket ad vissza, ha speciális attribútum szűrés engedélyezve van a lista számára. Ellenkező esetben hamis értéket ad vissza.
filter_portal_user_attribute_name Visszaküldi az attribútum logikai nevét a kapcsolattartóra történő keresés során, amelyet a jelenlegi portálfelhasználó kapcsolattartója által történő eredményrekordok szűréséhez használnak. Például: contactid
filter_website_attribute_name Visszaküldi az attribútum logikai nevét az adx_website történő keresésre vonatkozóan, amelyet a jelenlegi portál webhelye által történő eredményrekordok szűréséhez használnak. Például: adx_websiteid
language_code Visszaküldi a(z) Power Apps egész nyelvkódját, amelyet az összes honosított címke kiválasztásához használ a listára vonatkozóan.
page_size Visszaküldi a konfigurált eredmény oldal méretét a listára vonatkozóan.
primary_key_name Visszaküldi az elsődleges attribútum logikai nevét a lista által megjelenítendő rekordokra vonatkozóan.
search_enabled Igaz értéket ad vissza, ha a listára vonatkozóan az keresés engedélyezve van. Ellenkező esetben hamis értéket ad vissza.
search_placeholder Visszatér a konfigurált honosított szöveg a lista keresési mező helyőrzőjére vonatkozóan.
search_tooltip Visszatér a lista keresési eszközleírásaira vonatkozó konfigurált honosított szövege.
nézet Visszaküldi az entitáslistára vonatkozó elérhető nézetet a listanézet objektumaként.
[attribútum logikai neve] Hozzáférhet a lista (adx_entitylist) Power Apps rekordjának bármely attribútumához a logikai név használatával, azonos módon tábla objektumként. Például: {{ entitylist.adx_name }}

Listanézet attribútumok

Attribútum Ismertetés
oszlop Visszaküldi a nézet oszlopait, mint a lista nézetoszlop-objektumai.
entity_logical_name Visszaküldi a Power Apps-tábla logikai nevét a nézetben szereplő rekordokra vonatkozóan. Például kapcsolattartó
Azonosító Visszaküldi a nézet GUID azonosítóját.
language_code Visszaküldi a Power Apps egészérték-nyelvkódját, amelyet az összes honosított címke (oszlop, fejléc, stb.) kiválasztásához használ.
Név szerint Visszaküldi a nézet Power Apps megjelenítési nevét.
primary_key_logical_name Visszaküldi a Power Apps tábla elégséges kulcsának logikai nevét a nézetben szereplő rekordokra vonatkozóan. Például: contactid
sort_expression Visszaküldi a nézetre vonatkozó alapértelmezett rendezési kifejezését. Például: name ASC, createdon DESC.

Lista nézet oszlopának attribútumai

Attribútum Ismertetés
attribute_type Karakterláncként küldi vissza az oszlopra vonatkozó Power Apps-attribútumtípus nevét. Például: Lookup, Picklist, String, Boolean, DateTime
logical_name Visszaküldi az oszlopra vonatkozó Power Apps-attribútum logikai nevét. Például: createdon
Név szerint Visszaküldi az oszlopra vonatkozó honosított Power Apps megjelenítési nevét. Például: Created On
sort_ascending Növekvő sorrendben küldi vissza az oszlop rendezésére vonatkozó rendezési kifejezés karakterláncát. Például: createdon ASC
sort_descending Csökkenő sorrendben küldi vissza az oszlop rendezésére vonatkozó rendezési kifejezés karakterláncát. Például: createdon DESC
sort_disabled Igaz értéket küld vissza, ha a rendezés nem alkalmazható az oszlopra vonatkozóan. Ellenkező esetben hamis értéket ad vissza.
sort_enabled Igaz értéket küld vissza, ha a rendezés alkalmazható az oszlopra vonatkozóan. Ellenkező esetben hamis értéket ad vissza.
width Képpontokban küldi vissza az oszlopra vonatkozó konfigurált szélességet.

entitásnézet

Az entitásnézet objektumot az entitásnézet címkében használja a rendszer, és a nézet metaadataihoz, valamint a nézet eredményrekordjaihoz is hozzáférést biztosít.

Attribútumok

Attribútum Ismertetés
oszlop Visszaküldi az oszlopokat a nézetben, mint az táblanézet oszlopobjektumai.
entity_permission_denied Igaz értéket ad vissza, ha az eredmények megtekintéséhez a hozzáférést megtagadta a jelenlegi felhasználó számára a Táblajogosultságok hiánya miatt. Hamis értéket ad vissza, ha az eredmények megtekintéséhez a hozzáférést a rendszer megadta.
entity_logical_name A nézeteredmény-bejegyzések a(z) Power Apps-tábla logikai nevei. Például kapcsolattartó
first_page A nézeteredmények első oldalának oldalszáma. Ez 1 lesz, hacsak nem volt egyáltalán találat, ebben az esetben az érték null lesz.
Azonosító Az Power Apps-nézet GUID-azonosítója, amely meghatározza az entitásnézet értékét.
language_code A(z) Power Apps egész nyelvi kódja, amelyet a rendszer az aktuális nézet lokalizált címkéinek a betöltésére használ.
last_page A nézeteredmények utolsó oldalának oldalszáma. Ha nem volt találat, ez null érték lesz.
Név A(z) Power Apps nézet neve, amely meghatározza ezt az entitásnézetet, például Aktív kapcsolattartók.
next_page A nézeteredmények következő oldalának oldalszáma. Ha az eredményeknek nincs következő oldala, ez null érték lesz.
oldal A nézeteredmények aktuális oldalának oldalszáma.
oldalak Az oldalszámok egy tömbjét jelenít meg, amely tartalmazza az aktuális nézet összes eredményoldalát.
page_size Az aktuális nézet oldalankénti találatainak a száma.
previous_page A nézeteredmények következő oldalának oldalszáma. Ha az eredményeknek nincs előző oldala, ez null érték lesz.
primary_key_logical_name A nézet eredménytáblájának elsődleges kulcsattribútumának Power Apps-logikai neve. Például kapcsolattartó-azonosító.
rekord A nézet rekorderedményeinek az aktuális lapja táblaobjektumokként.
sort_expression A nézet alapértelmezett rendezési kifejezése. Például nameASC, createdon DESC.
total_pages A nézet eredményoldalainak a teljes száma.
total_records A nézet eredményeinek teljes száma (az összes oldalra vonatkozóan).

események

Lehetővé teszi az eseményekhez való hozzáférést és az ábrázolásukat. Az események objektum lehetővé teszi, hogy kijelöljön egy adott eseményt, vagy az összes eseményt.

események Objektum

Az események objektum lehetővé teszi, hogy hozzáférjen bármely adott eseményhez a portálon, vagy hozzáférjen az összes eseményhez portálon (az eseménytől függetlenül).

Az események objektum a következő tulajdonságokkal rendelkezik:

Attribútum Ismertetés
ismétlődések Egy esemény-előfordulási objektumot küld vissza, amely a portál minden esemény-előfordulását tartalmazza
[esemény neve vagy azonosítója] Hozzáférhet bármelyik eseményhez a neve vagy azonosító tulajdonságai alapján.
{% hozzárendelési esemény = események["Eseménynév"] %}
{% hozzárendelési esemény = események["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

esemény Objektum

Az eseményobjektum lehetővé teszi, hogy egyetlen eseménnyel kapcsolatos műveleteket végezzen, hozzáférést biztosítva ezen esemény ütemezéseihez és előfordulásaihoz.

Az esemény objektum a következő tulajdonságokkal rendelkezik:

Attribútum Ismertetés
alkalom után Egy esemény-előfordulási objektumot küld vissza, amely az esemény minden előfordulását tartalmazza.
Név Az esemény neve.
URL-cím Az esemény URL-je.

esemény-előfordulások Objektum

Az esemény-előfordulási objektum hozzáférést biztosít az esemény-előfordulási objektumok egy gyűjteményéhez. Rendszerezheti az esemény-előfordulásokat és megadhat egy dátumtartományt az előhívandó előfordulásokhoz, illetve elérheti a tördelést és használhat liquid-szűrőket

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

ne feledje

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

is lehetséges továbbá

A következő attribútumok vannak az esemény-előfordulási objektumhoz rendelve

Attribútum Leírás
Összes Visszaadja az összes esemény-előfordulási objektumot a gyűjteményben.

esemény-előfordulási Objektum

Egy esemény-előfordulást jelöl. A társított tulajdonságok az alábbiak:

Attribútum Leírás
URL-cím Az előfordulás URL-címe.
is_all_day_event Ez egy egész napos esemény?
start_time Az esemény kezdési ideje.
end_time Az esemény befejezésének ideje.

hurokhoz

Hasznos tulajdonságokat tartalmaz egy for hurokblokkon belül.

Megjegyzés

A forloop csak egy for címkében használható.

Kód

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

This is child page number {{ forloop.index }}.

{% endif %}

{% endfor %}

Kimenet

This is the first child page!

This is child page number 2.

This is child page number 3.

Attribútumok

Attribútum Leírás
első Igaz eredményt ad vissza, ha ez a hurok első iterációja. Hamis eredményt ad vissza, ha ez nem a hurok első iterációja.
index Az aktuális cikk pozíciója a gyűjteményben, ahol az első elem pozíciója 1.
index0 Az aktuális cikk pozíciója a gyűjteményben, ahol az első elem pozíciója 0.
utolsó Igaz eredményt ad vissza, ha ez a hurok utolsó iterációja. Hamis eredményt ad vissza, ha ez nem a hurok utolsó iterációja.
hossz Visszaadja a hurok iterációjainak számát ߝ az átiterált gyűjteményben szereplő cikkek számát.
rindex A hurokban hátralévő elemek száma (hossz – index) ahol 1 az utolsó elem indexe.
rindex0 A hurokban hátralévő elemek száma (hossz – index) ahol 0 az utolsó elem indexe.

fórumok

Lehetővé teszi a fórumokhoz és fórumhozzászólás-láncokhoz való hozzáférést és ábrázolást. A fórumadatok Liquiddel történő renderelése kiterjed a bejegyzésekre is, azonban egy új bejegyzés vagy hozzászóláslánc létrehozásához a beépített funkcióval rendelkező ASP.NET többlépéses űrlapok Lapsablonját kell használnia (mint például az alapértelmezett Fórum Hozzászóláslánc, illetve a Fórumbejegyzés Lapsablonokat).

A fórum objektum segítségével kijelölhet egy Fórumot vagy Fórumhozzászólás-láncot:

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

fórum Objektum

A fórum objektum lehetővé teszi a hozzáférést a portálon lévő bármelyik fórumhoz, illetve a portálon lévő összes fórumhoz (fórumtól függetlenül).

A fórum objektum lehetővé teszi a munkát egyetlen fórummal, illetve elérhetővé teszi a fórumhoz tartozó fórumhozzászólás-láncot.

A fórumhozzászólás-lánc objektum lehetővé teszi a hozzáférést a hozzászólás-lánc objektumok gyűjteményéhez. Rendezheti a fórumhozzászólás-láncokat, valamint tördelheti azokat a rugalmas szűrők segítségével.

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

Egyetlen Fórumhozzászólás-lánc

A fórumbejegyzés objektum lehetővé teszi a hozzáférést a fórumbejegyzés objektumok gyűjteményéhez.

Attribútumok

Attribútum Leírás
hozzászólásláncok Egy fórumhozzászóláslánc-objektumot jelenít meg, amely a portálon található összes fórumhozzászóláslánc-objektumot tartalmazza.
Összes Visszaadja az összes fórumobjektumot a portálon. Meg kell jegyezni, hogy a webhelyfórumok egyenértékűek ezekkel.
thread_count Visszaadja a hozzászólásláncok számát az egész weboldalra kiterjedően, egész értékben.
post_count Visszaadja a portálon található összes bejegyzés egész értékét.
[fórum neve vagy azonosítója] Hozzáférhet bármelyik fórumhoz a neve vagy azonosító tulajdonságai alapján.
`{% assign forum = forums[Forum Name] %}
{% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

fórum Objektum

Attribútumok

Megjegyzés

entitások

Attribútum Description
hozzászólásláncok Visszaad egy fórumhozzászóláslánc-objektumot, ami a fórumon lévő összes fórumhozzászólás-láncot tartalmazza.
Név szerint A Fórum Neve
thread_count Visszaadja a hozzászólásláncok értékét az egész fórumra kiterjedően egész értékben.
post_count Visszaadja a fórumhozzászólások egész értékét az egész fórumra kiterjedően.

fórumhozzászólás-lánc Objektum

Attribútumok

Attribútum Leírás
Összes Visszaadja az összes fórumhozzászóláslánc-objektumot a gyűjteményben.

fórum-hozzászóláslánc Objektum

Attribútumok

Megjegyzés

entitások

Attribútum Leírás
bejegyzések Visszaad egy fórumbejegyzés-objektumot, ami a fórum-hozzászólásláncban lévő összes fórumbejegyzést tartalmazza.
szerző Megadja a hozzászóláslánchoz tartozó szerzőt (amely egy egyszerű kapcsolattartó táblaobjektum).
latest_post Visszaadja a legfrissebb bejegyzést a fórumhozzászólás-láncban.
first_post Visszaadja a legelső bejegyzést a fórumhozzászólás-láncban.
post_count Visszaadja egész értékben, hogy hány bejegyzés van az adott fórumhozzászólás-láncban.
is_answered A fórumhozzászólás-lánc megválaszolt-e vagy sem?
is_sticky Kiemelt-e a fórumhozzászólás-lánc?

fórumbejegyzések Objektum

Attribútumok

Attribútum Leírás
Összes Visszaadja az összes fórumhozzászóláslánc-objektumot a gyűjteményben.

Egyetlen Fórumbejegyzés

Attribútumok

Megjegyzés

entitások

Attribútum Leírás
szerző Megadja a bejegyzéshez tartozó szerzőt (amely egy egyszerű kapcsolattartó táblaobjektum).
tartalom A bejegyzés tartalma.
is_answer Ez a bejegyzés a válasz a fórumhozzászólás-láncra?

tudás

Hozzáférést biztosít a Power Apps tudásbázis-cikkek és kategória táblarekordokhoz a cikkek és kategóriák portálon belüli megjelenítéséhez.

Attribútumok

Attribútum Leírás
cikkek Visszaad egy cikkobjektumot, amely objektumelemeket tartalmaz a portálon elérhető tudásbázis-cikk táblabejegyzésekhez.
kategóriák Visszaad egy kategóriaobjektumot, amely kategóriaobjektumokat tartalmaz a portálon elérhető kategória táblabejegyzésekhez.

cikkobjektum

A cikkobjektumok lehetővé teszik a hozzáférést a cikkobjektumok gyűjteményéhez. Rendezheti a cikkeket, valamint tördelheti azokat a rugalmas szűrők segítségével.

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

Attribútumok

Attribútum Leírás
népszerű Visszaad egy cikkobjektum-gyűjteményt, amely a legtöbb megtekintéssel rendelkezik. {% assign popular_articles = knowledge.articles.popular %}
legutóbbi Visszaad egy cikkobjektum-gyűjteményt, amely a legfrissebb módosítási dátummal rendelkezik. {% assign recent_articles = knowledge.articles.recent %}
felső Visszaad egy cikkobjektum-gyűjteményt, amely a legnagyobb értékeléssel rendelkezik. {% assign top_articles = knowledge.articles.top %}

Szűrők

Az alábbi szűrők csak opcionális paramétereket tud elfogadni az oldalméret és a nyelv tekintetében. Az első paraméter a beolvasására váró bejegyzések száma. Az alapértelmezett oldalméret 5. A második paraméter értéke az adott nyelv kódja cikkek beolvasásához a megadott nyelven. A szűrők összekapcsolhatók más Liquid szűrőkkel.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Attribútum Leírás
népszerű Visszaad egy cikkobjektum-gyűjteményt, amely a legtöbb megtekintéssel rendelkezik. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
legutóbbi Visszaad egy cikkobjektum-gyűjteményt, amely a legfrissebb módosítási dátummal rendelkezik. {% assign recent_articles = knowledge.articles \| recent: 5 %}
felső Visszaad egy cikkobjektum-gyűjteményt, amely a legnagyobb értékeléssel rendelkezik. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

kategóriaobjektumok

A kategóriaobjektumok lehetővé teszik a kategóriaobjektumok egy gyűjteményéhez való hozzáférést. Elrendezheti a kategóriákat, elvégezheti a tördelést, továbbá használhat Liquid szűrőket:

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

Attribútumok

Attribútum Leírás
legutóbbi Visszaad egy kategóriaobjektum-gyűjteményt, amely a legfrissebb módosítási dátummal rendelkezik.
top_level Visszaad egy kategóriaobjektum-gyűjteményt, amely nem rendelkezik fölérendelt kategóriával.

Szűrők

Az alábbi szűrők csak egy opcionális paramétert tudnak elfogadni, amely az oldalméretet jelzi. Az alapértelmezett oldalméret 5. A szűrők összekapcsolhatók más Liquid szűrőkkel.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Attribútum Leírás
legutóbbi Visszaad egy kategóriaobjektum-gyűjteményt, amely a legfrissebb módosítási dátummal rendelkezik. Megadhatja a paramétereket {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level Visszaad egy kategóriaobjektum-gyűjteményt, amely nem rendelkezik fölérendelt kategóriával. {% assign root_categories = knowledge.categories \| top_level %}

cikkobjektum

A cikkobjektum lehetővé teszi, hogy egyetlen tudásbázis-cikkel dolgozzon, amely megjeleníti a cikk részleteit a portálon.

Attribútumok

a cikk egy entitás objektum, ugyanazon attribútumokkal, továbbá az itt felsoroltakkal.

Attribútum Leírás
article_public_number A cikk nyilvános száma.
comment_count Az adott cikkre érkezett hozzászólások egész száma.
tartalom A cikk tartalma.
current_user_can_comment Visszaad egy logikai értéket, amely azt jelzi, hogy az aktuális felhasználó hozzáfűzhet-e megjegyzéseket a cikkhez, vagy nem.
is_rating_enabled Visszaad egy logikai értéket, amely azt jelzi, hogy engedélyezve van-e a minősítést egy cikk esetén, vagy nem.
kulcsszavak A cikk kulcsszavai.
Név A cikk címének egy másik elnevezése.
minősítés A cikk a decimális minősítési értéke.
title A cikk címe.
view_count A cikk megtekintéseinek egész száma.

kategóriaobjektum

A kategóriaobjektum lehetővé teszi, hogy egyetlen kategóriával dolgozzon, amely megjeleníti a részleteket a portálon.

Attribútumok

a kategória egy entitás objektum, ugyanazon attribútumokkal, továbbá az itt felsoroltakkal.

Attribútum Leírás
kategóriaszám A kategória kategóriaszáma.
Név A kategória címének egy másik elnevezése.
cím A kategória címe.

nyelv

Az aktuális nyelvnevet és a nyelvi kódot tartalmazza, ha engedélyezve van a többnyelvű támogatás.

Attribútumok

Attribútum Ismertetés
URL-cím Az aktuális kérelem URL-címét és az aktuális nyelvkód előtagot tartalmazza.
url_substitution Az aktuális kérelem URL-címét az aktuális nyelvkód előtaggal együtt tartalmazza, amely megkerüli az oldal kimeneti gyorsítótárát.
Név Az aktuális nyelv címe.
kód A nyelv nyelvkódja.

A Nyelvek legördülő listája websablon például alapértelmezés szerint ezt a rugalmas objektumot használja a rendelkezésre álló nyelvek felsorolásához, ha több nyelv áll rendelkezésre.

oldal

Az aktuális portál lapkérésére hivatkozik. Ez az objektum egyesíti a honlaptérkép attribútumait és az aktuális lekérdezési entitásokat (általában egy weboldal).

Az oldalobjektum hozzáférést biztosít olyan dolgokhoz, mint az adott laphoz a hivatkozáslánc, az aktuális laphoz tartozó cím vagy URL, és bármely egyéb attribútumhoz vagy az alárendelt Power Apps-rekordhoz kapcsolódó entitásokhoz.

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

Lap attribútumai

Megjegyzés

entitások

Attribútum Leírás
hivatkozásláncok Visszaadja az oldal hivatkozásláncának oldaltérképcsomópont-objektumait az oldaltérkép szülőcsomópontjától kezdődve a szülő csomópontig.
gyermek Visszaadja az oldal oldaltérkép-gyermekcsomópont objektumait.
szülő Visszaadja az oldal oldaltérkép-szülőcsomópont objektumait. Ha az oldal a Kezdőlap, a szülő null lesz.
title A lap címe.
URL-cím A lap URL-címe.
[attribútum vagy kapcsolat neve] Logikai név alapján a lap alárendelt Power Apps-rekordjának bármelyik attribútuma elérhető.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
A táblaattribútumok legtöbb értéke közvetlenül a Liquid-típusok értékhez kapcsolódik: Két Beállítási mező térkép a Boolean-értékekhez, szövegmezők a karakterláncokhoz, numerikus/pénznem mezők a számokhoz, dátum/idő mezők a dátum objektumokhoz. De néhány attribútumtípust objektumként adnak vissza:
  • A Keresés (Társított táblareferencia) mezők társított táblázat-referenciaobjektumként lesznek visszaadva.
  • Az Értékkészletet/Választási listát értékkészlet érték objektumként adnak vissza.
  • A kapcsolati séma neve által bármennyi kapcsolódó entitást betölthet.
    {{ page.adx_webpage_entitylist.adx_name }}
    Abban az esetben, ha a kapcsolat reflexív (azaz önhivatkozó), egy entitások objektumot ad vissza. (Ellenkező esetben egyértelmű lenne az eredmény.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Megjegyzés: Nagyszámú kapcsolódó entitások betöltésekor vagy nagyszámú kapcsolat egyetlen sablonban történő elérésekor negatív hatást gyakorolnak a sablon rendelésénének teljesítményében. Kerülje a cikluson belül a tömbben lévő minden egyes elemére vonatkozó kapcsolódó entitás betöltését. Amennyiben lehetséges, inkább használja a Power Apps Dataverse-táblacímkék elemet az entitásgyűjtemények betöltésére.

szavazások

Lehetővé teszi a szavazáshoz való hozzáférést és az ábrázolásukat.

A szavazások objektum lehetővé teszi, hogy kijelöljön egy adott szavazást, vagy a szavazás-elhelyezést:

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

Szavazásattribútumok

Attribútum Leírás
elhelyezések Visszaküldi a szavazás-elhelyezések objektumot.
[szavazás neve vagy azonosítója] Hozzáférhet bármelyik szavazáshoz a neve vagy azonosító tulajdonságai alapján. {% assign poll = polls[Poll Name] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Szavazáselhelyezés attribútumok

Attribútum Leírás
[szavazás elhelyezése vagy azonosítója] Hozzáférhet bármely szavazáselhelyezéshez a neve vagy azonosító tulajdonságai alapján.{% assign placement = polls.placements[Placement Name or Id] %}
{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Szavazáselhelyezés attribútumok

Megjegyzés

entitások

Attribútum Leírás
Név szerint Visszaküldi a szavazás-elhelyezés névmezőjét.
placement_url Az URL, amely arra használható, hogy lekérjen egy sablon által teljesen megjelenített szavazás-elhelyezést.
szavazások Visszaküldi az elhelyezéssel társított szavazásobjektumok gyűjteményét. Az Iterációs címkék és a Tömb szűrők lehetőséget használhatja ezzel a gyűjteménnyel.
random_url Az URL, amely arra használható, hogy lekérjen egy véletlenszerű szavazást a sablon által teljesen megjelenített elhelyezésből.
submit_url Az URL cím, ahova a kitöltött szavazások lesznek elküldve.

Szavazás-attribútumok

Megjegyzés

entitások

Attribútum Leírás
has_user_voted Igaz értéket ad vissza, ha a jelenlegi felhasználó (legyen az bejelentkezve, vagy anonim állapotban) már szavazott ezen a szavazáson.
Név szerint Visszaküldi a szavazás névmezőjét.
beállítások Visszaküldi az elhelyezéssel társított szavazásbeállítási objektumok gyűjteményét. Az Iterációs címkék és a Tömb szűrők lehetőséget használhatja ezzel a gyűjteménnyel.
poll_url Az URL, amely arra használható, hogy lekérjen egy sablon által teljesen megjelenített szavazást.
kérdés Visszaküldi a szavazás Kérdés mezőjét.
submit_button_label Visszaküld egy, a szavazás elküldés gombjának felülbírálására szolgáló karakterláncot.
submit_url Az URL cím, ahova a kitöltött szavazások lesznek elküldve.
user_selected_option Visszaküldi a felhasználó által választott szavazás-beállítás objektumot (ha már szavazott).
szavazatok Visszaküldi azon szavazatok számát, amelyek táblázatba lettek foglalva a szavazáshoz.

Szavazási beállítások attribútumai

Megjegyzés

entitások

Attribútum Leírás
válasz Visszaküldi a szavazás Válasz mezőjét.
százalék Visszaküldi a szavazatok százalékos számát, 0 és 100 közötti tizedes törtben.
szavazatok Visszaküldi azon szavazatok számát, amelyek táblázatba lettek foglalva a beállításhoz.

kérés

Az aktuális HTTP-kérelemről tartalmaz információt.

{% assign id = request.params['id'] | escape %}

<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>

Megjegyzés

  • A Liquid-ben dinamikus URL-ek képezhetők URL Szűrők használatával.
  • A request.url elemben használt URL-cím lehet tetszőleges kért érték, és cached eredményt kap a következő kérésekhez. A helyes érték biztosításához a request.url elemben, fontolja meg helyettesítő címke, részleges URL-cím, például ~{WebFile elérési útját} vagy a portál URL használatát a Webhelybeállításokban.
  • A Power Apps portálok 29.3.8.x vagy újabb verziója alapértelmezés szerint az escape liquid-szűrőt fogja kényszeríteni a felhasználó és a kérelem Liquid-objektumokra. Az alapértelmezett konfiguráció letiltásához és az ilyen Liquid-objektumok bővítmény szűrő nélkül való engedélyezéséhez tekintse meg a portálwebhely beállításait – Site/EnableDefaultHtmlEncoding.

Attribútumok

Attribútum Ismertetés
paraméterek Az aktuális kérelem megnevezett paraméter-értékei. A params az URL-lekérdezés paramétereinek, utóparamétereinek és sütijeinek kombinációja.
Útvonal Az aktuális URL-lekérdezés elérési útvonala.
/profile/
path_and_query Az aktuális URL-kérelem elérési útvonala és lekérdezése
/profile/?foo=1&bar=something
lekérdezés Az aktuális URL-kérelem lekérdezési része.
?foo=1&bar=something
URL-cím Az aktuális kérelem teljes URL-címe.
https://www.example.com/profile/?foo=1&bar=something

keresésindex

A keresésiindex-objektum lehetővé teszi a Power Apps Dataverse táblacímkék értéken belüli használatot, és hozzáférést ad a lekérdezés eredményeihez.

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

Attribútumok

Attribútum Leírás
approximate_total_hits Az index lekérdezés hozzávetőleges eredményét adja vissza. A keresési index a biztonsági szűrők és más tervezési tényezők miatt csak egy hozzávetőleges eredményt ad vissza, valamint néhány szituációban ez nem biztos, hogy az eredmények pontos száma lesz.
oldal Visszaadja az aktuális lekérdezés oldalszámát.
page_size Visszaadja az aktuális lekérdezés maximális oldal méretét. Ha azt szeretné, hogy a találatok tényleges száma jelenjen meg az aktuális oldalon (mivel ez lehet, hogy kevesebb, mint a megadott maximális méret) használja a results.size értéket.
eredmény Visszaadja keresésindex eredmény objektum formában a lekérdezés eredményének oldalát.

Keresési index eredményei

Attribútum Leírás
Entitás Az entitások az eredmény alapjául szolgálnak.
részlet Ez az eredményhez hozzákapcsolódó rövid szövegrészlet, olyan fogalmakkal, amik a megadott lekérdezéshez kapcsolódnak. Ez az <em> HTML-címkével van kiemelve. Bizonyos típusú lekérdezések nem támogatják a kiemelt részeket, mint például az intelligens lekérdezések (~) és a és a helyettesítő karakteres lekérdezések (*). Ez a tulajdonság NULL értékű lesz azokban az esetekben.
Azonosító Az eredmények alárendelt rekordjainak a Power Apps-táblához tartozó azonosítója karakterlánc lesz. Például 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Az eredmények alárendelt rekordjainak a Power Apps-tábla logikai neve. Például: adx_webpage
Szám Az eredmények száma minden oldalon az 1-től kezdődik. Például az eredmények második oldalán az első eredmény 11 lesz 10-es méretű oldal esetén.
pontszám Az eredmények Lucene pontszáma, lebegőpontos értékként. Az eredmények ezen érték szerint lesznek rendezve.
title Az eredmény címe.
URL-cím Az eredmény URL címe. Ez általában – de nem feltétlenül – a jelenlegi alkalmazás abszolút elérési útja, mint a teljes URL címe. Például: /articles/article1/

beállítások

Lehetővé teszi, hogy név szerint bármely webhelybeállítást betöltsön. Ha egy beállítás a megadott néven nem található, nulla lesz visszaküldve.

Megjegyzés

A beállítások karakterláncok formátumban kerülnek visszaküldésre, de használhatja a Típusszűrők elemet, hogy egyéb típusba konvertálja őket.

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

oldaltérkép

Hozzáférést biztosít az oldaltérképhez.

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

Oldaltérkép attribútumai

Attribútum Leírás
Aktuális Az aktuális oldalra visszaadja az oldaltérkép-csomópontot.
Gyökér Visszaadja az oldaltérkép-csomópont objektumot a honlap gyökéroldalára (kezdőoldalára).

Oldaltérkép-csomópont attribútumai

Attribútum Leírás
Hivatkozáslánc Visszaadja a csomópont hivatkozásláncának oldaltérképcsomópont-objektumait az oldaltérkép szülőcsomópontjától kezdődve a szülő csomópontig.
Gyermekek Visszaadja a csomópont oldaltérkép-gyermekcsomópont objektumait.
Leírás A csomópont leírás/összegzés tartalma. (Ez a mező tartalmazhat HTML-t.)
Entitás Visszaadja a csomópont alárendelt entitások objektumait. Ha a csomópontnak nincs alárendelt táblája, ez az érték null lesz.
is_sitemap_ancestor Igaz értéket ad vissza, ha az oldaltérkép-csomópont a jelenlegi csomópont szülője, egyébként hamis értéket ad vissza.
is_sitemap_current Igaz értéket ad vissza, ha az oldaltérkép-csomópont a jelenlegi csomópont, egyébként hamis értéket ad vissza.
Szülő Visszaadja a csomópont oldaltérkép-szülőcsomópont objektumait. Ha a csomópont szülő, akkor null lesz.
Munkakör A csomópont címe.
URL-cím A csomópont URL-je.

helyjelzők

Lehetővé teszi, hogy név szerint betöltse bármely helyjelzőt. Ha a helyjelző létezik, egy helyjelző elem lesz visszaadva. Ha egy helyjelző a megadott néven nem található, nulla lesz visszaküldve.

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

Helyjelző-attribútumok

Attribútum Leírás
URL-cím A cél helyjelző URL címe.
[attribútum logikai neve] Logikai név alapján a cél Power Apps-rekord helyjelzőjének bármelyik attribútuma elérhető. Például: {{ sitemarker.adx_name }}

tartalomrészek

Engedélyezi, hogy név által bármely tartalomrészt betöltse. Ha a névvel megadott tartalomrészlet nem található, null érték jelenik meg.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Hasznos tulajdonságokat tartalmaz egy Iterációs címkék hurokblokkon belül.

Megjegyzés

A forloop csak egy Iterációs címkék címkében használható.

Attribútumok

Attribútum Leírás
Col Visszaküldi az aktuális sor indexét az 1 elemmel kezdve.
col0 Visszaküldi az aktuális sor indexét a 0 elemmel kezdve.
col_first Igaz értéket ad vissza, ha az aktuális oszlop az első oszlop, hamis értéket ad vissza, ha nem.
col_last Igaz értéket ad vissza, ha az aktuális oszlop az utolsó oszlop, hamis értéket ad vissza, ha nem.
Első Igaz eredményt ad vissza, ha ez a hurok első iterációja. Hamis eredményt ad vissza, ha ez nem a hurok első iterációja.
Index Az aktuális cikk pozíciója a gyűjteményben, ahol az első elem pozíciója 1.
index0 Az aktuális cikk pozíciója a gyűjteményben, ahol az első elem pozíciója 0.
utolsó Igaz eredményt ad vissza, ha ez a hurok utolsó iterációja. Hamis eredményt ad vissza, ha ez nem a hurok utolsó iterációja.
Hossz Visszaadja a hurok iterációjainak számát ߝ az átiterált gyűjteményben szereplő cikkek számát.
Rindex A hurokban hátralévő elemek száma (hossz – index) ahol 1 az utolsó elem indexe.
rindex0 A hurokban hátralévő elemek száma (hossz – index) ahol 0 az utolsó elem indexe.

Felhasználó

Az aktuális portálfelhasználóra hivatkozik, hozzáférést biztosítva az alárendelt Power Apps kapcsolattartó rekord minden attribútumához. Ha egy felhasználó sincs bejelentkezve, akkor ez a változó nulla.

A felhasználó egy entitás objektum.

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

Megjegyzés

A Power Apps portálok 29.3.8.x vagy újabb verziója alapértelmezés szerint az escape liquid-szűrőt fogja kényszeríteni a felhasználó és a kérelem Liquid-objektumokra. Az alapértelmezett konfiguráció letiltásához és az ilyen Liquid-objektumok bővítmény szűrő nélkül való engedélyezéséhez tekintse meg a portálwebhely beállításait – Site/EnableDefaultHtmlEncoding.

Attribútumok

Az entitások összes attribútuma mellett a felhasználó az alábbi attribútumokkal is rendelkezik.

Attribútum Leírás
szerepkörök A szerepköröket adja vissza, melynek a felhasználó tagja, mint egy tömb.
{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}
Megjegyzés:: használhatja a has_role szűrőt egyedi szerepkörök teszteléséhez.
basic_badges_url A szolgáltatás URL-címet adja vissza a felhasználó jelvények beolvasására.
Felhasználó jelvények megjelenítéséhez meg kell adni egy címkét a „data-badge” és „data-uri” attribútumokkal. Az aktuális felhasználó jelvényeinek megjelenítéséhez:
<div data-badge data-uri='{{user.basic_badges_url }}'></div>
A felhasználó jelvények megjelenítése azonosító szerint (változó felhasználói azonosító):
`<div data-badge data-uri='{{user.basic_badges_url

Webhivatkozások

Lehetővé teszi, hogy név vagy azonosító szerint betöltsön bármely webhivatkozások elemet.

Ha van webhivatkozás-készlet a webhivatkozás-készlet objektuma visszatér. Ha a névvel vagy azonosítóval megadott webhivatkozás-készlet nem található, null értéket ad vissza.

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

Webhivatkozások-készlet Attribútumai

Megjegyzés

a webhivatkozás-készlet egy entitás objektum, ugyanazon attribútumokkal, továbbá az itt felsoroltakkal.

Attribútum Leírás
Másolás A webhivatkozás-készlet HTML másolata.
Név szerint A webhivatkozás-készlet neve.
Munkakör A webhivatkozás-készlet címe.
Webhivatkozások A webhivatkozás-készlettel van társítva a webhivatkozás objektumainak tömbje.
[attribútum logikai neve] A webhivatkozás-készlet Power Apps-rekordjának bármely attribútumához hozzáférhet a logikai név által. Például: {{ weblinkset.createdon }}

Webhivatkozás Attribútumai

Megjegyzés

a webhivatkozás egy entitás objektum, ugyanazon attribútumokkal, továbbá az itt felsoroltakkal.

Attribútum Leírás
Leírás A webhivatkozás-készlet HTML leírása.
display_image_only A logikai attribútum jelzi, hogy a webhivatkozás csak képként jelenjen-e meg, hivatkozási szöveg nélkül.
display_page_child_links Logikai attribútum jelzi, hogy részleges hivatkozásként mutassa-e a webhivatkozás a hivatkozott oldal oldaltérképének alárendelt oldalaira vonatkozó hivatkozásait.
Kép Erre a hivatkozásra vonatkozó webhivatkozás képobjektuma. Ez az attribútum nulla, ha nem található kép.
is_external A locikai attribútum jelzi, hogy a webhivatkozás URL-címe külső telephelyre hivatkozik-e (vagy inkább egy belső portál oldalra).
is_sitemap_ancestor Igaz értéket ad vissza, ha a webhivatkozás URL-címe a jelenlegi telephelytérkép csomópontjának elődjére hivatkozik, ellenkező esetben hamis értéket ad vissza.
is_sitemap_current Igaz értéket ad vissza, ha a webhivatkozás URL-címe a jelenlegi telephelytérkép csomópontjára hivatkozik, ellenkező esetben hamis értéket ad vissza.
Név szerint A webhivatkozás-készlet neve/címe.
Nofollow A logikai attribútum jelzi, hogy a webhivatkozás mint rel=nofollow van-e bejelölve.
open_in_new_window Logikai attribútum jelzi, hogy a webhivatkozást az új böngésző ablakban/lapon kell-e megnyitni a kiválasztáskor.
Eszközleírás A webhivatkozásra vonatkozó eszközleírás szövege.
URL-cím A webhivatkozás URL-címe.
Webhivatkozások A webhivatkozással van társítva az alárendelt webhivatkozás objektumainak tömbje.
[attribútum logikai neve] A webhivatkozás Power Apps-rekordjának bármely attribútumához hozzáférhet a logikai név által. Például: {{ weblink.createdon }}

Webhivatkozások képattribútumai

alternate_text A képre vonatkozó másodlagos szöveg.
Magasság A kép meghatározott magasságát tartalmazó egész szám. Ha nincs megadva magasságérték, ez az attribútum üres lesz.
URL-cím A kép URL-címe.
Szélesség A kép meghatározott szélességét tartalmazó egész szám. Ha nincs megadva szélességérték, ez az attribútum üres lesz.

Webhely

A portál webhely rekordjára hivatkozik, hozzáférést biztosítva a Power Apps Weblap (adx_website) rekord összes attribútumához a portálhoz.

Megjegyzés

A webhely egy entitás objektum, az összes ugyanolyan attribútummal.

Kód

{{ website.adx_name }} ({{ website.id }})

Kimeneti

Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)

Attribútumok

A következő táblázat a címke attribútumait sorolja fel, amelyek az alapértelmezett értékek lecserélésére használhatók a gyorsítótárazás elkerüléséhez.

Alapértelmezett Helyettesítő (kerüli a gyorsítótárazást) Példa
sign_in_url sign_in_url_substitution Alapértelmezés: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F
Helyettesítő (a gyorsítótárazás elkerülése): website.sign_in_url_substitution /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F
(a „substitute-page” ebben a példában felváltja az alapértelmezett gyorsítótárazott URL-címet.)
sign_out_url sign_out_url_substitution Alapértelmezés: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F
Helyettesítő (a gyorsítótárazás elkerülése): website.sign_out_url_substitution /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F
(a „substitute-page” ebben a példában felváltja az alapértelmezett gyorsítótárazott URL-címet.)

Kapcsolódó információk

Liquid-típusok
Liquid-címkék
Liquid-szűrők

Megjegyzés

Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)

A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).