Compartir por

Obxectos Liquid dispoñibles

  • Artigo

Os obxectos Liquid conteñen atributos para xerar contido dinámico para a páxina. Por exemplo, o obxecto da páxina ten un atributo chamado título que se pode usar para xerar o título da páxina actual.

Para acceder a un atributo de obxecto por nome, utilice un punto (.). Para procesar o atributo dun obxecto nun modelo, póñalle {{ and }}.

Importante

Para evitar posibles problemas de script entre sitios (XSS), use sempre o filtro de escape para os datos de codificación de HTML sempre que use obxectos Liquid para ler datos non fiables proporcionados polo usuario.

{{ page.title }}

Tamén se pode acceder aos atributos dun obxecto usando un nome de cadea e []. Este formato é útil nos casos en que o atributo requirido está determinado dinamicamente ou o nome do atributo contén caracteres, espazos, caracteres especiais, etc. que non serían válidos ao utilizar un punto (.) dentro da sintaxe.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Pódense usar os seguintes obxectos e acceder a eles desde calquera lugar, en calquera modelo.

Obxecto Descripción
entidades Permítelle cargar calquera táboa de Microsoft Dataverse por ID. Máis información: entidades
agora Oo bxecto de data/hora que se refire á hora UTC actual, no momento en que se procesa o modelo.
Nota: a aplicación web do portal almacena este valor na caché e non se actualiza cada vez. Máis información: Filtros de datos
páxina Refírese á páxina de solicitude de portal actual. O obxecto de páxina fornece acceso a cousas como listas de ligazóns para a páxina actual, o título ou o URL da páxina actual, e calquera outro atributo ou entidade relacionada do rexistro de Dataverse subxacente. Máis información: páxina
params Atallo práctico de request.params. Máis información: solicitude
solicitude Contén información sobre a solicitude HTTP actual. Máis información: solicitude
configuración Permítelle cargar calquera configuración de sitio por nome. Máis información: configuración
mapa de sitio Permite acceso ao mapa de sitio do portal. Máis información: mapa do sitio
marcadores do sitio Permítelle cargar os marcadores do sitio por nome. Máis información: marcadores do sitio
fragmentos Permite cargar calquera fragmento de contido por nome. Máis información: fragmentos
Usuario Refírese ao usuario do portal actual, permitindo acceso a todos os atributos do rexistro do contacto de Dataverse subxacente. Se ningún usuario inicia sesión, esta variable é nula. Máis información: usuario
ligazóns web Permite cargar calquera conxunto de ligazóns web por nome ou ID. Máis información: ligazóns web
sitio web Fai referencia ao rexistro da páxina web do portal, permitindo acceso a todos os atributos do rexistro do sitio web de Dataverse (adx_website) do portal. Máis información: sitio web

ads

Permite a recuperación e visualización dun anuncio.

O obxecto anuncios permítelle seleccione un anuncio ou posicionamento de anuncio específicos:

<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 anuncios

Atributo Descripción
posicionamentos Devolve o obxecto adplacements.
[nome ou id de anuncio] Pode acceder a calquera anuncio por propiedades de Nome ou Id.
{% assign ad = ads[Ad Name] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Atributos de posicionamentos de anuncios

Atributo Descripción
[nome ou id de posicionamento de anuncio] Pode acceder a calquera adplacement por propiedades de Nome ou Id.
{% assign placement = ads.placements[Placement Name or Id] %}
{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Atributos de posicionamento de anuncios

Unha colocación de anuncios é un obxecto de táboa cos mesmos atributos xerais e os seguintes:

Atributo Descripción
Anuncios Devolve o conxunto de obxectos de anuncio asociados ao posicionamento. Con esta colección pódense usar etiquetas de iteración e filtros de matriz .
Nome Devolve o campo de Nome para o posicionamento de anuncio.
placement_url O URL que se pode utilizar para recuperar o posicionamento de anuncio completamente procesado por un modelo.
random_url O URL que se pode utilizar para recuperar un anuncio aleatorio do posicionamento completamente procesado por un modelo.

Atributos de anuncios

Nota

Un anuncio é un obxecto de táboa, con todos os mesmos atributos ademais dos seguintes:

Atributo Descripción
ad_url O URL que se pode utilizar para recuperar o anuncio completamente procesado por un modelo.
Copiar Devolve o campo Copiar para o anuncio.
imaxe Devolve o obxecto de imaxe (se existe) para o anuncio.
Nome Devolve o campo Nome para o anuncio.
open_in_new_window Devolve verdadeiro se o URL especificado por redirect_url debe abrir nunha ventá nova.
redirect_url O URL ao que se dirixe o usuario ao seleccionar o anuncio.

Atributos de Imaxe de anuncios

Atributo Descripción
alternate_text Devolve o texto que está destinado a aparecer no atributo da alt da etiqueta .
altura Devolve a altura en píxeles da imaxe
Enderezo URL Devolve a orixe de URL da imaxe.
largura Devolve o ancho en píxeles da imaxe

blogs

Permite a recuperación e visualización de blogs e publicacións de blog.

O obxecto blogs permítelle seleccionar un blog ou publicacións de blog específicos.

{% 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>

Obxecto de blogs

O obxecto de blogs permítelle acceder a calquera blog específico no portal ou acceder a todas as publicacións de blog no portal.

A táboa seguinte explica os atributos asociados ao obxecto de blogs.

Atributo Descripción
mensaxes Devolve un obxecto blogposts que contén todas as publicacións de blog no portal.
[nome ou id do blog] Pode acceder a calquera blog por propiedades de Nome ou Id. 
{% assign blog = blogs["Blog Name"] %}                             

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

obxecto de blog

O obxecto de blog permítelle traballar cunha única publicaciób de blog, permitindo o acceso ás publicacións dese blog.

A táboa seguinte explica varios atributos asociados ao obxecto de blog.

Atributo Descripción
mensaxes Devolve un obxecto blogposts que contén todas as publicacións de blog do blog.
Nome Nome do blog.
title Título do blog.
Enderezo URL URL do blog.

obxecto blogposts

O obxecto publicacións de web permítelle acceder a unha colección de obxectos de publicacións de blog. Pode ordenar as publicacións de blog e obter paxinación tamén mediante filtros liquid:

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

Outras opcións posibles:

  • blogs.posts.all (para obter todas as publicacións do blog)
  • blogs.posts | from\_index: 0 | take: 2

A táboa seguinte explica varios atributos asociados ao obxecto de blogposts.

Atributo Descripción
Todos Devolve todos os obxectos blogpost na colección.

Obxecto blogpost

Fai referencia a unha única publicación de blog.

A táboa seguinte explica varios atributos asociados ao obxecto blogpost.

Atributo Descripción
url URL da publicación.
contido Devolve o campo de contido da publicación.
autor Devolve os autores da publicación (que é simplemente un obxecto de táboa de contacto.
título Título da publicación.
comment_count Devolve o valor enteiro do número total dos comentarios que hai para unha determinada publicación.
publish_date A data en que se publicou a publicación.

entidades

Atención

Para evitar posibles problemas de script entre sitios (XSS), use sempre o filtro de escape para os datos de cadea de codificación de HTML sempre que use o obxecto Liquid de entidades para ler datos proporcionados polo usuario que non son de confianza.

Nota

Algunhas das convencións de nomenclatura de Dataverse cambiaron, por exemplo, entidades de Dataverse agora chámanse táboas. Os cambios de nome non se aplican aos obxectos Liquid. O obxecto Entidades Liquid seguirá denominándose entidades.

Permítelle cargar calquera táboa de Dataverse por ID. Se a táboa existe, devólvese un obxecto de táboa. Se non se atopa unha táboa co ID indicado, devólvese 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 %}

Entidad

Un obxecto de entidade proporciona acceso aos atributos dun rexistro de táboa Dataverse .

Atributo Descripción
ID O Identificador de GUID da táboa, como unha cadea. Por exemplo, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name Nome lóxico de Dataverse da táboa.
Notas Carga todas as notas (anotación) asociadas á táboa, ordenadas de máis antiga a máis recente (createdon). As notas devólvense como obxectos de nota.
permisos Carga os resultados de aserción de permiso de Táboa para a táboa. Os resultados devólvense como un obxecto de permisos.
url Devolve o camiño do URL do sistema de xestión de contido de Power Pages para a táboa. Se a táboa non ten un URL válido no sitio web actual, devolve null. Xeralmente, isto só devolve un valor para certos tipos de táboas que se integraron no CMS do portal, a non ser que personalizou o fornecedor de URL na súa aplicación.
[atributo ou nome da relación] Pode acceder a calquera atributo da táboa de Dataverse por nome lóxico. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
Os valores da maioría dos atributos de táboa asígnanse directamente aos tipos de Liquid: dous campos de opcións para booleanos, campos de texto para cadeas, campos numéricos/de moeda para números, campos de data/hora para obxectos de data. Pero algúns tipos de atributo devólvense como obxectos:
  • Os campos de busca (referencia de táboa asociada) devólvense como obxectos de referencia de táboa asociados.
  • Os campos Conxunto de Opcións/lista despregable devólvense como obxectos de valor de conxunto de opcións.
  • Tamén pode cargar as entidades relacionadas por nome de esquema de relación.
    • {{ page.adx_webpage_entitylist.adx_name }}No caso de que unha relación sexa reflexiva (é dicir, autorreferencial), devólvese un obxecto de relación reflexivo. (En caso contrario, o resultado pode ser ambiguo.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Nota: A carga de grandes cantidades de entidades relacionadas ou o acceso a grandes cantidades de relacións nun único modelo, pode ter un impacto negativo no rendemento de procesamento do modelo. Evite cargar entidades relacionadas para cada elemento nunha matriz, dentro dun bucle. Se é posible, use etiquetas de táboa de Dataverse para cargar coleccións de entidades.

Táboa de referencia asociada

Os valores de atributo de busca devólvense como obxectos de referencia de táboa asociados, cos seguintes atributos.

Atributo Descripción
ID O Identificador de GUID da táboa referenciada, como unha cadea.
Por exemplo, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name O nome lóxico de Dataverse da táboa referenciada.
Nome O atributo do nome principal da táboa referenciada.

Nota

Unha nota é un obxecto de táboa que fornece acceso aos atributos e ás relacións dun rexistro de anotación. Ademais de todos os atributos dun obxecto de táboa, unha nota ten os seguintes atributos adicionais.

Atributo Descripción
documentbody Carga o atributo documentbody do rexistro documentbody da nota, como unha cadea de codificación Base64. Debido a que o contido deste atributo pode ser grande, non se carga co resto dos atributos da nota, só se carga baixo demanda.
Nota: o uso do atributo documentbody pode ter un efecto negativo no rendemento da representación do modelo e debe facerse con precaución.
Utilice o atributo url para fornecer unha ligazón ao anexo da nota, se posible.
Enderezo URL Devolve o camiño de URL para o indicador de anexo incorporado da anotación do portal. Se o usuario ten permiso e a nota ten un ficheiro adxunto, unha solicitude a este URL descarga o anexo do ficheiro de nota.

Nota

Filtros adicionais

Valor do conxunto de opcións

Os valores de atributo de conxunto de opcións/lista despregable devólvense como obxectos de referencia de táboa asociados, cos seguintes atributos.

Atributo Descripción
Etiqueta A etiqueta localizada do valor do atributo do conxunto de opcións/lista despregable. Por exemplo, Activo
Valor O valor de número enteiro do valor do atributo do conxunto de opcións/lista despregable. Por exemplo: 0

Permisos da táboa

O obxecto de permisos de táboa fornece acceso aos resultados pde aserción de permiso agregado para unha táboa.

Atributo Descripción
can_append Devolve verdadeiro se o usuario actual ten permiso para anexar rexistros a a relacións deste rexistro. En caso contrario, devolve Falso.
can_append_to Devolve verdadeiro se o usuario actual ten permiso para anexar este rexistro a unha relación doutra táboa. En caso contrario, devolve Falso.
can_create Devolve verdadeiro se o usuario actual ten permiso para crear novos rexistros deste tipo de táboa. En caso contrario, devolve Falso.
can_delete Devolve verdadeiro se o usuario actual ten permiso para eliminar este rexistro. En caso contrario, devolve Falso.
can_read Devolve verdadeiro se o usuario actual ten permiso para ler este rexistro. En caso contrario, devolve Falso.
can_write Devolve verdadeiro se o usuario actual ten permiso para actualizar este rexistro. En caso contrario, devolve Falso.
rules_exist Devolve verdadeiro se os resultados do permiso representados por este obxecto son o resultado de regras de permiso definidas explicitamente. Devolve false se son os predeterminados resulta en ausencia de permisos definidos explícitamente.

Relación reflexiva

Os intentos de cargar relacións reflexivas, é dicir, autorreferenciadas, a entidades devólvense como obxectos cos seguintes atributos.

Atributo Descripción
is_reflexive Devolve verdadeiro. Pódese utilizar para probar se un obxecto devolto por unha relación é un obxecto de relación reflexiva.
referenciado Devolve unha matriz de entidades referenciadas para a relación.
fai referencia a Devolve unha táboa de referencia para a relación. Devolve null se non hai unha táboa de referencia. Se a relación é de varios a varios (N:N), devolve unha matriz de entidades de referencia.

entitylist

O obxecto entitylist úsase dentro das etiquetas de táboa de Dataverse. Fornece acceso a todos os atributos dunha lista determinada.

Nota

Procesar a lista asociada á páxina actual

Atributos

Nota

entidades

Atributo Descripción
create_enabled Devolve verdadeiro se a creación de novos rexistros está configurada para a lista. En caso contrario, devolve Falso.
create_url Devolve o camiño URL configurado para un botón ou ligazón de creación para a lista.
detail_enabled Devolve verdadeiro se unha visualización detallada dos rexistros individuais está configurada para a lista. En caso contrario, devolve Falso.
detail_id_parameter Devolve o nome do parámetro da cadea de consulta a utilizar para o id. do rexistro cando se crea un URL de visualización de detalle dun rexistro. Consulte Filtros de URL para obter detalles sobre o uso de filtros de Liquid para crear URL. Por exemplo: ID
detail_label Devolve a etiqueta localizada configurada para botóns ou ligazóns de visualización de detalles para a lista.
detail_url Devolve o camiño URL configurad para botóns ou ligazóns de visualización de detalles para a lista.
empty_list_text Devolve o texto localizado configurado que se mostrará ao visualización da lista non devolve resultados.
enable_entity_permissions Devolve verdadeiro se o filtro de Permiso de táboa está activado para esta lista. En caso contrario, devolve Falso.
entity_logical_name Devolve o nome lóxico da táboa de Dataverse para os rexistros que mostrará esta lista. Por exemplo: contacto
filter_account_attribute_name Devolve o nome lóxico do atributo para a busca na conta que se usa para filtrar os rexistros de resultados polo conta primaria do usuario do portal actual. Por exemplo: accountid
filter_apply_label Devolve a etiqueta localizada configurada que se vai usar para a ligazón ou o botón que aplica un filtro de atributo avanzado aos resultados da lista.
filter_definition Devolve a definición do filtro do atributo JSON para a lista. Consulte Filtros da lista para obter información sobre como usar o filtro Liquid de metafiltros para procesar esta definición.
filter_enabled Devolve verdadeiro se o filtro de atributo avanzado está activado para a lista. En caso contrario, devolve Falso.
filter_portal_user_attribute_name Devolve o nome lóxico do atributo para a busca no contacto que se usa para filtrar os rexistros de resultados polo contacto do usuario do portal actual. Por exemplo: contactid
filter_website_attribute_name Devolve o nome lóxico do atributo para a busca en adx_website que se usa para filtrar os rexistros de resultados polo sitio web do portal actual. Por exemplo: adx_websiteid
language_code Devolve o código enteiro de idioma de Dataverse que será utilizado para seleccionar todas as etiquetas localizadas para esta lista.
page_size Devolve o tamaño de páxina do resultado configurado para a lista.
primary_key_name Devolve o nome lóxico do atributo clave primario para os rexistros que mostrará esta lista.
search_enabled Devolve verdadeiro se a busca está activada para esta lista. En caso contrario, devolve Falso.
search_placeholder Devolve o texto localizado configurado para o marcador de posición do campo de busca de listas.
search_tooltip Devolve o texto localizado configurado para a información sobre ferramentas da busca de listas.
visualizacións Devolve as visualizacións dispoñibles para a lista, como obxectos de visualización da lista.
[nome lóxico do atributo] Pode acceder a calquera atributo do rexistro de Dataverse da lista (adx_entitylist) por nome lóxico, da mesma forma que un obxecto de táboa. Por exemplo, {{ entitylist.adx_name }}

Atributos de visualización de listas

Atributo Descripción
columnas Devolve as columnas da visualización, como obxectos de columna de visualización de listas.
entity_logical_name Devolve o nome lóxico da táboa de Dataverse para os rexistros incluídos na visualización. Por exemplo: contacto
ID Devolve o Identificador GUID da visualización.
language_code Devolve o Dataverse código de idioma enteiro que se usa para seleccionar todas as etiquetas localizadas (cabeceiras de columnas, etc.) para a vista.
Nome Devolve o nome para mostrar de Dataverse para a visualización.
primary_key_logical_name Devolve o nome lóxico clave primario da táboa de Dataverse para os rexistros incluídos na visualización. Por exemplo: contactid
sort_expression Devolve a expresión de clasificación predefinida para a visualización. Por exemplo, name ASC, createdon DESC

Atributos de columna de visualización de listas

Atributo Descripción
attribute_type Devolve o nome do tipo de atributo de Dataverse para a columna, como unha cadea. Por exemplo: Busca, lista de Opcións, Cadea, Booleano, data e Hora
logical_name Devolve o nome lóxico de atributo de Dataverse para a columna. Por exemplo: createdon
Nome Devolve o nome para mostrar localizado de Dataverse para a columna. Por exemplo: Creado o
sort_ascending Devolve unha cadea de expresión de clasificación para a ordenación de columna en orde ascendente. Por exemplo: createdon ASC
sort_descending Devolve unha cadea de expresión de clasificación para a ordenación de columna en orde descendente. Por exemplo: createdon DESC
sort_disabled Devolve verdadeiro se a ordenación está desactivada para a columna. En caso contrario, devolve Falso.
sort_enabled Devolve verdadeiro se a ordenación está activada para a columna. En caso contrario, devolve Falso.
largura Devolve o ancho configurado para a columna, en píxeles.

entityview

O obxecto entityview utilízase na etiqueta entityview e fornece acceso aos metadatos para a visualización, así como para ver os rexistros de resultado.

Atributos

Atributo Descripción
columnas Devolve as columnas da visualización, como obxectos de columna de visualización de táboas.
entity_permission_denied Devolve verdadeiro se se rexeitou o acceso á visualización de resultados debido a Permisos de táboa insuficientes para o usuario actual. Devolve falso se se concedeu acceso de lectura para ver os resultados.
entity_logical_name O nome lóxico da táboa de Dataverse dos rexistros do resultado da visualización. Por exemplo: contacto
first_page O número de páxina da primeira páxina dos resultados da visualización. Este é 1 a menos que non se devolvese ningún resultado, nese caso é nulo.
ID O Identificador de GUID da visualización de Dataverse que define esta entityview.
language_code O código de idioma enteiro de Dataverse que se usa para cargar etiquetas localizadas para a visualización actual.
last_page O número de páxina da última páxina dos resultados da visualización. Se non se devolveron resultados, este valor é nulo.
nome O nome da visualización de Dataverse que define esta entityview, por exemplo Contactos Activos.
next_page O número de páxina da seguinte páxina dos resultados da visualización. Se non hai unha páxina seguinte de resultados, este valor é nulo.
Páxina O número de páxina da páxina actual dos resultados da visualización.
pages Devolve unha matriz de números de páxina que contén todas as páxinas de resultados da visualización actual.
page_size O número de resultados devoltos por páxina da visualización actual.
previous_page O número de páxina da seguinte páxina dos resultados da visualización. Se non hai unha páxina anterior de resultados, esta é nula.
primary_key_logical_name O nome lóxico do atributo clave principal de Dataverse da táboa de resultado para esta visualización. Por exemplo: contactid.
rexistros Páxina actual dos rexistros de resultado para a visualización, como obxectos de táboa.
sort_expression Expresión de clasificación predefinida para a visualización. Por exemplo, nameASC, createdon DESC.
total_pages Número total de páxinas de resultados para a visualización.
total_records Número total de resultados para a visualización (en todas as páxinas).

eventos

Permite a recuperación e visualización de eventos. O obxecto eventos permítelle seleccionar un evento específico ou todos os eventos.

Obxecto eventos

O obxecto eventos permítelle acceder a calquera evento específico no portal ou acceder a todos os eventos no portal (independentemente de cal sexa o evento).

O obxecto eventos ten os atributos seguintes:

Atributo Descripción
ocorrencias Devolve un eventoccurancessobject que contén todas as repeticións do evento no portal
[nome ou ID do evento] Pode acceder a calquera evento por propiedades de Nome ou Id.
{% assign event = events["Event Name"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Obxecto eventos

O obxecto evento permítelle traballar cun evento individual, de maneira que pode acceder a programacións e repeticións dese evento.

O obxecto evento ten os atributos seguintes:

Atributo Descripción
ocorrencias Devolve un eventoccurrencesobject que contén todas as repeticións do evento.
Nome O nome do evento.
Enderezo URL O URL do evento.

Obxecto eventoccurences

O obxecto eventoccurrences permítelle acceder a unha colección de obxectos de repetición do evento. Podes ordenar as ocorrencias de eventos e especificar un intervalo de datas para as que se recuperarán, así como conseguir a paxinación mediante filtros de líquidos:

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

Tamén é posible a seguinte opción:

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

Os seguintes atributos están asociados ao obxecto eventoccurrences

Atributo Descripción
Todos Devolve todos os obxectos eventoccurance na colección.

Obxecto eventoccurence

Representa unha repetición única do evento. Os seguintes son os atributos asociados:

Atributo Descripción
url O URL da repetición.
is_all_day_event Trátase dun evento para todo o día?
start_time A hora de inicio do evento.
end_time A hora de fin do evento.

forloop

Contén propiedades útiles dentro dun bloque de bucle para.

Nota

forloop só se pode usar dentro dunha etiqueta para.

Código

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

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

{% endif %}

{% endfor %}

Saída

This is the first child page!

This is child page number 2.

This is child page number 3.

Atributos

Atributo Descrición
Primeiro Devolve verdadeiro se é a primeira iteración do bucle. Devolve falso se non é a primeira iteración.
índice A posición actual do elemento da colección, onde o primeiro elemento ten unha posición de 1.
index0 A posición actual do elemento da colección, onde o primeiro elemento ten unha posición de 0.
Última Devolve verdadeiro se é a última iteración do bucle. Devolve falso se non é a última iteración.
lonxitude Devolve o número de iteracións do bucle ߝ e o número de elementos na colección son iterados de novo.
rindex O número de elementos restantes no bucle (lonxitude - índice) onde 1 é o índice do último elemento.
rindex0 O número de elementos restantes no bucle (lonxitude - índice) onde 0 é o índice do último elemento.

forums

Permite a recuperación e visualización de foros e fíos de foros. A capacidade de utilizar liquid para procesar os datos de foros amplíase a mensaxes, mais para crear unha nova mensaxe ou fío de conversa, debe utilizar un modelo de páxina de formularios de varios pasos de ASP.NET coa funcionalidade incorporada (como o fío de Conversa predefinido do foro e modelos de Páxina de mensaxe do foro).

O obxecto foros permítelle seleccionar un foro ou un fío de conversa 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>

Obxecto foros

O obxecto foro permítelle acceder a calquera foro específico no portal ou acceder a todos os fíos de conversa de foro no portal (independentemente de cal sexa o foro).

O obxecto foro permítelle traballar cun foro individual, de maneira que pode acceder a fíos de conversa para ese foro.

O obxecto forumthreads permítelle acceder a unha colección de obxectos forumthreads. Pode ordenar os fíos de conversa de foros e conseguir paxinación tamén utilizando filtros liquid.

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

Un fío de Conversa de foro Individual

O obxecto forumposts permítelle acceder a unha colección de obxectos forumposts.

Atributos

Atributo Descripción
fíos de conversa Devolve un obxecto forumthreads que contén todos os obxectos forumthreads no portal.
Todos Devolve todos os obxectos de foro no portal. Teña en conta que website.forums tamén é un equivalente.
thread_count Devolve o valor enteiro do total de fíos de conversa que hai en todo o sitio web.
post_count Devolve o valor enteiro do número total de publicacións no portal.
[nome ou id do foro] Pode acceder a calquera foro por propiedades de Nome ou Id.
`{% assign forum = forums[Forum Name] %}
{% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Obxecto foro

Atributos

Nota

entidades

Atributo Descripción
fíos de conversa Devolve un obxecto forumthreads que contén todos os fíos de conversa para o foro.
Nome O nome do foro.
thread_count Devolve o valor enteiro do total de fíos de conversa que hai no foro.
post_count Devolve o valor enteiro do total de mensaxes que hai en todo o foro.

Obxecto forumthreads

Atributos

Atributo Descripción
Todos Devolve todos os obxectos forumthread na colección.

Obxecto forumthread

Atributos

Nota

entidades

Atributo Descripción
mensaxes Devolve un obxecto forumposts que contén todas as mensaxes para o fío de conversa.
autor Devolve o autor do fío de conversa (que é simplemente un obxecto de táboa de contacto).
latest_post Devolve a última mensaxe no fío de conversa.
first_post Devolve a primeiro mensaxe no fío de conversa.
post_count Devolve o valor enteiro do total de mensaxes dos fíos de conversa que hai no fío de conversa.
is_answered Respondeuse o fío de conversa ou non?
is_sticky É o fío de conversa un fío de conversa adhesivo?

Obxecto forumposts

Atributos

Atributo Descripción
Todos Devolve todos os obxectos forumthread na colección.

Unha mensaxe de foro Individual

Atributos

Nota

entidades

Atributo Descripción
autor Devolve o autor da publicación (que é simplemente un obxecto de táboa de contacto).
contido O contido da mensaxe.
is_answer É esta unha resposta ao fío de conversa?

coñecemento

Fornece acceso aos rexistros de táboa de categoría e artigo de coñecemento de Dataverse para procesar artigos e categorías nun portal.

Atributos

Atributo Descripción
artigos Devolve un obxecto de artigos que contén obxectos de artigo para os rexistros de táboa do artigo de coñecemento dispoñibles no portal.
de premios Devolve un obxecto de categorías que contén obxectos de categoría para os rexistros de táboa de categoría dispoñibles no portal.

obxecto de artigos

O obxecto artigos permítelle acceder a unha colección de obxectos de artigo. Pode ordenar os artigos e conseguir paxinación tamén utilizando filtros 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 Devolve unha colección de obxectos de artigo que contén o maioría das visualizacións. {% assign popular_articles = knowledge.articles.popular %}
recente Devolve unha colección de obxectos de artigo que contén a última data modificada. {% assign recent_articles = knowledge.articles.recent %}
superior Devolve unha colección de obxectos de artigo que contén a clasificación máis alta. {% assign top_articles = knowledge.articles.top %}

Filtros

Os seguintes filtros poderá aceptar simultaneamente parámetros opcionais para tamaño de páxina e idioma. O primeiro parámetro é o número de rexistros a recuperar. O tamaño de páxina predefinido é 5. O segundo parámetro é o código de idioma para recuperar artigos para un idioma determinado. Os filtros pódense combinar con outros filtros de líquidos.

{% 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 Devolve unha colección de obxectos de artigo que contén o maioría das visualizacións. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
recente Devolve unha colección de obxectos de artigo que contén a última data modificada. {% assign recent_articles = knowledge.articles \| recent: 5 %}
superior Devolve unha colección de obxectos de artigo que contén a clasificación máis alta. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

obxecto de categorías

O obxecto categorías permítelle acceder a unha colección de obxectos de categoría. Pode ordenar categorías e obter paxinación tamén mediante filtros 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
recente Devolve unha colección de obxectos de categoría que contén a última data modificada.
top_level Devolve unha colección de obxectos de categoría que non teñen unha categoría principal.

Filtros

Os seguintes filtros poden aceptar un parámetro opcionalque indica o tamaño de páxina. O tamaño de páxina predefinido é 5. Os filtros pódense combinar con outros filtros de líquidos.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Atributo Descripción
recente Devolve unha colección de obxectos de categoría que contén a última data modificada. Pode fornecer parámetros {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level Devolve unha colección de obxectos de categoría que non teñen unha categoría principal. {% assign root_categories = knowledge.categories \| top_level %}

Obxecto de artigo

O obxecto de artigo permítelle traballar cun único knowledgearticle para mostrar detalles dese artigo no portal.

Atributos

O artigo é un obxecto de ​​entidade, con todos os mesmos atributos, ademais dos seguintes:

Atributo Descripción
article_public_number O Número público do Artigo do artigo.
comment_count O valor enteiro do reconto de cantos comentarios hai para un determinado artigo.
contido O contido do artigo.
current_user_can_comment Devolve un valor Booleano que indica se o usuario actual pode engadir comentarios sobre o artigo.
is_rating_enabled Devolve un valor booleano que indica se está activada a clasificación dun artigo.
palabras clave As palabras clave do artigo.
Nome Un alias alternativo para o título do artigo.
valoración O valor de clasificación decimal do artigo.
title O título do artigo.
view_count O valor enteiro do número de veces que se viu o artigo.

Obxecto de categorías

O obxecto de categoría permítelle traballar cunha única categoría para mostrar detalles desa categoría no portal.

Atributos

A categoría é un obxecto entidade, con todos os mesmos atributos, ademais dos seguintes:

Atributo Descripción
categorynumber O número de categoría da categoría.
Nome Un alias alternativo para o título da categoría.
título O título da categoría.

idioma

Proporciona o nome de idioma actual e o código de idioma se está activado soporte en varios idiomas.

Atributos

Atributo Descripción
url O URL de solicitude actual está prefixado co código de idioma actual.
url_substitution O URL de solicitude actual está prefixado co código de idioma actual ignorando a caché de saída da páxina.
Nome Título do idioma actual.
code Código de idioma do idioma.

Por exemplo, o modelo web Menú despregable de idiomas utiliza por defecto este obxecto liquid para enumerar os idiomas dispoñibles cando hai varios idiomas dispoñibles.

rexistro

Os creadores teñen a capacidade de incorporar declaracións de rexistro dentro do seu código Liquid. Cando se está a executar o sitio de Power pages, os rexistros engadidos por un creador en código Liquid móstranse na Power Pages extensión da ferramenta para programadores. Estes rexistros, incorporados polo creador, móstranse na extensión da ferramenta para programadores cando a configuración de diagnóstico está activada.

Pódese usar a seguinte sintaxe en Liquid code para rexistrar mensaxes personalizadas:

{% log message:'Custom message' level:'Warning' %}

Atributos de rexistro

Atributo Descripción
rexistro Nome do obxecto líquido
mensaxe Unha cadea que representa calquera mensaxe personalizada para rexistrar
nivel Rexistra a mensaxe como Información, Aviso ou Erro

Exemplo:

{% log message: 'Log from Home page' %}

{% fetchxml query %}
<fetch version="1.0" mapping="logical" >
<entity name="contact">
<attribute name="fullname"/>
<attribute name="emailaddress1"/>
</entity>
</fetch>
{% endfetchxml %}

{% assign contacts = query.results.entities %}

{% for contact in contacts %}
<div> Contact name: {{contact.fullname}} </div><br/>
{% capture msgg %} 
Contact email is {{contact.emailaddress1}} for name {{contact.fullname}}
{% endcapture %}
{% log message: msgg %}
{% endfor %}

páxina

Refírese á páxina de solicitude de portal actual. Este obxecto combina os atributos do sitio do mapae a solicitude actual entidades (normalmente nunha páxina web).

O obxecto de páxina fornece acceso a cousas como listas de ligazóns para a páxina actual, o título ou o URL da páxina actual, e calquera outro atributo ou entidade relacionada do rexistro de Dataverse subxacente.

<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áxina

Nota

entidades

Atributo Descripción
Listaxes de ligazóns Devolve os obxectos da páxina do mapa de sitio do listado de ligazóns, comezando no nó da raíz do mapa de sitio e acabando no principal.
secundario Devolve os obxectos do nó do mapa de sitio secundarios da páxina.
primario Devolve o nó do mapa de sitio principal da páxina. Se a páxina é a páxina de inicio, o pai é nulo.
título Título da páxina.
url URL da páxina.
[atributo ou nome da relación] Pode acceder a calquera atributo do rexistro subxacente de Dataverse da páxina por nome lóxico.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
Os valores da maioría dos atributos de táboa asígnanse directamente aos tipos de Liquid: dous campos de opcións para booleanos, campos de texto para cadeas, campos numéricos/de moeda para números, campos de data/hora para obxectos de data. Pero algúns tipos de atributo devólvense como obxectos:
  • Os campos de busca (referencia de táboa asociada) devólvense como obxectos de referencia de táboa asociados.
  • Os campos de conxunto de opcións ou de lista despregable se devólvense como obxectos de valor do conxunto de opcións.
    • Tamén pode cargar as entidades relacionadas por nome de esquema de relación.
    {{ page.adx_webpage_entitylist.adx_name }}
    No caso de que unha relación sexa reflexiva (é dicir, autorreferencial), devólvese un entidades obxecto. (En caso contrario, o resultado pode ser ambiguo.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Nota: A carga de grandes cantidades de entidades relacionadas ou o acceso a grandes cantidades de relacións nun único modelo, pode ter un impacto negativo no rendemento de procesamento do modelo. Evite cargar entidades relacionadas para cada elemento nunha matriz, dentro dun bucle. Se é posible, é preferible o uso de etiquetas de táboa de Dataverse para cargar coleccións de entidades.

polls

Permite a recuperación e visualización dunha enquisa.

O obxecto enquisas permítelle seleccione unha enquisa específica ou posicionamento de enquisa:

<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 enquisas

Atributo Descripción
posicionamentos Devolve o obxecto pollplacements.
[nome ou id da enquisa] Pode acceder a calquera enquisa por propiedades de Nome ou Id. {% assign poll = polls[Poll Name] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Atributos de posicionamentos de enquisas

Atributo Descripción
[nome ou id de posicionamento da enquisa] Pode acceder a calquer posicionamento de enquisa por propiedades de Nome ou Id.{% assign placement = polls.placements[Placement Name or Id] %}
{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Atributos de posicionamento de enquisas

Nota

entidades

Atributo Descripción
Nome Devolve o campo de Nome para o posicionamento de enquisa.
placement_url O URL que se pode utilizar para recuperar o posicionamento de enquisa completamente procesado por un modelo.
polls Devolve o conxunto de obxectos de enquisa asociados ao posicionamento. Con esta colección pódense usar etiquetas de iteración e filtros de matriz .
random_url O URL que se pode utilizar para recuperar unha enquisa aleatoria do posicionamento completamente procesado por un modelo.
submit_url O URL ao que se enviou unha enquisa concluída.

Atributos de enquisa

Nota

entidades

Atributo Descripción
has_user_voted Devolve verdadeiro se o usuario actual (rexistrado ou anónimo) xa votou na enquisa.
Nome Devolve o campo de Nome para a enquisa.
opcións Devolve o conxunto de obxectos de opción de enquisa asociados á enquisa. Con esta colección pódense usar etiquetas de iteración e entidades .
poll_url O URL que se pode utilizar para recuperar a enquisa completamente procesada por un modelo.
Pregunta de Devolve o campo Pregunta para a enquisa.
submit_button_label Devolve unha cadea que se pode usar para anular a etiqueta do botón de enviar para a enquisa.
submit_url O URL ao que se enviou unha enquisa concluída.
user_selected_option Devolve o obxecto polloption seleccionado polo usuario (se xa votou).
votos Devolve o número de votos que están tabulados para a enquisa.

Atributos da opción de enquisa

Nota

entidades

Atributo Descripción
resposta Devolve o campo Resposta para a enquisa.
porcentaxe Devolve a porcentaxe do votos na enquisa para a opción como un número decimal de 0 a 100.
votos Devolve o número de votos que están tabulados para a opción.

solicitude

Contén información sobre a solicitude HTTP actual.

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

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

Nota

Atributos

Atributo Descripción
params Os valores de parámetro para a solicitude actual. params é unha combinación de parámetros de cadea de consultas de URL, parámetros de publicación de formulario e cookies.
Camiño O camiño do URL de solicitude actual.
/profile/
path_and_query O camiño e a consulta do URL de solicitude actual.
/profile/?foo=1&bar=something
query A parte da consulta do URL de solicitude actual.
?foo=1&bar=something
url O URL completo da solicitude actual.
https://www.example.com/profile/?foo=1&bar=something

searchindex

O obxecto searchindex utilízase en etiquetas de táboa de Dataverse e fornece acceso aos resultados dunha 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

Atributo Descripción
approximate_total_hits Devolve un reconto aproximado dos acertos totais que coinciden coa consulta de índice. Debido ao funcionamento do índice de busca no que respecta ao filtrado de seguranza e outros factores de deseño, este número é só unha aproximación e é posible que non coincida exactamente co número total de resultados dispoñibles para o usuario actual nalgunhas situacións.
Páxina Devolve o número de páxina da consulta actual.
page_size Devolve o tamaño máximo de páxina da consulta actual. Se desexa que se devolva o número real de resultados para a páxina actual (porque pode ser inferior ao tamaño máximo de páxina especificado), use results.size.
Resultados Devolve a páxina de resultados da consulta, como obxectos de resultado de índice de busca.

Buscar resultados de índice

Atributo Descripción
Entidade As entidades subxacentes para o resultado.
fragmento Un fragmento breve de texto pertinente para o resultado, no que os termos que coinciden coa consulta especificada están destacados mediante a etiqueta <em> de HTML. Algúns tipos de consultas non admiten fragmentos destacados, como consultas difusas (~) e consultas con comodín (*). Esta propiedade é nula neses casos.
ID O id. da táboa de Dataverse do rexistro subxacente para o resultado, como unha cadea. Por exemplo, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name O nome lóxico da táboa de Dataverse do rexistro subxacente para o resultado. Por exemplo: adx_webpage
Número O número do resultado, en todas as páxinas de resultado, comezando por 1. Por exemplo, para o primeiro resultado da segunda páxina de resultados, cun tamaño de páxina de 10, este valor é 11.
puntuación A puntuación Lucene do resultado, como valor de punto flotante. Os resultados devólvense ordenados por este valor.
título Título do resultado.
url O URL para o resultado. Isto normalmente, mais non sempre, será un camiño absoluto para a aplicación actual, máis que como un URL completo. For exemplo: /articles/article1/

configuración

Permite cargar calquera configuración de sitio por nome. Se non se atopa un valor cun nome determinado, devolverase nulo.

Nota

As configuracións devólvense como cadeas, pero pode usar filtros de tipo para convertelos en outros 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 %}

Nota

Procesar unha cabeceira do sitio web e barra de navegación primaria

mapa de sitio

Permite acceso ao mapa de sitio do 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 do mapa de sitio

Atributo Descripción
Actual Devolve o obxecto do nó do mapa de sitio da páxina actual.
Raíz Devolve o obxecto do nó do mapa do sitio da páxina de raíz (inicio) do sitio web.

Atributos do nó do mapa de sitio

Atributo Descripción
Listaxes de ligazóns Devolve os obxectos do nó do mapa de sitio do listado de ligazóns, comezando no nó da raíz do mapa de sitio e acabando no principal.
Fillos Devolve os obxectos do nó do mapa de sitio secundarios do nó.
Descripción O contido de descrición ou resumo para o nó. (Este campo pode conter HTML.)
Entidad Devolve as entidades subxacentes do nó. Se o nodo non ten unha táboa subxacente, este valor é nulo.
is_sitemap_ancestor Devolve verdadeiro se o nó de mapa de sitio é un antecesor do nó actual, en caso contrario falso.
is_sitemap_current Devolve verdadeiro se o nó do mapa de sitio é o nó actual, en caso contrario falso.
Primario Devolve o nó do mapa de sitio principal do nó. Se o nodo é o nodo raíz, o pai é nulo.
Cargo Título do nó.
url URK do nó.

marcadores do sitio

Permítelle cargar os marcadores do sitio por nome. Se o marcador de sitio existe, devólvese un obxecto de marcador de sitio. Se non se atopa un marcador de sitio co nome dado, nulo é devolto.

{{ 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 %}

Nota

Procesar unha cabeceira do sitio web e barra de navegación primaria

Atributos dos marcadores do sitio

Atributo Descripción
url Enderezo URL de destino do marcador do sitio.
[nome lóxico do atributo] Pode acceder a calquera atributo do rexistro de Dataverse do marcador do sitio por nome lóxico. Por exemplo, {{ sitemarker.adx_name }}

fragmentos

Permítelle cargar fragmentos de contido por nome. Se non se atopa un fragmento co nome dado, nulo é devolto.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Contén propiedades útiles dentro dun bloque de bucle de Etiquetas de iteración.

Nota

tablerowloop só se pode usar dentro dunha etiqueta etiquetas de iteración.

Atributos

Atributo Descripción
Col Devolve o índice da fila actual, comezando en 1.
col0 Devolve o índice da fila actual, comezando en 0.
col_first Devolve verdadeiro se a columna actual é a primeira columna dunha fila, devolve falso se non é.
col_last Devolve verdadeiro se a columna actual é a última columna dunha fila, devolve falso se non é.
Primeira Devolve verdadeiro se é a primeira iteración do bucle. Devolve falso se non é a primeira iteración.
Índice A posición actual do elemento da colección, onde o primeiro elemento ten unha posición de 1.
index0 A posición actual do elemento da colección, onde o primeiro elemento ten unha posición de 0.
Última Devolve verdadeiro se é a última iteración do bucle. Devolve falso se non é a última iteración.
Lonxitude Devolve o número de iteracións do bucle ߝ e o número de elementos na colección son iterados de novo.
Rindex O número de elementos restantes no bucle (lonxitude - índice) onde 1 é o índice do último elemento.
rindex0 O número de elementos restantes no bucle (lonxitude - índice) onde 0 é o índice do último elemento.

User

Refírese ao usuario do portal actual, permitindo acceso a todos os atributos do rexistro do contacto de Dataverse subxacente. Se ningún usuario inicia sesión, esta variable é nula.

O usuario é un entidade obxecto.

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

Nota

Versión de lanzamento de Power Pages 9.3.8.x ou posterior terá por defecto o filtro de líquido de escape aplicado para usuario e obxectos de Liquid de solicitude. Para desactivar esta configuración predeterminada e permitir estes obxectos de Liquid sen o filtro de Liquid de escape, consulte configuración do sitio do portal - Site/EnableDefaultHtmlEncoding.

Atributos

Ademais de ter todos os atributos dun obxecto de entidade, o usuario ten os seguintes atributos.

Atributo Descrición
roles Devolve os roles aos que pertence o usuario como unha matriz.
{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}
Nota: Tamén pode usar o filtro has_role para probar as subscricións de roles individuais.
basic_badges_url Devolve o URL do servizo para recuperar os distintivos dun usuario.
Para renderizar distintivos para un usuario, debes incluír unha etiqueta cos atributos "data-badge" e "data-uri". Para procesar os distintivos do usuario actual:
<div data-badge data-uri='{{user.basic_badges_url }}'></div>
Para procesar os distintivos dun usuario por identificador (identificador de usuario variable):
`<div data-badge data-uri='{{user.basic_badges_url

Permite cargar calquera ligazón web por nome ou identificador

Se o conxunto de ligazóns web existe, a conxunto de ligazóns web obxecto é devolto. Se non se atopa un conxunto de ligazóns web co nome ou ID, devólvese 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

Procesar unha cabeceira do sitio web e barra de navegación primaria |

Nota

Un conxunto de ligazóns web é un obxecto entity con todos os mesmos atributos, ademais dos seguintes:

Atributo Descripción
Copiar O copia HTML do conxunto de ligazóns web.
Nome O nome do conxunto de ligazóns web.
Cargo O título do conxunto de ligazóns web.
Ligazóns web A matriz dos obxectos da ligazón web asociados ao conxunto de ligazóns web.
[nome lóxico do atributo] Pode acceder a calquera atributo do rexistro de Dataverse do conxunto de ligazóns web por nome lóxico. Por exemplo, {{ weblinkset.createdon }}

Nota

Unha ligazón web é un obxecto entidade con todos os mesmos atributos, ademais dos seguintes:

Atributo Descripción
Descripción A descrición HTML da ligazón web.
display_image_only Atributo Booleano que indica se a ligazón web debe mostrarse só como unha imaxe, sen texto de ligazón.
display_page_child_links Atributo Booleano que indica se a ligazón web debe mostrar ligazóns ás páxinas secundarias de mapa de sitio da páxina ligada, como subligazóns.
Image O obxecto da imaxe da ligazón web para esta ligazón. Este atributo é nulo se non hai ningunha imaxe presente.
is_external Atributo Booleano que indica se o URL de destino da ligazón web é un sitio externo (en lugar dunha páxina de portal interna).
is_sitemap_ancestor Devolve verdadeiro se o URL da ligazón web fai referencia a un antecesor do nó do mapa de sitio actual, en caso contrario falso.
is_sitemap_current Devolve verdadeiro se o URL da ligazón web fai referencia ao nó do mapa de sitio actual, en caso contrario falso.
Nome O nome/título da ligazón web.
Nofollow Atributo Booleano que indica se a ligazón web debe estar marcado como rel=nofollow.
open_in_new_window Atributo Booleano que indica se se debería abrir a ligazón web nunha nova ventá ou nun novo separador do explorador ao seleccionalo.
Información sobre ferramentas Texto da información sobre Ferramentas para a ligazón web.
Enderezo URL O URL da ligazón web
Ligazóns web A matriz dos obxectos secundarios da ligazón web asociados á ligazón web.
[nome lóxico do atributo] Pode acceder a calquera atributo do rexistro de Dataverse da ligazón web por nome lóxico. Por exemplo, {{ weblink.createdon }}
alternate_text Texto alternativo para a imaxe.
Altura Número enteiro que especifica a altura especificada da imaxe. Se non se proporcionou ningún valor de altura, este atributo é nulo.
url O URL da imaxe.
Largura Número enteiro que especifica a anchura especificada da imaxe. Se non se proporcionou ningún valor de ancho, este atributo é nulo.

sitio web

Fai referencia ao sitio web do portal, que permite o acceso a todos os atributos do rexistro do sitio web de Dataverse (adx_website) para o portal.

Nota

O sitio web é un obxecto de entidade, con todos os mesmos atributos.

Código

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

Saída

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

Atributos

A seguinte táboa enumera os atributos desta etiqueta que se poden usar substituíndo os valores predeterminados para evitar o almacenamento na caché.

Predefinida Substituto (evita o almacenamento na caché) Exemplo
sign_in_url sign_in_url_substitution Predeterminado: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F
Substitución (evita almacenar na caché): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F
("páxina de substitución" neste exemplo substitúe o URL almacenado na caché predeterminado).
sign_out_url sign_out_url_substitution Predeterminado: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F
Substitución (evita almacenar na caché): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F
("páxina de substitución" neste exemplo substitúe o URL almacenado na caché predeterminado).

Consulte tamén

Tipos de Liquid
Etiquetas Liquid
Filtros Liquid