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.

fetchxml

Permet a l'usuari consultar dades de 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 la mostra anterior) conté la consulta resultant que es pot utilitzar per obtenir dades de 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
recompte
pàgina
paging-cookie
utc-offset
aggregate
distinct
min-active-row-version
output-format
retorntotalrecordcount
no-lock
ordre
entitat
ordre attribute
alias
descendent
entitat nom
all-attributes
no-attrs
attribute
ordre
filter
link-entity
filter tipus
hint
isquickfindfields
condició
filter
link-entity nom
de
per a
alias
link-type
visible
intersecció
all-attributes
no-attrs
attribute
ordre
filter
link-entity
condició columna
entityname
attribute
operador
aggregate
alias
uiname
uitype
uihidden
valor
valor

inclou

Inclou el contingut d'una plantilla en una altra, pel seu nom. En Power Apps portals, l'origen d'aquesta altra plantilla serà generalment una plantilla web. això 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 es definiran com a variables a la plantilla inclosa.

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

bloc

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

prolongacions

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

En Power Apps portals, el nom de plantilla principal proporcionat a l'etiqueta generalment es referirà 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. Això é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.

Suggeriment

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 l'ús d'etiquetes de substitució, URL parcial com ~ {Camí del fitxer web} o emmagatzemar l'adreça URL del portal a Configuració del lloc.

codecomponent

Vegeu Entendre l'Dataverse etiqueta d'entitat, Utilitzeu els components del codi Etiqueta de plantilla líquida.

Consulteu també

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