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ă: Această valoare este memorată în cache de aplicația web portal ș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ă va fi 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
Oferă posibilitatea de a accesa și de a reda o reclamă.
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 amplasare a reclamei este un obiect de tabel cu aceleași atribute generale și atributele enumerate mai jos.
| Atribut | Descriere |
|---|---|
| Reclame | Returnează colecția de obiecte de tip reclamă asociate cu amplasarea. Etichetele de repetare ș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ă
O reclamă este un obiect de tabel, cu aceleași atribute, pe lângă cele enumerate mai jos.
| 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 | URL-ul la care va fi direcționat utilizatorul după ce selectează reclama. |
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
Oferă posibilitatea de a accesa și de a face reda bloguri și publicări pe 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. În cazul în care tabelul există, un obiect de tabel va fi returnat. În cazul în care un tabel cu ID-ul dat nu este găsit, va fi returnat nul.
{% 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 de entitate oferă acces la atributele unei înregistrări de tabel Dataverse.
| 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ă orice note (annotation) asociate cu tabelul, ordonate de la cele mai vechi la cele mai noi (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, acest lucru va returna o valoare doar pentru anumite tipuri de tabel care au fost integrate în CMS-ul de portal, dacă nu ați personalizat URL-ul de furnizor în aplicație. |
| [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ă), va fi returnat un obiect de relație reflexivă. (Altfel, rezultatul ar fi ambiguu.){{ page.adx_webpage_webpage.referencing.adx_name }} Notă: Încărcarea unui număr mare de entități corelate sau accesarea unui număr mare de relații într-un șablon unic poate avea un impact negativ asupra performanței de redare a șabloanelor. 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. În plus față de toate atributele unui obiect de 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 împreună cu restul atributelor de notă, ci va fi încărcat doar la cerere. Notă: Utilizarea atributului documentbody ar putea avea un impact negativ asupra performanței de redare a șabloanelor și ar trebui să fie 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 acest URL va descărca fișierul atașat notei. |
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 rezultatele implicite în absența permisiunilor definite 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ăutare la contul care va fi utilizat pentru a filtra înregistrările rezultate de contul părinte al utilizatorului portalului curent. 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ăutare la persoana de contact care va fi utilizată pentru a filtra înregistrările rezultate de persoana de contact curentă a utilizatorului de portal. De exemplu, contactid |
| filter_website_attribute_name | Returnează numele logic al atributului pentru căutare la adx_website care va fi utilizat pentru a filtra înregistrările rezultate de 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ă codul lingvistic număr întreg Dataverse care va fi 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 va fi 1, dacă nu ar exista rezultate returnate, caz în care va fi null. |
| 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ă au existat rezultate returnate, acesta va fi null. |
| 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. În cazul în care nu există nicio pagină următoare cu rezultate, aceasta va fi null. |
| Pagină | 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. În cazul în care nu există nicio pagină anterioară cu rezultate, aceasta va fi null. |
| 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
Oferă posibilitatea de a accesa și de a reda evenimente. 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 |
|---|---|
| occurences | Î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 să ordonați aparițiile evenimentului și să specificați un interval de date pentru apariții pentru a regăsi și a obține paginarea, precum și folosind filtrele lichide
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
rețineți că
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
este posibil de asemenea.
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ă. Atributele asociate sunt prezentate mai jos:
| 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.
Code
{% for child in page.children %}
{% if forloop.first %}
This is the first child page!
{% else %}
This is child page number {{ forloop.index }}.
{% endif %}
{% endfor %}
Output
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
Oferă posibilitatea de a accesa și de a reda forumuri și fire 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 Liquid.
{% 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 Liquid.
{% 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 obiect de entitate, cu aceleași atribute, pe lângă cele enumerate mai jos.
| Atribut | Descriere |
|---|---|
| article_public_number | Numărul public de articol al articolului. |
| comment_count | Valoarea număr întreg a numărului de comentarii existente pentru un anumit articol. |
| content | 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 | Numărul întreg de vizualizări ale articolului. |
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 de entitate, cu aceleași atribute, pe lângă cele enumerate mai jos.
| 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.
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. În cazul în care pagina este pagină de pornire, parent va fi null. |
| 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 va returna un obiect entități. (Altfel, rezultatul ar fi ambiguu.) {{ page.adx_webpage_webpage.referencing.adx_name }} Notă: Încărcarea unui număr mare de entități corelate sau accesarea unui număr mare de relații într-un șablon unic poate avea un impact negativ asupra performanței de redare a șabloanelor. 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
Oferă posibilitatea de a accesa și de a reda un 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 repetare ș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. Iteration tags și entities pot fi utilizate 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 | Întoarce obiectul polloption selectat de utilizator (în cazul în care a votat deja). |
| votes | Returnează numărul de voturi care au fost intabulate 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 au fost intabulate 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. Din cauza 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 este posibil să se nu potrivească exact cu numărul total de rezultate disponibile utilizatorului 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 ca numărul real de rezultate returnate pentru pagina curentă (deoarece poate fi mai mic decât dimensiunea maximă specificată), 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>. Rețineți că anumite tipuri de interogări nu acceptă fragmente evidențiate, cum ar fi interogări fuzzy (~) și interogări wildcard (*). Această proprietate va fi null î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 de pagină de 10, această valoare va fi 11. |
| score | Scorul Lucene al rezultatului, ca valoare virgulă mobilă. Rezultatele vor fi returnate ordonate după această valoare. |
| titlu | 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). |
| Entitate | Returnează entități subiacente nodului. În cazul în care nodul nu are niciun tabel subiacent, această valoare va fi 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. În cazul în care nodul este nodul rădăcină, parent va fi null. |
| Funcția | Titlul nodului. |
| URL | Adresa URL a nodului. |
markere de site
Vă permite să încărcați orice marker de site după nume. În cazul în care markerul de site există, va fi returnat un obiect marker de site. Dacă nu este găsit un creator de site cu numele dat, se va returna nul.
{{ 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 va returna nul.
{{ 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. |
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ă va fi nulă.
utilizatorul este un obiect entitate.
{% 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, de asemenea, filtrul has_role pentru a testa calitatea de membru la unrol individual. |
| basic_badges_url | Returnează url-ul de serviciu pentru a prelua ecusoanele unui utilizator. Pentru a face ecusoane pentru un utilizator trebuie să includeți o etichetă cu atributele „date-ecuson” și „date-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ă există un set de linkuri web, va fi returnat un obiect set de linkuri web. Dacă nu este găsit un set de linkuri web cu numele sau ID-ul dat, se va returna nul.
<!-- 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 obiect de entitate, cu aceleași atribute, pe lângă cele enumerate mai jos.
| Atribut | Descriere |
|---|---|
| Copiere | 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 de entitate, cu aceleași atribute, pe lângă cele enumerate mai jos.
| 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. |
| Imagine | Imaginea linkului web pentru acest link. Acest atribut va fi nul în cazul în care 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. În cazul în care nu a fost furnizată nicio valoare de înălțime, acest atribut va fi nul. |
| URL | URL-ul imaginii. |
| Lățime | Întregi care conțin lățimea specificată a imaginii. În cazul în care nu a fost furnizată nicio valoare de lățime, acest atribut va fi 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.
Code
{{ website.adx_name }} ({{ website.id }})
Output
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 (evită 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 (evită 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.) |