Compartir a través de


Objetos de Liquid disponibles

Los objetos de Liquid contienen atributos para emitir contenido dinámico a la página. Por ejemplo, el objeto Page tiene un atributo llamado Title que se puede usar para emitir el título de la página actual.

Para obtener acceso a un atributo de objeto por nombre, use un punto (.). Para generar el atributo de un objeto en una plantilla, inclúyalo entre {{ and }}.

Importante

Para evitar posibles problemas de secuencias de comandos entre sitios (XSS), utilice siempre filtro de escape para codificar datos en HTML siempre que se utilicen objetos Liquid para leer datos que no sean de confianza proporcionados por el usuario.

{{ page.title }}

También se puede acceder a los atributos de un objeto con un nombre de cadena y []. Esto formato es útil en casos en que el atributo necesario se determine dinámicamente, o el nombre de atributo contenga caracteres, espacios, caracteres especiales, etc. que invalidarían el uso de un punto (.) dentro de la sintaxis.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Los siguientes objetos se pueden usar y acceder a ellos en cualquier lugar de cualquier plantilla.

Objecto Description
entidades Permite cargar cualquier tabla de Microsoft Dataverse por Id. Más información: entidades
ahora Un objeto de fecha/hora que hace referencia a la hora UTC actual, en el momento que se representa la plantilla.
Nota: este valor es almacenado en la memoria caché de la aplicación web del portal y no siempre se actualiza. Más información: Filtros de fecha
página Hace referencia a la página de solicitud del portal actual. El objeto page proporciona acceso a los aspectos como rutas de navegación para la página actual, el título o la dirección URL de la página actual, y cualquier otro atributo o entidad relacionada de registro de Dataverse subyacente. Más información: página
parámetros Un acceso directo adecuado para request.params. Más información: solicitud
solicitud Contiene información acerca de la solicitud HTTP actual. Más información: solicitud
configuración Permite cargar cualquier configuración de sitio por nombre. Más información: configuración
mapa del sitio Permite el acceso al mapa del sitio del portal. Más información: mapa del sitio
marcadores de sitio Permite cargar cualquier marcador de sitio por nombre. Más información: marcadores del sitio
fragmentos Permite cargar cualquier fragmento de contenido por nombre. Más información: fragmentos
Usuario Hace referencia al usuario del portal actual, que permite el acceso a todos los atributos del registro de contacto de Dataverse subyacente. Si ningún usuario ha iniciado sesión, esta variable será null. Más información: usuario
weblinks Permite cargar cualquier Conjunto de vínculos web por nombre o Id. Más información: vínculos web
sitio web Hace referencia al registro de sitio web del portal, que permite el acceso a todos los atributos del registro del sitio web de Dataverse (adx_website) para el portal. Más información: sitio web

ads

Proporciona la capacidad de acceder y representar un anuncio.

El objeto ads permite seleccionar un anuncio o ubicación de anuncio específico:

<div>

{% assign ad = ads[Ad Name] %}

<h4>{{ ad.title }}</h4>

<a href={{ ad.redirect_url }}>

<img src={{ ad.image.url }} alt={{ ad.image.alternate_text }} />

</a>

</div>

Atributos de ads

Atributo Description
placements Devuelve el objeto de ubicaciones de anuncios.
[nombre o id de anuncio] Puede obtener acceso a cualquier anuncio por sus propiedades de nombre o id.
{% assign ad = ads[Ad Name] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Atributos de Ad Placements

Attribute Description
[nombre o identificador de colocación de anuncio] Puede obtener acceso a cualquier ubicación de anuncios por sus propiedades de nombre o id.
{% assign placement = ads.placements[Placement Name or Id] %}
{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Atributos de Ad Placement

Una ubicación de anuncio es un objeto de tabla con los mismos atributos generales y los atributos que se enumeran a continuación.

Atributo Descripción
Anuncios Devuelve la colección de objetos de anuncio asociados con la ubicación. Las etiquetas de iteración y los filtros de matriz se pueden usar con esta colección.
Name Devuelve el campo Nombre para la ubicación del anuncio.
placement_url La dirección URL que puede usarse para recuperar la ubicación del anuncio representada completamente por una plantilla.
random_url La dirección URL que puede usarse para recuperar un anuncio aleatorio de la ubicación representada completamente por una plantilla.

Atributos de Ad

Nota

Un anuncio es un objeto de tabla con los mismos atributos, además de los que se muestran a continuación.

Attribute Description
ad_url La dirección URL que puede usarse para recuperar el anuncio representada completamente por una plantilla.
Texto Devuelve el campo Texto del anuncio.
image Devuelve el objeto de imagen (si la hay) para el anuncio.
Name Devuelve el campo Nombre del anuncio.
open_in_new_window Devuelve true si la dirección URL especificada por redirect_url debe abrirse en una nueva ventana.
redirect_url La dirección URL a la que se reenviará al usuario al hacer clic en el anuncio.

Atributos de Ad Image

Attribute Description
alternate_text Devuelva el texto que está diseñado para que aparezca en el atributo alt de la etiqueta.
height Devuelve el alto en píxeles para la imagen
dirección url Devuelve el origen de la dirección URL de la imagen.
width Devuelve el ancho en píxeles para la imagen

blogs

Proporciona la capacidad de acceder y representar blogs y entradas de blog.

El objeto blogs permite seleccionar un blog específico o entradas de blog.

{% assign posts = blogs.posts | paginate: 0,4 %}

<div class=content-panel panel panel-default>

<div class=panel-heading>

{% assign sitemarker = sitemarkers["Blog Home"] %}

{% assign snippet = snippets[Home Blog Activity Heading] %}

<a class=pull-right href={{sitemarker.url}}> All Blogs </a>

<h4>

<a class=feed-icon fa fa-rss-square href={{ blogs.feedpath }} />

{{ snippet.adx_value }}

</h4>

</div>

<ul class=list-group>

{% for post in posts.all %}

<li class=list-group-item >

<a class=user-avatar href={{ post.author_url }}>

<img src={{ post.user_image_url }} />

</a>

<h4 class=list-group-item-heading>

<a href={{ post.app_relative_path }}>{{ post.title }}</a>

</h4>

<div class=content-metadata>

<abbr class=timeago>{{ post.publish_date }}</abbr>

&ndash;

<a href={{ post.author_url }}> {{ post.author_name }} </a>

&ndash;

<a href={{ post.application_path }}#comments>

<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}

</a>

</div>

</li>

{% endfor %}

</ul>

</div>

Objeto blogs

El objeto blogs permite tener acceso a cualquier blog específico en el portal, o tener acceso a todas las entradas de blog en el portal.

En la tabla siguiente se explican los atributos asociados con el objeto blogs.

Atributo Descripción
posts Devuelve un objeto blogposts que contiene todas las entradas de blog en el portal.
[nombre o identificador de blog] Puede obtener acceso a cualquier blog por sus propiedades de nombre o id.
{% assign blog = blogs["Blog Name"] %}                             

{% assign blog = blogs["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}  |

Objeto blog

El objeto blog permite trabajar con un solo blog, lo que permite obtener acceso a las entradas de ese blog.

En la tabla siguiente se explican los distintos atributos asociados con el objeto blog.

Atributo Descripción
posts Devuelve un objeto blogposts que contiene todas las entradas de ese blog.
Nombre El nombre del blog.
title El título del blog.
dirección url La dirección URL del blog.

Objeto blogposts

El objeto blogposts permite tener acceso a una colección de objetos de entradas de blog. Puede ordenar las entradas de blog y realizar la paginación además de utilizar filtros de Liquid:

{% assign blogposts = blogs.posts | order\_by “adx\_name”, “desc” | paginate: 0,4 | all %}

Otras opciones posibles:

  • blogs.posts.all (para obtener todas las entradas de blog)
  • blogs.posts | from\_index: 0 | take: 2

En la tabla siguiente se explican los distintos atributos asociados con el objeto blogposts.

Atributo Descripción
Todas Devuelve todos los objetos blogposts en la colección.

Objeto blogpost

Hace referencia a una sola entrada de blog.

En la tabla siguiente se explican los distintos atributos asociados con el objeto blogpost.

Atributo Descripción
Dirección URL URL de la entrada.
contenido Devuelve el campo Contenido de la entrada.
autor Devuelve los autores de la publicación (que es simplemente un objeto de tabla de contacto).
nombre El título de la entrada.
comment_count Devuelve el valor entero del recuento del número de comentarios para una entrada determinada.
publish_date La fecha en la que la publicación se publicó.

entidades

Precaución

Para evitar posibles problemas de scripting entre sitios (XSS), utilice siempre filtro de escape para codificar en HTML datos de cadena cada vez que se utilicen un objeto Liquid de entidades para leer datos proporcionados por el usuario en los que no se puede confiar.

Nota

Algunas de las convenciones de nomenclatura de Dataverse han cambiado, por ejemplo, las entidades de Dataverse ahora se llaman tablas. Los cambios de nombre no se aplican a los objetos de Liquid. El objeto de entidades líquidas seguirá denominándose como entidades.

Permite cargar cualquier tabla de Dataverse por Id. Si la tabla existe, se devolverá un objeto de tabla. Si no se encuentra una tabla con el Id. dado, se devolverá null.

{% assign account = entities.account['936DA01F-9ABD-4d9d-80C7-02AF85C822A8'] %}

{% if account %}

{{ account.name | escape }} ({{ account.statecode.label | escape }})

{% endif %}

{% assign entity_logical_name = 'contact' %}

{% assign contact = entities[entity_logical_name][request.params.contactid] %}

{% if contact %}

{{ contact.fullname | escape }} ({{ contact.parentcustomerid.name | escape }})

{% endif %}

Entity

Un objeto de entidad proporciona acceso a los atributos de un registro de tabla de Dataverse.

Atributo Descripción
Id. El Id. de GUID de la tabla, como cadena. Por ejemplo, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Nombre lógico de Dataverse de la tabla.
Notas Carga cualquier nota (anotación) asociada a la tabla, ordenada de la más antigua a la más nueva (createdon). Las notas se devuelven como objetos de nota.
permisos Carga resultados de la aserción de permiso de tabla para la tabla. Se devuelven los resultados como un objeto de permisos.
Dirección URL Devuelve la ruta de la dirección URL del sistema de administración del contenido de Power Pages para la tabla. Si la tabla no tiene una dirección URL válida en el sitio web actual, devuelve null. Normalmente, esto devolverá solo un valor para determinados tipos de tabla que se han integrado en la CMS del portal, a menos que haya personalizado el proveedor de la dirección URL en la aplicación.
[nombre de atributo o relación] Puede obtener acceso a cualquier atributo de la tabla de Dataverse por nombre lógico. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
Los valores de la mayoría de los atributos de tabla se asignan directamente a los tipos de Liquid: los campos de dos opciones se asignan a booleanos, los campos de texto a cadenas, los campos numérico o divisa a números, los campos de fecha y hora a objetos de fecha. Pero algunos tipos de atributos se devuelven como objetos:
  • Los campos de búsqueda (referencia de tabla asociada) se devuelven como objetos de referencia de tabla asociados.
  • Los campos de conjunto de opciones o de lista desplegable se devuelven como objetos de valor del conjunto de opciones.
  • También puede cargar cualquier entidad relacionada por nombre de esquema de la relación.
  • {{ page.adx_webpage_entitylist.adx_name }}En caso de que una relación sea reflexiva (es decir, que se haga referencia a sí misma), se devolverá un objeto de relación reflexiva. (Si no, el resultado sería ambiguo.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Nota: Cargar un gran número de entidades relacionadas, o acceder a un gran número de relaciones en una sola plantilla, puede tener un impacto negativo en el rendimiento de la representación de plantilla. Evite cargar entidades relacionadas para cada elemento de una matriz, en un bucle. Cuando sea posible, use etiquetas de tabla de Dataverse common data service para cargar colecciones de entidades.

Referencia de tabla asociada

Los valores de atributo de búsqueda se devuelven como objetos de referencia de la tabla asociada, con los siguientes atributos.

Atributo Descripción
Id. El Id. de GUID de la tabla a la que se hace referencia, como cadena.
Por ejemplo, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name El nombre lógico de Dataverse de la tabla referenciada.
Name El atributo de nombre principal de la tabla referenciada.

Nota

Una nota es un objeto de tabla que proporciona acceso a los atributos y relaciones de un registro de anotación. Además de todos los atributos de un objeto de tabla, una nota tiene los siguientes atributos adicionales.

Atributo Descripción
documentbody Carga el atributo documentbody del registro anotación de nota, como cadena codificada en Base64. Como el contenido de este atributo puede ser grande, no se carga con el resto de los atributos de nota y se carga solo según petición.
Nota: El uso del atributo documentbody podría tener un impacto negativo en rendimiento de representación de la plantilla, y se debe hacer con precaución.
Use el atributo url para proporcionar un vínculo con los datos adjuntos de nota en su lugar, si es posible.
dirección url Devuelve la dirección URL del controlador de datos adjuntos de la anotación del portal integrado. Si el usuario tiene permiso, y la nota tiene un archivo adjunto, una solicitud a esta dirección URL descargará el archivo adjunto de la nota.

Valor del conjunto de opciones

Los valores de atributo de conjunto de opciones/lista desplegable se devuelven como objetos de referencia de la tabla, con los siguientes atributos.

Atributo Descripción
Etiqueta La etiqueta localizada del valor de atributo del conjunto de opciones/lista desplegable. Por ejemplo, "Activo"
Valor El valor entero del valor de atributo del conjunto de opciones/lista desplegable. Por ejemplo, 0

Permisos de tabla

El objeto Permisos de tabla proporciona acceso a los resultados agregados de aserción de permisos para una tabla.

Attribute Description
can_append Devuelve true si el usuario actual tiene permiso para anexar registros a relaciones de este registro. De lo contrario, devuelve false.
can_append_to Devuelve true si el usuario actual tiene permiso para anexar este registro a una relación de otra tabla. De lo contrario, devuelve false.
can_create Devuelve true si el usuario actual tiene permiso para crear nuevos registros de este tipo de tabla. De lo contrario, devuelve false.
can_delete Devuelve true si el usuario actual tiene permiso para eliminar este registro. De lo contrario, devuelve false.
can_read Devuelve true si el usuario actual tiene permiso para leer este registro. De lo contrario, devuelve false.
can_write Devuelve true si el usuario actual tiene permiso para actualizar este registro. De lo contrario, devuelve false.
rules_exist Devuelve true si los resultados de permisos representados por este objeto son resultado de las reglas de permiso definidas explícitamente. Devuelve false si son los resultados predeterminados en ausencia de permisos definidos explícitamente.

Relación reflexiva

Los intentos de cargar relaciones reflexivas (es decir, que se hacen referencia a sí mismas) en entidades se devuelven como objetos con los siguientes atributos.

Attribute Description
is_reflexive Devuelve true. Se puede usar para comprobar si un objeto devuelto por una relación es un objeto de relación reflexiva.
referenced Devuelve una matriz de entidades referenciadas para la relación determinada.
referencing Devuelve una tabla de referencia para la relación determinada. Devuelve null si no existe una tabla de referencia. Si la relación es de varios a varios (N:N), devuelve una matriz de entidades de referencia.

entitylist

El objeto entitylist se utiliza dentro de las etiquetas de tabla de Dataverse. Proporciona acceso a todos los atributos de una determinada lista.

Atributos

Nota

entities

Attribute Description
create_enabled Devuelve true si la creación de nuevos registros se configura para la lista. De lo contrario, devuelve false.
create_url Devuelve la ruta URL configurada para un vínculo o un botón de creación para la lista.
detail_enabled Devuelve true si una vista de detalle para registros individuales se configura para la lista. De lo contrario, devuelve false.
detail_id_parameter Devuelve el nombre de parámetro de cadena de consulta que usará para el Id. de registro al crear una dirección URL de vista de detalle de registro. Vea Filtros de direcciones URL para obtener detalles sobre el uso de filtros de Liquid para generar URL. Por ejemplo, id.
detail_label Devuelve la etiqueta localizada configurada para vínculos o botones de vista de detalle para la lista.
detail_url Devuelve la ruta URL configurada para vínculos o botones de vista de detalle para la lista.
empty_list_text Devuelve el texto localizado configurado que se mostrará cuando la vista en lista no devuelva ningún resultado.
enable_entity_permissions Devuelve true si el filtro de permisos de tabla está habilitado para esta lista. De lo contrario, devuelve false.
entity_logical_name Devuelve el nombre lógico de la tabla de Dataverse para los registros que mostrará esta lista. Por ejemplo, contact
filter_account_attribute_name Devuelve el nombre lógico de atributo para la búsqueda a cuenta que usará para filtrar los registros de resultado la cuenta primaria del usuario del portal actual. Por ejemplo, accountid
filter_apply_label Devuelve la etiqueta localizada configurada que se usará para el vínculo/botón que aplica un filtro de atributo avanzado a los resultados de la lista.
filter_definition Devuelve la definición de filtro de atributo JSON para la lista. Vea Filtros de lista para obtener información sobre cómo usar el filtro de Liquid de metafiltros para procesar esta definición.
filter_enabled Devuelve true si el filtro de atributo avanzado está habilitada para la lista. De lo contrario, devuelve false.
filter_portal_user_attribute_name Devuelve el nombre lógico de atributo para la búsqueda a contacto que se usará para filtrar los registros de resultado el contacto del usuario del portal actual. Por ejemplo, contactid
filter_website_attribute_name Devuelve el nombre lógico de atributo para la búsqueda a adx_website que usará para filtrar los registros de resultado el sitio web del portal actual. Por ejemplo, adx_websiteid
código_idioma Devuelve el código de idioma entero de Dataverse que se usará para seleccionar todas las etiquetas localizadas para esta lista.
page_size Devuelve el tamaño de página de resultados configurada para la lista.
primary_key_name Devuelve el nombre lógico de atributo de clave principal para los registros que mostrará esta lista.
search_enabled Devuelve true si la búsqueda está habilitada para esta lista. De lo contrario, devuelve false.
search_placeholder Devuelve el texto localizado configurado para el marcador de posición del campo de búsqueda en la lista.
search_tooltip Devuelve el texto localizado configurado para la información sobre herramientas de búsqueda en la lista.
vistas Devuelve las vistas disponibles para la lista, como objetos de vista de lista.
[nombre lógico del atributo] Puede obtener acceso a cualquier atributo del registro de Dataverse de la lista (adx_entitylist) por nombre lógico, de la misma forma que un objeto de tabla. Por ejemplo, {{ entitylist.adx_name }}

Lista de atributos de vista

Attribute Description
columnas Devuelve las columnas de la vista como objetos de columna de vista de la lista.
entity_logical_name Devuelve el nombre lógico de la tabla de Dataverse para los registros incluidos en la vista. Por ejemplo, contact
Id Devuelve el identificador de GUID de la vista.
código_idioma Devuelve el código de idioma entero de Dataverse que se usará para seleccionar todas las etiquetas localizadas (encabezados de columna, etc.) para la vista.
Name Devuelve el nombre para mostrar de Dataverse de la vista.
primary_key_logical_name Devuelve el nombre lógico de clave principal de la tabla de Dataverse para los registros incluidos en la vista. Por ejemplo, contactid
sort_expression Devuelve la expresión de ordenación predeterminada para la vista. Por ejemplo, name ASC, createdon DESC

Atributos de columna de vista de lista

Attribute Description
attribute_type Devuelve el nombre del tipo de atributo de Dataverse para la columna, como cadena. Por ejemplo, Lookup, Picklist, String, Boolean, DateTime
logical_name Devuelve el nombre lógico de atributo de Dataverse para la columna. Por ejemplo, createdon
Nombre Devuelve el nombre para mostrar de Dataverse localizado para la columna. Por ejemplo, Created On
sort_ascending Devuelve una cadena de expresión de orden para ordenar la columna en orden ascendente. Por ejemplo, createdon ASC
sort_descending Devuelve una cadena de expresión de orden para ordenar la columna en orden descendente. Por ejemplo, createdon DESC
sort_disabled Devuelve true si el orden está deshabilitado para la columna. De lo contrario, devuelve false.
sort_enabled Devuelve true si el orden está habilitado para la columna. De lo contrario, devuelve false.
width Devuelve el ancho configurado para la columna, en píxeles.

entityview

El objeto entityview se usa dentro de la etiqueta entityview y proporciona acceso a los metadatos de la vista, así como registros de los resultados de la vista.

Atributos

Atributo Descripción
columnas Devuelve las columnas de la vista, como objetos de columna de vista de tabla.
entity_permission_denied Devuelve true si el acceso a los resultados de la vista se ha denegado debido a permisos de tabla insuficientes para el usuario actual. Devuelve false si se ha concedido acceso de lectura a los resultados de la vista.
entity_logical_name El nombre lógico de la tabla de Dataverse de los registros de resultados de la vista. Por ejemplo, contact
first_page El número de página de la primera página de los resultados de vista. Será 1 a menos que no hubiera resultados devueltos, en cuyo caso será null.
Id. El Identificador GUID de la vista de Dataverse que define esta entityview.
código_idioma El código de idioma entero de Dataverse que se usa para cargar etiquetas localizadas para la vista actual.
last_page El número de página de la última página de los resultados de vista. Si no hay resultados devueltos, será null.
nombre El nombre de la vista de Dataverse que define esta entityview., por ejemplo, Contactos activos.
next_page El número de página de la siguiente página de los resultados de vista. Si no hay siguiente página de resultados, será null.
Página El número de página de la página actual de los resultados de vista.
pages Devuelve una matriz de números de página que contiene todas las páginas de resultados de la vista actual.
page_size El número de resultados devueltos por página para la vista actual.
previous_page El número de página de la siguiente página de los resultados de vista. Si no hay página anterior de resultados, será null.
primary_key_logical_name El nombre lógico de Dataverse del atributo de clave principal de la tabla de resultado para esta vista. Por ejemplo, contactid.
registros La página actual de los registros de resultado de la vista, como objetos de tabla.
sort_expression Expresión de ordenación predeterminada para la vista. Por ejemplo, nameASC, createdon DESC.
total_pages El número total de páginas de resultados para la vista.
total_records El número total de resultados para la vista (en todas las páginas).

eventos

Proporciona la capacidad de acceder y representar eventos. El objeto events permite seleccionar un evento específico o todos los eventos.

Objeto events

El objeto events permite tener acceso a cualquier evento específico del portal, o tener acceso a todos los eventos del portal (independientemente del evento).

El objeto events tiene los siguientes atributos:

Atributo Descripción
occurences Devuelve un objeto eventoccurancess que contiene todas las instancias del evento en el portal
[event name or id] Puede obtener acceso a cualquier evento por sus propiedades de nombre o id.
{% assign event = events["Event Name"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Objeto event

El objeto event permite trabajar con un solo evento, lo que permite obtener acceso a las programaciones e instancias de ese evento.

El objeto event tiene los siguientes atributos:

Atributo Descripción
repeticiones Devuelve un objeto eventoccurrences que contiene todas las instancias del evento.
nombre El nombre del evento.
dirección url Dirección URL del evento.

Objeto eventoccurences

El objeto eventoccurrences permite tener acceso a una colección de objetos de instancias del evento. Puede ordenar las instancias del evento y especificar un intervalo de fechas para las instancias a recuperar, y realizar paginación así como utilizar filtros de Liquid.

{% assign occurances = event.occurrences.from[today].to[advance_date] %}

tenga en cuenta que

{% assign occurances = event.occurrences.min[today].max[advance_date] %}

también es posible.

Los siguientes atributos se asocian con el objeto eventoccurrences

Atributo Descripción
Todas Devuelve todos los objetos eventoccurrence en la colección.

Objeto eventoccurence

Representa una sola instancia del evento. Los atributos asociados se indican a continuación:

Attribute Description
Dirección URL Dirección URL de la instancia.
is_all_day_event ¿Se trata de un evento de todo el día?
start_time Las horas de inicio del evento.
end_time Las horas de finalización del evento.

forloop

Contiene propiedades útiles en un bloque de bucle para.

Nota

forloop solo se puede usar dentro de una etiqueta para.

Code

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

This is child page number {{ forloop.index }}.

{% endif %}

{% endfor %}

Output

This is the first child page!

This is child page number 2.

This is child page number 3.

Atributos

Atributo Descripción
primero Devuelve true si es la primera iteración del bucle. Devuelve false si no es la primera iteración.
index La ubicación del elemento actual en la colección, donde el primer artículo tiene una posición de 1.
index0 La ubicación del elemento actual en la colección, donde el primer artículo tiene una posición de 0.
Última Devuelve true si es la última iteración del bucle. Devuelve false si no es la última iteración.
length Devuelve el número de iteraciones para el de bucle ߝ el número de elementos en la colección que se está iterando.
rindex Número de elementos que permanecen en el bucle (duración - índice) donde 1 es el índice del último elemento.
rindex0 Número de elementos que permanecen en el bucle (duración - índice) donde 0 es el índice del último elemento.

foros

Proporciona la capacidad de acceder y representar foros e hilos de foros. La posibilidad de usar Liquid para representar datos de foros se amplía a las entradas, pero para crear una nueva entrada o hilo, debe usar una plantilla de página de formulario de varios pasos ASP.NET con dicha funcionalidad integrada (por ejemplo, las plantillas predeterminadas de página de hilos y entradas de foro).

El objeto de foros permite seleccionar un foro o hilos de foro:

<div class=content-panel panel panel-default>

<div class=panel-heading>

<h4>

<span class=fa fa-comments aria-hidden=true></span>

{{ snippets[Home Forum Activity Heading] | default: Forum Activity | h }}

</h4>

</div>

{% for forum in website.forums %}

<ul class=list-group>

<li class=list-group-item>

<div class=row>

<div class=col-sm-6>

<h4 class=list-group-item-heading><a href="{{ forum.url | h }}"> {{ forum.name | h }}</a></h4>

<div class=list-group-item-text content-metadata>{{ forum.adx_description | h }}</div>

</div>

<div class=col-sm-3 content-metadata>{{ forum.thread_count }} threads</div>

<div class=col-sm-3 content-metadata>{{ forum.post_count }} posts</div>

</div>

</li>

</ul>

{% endfor %}

</div>

Objetos foros

El objeto foros permite tener acceso a cualquier foro específico en el portal, o tener acceso a todos hilos de foro en el portal (independientemente del foro).

El objeto forum permite trabajar con un solo foro, lo que permite obtener acceso a los hilos del foro.

El objeto forumthreads permite tener acceso a una colección de objetos de hilos de foro. Puede ordenar los hilos de foro y realizar paginación además de utilizar filtros de Liquid.

{% assign threads = forum.threads | order_by adx_name, desc | paginate: 0,4 | all %}

Un único hilo del foro

El objeto forumposts permite tener acceso a una colección de objetos de entrada de foro.

Atributos

Atributo Descripción
threads Devuelve un objeto forumthreads que contiene todos los objetos forumthread en el portal.
Todas Devuelve todos los objetos forum del portal. Tenga en cuenta que website.forums es también un equivalente.
thread_count Devuelve el valor de entero del recuento del número de hilos que hay en el sitio web completo.
post_count Devuelve el valor de entero del número total de publicaciones del portal.
[nombre o identificador del foro] Puede obtener acceso a cualquier foro por sus propiedades de nombre o id.
`{% assign forum = forums[Forum Name] %}
{% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Objeto forum

Atributos

Nota

entities

Attribute Description
threads Devuelve un objeto forumthreads que contiene todos hilos del foro.
Name El nombre del foro.
thread_count Devuelve el valor entero del recuento del número de hilos que hay en el foro.
post_count Devuelve el valor entero del recuento del número de entradas que hay en todo el foro.

Objeto forumthreads

Atributos

Atributo Descripción
Todas Devuelve todos los objetos forumthread en la colección.

Objeto forumthread

Atributos

Nota

entities

Attribute Description
posts Devuelve un objeto forumposts que contiene todas las entradas de foro del hilo.
author Devuelve el autor del hilo (que es simplemente un objeto de tabla de contacto).
latest_post Devuelve la última entrada del hilo.
first_post Devuelve la primera entrada del hilo.
post_count Devuelve el valor de entero del recuento del número de entradas que hay en el hilo.
is_answered ¿Se ha respondido al hilo o no?
is_sticky ¿Es el hilo un hilo pegajoso?

Objeto forumposts

Atributos

Atributo Descripción
Todas Devuelve todos los objetos forumthread en la colección.

Una sola entrada del foro

Atributos

Nota

entities

Attribute Description
autor Devuelve el autor de la publicación (que es simplemente un objeto de tabla de contacto).
contenido Contenido de la entrada.
is_answer ¿Es esta entrada una respuesta al hilo?

Conocimiento

Proporciona acceso al artículo de conocimiento de Dataverse y a los registros de tabla de categoría para representar los artículos y las categorías en un portal.

Atributos

Atributo Descripción
artículos Devuelve un objeto de artículo que contiene los objetos de artículo para los registros de tabla de los artículos de conocimiento disponibles en el portal.
categorías Devuelve un objeto de categoría que contiene los objetos de categoría para los registros de tabla de las categorías disponibles en el portal.

objeto de artículos

El objeto de artículos permite tener acceso a una colección de objetos de artículo. Puede ordenar los artículos y realizar paginación además de utilizar filtros de Liquid.

{% assign count = count | default: 3 %}
{% assign languagecode = website.selected_language.code %}
{% assign popular_articles = knowledge.articles | popular: count,languagecode  %}
{% if popular_articles %}
    <div class=list-group>
    {% for article in popular_articles %}
      <div class=list-group-item clearfix>
        <a class=title href={{ article.url | escape }}>{{ article.title | escape }}</a>
        <p class=description>{{ article.description | escape }}</p>
      </div>
    {% endfor %}
    </div>
{% endif %}

Atributos

Atributo Descripción
Popular Devuelve una recopilación de objetos del artículo que contiene los más vistos. {% assign popular_articles = knowledge.articles.popular %}
reciente Devuelve una recopilación de objetos del artículo que contiene los últimos modificados. {% assign recent_articles = knowledge.articles.recent %}
superior Devuelve una recopilación de objetos del artículo que contiene los de mayor interés. {% assign top_articles = knowledge.articles.top %}

Filtros

Los filtros siguientes pueden admitir parámetros opcionales para el tamaño de página y el idioma. El primer parámetro es el número o los registros a recuperar. El tamaño de página predeterminado es 5. El segundo parámetro es el código de un idioma para recuperar los artículos de un idioma determinado. Los filtros se pueden combinar con otros Filtros Liquid.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}
Atributo Descripción
Popular Devuelve una recopilación de objetos del artículo que contiene los más vistos. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
reciente Devuelve una recopilación de objetos del artículo que contiene los últimos modificados. {% assign recent_articles = knowledge.articles \| recent: 5 %}
superior Devuelve una recopilación de objetos del artículo que contiene los de mayor interés. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

objeto de categorías

El objeto categorías permite tener acceso a una colección de objetos de categorías. Puede ordenar las categorías y realizar paginación además de utilizar filtros de Liquid.

{% assign category_url = sitemarkers['Category'].url %}
  {% assign count = count | default: 0 %}  
  {% assign categories = knowledge.categories | top_level: count %}
  {% if categories %}
    <div class=list-group unstyled>
    {% for category in categories %}
      <a href={{ category_url | add_query: 'id', category.categorynumber }} class=list-group-item>
        {{ category.title }}
      </a>
    {% endfor %}
    </div>
  {% endif %}

Atributos

Atributo Descripción
reciente Devuelve una recopilación de objetos de categorías que contiene los últimos modificados.
top_level Devuelve una recopilación de objetos de categorías que no tiene una categoría principal.

Filtros

Los filtros siguientes pueden admitir un parámetro opcional que indique el tamaño de página. El tamaño de página predeterminado es 5. Los filtros se pueden combinar con otros Filtros Liquid.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Atributo Descripción
reciente Devuelve una recopilación de objetos de categorías que contiene los últimos modificados. Puede proporcionar parámetros {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level Devuelve una recopilación de objetos de categorías que no tiene una categoría principal. {% assign root_categories = knowledge.categories \| top_level %}

objeto de artículos

El objeto de artículo permite trabajar con un solo artículo de conocimiento para mostrar los detalles del artículo en el portal.

Atributos

el artículo es un objeto de entidad, con todos los mismos atributos, además de los que se muestran a continuación.

Atributo Descripción
article_public_number El número público de artículo del artículo.
comment_count El valor entero del recuento del número de comentarios de un artículo determinado.
content El contenido del artículo.
current_user_can_comment Devuelve un valor booleano que indica si el usuario actual puede agregar comentarios en el artículo.
is_rating_enabled Devuelve un valor booleano que indica si está habilitado el nivel de interés en un artículo.
palabras clave Las palabras clave del artículo.
nombre Un alias alternativo para el título del artículo.
nivel de interés El valor decimal del nivel de interés en el artículo.
title Título del artículo.
view_count El valor entero del número de veces que el artículo se ha visto.

objeto de categorías

El objeto de categoría permite trabajar con una sola categoría para mostrar los detalles en el portal.

Atributos

la categoría es un objeto de entidad, con todos los mismos atributos, además de los que se muestran a continuación.

Atributo Descripción
número de categoría El número de categoría de la categoría.
nombre Un alias alternativo para el título de la categoría.
título El título de la categoría.

lenguaje

Proporciona el nombre del idioma actual y el código de idioma si la compatibilidad con varios idiomas está habilitada.

Atributos

Atributo Descripción
dirección URL La dirección URL de solicitud actual con el prefijo del código de idioma actual.
url_substitution La dirección URL de solicitud actual con el prefijo del código de idioma actual sin pasar por la caché de salida de la página.
nombre Título del idioma actual.
código El código de idioma del idioma.

Por ejemplo, la plantilla web Lista desplegable de idiomas usa de forma predeterminada este objeto líquido para listar los idiomas disponibles cuando hay varios idiomas disponibles.

página

Hace referencia a la página de solicitud del portal actual. Este objeto combina los atributos del mapa del sitio y la solicitud actual entidades (generalmente, una página web).

El objeto page proporciona acceso a los aspectos como rutas de navegación para la página actual, el título o la dirección URL de la página actual, y cualquier otro atributo o entidad relacionada de registro de Dataverse subyacente.

<ul class=breadcrumb>

{% for crumb in page.breadcrumbs %}

<li><a href={{ crumb.url | escape }}>{{ crumb.title | escape }}</a></li>

{% endfor %}

<li class=active>{{ page.title | escape }}</li>

</ul>

<div class=page-header>

<h1>{{ page.title | escape }}</h1>

</div>

<div class=page-copy>

{{ page.adx_copy }}

</div>

<div class=list-group>

{% for child in page.children %}

<a class=list-group-item href={{ child.url | escape }}>

{{ child.title | escape }}

</a>

{% endfor %}

</div>

<!-- Page {{ page.id }} was last modified on {{ page.modifiedon }}. -->

Atributos de página

Nota

entities

Attribute Description
breadcrumbs Devuelve los objetos de nodo del mapa del sitio de ruta de navegación para la página, empezando desde el nodo raíz del mapa del sitio y terminando en el principal.
children Devuelve objetos de nodo de mapa del sitio secundario de la página.
parent Devuelve el nodo de mapa del sitio principal de la página. Si la página es la página principal, el principal será nulo.
nombre El título de la página.
Dirección URL Dirección URL de la página.
[nombre de atributo o relación] Puede obtener acceso a cualquier atributo del registro de Dataverse subyacente de la página por nombre lógico.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
Los valores de la mayoría de los atributos de tabla se asignan directamente a los tipos de Liquid: los campos de dos opciones se asignan a booleanos, los campos de texto a cadenas, los campos numérico o divisa a números, los campos de fecha y hora a objetos de fecha. Pero algunos tipos de atributos se devuelven como objetos:
  • Los campos de búsqueda (referencia de tabla asociada) se devuelven como objetos de referencia de tabla asociados.
  • Los campos de conjunto de opciones o de lista desplegable se devuelven como objetos de valor del conjunto de opciones.
  • También puede cargar cualquier entidad relacionada por nombre de esquema de la relación.
    {{ page.adx_webpage_entitylist.adx_name }}
    En caso de que una relación sea reflexiva (es decir que haga referencia a sí misma), se devolverá un objeto entidades. (Si no, el resultado sería ambiguo.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Nota: Cargar un gran número de entidades relacionadas, o acceder a un gran número de relaciones en una sola plantilla, puede tener un impacto negativo en el rendimiento de la representación de plantilla. Evite cargar entidades relacionadas para cada elemento de una matriz, en un bucle. Cuando sea posible, se recomienda el uso de etiquetas de tabla de Dataverse para cargar colecciones de entidades.

sondeos

Proporciona la capacidad de acceder y representar un sondeo.

El objeto polls permite seleccionar un sondeo o ubicación de sondeo específico:

<div>

{% assign poll = polls[Poll Name] %}

<h4>{{ poll.question }}</h4>

{% for option in poll.options %}

<div>

<input type=radio name={{ poll.name }} id={{ option.id }} />

<label for={{ option.id }}>{{ option.answer }}</label>

</div>

{% endfor %}

<button type=button>{{ poll.submit_button_label }}</button>

</div>

Atributos de sondeos

Atributo Description
placements Devuelve el objeto pollplacements.
[nombre o identificador del sondeo] Puede obtener acceso a cualquier sondeo por sus propiedades de nombre o id. {% assign poll = polls[Poll Name] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Atributos de ubicaciones de sondeos

Attribute Description
[nombre o identificación de ubicación de sondeo] Puede obtener acceso a cualquier ubicación de sondeo por sus propiedades de nombre o id.{% assign placement = polls.placements[Placement Name or Id] %}
{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Atributos de ubicación de sondeos

Nota

entities

Attribute Description
Name Devuelve el campo Nombre para la ubicación del sondeo.
placement_url La dirección URL que puede usarse para recuperar la ubicación del sondeo representada completamente por una plantilla.
sondeos Devuelve la colección de objetos de sondeo asociados con la ubicación. Las etiquetas de iteración y los filtros de matriz se pueden usar con esta colección.
random_url La dirección URL que puede usarse para recuperar un sondeo aleatorio de la ubicación representada completamente por una plantilla.
submit_url La dirección URL a la que se envía un sondeo completado.

Atributos de sondeo

Nota

entities

Attribute Description
has_user_voted Devuelve true si el usuario actual (que ha iniciado sesión o anónimo) ya ha votado en este sondeo.
Nombre Devuelve el campo Nombre para el sondeo.
opciones Devuelve la colección de objetos poll option asociados con el sondeo. Las etiquetas de la iteración y las entidades se puede usar con esta colección.
poll_url La dirección URL que puede usarse para recuperar el sondeo representada completamente por una plantilla.
pregunta Devuelve el campo Pregunta para el sondeo.
submit_button_label Devuelve una cadena que se puede usar para reemplazar la etiqueta del botón enviar para el sondeo.
submit_url La dirección URL a la que se envía un sondeo completado.
user_selected_option Devuelve el objeto polloption seleccionado por el usuario (si ya ha votado).
votes Devuelve el número de votos que se han tabulado para el sondeo.

Atributos de la opción de sondeo

Nota

entities

Attribute Description
answer Devuelve el campo Respuesta para el sondeo.
percentage Devuelve el porcentaje de votos en el sondeo para la opción como número decimal entre 0 y 100.
votes Devuelve el número de votos que se han tabulado para la opción.

solicitud

Contiene información acerca de la solicitud HTTP actual.

{% assign id = request.params['id'] | escape %}

<a href={{ request.url | add_query: 'foo', 1 | escape }}>Link</a>

Nota

  • Puede crear direcciones URL dinámicamente en Liquid utilizando filtros de dirección URL.
  • La URL utilizada en request.url puede ser cualquier valor solicitado, y se añade al 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.
  • La versión de lanzamiento de Power Pages 9.3.8.x o posterior tendrá activada de forma predeterminada el filtro Liquid de escape para objetos Liquid de usuario y solicitud. Para deshabilitar esta configuración predeterminada y permitir que estos objetos Liquid sin filtro Liquid de escape, consulte Configuración del sitio de portales: Site/EnableDefaultHtmlEncoding.

Atributos

Atributo Descripción
parámetros Valores de parámetros con nombre para la solicitud actual. params es una combinación de parámetros de cadena de consulta de la dirección URL, parámetros de entrada de formulario, y cookies.
Path La ruta de dirección URL de la solicitud actual.
/profile/
path_and_query La ruta y consulta de la dirección URL de la solicitud actual.
/profile/?foo=1&bar=something
query La parte de consulta de la dirección URL de la solicitud actual.
?foo=1&bar=something
Dirección URL La dirección URL completa de la solicitud actual.
https://www.example.com/profile/?foo=1&bar=something

searchindex

El objeto searchindex se usa dentro de las etiquetas de tabla de Dataverse y proporciona acceso a los resultados de una consulta.

{% searchindex query: 'support', page: params.page, page_size: 10 %}

{% if searchindex.results.size > 0 %}

<p>Found about {{ searchindex.approximate_total_hits }} matches:</p>

<ul>

{% for result in searchindex.results %}

<li>

<h3><a href={{ result.url | escape }}>{{ result.title | escape }}</a></h3>

<p>{{ result.fragment }}</p>

</li>

{% endfor %}

</ul>

{% else %}

<p>Your query returned no results.</p>

{% endif %}

{% endsearchindex %}

Atributos

Attribute Description
approximate_total_hits Devuelve un recuento aproximado de los aciertos generales que coinciden con la consulta de índice. Debido a la forma de funcionar del índice de búsqueda en relación con el filtrado de seguridad y otros factores de diseño, este número sólo es una aproximación, puede no coincidir exactamente con el número total de resultados disponibles al usuario actual en algunos casos.
Página Devuelve el número de página de la consulta actual.
page_size Devuelve el tamaño de página máximo de la consulta actual. Si desea que el número real de resultados devueltos para la página actual (ya que puede ser inferior al tamaño máximo de página especificado), debe usar results.size.
Resultados Devuelve la página de resultados de la consulta, como objetos de resultados de índice de búsqueda.

Resultados de índice de búsqueda

Atributo Descripción
entidad Las entidades subyacentes para el resultado.
fragment Un fragmento de texto corto relevante para el resultado, con los términos que coinciden con la consulta especificada resaltada utilizando la etiqueta HTML <em>. Determinados tipos de consultas no admiten fragmentados resaltados, como las consultas aproximadas (~) y consultas comodín (*). Esta propiedad será nula en esos casos.
Id El Id. de tabla de Dataverse del registro subyacente para el resultado, como cadena. Por ejemplo, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name El nombre lógico de tabla de Dataverse del registro subyacente para el resultado. Por ejemplo, adx_webpage
número El número del resultado, a través de todas las páginas de resultado, empezando por 1. Por ejemplo, para el primer resultado de la segunda página de resultados, con un tamaño de página de 10, este valor será 11.
score La puntuación Lucene del resultado, como un valor de coma flotante. Los resultados serán devueltos ordenados por este valor.
title El título del resultado.
Dirección URL La dirección URL para el resultado. Esta será normalmente (pero no necesariamente) una ruta de acceso absoluta de la aplicación actual, en lugar de la dirección URL completa. Por ejemplo: /articles/article1/

configuración

Permite cargar cualquier configuración de sitio por nombre. Si no se encuentra un valor con un nombre dado, se devolverá null.

Nota

Los valores se devuelven como cadenas, pero puede usar filtros de tipo para convertirlos en otros tipos.

{{ settings[My Setting] }}

{% assign search_enabled = settings[Search/Enabled] | boolean %}

{% if search_enabled %}

Search is enabled.

{% endif %}

{% assign pagesize = settings['page size'] | integer | default: 10 %}

{% if pagesize > 10 %}

Page size is greater than 10.

{% endif %}

mapa del sitio

Permite el acceso al mapa del sitio del portal.

<h1>{{ sitemap.root.title }}</h1>

<ul class=breadcrumb>

{% for crumb in sitemap.current.breadcrumbs %}

<li><a href={{ crumb.title }}>{{ crumb.title }}</a></li>

{% endfor %}

<li class=active>{{ sitemap.current.title }}</li>

</ul>

{% for child in sitemap.current.children %}

<a href={{ child.url }}>{{ child.title }}</a>

{% endfor %}

It's also possible to load a site map node by URL path:

{% assign node = sitemap[/content/page1/] %}

{% if node %}

{% for child in node.children %}

<a href={{ child.url }}>{{ child.title }}</a>

{% endfor %}

{% endif %}

Atributos del mapa del sitio

Atributo Descripción
Actuales Devuelve el objeto del nodo de mapa del sitio para la página actual.
Raíz Devuelve el objeto del nodo de mapa del sitio de la página raíz (principal) del sitio web.

Atributos del nodo del mapa del sitio

Atributo Descripción
Rutas de navegación Devuelve los objetos de nodo del mapa del sitio de ruta de navegación para el nodo, empezando desde el nodo raíz del mapa del sitio y terminando en el principal.
Secundarios Devuelve objetos de nodo de mapa del sitio secundario del nodo.
Descripción El contenido de descripción/resumen para el nodo. (Este campo puede contener HTML).
Entidad Devuelve las entidades subyacentes del nodo. Si el nodo no tiene una tabla subyacente, este valor será null.
is_sitemap_ancestor Devuelve true si el nodo del mapa del sitio es un antecesor del nodo actual, de lo contrario false.
is_sitemap_current Devuelve true si el nodo del mapa del sitio es el nodo actual, de lo contrario false.
Principal Devuelve el nodo de mapa del sitio principal del nodo. Si el nodo es el nodo raíz, principal será null.
Cargo El título del nodo.
dirección url La dirección URL del nodo.

marcadores de sitio

Permite cargar cualquier marcador de sitio por nombre. Si el marcador de sitio existe, se devolverá un objeto de marcador de sitio. Si no se encuentra un marcador de sitio con un nombre determinado, se devolverá null.

{{ sitemarkers[Login].url }}

{% assign my_sitemarker = sitemarkers["My Site Marker"] %}

{% if my_sitemarker %}

<a href={{ my_sitemarker.url }}>{{ my_sitemarker.adx_name }}</a>

{% else %}

Site marker My Site Marker does not exist.

{% endif %}

Atributos de marcador de sitio

Attribute Description
Dirección URL La dirección URL del destino del marcador de sitio.
[nombre lógico del atributo] Puede obtener acceso a cualquier atributo del registro de Dataverse de destino del marcador de sitio por nombre lógico. Por ejemplo, {{ sitemarker.adx_name }}

fragmentos

Permite cargar cualquier fragmento de contenido por nombre. Si no se encuentra un fragmento con un nombre dado, se devolverá null.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Contiene propiedades útiles en un bloque de bucle Etiquetas de iteración.

Nota

tablerowloop solo se puede usar dentro de una etiqueta de iteración.

Atributos

Atributo Descripción
Col Devuelve el índice de la fila actual, empezando en 1.
col0 Devuelve el índice de la fila actual, empezando en 0.
col_first Devuelve true si la columna actual es la primera columna de una fila, devuelve false si no lo es.
col_last Devuelve true si la columna actual es la última columna de una fila, devuelve false si no lo es.
Primera Devuelve true si es la primera iteración del bucle. Devuelve false si no es la primera iteración.
Índice La ubicación del elemento actual en la colección, donde el primer artículo tiene una posición de 1.
index0 La ubicación del elemento actual en la colección, donde el primer artículo tiene una posición de 0.
Última Devuelve true si es la última iteración del bucle. Devuelve false si no es la última iteración.
Duración Devuelve el número de iteraciones para el de bucle ߝ el número de elementos en la colección que se está iterando.
Rindex Número de elementos que permanecen en el bucle (duración - índice) donde 1 es el índice del último elemento.
rindex0 Número de elementos que permanecen en el bucle (duración - índice) donde 0 es el índice del último elemento.

Usuario

Hace referencia al usuario del portal actual, que permite el acceso a todos los atributos del registro de contacto de Dataverse subyacente. Si ningún usuario ha iniciado sesión, esta variable será null.

El usuario es un objeto de entidad.

{% if user %}
 
Hello, {{ user.fullname | escape }}!
 
{% else %}
 
Hello, anonymous user!
 
{% endif %}

Nota

La versión de lanzamiento de Power Pages 9.3.8.x o posterior tendrá activada de forma predeterminada el filtro Liquid de escape para objetos Liquid de usuario y solicitud. Para deshabilitar esta configuración predeterminada y permitir que estos objetos Liquid sin filtro Liquid de escape, consulte Configuración del sitio de portales: Site/EnableDefaultHtmlEncoding.

Atributos

Además de tener todos los atributos de un objeto de entidad, el usuario tiene los siguientes atributos.

Atributo Descripción
roles Devuelve los roles a los que pertenece el usuario como una matriz.
{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}
Nota: También puede usar el filtro has_role para probar las suscripciones de roles individuales.
basic_badges_url Devuelve la dirección URL del servicio para recuperar las insignias de un usuario.
Para que se muestren las insignias para un usuario, debe incluir una etiqueta con los atributos "data-badge" y "data-uri". Para mostrar las insignias del usuario actual:
<div data-badge data-uri='{{user.basic_badges_url }}'></div>
Para mostrar las insignias de un usuario por Id. (Id. de usuario variable):
<div data-badge data-uri='{{user.basic_badges_url

Permite cargar cualquier weblinks por nombre o Id.

Si existe el conjunto de vínculos web, se devolverá un objeto de conjunto de vínculos web. Si no se encuentra un conjunto de vínculos web con el nombre o el Id. dado, se devolverá null.

<!-- Load web link set by ID -->

{{ weblinks[page.adx_navigation.id].name }}

<!-- Load web link set by name -->

{% assign nav = weblinks[Primary Navigation] %}

{% if nav %}

<h1>{{ nav.title | escape }}</h1>

<ul>

{% for link in nav.weblinks %}

<li>

<a href={{ link.url | escape }} title={{ link.tooltip | escape }}>

{% if link.image %}

<img src={{ link.image.url | escape }} alt={{ link.image.alternate_text | escape }} />

{% endif %}

{{ link.name | escape }}

</a>

</li>

{% endfor %}

</ul>

{% endif %}

Nota

Un conjunto de vínculos web es un objeto de entidad, con todos los mismos atributos, además de los que se muestran a continuación.

Atributo Descripción
Copia Texto HTML del conjunto de vínculos web.
Nombre Nombre del conjunto de vínculos web.
Cargo Título del conjunto de vínculos web.
Weblinks La matriz de objetos de vínculo web asociada con el conjunto de vínculos web.
[nombre lógico del atributo] Puede obtener acceso a cualquier atributo del registro de Dataverse del conjunto de vínculos web por nombre lógico. Por ejemplo:{{ weblinkset.createdon }}

Nota

Un vínculo web es un objeto de entidad, con todos los mismos atributos, además de los que se muestran a continuación.

Atributo Description
Description Descripción HTML del vínculo web.
display_image_only Atributo booleano que indica si el vínculo web debe mostrarse solo como imagen, sin el texto del vínculo.
display_page_child_links Atributo booleano que indica si el vínculo web debe mostrar vínculos a páginas secundarias del mapa del sitio de la página vinculada, como vínculos secundarios.
Imagen El objeto de imagen de vínculo web para este vínculo. Este atributo será nulo si no hay imagen presente.
is_external Atributo booleano que indica si la dirección URL de destino del vínculo web es a un sitio externo (en lugar de una página del portal interno).
is_sitemap_ancestor Devuelve true si la dirección URL del vínculo web hace referencia a un antepasado del nodo del mapa del sitio actual, de lo contrario false.
is_sitemap_current Devuelve true si la dirección URL del vínculo web hace referencia a un nodo del mapa del sitio actual, de lo contrario false.
Nombre Nombre/título del vínculo web.
Nofollow Atributo booleano que indica si el vínculo web se debe marcar como rel=nofollow.
open_in_new_window Atributo booleano que indica si el vínculo web se debe abrir en una nueva ventana/pestaña del explorador cuando se selecciona.
Información sobre herramientas Texto de información sobre herramientas para el vínculo web.
dirección url Dirección URL del vínculo web.
Weblinks La matriz de objetos de vínculo web secundarios asociada con el vínculo web.
[nombre lógico del atributo] Puede obtener acceso a cualquier atributo del registro de Dataverse del vínculo web por nombre lógico. Por ejemplo:{{ weblink.createdon }}
alternate_text Texto alternativo para la imagen.
Height Entero que contiene el alto especificado de la imagen. Si no se proporcionó ningún valor de alto, este atributo será nulo.
dirección url Dirección URL de la imagen.
Ancho Entero que contiene el ancho especificado de la imagen. Si no se proporcionó ningún valor de ancho, este atributo será nulo.

sitio web

Hace referencia al sitio web del portal, que permite el acceso a todos los atributos del registro del sitio web de Dataverse (adx_website) para el portal.

Nota

El sitio web es un objeto de entidad, con todos los mismos atributos.

Code

{{ website.adx_name }} ({{ website.id }})

Salida

Community Portal (936DA01F-9ABD-4d9d-80C7-02AF85C822A8)

Atributos

La siguiente tabla enumera los atributos de esta etiqueta que se pueden usar sustituyendo los valores predeterminados para evitar el almacenamiento en caché.

Valor predeterminado Sustituir (evita el almacenamiento en caché) Ejemplo
sign_in_url sign_in_url_substitution Valor predeterminado: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F
Sustitución (evita el almacenamiento en caché): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F
("substitute-page" en este ejemplo reemplaza la dirección URL predeterminada en caché).
sign_out_url sign_out_url_substitution Valor predeterminado: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F
Sustitución (evita el almacenamiento en caché): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F
("substitute-page" en este ejemplo reemplaza la dirección URL predeterminada en caché).

Consultar también

Tipos Liquid
Etiquetas de Liquid
Filtros de Liquid