Etichete de șablon

Notă

Începând cu 12 octombrie 2022, portalurile Power Apps sunt Power Pages. Mai multe informații: Microsoft Power Pages este acum disponibil în general (blog)
În curând vom migra și vom îmbina documentația portalurilor Power Apps cu documentația Power Pages.

Etichetele șablon controlează ieșirea unui șablon în diverse moduri și permite combinația de mai multe șabloane într-o singură ieșire.

fetchxml

Permite utilizatorului să interogheze datele de la Microsoft Dataverse și să redea rezultatele într-o pagină.

Notă

Puteți afla mai multe despre interogarea datelor utilizând fetchxml la utilizați FetchXML pentru a interoga date.

{% fetchxml resultVariable %}
<!— Fetchxml query -->
...
{% endfetchxml %}

Când utilizați FetchXML pentru interogarea datelor, asigurați-vă că nu utilizați etichete cu închidere automată. De exemplu, în loc de <attribute name="title"/>, utilizați <attribute name="title"></attribute> cu etichetă de închidere explicită </attribute>.

Atributul rezultate

Atributul Rezultate din variabila furnizată (cum ar fi „resultVariable” în eșantionul de mai sus) conține rezultatele interogării FetchXML și alte câteva atribute.

• Entităţi

  Acest atribut conține rezultatul interogării fetchxml. Puteți itera rezultatul și îl puteți folosi în șablonul dvs. webtemplate.

  <table> 
  {% for entityVariable in resultVariable.results.entities %} 
  <tr> 
  <td>Attribut-1: {{ entityVariable.attribute1 }}</td> 
  <td>Attribut-2: {{ entityVariable.attribute2 }}</td> 
  </tr> 
  {% endfor %} 
  </table> 
  

• TableName

  Obține numele logic al entității.

• ExtensionData

  Obține structura care conține date suplimentare.

• MinActiveRowVersion

  Obține cea mai mică valoare a versiunii de rând active.

• MoreRecords

  Obține dacă există mai multe înregistrări disponibile.

• PagingCookie

  Obține informațiile actuale de paginare.

• TotalRecordCount

  Obține numărul total de înregistrări din colecție.
  ReturnTotalRecordCount a fost adevărat atunci când a fost executată interogarea.

• TotalRecordCountLimitExceeded

  Obține dacă rezultatele interogării depășesc numărul total de înregistrări.

Atribut XML

Atributul XML din variabila furnizată (cum ar fi „resultVariable” în eșantionul de mai sus) conține interogarea rezultantă care poate fi folosită pentru a obține date de la Microsoft Dataverse. Acest atribut este util în scopul depanării atunci când doriți să înțelegeți cum se aplică permisiunea de tabel în această etichetă fetchxml.

Alte elemente și atribute acceptate

Eticheta fetchxml liquid acceptă următoarele atribute și elemente secundare.

Element/Element secundar	Atribute	Element secundar
preluare	mapare versiune contor pagină cookie de paginare utc-offset agregat distinct versiune rând activ min format de ieșire returntotalrecordcount fără blocare	ordine entitate
ordine	atribut alias descendentă
entitate	nume toate atributele no-attrs atribut	ordine filtrați entitate link
filtrați	tip indiciu isquickfindfields	condiție filtrați
entitate link	nume de la până la alias tip de link vizibil intersectare toate atributele no-attrs atribut	ordine filtrați entitate link
condiție	coloană nume entitate atribut operator agregat alias uiname uitype uihidden valoare	valoare

include

Include conținutul unui șablon într-altul, după nume. În portalurile Power Apps, sursa acestui șablon va fi în general un șablon web. Aceasta permite reutilizarea fragmentelor comune de șablon din mai multe locuri.

Atunci când un șablon este inclus într-altul, șablonul incluse va avea acces la orice variabile definite în șablonul părinte.

{% include 'My Template' %}

Este, de asemenea, posibil să treceți orice număr de parametri denumiți în eticheta include. Aceștia sunt definiți ca variabile în șablonul inclus.

{% include 'My Template' a:x, b:y %}

block

Utilizat în legătură cu extends pentru a oferi moștenirea șabloanelor. Consultați extends pentru utilizare.

se extinde

Utilizat în legătură cu eticheta block, oferă moștenirea șabloanelor. Acest lucru permite ca mai multe șabloane să utilizeze aspectul partajat, înlocuind în același timp zonele specifice ale aspectului părinte.

În portalurile Power Apps, numele șablonului principal oferit etichetei se va referi în general la numele unui șablon web.

Atunci când se utilizează extends, acesta trebuie să fie primul conținut din șablon și poate fi urmat doar de una sau mai multe etichete block.

În cazul în care un bloc definit în șablonul principal nu este suprascris, va fi redat conținutul său din șablonul principal (dacă este cazul).

comentariu

Vă permite să lăsați codul neredat în interiorul unui șablon Liquid. Orice conținut din cadrul blocului nu va fi redat și orice cod Liquid din acesta nu va fi executat.

Cod

Hello{% comment %}, {{ user.fullname }}{% endcomment %}. My name is Charles.

Ieșire

Hello. My name is Charles.

raw

Permite ieșirea unui cod Liquid pe o pagină fără ca acesta să fie analizat și executat.

Ieșire

Hello, {{ user.fullname }}. My name is Charles.

substituire

Când activați stocarea în cache a antetului și a subsolului și doriți să evitați stocarea în cache a anumitor secțiuni de ieșire, puteți utiliza această etichetă. Această etichetă oferă blocul de conținut din antet sau subsol în care ieșirea blocului de conținut încadrat nu se plasează în cache. Acest lucru este util în scenariile în care utilizatorul utilizează un obiect care poate fi actualizat frecvent, cum ar fi cererea, pagina, limba și data. De exemplu, consultați scenariile de actualizare ale codului sursă pentru antet și subsol web când Cache-ul pentru antet și subsol este activat.

Sfat

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.

codecomponent

Consultați Înțelegeți componenta codului Dataverse etichetă de entitate, Utilizați componentele codului eticheta șablon lichid.

Consultați și

Etichete de control al fluxului
Etichete de iterare
Etichete de variabile
Power Apps Dataverse etichete de entitate
Utilizarea etichetei de șablon Liquid pentru componente de cod

Notă

Ne puteți spune care preferințele dvs. lingvistice pentru documentație? Răspundeți la un chestionar scurt. (rețineți că acest chestionar este în limba engleză)

Chestionarul va dura aproximativ șapte minute. Nu sunt colectate date personale (angajament de respectare a confidențialității).