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


Elérhető Liquid-objektumok

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.

Object Adatfolyam leírása
entitások Lehetővé teszi, hogy bármennyi Microsoft Dataverse-táblát töltsön be az azonosító szerint. További információk: 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: A portál webalkalmazása gyorsítótárazza ezt az értéket, és nem frissül minden alkalommal. További információk: 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 Dataverse-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 Dataverse kapcsolattartó rekord minden attribútumához. Ha nincs bejelentkezett felhasználó, ez a változó null. ... 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ók: webes hivatkozások
Webhely A portál Weblap rekordjára hivatkozik, hozzáférést biztosítva a Dataverse webhely (adx_website) rekord összes attribútumához a portálhoz. További információk: webhely

hirdetések

Lehetővé teszi a hirdetések lekérését és megjelenítését.

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 Adatfolyam leírása
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 Adatfolyam leírása
[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éselhelyezés olyan táblázatobjektum, amely ugyanazokkal az általános attribútumokkal és a következő attribútumokkal rendelkezik:

Attribútum Description
Hirdetések Visszaküldi az elhelyezéssel társított hirdetésobjektumok gyűjteményét. Iterációs címkék és tömbszűrők használhatók ezzel a gyűjteménnyel.
Name 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

Feljegyzés

A hirdetés egy táblaobjektum, amely a következőkön kívül ugyanazokkal az attribútumokkal rendelkezik:

Attribútum Description
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).
Name 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, amelyre a rendszer a hirdetés kiválasztásával átirányítja a felhasználót.

Hirdetéskép-attribútumok

Attribútum Adatfolyam leírása
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.
szélesség Visszaküldi a képhez tartozó szélességet pixelekben.

blogok

Lehetővé teszi a blogok és blogbejegyzések visszakeresését és 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 megszerzé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

Figyelmezteté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.

Feljegyzé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 Dataverse-táblát töltsön be az azonosító szerint. Ha a tábla létezik, a függvény egy táblaobjektumot ad vissza. Ha a megadott azonosítóval rendelkező tábla nem található, a rendszer null értéket ad vissza.

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

Az entitásobjektum hozzáférést biztosít egy Dataverse 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 Dataverse-tábla logikai neve.
Megjegyzések Betölti a táblázathoz társított jegyzeteket (jegyzet), a legrégebbitől a legújabbig (createdon) rendezve. 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 Pages 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. Ez általában csak bizonyos, a portál CMS-be integrált táblatípusok értékét adja vissza, kivéve, ha testre szabta az URL-szolgáltatót az alkalmazásban.
[attribútum vagy kapcsolat neve] Logikai név alapján a(z) Dataverse-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 egy kapcsolat reflexív (azaz önreferenciális), reflexív kapcsolatobjektumot ad vissza. (Ellenkező esetben egyértelmű lenne az eredmény.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Megjegyzés: Nagy számú kapcsolódó entitás betöltése vagy nagyszámú kapcsolatok elérése egyetlen sablonban negatív hatással lehet a sablon megjelenítési teljesítményére. 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 Dataverse logikai neve.
Name 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áblázatobjektumok összes attribútuma mellett a jegyzetek a következő további attribútumokkal rendelkeznek.

Attribútum Description
documentbody A megjegyzés annotation rekordja documentbody attribútumát Base64 kódolású karakterláncként tölti be. Mivel ennek az attribútumnak a tartalma nagy lehet, nem töltődik be a többi jegyzetattribútummal, csak igény szerint töltődik be.
Megjegyzés: A documentbody attribútum használata negatív hatással lehet a sablon megjelenítési teljesítményére, ezért körültekintően kell eljárni.
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ónak van engedélye, és a jegyzethez csatolt fájl is tartozik, az URL-címre küldött kérés letölti a jegyzetfájl mellékletét.

Feljegyzé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 Adatfolyam leírása
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 ezek az alapértelmezett eredmények explicit módon meghatározott engedélyek hiányában.

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 Adatfolyam leírása
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 Dataverse táblacímkékben használható. Egy adott lista összes attribútumához hozzáférést biztosít.

Attribútumok

Feljegyzés

Entitások

Attribútum Adatfolyam leírása
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 Dataverse-tábla logikai nevét a táblalista által megjelenítendő rekordokra vonatkozóan. Például kapcsolattartó
filter_account_attribute_name Visszaadja annak a partnerkeresésnek az attribútumlogikai nevét, amelyet az aktuális portálfelhasználó fölérendelt partner az eredményrekordok szűrésére használ. 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 Visszaadja a kapcsolattartóhoz való keresés attribútumlogikai nevét, amely az eredményrekordok aktuális portálfelhasználó kapcsolattartója szerinti szűrésére szolgál. Például: contactid
filter_website_attribute_name Visszaadja a keresés attribútumlogikai nevét adx_website, amelyet az aktuális portálwebhely az eredményrekordok szűrésére használ. Például: adx_websiteid
nyelvi_kód Visszaküldi a(z) Dataverse 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) Dataverse 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 Adatfolyam leírása
oszlop Visszaküldi a nézet oszlopait, mint a lista nézetoszlop-objektumai.
entity_logical_name Visszaküldi a Dataverse-tábla logikai nevét a nézetben szereplő rekordokra vonatkozóan. Például kapcsolattartó
Id Visszaküldi a nézet GUID azonosítóját.
nyelvi_kód A Dataverse nézet összes honosított címkéjének (oszlopfejlécek stb.) kiválasztásához használt egész nyelvi kódot adja eredményül.
Name Visszaküldi a nézet Dataverse megjelenítési nevét.
primary_key_logical_name Visszaküldi a Dataverse 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 Adatfolyam leírása
attribute_type Karakterláncként küldi vissza az oszlopra vonatkozó Dataverse-attribútumtípus nevét. Például: Lookup, Picklist, String, Boolean, DateTime
logical_name Visszaküldi az oszlopra vonatkozó Dataverse-attribútum logikai nevét. Például: createdon
Név szerint Visszaküldi az oszlopra vonatkozó honosított Dataverse 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) Dataverse-tábla logikai nevei. Például kapcsolattartó
first_page A nézeteredmények első oldalának oldalszáma. Ez 1, kivéve, ha nem adtak vissza eredményt, amely esetben null.
Id Az Dataverse-nézet GUID-azonosítója, amely meghatározza az entitásnézet értékét.
nyelvi_kód A(z) Dataverse 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 kapott eredményt, ez az érték null.
name A(z) Dataverse 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 nincs következő eredményoldal, ez az érték null.
Lap 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 nincs korábbi eredményoldal, akkor ez null.
primary_key_logical_name A nézet eredménytáblájának elsődleges kulcsattribútumának Dataverse-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ények lekérését és megjelenítését. 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 Description
alkalom után 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.
{% assign event = events["Event Name"] %}
{% assign event = events["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. Rendezheti az esemény-előfordulásokat, és megadhat egy dátumtartományt az előfordulások beolvasásához, valamint folyadékszűrők használatával oldalszámozást is elérhet:

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

A következő lehetőség is lehetséges:

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

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 attribútumok a következők:

Attribútum Description
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.

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

Hozam

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órumok és fórumszálak visszakeresését és megjelenítését. 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

Feljegyzés

Entitások

Attribútum Adatfolyam leírása
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.
Name 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

Feljegyzés

Entitások

Attribútum Adatfolyam leírása
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

Feljegyzés

Entitások

Attribútum Adatfolyam leírása
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 Dataverse 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 kombinálhatók más folyadékszű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 Description
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 kombinálhatók más folyadékszűrőkkel.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Attribútum Description
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 cikkely egy entitásobjektum , amely a következő attribútumokon kívül ugyanazokkal az attribútumokkal rendelkezik:

Attribútum Description
article_public_number A cikk nyilvános száma.
comment_count Annak a számnak az egész értéke, hogy hány megjegyzés van egy adott cikkhez.
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 értéke.

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ásobjektum , amely a következő attribútumokon kívül ugyanazokkal az attribútumokkal rendelkezik:

Attribútum Description
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.

napló

A készítők képesek naplóutasításokat beépíteni a Liquid kódjukba. Amikor a Power Pages webhely fut, a készítő által a Liquid-kódban hozzáadott naplók megjelennek a Power Pages fejlesztői eszköz bővítményében. Ezek a készítő által beágyazott naplók megjelennek a fejlesztői eszköz bővítményében, ha a diagnosztikai beállítás engedélyezve van.

A Liquid-kódban a következő szintaxis használható az egyéni üzenetek naplózásához:

{% log message:'Custom message' level:'Warning' %}

Naplóattribútumok

Attribútum Description
napló Folyékony objektum neve
üzenet A naplózandó egyéni üzeneteket jelölő karakterlánc
szint Naplózza az üzenetet információként, figyelmeztetésként vagy hibaként

Példa:

{% log message: 'Log from Home page' %}

{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}

{% assign contacts = query.results.entities %}

{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %} 
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}

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

Feljegyzés

Entitások

Attribútum Adatfolyam leírása
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 a lap a kezdőlap, szülő értéke null.
beosztás 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 Dataverse-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 egy kapcsolat reflexív (azaz önhivatkozó), a rendszer egy entitásobjektumot ad vissza. (Ellenkező esetben egyértelmű lenne az eredmény.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Megjegyzés: Nagy számú kapcsolódó entitás betöltése vagy nagyszámú kapcsolatok elérése egyetlen sablonban negatív hatással lehet a sablon megjelenítési teljesítményére. 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 elemet az entitásgyűjtemények betöltésére.

szavazások

Lehetővé teszi a szavazás lekérését és megjelenítését.

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 Adatfolyam leírása
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 Adatfolyam leírása
[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

Feljegyzés

Entitások

Attribútum Adatfolyam leírása
Name 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. Iterációs címkék és tömbszűrők használhatók 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

Feljegyzés

Entitások

Attribútum Adatfolyam leírása
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. Iterációs címkék és entitások használhatók 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 A felhasználó által kiválasztott polloption objektumot adja vissza (ha már szavazott).
szavazatok A szavazáshoz táblázatba foglalt szavazatok számát adja eredményül.

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

Feljegyzés

Entitások

Attribútum Adatfolyam leírása
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 A beállításhoz táblázatba foglalt szavazatok számát adja eredményül.

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>

Feljegyzé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 Pages kiadás 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.
Path 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 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 Adatfolyam leírása
approximate_total_hits Az index lekérdezés hozzávetőleges eredményét adja vissza. A keresési index biztonsági szűréssel és egyéb tervezési tényezőkkel kapcsolatos működése miatt ez a szám csak hozzávetőleges, és előfordulhat, hogy bizonyos helyzetekben nem egyezik meg pontosan az aktuális felhasználó számára elérhető eredmények teljes számával.
Lap 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 az aktuális oldalra vonatkozó eredmények tényleges számát szeretné megadni (mert ez kisebb lehet a megadott maximális oldalméretnél), 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 töredékeket, például az fuzzy lekérdezéseket (~) és a helyettesítő karakteres lekérdezéseket (*). Ez a tulajdonság ezekben az esetekben null értékű.
Id Az eredmények alárendelt rekordjainak a Dataverse-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 Dataverse-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 a találatok második oldalának első eredményénél, 10-es oldalmérettel, ez az érték 11.
pontszám Az eredmények Lucene pontszáma, lebegőpontos értékként. Az eredményeket a rendszer ezen érték szerint rendezve adja vissza.
beosztás 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.

Feljegyzé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ő HTML-kódot tartalmazhat.)
Entity Visszaadja a csomópont alárendelt entitások objektumait. Ha a csomópontnak nincs mögöttes táblája, ez az érték null.
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 a gyökércsomópont, szülő értéke null.
Title 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 sitejelölő létezik, a rendszer egy sitemarker objektumot ad vissza. Ha a megadott nevű webhelyjelölő nem található, a rendszer null értéket ad vissza.

{{ 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 Adatfolyam leírása
url-cím A cél helyjelző URL címe.
[attribútum logikai neve] Logikai név alapján a cél Dataverse-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 megadott nevű kódrészlet nem található, a rendszer null értéket ad vissza.

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

Feljegyzé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.

User

Az aktuális portálfelhasználóra hivatkozik, hozzáférést biztosítva az alárendelt Dataverse kapcsolattartó rekord minden attribútumához. Ha nincs bejelentkezett felhasználó, ez a változó null. ...

A felhasználó egy entitásobjektum .

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

Feljegyzés

A Power Pages kiadás 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: A szűrővel tesztelheti az has_role egyes szerepkörtagságokat is.
basic_badges_url A szolgáltatás URL-címet adja vissza a felhasználó jelvények beolvasására.
Ha jelvényeket szeretne megjeleníteni egy felhasználó számára, meg kell adnia egy címkét az "data-badge" és a "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

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

Ha a hivatkozáskészlet  létezik, a függvény a hivatkozáskészlet  objektumot ad vissza. Ha a megadott névvel vagy azonosítóval rendelkező hivatkozáskészlet  nem található, a rendszer 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 %}

Feljegyzés

A hivatkozáskészlet  egy entitásobjektum , amely a következő attribútumokon kívül ugyanazokkal az attribútumokkal rendelkezik:

Attribútum Description
Másolat 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 Dataverse-rekordjának bármely attribútumához hozzáférhet a logikai név által. Például: {{ weblinkset.createdon }}

Feljegyzés

A webhivatkozás egy entitásobjektum , amely a következő attribútumokon kívül ugyanazokkal az attribútumokkal rendelkezik:

Attribútum Description
Description 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.
Image Erre a hivatkozásra vonatkozó webhivatkozás képobjektuma. Ez az attribútum null értékű, ha nincs 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 Dataverse-rekordjának bármely attribútumához hozzáférhet a logikai név által. Például: {{ weblink.createdon }}
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 nem adott meg magasságértéket, ez az attribútum null.
url-cím A kép URL-címe.
Width A kép meghatározott szélességét tartalmazó egész szám. Ha nem adott meg szélességi értéket, ez az attribútum null.

Webhely

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

Feljegyzés

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

Kód

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

Hozam

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és (elkerüli a gyorsítótárazást): 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és (elkerüli a gyorsítótárazást): 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

Folyékony típusok
Folyékony címkék
Folyadékszűrők