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>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<a href={{ post.application_path }}#comments>
<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}
</a>
</div>
</li>
{% endfor %}
</ul>
</div>
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:
{{ 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
É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
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
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
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
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
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:
{{ 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
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
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
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 |
Webhivatkozások
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 %}
Webhivatkozások-készlet Attribútumai
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 }} |
Webhivatkozás Attribútumai
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 }} |
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 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.) |