Comparteix a través de

Etiquetes de plantilla

  • Article

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

fetchxml

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

Nota

Podeu obtenir més informació sobre com fer consultes a les dades amb fetchxml a Utilitzar FetchXML per consultar dades.

{% 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>.

Atribut de resultats

L'atribut de resultats a la variable proporcionada (com ara "resultVariable" a l'exemple anterior) conté els resultats de la consulta FetchXML 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>

  • TableName

    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.

  • MoreRecords

    Obté si hi ha més registres disponibles.

  • PagingCookie

    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.

Atribut XML

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

Altres elements i atributs compatibles

L'etiqueta de Liquid fetchxml admeten els atributs següents i elements secundaris.

Element/element secundari Atributs Element secundari
fetch mapping
version
count
page
paging-cookie
utc-offset
aggregate
distinct
min-active-row-version
output-format
returntotalrecordcount
no-lock		 order
entitat
ordre attribute
alias
descendent
entitat name
all-attributes
no-attrs
attribute		 order
filter
link-entity
filter type
hint
isquickfindfields		 condition
filter
link-entity name
from
to
alias
link-type
visible
intersect
all-attributes
no-attrs
attribute		 order
filter
link-entity
condició column
entityname
attribute
operator
aggregate
alias
uiname
uitype
uihidden
valor		 valor

inclou

Inclou el contingut d'una plantilla en una altra, pel seu nom. A Power Pages, l'origen d'aquesta plantilla, en general, serà 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 que s'ha inclòs tindrà accés a qualsevol variable que s'hagi definir 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 definiran com a variables a la plantilla inclosa.

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

bloc

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

prolongacions

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.

A Power Pages, el nom de la plantilla principal que s'ha proporcionat a l'etiqueta, en general, farà referència 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 no es substitueix un bloc que s'hagi definir a la plantilla principal, es representarà el contingut de la plantilla principal (si n'hi ha).

comentari

Permet deixar un codi sense representar a la plantilla de Liquid. El contingut del bloc no es representarà i no s'executarà cap codi de Liquid d'aquest.

Codi

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

Sortida

Hello. My name is Charles.

sense processar

Permet generar un codi de Liquid en una pàgina sense haver-lo d'analitzar ni executar.

Sortida

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

substitució

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.

Propina

L'adreça URL utilitzada per a request.url pot ser qualsevol valor sol·licitat i s'emmagatzema a la memòria cau per a sol·licituds posteriors. Per garantir el valor correcte a request.url, considereu la possibilitat d'utilitzar l'etiqueta de substitució, una adreça URL parcial, com ara ~{Ruta del fitxer web} o emmagatzemar l'adreça URL del portal a la Configuració del lloc.

codecomponent

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

Consulteu també

Etiquetes de flux de control
Etiquetes d’iteració
Etiquetes variables
Etiquetes de Liquid de Dataverse
Utilitzar l'etiqueta de plantilla de Liquid per als components de codi