Compartir a través de

Etiquetas de plantilla

  • Artículo

Nota

A partir del 12 de octubre de 2022, los portales de Power Apps son Power Pages. Más información: Microsoft Power Pages ya está disponible para el público en general (blog)
Pronto migraremos y fusionaremos la documentación de los portales de Power Apps con la documentación de Power Pages.

Las etiquetas de plantilla controlan el resultado de una plantilla de varias formas, y permiten combinar varias plantillas en una sola.

fetchxml

Permite al usuario consultar datos de Microsoft Dataverse y representar los resultados en una página.

Nota

Puede obtener más información sobre cómo consultar los datos utilizando fetchxml en usar FetchXML para consultar datos.

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

Cuando utilice fetchxml para consultar datos, asegúrese de no utilizar etiquetas de cierre automático. Por ejemplo, en lugar de <attribute name="title"/>, use <attribute name="title"></attribute> con una etiqueta de cierre explícita </attribute>.

Atributo de resultados

El atributo de resultados en la variable proporcionada (como 'resultVariable' en el ejemplo anterior) contiene los resultados de la consulta FetchXML y otros atributos.

  • Entidades

    Este atributo contiene el resultado de la consulta fetchxml. Puede iterar el resultado y usarlo en su 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

    Obtiene el nombre lógico de la entidad.

  • ExtensionData

    Obtiene la estructura que contiene datos adicionales.

  • MinActiveRowVersion

    Obtiene el valor de versión de fila activa más bajo.

  • MoreRecords

    Obtiene si hay más registros disponibles.

  • PagingCookie

    Obtiene la información de paginación actual.

  • TotalRecordCount

    Obtiene el número total de registros de la colección.
    ReturnTotalRecordCount era verdadero cuando se ejecutó la consulta.

  • TotalRecordCountLimitExceeded

    Obtiene si los resultados de la consulta exceden el recuento total de registros.

Atributo XML

El atributo XML en la variable proporcionada (como 'resultVariable' en el ejemplo anterior) contiene la consulta resultante que se puede usar para obtener datos de Microsoft Dataverse. Este atributo es útil para fines de depuración cuando desea comprender cómo se aplica el permiso de tabla en esta etiqueta fetchxml.

Otros elementos y atributos admitidos

La etiqueta líquida fetchxml admite los siguientes atributos y elementos secundarios.

Elemento/elemento secundario Atributos Elemento secundario
fetch asignación
versión
recuento
página
paging-cookie
utc-offset
agregado
distinto
min-active-row-version
output-format
returntotalrecordcount
no-lock		 pedido
entidad
pedido atributo
alias
descendente
entidad name
all-attributes
no-attrs
atributo		 pedido
filtrar
link-entity
filtrar type
hint
isquickfindfields		 condition
filtrar
link-entity name
from
to
alias
link-type
visible
intersección
all-attributes
no-attrs
atributo		 pedido
filtrar
link-entity
condition columna
entityname
atributo
operador
agregado
alias
uiname
uitype
uihidden
value		 value

incluir

Incluye el contenido de una plantilla en otra, por nombre. En los portales de Power Apps, el origen de esta otra plantilla será normalmente una plantilla web. Esto permite la reutilización de fragmentos comunes de plantilla en varios lugares.

Cuando una plantilla se incluye en otra, la plantilla incluida tendrá acceso a las variables definidas en la plantilla primaria.

{% include 'My Template' %}

También es posible pasar cualquier número de parámetros con nombre a la etiqueta include. Estos a continuación se definirán como variables de la plantilla incluida.

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

block

Usado junto con extends para proporcionar herencia de plantilla. Vea extends para uso.

extends

Usado junto con la etiqueta block para proporcionar herencia de plantilla. Esto permite que varias plantillas usen un diseño compartido, al tiempo que reemplazan áreas específicas del diseño primario.

En los portales de Power Apps, el nombre de la plantilla primaria suministrado a la etiqueta normalmente hará referencia al nombre de una plantilla web.

Cuando se utiliza extends, debe ser el primer contenido de la plantilla, y solo puede ir seguido de una o más etiquetas block.

Si un bloque definido en la plantilla principal no se reemplaza, su contenido en la plantilla primaria (si lo hay) se representará.

comentario

Permite dejar código no representado dentro una plantilla de Liquid. No se representará ningún contenido dentro del bloque y no se ejecutará ningún código de Liquid dentro.

Código

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

Salida

Hello. My name is Charles.

raw

Permite la salida de código Liquid en una página sin tener que analizarla y ejecutarla.

Salida

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

sustitución

Cuando habilita el almacenamiento en caché de encabezados y pies de página, y desea evitar el almacenamiento en caché de determinada salida de sección, puede usar esta etiqueta. Esta etiqueta proporciona el bloque de contenido en el encabezado o pie de página donde el resultado del bloque de contenido envuelto no se almacena en caché. Esto es útil en escenarios en los que el usuario usa un objeto que se puede actualizar con frecuencia, como solicitud, página, idioma y fecha. Por ejemplo, consulte los escenarios de actualización del código fuente de la plantilla web de encabezado y pie de página cuando el almacenamiento en caché del encabezado y pie de página esté habilitado.

Sugerencia

La URL utilizada en request.url puede ser cualquier valor solicitado, y se añade a la caché para solicitudes posteriores. Para garantizar el valor correcto en request.url, considere usar etiqueta de sustitución, URL parcial como ~{Ruta del archivo web} o almacenar la URL del portal en Configuraciones del sitio.

codecomponent

Consulte Comprender codecomponent Etiquetas de entidad de Dataverse, Usar componentes de código Etiqueta de plantilla líquida.

Consulte también

Etiquetas de flujo de control
Etiquetas de iteración
Etiquetas variables
Etiquetas de entidad de Power Apps Dataverse
Usar componentes de código Etiqueta de plantilla Liquid

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).