Objectes de Liquid disponibles

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

{{ 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 Microsoft Dataverse 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ó web del portal emmagatzema a la memòria cau aquest valor i no s'actualitza cada vegada. Més informació: Filtres de data
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 Dataverse subjacent. Més informació: pàgina
paràmetres	Una drecera convenient per a request.params. Més informació: sol·licitud
sol·licitud	Conté informació sobre la sol·licitud HTTP actual. Més informació: sol·licitud
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 Dataverse subjacents. Si no hi ha cap usuari connectat, aquesta variable és nul· la. 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 Dataverse (adx_website) del portal. Més informació: lloc web

anuncis

Permet la recuperació i la visualització d'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

Un emplaçament d'anunci és un objecte de taula amb els mateixos atributs generals i els atributs següents:

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

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'URL al qual es dirigeix l'usuari seleccionant 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.
amplada	Retorna l'amplada en píxels de la imatge

blocs

Permet la recuperació i visualització de 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 publicacions del bloc)
• 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

Permet pujar qualsevol taula del Dataverse per l'identificador. Si la taula existeix, es retorna un objecte de taula. Si no es troba una taula amb l'ID donat, es retorna 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 proporciona accés als atributs d'un Dataverse registre de taula.

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 Dataverse.
Notes	Carrega les notes (anotacions) associades a la taula, ordenades de la més antiga a la 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 de Power Pages de la taula. Si la taula té cap adreça URL vàlida al lloc web actual, retornarà nul. En general, només retorna un valor per a determinats tipus de taula que s'han integrat al CMS del portal, tret que hàgiu personalitzat el proveïdor d'URL a l'aplicació.
[nom d'atribut o relació]	Podeu accedir a qualsevol atribut de la taula del Dataverse 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 el cas que una relació sigui reflexiva (és a dir, autoreferencial), es retorna un objecte de relació reflexiva. (En cas contrari, el resultat seria ambigu).{{ page.adx_webpage_webpage.referencing.adx_name }} Nota: Carregar un gran nombre d'entitats relacionades o accedir a un gran nombre de relacions en una sola plantilla pot tenir un impacte negatiu en el rendiment de la 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 Dataverse 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 tots els atributs d'un objecte de taula, una nota té els següents atributs addicionals.

Atribut	Descripció
documentbody	Carrega l'atribut documentbody del registre annotation de nota, com una cadena codificada en base 64. Com que el contingut d'aquest atribut pot ser gran, no es carrega amb la resta d'atributs de nota, només es carrega sota demanda. Nota: L'ús de l'atribut documentbody podria tenir un efecte negatiu en el rendiment de la representació de la plantilla i s'ha de fer 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 té un fitxer adjunt, una sol·licitud a aquest URL descarrega el fitxer adjunt de la 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 en absència de 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 de Dataverse. Proporciona accés a tots els atributs d'una llista determinada.

Atributs

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 Dataverse 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 al compte que s'utilitza per filtrar els registres de resultats pel 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 de l'atribut per a la cerca de contacte que s'utilitza per filtrar els registres de resultats pel contacte de l'usuari del portal actual. Per exemple, contactid
filter_website_attribute_name	Retorna el nom lògic de l'atribut per a la cerca a adx_website que s'utilitza per filtrar els registres de resultats pel lloc web del portal actual. Per exemple, adx_websiteid
codi_llengua	Retorna el codi de llengua enter de Dataverse 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 de Dataverse (adx_entitylist) mitjançant el nom lògic, de la mateixa manera que un objecte de 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 Dataverse per als registres inclosos a la visualització. Per exemple, contacte
Id.	Retorna l'identificador de GUID de la visualització.
codi_llengua	Retorna el codi d'idioma Dataverse enter que s'utilitza per seleccionar totes les etiquetes localitzades (capçaleres de columna, etc.) per a la visualització.
Nom	Retorna el nom de visualització del Dataverse de la visualització.
primary_key_logical_name	Retorna el nom lògic de clau principal de taula del Dataverse 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 Dataverse de la columna, com una cadena. Per exemple, Lookup, Picklist, String, Boolean, DateTime
logical_name	Retorna el nom lògic d'atribut del Dataverse de la columna. Per exemple, createdon
Nom	Retorna el nom de visualització del Dataverse 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 Dataverse 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ó. Això és 1 tret que no s'hagin retornat resultats, en aquest cas és nul.
Id.	L'identificador de GUID de la visualització del Dataverse que defineix aquesta entityview.
codi_llengua	El codi enter de llengua del Dataverse 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, aquest valor és nul.
nom	El nom de la visualització del Dataverse 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 següent de resultats, aquest valor és 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 anterior de resultats, això és nul.
primary_key_logical_name	El nom lògic del Dataverse 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

Permet la recuperació i visualització d'esdeveniments. 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["Event Name"] %} {% 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 un interval de dates per recuperar-les, i també aconseguir la paginació mitjançant filtres líquids:

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

També és possible la següent opció:

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

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. Els atributs associats són els següents:

Atribut	Descripció
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.

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

Permet la recuperació i visualització de fòrums i fils de fòrum. 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

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

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

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 Dataverse 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 líquids.

{% 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 líquids.

{% 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 atributs següents:

Atribut	Descripció
article_public_number	El número públic de l'article.
comment_count	El valor enter del recompte de quants comentaris hi ha per a 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 vist 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 atributs següents:

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.

Registre

Els creadors tenen la capacitat d'incorporar declaracions de registre dins del seu codi Liquid. Quan el lloc del Power Pages s'està executant, els registres afegits per un creador al codi del Liquid es mostren a l'extensió Power Pages de l'einade desenvolupador. Aquests registres, incrustats pel fabricant, es mostren a l'extensió de l'eina de desenvolupament quan la configuració de diagnòstic està habilitada.

La sintaxi següent es pot utilitzar en el codi Liquid per registrar missatges personalitzats:

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

Atributs de registre

Atribut	Descripció
Registre	Nom de l'objecte líquid
message	Una cadena que representa els missatges personalitzats que s'han de registrar
nivell	Registreu el missatge com a Informació, Advertiment o Error

Exemple:

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

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

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

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

pà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 Dataverse 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

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 d'inici, el pare és nul.
títol	El títol de la pàgina.
url	L'adreça URL de la pàgina.
[nom d'atribut o relació]	Podeu accedir a qualsevol atribut del registre del Dataverse 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 el cas que una relació sigui reflexiva (és a dir, autoreferencial), es retorna un objecte entitats . (En cas contrari, el resultat seria ambigu).{{ page.adx_webpage_webpage.referencing.adx_name }} Nota: Carregar un gran nombre d'entitats relacionades o accedir a un gran nombre de relacions en una sola plantilla pot tenir un impacte negatiu en el rendiment de la representació de la plantilla. Eviteu carregar entitats relacionades per a cada element d'una matriu, en un bucle. Si és possible, utilitzeu les de les etiquetes de taula de Dataverse per carregar col·leccions d'entitats.

sondejos

Permet la recuperació i visualització d'una enquesta.

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

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

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 i entitats d'iteració 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 nombre de vots que es tabulen per a l'enquesta.

Atributs de l'opció de sondeig

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 nombre de vots tabulats 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>

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
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 de Dataverse 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. A causa de la forma en què funciona l'índex de cerca pel que fa al filtratge de seguretat i altres factors de disseny, aquest nombre és només una aproximació i pot no coincidir exactament amb el nombre 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 nombre real de resultats per a la pàgina actual (perquè pot ser inferior a la mida màxima de la pàgina especificada), utilitzeu 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 fragments ressaltats, com ara consultes difuses (~) i consultes comodí (*). Aquesta propietat és nul·la en aquests casos.
Id.	L'identificador de taula del Dataverse 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 Dataverse 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 és 11.
puntuació	La puntuació Lucene del resultat, com un valor de coma flotant. Els resultats es retornen ordenats per aquest valor.
títol	El títol del resultat.
url	L'adreça URL del resultat. Normalment serà, però no necessàriament, 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.

{{ 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.)
Entity	Retorna les entitats subjacents del node. Si el node no té cap taula subjacent, aquest valor és 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, parent és nul.
Càrrec	El títol del node.
url	L'adreça URL del node.

marcadors de lloc

Permeten carregar marcadors de lloc pel nom. Si el sitemarker existeix, es retorna un objecte sitemarker. Si no es troba un marcador de lloc amb el nom de pila, es retorna 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ó
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 Dataverse 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 un fragment amb el nom de pila, es retorna 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ó.

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.

User

Fa referència a l'usuari del portal actual, que permet accedir a tots els atributs del registre del contacte del Dataverse subjacents. Si no hi ha cap usuari connectat, aquesta variable és nul· la.

L'usuari és un objecte d'entitat .

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

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 has_role filtre per provar la pertinença a funcions individuals.
basic_badges_url	Retorna l'adreça url del servei per recuperar els distintius d'un usuari. Per representar insígnies per a 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 retorna un objecte del conjunt d'enllaços web. Si no es troba un conjunt d'enllaços web amb el nom o l'ID de donació, es retorna 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

Atribut	Descripció
Copia	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 Dataverse del conjunt d'enllaços web mitjançant el nom lògic. Per exemple, {{ weblinkset.createdon }}

Atributs d'enllaços web

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.
Image	L'objecte de la imatge de l'enllaç web d'aquest enllaç. Aquest atribut és 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 Dataverse 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 proporcionat cap valor d'alçada, aquest atribut és nul.
url	L'adreça URL de la imatge.
Amplària	Enter que conté l'amplada especificada de la imatge. Si no s'ha proporcionat cap valor d'amplada, aquest atribut és 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 Dataverse (adx_website) del portal.

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 líquids
Etiquetes líquides
Filtres de líquids