Obxectos Liquid dispoñibles
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 Power Apps 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: Este valor está na caché da aplicación web do portal e non se actualizada cada vez. Máis información: Filtros por data |
| 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 Power Apps 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 de contido |
| Usuario | Refírese ao usuario do portal actual, permitindo acceso a todos os atributos do rexistro do contacto de Power Apps subxacente. Se ningún usuario iniciou sesión, esta variable será nulo. 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 Power Apps (adx_website) do portal. Máis información: sitio web |
ads
Fornece a capacidade de acceder e procesar un 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 atributos que se indican a continuación.
| Atributo | Descripción |
|---|---|
| Anuncios | Devolve o conxunto de obxectos de anuncio asociados ao posicionamento. As etiquetas de iteración e os filtros de matriz pódense utilizar con esta colección. |
| 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 cos mesmos atributos, ademais dos enumerados a continuación.
| 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. |
| abrir_en_nova_ventá | Devolve verdadeiro se o URL especificado por redirect_url debe abrir nunha ventá nova. |
| redirect_url | O URL que ao que ousuario será dirixido 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
Proporciona a capacidade de acceder e procesar 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>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<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
Advertencia
Para evitar posibles problemas de cross-site scripting (XSS), use sempre filtro de escape a HTML codificar datos de cadea sempre que se use entidades Obxecto líquido para ler os datos proporcionados polo usuario dos que non se pode confiar.
Nota
Algunhas das convencións de nomenclatura de Dataverse cambiaron, por exemplo,Dataverse agora chámanse entidades táboas. Os cambios de nome non se aplican aos obxectos Liquid. O obxecto Entidades líquidas seguirá sendo denominado entidades.
Permítelle cargar calquera táboa de Power Apps por ID. Se a táboa existe, devolverase un obxecto de táboa. Se non se atopa unha táboa con identificador determinado, devolverase nulo.
{% 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 obxecto de entidade fornece acceso aos atributos dun rexistro da táboa de Power Apps.
| 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 Power Apps da táboa. |
| Notas | Carga as notas (annotation) asociadas á táboa, pedidas desde a máis antiga á 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 dos portais de Power Apps para a táboa. Se a táboa non ten un URL válido no sitio web actual, devolve null. Xeralmente, isto só devolverá un valor para determinados tipos de táboas que están integradas no CMS do portal , a menos que teña personalizado o fornecedor do URL na súa aplicación. |
| [Atributo ou nome da relación] | Pode acceder a calquera atributo da táboa de Power Apps 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:
{{ page.adx_webpage_entitylist.adx_name }}En caso de que unha relación sexa reflexiva, é dicir, autorreferenciada, devolverase un obxecto de relación reflexiva. (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 Power Apps 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. Como o contido deste atributo pode ser grande, non está cargado co resto dos atributos de nota. Só se carga a petición. Nota: o uso do atributo documentbody podería ter un impacto negativo no rendemento do procesamento do modelo, polo que se debería realizar con atenció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 anexado, unha solicitude para este URL descargará o anexo de ficheiro da nota. |
Nota
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 falso se hai resultados predefinidos na ausencia de permisos definidos explicitamente. |
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 de Power Apps. Fornece acceso a todos os atributos dunha lista determinada.
Atributos
Nota
| 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 Power Apps para os rexistros que mostrará esta lista. Por exemplo: contacto |
| filter_account_attribute_name | Devolve o nome lóxico do atributo de busca para conta que será utilizado para filtrar rexistros de resultado pola conta primaria do usuario actual do portal. 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 de busca para contacto que será utilizado para filtrar rexistros de resultado polo contacto do usuario actual do portal. Por exemplo: contactid |
| filter_website_attribute_name | Devolve o nome lóxico do atributo de busca para adx_website que será utilizado para filtrar rexistros de resultado polo sitio web actual do portal. POr exemplo: adx_websiteid |
| language_code | Devolve o código enteiro de idioma de Power Apps 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 da lista (adx_entitylist) Power Apps 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 Power Apps para os rexistros incluídos na visualización. Por exemplo: contacto |
| Identificador | Devolve o Identificador GUID da visualización. |
| language_code | Devolve o código enteiro de idioma de Power Apps que será utilizado para seleccionar todas as etiquetas localizadas (cabeceiras de columna, etc.) para a visualización. |
| Nome | Devolve o nome para mostrar de Power Apps para a visualización. |
| primary_key_logical_name | Devolve o nome lóxico clave primario da táboa de Power Apps 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 Power Apps 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 Power Apps para a columna. Por exemplo: createdon |
| Nome | Devolve o nome para mostrar localizado de Power Apps 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. |
| clasificación_activado | 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 Power Apps 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. Será 1 a menos que non se devolveran resultados, en cuxo caso será null. |
| Identificador | O Identificador de GUID da visualización de Power Apps que define esta entityview. |
| language_code | O código de idioma enteiro de Power Apps 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, será null. |
| Nome | O nome da visualización de Power Apps 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 ningunha páxina seguinte de resultados, será null. |
| 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 ningunha páxina previa de resultados, será null. |
| primary_key_logical_name | O nome lóxico do atributo clave principal de Power Apps 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
Fornece a capacidade de acceder e procesar 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 |
|---|---|
| repeticións | 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. Pode ordenar as repeticións do evento e especificar un intervalo de datas que poden recuperar as repeticións, e obter tamén paxinación utilizando filtros Liquid
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
teña en conta que
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
tamén é posible.
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 atributos asociados enuméranse a continuación
| Atributo | Descripción |
|---|---|
| Enderezo 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
Fornece a posibilidade de acceder e procesar Foros e Fíos de conversa 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 avanzados 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
| 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
| 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
| 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 Power Apps 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. É posible combinar filtros con outros 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 | 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. É posible combinar filtros con outros filtros Liquid.
{% 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
artigo é un obxecto de entidade cos mesmos atributos, ademais dos enumerados a continuación.
| Atributo | Descripción |
|---|---|
| article_public_number | O Número público do Artigo do artigo. |
| comment_count | O valor enteiro do número total dos comentarios que 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 visualizou 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
categoría é un obxecto de entidade cos mesmos atributos, ademais dos enumerados a continuación.
| 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.
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 Power Apps 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
| 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, primario será null. |
| title | Título da páxina. |
| Enderezo URL | URL da páxina. |
| [Atributo ou nome da relación] | Pode acceder a calquera atributo do rexistro subxacente de Power Apps 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:
{{ page.adx_webpage_entitylist.adx_name }}En caso de que unha relación sexa reflexiva (é dicir, autorreferenciada), devolverase un obxecto entidades. (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 de Power Apps para cargar coleccións de entidades. |
polls
Fornece a capacidade de acceder e procesar unha 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
| 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. As etiquetas de iteración e os filtros de matriz pódense utilizar con esta colección. |
| 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
| 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. As Etiquetas de iteración e as entidades pódense utilizar con esta colección. |
| 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 contabilizados para a enquisa. |
Atributos da opción de enquisa
Nota
| 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 contabilizados 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
- Pode xerar URL dinamicamente en Liquid utilizando Filtros de URL.
- O URL usado en request.url pode ser calquera valor solicitado e almacénase na caché para solicitudes posteriores. Para garantir o valor correcto en request.url, considere usar a etiqueta de substitución, un URL parcial como ~{Ruta do ficheiro web} ou almacenar o URL do portal en Configuración do sitio.
- Versión de lanzamento de portais de Power Apps 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
| 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. /perfil/ |
| 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 |
| Enderezo 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 de Power Apps 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. A maneira en que funciona o índice de busca en relación coa filtraxe 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 o número real de resultados devolto para a páxina actual (xa que pode ser menor que o tamaño de páxina máximo especificado), utilice 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. Determinados tipos de consulta non admiten fragmentos destacados, tales como consultas aproximadas (~) e consultas comodín (*). Esta propiedade será nula neses casos. |
| ID | O id. da táboa de Power Apps 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 Power Apps 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 dos resultados, cun tamaño de páxina de 10, este valor será 11. |
| puntuación | A puntuación Lucene do resultado, como valor de punto flotante. Os resultados devolveranse en orde segundo este valor. |
| title | Título do resultado. |
| Enderezo 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 %}
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.) |
| Entidade | Devolve as entidades subxacentes do nó. Se o nó ten ningunha táboa subxacente, este valor será null. |
| 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 nó é o nó raíz, principal será null. |
| Cargo | Título do nó. |
| Enderezo URL | URK do nó. |
marcadores do sitio
Permítelle cargar os marcadores do sitio por nome. Se o marcador do sitio existe, devolverase un obxecto de marcador do sitio. Se non se atopa un marcador de sitio cun nome determinado, devolverase nulo.
{{ 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 dos marcadores do sitio
| Atributo | Descripción |
|---|---|
| Enderezo URL | Enderezo URL de destino do marcador do sitio. |
| [Nome lóxico do atributo] | Pode acceder a calquera atributo do rexistro de Power Apps 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 de código cun nome determinado, devolverase nulo.
{{ 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. |
Usuario
Refírese ao usuario do portal actual, permitindo acceso a todos os atributos do rexistro do contacto de Power Apps subxacente. Se ningún usuario iniciou sesión, esta variable será nulo.
O usuario é un obxecto de entidade.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
Nota
Versión de lanzamento de portais de Power Apps 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 procesar os distintivos para un usuario, debe 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 |
ligazóns web
Permite cargar calquera ligazón web por nome ou identificador
Se existe o conxunto de ligazóns web, devolverase un obxecto de conxunto de ligazóns web. Se non se atopa un conxunto de ligazóns web co nome ou o identificador determinado, devolverase nulo.
<!-- 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 %}
Atributos de conxuntos de ligazóns web
Nota
Un conxunto de ligazóns web é un obxecto de entidade, con todos os mesmos atributos, ademais dos que se indican a continuación.
| Atributo | Descrició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 Power Apps do conxunto de ligazóns web por nome lóxico. Por exemplo, {{ weblinkset.createdon }} |
Atributos da ligazón web
Nota
Unha ligazón web é un obxecto de entidade, con todos os mesmos atributos, ademais dos que se indican a continuación.
| Atributo | Descrición |
|---|---|
| Descrició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. |
| Imaxe | O obxecto da imaxe da ligazón web para esta ligazón. Este atributo será nulo se non hai imaxes presentes. |
| 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 Power Apps da ligazón web por nome lóxico. Por exemplo, {{ weblink.createdon }} |
Atributos de imaxe da ligazón web
| alternate_text | Texto alternativo para a imaxe. |
|---|---|
| Altura | Número enteiro que especifica a altura especificada da imaxe. Se non se forneceu ningún valor de altura, este atributo será nulo. |
| Enderezo URL | O URL da imaxe. |
| Largura | Número enteiro que especifica a anchura especificada da imaxe. Se non se forneceu ningún valor de anchura, este atributo será nulo. |
sitio web
Fai referencia ao sitio web do portal, que permite o acceso a todos os atributos do rexistro do sitio web de Power Apps (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
Nota
Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)
Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).
Comentarios
Enviar e ver os comentarios