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>
–
<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>
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:
{{ 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
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.
Atributs
Nota
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
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
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
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
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:
{{ 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
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
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
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 %}
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 %}
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 %}
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).