Compartir a través de

Etiquetas de plantilla

  • Artículo

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 mapping
version
count
page
paging-cookie
utc-offset
aggregate
distinct
min-active-row-version
output-format
returntotalrecordcount
no-lock		 order
entidad
pedido attribute
alias
descendente
entidad name
all-attributes
no-attrs
atributo		 order
filter
link-entity
filtrar type
hint
isquickfindfields		 condition
filtrar
link-entity name
from
to
alias
link-type
visible
intersect
all-attributes
no-attrs
atributo		 order
filter
link-entity
condition column
entityname
attribute
operator
aggregate
alias
uiname
uitype
uihidden
value		 value

incluir

Incluye el contenido de una plantilla en otra, por nombre. En Power Pages, el origen de esta otra plantilla será normalmente una plantilla web. Este operador 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 parámetros se definirán como variables de la plantilla incluida.

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

block

Se usa junto con extends para proporcionar herencia de plantilla. Vea extends para uso.

extends

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

En Power Pages, 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.

Code

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

Output

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é. Este operador 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.

Propina

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 Liquid de Dataverse
Usar componentes de código Etiqueta de plantilla Liquid