Objectes de Liquid disponibles

Nota

Des del 12 d'octubre de 2022, els portals del Power Apps són Power Pages. Més informació: Microsoft Power Pages ara està disponible de manera general (bloc)
Ben aviat migrarem i combinarem la documentació dels portals del Power Apps amb la documentació del Power Pages.

Els objectes de Liquid contenen atributs per generar el contingut dinàmic de la pàgina. Per exemple, l'objecte page té un atribut que s'anomena title que es pot utilitzar per generar el títol de la pàgina actual.

Per accedir a un atribut de l'objecte pel nom, utilitzeu un punt (.). Per representar un atribut de l'objecte en una plantilla, poseu-lo entre {{ and }}.

Important

Per evitar possibles problemes de creació de scripts entre llocs (XSS), utilitzeu sempre el filtre d'escapament a les dades de codificació HTML sempre que s'utilitzin objectes del Liquid per llegir dades no fiables proporcionades per l'usuari.

{{ page.title }}

Als atributs d'un objecte també s'hi pot accedir amb un nom de cadena i []. Aquest format és útil en els casos en què l'atribut necessari s'ha determinat de forma dinàmica o el nom de l'atribut conté caràcters, com ara, espais, caràcters especials, etc., que no són vàlids quan utilitzeu un punt (.) dins de la sintaxi.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Els objectes següents es poden utilitzar en qualsevol lloc i, a més, també s'hi pot accedir des de qualsevol lloc, en qualsevol plantilla.

Objecte	Descripció
entitats	Permet pujar qualsevol taula del Power Apps per l'identificador. Més informació: entitats
ara	Un objecte de de data i hora que fa referència a l'hora local de l'usuari actual, en el moment en què es representa la plantilla. Nota: l'aplicació del portal web emmagatzema aquest valor a la memòria cau i no s'actualitza cada vegada. Més informació: Filtres de dades
pàgina	Fan referència a la pàgina de sol·licitud del portal actual. L'objecte page proporciona accés a elements, com ara, les rutes de navegació i el títol o l'adreça URL de la pàgina actual, i qualsevol atribut o entitat relacionada del registre del Power Apps subjacent. Més informació: pàgina
paràmetres	Una drecera convenient per a request.params. Sol·licitud de Més informació:
sol·licitud	Conté informació sobre la sol·licitud HTTP actual. Sol·licitud de Més informació:
configuració	Permet carregar Configuracions de lloc pel nom. Més informació: configuració
mapa del lloc	Permet accedir al mapa del lloc del portal. Més informació: mapa del lloc
marcadors de lloc	Permeten carregar marcadors de lloc pel nom. Més informació: marcadors de lloc
fragments	Permet carregar fragments de contingut pel nom. Més informació: fragments
usuari	Fa referència a l'usuari del portal actual, que permet accedir a tots els atributs del registre del contacte del Power Apps subjacents. Si cap usuari no ha iniciat sessió, aquesta variable serà null. Més informació: usuari
enllaços web	Permet pujar qualsevol conjunt d'enllaços web o identificador. Més informació: enllaços web
lloc web	Fa referència al registre del lloc web, la qual cosa permet l'accés a tots els atributs del registre del lloc web del Power Apps (adx_website) del portal. Més informació: lloc web

anuncis

Proporciona la capacitat per representar i accedir a un anunci.

L'objecte ads permet seleccionar un anunci específic o un una ubicació d'anunci.

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

Atributs d'anuncis

Atribut	Descripció
ubicacions	Retorna l'objecte adplacements.
[nom o identificador de l'anunci]	Podeu accedir a qualsevol anunci pel nom o per les propietats de l'identificador. {% assign ad = ads[Ad Name] %} {% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Atributs de les ubicacions de l'anunci

Atribut	Descripció
[nom del lloc o identificador de l'anunci]	Podeu accedir a qualsevol ubicació d'anunci pel nom o les propietats de l'identificador. {% assign placement = ads.placements[Placement Name or Id] %} {% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Atributs de la ubicació d'anunci

Una col·locació de l'anunci és un objecte de taula amb els mateixos atributs generals i els atributs que s'enumeren a continuació.

Atribut	Descripció
Anuncis	Retorna la col·lecció d'objectes d'anunci associats amb la ubicació. Les Etiquetes d'iteració i els Filtres de matriu es poden utilitzar amb aquesta col lecció.
Nom	Retorna el camp Nom per a la ubicació d'anunci.
placement_url	L'adreça URL es pot utilitzar per recuperar la ubicació d'anunci representada totalment per una plantilla.
random_url	L'adreça URL es pot utilitzar per recuperar un anunci aleatori representat totalment per una plantilla.

Atributs d'anunci

Nota

Un anunci és un objecte de taula, amb tots els mateixos atributs, a més dels que figuren a continuació.

Atribut	Descripció
ad_url	L'adreça URL es pot utilitzar per recuperar l'anunci representat totalment per una plantilla.
Còpia	Retorna el camp Copia per a l'anunci.
imatge	Retorna l'objecte de la imatge (si n'hi ha) per a l'anunci.
Nom	Retorna el camp Nom per a l'anunci.
open_in_new_window	Retorna Cert si l'adreça URL especificada per redirect_url s'ha d'obrir en una finestra nova.
redirect_url	L'adreça URL a la que es redirigirà a l'usuari quan seleccioni l'anunci.

Atributs de la imatge de l'anunci

Atribut	Descripció
alternate_text	Retorna el text que apareixerà a l'atribut alt de l'etiqueta.
height	Retorna l'alçada en píxels de la imatge
Adreça url	Retorna l'origen de l'adreça URL de la imatge.
width	Retorna l'amplada en píxels de la imatge

blocs

Ofereix la possibilitat d'accedir i representar blocs i entrades de bloc.

L'objecte blogs permet seleccionar un bloc o entrades de bloc específiques.

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

Objecte blogs

L'objecte blogs permet accedir a qualsevol bloc específic o a totes les entrades de bloc del portal.

En la taula següent s'expliquen els atributs associats amb l'objecte blogs.

Atribut	Descripció
missatges	Retorna un objecte blogposts que conté totes les entrades de bloc del portal.
[nom o identificador del blog]	Podeu accedir a qualsevol blog pel nom o per les propietats de l'identificador.

{% assign blog = blogs["Blog Name"] %}                             

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

Objecte blog

L'objecte blog permet treballar amb un únic bloc, la qual cosa permet accedir a les entrades d'aquest bloc.

En la taula següent s'expliquen diversos atributs associats amb l'objecte blog.

Atribut	Descripció
missatges	Retorna un objecte blogposts que conté totes les entrades de bloc del bloc.
Nom	El nom del bloc.
title	El títol del bloc.
Adreça url	L'adreça URL del bloc.

Objecte blogposts

L'objecte blogposts permet accedir a una col·lecció d'objectes d'entrades de bloc. Podeu demanar les entrades del bloc i aconseguir la paginació a més d'utilitzar filtres de Liquid:

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

Altres opcions possibles:

• blogs.posts.all (per obtenir totes les entrades del blog)
• blogs.posts | from\_index: 0 | take: 2

En la taula següent s'expliquen diversos atributs associats amb l'objecte blogposts.

Atribut	Descripció
Tot	Retorna tots els objectes blogpost a la col·lecció

Objecte blogpost

Fa referència a una única entrada de bloc.

En la taula següent s'expliquen diversos atributs associats amb l'objecte blogpost.

Atribut	Descripció
url	L'adreça URL de l'entrada.
contingut	Retorna el camp Contingut per a l'entrada.
autor	Torna els autors de l'entrada (que és simplement un objecte de taula de contacte).
títol	El títol de l'entrada.
comment_count	Retorna el valor enter del recompte dels comentaris que hi havia en una entrada determinada.
publish_date	La data en què es va publicar l'entrada.

entitats

Atenció

Per evitar possibles problemes de creació de scripts entre llocs (XSS), utilitzeu sempre el filtre d'escapament a les dades de cadena de codificació HTML sempre que s'utilitzi l'objecte del Liquid entities per llegir dades no fiables proporcionades per l'usuari.

Nota

Algunes de les convencions de noms del Dataverse han canviat, per exemple, les entitats del Dataverse ara s'anomenen taules. Els canvis de nom no s'apliquen als objectes de Liquid. L'objecte d'entitats de Liquid seguirà anomenant-se entitats.

Permet pujar qualsevol taula del Power Apps per l'identificador. Si la taula existeix, es retornarà un objecte de taula. Si no es troba una taula amb l'identificador especificat, es retornarà null.

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

{% if account %}

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

{% endif %}

{% assign entity_logical_name = 'contact' %}

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

{% if contact %}

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

{% endif %}

Entity

Un objecte d'entitat ofereix accés als atributs d'un registre de taula del Power Apps.

Atribut	Descripció
Id.	L'identificador de GUID de la taula, com una cadena. Per exemple, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	Nom lògic de la taula del Power Apps.
Notes	Carrega qualsevol nota (annotation) associada amb la taula, ordenades de més antiga a més recent (createdon). Les notes es retornen com a objectes de nota.
permisos	Carrega els resultats d'asserció de permís de taula de la taula. Els resultats es retornen com a objecte de permisos.
url	Retorna el camí d'adreça URL del sistema de gestió de continguts dels portals del Power Apps de la taula. Si la taula té cap adreça URL vàlida al lloc web actual, retornarà nul. Generalment, això només retornarà un valor per a determinats tipus de taula que s'han integrat al CMS del portal , llevat que hagueu personalitzat el proveïdor d'adreça URL a la aplicació.
[nom d'atribut o relació]	Podeu accedir a qualsevol atribut de la taula del Power Apps mitjançant el nom lògic. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Els valors de la majoria d'atributs de taula s'apliquen directament a Tipus de Liquid: els dos camps d'opció s'apliquen a booleans, els camps de text a les cadenes, els camps numèric i de moneda als números i els camps data i hora als objectes de data. No obstant això, alguns tipus d'atributs es retornen com a objectes: Els camps Cerca (Referència de taula associada) es retornen com a objectes de referència de taula associats. Els camps Conjunt d'opcions i Llista de selecció es retornen com a objectes de valor de conjunt d'opcions. També podeu carregar qualsevol entitat relacionada mitjançant el nom de esquema de relació. {{ page.adx_webpage_entitylist.adx_name }}En cas que una relació sigui reflexiva (és a dir, amb una relació de referència), es retornarà un objecte de relació reflexiva. (En cas contrari, el resultat seria ambigu).{{ page.adx_webpage_webpage.referencing.adx_name }} Nota: La càrrega d'un gran número d'entitats relacionades o l'accés a un gran número de relacions en una sola plantilla poden tenir un impacte negatiu en el rendiment de representació de la plantilla. Eviteu carregar entitats relacionades per a cada element d'una matriu, en un bucle. Si és possible, utilitzeu Etiquetes de taula del Dataverse per carregar col·leccions d'entitats.

Referència de la taula associada

Els valors d'atribut de cerca es retornen com a objectes de referència de taula associada, amb els atributs següents.

Atribut	Descripció
Id.	L'identificador de GUID de la taula de referència, com una cadena. Per exemple, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	El nom lògic del Power Apps de la taula a la qual es fa referència.
Nom	L'atribut del nom principal de la taula a la qual es fa referència.

Nota

Una nota és un objecte de taula que ofereix accés als atributs i relacions d'un registre d'anotació. A més de tenir tots els atributs d'un objecte de taula, una nota té els atributs addicionals següents.

Atribut	Descripció
documentbody	Carrega l'atribut documentbody del registre annotation de nota, com una cadena codificada en base 64. Atès que el contingut d'aquest atribut pot ser gran, no es carregarà amb la resta dels atributs de nota i només es carregarà segons demanda. Nota: L'ús de l'atribut documentbody podria tenir un impacte negatiu en el rendiment de representació de la plantilla i ha de fer-se amb precaució. Utilitzeu l'atribut URL per proporcionar un enllaç a la nota adjunta, si és possible.
Adreça url	Retorna el camí d'adreça URL per al controlador de l'anotació de portal de creació adjunta. Si l'usuari té permís i la nota conté un fitxer adjunt, una petició a aquesta adreça URL descarregarà el fitxer de nota adjunt.

Nota

Filtres addicionals

Valor de conjunt d'opcions

Els valors d'atribut de conjunt d'opcions i de llista de selecció es retornen com a objectes de referència de taula associada, amb els atributs següents.

Atribut	Descripció
Etiqueta	L'etiqueta localitzada del valor d'atribut de conjunt d'opcions i de llista de selecció. Per exemple, Actiu
Valor	El valor enter del valor d'atribut de conjunt d'opcions i de llista de selecció. Per exemple, 0

Permisos de la taula

L'objecte de permisos de taula ofereix accés als resultats d'asserció de permís agregats d'una taula.

Atribut	Descripció
can_append	Retorna true si l'usuari actual té permís per annexar els registres a les relacions d'aquest registre. En cas contrari, retorna False.
can_append_to	Retorna true si l'usuari actual té permís per annexar els registres a la relació d'una altra taula. En cas contrari, retorna False.
can_create	Retorna true si l'usuari actual té permís per crear registres nous d'aquest tipus de taula. En cas contrari, retorna False.
can_delete	Retorna true si l'usuari actual té permís per suprimir aquest registre. En cas contrari, retorna False.
can_read	Retorna true si l'usuari actual té permís per llegir aquest registre. En cas contrari, retorna False.
can_write	Retorna true si l'usuari actual té permís per actualitzar aquest registre. En cas contrari, retorna False.
rules_exist	Retorna true si els resultats de permís representats per aquest objecte són el resultat de normes de permís explícitament definides. Retorna false si són els resultats per defecte quan no hi ha permisos definits explícitament.

Relació reflexiva

Carrega relacions reflexives (és a dir, de referència a un mateix) a les entitats que es retornen com a objectes amb els atributs següents.

Atribut	Descripció
is_reflexive	Retorna true. Es pot utilitzar per provar si un objecte retornat per una relació és un objecte de relació reflexiva.
referències	Retorna una matriu d'entitats a les quals es fa referència per a la relació determinada.
referències	Retorna una taula de referència per a la relació determinada. Retorna nul si no existeix cap taula de referència. Si la relació és de diversos a diversos (N:N), retorna una matriu d'entitats de referència.

entitylist

L'objecte de llista de taules s'utilitza dins de les etiquetes de taula del Power Apps al Dataverse. Proporciona accés a tots els atributs d'una llista determinada.

Nota

Representació d'una llista associada amb la pàgina actual

Atributs

Nota

entitats

Atribut	Descripció
create_enabled	Retorna true si la creació de nous registres està configurada per a la llista. En cas contrari, retorna False.
create_url	Retorna el camí d'adreça URL configurat de l'enllaç o botó de creació per a la llista.
detail_enabled	Retorna true si una visualització de detall dels registres individuals està configurada per a la llista. En cas contrari, retorna False.
detail_id_parameter	Retorna el nom del paràmetre de cadena de consulta que s'utilitzarà per a l'identificador de registre en construir una adreça URL de visualització de detall de registre. Consulteu filtres d'adreça URL per obtenir més informació sobre l'ús de filtres de Liquid per construir adreces URL. Per exemple, id
detail_label	Retorna l'etiqueta localitzada configurada dels enllaços o botons de visualització de detall per a la llista.
detail_url	Retorna el camí d'adreça URL configurat d'enllaç o botó de visualització de detall per a la llista.
empty_list_text	Retorna el text localitzat configurat que es mostrarà quan la visualització de llista no torni cap resultat.
enable_entity_permissions	Retorna true si s'habilita el filtre de permís de taula per a aquesta llista. En cas contrari, retorna False.
entity_logical_name	Retorna el nom lògic de taula del Power Apps per als registres que es visualitzaran mitjançant aquesta llista. Per exemple, contacte
filter_account_attribute_name	Retorna el nom lògic de l'atribut per a la cerca de compte que s'utilitzarà per filtrar els registres de resultat mitjançant el compte principal de l'usuari del portal actual. Per exemple, accountid
filter_apply_label	Retorna l'etiqueta localitzada configurada que s'utilitzarà per al botó o l'enllaç que aplica un filtre d'atribut avançat als resultats de la llista.
filter_definition	Retorna la definició de filtre d'atribut JSON per a la llista. Consulteu Filtres de llista per obtenir més informació sobre com utilitzar el filtre de Liquid metafilters per processar aquesta definició.
filter_enabled	Retorna true si s'habilita el filtratge d'atribut avançat per a la llista. En cas contrari, retorna False.
filter_portal_user_attribute_name	Retorna el nom lògic d'atribut per a la cerca de contacte que s'utilitzarà per filtrar els registres de resultat mitjançant el contacte de l'usuari de portal actual. Per exemple, contactid
filter_website_attribute_name	Retorna el nom lògic d'atribut per a la cerca d'adx_website que s'utilitzarà per filtrar els registres de resultat mitjançant el lloc web del portal actual. Per exemple, adx_websiteid
language_code	Retorna el codi de llengua enter de Power Apps que s'utilitzarà per seleccionar totes les etiquetes localitzades d'aquesta llista.
page_size	Retorna la mida de pàgina de resultat configurada de la llista.
primary_key_name	Retorna el nom lògic d'atribut clau principal per als registres que es visualitzaran mitjançant aquesta llista.
search_enabled	Retorna true si s'habilita la cerca per a aquesta llista. En cas contrari, retorna False.
search_placeholder	Retorna el text localitzat configurat per al marcador de posició del camp de cerca de llista.
search_tooltip	Retorna el text localitzat configurat per a l'indicador de cerca de llista.
visualitzacions	Retorna les visualitzacions disponibles de la llista, com a objectes de visualització de llista.
[nom lògic de l'atribut]	Podeu accedir a qualsevol atribut del registre del Power Apps de la llista (adx_entitylist) mitjançant el nom lògic, de la mateixa manera que un objecte taula. Per exemple, {{ entitylist.adx_name }}

Atributs de visualització de llista

Atribut	Descripció
columnes	Retorna les columnes de la visualització, com a objectes de columna de visualització de llista.
entity_logical_name	Retorna el nom lògic de taula del Power Apps per als registres inclosos a la visualització. Per exemple, contacte
Identificador	Retorna l'identificador de GUID de la visualització.
language_code	Retorna el codi de llengua enter del Power Apps que s'utilitzarà per seleccionar totes les etiquetes localitzades (capçaleres de columna, etc.) per a la visualització.
Nom	Retorna el nom de visualització del Power Apps de la visualització.
primary_key_logical_name	Retorna el nom lògic de clau principal de taula del Power Apps per als registres inclosos a la visualització. Per exemple, contactid
sort_expression	Retorna l'expressió de tipus per defecte de la visualització. Per exemple, name ASC, createdon DESC

Atributs de columna de visualització de llista

Atribut	Descripció
attribute_type	Retorna el nom de tipus d'atribut del Power Apps de la columna, com una cadena. Per exemple, Lookup, Picklist, String, Boolean, DateTime
logical_name	Retorna el nom lògic d'atribut del Power Apps de la columna. Per exemple, createdon
Nom	Retorna el nom de visualització del Power Apps localitzat de la columna. Per exemple, Created On
sort_ascending	Retorna una cadena d'expressió de tipus de la columna d'ordenació en ordre ascendent. Per exemple, createdon ASC
sort_descending	Retorna una cadena d'expressió de tipus de la columna d'ordenació en ordre descendent. Per exemple, createdon DESC
sort_disabled	Retorna true si s'inhabilita l'ordenació de la columna. En cas contrari, retorna False.
sort_enabled	Retorna true si s'habilita l'ordenació de la columna. En cas contrari, retorna False.
width	Retorna l'amplada configurada de la columna, en píxels.

entityview

L'objecte entityview s'utilitza a l'etiqueta entityview i proporciona accés a les metadades de la vista, a més dels registres de resultats de visualització.

Atributs

Atribut	Descripció
columnes	Retorna les columnes de la visualització, com a objectes de columna de visualització de taula.
entity_permission_denied	Retorna true si l'accés als resultats de visualització s'ha denegat atès que els permisos de taula de l'usuari actual són insuficients. Retorna false si s'ha concedit l'accés de lectura per veure els resultats.
entity_logical_name	El nom lògic de la taula del Power Apps dels registres de resultats de visualització. Per exemple, contacte
first_page	El número de pàgina de la primera pàgina dels resultats de visualització. Aquest serà 1 si no hi havia cap resultat retornat; en aquest cas serà nul.
Identificador	L'identificador de GUID de la visualització del Power Apps que defineix aquesta entityview.
language_code	El codi enter de llengua del Power Apps que s'utilitza per carregar les etiquetes localitzades per a la visualització actual.
last_page	El número de pàgina de la última pàgina dels resultats de visualització. Si no s'ha retornat cap resultat, aquesta serà nul.
nom	El nom de la visualització del Power Apps que defineix aquest entityview, per exemple, contactes actius.
next_page	El número de pàgina de la pàgina següent dels resultats de visualització. Si no hi ha cap pàgina de resultats següent, serà nul.
Pàgina	El número de pàgina de la pàgina actual dels resultats de visualització.
pàgines	Retorna una matriu de números de pàgina que conté totes les pàgines de resultats per a la visualització actual.
page_size	El número de resultats que s'han retornat per pàgina per a la visualització actual.
previous_page	El número de pàgina de la pàgina següent dels resultats de visualització. Si no hi ha cap pàgina de resultats anterior, serà nul.
primary_key_logical_name	El nom lògic del Power Apps de l'atribut clau principal de la taula de resultats per a aquesta visualització. Per exemple, contactid
registres	La pàgina actual de registres de resultats de la visualització, com a objectes de taula.
sort_expression	L'expressió de tipus per defecte de la visualització. Per exemple, nameASC, createdon DESC.
total_pages	El nombre total de pàgines de resultats de la visualització.
total_records	El nombre total de resultats de la visualització (de totes les pàgines).

incidències

Proporciona la capacitat d'accedir als esdeveniments i representar-los. L'objecte events permet seleccionar un esdeveniment específic o tots els esdeveniments.

Objecte esdeveniments

L'objecte events permet accedir a qualsevol esdeveniment específic o a tots els esdeveniments del portal (independentment de l'esdeveniment).

L'objecte events té els atributs següents:

Atribut	Descripció
repeticions	Retorna un objecte eventoccurancess que conté totes les repeticions d'esdeveniments del portal
[nom o identificador de l'esdeveniment]	Podeu accedir a qualsevol incidència pel nom o per les propietats de l'identificador. {% assign event = events["Nom de l'esdeveniment"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Objecte esdeveniment

L'objecte event permet treballar amb un únic esdeveniment, la qual cosa permet accedir als programes i les repeticions d'aquest esdeveniment.

L'objecte event té els atributs següents:

Atribut	Descripció
repeticions	Retorna un objecte eventoccurancess que conté totes les repeticions d'esdeveniments.
nom	El nom de l'esdeveniment.
Adreça url	L'adreça URL de la incidència.

Objecte eventoccurences

L'objecte eventoccurrences permet accedir a una col·lecció d'objectes de repeticions d'esdeveniments. Podeu ordenar les repeticions d'esdeveniments i especificar l'interval de dates de les repeticions per recuperar-les i aconseguir la paginació, així com utilitzar els filtres de Liquid

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

tingueu en compte que:

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

també és possible.

Els atributs següents estan associats amb l'objecte eventoccurrences

Atribut	Descripció
Tot	Retorna tots els objectes eventoccurrences a la col·lecció

Objecte eventoccurence

Representa una única repetició d'esdeveniments. A continuació s'indiquen els atributs associats:

Atribut	Descripció
Adreça url	L'adreça URL de la repetició.
is_all_day_event	És un esdeveniment que dura tot el dia?
start_time	L'hora d'inici de l'esdeveniment.
end_time	L'hora d'acabament de l'esdeveniment.

forloop

Conté propietats útils a un bloc de bucle for.

Nota

forloop només es pot utilitzar dins d'una etiqueta for.

Codi

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

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

{% endif %}

{% endfor %}

Sortida

This is the first child page!

This is child page number 2.

This is child page number 3.

Atributs

Atribut	Descripció
primer	Torna true si és la primera iteració del bucle. Torna false si no és la primera iteració.
índex	La posició de l'element actual a la col·lecció, en què el primer element té una posició d'1.
index0	La posició de l'element actual a la col·lecció, en què el primer element té una posició d'0.
Última	Torna true si és la última iteració del bucle. Torna false si no és la última iteració.
longitud	Torna el nombre d'iteracions del bucle ߝ i el número d'elements de la col·lecció que s'han iterat.
rindex	El número d'elements restants del bucle (longitud - índex) on 1 és l'índex de l'últim element.
rindex0	El número d'elements restants del bucle (longitud - índex) on 0 és l'índex de l'últim element.

fòrums

Ofereix la possibilitat d'accedir i representar fòrums i fils de fòrums. La capacitat d'utilitzar Liquid per representar dades del fòrum s'estén fins a les entrades, però per crear una nova entrada o fil, heu d'utilitzar una plantilla de pàgina de formularis avançats de diversos passos ASP.NET amb aquesta funcionalitat incorporada (com el fil del fòrum o les plantilles de pàgina de les entrades del fòrum).

L'objecte fòrums permet seleccionar un fòrum o fils de fòrums:

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

Objecte fòrums

L'objecte fòrums permet accedir a qualsevol fòrum específic del portal o a tots els fils del fòrum del portal (independentment del fòrum).

L'objecte forum permet treballar amb un únic fòrum, la qual cosa permet accedir als fils d'aquell fòrum.

L'objecte forumthreads permet accedir a una col·lecció d'objectes forumthread. Podeu demanar els fils del fòrum i aconseguir la paginació així com utilitzar filtres de Liquid.

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

Un únic fil de fòrum

L'objecte forumposts permet accedir a una col·lecció d'objectes forumpost.

Atributs

Atribut	Descripció
fils	Retorna un objecte forumthreads que conté tots els objectes forumthreads del portal.
Tot	Retorna tots els objectes forum del portal. Tingueu en compte que website.forums també és un equivalent.
thread_count	Retorna el valor enter del recompte del número de fils que hi ha a tot el lloc web.
post_count	Retorna el valor enter del recompte del número d'entrades que hi ha a tot el portal.
[nom o identificador del fòrum]	Podeu accedir a qualsevol fòrum pel nom o per les propietats de l'identificador. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Objecte fòrum

Atributs

Nota

entitats

Atribut	Descripció
fils	Retorna un objecte forumthreads que conté tots els fils del fòrum.
Nom	El nom del fòrum.
thread_count	Retorna el valor enter del recompte del número de fils que hi ha al fòrum.
post_count	Retorna el valor enter del recompte del número d'entrades que hi ha a tot el fòrum.

Objecte forumthreads

Atributs

Atribut	Descripció
Tot	Retorna tots els objectes forumthreads a la col·lecció.

Objecte forumthread

Atributs

Nota

entitats

Atribut	Descripció
missatges	Retorna un objecte forumposts que conté totes les entrades de fòrum del fil.
autor	Torna l'autor del fil (que és simplement un objecte de taula de contacte).
latest_post	Retorna l'últim missatge del fil.
first_post	Retorna el primer missatge del fil.
post_count	Retorna el valor enter del recompte del número d'entrades que hi ha al fil.
is_answered	S'ha respost el fil?
is_sticky	És un fil permanent?

Objecte forumposts

Atributs

Atribut	Descripció
Tot	Retorna tots els objectes forumthreads a la col·lecció.

Una única entrada de fòrum

Atributs

Nota

entitats

Atribut	Descripció
autor	Torna l'autor de l'entrada (que és simplement un objecte de taula de contacte).
contingut	El contingut de l'entrada.
is_answer	Aquesta entrada és una resposta del fil?

coneixement

Proporciona accés al knowledgearticle del Power Apps i als registres de taula de categories per representar articles i categories en un portal.

Atributs

Atribut	Descripció
articles	Retorna un objecte "articles" que conté objectes d'article per als registres de taula knowledgearticle disponibles al portal.
de guardons	Retorna un objecte "categories" que conté objectes de categories per als registres de taula de categoria disponibles al portal.

objecte "articles"

L'objecte "articles" permet accedir a una col·lecció d'objectes "article". Podeu demanar els articles i aconseguir la paginació així com utilitzar filtres de Liquid.

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

Atributs

Atribut	Descripció
popular	Retorna una col·lecció d'objectes "article" que conté més vistes. {% assign popular_articles = knowledge.articles.popular %}
recent	Retorna una col·lecció d'objectes "article" que conté les últimes dates modificades. {% assign recent_articles = knowledge.articles.recent %}
principal	Retorna una col·lecció d'objectes "article" que conté les valoracions més altes. {% assign top_articles = knowledge.articles.top %}

Filtres

Els filtres següents poden acceptar paràmetres opcionals per a la mida de la pàgina i l'idioma. El primer paràmetre és el nombre o registres per recuperar. La pàgina per defecte és 5. El segon paràmetre és el codi d'un idioma per recuperar els articles per a un determinat idioma. Els filtres es poden combinar amb altres filtres de Liquid.

{% assign page_size = 5 %}
{% assign language_code = website.selected_language.code %}
{% assign recent_articles = knowledge.articles | recent: page_size, language_code %}

Atribut	Descripció
popular	Retorna una col·lecció d'objectes "article" que conté més vistes. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
recent	Retorna una col·lecció d'objectes "article" que conté les últimes dates modificades. {% assign recent_articles = knowledge.articles \| recent: 5 %}
principal	Retorna una col·lecció d'objectes "article" que conté les valoracions més altes. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

objecte "categories"

L'objecte "categories" permet accedir a una col·lecció d'objectes de categories. Podeu demanar les categories i aconseguir la paginació així com utilitzar filtres de Liquid.

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

Atributs

Atribut	Descripció
recent	Retorna una col·lecció d'objectes "categoria" que conté les últimes dates modificades.
top_level	Retorna una col·lecció d'objectes de categoria que no tenen una categoria principal.

Filtres

Els filtres següents poden acceptar un paràmetre opcional que indica la mida de la pàgina. La pàgina per defecte és 5. Els filtres es poden combinar amb altres filtres de Liquid.

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}

Atribut	Descripció
recent	Retorna una col·lecció d'objectes "categoria" que conté les últimes dates modificades. Podeu proporcionar els paràmetres {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level	Retorna una col·lecció d'objectes de categoria que no tenen una categoria principal. {% assign root_categories = knowledge.categories \| top_level %}

objecte "article"

L'objecte article permet treballar amb un sol knowledgearticle per mostrar detalls d'aquest article en el portal.

Atributs

article és un objecte d'entitat, amb tots els mateixos atributs, a més dels que figuren a continuació.

Atribut	Descripció
article_public_number	El número públic de l'article.
comment_count	El valor enter del recompte dels comentaris que hi havia en un article determinat.
contingut	El contingut de l'article.
current_user_can_comment	Retorna un valor booleà que indica si l'usuari actual pot afegir comentaris a l'article.
is_rating_enabled	Retorna un valor booleà que indica si està habilitada la valoració en un article.
keywords	Les paraules clau de l'article.
nom	Un àlies alternatiu per al títol de l'article.
rating	El valor de la valoració decimal a l'article.
title	El títol de l'article.
view_count	El valor enter del nombre de vegades que s'ha visualitzat l'article.

objecte "category"

L'objecte category permet treballar amb una sola categoria per mostrar els seus detalls en el portal.

Atributs

category és un objecte d'entitat, amb tots els mateixos atributs, a més dels que figuren a continuació.

Atribut	Descripció
categorynumber	El número de categoria de la categoria.
nom	Un àlies alternatiu per al títol de la categoria.
títol	El títol de la categoria.

llengua

Proporciona el nom de la llengua actual i el codi de la llengua si la compatibilitat amb diverses llengües està habilitada.

Atributs

Atribut	Descripció
url	L'URL de sol·licitud actual té com a prefix el codi de llengua actual.
url_substitution	L'URL de la sol·licitud actual amb el prefix del codi de llengua actual sense passar per la memòria cau de sortida de la pàgina.
nom	Títol de la llengua actual.
code	Codi de llengua de la llengua.

Per exemple, la plantilla web Desplegable de llengües per defecte utilitza aquest objecte del Liquid per enumerar les llengües disponibles quan hi ha diverses llengües disponibles.

pàgina

Fan referència a la pàgina de sol·licitud del portal actual. Aquest objecte combina els atributs del mapa del lloc i les entitats de la sol·licitud actual (normalment una pàgina web).

L'objecte page proporciona accés a elements, com ara, les rutes de navegació i el títol o l'adreça URL de la pàgina actual, i qualsevol atribut o entitat relacionada del registre del Power Apps subjacent.

<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 }}. -->

Atributs de la pàgina

Nota

entitats

Atribut	Descripció
rutes de navegació	Retorna els objectes del node de mapa del lloc de la ruta de navegació de la pàgina, des del node arrel del mapa del lloc fins al principal.
secundaris	Retorna els objectes del node de mapa del lloc secundaris de la pàgina.
principal	Retorna el node del mapa del lloc principal de la pàgina. Si la pàgina és la pàgina principal, el principal serà nul.
title	El títol de la pàgina.
Adreça url	L'adreça URL de la pàgina.
[nom d'atribut o relació]	Podeu accedir a qualsevol atribut del registre del Power Apps subjacent de la pàgina mitjançant el nom lògic. {{ page.createdon }} {% assign attribute_name = 'name' %} {{ page[attribute_name] }} Els valors de la majoria d'atributs de taula s'apliquen directament a Tipus de Liquid: els dos camps d'opció s'apliquen a booleans, els camps de text a les cadenes, els camps numèric i de moneda als números i els camps data i hora als objectes de data. No obstant això, alguns tipus d'atributs es retornen com a objectes: Els camps Cerca (Referència de taula associada) es retornen com a objectes de referència de taula associats. Els camps Conjunt d'opcions i Llista de selecció es retornen com a objectes de valor de conjunt d'opcions. També podeu carregar qualsevol entitat relacionada mitjançant el nom de esquema de relació. {{ page.adx_webpage_entitylist.adx_name }} En cas que una relació sigui reflexiva (és a dir, amb una relació de referència), es retornarà un objecte entitats. (En cas contrari, el resultat seria ambigu).{{ page.adx_webpage_webpage.referencing.adx_name }} Nota: La càrrega d'un gran número d'entitats relacionades o l'accés a un gran número de relacions en una sola plantilla poden tenir un impacte negatiu en el rendiment de representació de la plantilla. Eviteu carregar entitats relacionades per a cada element d'una matriu, en un bucle. Si és possible, utilitzeu les de taula del Dataverse al Power Apps per carregar col·leccions d'entitats.

sondejos

Proporciona la capacitat per representar i accedir a un sondeig.

L'objecte polls permet seleccionar un sondeig específic o una ubicació de sondeig:

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

Atributs de sondeig

Atribut	Descripció
ubicacions	Retorna l'objecte pollplacements.
[nom o identificador del sondeig]	Podeu accedir a qualsevol sondeig pel nom o per les propietats de l'identificador. {% assign poll = polls[Poll Name] %} {% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Atributs de les ubicacions del sondeig

Atribut	Descripció
[nom del lloc o identificador del sondeig]	Podeu accedir a qualsevol ubicació de sondeig pel nom o les propietats de l'identificador.{% assign placement = polls.placements[Placement Name or Id] %} {% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Atributs de la ubicació del sondeig

Nota

entitats

Atribut	Descripció
Nom	Retorna el camp Nom per a la ubicació del sondeig.
placement_url	L'adreça URL es pot utilitzar per recuperar la ubicació del sondeig representada totalment per una plantilla.
sondejos	Retorna la col·lecció d'objectes de sondeig associats amb la ubicació. Les Etiquetes d'iteració i els Filtres de matriu es poden utilitzar amb aquesta col lecció.
random_url	L'adreça URL es pot utilitzar per recuperar un sondeig aleatori representat totalment per una plantilla.
submit_url	L'adreça URL a la que s'envia un sondeig completat.

Atributs de sondeig

Nota

entitats

Atribut	Descripció
has_user_voted	Retorna Cert si l'usuari actual (amb sessió iniciada o anònim) ja ha votat en aquest sondeig.
Nom	Retorna el camp Nom per al sondeig.
opcions	Retorna la col·lecció d'objectes poll option associats amb el sondeig. Les Etiquetes d'iteració i les entitats es poden utilitzar amb aquesta col lecció.
poll_url	L'adreça URL es pot utilitzar per recuperar el sondeig representat totalment per una plantilla.
Pregunta del	Retorna el camp Pregunta per al sondeig.
submit_button_label	Retorna una cadena que es poden utilitzar per substituir l'etiqueta del botó Envia per al sondeig.
submit_url	L'adreça URL a la que s'envia un sondeig completat.
user_selected_option	Retorna l'objecte polloption seleccionat per l'usuari (si ja ha votat).
vots	Retorna el número de vots que s'han tabulat per al sondeig.

Atributs de l'opció de sondeig

Nota

entitats

Atribut	Descripció
resposta	Retorna el camp Resposta per al sondeig.
percentatge	Torna el percentatge de vots del sondeig per a l'opció com un número decimal de 0 a 100.
vots	Retorna el número de vots que s'han tabulat per a l'opció.

sol·licitud

Conté informació sobre la sol·licitud HTTP actual.

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

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

Nota

• Podeu crear adreces URL de forma dinàmica a Liquid mitjançant Filtres d'adreces URL.
• L'adreça URL utilitzada per a request.url pot ser qualsevol valor sol·licitat i s'afegeix a la memòria cau per a sol·licituds posteriors. Per garantir el valor correcte a request.url, considereu la possibilitat d'utilitzar l'etiqueta de substitució, una adreça URL parcial, com ara ~{Ruta del fitxer web} o emmagatzemar l'adreça URL del portal a la Configuració del lloc.
• Els portals del Power Apps amb la versió 9.3.8.x o posterior disposaran per defecte del filtre d'escapada de Liquid aplicat per a objectes de Liquid usuari i sol·licitud. Per inhabilitar aquesta configuració per defecte i permetre que aquests objectes del Liquid sense filtre d'escapada del Liquid, vegeu la configuració del lloc del portal - Site/EnableDefaultHtmlEncoding.

Atributs

Atribut	Descripció
paràmetres	El paràmetre anomenat per a la sol·licitud actual. params és una combinació de paràmetres de consulta d'adreces URL, paràmetres de publicació de formularis i galetes.
Camí	El camí de l'adreça URL de sol·licitud actual. /profile/
path_and_query	El camí i la consulta de l'adreça URL de sol·licitud actual. /profile/?foo=1&bar=something
consulta	La part de la consulta de l'adreça URL de sol·licitud actual. ?foo=1&bar=something
Adreça url	L'adreça URL completa de la sol·licitud actual. https://www.example.com/profile/?foo=1&bar=something

searchindex

L'objecte searchindex s'utilitza amb les etiquetes de taula del Dataverse al Power Apps i proporciona accés als resultats de la 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 %}

Atributs

Atribut	Descripció
approximate_total_hits	Retorna un recompte aproximat de les visites totals que coincideixen amb la consulta d'índex. Degut a la forma en que funciona l'índex de cerca en relació amb el filtratge de seguretat i altres factors del disseny, el número només és una aproximació i és possible que no coincideixi exactament amb el número total de resultats disponibles per a l'usuari actual en algunes situacions.
Pàgina	Retorna el número de pàgina de la consulta actual.
page_size	Retorna la midà màxima de la pàgina de la consulta actual. Si voleu que es retorni el número de resultats per a la pàgina actual (ja que pot ser menor a la mida de la pàgina màxima especificada), heu d'utilitzar results.size.
Resultats	Retorna la pàgina de resultats de la consulta, com a objectes de resultats d'índex de cerca.

Resultats de l'índex de cerca

Atribut	Descripció
entitat	L'objecte entitats subjacent del resultat.
fragment	Un fragment de text breu pertinent del resultat, amb termes que coincideixen amb la consulta especificada destacada amb l'etiqueta HTML <em>. Alguns tipus de consultes no admeten els fragments destacats, com ara les consultes confuses (~) i les consultes comodí (*). Aquesta propietat serà nul·la en aquests casos.
Id.	L'identificador de taula del Power Apps del registre subjacent del resultat, com una cadena. Per exemple, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	El nom lògic de la taula del Power Apps del registre subjacent del resultat. Per exemple, adx_webpage
Número	El número del resultat, de totes les pàgines de resultats, a partir d'1. Per exemple, per al primer resultat de la segona pàgina de resultats, amb una mida de pàgina de 10, aquest valor serà 11.
puntuació	La puntuació Lucene del resultat, com un valor de coma flotant. Els resultats es retornaran ordenats per aquest valor.
title	El títol del resultat.
Adreça url	L'adreça URL del resultat. Normalment serà—però no necessàriament—serà una ruta d'accés absoluta de l'aplicació actual, en lloc d'una adreça URL completa. Per exemple: /articles/article1/

configuració

Permet carregar una configuració de lloc pel nom. Si no es troba una configuració amb el nom especificat, es retornarà null.

Nota

La configuració es retorna com a cadenes, però podeu utilitzar els filtres de Tipus per convertir-les a altres tipus.

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

Representació d'una capçalera del lloc web i d'una barra de navegació principal

mapa del lloc

Permet accedir al mapa del lloc del portal.

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

<ul class=breadcrumb>

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

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

{% endfor %}

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

</ul>

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

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

{% endfor %}

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

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

{% if node %}

{% for child in node.children %}

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

{% endfor %}

{% endif %}

Atributs del mapa del lloc

Atribut	Descripció
Actual	Retorna l'objecte del node de mapa del lloc de la pàgina actual.
Arrel	Retorna l'objecte del node de mapa del lloc de la pàgina arrel (inicial) del lloc web.

Atributs del node de mapa del lloc

Atribut	Descripció
Rutes de navegació	Retorna els objectes del node de mapa del lloc de la ruta de navegació del node, des del node arrel del mapa del lloc fins al principal.
Fills	Retorna els objectes del node de mapa del lloc secundaris del node.
Descripció	El contingut del resum o la descripció del node. (Aquest camp pot contenir HTML).
Entitat	Retorna les entitats subjacents del node. Si el node no té cap taula subjacent, aquest valor serà nul.
is_sitemap_ancestor	Torna true si el node del mapa del lloc és un avantpassat del node actual, en cas contrari false.
is_sitemap_current	Torna true si el node del mapa del lloc és el node actual, en cas contrari false.
Principal	Retorna el node del mapa del lloc principal del node. Si el node és el node arrel, el principal serà nul.
Càrrec	El títol del node.
Adreça url	L'adreça URL del node.

marcadors de lloc

Permeten carregar marcadors de lloc pel nom. Si el marcador de lloc existeix, es retornarà un objecte del marcador de lloc. Si no es troba un marcador de lloc amb el nom especificat, es retornarà null.

{{ sitemarkers[Login].url }}

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

{% if my_sitemarker %}

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

{% else %}

Site marker My Site Marker does not exist.

{% endif %}

Nota

Representació d'una capçalera del lloc web i d'una barra de navegació principal

Atributs dels marcadors de lloc

Atribut	Descripció
Adreça url	L'adreça URL de l'objectiu del marcador de lloc.
[nom lògic de l'atribut]	Podeu accedir a qualsevol atribut del registre del Power Apps de l'objectiu del marcador de lloc mitjançant el nom lògic. Per exemple, {{ sitemarker.adx_name }}

fragments

Permeten carregar fragments de contingut pel nom. Si no es troba una fragment amb el nom especificat, es retornarà null.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

bucle de fila de taula

Conté propietats útils a un bloc de bucle Etiquetes d'iteració.

Nota

tablerowloop només es pot utilitzar dins d'una etiqueta Etiquetes d'iteració.

Atributs

Atribut	Descripció
Col	Retorna l'índex de la fila actual, començant per 1.
col0	Retorna l'índex de la fila actual, començant per 0.
col_first	Retorna true si la columna actual és la primera columna d'una fila i retorna false si no ho és.
col_last	Retorna true si la columna actual és l'última columna d'una fila i retorna false si no ho és.
Nom	Torna true si és la primera iteració del bucle. Torna false si no és la primera iteració.
Índex	La posició de l'element actual a la col·lecció, en què el primer element té una posició d'1.
index0	La posició de l'element actual a la col·lecció, en què el primer element té una posició d'0.
Última	Torna true si és la última iteració del bucle. Torna false si no és la última iteració.
Longitud	Torna el nombre d'iteracions del bucle ߝ i el número d'elements de la col·lecció que s'han iterat.
Rindex	El número d'elements restants del bucle (longitud - índex) on 1 és l'índex de l'últim element.
rindex0	El número d'elements restants del bucle (longitud - índex) on 0 és l'índex de l'últim element.

usuari

Fa referència a l'usuari del portal actual, que permet accedir a tots els atributs del registre del contacte del Power Apps subjacents. Si cap usuari no ha iniciat sessió, aquesta variable serà null.

l'usuari és un objecte entitat.

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

Nota

Els portals del Power Apps amb la versió 9.3.8.x o posterior disposaran per defecte del filtre d'escapada de Liquid aplicat per a objectes de Liquid usuari i sol·licitud. Per inhabilitar aquesta configuració per defecte i permetre que aquests objectes del Liquid sense filtre d'escapada del Liquid, vegeu la configuració del lloc del portal - Site/EnableDefaultHtmlEncoding.

Atributs

A més de tenir tots els atributs d'un objecte entitat, l'usuari té els atributs següents.

Atribut	Descripció
funcions	Retorna les funcions a què pertany l'usuari, com una matriu. {% if user.roles contains 'Administrators' %} User is an administrator. {% endif %} Nota: també podeu utilitzar el filtre has_role per a membres d'una funció individual.
basic_badges_url	Retorna l'adreça url del servei per recuperar els distintius d'un usuari. Per representar distintius d'un usuari, heu d'incloure una etiqueta amb els atributs "data-badge" i "data-uri". Per representar els distintius de l'usuari actual: <div data-badge data-uri='{{user.basic_badges_url }}'></div> Per representar els distintius d'un usuari per id (variable userid): `<div data-badge data-uri='{{user.basic_badges_url

enllaços web

Permet carregar qualsevol enllaç web pel nom o l'identificador.

Si el conjunt d'enllaços web existeix, es retornarà un objecte de conjunt d'enllaços web. Si no es troba el conjunt d'enllaços web amb el nom o l'identificador determinat, es retornarà 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

Representació d'una capçalera del lloc web i d'una barra de navegació principal |

Atributs de conjunt d'enllaços web

Nota

Un conjunt d'enllaços web és un objecte d'entitat, amb tots els mateixos atributs, a més dels que figuren a continuació.

Atribut	Descripció
Còpia	La còpia HTML del conjunt d'enllaços web.
Nom	El nom del conjunt d'enllaços web.
Càrrec	El títol del conjunt d'enllaços web.
Enllaços web	La matriu d'objectes d'enllaços web associada amb el conjunt d'enllaços web.
[nom lògic de l'atribut]	Podeu accedir a qualsevol atribut del registre del Power Apps del conjunt d'enllaços web mitjançant el nom lògic. Per exemple, {{ weblinkset.createdon }}

Atributs d'enllaços web

Nota

Un enllaç web és un objecte d'entitat, amb tots els mateixos atributs, a més dels que figuren a continuació.

Atribut	Descripció
Descripció	La descripció HTML de l'enllaç web.
display_image_only	L'atribut booleà que indica si l'enllaç web nomé s'ha de mostrar com una imatge, sense text d'enllaç.
display_page_child_links	L'atribut booleà que indica si l'enllaç web ha de mostrar enllaços a les pàgines secundàries del mapa del lloc de la pàgina enllaçada, com a subenllaços.
Imatge	L'objecte de la imatge de l'enllaç web d'aquest enllaç. Aquest atribut serà nul si no hi ha cap imatge.
is_external	L'atribut booleà que indica si l'adreça URL de destinació de l'enllaç web és d'un lloc extern (enlloc d'una pàgina del portal interna).
is_sitemap_ancestor	Retorna true si l'adreça URL de l'enllaç web fa referència a un antecessor del node del mapa del lloc actual, si no retorna false.
is_sitemap_current	Retorna true si l'adreça URL de l'enllaç web fa referència al node del mapa del lloc actual, si no retorna false.
Nom	El nom o el títol de l'enllaç web.
Nofollow	L'atribut booleà que indica si l'enllaç web s'ha de marcar com a rel=nofollow.
open_in_new_window	L'atribut booleà que indica si l'enllaç web s'ha d'obrir en una nova finestra o pestanya del navegador web quan seleccioneu.
Indicador de funció	Text de l'indicador de funció de l'enllaç web.
Adreça url	L'adreça URL de l'enllaç web.
Enllaços web	La matriu d'objectes d'enllaços web secundaris associada amb el conjunt d'enllaços web.
[nom lògic de l'atribut]	Podeu accedir a qualsevol atribut del registre del Power Apps de l'enllaç web mitjançant el nom lògic. Per exemple, {{ weblink.createdon }}

Atributs de la imatge de l'enllaç web

alternate_text	Text alternatiu per a la imatge.
Alçada	Enter que contenen l'alçada especificada de la imatge. Si no s'ha especificat cap valor d'alçada, aquest atribut serà nul.
Adreça url	L'adreça URL de la imatge.
Amplada	Enter que conté l'amplada especificada de la imatge. Si no s'ha especificat cap valor d'amplada, aquest atribut serà nul.

lloc web

Fa referència al lloc web del portal, la qual cosa permet l'accés a tots els atributs del registre del lloc web del Power Apps (adx_website) del portal.

Nota

Lloc web és un objecte d'entitat, amb tots els mateixos atributs.

Codi

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

Sortida

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

Atributs

A la taula següent s'enumeren els atributs d'aquesta etiqueta que es poden utilitzar reemplaçant els valors per defecte per evitar la memòria cau.

Valor per defecte	Substitució (evita la memòria cau)	Exemple
sign_in_url	sign_in_url_substitution	Per defecte: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F Substitució (evita la memòria cau): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("substitute-page" en aquest exemple reemplaça l'URL de la memòria cau per defecte.)
sign_out_url	sign_out_url_substitution	Per defecte: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F Substitució (evita la memòria cau): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F ("substitute-page" en aquest exemple reemplaça l'URL de la memòria cau per defecte.)

Consulteu també

Tipus de Liquid
Etiquetes de Liquid
Filtres de Liquid

Nota

Ens podeu dir quines són les vostres preferències d'idioma per a la documentació? Responeu una breu enquesta. (tingueu en compte que l'idioma de l'enquesta és l'anglès)

Trigareu uns set minuts a completar l'enquesta. No es recopilen dades personals (declaració de privadesa).