Etiquetes de plantilla

Les etiquetes de plantilla controlen la sortida d'una plantilla de diverses formes i permeten la combinació de diverses plantilles en una única sortida.

Permet a l'usuari consultar dades del Microsoft Dataverse i representar els resultats en una pàgina.

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

Quan utilitzeu fetchxml per consultar dades, assegureu-vos que no utilitzeu etiquetes amb tancament propi. Per exemple, en lloc de <attribute name="title"/>, utilitzeu <attribute name="title"></attribute> amb l'etiqueta de tancament explícita </attribute>.

L'atribut results de la variable proporcionada (com ara "resultVariable" a l'exemple anterior) conté FetchXML els resultats de la consulta i alguns altres atributs.

• Entitats

  Aquest atribut conté el resultat de la consulta FetchXML. Podeu iterar el resultat i utilitzar-lo a la plantilla web.

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

• Nom de la taula

  Obté el nom lògic de l'entitat.

• ExtensionData

  Obté l'estructura que conté dades addicionals.

• MinActiveRowVersion

  Obté el valor de versió de la fila activa més baix.

• MésRegistres

  Obté si hi ha més registres disponibles.

• Galeta de paginació

  Obté la informació de paginació actual.

• TotalRecordCount

  Obté el nombre total de registres a la col·lecció.
  ReturnTotalRecordCount era cert en executar la consulta.

• TotalRecordCountLimitExceeded

  Obté si els resultats de la consulta excedeixen el recompte total de registres.

XML de la variable proporcionada (com ara "resultVariable" a l'exemple anterior) conté la consulta resultant que es pot utilitzar per obtenir dades Microsoft Dataverse. Aquest atribut és útil per depurar finalitats quan voleu comprendre com s'aplica el permís de taula a aquesta etiqueta fetchxml.

L'etiqueta líquida Fetchxml admet els següents atributs i elements fills.

Inclou el contingut d'una plantilla en una altra, pel seu nom. A Power Pages més, l'origen d'aquesta altra plantilla és generalment una plantilla web. Aquest operador permet la reutilització de fragments de plantilla comuns en diversos llocs.

Quan una plantilla s'inclou en una altra, la plantilla inclosa té accés a qualsevol variable definida a la plantilla principal.

{% include 'My Template' %}

També es pot passar qualsevol número de paràmetres de nom a l'etiqueta inclosa. Aquests paràmetres es defineixen com a variables a la plantilla inclosa.

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

S'utilitza amb les ampliacions per proporcionar l'herència de la plantilla. Consulteu ampliacions per obtenir més informació sobre l'ús.

S'utilitza amb l'etiqueta block per proporcionar l'herència de la plantilla. Aquest operador permet que diverses plantilles utilitzin un disseny compartit, mentre que substitueixen zones específiques del disseny principal.

En Power Pages, el nom de la plantilla principal proporcionat a l'etiqueta generalment es refereix al nom d'una plantilla web.

Quan s'utilitzen les prolongacions, han de ser el primer contingut de la plantilla i només poden anar seguides de una o més etiquetes block.

Si un bloc definit a la plantilla principal no es sobreescriu, el seu contingut a la plantilla principal (si n'hi ha) es renderitza.

Permet deixar un codi sense representar a la plantilla de Liquid. Qualsevol contingut del bloc no es renderitza i no s'executa cap codi Liquid que hi ha.

Codi

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

Sortida

Hello. My name is Charles.

Aquesta característica us permet mostrar el codi Liquid en una pàgina sense analitzar-lo ni executar-lo.

Sortida

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

Quan habiliteu la memòria cau de la capçalera i del peu de pàgina i voleu evitar la memòria cau de la sortida de determinades seccions, podeu utilitzar aquesta etiqueta. Aquesta etiqueta proporciona el bloc de contingut a la capçalera o el peu de pàgina on la sortida del bloc de contingut envoltat no s'emmagatzema a la memòria cau. Aquest operador és útil en els escenaris en què l'usuari utilitza un objecte que es pot actualitzar sovint, com ara una sol·licitud, una pàgina, la llengua i la data. Per exemple, consulteu els escenaris d'actualització de codi font de la plantilla web de capçalera i peu de pàgina quan s'habilita l'emmagatzematge a la memòria cau de la capçalera i l'emmagatzematge.

Vegeu Comprendre l'etiqueta d'entitat del Dataverse codecomponent, Utilitzar l'etiqueta de plantilla de Liquid de components de codi.

Controlar les etiquetes de flux
Etiquetes d'iteració
Etiquetes variables
Dataverse Etiquetes líquides
Utilitzar components de codi Etiqueta de plantilla Liquid