Obiecte Liquid disponibile
Obiectele Liquid conțin atributele pentru a reda conținut dinamic în pagină. De exemplu, obiectul pagină are un atribut numit titlu, care poate fi folosit pentru a afișa titlul paginii curente.
Pentru a accesa atributul unui obiect după nume, utilizați un punct (.). Pentru a reda atributul unui obiect întrun șablon, încadrați-l în {{ and }}.
Important
Pentru a evita potențialele probleme de scriptare între site-uri (XSS), utilizați întotdeauna filtrul escape pentru a codifica datele HTML ori de câte ori se utilizează obiecte Liquid pentru a citi date lipsite de încredere furnizate de utilizator.
{{ page.title }}
Atributele unui obiect pot fi accesate și folosind un nume de șir și []. Acest format este util în cazul în care atributul necesar este determinat în mod dinamic sau numele atributului conține caractere, spații, caractere speciale și așa mai departe, care ar fi nevalide atunci când se utilizează un punct (.) în interiorul sintaxei.
{{ page[title] }}
{% assign attribute_name = Name with spaces %}
{{ object[attribute_name] }}
Următoarele obiecte pot fi utilizate și accesate de oriunde, în orice șablon.
Obiect | Descriere |
---|---|
entități | Vă permite să încărcați orice tabel Microsoft Dataverse după ID. Informații suplimentare: entități |
acum | Un obiect dată/oră care se referă la ora UTC curentă, în momentul redării șablonului. Notă: aplicația web portal memorează această valoare în cache și nu este reîmprospătată de fiecare dată. Informații suplimentare: Filtre de date |
pagină | Se referă la pagina de solicitare a portalului curent. Obiectul page oferă acces la lucruri cum ar fi fragmente pentru pagina curentă, titlul sau URL-ul paginii curente și orice alte atribute sau entități corelate ale înregistrării Dataverse subiacente. Informații suplimentare: pagină |
params | O comandă rapidă convenabilă pentru request.params. Informații suplimentare: solicitare |
solicitare | Conține informații despre solicitarea HTTP curentă. Informații suplimentare: solicitare |
setări | Vă permite să încărcați orice Setare de site după nume. Informații suplimentare: setări |
hartă site | Permite accesul la harta de site a portalului. Informații suplimentare: hartă site |
markeri de site | Vă permite să încărcați orice marker de site după nume. Informații suplimentare: markere de site |
fragmente | Vă permite să încărcați orice Fragment de conținut după nume. Informații suplimentare: fragmente |
utilizator | Se referă la utilizatorul curent al portalului, oferind acces la toate atributele înregistrării persoană de contact Dataverse subiacente. Dacă niciun utilizator nu este conectat, această variabilă este nulă. Informații suplimentare: utilizator |
linkuri web | Vă permite să încărcați orice set de linkuri web după nume sau ID. Informații suplimentare: linkuri web |
site web | Se referă la înregistrarea site-ului web de portal, care permite accesul la toate atributele înregistrării de site web (adxwebsite) Dataverse pentru portal. Informații suplimentare: site web |
reclame
Permite preluarea și afișarea unui anunț.
Obiectul ads vă permite să selectați o reclamă specifică sau o plasare de reclamă.
<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>
Atribute pentru reclame
Atribut | Descriere |
---|---|
amplasări | Întoarce obiectul adplacements. |
[ad name or id] | Puteți accesa orice reclamă după numele său sau după proprietățile de identitate. {% assign ad = ads[Ad Name] %} {% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Atributele amplasărilor de reclame
Atribut | Descriere |
---|---|
[ad placement name or id] | Puteți accesa orice amplasare de reclamă după numele său sau după proprietățile de identitate.{% assign placement = ads.placements[Placement Name or Id] %} {% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %} |
Atributele amplasării de reclame
O destinație de plasare a anunțului este un obiect tabel cu aceleași atribute generale și cu următoarele atribute:
Atribut | Descriere |
---|---|
Reclame | Returnează colecția de obiecte de tip reclamă asociate cu amplasarea. Etichetele de iterație și filtrele de matrice pot fi utilizate cu această colecție. |
Nume | Returnează câmpul Nume pentru amplasarea reclamei. |
placement_url | URL-ul care poate fi folosit pentru a regăsi amplasarea reclamei, redat complet de un șablon. |
random_url | URL-ul care poate fi folosit pentru a regăsi o reclamă aleatoare din amplasare, redat complet de un șablon. |
Atribute de reclame
Notă
Un anunț este un obiect tabel, cu toate aceleași atribute în plus față de următoarele:
Atribut | Descriere |
---|---|
ad_url | URL-ul care poate fi folosit pentru a regăsi reclama, redat complet de un șablon. |
Copiere | Returnează câmpul Copiere pentru reclamă. |
image | Întoarce imaginea obiectului (dacă există) pentru reclamă. |
Nume | Returnează câmpul Nume pentru reclamă. |
open_in_new_window | Returnează adevărat dacă URL-ul specificat de redirect_url ar trebui să deschidă o fereastră nouă. |
redirect_url | Adresa URL către care este direcționat utilizatorul prin selectarea anunțului. |
Atributele imaginii Reclamă
Atribut | Descriere |
---|---|
alternate_text | Returnează textul care urmează să apară în atributul alt al etichetei. |
înălțime | Returnează înălțimea în pixeli pentru imagine |
URL | Returnează sursă URL pentru imagine. |
lățime | Returnează lățimea în pixeli pentru imagine |
bloguri
Permite preluarea și afișarea blogurilor și a postărilor de blog.
Obiectul blogs vă permite să selectați un blog specific sau o publicare de blog.
{% 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>
Obiectul bloguri
Obiectul bloguri vă permite să accesați orice blog specific din portal sau să accesați toate postările de blog din portal.
Tabelul următor explică atributele asociate cu obiectul blogs.
Atribut | Descriere |
---|---|
postări | Întoarce un obiect blogposts care conține toate postările de blog din portal. |
[blog name or id] | Puteți accesa orice blog după numele său sau după proprietățile de identitate. |
{% assign blog = blogs["Blog Name"] %}
{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Obiectul blog
Obiectul blog vă permite să lucrați cu un singur blog, permițându-vă să accesați publicări pentru acel blog.
Tabelul următor explică diverse atribute asociate cu obiectul blog.
Atribut | Descriere |
---|---|
postări | Întoarce un obiect blogposts care conține toate postările de blog pentru blog. |
Nume | Numele blogului. |
titlu | Titlul blogului. |
URL | Adresa URL a blogului. |
Obiectul blogposts
Obiectul blogposts vă permite să accesați o colecție de obiecte pentru publicarea pe blog. Puteți ordona publicările pe blog și realiza paginarea, precum și utiliza filtrele lichide:
{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}
Alte opțiuni posibile:
blogs.posts.all
(pentru a obține toate postările de pe blog)blogs.posts | from\_index: 0 | take: 2
Tabelul următor explică diverse atribute asociate cu obiectul blogposts.
Atribut | Descriere |
---|---|
Toate | Returnează toate obiectele blogpost din colecție. |
Obiectul blogpost
Se referă la o singură publicare de blog.
Tabelul următor explică diverse atribute asociate cu obiectul blogpost.
Atribut | Descriere |
---|---|
URL | Adresa URL a publicării. |
conținut | Returnează câmpul Conținut pentru publicare. |
author | Returnează autorii pentru publicare (care este pur și simplu un obiect de tabel persoană de contact). |
Funcția | Titlul publicării. |
comment_count | Returnează valoarea număr întreg a numărului de comentarii existente pentru o anumită publicare. |
publish_date | Data la care a fost publicat postul. |
entități
Atenție
Pentru a evita potențialele probleme de scriptare între site-uri (XSS), utilizați întotdeauna filtrul escape pentru a codifica datele șir ori de câte ori se utilizează entități obiect Liquid pentru a citi date furnizate de utilizator care nu sunt de încredere.
Notă
Unele dintre convențiile de denumire ale Dataverse s-au schimbat, de exemplu, entitățile Dataverse se numesc acum tabele. Schimbările de nume nu se aplică obiectelor Liquid. Obiectul entităților Liquid va continua să fie denumit entități.
Vă permite să încărcați orice tabel Dataverse după ID. Dacă tabelul există, este returnat un obiect tabel. Dacă nu este găsit un tabel cu ID-ul dat, se returnează null .
{% 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
Un obiect entitate oferă acces la atributele unei Dataverse înregistrări de tabel.
Atribut | Descriere |
---|---|
Id | ID-ul GUID al tabelului, ca șir. De exemplu, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
logical_name | Numele Dataverse logic al tabelului. |
Note | Încarcă toate notele (adnotare) asociate tabelului, ordonate de la cel mai vechi la cel mai nou (createdon ). Notele sunt returnate ca obiecte notă. |
permisiuni | Încarcă rezultatele aserțiunii de permisiune tabel pentru tabel. Rezultatele sunt returnate ca un obiect permisiuni. |
URL | Returnează calea URL din sistemul de management al conținutului de Power Pages pentru tabel. Dacă tabelul nu are niciun URL valid în site-ul curent, returnează null. În general, aceasta returnează doar o valoare pentru anumite tipuri de tabele care au fost integrate în CMS-ul portalului, cu excepția cazului în care ați personalizat furnizorul de adrese URL în aplicația dvs. |
[attribute or relationship name] | Puteți accesa orice atribut al tabelului Dataverse după numele logic. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Valorile celor mai multe atribute de tabel se mapează direct la Tipuri Liquid: Două Câmpuri de opțiune se mapează la valori Boolene, câmpurile text la șiruri de caractere, câmpurile numerice/monedă la valori numerice, câmpurile dată/oră la obiecte de tip dată. Dar unele tipuri de atribute sunt returnate ca obiecte:
{{ page.adx_webpage_entitylist.adx_name }} În cazul în care o relație este reflexivă (adică autoreferențială), un obiect de relație reflexiv este returnat. (Altfel, rezultatul ar fi ambiguu.){{ page.adx_webpage_webpage.referencing.adx_name }} Notă: încărcarea unui număr mare de entități asociate sau accesarea unui număr mare de relații într-un singur șablon poate avea un impact negativ asupra performanței de redare a șablonului. Evitați încărcarea entităților corelate pentru fiecare element dintr-o matrice, într-o buclă. Acolo unde este posibil, utilizați etichetele de tabel Dataverse pentru a încărca colecții de entități. |
Referință tabel asociat
Valorile atributului de căutare sunt returnate ca obiecte de referință la tabel asociat, cu următoarele atribute.
Atribut | Descriere |
---|---|
Id | ID-ul GUID al tabelului referință, ca șir. De exemplu, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
logical_name | Nume logic Dataverse al tabelului de referință. |
Nume | Atributul nume principal al tabelului de referință. |
Notă
O notă este un obiect de tabel care oferă acces la atributele și relațiile unei înregistrări annotation. Pe lângă toate atributele unui obiect tabel, o notă are următoarele atribute suplimentare.
Atribut | Descriere |
---|---|
documentbody | Încarcă atributul documentbody al înregistrării annotation a notei, ca un șir codificat Base64. Deoarece conținutul acestui atribut poate fi mare, acesta nu este încărcat cu restul atributelor notei, este încărcat doar la cerere. Notă: utilizarea atributului documentbody ar putea avea un efect negativ asupra performanței de redare a șablonului și trebuie făcută cu prudență. Utilizați atributul url pentru a oferi un link către atașare notei în schimb, dacă este posibil. |
URL | Întoarce calea URL pentru handlerul atașării la adnotarea integrată în portal. Dacă utilizatorul are permisiunea și nota are un fișier atașat, o solicitare la această adresă URL descarcă atașamentul fișierului notă. |
Notă
Valoare set opțiuni
Valorile atributului Set de opțiuni/listă verticală sunt returnate ca obiecte de referință la tabelul asociat, cu următoarele atribute.
Atribut | Descriere |
---|---|
Etichetă | Valoarea localizată a valorii atributului set de opțiuni/listă verticală. De exemplu, Activ |
Valoare | Valoarea întreagă a valorii atributului set de opțiuni/listă verticală. De exemplu, 0 |
Permisiuni tabel
Obiectul permisiuni de tabel oferă acces la rezultatele aserțiunii de permisiuni agregate pentru un tabel.
Atribut | Descriere |
---|---|
can_append | Returnează true dacă utilizatorul curent are permisiunea de a adăuga înregistrări la relațiile acestei înregistrări. În caz contrar, returnează false. |
can_append_to | Returnează true dacă utilizatorul curent are permisiunea de a adăuga această înregistrare la o relație a altui tabel. În caz contrar, returnează false. |
can_create | Returnează true dacă utilizatorul curent are permisiunea de a crea înregistrări noi cu acest tip de tabel. În caz contrar, returnează false. |
can_delete | Returnează true dacă utilizatorul curent are permisiunea de a șterge această înregistrare. În caz contrar, returnează false. |
can_read | Returnează true dacă utilizatorul curent are permisiunea de a citi această înregistrare. În caz contrar, returnează false. |
can_write | Returnează true dacă utilizatorul curent are permisiunea de a actualiza această înregistrare. În caz contrar, returnează false. |
rules_exist | Returnează true dacă rezultatele de permisiune reprezentate de acest obiect sunt rezultatul regulilor de permisiune definite explicit. Returnează false dacă acestea sunt implicite, rezultă în absența permisiunilor definite în mod explicit. |
Relație reflexivă
Încearcă să încarce relații reflexive (adică auto-referențiale) pentru entitățile returnate ca obiecte cu următoarele atribute.
Atribut | Descriere |
---|---|
is_reflexive | Returnează true. Poate fi utilizat pentru a testa dacă un obiect returnat de o relație este un obiect de relație reflexivă. |
referenced | Returnează un șir de entități de referință pentru relația dată. |
referencing | Returnează un tabel de referință pentru relația dată. Returnează null în cazul în care nu există niciun tabel de referință. Daca relatia este multe-la-multe (N:N), returnează un șir de entități de referință. |
listă de entități
Obiectul listă de entități este utilizat în cadrul etichetelor de tabel Dataverse. Acesta oferă acces la toate atributele unei anumite liste.
Atribute
Notă
Atribut | Descriere |
---|---|
create_enabled | Returnează true în cazul în care crearea de noi înregistrări este configurată pentru listă. În caz contrar, returnează false. |
create_url | Returnează calea URL configurată pentru un link/buton de creare pentru listă. |
detail_enabled | Returnează true în cazul în care este configurată o vizualizare de detaliu pentru înregistrările individuale pentru listă. În caz contrar, returnează false. |
detail_id_parameter | Returnează numele de parametru al șirului de interogare de utilizat pentru ID-ul de înregistrare atunci când se construiește un URL de vizualizare a detaliului de înregistrare. Consultați Filtre URL pentru detalii despre utilizarea filtrelor Liquid pentru a construi URL-uri. De exemplu, ID |
detail_label | Returnează eticheta localizată configurată pentru linkuri/butoane de vizualizare detaliată pentru listă. |
detail_url | Returnează calea URL configurată pentru linkuri/butoane de vizualizare detaliată pentru listă. |
empty_list_text | Returnează textul localizat configurat pentru a fi afișat atunci când vizualizarea listă nu returnează rezultate. |
enable_entity_permissions | Returnează true dacă filtrarea permisiunii de tabel este activată pentru această listă. În caz contrar, returnează false. |
entity_logical_name | Returnează numele logic de tabel Dataverse pentru înregistrări de afișat de către această listă. De ex., contact |
filter_account_attribute_name | Returnează numele logic al atributului pentru căutarea în cont care este utilizat pentru a filtra înregistrările rezultate după cont principal al utilizatorului curent al portalului. De exemplu, accountid |
filter_apply_label | Returnează eticheta localizată configurată de utilizat pentru linkul/butonul care aplică un filtru de atribut avansat la rezultatele listei. |
filter_definition | Returnează definiția filtrului de atribut JSON pentru listă. Consultați Filtrele listei pentru detalii despre cum să utilizați metafiltre Filtrul Liquid pentru a procesa această definiție. |
filter_enabled | Returnează true dacă este activată filtrarea de atribute avansată pentru listă. În caz contrar, returnează false. |
filter_portal_user_attribute_name | Returnează numele logic al atributului pentru căutarea la contact, care este utilizat pentru a filtra înregistrările rezultate după contactul utilizatorului actual al portalului. De exemplu, contactid |
filter_website_attribute_name | Returnează numele logic al atributului pentru căutarea la adx_website, care este folosit pentru a filtra înregistrările rezultate după site-ul web al portalului curent. De exemplu, adx_websiteid |
language_code | Returnează codul lingvistic număr întreg Dataverse care va fi utilizat pentru a selecta toate etichetele localizate pentru această listă. |
page_size | Returnează dimensiunea paginii de rezultate configurată pentru listă. |
primary_key_name | Returnează numele logic de atribuit de cheie principală pentru înregistrări de afișat de către această listă. |
search_enabled | Returnează true dacă este activată căutarea pentru această listă. În caz contrar, returnează false. |
search_placeholder | Returnează textul localizat configurat pentru substituentul câmp de căutare de listă. |
search_tooltip | Returnează textul localizat configurat pentru sfatul ecran de căutare de listă. |
vizualizări | Returnează vizualizările disponibile pentru listă, ca obiecte de vizualizare listă. |
[attribute logical name] | Puteți accesa orice atribut al înregistrării Dataverse din listă (adxentitylist) după numele logic, în același mod ca un obiect de tabel. De exemplu, {{ entitylist.adx_name }} |
Atributele listei vizualizări
Atribut | Descriere |
---|---|
coloane | Returnează coloanele vizualizării ca obiecte coloană de vizualizare a listei. |
entity_logical_name | Returnează numele logic de tabel Dataverse pentru înregistrările incluse în vizualizare. De ex., contact |
Id | Întoarce ID-ul GUID de vizualizare. |
language_code | Returnează Dataverse codul de limbă întreg care este utilizat pentru a selecta toate etichetele localizate (anteturi de coloane etc.) pentru vizualizare. |
Nume | Returnează numele de afișare Dataverse al vizualizării. |
primary_key_logical_name | Returnează numele logic al cheii principale de tabel Dataverse pentru înregistrările incluse în vizualizare. De exemplu, contactid |
sort_expression | Returnează expresia de sortare implicită pentru vizualizare. De exemplu, name ASC, createdon DESC |
Atributele de coloană ale vizualizării listă
Atribut | Descriere |
---|---|
attribute_type | Returnează numele tipului de atribut Dataverse pentru coloană, ca șir de caractere. De exemplu, Lookup, Picklist, String, Boolean, DateTime |
logical_name | Returnează numele logic al atributului Dataverse pentru coloană. De exemplu, createdon |
Nume | Returnează numele de afișare Dataverse localizat pentru coloană. De exemplu, Creată pe |
sort_ascending | Returnează un șir de expresie de sortare pentru sortarea coloanei în ordine crescătoare. De exemplu, createdon ASC |
sort_descending | Returnează un șir de expresie de sortare pentru sortarea coloanei în ordine descrescătoare. De exemplu, createdon DESC |
sort_disabled | Returnează true în cazul în care este dezactivată sortarea pentru coloană. În caz contrar, returnează false. |
sort_enabled | Returnează true în cazul în care este activată sortarea pentru coloană. În caz contrar, returnează false. |
lățime | Returnează lățimea configurată pentru coloană, în pixeli. |
entityview
Obiectul entityview este utilizat în cadrul etichetei entityview și oferă acces la metadatele pentru vizualizare, precum și la vizualizarea înregistrărilor rezultate.
Atribute
Atribut | Descriere |
---|---|
coloane | Returnează coloanele în vizualizare drept obiecte coloană de vizualizare tabel. |
entity_permission_denied | Returnează true în cazul în care accesul la rezultatele de vizualizare a fost refuzat din cauza unor permisiuni de tabel insuficiente pentru utilizatorul curent. Returnează false în cazul în care s-a acordat acces de citire pentru a vizualiza rezultatele. |
entity_logical_name | Numele logic al tabelului Dataverse al înregistrărilor pentru vizualizarea înregistrărilor rezultate. De ex., contact |
first_page | Numărul de pagină al primei pagini cu rezultatele de vizualizare. Acesta este 1, cu excepția cazului în care nu au fost returnate rezultate, caz în care este nul. |
Id | ID-ul GUID al vizualizării Dataverse care definește această entityview. |
language_code | Codul de limbă al numărului întreg Dataverse utilizat pentru a încărca etichetele localizate pentru vizualizarea curentă. |
last_page | Numărul de pagină al ultimei pagini cu rezultatele de vizualizare. Dacă nu au fost returnate rezultate, această valoare este nulă. |
nume | Numele vizualizării Dataverse care definește această entityview, de exemplu, Contacte active. |
next_page | Numărul de pagină al următoarei pagini cu rezultatele de vizualizare. Dacă nu există o pagină următoare de rezultate, această valoare este nulă. |
Pagina | Numărul de pagină al paginii curente cu rezultatele de vizualizare. |
pagini | Întoarce o matrice de numere de pagină care conține toate paginile de rezultate pentru vizualizarea curentă. |
page_size | Numărul de rezultate returnate pe pagină pentru vizualizarea curentă. |
previous_page | Numărul de pagină al următoarei pagini cu rezultatele de vizualizare. Dacă nu există o pagină anterioară de rezultate, aceasta este nulă. |
primary_key_logical_name | Numele logic Dataverse al atributului cheie primară al tabelului rezultat pentru această vizualizare. De ex., contactid. |
înregistrări | Pagina curentă cu înregistrările rezultate pentru vizualizare, ca obiecte de tabel. |
sort_expression | Expresia de sortare implicită pentru vizualizare. De exemplu, nameASC, createdon DESC. |
total_pages | Numărul total de pagini cu rezultate pentru vizualizare. |
total_records | Numărul total de rezultate pentru vizualizare (din toate paginile). |
evenimente
Permite preluarea și afișarea evenimentelor. Obiectul evenimente vă permite să selectați un anumit eveniment sau pe toate.
Obiectul events
Obiectul events vă permite să accesați orice eveniment specific din portal sau să accesați toate evenimentele din portal (indiferent de eveniment).
Obiectul events are următoarele atribute:
Atribut | Descriere |
---|---|
apariții | Întoarce un obiect eventoccurances care conține toate aparițiile evenimentului din portal |
[nume de eveniment sau id] | Puteți accesa orice eveniment după numele său sau după proprietățile de identitate. {% assign event = events["Event Name"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %} |
Obiectul event
Obiectul event vă permite să lucrați cu un singur eveniment, permițându-vă să accesați programe și cazuri pentru acel eveniment.
Obiectul event are următoarele atribute:
Atribut | Descriere |
---|---|
apariții | Întoarce un obiect eventoccurences care conține toate aparițiile pentru eveniment. |
nume | Numele evenimentului. |
URL | URL-ul evenimentului. |
Obiectul eventoccurences
Obiectul eventoccurrences vă permite să accesați o colecție de obiecte cu aparițiile evenimentului. Puteți comanda aparițiile evenimentului și specifica un interval de date pentru apariția apariției și puteți obține paginarea, de asemenea, utilizând filtre de lichide:
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
De asemenea, este posibilă următoarea opțiune:
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
Următoarele atribute sunt asociate cu obiectul eventoccurrences
Atribut | Descriere |
---|---|
Toate | Returnează toate obiectele eventoccurance din colecție. |
Obiectul eventoccurence
Reprezintă o apariție de eveniment unică. Următoarele sunt atributele asociate:
Atribut | Descriere |
---|---|
URL | Adresa URL a apariției. |
is_all_day_event | Acesta este un eveniment care durează întreaga zi? |
start_time | Ora de început pentru eveniment. |
end_time | Ora de sfârșit pentru eveniment. |
forloop
Conține proprietăți utile într-o blocare de buclă for.
Notă
forloop se poate utiliza numai în cadrul unei etichete for.
Cod
{% for child in page.children %}
{% if forloop.first %}
This is the first child page!
{% else %}
This is child page number {{ forloop.index }}.
{% endif %}
{% endfor %}
Ieșire
This is the first child page!
This is child page number 2.
This is child page number 3.
Atribute
Atribut | Descriere |
---|---|
Prima | Returnează true în cazul în care este prima repetare a buclei. Returnează false în cazul în care nu este prima repetare. |
index | Poziția elementului curent din colecție, în care primul element are poziția 1. |
index0 | Poziția elementului curent din colecție, în care primul element are poziția 0. |
Ultima | Returnează true în cazul în care este ultima repetare a buclei. Returnează false în cazul în care nu este ultima repetare. |
length | Returnează numărul de repetiții pentru buclă ߝ numărul de elemente din colecție fiind repetat peste. |
rindex | Numărul de elemente rămase în buclă (lungime - index) în care 1 este indicele ultimului element. |
rindex0 | Numărul de elemente rămase în buclă (lungime - index) în care 0 este indicele ultimului element. |
forumuri
Permite regăsirea și afișarea forumurilor și a subiectelor de forum. Capacitatea de a folosi Liquid pentru a reda date de forum se extinde și la postări, dar pentru a crea o postare sau un fir nou, trebuie să utilizați un șablon de pagină formular cu mai mulți pași ASP.NET cu funcționalitatea menționată încorporată (cum ar fi firul de forum și șabloanele de pagină de publicare pe forum implicite).
Obiectul de forumuri vă permite să selectați un forum sau fire de forum:
<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>
Obiect de forumuri
Obiectul de forumuri vă permite să accesați orice forum specific din portal sau să accesați toate fiele de forum din portal (indiferent de forum).
Obiectul forum vă permite să lucrați cu un singur forum, permițându-vă să accesați firele pentru acel forum.
Obiectul forumthreads vă permite să accesați o colecție de obiecte forumthread. Puteți ordona fire de forum și realiza paginarea, precum și utiliza filtrele Liquid.
{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}
Un singur fir de forum
Obiectul forumposts vă permite să accesați o colecție de obiecte forumpost.
Atribute
Atribut | Descriere |
---|---|
threads | Întoarce un obiect forumthreads care conține toate obiectele forumthread din portal. |
Toate | Returnează toate obiectele forum din portal. Rețineți că website.forums este de asemenea un echivalent. |
thread_count | Returnează valoarea număr întreg a numărului de fire existente pe întregul site web. |
post_count | Returnează valoarea număr întreg a numărului total de postări din portal. |
[forum name or id] | Puteți accesa orice forum după numele său sau după proprietățile de identitate. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %} |
Obiectul forum
Atribute
Notă
Atribut | Descriere |
---|---|
threads | Întoarce un obiect forumthreads care conține toate firele de forum pentru forum. |
Nume | Numele forumului. |
thread_count | Returnează valoarea număr întreg a numărului de fire existente pe forum. |
post_count | Returnează valoarea număr întreg a numărului de postări care sunt în întregul forum. |
Obiectul forumthreads
Atribute
Atribut | Descriere |
---|---|
Toate | Returnează toate obiectele forumthread din colecție. |
Obiectul forumthread
Atribute
Notă
Atribut | Descriere |
---|---|
postări | Întoarce un obiect forumposts care conține toate publicările pentru fir. |
author | Returnează autorul pentru fir (care este pur și simplu un obiect de tabel persoană de contact). |
latest_post | Returnează cea mai recentă publicare din fir. |
first_post | Returnează prima publicare din fir. |
post_count | Returnează valoarea număr întreg a numărului de publicări existente în fir. |
is_answered | La fir ați răspuns sau nu? |
is_sticky | Firul este unul adeziv? |
Obiectul forumposts
Atribute
Atribut | Descriere |
---|---|
Toate | Returnează toate obiectele forumthread din colecție. |
O singură postare de forum
Atribute
Notă
Atribut | Descriere |
---|---|
author | Returnează autorul pentru publicare (care este pur și simplu un obiect de tabel persoană de contact). |
conținut | Conținutul publicării. |
is_answer | Această publicare este un răspuns la fir? |
cunoștințe
Oferă acces la articolul de cunoștințe Dataverse și la înregistrările de tabel de categorie pentru a reda articolele și categoriile dintr-un portal.
Atribute
Atribut | Descriere |
---|---|
articole | Returnează un obiect de articole care conține obiecte de articole pentru înregistrările de tabel articol de cunoștințe disponibile în portal. |
categorii | Returnează un obiect de categorii care conține obiecte de categorie pentru înregistrările de tabel de categorie disponibile în portal. |
obiect de articole
Obiectul de articol vă permite să accesați o colecție de obiecte de articole. Puteți ordona articolele și realiza paginarea și utilizând filtrele Liquid.
{% 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 %}
Atribute
Atribut | Descriere |
---|---|
populare | Returnează o colecție de obiecte de articol care conține cele mai multe vizualizări. {% assign popular_articles = knowledge.articles.popular %} |
recente | Returnează o colecție de obiecte de articol care conține data ultimei modificări. {% assign recent_articles = knowledge.articles.recent %} |
sus | Returnează o colecție de obiecte de articol care conține cele mai bune evaluări. {% assign top_articles = knowledge.articles.top %} |
Filtre
Următoarele filtre pot accepta parametri opționali pentru dimensiunea și limba paginii. Primul parametru reprezintă numărul sau înregistrările de regăsit. Dimensiunea implicită de pagină este 5. Al doilea parametru este codul de limbă pentru a regăsi articole pentru o anumită limbă. Filtrele pot fi combinate cu alte filtre de lichide.
{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Atribut | Descriere |
---|---|
populare | Returnează o colecție de obiecte de articol care conține cele mai multe vizualizări. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %} |
recente | Returnează o colecție de obiecte de articol care conține data ultimei modificări. {% assign recent_articles = knowledge.articles \| recent: 5 %} |
sus | Returnează o colecție de obiecte de articol care conține cele mai bune evaluări. {% assign top_articles = knowledge.articles \| top: 3, en-US %} |
obiect de categorii
Obiectul de categorii vă permite să accesați o colecție de obiecte de categorie. Puteți ordona categoriile și realiza paginarea și utilizând filtrele Liquid.
{% 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 %}
Atribute
Atribut | Descriere |
---|---|
recente | Returnează o colecție de obiecte de categorie care conține data ultimei modificări. |
top_level | Returnează o colecție de obiecte de categorie care nu au o categorie principală. |
Filtre
Următoarele filtre pot accepta un parametru opțional care indică dimensiunea paginii. Dimensiunea implicită de pagină este 5. Filtrele pot fi combinate cu alte filtre de lichide.
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Atribut | Descriere |
---|---|
recente | Returnează o colecție de obiecte de categorie care conține data ultimei modificări. Puteți furniza parametrii {% assign recent_categories = knowledge.categories \| recent: 10 %} |
top_level | Returnează o colecție de obiecte de categorie care nu au o categorie principală. {% assign root_categories = knowledge.categories \| top_level %} |
Obiect de articol
Obiectul de articol vă permite să lucrați cu un singur articol de cunoștințe pentru a afișa detaliile acelui articol în portal.
Atribute
Articolul este un entitate obiect, cu toate aceleași atribute, pe lângă următoarele atribute:
Atribut | Descriere |
---|---|
article_public_number | Numărul public de articol al articolului. |
comment_count | Valoarea întreagă a numărului de comentarii pentru un articol dat. |
conținut | Conținutul articolului. |
current_user_can_comment | Returnează o valoare booleană care indică dacă utilizatorul curent poate adăuga comentarii la articol. |
is_rating_enabled | Returnează o valoare booleană indicând dacă este activată evaluarea pentru un articol. |
cuvinte cheie | Cuvintele cheie despre articol. |
nume | Un alias alternativ pentru titlul articolului. |
evaluare | Valoarea zecimală de evaluare pentru articol. |
titlu | Titlul articolului. |
view_count | Valoarea întreagă a numărului de ori când articolul a fost vizualizat. |
Obiect de categorii
Obiectul de categorie vă permite să lucrați cu o singură categorie pentru a-i afișa detaliile în portal.
Atribute
Categoria este un obiect entity , cu toate aceleași atribute, în plus față de următoarele atribute:
Atribut | Descriere |
---|---|
numărcategorie | Numărul categoriei. |
nume | Un alias alternativ pentru titlul categoriei. |
titlu | Titlul categoriei. |
limbă
Oferă numele limbii curente și codul de limbă dacă este activat suport în mai multe limbi.
Atribute
Atribut | Descriere |
---|---|
URL | Adresa URL a solicitării curente prefixată cu codul de limbă curent. |
url_substituire | Adresa URL a solicitării curente prefixată cu codul limbii curente ocolind memoria cache de ieșire a paginii. |
nume | Titlul limbii curente. |
cod | Codul de limbă al limbii. |
De exemplu, șablonul web Meni derulant Limbi folosește implict acest obiect lichid pentru a lista limbile disponibile atunci când sunt disponibile mai multe limbi.
jurnal
Producătorii au capacitatea de a încorpora declarații de jurnal în codul lor Liquid. Când site-ul Power pages rulează, jurnalele adăugate de un producător în codul Liquid sunt afișate în Power Pages extensia instrumentului pentru dezvoltatori. Aceste jurnale, încorporate de producător, sunt afișate în extensia instrumentului pentru dezvoltatori atunci când setarea de diagnosticare este activată.
Următoarea sintaxă poate fi utilizată în codul Liquid pentru a înregistra mesaje personalizate:
{% log message:'Custom message' level:'Warning' %}
Atributele jurnalului
Atribut | Descriere |
---|---|
jurnal | Numele obiectului lichid |
mesaj | Un șir care reprezintă orice mesaj personalizat de înregistrat |
nivel | Înregistrați mesajul ca Informații, Avertisment sau Eroare |
Exemplu:
{% 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 %}
pagină
Se referă la pagina de solicitare a portalului curent. Acest obiect combină atributele sitemap și solicitarea curentă entities (de obicei, o pagină web).
Obiectul page oferă acces la lucruri cum ar fi fragmente pentru pagina curentă, titlul sau URL-ul paginii curente și orice alte atribute sau entități corelate ale înregistrării Dataverse subiacente.
<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 }}. -->
Atribute de pagină
Notă
Atribut | Descriere |
---|---|
breadcrumbs | Returnează urmele obiectelor de nod de hartă de site pentru pagină, pornind de la nodul rădăcină de hartă de site și se încheie la părinte. |
children | Întoarce obiectele de nod de hartă de site subordonatoare ale paginii. |
parent | Întoarce nodul de hartă de site părinte al paginii. Dacă pagina este pagina de pornire, părinte este nul. |
Funcția | Titlul paginii. |
URL | Adresa URL a paginii. |
[attribute or relationship name] | Puteți accesa orice atribut al înregistrării Dataverse subiacente a paginii după numele logic.{{ page.createdon }} {% assign attribute_name = 'name' %} {{ page[attribute_name] }} Valorile celor mai multe atribute de tabel se mapează direct la Tipuri Liquid: Două Câmpuri de opțiune se mapează la valori Boolene, câmpurile text la șiruri de caractere, câmpurile numerice/monedă la valori numerice, câmpurile dată/oră la obiecte de tip dată. Dar unele tipuri de atribute sunt returnate ca obiecte:
{{ page.adx_webpage_entitylist.adx_name }} În cazul în care o relație este reflexivă (adică autoreferențială), se returnează un entități obiect. (Altfel, rezultatul ar fi ambiguu.) {{ page.adx_webpage_webpage.referencing.adx_name }} Notă: încărcarea unui număr mare de entități asociate sau accesarea unui număr mare de relații într-un singur șablon poate avea un impact negativ asupra performanței de redare a șablonului. Evitați încărcarea entităților corelate pentru fiecare element dintr-o matrice, într-o buclă. Acolo unde este posibil, utilizați de preferință etichetele de tabel Dataverse pentru a încărca colecții de entități. |
sondaje
Permite preluarea și afișarea unui sondaj.
Obiectul polls vă permite să selectați un sondaj specific sau o plasare de sondaj.
<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>
Atribute de sondaje
Atribut | Descriere |
---|---|
amplasări | Întoarce obiectul pollplacements. |
[poll name or id] | Puteți accesa orice sondaj după numele său sau după proprietățile de identitate. {% assign poll = polls[Poll Name] %} {% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %} |
Atributele amplasărilor de sondaje
Atribut | Descriere |
---|---|
[poll placement name or id] | Puteți accesa orice amplasare de sondaj după numele său sau după proprietățile de identitate.{% assign placement = polls.placements[Placement Name or Id] %} {% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %} |
Atributele amplasării de sondaje
Notă
Atribut | Descriere |
---|---|
Nume | Returnează câmpul Nume pentru amplasarea sondajului. |
placement_url | URL-ul care poate fi folosit pentru a regăsi amplasarea sondajului, redat complet de un șablon. |
sondaje | Returnează colecția de obiecte de tip sondaj asociate cu amplasarea. Etichetele de iterație și filtrele de matrice pot fi utilizate cu această colecție. |
random_url | URL-ul care poate fi folosit pentru a regăsi un sondaj aleator din amplasare, redat complet de un șablon. |
submit_url | URL-ul la care este trimis un sondaj finalizat. |
Atribute de sondaj
Notă
Atribut | Descriere |
---|---|
has_user_voted | Returnează true dacă utilizatorul curent (conectat sau anonim) a votat deja în acest sondaj. |
Nume | Returnează câmpul Nume pentru sondaj. |
options | Returnează colecția de obiecte de tip poll option asociate cu sondajul. Etichetele de iterație și entitățile pot fi folosite cu această colecție. |
poll_url | URL-ul care poate fi folosit pentru a regăsi sondajul, redat complet de un șablon. |
întrebare | Returnează câmpul Întrebare pentru sondaj. |
submit_button_label | Returnează un șir care poate fi folosit pentru a înlocui eticheta buton de remitere pentru sondaj. |
submit_url | URL-ul la care este trimis un sondaj finalizat. |
user_selected_option | Returnează obiectul polloption selectat de utilizator (dacă a votat deja). |
votes | Returnează numărul de voturi care sunt tabulate pentru sondaj. |
Atributele opțiunii de sondaj
Notă
Atribut | Descriere |
---|---|
answer | Returnează câmpul Răspuns pentru sondaj. |
percentage | Returnează procentul de voturi din sondaj pentru opțiunea număr zecimal între 0 și 100. |
votes | Returnează numărul de voturi care sunt tabulate pentru opțiune. |
solicitare
Conține informații despre solicitarea HTTP curentă.
{% assign id = request.params['id'] | escape %}
<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>
Notă
- Puteți construi URL-uri dinamic în Liquid folosind filtre de URL.
- Adresa URL folosită în request.url poate fi orice valoare solicitată, și primește în cache pentru cererile ulterioare. Pentru a asigura valoarea corectă în request.url, luați în considerare utilizarea etichetei de substituție, adresă URL parțială, cum ar fi ~{calea WebFile} sau stocarea adresei URL a portalului în Setări site.
- Versiunea de lansare Power Pages 9.3.8.x sau versiunile ulterioare vor avea în mod implicit filtrul Liquid escape impus pentru obiectele Liquid utilizator și solicitare. Pentru a dezactiva această configurație implicită și a permite aceste obiecte Liquid fără filtrul Liquid escape, vizualizați setări site portal - Site/EnableDefaultHtmlEncoding.
Atribute
Atribut | Descriere |
---|---|
params | Valori parametru denumite pentru cererea curentă. params este o combinație de parametri de șir de interogare URL, de parametri de postare de formular și de module cookie. |
Cale | Calea URL-ului de cerere curent. /profile/ |
path_and_query | Calea și interogarea URL-ului de cerere curent./profile/?foo=1&bar=something |
interogare | Partea de interogare a URL-ului de cerere curent. ?foo=1&bar=something |
URL | URL-ul complet al cererii curente.https://www.example.com/profile/?foo=1&bar=something |
searchindex
Obiectul searchindex este utilizat în cadrul etichetelor de tabel Dataverse și furnizează acces la rezultatele unei interogări.
{% 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 %}
Atribute
Atribut | Descriere |
---|---|
approximate_total_hits | Returnează un număr aproximativ de accesări totale care se potrivesc interogării indexului. Datorită modului în care funcționează indexul de căutare în ceea ce privește filtrarea de securitate și alți factori de proiectare, acest număr este doar o aproximare și s-ar putea să nu se potrivească exact cu numărul total de rezultate disponibile pentru utilizatorul curent în unele situații. |
Pagina | Returnează numărul de pagină al interogării curente. |
page_size | Returnează dimensiunea maximă de pagină a interogării curente. Dacă doriți să fie returnat numărul real de rezultate pentru pagina curentă (deoarece aceasta poate fi mai mică decât dimensiunea maximă specificată a paginii), utilizați results.size. |
Rezultate | Returnează pagina de rezultate a interogării, ca obiecte ale rezultatului indexului de căutare. |
Rezultatele indexului de căutare
Atribut | Descriere |
---|---|
entitate | Entități subiacente pentru rezultat. |
fragment | Un fragment de text scurt relevant pentru rezultat, cu termenii care se potrivesc interogării specificate evidențiate utilizând eticheta HTML <em>. Anumite tipuri de interogări nu acceptă fragmente evidențiate, cum ar fi interogări neclare (~) și interogări cu metacaractere (*). Această proprietate este nulă în aceste cazuri. |
Id | ID-ul de tabel Dataverse al înregistrării subiacente pentru rezultat, sub formă de șir. De exemplu, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8 |
logical_name | Numele logic al tabelului Dataverse al înregistrării subiacente pentru rezultat. De exemplu, adx_webpage |
Număr | Numărul de rezultate, din toate paginile de rezultate, pornind de la 1. De exemplu, pentru primul rezultat al celei de-a doua pagini de rezultate, cu o dimensiune a paginii de 10, această valoare este 11. |
score | Scorul Lucene al rezultatului, ca valoare virgulă mobilă. Rezultatele sunt returnate ordonate după această valoare. |
Funcția | Titlul rezultatului. |
URL | Adresa URL a rezultatului. Acesta va fi de obicei – dar nu necesar – mai degrabă o cale absolută pentru aplicația curentă decât un URL complet. De ex.: /articles/article1/ |
setări
Vă permite să încărcați orice setare de site după nume. Dacă nu este găsită o setare cu numele dat, se va returna nul.
Notă
Setările sunt returnate ca șiruri, dar aveți posibilitatea să utilizați filtre Tip pentru a le converti la alte tipuri.
{{ 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 %}
hartă site
Permite accesul la harta de site a portalului.
<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 %}
Atribute hartă site
Atribut | Descriere |
---|---|
Curent | Returnează un obiect de nod de hartă de site pentru pagina curentă. |
Rădăcină | Returnează obiectul nod de hartă de site pentru pagina rădăcină (de pornire) a site-ului web. |
Atributele nodului de hartă de site
Atribut | Descriere |
---|---|
Urme | Returnează urmele obiectelor de nod de hartă de site pentru nod, pornind de la nodul rădăcină de hartă de site și se încheie la părinte. |
Fii | Întoarce obiectele de nod de hartă de site subordonatoare ale nodului. |
Descriere | Conținutul descrierii/sumarului pentru nod. (Acest câmp poate conține HTML.) |
Entity | Returnează entități subiacente nodului. Dacă nodul nu are un tabel subiacent, această valoare este nulă. |
is_sitemap_ancestor | Returnează true dacă nodul de hartă de site este un strămoș al nodului curent. În caz contrar, returnează false. |
is_sitemap_current | Returnează true dacă nodul de hartă de site este nodul curent. În caz contrar, returnează false. |
Element principal | Întoarce nodul de hartă de site părinte al nodului. Dacă nodul este nodul rădăcină, părinte este nul. |
Funcție | Titlul nodului. |
URL | Adresa URL a nodului. |
markeri de site
Vă permite să încărcați orice marker de site după nume. Dacă sitemarker-ul există, este returnat un obiect sitemarker. Dacă nu este găsit un marcator de site cu numele dat, se returnează null .
{{ 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 %}
Atribute de marker de site
Atribut | Descriere |
---|---|
URL | URL-ul țintă al markererului de site. |
[attribute logical name] | Puteți accesa orice atribut al înregistrării Dataverse țintă a markerului de site după numele logic. De exemplu, {{ sitemarker.adx_name }} |
fragmente
Vă permite să încărcați orice fragmente de conținut după nume. Dacă nu este găsit un fragment cu numele dat, se returnează null .
{{ snippets[Header] }}
{% assign footer = snippets[Footer] %}
{% if footer %}
{{ footer }}
{% else %}
No footer snippet was found.
{% endif %}
tablerowloop
Conține proprietăți utile într-o blocare de buclă Iteration tags.
Notă
tablerowloop se poate utiliza numai în cadrul unei etichete Etichete de repetare.
Atribute
Atribut | Descriere |
---|---|
Col | Returnează indexul rândului curent, începand de la 1. |
col0 | Returnează indexul rândului curent, începand de la 0. |
col_first | Returnează adevărat în cazul în care coloana curentă este prima coloană dintr-un rând, returnează fals dacă nu este prima coloană dintr-un rând. |
col_last | Returnează adevărat în cazul în care coloana curentă este ultima coloană dintr-un rând, returnează fals dacă nu este ultima coloană dintr-un rând. |
Prenume | Returnează true în cazul în care este prima repetare a buclei. Returnează false în cazul în care nu este prima repetare. |
Index | Poziția elementului curent din colecție, în care primul element are poziția 1. |
index0 | Poziția elementului curent din colecție, în care primul element are poziția 0. |
Ultima | Returnează true în cazul în care este ultima repetare a buclei. Returnează false în cazul în care nu este ultima repetare. |
Length | Returnează numărul de repetiții pentru buclă ߝ numărul de elemente din colecție fiind repetat peste. |
Rindex | Numărul de elemente rămase în buclă (lungime - index) în care 1 este indicele ultimului element. |
rindex0 | Numărul de elemente rămase în buclă (lungime - index) în care 0 este indicele ultimului element. |
User
Se referă la utilizatorul curent al portalului, oferind acces la toate atributele înregistrării persoană de contact Dataverse subiacente. Dacă niciun utilizator nu este conectat, această variabilă este nulă.
Utilizatorul este o entitate obiect.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
Notă
Versiunea de lansare Power Pages 9.3.8.x sau versiunile ulterioare vor avea în mod implicit filtrul Liquid escape impus pentru obiectele Liquid utilizator și solicitare. Pentru a dezactiva această configurație implicită și a permite aceste obiecte Liquid fără filtrul Liquid escape, vizualizați setări site portal - Site/EnableDefaultHtmlEncoding.
Atribute
În plus față de faptul că are toate atributele unui obiect entitate, utilizatorul are următoarele atribute.
Atribut | Descriere |
---|---|
roluri | Returnează roluri cărora le aparține utilizatorul, ca o serie.{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %} Notă: puteți utiliza și filtrul has_role pentru a testa apartenența la rol individual. |
basic_badges_url | Returnează url-ul de serviciu pentru a prelua ecusoanele unui utilizator. Pentru a reda insigne pentru un utilizator, trebuie să includeți o etichetă cu atributele „data-badge” și „data-uri”. Pentru a reda ecusoanele utilizatorului curent: <div data-badge data-uri='{{user.basic_badges_url }}'></div> Pentru a reda ecusoanele unui utilizator după ID (ID utilizator variabil): `<div data-badge data-uri='{{user.basic_badges_url |
linkuri web
Vă permite să încărcați orice linkuri web după nume sau ID.
Dacă set de linkuri web există, un set de linkuri web obiect este returnat. Dacă nu este găsit un set de linkuri web cu numele dat sau ID, se returnează null .
<!-- 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 %}
Atribute set linkuri web
Notă
Un set de linkuri web este un entitate obiect, cu toate aceleași atribute, în plus față de următoarele atribute:
Atribut | Descriere |
---|---|
Copiați | Copie HTML a setului de link-uri web. |
Nume | Numele setului de link-uri web. |
Funcția | Titlul setului de link-uri web. |
Weblinks | Seria de obiecte linkuri web asociate cu setul de linkuri web. |
[attribute logical name] | Puteți accesa orice atribut al înregistrării setului de linkuri web Dataverse după numele logic. De exemplu, {{ weblinkset.createdon }} |
Atribute linkuri web
Notă
Un link web este un obiect entitate, cu toate aceleași atribute, în plus față de următoarele atribute:
Atribut | Descriere |
---|---|
Descriere | Descriere HTML a link-urilor web. |
display_image_only | Atribut conjuncție logică care să indice dacă linkul web trebuie să fie afișat ca o imagine, cu niciun link text. |
display_page_child_links | Atributul conjuncție logică care să indice dacă linkul web ar trebui să arate linkuri la paginile copil sitemap legate, ca sublinkuri. |
Image | Imaginea linkului web pentru acest link. Acest atribut este nul dacă nu este prezentă nicio imagine. |
is_external | Atributul conjuncție logică care indică dacă URL-ul țintă al link-ului de web este la un site extern (nu la o pagină de portal internă). |
is_sitemap_ancestor | Returnează true dacă URL-ul linkului web face referire un strămoș al nodului curent al hărții site-ului, în caz contrar returnează false. |
is_sitemap_current | Returnează true dacă URL-ul linkului web face referire la nodul curent al hărții site-ului, în caz contrar returnează false. |
Nume | Titlul/numele link-ului web. |
Nofollow | Atributul de conjuncíe logică care să indice dacă linkul web ar trebui să fie marcat ca rel=nofollow. |
open_in_new_window | Atributul boolean care indică dacă linkul web ar trebui să fie deschis într-o nouă fereastră sau filă de browser atunci când este selectat. |
Sfat ecran | Text sfat ecran pentru link-ul de web. |
URL | URL-ul linkului web. |
Weblinks | Seria de obiecte linkuri web copil asociate cu setul de linkuri web. |
[attribute logical name] | Puteți accesa orice atribut al înregistrării de linkuri web Dataverse după numele logic. De exemplu, {{ weblink.createdon }} |
Atribute imagine linkuri web
alternate_text | Alternați textul pentru imagine. |
---|---|
Înălțime | Întregi care conțin înălțimea specificată a imaginii. Dacă nu a fost furnizată nicio valoare a înălțimii, acest atribut este nul. |
URL | URL-ul imaginii. |
Lățime | Întregi care conțin lățimea specificată a imaginii. Dacă nu a fost furnizată nicio valoare a lățimii, acest atribut este nul. |
site web
Se referă la site-ul web de portal, permițând accesul la toate atributele înregistrării de site web (adxwebsite) Dataverse pentru portal.
Notă
Site-ul web este un obiect entitate, cu aceleași atribute.
Cod
{{ website.adx_name }} ({{ website.id }})
Ieșire
Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)
Atribute
Următorul tabel listează atributele pentru această etichetă care pot fi utilizate înlocuind valorile implicite pentru a evita stocarea în cache.
Implicită | Înlocuitor (evită stocarea în cache) | Exemplu |
---|---|---|
url_conectare_la | url_conectare_la_substituire | Implicit: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F Înlocuire (evita stocarea în cache): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F („pagina-substitut” din acest exemplu înlocuiește adresa URL implicită în cache.) |
deconectare_url | url_deconectare_substituire | Implicit: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F Înlocuire (evita stocarea în cache): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F („pagina-substitut” din acest exemplu înlocuiește adresa URL implicită în cache.) |