Etiquetes de plantilla
Nota
Des del 12 d'octubre de 2022, els portals del Power Apps són Power Pages. Més informació: Microsoft Power Pages ara està disponible de manera general (bloc)
Ben aviat migrarem i combinarem la documentació dels portals del Power Apps amb la documentació del Power Pages.
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 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. Als portals del Power Apps, l'origen d'aquesta plantilla, en general, serà 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.
Als portals del Power Apps, 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. 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 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 d’entitat del Dataverse del Power Apps
Utilitzar l'etiqueta de plantilla de Liquid per als components de codi
Nota
Ens podeu dir quines són les vostres preferències d'idioma per a la documentació? Responeu una breu enquesta. (tingueu en compte que l'idioma de l'enquesta és l'anglès)
Trigareu uns set minuts a completar l'enquesta. No es recopilen dades personals (declaració de privadesa).
Comentaris
https://aka.ms/ContentUserFeedback.
Properament: al llarg del 2024 eliminarem gradualment GitHub Issues com a mecanisme de retroalimentació del contingut i el substituirem per un nou sistema de retroalimentació. Per obtenir més informació, consulteu:Envieu i consulteu els comentaris de