Objetos Liquid disponíveis

Os objetos do Liquid contêm atributos para gerar o conteúdo dinâmico para a página. Por exemplo, o objeto pageobject tem um atributo denominado title que pode ser utilizado para gerar o título da página atual.

Para aceder a um atributo de objeto por nome, utilize um ponto (.). Para compor o atributo de um objeto num modelo, encapsule-o entre {{ and }}.

{{ page.title }}

Os atributos de um objeto também podem ser acedidos utilizando um nome de cadeia e []. Este formato é útil nos casos em que o atributo obrigatório é determinado de forma dinâmica ou que o nome do atributo contém carateres, espaços, carateres especiais, etc., que seriam inválidos ao utilizar um ponto (.) dentro da sintaxe.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Os seguintes objetos podem ser utilizados e acedidos em qualquer lugar, em qualquer modelo.

Object	Description
entidades	Permite carregar qualquer tabela do Microsoft Dataverse por ID. Mais informações: entidades
agora	Um objeto de data/hora que faça referência à hora UTC atual, no momento em que o modelo é composto. Nota: a aplicação web do portal coloca em cache este valor e não é sempre atualizado. Mais informações: Filtros de data
página	Referencia a página do pedido do portal atual. O objeto page fornece acesso, por exemplo, aos trilhos da página atual, ao título ou URL da página atual e a quaisquer outros atributos ou entidades relacionadas do registo do Dataverse subjacente. Mais informações: página
parâmetros	Um atalho conveniente para request.params. Mais informações: pedido
pedido	Contém informações sobre o pedido HTTP atual. Mais informações: pedido
definições	Permite carregar qualquer Definição do Site por nome. Mais informações: definições
sitemap	Permite o acesso ao mapa do site do portal. Mais informações: mapa do site
sitemarkers	Permite carregar quaisquer Marcadores do Site por nome. Mais informações: marcadores do site
fragmentos	Permite carregar qualquer Fragmento de Conteúdo por nome. Mais informações: fragmentos
utilizador	Referencia o utilizador do portal atual, permitindo o acesso a todos os atributos do registo de contacto do Dataverse subjacente. Se nenhum utilizador tiver sessão iniciada, esta variável é null. Mais informações: utilizador
ligações Web	Permite carregar qualquer Conjunto de Ligações Web por nome ou ID. Mais informações: ligações Web
website	Refere-se ao registo de site do portal, que permite o acesso a todos os atributos do registo do site do Dataverse (adx_website) para o portal. Mais informações: site

ads

Permite a obtenção e apresentação de um anúncio.

O objeto ads permite selecionar um anúncio ou colocação de anúncio específico:

<div>

{% assign ad = ads[Ad Name] %}

<h4>{{ ad.title }}</h4>

<a href={{ ad.redirect_url }}>

<img src={{ ad.image.url }} alt={{ ad.image.alternate_text }} />

</a>

</div>

Atributos de Ads

Atributo	Description
placements	Devolve o objeto adplacements.
[nome do anúncio ou id]	Pode aceder a qualquer ad pelas respetivas propriedades Name ou Id. {% assign ad = ads[Ad Name] %} {% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Atributos de Colocações de Anúncios

Atributo	Description
[colocação do anúncio ou id]	Pode aceder a qualquer adplacement pelas respetivas propriedades Name ou Id. {% assign placement = ads.placements[Placement Name or Id] %} {% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Atributos de Colocação de Anúncios

Uma colocação de anúncio é um objeto de tabela com os mesmos atributos gerais, e os atributos seguintes:

Atributo	Description
Anúncios	Devolve a coleção de objetos ad associados à colocação. É possível utilizar Etiquetas de iteração e Filtros de matriz com esta coleção.
Name	Devolve o campo Nome da colocação do anúncio.
placement_url	O URL que pode ser utilizado para obter o posicionamento do anúncio totalmente composto por um modelo.
random_url	O URL que pode ser utilizado para obter um anúncio aleatório a partir da colocação totalmente composta por um modelo.

Atributos de Ad

Atributo	Description
ad_url	O URL que pode ser utilizado para obter o anúncio totalmente composto por um modelo.
Copiar	Devolve o campo Cópia do anúncio.
image	Devolve o objeto de imagem (se existir) do anúncio.
Name	Devolve o campo Nome do anúncio.
open_in_new_window	Devolve true se o URL especificado por redirect_url for aberto numa nova janela.
redirect_url	O URL para onde o utilizador é direcionado ao selecionar o anúncio.

Atributos da Imagem do Anúncio

Atributo	Description
alternate_text	Devolve o texto que se destina a aparecer no atributo alt da etiqueta.
height	Devolve a altura em pixéis para a imagem
URL	Devolve a origem do URL para a imagem.
largura	Devolve a largura em pixéis para a imagem

blogues

Permite a obtenção e apresentação de blogues e publicações de blogue.

O objeto blogs permite selecionar um blogue ou mensagens de blogue específicas.

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

Objeto blogs

O objeto blogs permite aceder a qualquer blogue específico no portal ou aceder a todas as publicações de blogue no portal.

A tabela seguinte explica os atributos associados ao objeto blogs.

Atributo	Descrição
posts	Devolve um objeto blogposts que contém todas as mensagens de blogue no portal.
[nome do blogue ou id]	Pode aceder a qualquer blogue pelas respetivas propriedades Name ou Id.

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

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

Objeto blog

O objeto blog permite trabalhar com um único blogue, permitindo-lhe aceder às mensagens desse blogue.

A tabela seguinte explica os vários atributos associados ao Objeto blog.

Atributo	Descrição
posts	Devolve um objeto blogposts que contém todas as mensagens do blogue.
Nome	O nome do blogue.
title	O título do blogue.
URL	O URL do blogue.

Objeto blogposts

O objeto blogposts permite aceder a uma coleção de objetos de publicação de blogue. Pode ordenar as publicações de blogue e obter a paginação, bem como utilizar filtros do Liquid:

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

Outras opções possíveis:

• blogs.posts.all (para obter todas as publicações de blogue)
• blogs.posts | from\_index: 0 | take: 2

A tabela seguinte explica os vários atributos associados ao Objeto blogposts.

Atributo	Descrição
Tudo	Devolve todos os objetos blogpost na coleção.

Objeto blogpost

Referencia uma única publicação de blogue.

A tabela seguinte explica os vários atributos associados ao Objeto blogpost.

Atributo	Descrição
URL	O URL da publicação.
conteúdo	Devolve o campo Conteúdo da publicação.
autor	Devolve os autores da publicação (que é simplesmente objeto de tabela do contacto).
cargo	O Título da publicação.
comment_count	Devolve o valor inteiro da contagem do número de comentários existente para determinada publicação.
publish_date	A data em que a publicação foi publicada.

entidades

Permite carregar qualquer tabela do Dataverse por ID. Se a tabela existir, é devolvido um objeto de tabela. Se uma tabela com o ID fornecido não for encontrada, é devolvido 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

Um objeto de entidade fornece acesso aos atributos de um registo de tabela do Dataverse.

Atributo	Descrição
ID	O ID do GUID da tabela, como uma cadeia. Por exemplo, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	O nome lógico do Dataverse da tabela.
Notas	Carrega quaisquer notas (anotação) associadas à tabela, ordenadas da mais antiga à mais recente (createdon). As notas são devolvidas como objetos de nota.
permissões	Carrega os resultados da declaração da Permissão da Tabela para a tabela. Os resultados são devolvidos como um objeto de permissões.
url	Devolve o caminho do URL do sistema de gestão de conteúdos do Power Pages para a tabela. Se a tabela não tiver um URL válido no Web site atual, devolve null. Normalmente, só devolve um valor para determinados tipos de tabela que foram integradas no CMS do portal, a menos que tenha personalizado o Fornecedor de URL na sua aplicação.
[nome do atributo ou relação]	Pode aceder a qualquer atributo da tabela do Dataverse por nome lógico. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }} Os valores de maioria dos atributos de tabela são mapeados diretamente para tipos do Liquid: os campos Duas Opções são mapeados para campos Booleanos, os campos de texto para cadeias de carateres, os campos numéricos/moeda para números, os campos de data/hora para objetos de data. No entanto, alguns tipos de atributo são devolvidos como objetos: Os campos de Pesquisa (Referência da Tabela Associada) são devolvidos como objetos de referência de tabela associados. os campos Conjunto de Opções/Lista de Opções são devolvidos como objetos de valor do conjunto de opções. Também pode carregar quaisquer entidades relacionadas por nome do esquema de relações. {{ page.adx_webpage_entitylist.adx_name }}No caso de uma relação ser reflexiva (ou seja, fizer auto-referenciação), é devolvido um objeto de relação reflexiva. (Caso contrário, o resultado seria ambíguo.){{ page.adx_webpage_webpage.referencing.adx_name }} Nota: o carregamento de um grande número de entidades relacionadas ou o acesso a um grande número de relações num único modelo pode ter um impacto negativo no desempenho de composição do modelo. Evite carregar entidades relacionadas para cada item numa matriz, dentro de um ciclo. Sempre que possível, utilize etiquetas de tabela do Dataverse para carregar coleções de entidades.

Referência da Tabela Associada

Os valores dos atributos de pesquisa são devolvidos como objetos de referência de tabela associada, com os seguintes atributos.

Atributo	Descrição
ID	O ID do GUID da tabela referenciada, como uma cadeia. Por exemplo, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	O nome lógico do Dataverse da tabela referenciada.
Name	O atributo do nome primário da tabela referenciada.

Nota

Uma nota é um objeto de tabela que fornece acesso aos atributos e às relações de um registo de anotação. Além de todos os atributos de um objeto de tabela, uma nota tem os seguintes atributos extra.

Atributo	Description
documentbody	Carrega o atributo documentbody do registo de annotation da nota, como uma cadeia codificada em Base64. Como o conteúdo deste atributo poderá ser de grandes dimensões, não é carregado com os restantes atributos da nota e só é carregado a pedido. Nota: a utilização do atributo documentbody pode ter um efeito negativo no desempenho de composição do modelo e deve ser feito com precaução. Opte por utilizar o atributo url para fornecer uma hiperligação para o anexo da nota, se possível.
URL	Devolve o caminho do URL para o processador de anexos de anotação do portal incorporado. Se o utilizador tiver permissão e a nota tiver um ficheiro anexado, um pedido para este URL descarrega o anexo de ficheiro da nota.

Valor do Conjunto de Opções

Os valores do atributo Conjunto de Opções/Lista de Opções são devolvidos como objetos de referência de tabela associada, com os seguintes atributos.

Atributo	Descrição
Etiqueta	A etiqueta localizada do valor do atributo conjunto de opções/lista de opção. Por exemplo, Ativo
Valor	O valor inteiro do valor do atributo conjunto de opções/lista de opções. Por exemplo, 0

Permissões de Tabela

O objeto Permissões de Tabela fornece acesso aos resultados da declaração de permissão agregados para uma tabela.

Atributo	Description
can_append	Devolve true se o utilizador atual tiver permissão para acrescentar registos às relações deste registo. Caso contrário, devolve false.
can_append_to	Devolve true se o utilizador atual tiver permissão para acrescentar este registo a uma relação de outra tabela. Caso contrário, devolve false.
can_create	Devolve true se o utilizador atual tiver permissão para criar novos registos deste tipo de tabela. Caso contrário, devolve false.
can_delete	Devolve true se o utilizador atual tiver permissão para eliminar este registo. Caso contrário, devolve false.
can_read	Devolve true se o utilizador atual tiver permissão para ler este registo. Caso contrário, devolve false.
can_write	Devolve true se o utilizador atual tiver permissão para atualizar este registo. Caso contrário, devolve false.
rules_exist	Devolve true se os resultados da permissão representados por este objeto forem o resultado de regras de permissão definidas explicitamente. Devolve falso se forem os resultados predefinidos na ausência de permissões definidas explicitamente.

Relação Reflexiva

As tentativas para carregar relações reflexivas (ou seja, de auto-referenciação) em entidades são devolvidas como objetos com os seguintes atributos.

Atributo	Description
is_reflexive	Devolve true. Pode ser utilizado para testar se um objeto devolvido por uma relação é um objeto de relação reflexiva.
referenced	Devolve uma matriz de entidades referenciadas para a relação fornecida.
referencing	Devolve uma tabela de referenciação para a relação fornecida. Devolve null se não existirem tabelas de referenciação. Se a relação for muitos para muitos (N:N), devolve uma matriz das entidades de referenciação.

entitylist

O objeto entitylist é utilizado nas etiquetas de tabela do Dataverse. Fornece acesso a todos os atributos de uma determinada lista.

Atributos

Atributo	Description
create_enabled	Devolve true se a criação de novos registos estiver configurada para a lista. Caso contrário, devolve false.
create_url	Devolve o caminho de URL configurado para uma ligação/botão de criação para a lista.
detail_enabled	Devolve true se estiver configurada uma vista de detalhes para registos individuais para a lista. Caso contrário, devolve false.
detail_id_parameter	Devolve o nome do parâmetro da cadeia de consulta a utilizar o ID de registo ao criar um URL da vista de detalhes do registo. Consulte filtros de URL para obter detalhes sobre como utilizar filtros do Liquid para criar URLs. Por exemplo, id
detail_label	Devolve a etiqueta localizada configurada para as ligações/botões da vista detalhada para a lista.
detail_url	Devolve o caminho de URL para as ligações/botões da vista detalhada para a lista.
empty_list_text	Devolve o texto localizado configurado a apresentado quando a vista de lista não devolver resultados.
enable_entity_permissions	Devolve true se a filtragem da Permissão de Tabela estiver ativada para esta lista. Caso contrário, devolve false.
entity_logical_name	Devolve o nome lógico da tabela do Dataverse para os registos serem apresentados por esta lista. Por exemplo: contacto
filter_account_attribute_name	Devolve o nome lógico do atributo para a consulta para a conta que é utilizada para filtrar os registos de resultados pela conta principal do utilizador do portal atual. Por exemplo, accountid
filter_apply_label	Devolve a etiqueta localizada configurada a utilizar para a ligação/botão que aplica um filtro de atributo avançado para os resultados da lista.
filter_definition	Devolve a definição de filtro do atributo JSON para a lista. Consulte Filtros de Lista para obter detalhes sobre como utilizar o filtro metafilters do Liquid para processar esta definição.
filter_enabled	Devolve true se a filtragem de atributos avançada estiver ativada para a lista. Caso contrário, devolve false.
filter_portal_user_attribute_name	Devolve o nome lógico do atributo para a consulta para o contacto que é utilizado para filtrar os registos de resultados pelo contacto do utilizador do portal atual. Por exemplo, contactid
filter_website_attribute_name	Devolve o nome lógico do atributo para a consulta para o adx_website que é utilizado para filtrar os registos de resultados pelo Web site do portal atual. Por exemplo, adx_websiteid
language_code	Devolve o código de idioma de número inteiro do Dataverse que será utilizado para selecionar todas as etiquetas localizadas para esta lista.
page_size	Devolve o tamanho da página de resultados configurada para a lista.
primary_key_name	Devolve o nome lógico do atributo de chave primária para os registos serem apresentados por esta lista.
search_enabled	Devolve true se a pesquisa estiver ativada para esta lista. Caso contrário, devolve false.
search_placeholder	Devolve o texto localizado configurado para o marcador de posição do campo de pesquisa da lista.
search_tooltip	Devolve o texto localizado configurado para a descrição da pesquisa da lista.
vistas	Devolve as listas disponíveis para a lista, sob a forma de objetos de vista da lista.
[nome lógico do atributo]	Pode aceder a qualquer atributo do registo do Dataverse da lista (adx_entitylist) por nome lógico, tal como um objeto tabela. Por exemplo, {{ entitylist.adx_name }}

Atributos da Vista de Lista

Atributo	Description
colunas	Devolve as colunas da vista, sob a forma de objetos de coluna da vista de lista.
entity_logical_name	Devolve o nome lógico da tabela do Dataverse para os registos incluídos na vista. Por exemplo: contacto
Id	Devolve o ID do GUID da vista.
language_code	Devolve o código de idioma de número inteiro do Dataverse que é utilizado para selecionar todas as etiquetas localizadas (cabeçalhos de coluna, etc.) da vista.
Name	Devolve o nome a apresentar do Dataverse da vista.
primary_key_logical_name	Devolve o nome lógico da chave primária da tabela do Dataverse para os registos incluídos na vista. Por exemplo, contactid
sort_expression	Devolve a expressão de ordenação predefinida para a vista. Por exemplo, name ASC, createdon DESC

Atributos da Coluna da Vista de Lista

Atributo	Description
attribute_type	Devolve o nome do tipo de atributo do Dataverse para a coluna, sob a forma de cadeia. Por exemplo, Lookup, Picklist, String, Boolean, DateTime
logical_name	Devolve o nome lógico do atributo do Dataverse para a coluna. Por exemplo, createdon
Nome	Devolve o nome a apresentar do Dataverse para a coluna. Por exemplo, Created On
sort_ascending	Devolve uma cadeia de expressão de ordenação para ordenar a coluna por ordem ascendente. Por exemplo, createdon ASC
sort_descending	Devolve uma cadeia de expressão de ordenação para ordenar a coluna por ordem decrescente. Por exemplo, createdon DESC
sort_disabled	Devolve true se a ordenação estiver desativada para a coluna. Caso contrário, devolve false.
sort_enabled	Devolve true se a ordenação estiver ativada para a coluna. Caso contrário, devolve false.
width	Devolve a largura configurada para a coluna, em pixéis.

entityview

O objeto entityview é utilizado na tag entityview e fornece acesso aos metadados para a vista, bem como os registos de resultados da vista.

Atributos

Atributo	Descrição
colunas	Devolve as colunas da vista, sob a forma de objetos de coluna da vista de tabela.
entity_permission_denied	Devolve true se o acesso para ver os resultados foi negado devido a Permissões de Tabela insuficientes para o utilizador atual. Devolve false se foi concedido o acesso de leitura para ver os resultados.
entity_logical_name	O nome lógico da tabela do Dataverse dos registos de resultados da vista. Por exemplo: contacto
first_page	O número de página da primeira página dos resultados da vista. É 1, a menos que não tenham sido devolvidos resultados; neste caso, será null.
Id	O ID do GUID da vista do Dataverse que define esta entityview.
language_code	O código de idioma de número inteiro do Dataverse que está a ser utilizado para carregar etiquetas localizadas para a vista atual.
last_page	O número de página da última página dos resultados da vista. Se não foram devolvidos resultados, o valor é null.
name	O nome da vista do Dataverse que define este entityview., por exemplo, Contactos Ativos.
next_page	O número de página da página seguinte dos resultados da vista. Se não existir uma página seguinte de resultados, o valor é null.
Página	O número de página da página atual dos resultados da vista.
pages	Devolve uma matriz de números de página que contem todas as páginas de resultados para a vista atual.
page_size	O número de resultados devolvidos por página para a vista atual.
previous_page	O número de página da página seguinte dos resultados da vista. Se não existir uma página anterior de resultados, o valor é null.
primary_key_logical_name	O nome lógico do Dataverse do atributo de chave primária da tabela de resultados para esta vista. Por exemplo: contactid.
registos	A página atual dos registos de resultados da vista, como objetos de tabela.
sort_expression	A expressão de ordenação predefinida para a vista. Por exemplo, nameASC, createdon DESC.
total de páginas	O número total de páginas de resultados para a vista.
total_records	O número total de resultados para a vista (em todas as páginas).

eventos

Permite a obtenção e apresentação de eventos. O objeto events permite selecionar um evento específico ou todos os eventos.

Objeto events

O objeto events permite aceder qualquer evento específico no portal ou a todos os eventos no portal (independentemente do evento).

O objeto events tem os seguintes atributos:

Atributo	Description
ocorrências	Devolve um eventoccurancessobject que contém todas as ocorrências do evento no portal
[nome do evento ou id]	Pode aceder a qualquer evento pelas respetivas propriedades Name ou Id. {% assign event = events["Event Name"] %} {% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Objeto event

O objeto event permite trabalhar com um único evento, para aceder às agendas e ocorrências desse evento.

O objeto event tem os seguintes atributos:

Atributo	Descrição
ocorrências	Devolve um eventoccurrencesobject que contém todas as ocorrências do evento.
nome	O nome do evento.
URL	O URL do evento.

Objeto eventoccurences

O objeto eventoccurrences permite aceder a uma coleção de objetos de ocorrências do evento. Pode ordenar as ocorrências do evento e especificar um intervalo de datas para obter ocorrências, além de obter paginações utilizando filtros do Liquid:

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

A seguinte opção também é possível:

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

Os seguintes atributos estão associados ao objeto eventoccurrences

Atributo	Descrição
Tudo	Devolve todos os objetos eventoccurance na coleção.

Objeto eventoccurence

Representa uma ocorrência de evento único. Os seguintes são os atributos associados:

Atributo	Description
url	O URL da ocorrência.
is_all_day_event	Trata-se de um evento de dia inteiro?
hora de início	A data de início do evento.
end_time	A data de fim do evento.

forloop

Contém as propriedades úteis num bloco de ciclos for.

Código

{% for child in page.children %}

{% if forloop.first %}

This is the first child page!

{% else %}

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

{% endif %}

{% endfor %}

Saída

This is the first child page!

This is child page number 2.

This is child page number 3.

Atributos

Atributo	Descrição
Primeiro	Devolve true se for a primeira iteração do ciclo. Devolve false se não for a primeira iteração.
index	A posição do item atual na coleção, onde o primeiro item tem a posição 1.
index0	A posição do item atual na coleção, onde o primeiro item tem a posição 0.
Última	Devolve true se for a última iteração do ciclo. Devolve false se não for a última iteração.
length	Devolve o número de iterações para o ciclo ߝ o número de itens na coleção que está a iterado.
rindex	Número de itens restante que permanece no ciclo (duração - índice) onde 1 é o índice do último item.
rindex0	Número de itens restante que permanece no ciclo (duração - índice) onde 0 é o índice do último item.

forums

Permite a obtenção e apresentação de Fóruns e Tópicos do Fórum. A capacidade para utilizar código da linguagem Liquid para compor dados do fórum alarga-se às publicações, mas para criar uma nova publicação do tópico tem de utilizar um Modelo de Página dos formulários de vários passos ASP.NET com a funcionalidade referida incorporada (como os Modelos de Página de Publicação do Fórum e Tópico do Fórum predefinidos).

O objeto forums permite selecionar um Fórum ou Tópicos do Fórum:

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

Objeto forums

O objeto forums permite aceder qualquer fórum específico no portal ou a todos os tópicos do fórum no portal (independentemente do fórum).

O objeto forum permite trabalhar com um único fórum, para aceder aos tópicos desse fórum.

O objeto forumthreads permite aceder a uma coleção de objetos forumthread. Pode ordenar os tópicos do fórum e efetuar a paginação, bem como utilizar filtros do Liquid.

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

Um Único Tópico do Fórum

O objeto forumposts permite aceder a uma coleção de objetos de publicação do fórum.

Atributos

Atributo	Descrição
threads	Devolve um objeto forumthreads que contém todos os objetos forumthread no portal.
Tudo	Devolve todos os objetos forum no portal. Note que website.forums também é um equivalente.
thread_count	Devolve o valor de número inteiro da contagem do número de tópicos existente no Web site completo.
post_count	Devolve o valor inteiro do número total de mensagens no portal.
[nome do fórum ou id]	Pode aceder a qualquer fórum pelas respetivas propriedades Name ou Id. `{% assign forum = forums[Forum Name] %} {% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Objeto forum

Atributos

Atributo	Description
threads	Devolve um objeto forumthreads que contém todos os tópicos do fórum para o fórum.
Name	O Nome do Fórum.
thread_count	Devolve o valor de número inteiro da contagem do número de tópicos existente no fórum.
post_count	Devolve o valor de número inteiro da contagem do número total de publicações em todo do fórum.

Objeto forumthreads

Atributos

Atributo	Descrição
Tudo	Devolve todos os objetos forumthread na coleção.

Objeto forumthread

Atributos

Atributo	Description
posts	Devolve um objeto forumposts que contém todas as mensagens do fórum para o tópico.
author	Devolve o autor do tópico (um simples objeto de tabela de contactos).
latest_post	Devolve a publicação mais recente no tópico.
first_post	Devolve a primeira publicação no tópico.
post_count	Devolve o valor de número inteiro da contagem do número de mensagens existente no tópico.
is_answered	O tópico obteve respostas ou não?
is_sticky	Trata-se de um tópico afixado?

Objeto forumposts

Atributos

Atributo	Descrição
Tudo	Devolve todos os objetos forumthread na coleção.

Uma Única Publicação do Fórum

Atributos

Atributo	Description
autor	Devolve o autor da publicação (que é simplesmente objeto de tabela do contacto).
conteúdo	O conteúdo da publicação.
is_answer	Esta mensagem é uma resposta ao tópico?

knowledge

Fornece acesso aos registos de tabela knowledgearticle e category do Dataverse para compor artigos e categorias num portal.

Atributos

Atributo	Descrição
artigos	Devolve um objeto articles que contém objetos article para os registos da tabela knowledgearticle disponíveis no portal.
categorias	Devolve um objeto categories que contém objetos category para os registos da tabela de categoria disponíveis no portal.

objeto articles

O objeto articles permite aceder a uma coleção de objetos article. Pode ordenar os artigos e efetuar a paginação, bem como utilizar filtros do Liquid.

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

Atributos

Atributo	Descrição
popular	Devolve uma coleção de objetos article que contêm mais visualizações. {% assign popular_articles = knowledge.articles.popular %}
recent	Devolve uma coleção de objetos article que contêm a data de modificação mais recente. {% assign recent_articles = knowledge.articles.recent %}
principal	Devolve uma coleção de objetos article que contêm a classificação mais elevada. {% assign top_articles = knowledge.articles.top %}

Filtros

Os filtros seguintes podem aceitar parâmetros opcionais para tamanho da página e idioma. O primeiro parâmetro é o número de registos a obter. O tamanho de página predefinido é 5. O segundo parâmetro é o código de um idioma para obter artigos para um idioma específico. Os filtros podem ser combinados com outros Filtros do Liquid.

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

Atributo	Description
popular	Devolve uma coleção de objetos article que contêm mais visualizações. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
recent	Devolve uma coleção de objetos article que contêm a data de modificação mais recente. {% assign recent_articles = knowledge.articles \| recent: 5 %}
principal	Devolve uma coleção de objetos article que contêm a classificação mais elevada. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

Objeto categories

O objeto categories permite aceder a uma coleção de objetos de category. Pode ordenar as categorias e obter a paginação, bem como utilizar filtros do Liquid.

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

Atributos

Atributo	Descrição
recent	Devolve uma coleção de objetos category que contêm a data de modificação mais recente.
top_level	Devolve uma coleção de objetos category que não têm uma categoria principal.

Filtros

Os filtros seguintes podem aceitar um parâmetro opcional que indica o tamanho da página. O tamanho de página predefinido é 5. Os filtros podem ser combinados com outros Filtros do Liquid.

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

Atributo	Description
recent	Devolve uma coleção de objetos category que contêm a data de modificação mais recente. Pode fornecer parâmetros {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level	Devolve uma coleção de objetos category que não têm uma categoria principal. {% assign root_categories = knowledge.categories \| top_level %}

Objeto article

O objecto article permite-lhe trabalhar com um único knowledgearticle para apresentar os detalhes desse artigo no portal.

Atributos

Artigo é um objeto de entidade, com todos os mesmos atributos, além dos seguintes:

Atributo	Description
article_public_number	O Número Público do Artigo.
comment_count	O valor inteiro da contagem do número de comentários que existe para um artigo específico.
conteúdo	O conteúdo do artigo.
current_user_can_comment	Devolve um valor Booleano que indica se o utilizador atual pode adicionar comentários sobre o artigo.
is_rating_enabled	Devolve um valor booleano que indica se a classificação sobre um artigo está ativada.
keywords	As palavras-chave no artigo.
nome	Um alias alternativo para o título do artigo.
rating	O valor decimal da classificação no artigo.
title	O título do artigo.
view_count	Um número inteiro que representa o número de vezes que o artigo foi visualizado.

Objeto category

O objecto category permite-lhe trabalhar com uma única categoria para apresentar os respetivos detalhes no portal.

Atributos

categoria é um objeto de entidade, com todos os mesmos atributos, além dos seguintes:

Atributo	Description
categorynumber	O Número da Categoria.
nome	Um alias alternativo para o título da categoria.
título	O título da categoria.

idioma

Fornece o nome atual do idioma e código do idioma se o multiple-language support estiver ativado.

Atributos

Atributo	Descrição
URL	O URL de pedido atual pré-fixado com o código do idioma atual.
url_substitution	O URL de pedido atual pré-fixado com o código de idioma atual contornando a cache de saída da página.
nome	Título do idioma atual.
código	O código de idioma do idioma.

Por exemplo, o modelo Web Lista Pendente de Idiomas utiliza, por predefinição, este objeto Liquid para listar os idiomas disponíveis quando vários idiomas estão disponíveis.

registo

Os criadores têm a capacidade de incorporar instruções de registo no seu código Liquid. Quando o site do Power Pages está em execução, os registos adicionados por um criador em código Liquid são mostrados na extensão da ferramenta de programação do Power Pages. Estes registos, incorporados pelo criador, são apresentados na extensão da ferramenta de programação quando a definição de diagnóstico está ativada.

A sintaxe seguinte pode ser usada em código Liquid para registar mensagens personalizadas:

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

Registar atributos

Atributo	Description
registo	Nome do objeto Liquid
mensagem	Uma cadeia que representa quaisquer mensagens personalizadas a registar
nível	Registar a mensagem como Informação, Aviso ou Erro

Exemplo:

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

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

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

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

página

Referencia a página do pedido do portal atual. Este objeto combina os atributos do sitemap e o pedido atual entidades (normalmente uma página Web).

O objeto page fornece acesso, por exemplo, aos trilhos da página atual, ao título ou URL da página atual e a quaisquer outros atributos ou entidades relacionadas do registo do Dataverse subjacente.

<ul class=breadcrumb>

{% for crumb in page.breadcrumbs %}

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

{% endfor %}

<li class=active>{{ page.title | escape }}</li>

</ul>

<div class=page-header>

<h1>{{ page.title | escape }}</h1>

</div>

<div class=page-copy>

{{ page.adx_copy }}

</div>

<div class=list-group>

{% for child in page.children %}

<a class=list-group-item href={{ child.url | escape }}>

{{ child.title | escape }}

</a>

{% endfor %}

</div>

<!-- Page {{ page.id }} was last modified on {{ page.modifiedon }}. -->

Atributos da página

Atributo	Description
breadcrumbs	Devolve os objetos de nó do mapa do site de trilho da página, que começa no nó de raiz do mapa do site e termina no principal.
children	Devolve os objetos de nó do mapa do site subordinado da página.
parent	Devolve o nó do mapa do site principal da página. Se a página for a Home Page, o elemento principal é null.
cargo	O título da página.
url	O URL da página.
[nome do atributo ou relação]	Pode aceder a qualquer atributo do registo do Dataverse subjacente da página por nome lógico. {{ page.createdon }} {% assign attribute_name = 'name' %} {{ page[attribute_name] }} Os valores de maioria dos atributos de tabela são mapeados diretamente para tipos do Liquid: os campos Duas Opções são mapeados para campos Booleanos, os campos de texto para cadeias de carateres, os campos numéricos/moeda para números, os campos de data/hora para objetos de data. No entanto, alguns tipos de atributo são devolvidos como objetos: Os campos de Pesquisa (Referência da Tabela Associada) são devolvidos como objetos de referência de tabela associados. Os campos Conjunto de Opções/Lista de Opções são devolvidos como objetos de valor do conjunto de opções. Também pode carregar quaisquer entidades relacionadas por nome do esquema de relações. {{ page.adx_webpage_entitylist.adx_name }} No caso de uma relação ser reflexiva (ou seja, de auto-referenciação), é devolvido um objeto entities. (Caso contrário, o resultado seria ambíguo.){{ page.adx_webpage_webpage.referencing.adx_name }} Nota: o carregamento de um grande número de entidades relacionadas ou o acesso a um grande número de relações num único modelo pode ter um impacto negativo no desempenho de composição do modelo. Evite carregar entidades relacionadas para cada item numa matriz, dentro de um ciclo. Sempre que possível, privilegie a utilização das etiquetas de tabela do Dataverse para carregar coleções de entidades.

polls

Permite a obtenção e apresentação de um inquérito.

O objeto polls permite selecionar um inquérito ou colocação de inquérito específica:

<div>

{% assign poll = polls[Poll Name] %}

<h4>{{ poll.question }}</h4>

{% for option in poll.options %}

<div>

<input type=radio name={{ poll.name }} id={{ option.id }} />

<label for={{ option.id }}>{{ option.answer }}</label>

</div>

{% endfor %}

<button type=button>{{ poll.submit_button_label }}</button>

</div>

Atributos de Inquéritos

Atributo	Description
placements	Devolve o objeto pollplacements.
[nome do inquérito ou id]	Pode aceder a qualquer inquérito através das respetivas propriedades Name ou Id. {% assign poll = polls[Poll Name] %} {% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Atributos de Colocações de Iquérito

Atributo	Description
[colocação do inquérito ou id]	Pode aceder a qualquer colocação de inquérito pelas respetivas propriedades Name ou Id.{% assign placement = polls.placements[Placement Name or Id] %} {% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Atributos de Colocação de Inquérito

Atributo	Description
Name	Devolve o campo Nome da colocação do inquérito.
placement_url	O URL que pode ser utilizado para obter o posicionamento do inquérito totalmente composto por um modelo.
polls	Devolve a coleção de objetos poll associados à colocação. É possível utilizar Etiquetas de iteração e Filtros de matriz com esta coleção.
random_url	O URL que pode ser utilizado para obter um inquérito aleatóri0 a partir da colocação totalmente composta por um modelo.
submit_url	O URL para o qual um inquérito concluído é submetido.

Atributos do Inquérito

Atributo	Description
has_user_voted	Devolve verdadeiro se o utilizador atual (com sessão anónima ou anónimo) já votou neste inquérito.
Nome	Devolve o campo Nome do inquérito.
options	Devolve a coleção dos objetos de opção de inquérito associados ao inquérito. É possível utilizar Etiquetas de iteração e entidades com esta coleção.
poll_url	O URL que pode ser utilizado para obter o inquérito totalmente composto por um modelo.
question	Devolve o campo Pergunta do inquérito.
submit_button_label	Devolve uma cadeia que pode ser utilizada para definir manualmente a etiqueta do botão submeter para o inquérito.
submit_url	O URL para o qual um inquérito concluído é submetido.
user_selected_option	Devolve o objeto polloption selecionado pelo utilizador (se já tiverem votado).
votes	Devolve o número de votos que são tabelados para o inquérito.

Atributos da Opção de Inquérito

Atributo	Description
answer	Devolve o campo Resposta do inquérito.
percentage	Devolve a percentagem de votos no inquérito para a opção como um número decimal entre 0 e 100.
votes	Devolve o número de votos que são tabelados para a opção.

pedido

Contém informações sobre o pedido HTTP atual.

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

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

Atributos

Atributo	Descrição
parâmetros	Valores de parâmetros nomeados para o pedido atual. params é uma combinação de parâmetros da cadeia de consulta do URL, parâmetros da publicação do formulário e cookies.
Path	O caminho do URL do pedido atual. /profile/
path_and_query	O caminho e a consulta do URL do pedido atual. /profile/?foo=1&bar=something
query	A parte da consulta do URL do pedido atual. ?foo=1&bar=something
url	O URL completo do pedido atual. https://www.example.com/profile/?foo=1&bar=something

searchindex

O objeto searchindex é utilizado nas etiquetas de tabela do Dataverse e fornece acesso aos resultados de uma consulta.

{% searchindex query: 'support', page: params.page, page_size: 10 %}

{% if searchindex.results.size > 0 %}

<p>Found about {{ searchindex.approximate_total_hits }} matches:</p>

<ul>

{% for result in searchindex.results %}

<li>

<h3><a href={{ result.url | escape }}>{{ result.title | escape }}</a></h3>

<p>{{ result.fragment }}</p>

</li>

{% endfor %}

</ul>

{% else %}

<p>Your query returned no results.</p>

{% endif %}

{% endsearchindex %}

Atributos

Atributo	Description
approximate_total_hits	Devolve uma contagem aproximada do total de visitas correspondente à consulta do índice. Devido à forma como o índice de pesquisa funciona relativamente à filtragem de segurança e a outros fatores de conceção, este número é apenas uma aproximação e poderá não corresponder exatamente ao número total de resultados disponíveis para o utilizador atual em algumas situações.
Página	Devolve o número de páginas da consulta atual.
page_size	Devolve o tamanho de página máximo da consulta atual. Se pretende o número real de resultados devolvidos para a página atual (porque poderá ser menor do que o tamanho de página máximo especificado), utilize results.size.
Resultados	Devolve a página de resultados da consulta, sob a forma de objetos de resultado do índice.

Resultados do Índice de Pesquisa

Atributo	Descrição
entidade	As entidades subjacentes para o resultado.
fragment	Um fragmento de texto curto relevante para o resultado, com os termos que correspondem à consulta especificada realçada utilizando a etiqueta HTML <em>. Determinados tipos de consultas não suportam fragmentos realçados, como consultas aproximadas (~) e consultas com caráter universal (*). Esta propriedade é null nesses casos.
Id	O ID da tabela do Dataverse do registo subjacente para o resultado, como uma cadeia. Por exemplo, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name	O nome lógico da tabela do Dataverse do registo subjacente para o resultado. Por exemplo, adx_webpage
Número	O número do resultados em todas as páginas de resultados, que começa em 1. Por exemplo, para o primeiro resultado da segunda página de resultados, com um tamanho de página de 10, este valor é 11.
score	A pontuação de Lucene do resultado, sob a forma de vírgula flutuante. Os resultados são devolvidos ordenados por este valor.
cargo	O título do resultado.
url	O URL para o resultado. Normalmente, mas não necessariamente, será um caminho absoluto para a aplicação atual, em vez de um URL completo. Por exemplo: /articles/article1/

definições

Permite carregar qualquer definição do site por nome. Se uma definição com o nome fornecido não for encontrada, será devolvido nulo.

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

sitemap

Permite o acesso ao mapa do site do portal.

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

<ul class=breadcrumb>

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

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

{% endfor %}

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

</ul>

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

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

{% endfor %}

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

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

{% if node %}

{% for child in node.children %}

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

{% endfor %}

{% endif %}

Atributos do Mapa do Site

Atributo	Descrição
Atuais	Devolve o objeto de nó do mapa do site para a página atual.
Raiz	Devolve o objeto de nó do mapa do site para a página raiz (home page) do Web site.

Atributos do Nó do Mapa do Site

Atributo	Descrição
Trilhos	Devolve os objetos de nó do mapa do site de trilho do nó, que começa no nó de raiz do mapa do site e termina no principal.
Subordinados	Devolve os objetos de nó do mapa do site subordinado do nó.
Descrição	O conteúdo da descrição/resumo do nó. (Este campo poderá conter HTML).
Entity	Devolve as entidades subjacentes do nó. Se o nó não tiver uma tabela subjacente, este valor é null.
is_sitemap_ancestor	Devolve true se o nó do mapa do site for predecessor de um nó atual, caso contrário, devolve false.
is_sitemap_current	Devolve true se o nó do mapa do site for o nó atual, caso contrário, devolve false.
Principal	Devolve o nó do mapa do site principal do nó. Se o nó for o nó raiz, parent é null.
Title	O título do nó.
url	O URL do nó.

sitemarkers

Permite carregar qualquer marcador do site por nome. Se o marcador do site existir, é devolvido um objeto sitemarker. Se um marcador de site com o nome fornecido não for encontrado, é devolvido 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 %}

Atributos de Sitemarker

Atributo	Description
url	O URL do destino do marcador do site.
[nome lógico do atributo]	Pode aceder a qualquer atributo do registo do Dataverse do destino do marcador do site por nome lógico. Por exemplo, {{ sitemarker.adx_name }}

fragmentos

Permite carregar quaisquer fragmentos de conteúdo por nome. Se um fragmento com o nome fornecido não for encontrado, será devolvido null.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Contém as propriedades úteis num bloco de ciclos de etiquetas de iteração.

Atributos

Atributo	Descrição
Col	Devolve o índice da linha atual, a começar em 1.
col0	Devolve o índice da linha atual, a começar em 0.
col_first	Devolve true se a coluna atual for a primeira coluna numa linha, caso contrário devolve false.
col_last	Devolve true se a coluna atual for a última coluna numa linha, caso contrário devolve false.
Primeira	Devolve true se for a primeira iteração do ciclo. Devolve false se não for a primeira iteração.
Índice	A posição do item atual na coleção, onde o primeiro item tem a posição 1.
index0	A posição do item atual na coleção, onde o primeiro item tem a posição 0.
Última	Devolve true se for a última iteração do ciclo. Devolve false se não for a última iteração.
Length	Devolve o número de iterações para o ciclo ߝ o número de itens na coleção que está a iterado.
Rindex	Número de itens restante que permanece no ciclo (duração - índice) onde 1 é o índice do último item.
rindex0	Número de itens restante que permanece no ciclo (duração - índice) onde 0 é o índice do último item.

User

Referencia o utilizador do portal atual, permitindo o acesso a todos os atributos do registo de contacto do Dataverse subjacente. Se nenhum utilizador tiver sessão iniciada, esta variável é null.

Utilizador é um objeto de entidade.

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

Atributos

Além de ter todos os atributos de um objeto entity, utilizador tem os seguintes atributos.

Atributo	Descrição
funções	Devolve os direitos aos quais o utilizador pertence, como uma matriz. {% if user.roles contains 'Administrators' %} User is an administrator. {% endif %} Nota: também pode utilizar o filtro has_role para testar os membros da função individuais.
basic_badges_url	Devolve o url do serviço para obter os emblemas do utilizador. Para compor emblemas para um utilizador, tem de incluir uma etiqueta com os atributos "data-badge" e "data-uri". Para compor os emblemas do utilizador atual: <div data-badge data-uri='{{user.basic_badges_url }}'></div> Para compor sobre os emblemas de um utilizador por id (variável id de utilizador): `<div data-badge data-uri='{{user.basic_badges_url

ligações Web

Permite carregar quaisquer ligações Web por nome ou ID.

Se a ligação Web existir, é devolvido um objeto de conjunto de ligações Web. Se não for encontrado um conjunto de ligações Web com o nome ou ID indicado, é devolvido 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 %}

Atributos do Conjunto de Ligações Web

Atributo	Description
Copiar	O bloco de cópia HTML do conjunto de ligações Web.
Nome	O nome do conjunto de ligações Web.
Cargo	O título do conjunto de ligações Web.
Weblinks	A matriz de objetos de ligação Web associada ao conjunto de ligações Web.
[nome lógico do atributo]	Pode aceder a qualquer atributo do registo do Dataverse do conjunto de ligações Web por nome lógico. Por exemplo, {{ weblinkset.createdon }}

Atributos da Ligação Web

Atributo	Description
Description	A descrição HTML da ligação Web.
display_image_only	Atributo booleano que indica se a ligação Web deve ser apresentado apenas como imagem, sem o texto da ligação.
display_page_child_links	Atributo booleano que indica se a ligação Web deve mostrar as hiperligações para páginas subordinadas sitemap da página ligada, sob a forma de subligação.
Image	O objeto de imagem da ligação Web para esta ligação. Este atributo é null imagem se não estiverem presentes imagens.
is_external	Atributo booleano que indica se o URL de destino da ligação Web é para um site externo (em vez de para uma página do portal interna).
is_sitemap_ancestor	Devolve true se o URL da ligação Web referencia um predecessor do nó do mapa do site atual, caso contrário devolve false.
is_sitemap_current	Devolve true se o URL da ligação Web referencia o nó do mapa do site atual, caso contrário devolve false.
Nome	O nome/título da ligação Web.
Nofollow	Atributo booleano que indica se a ligação Web deve ser marcada como rel=nofollow.
open_in_new_window	Atributo booleano que indica se a ligação Web deve ser aberto numa nova janela/separador de browser quando selecionada.
Descrição	Descrição do texto da ligação Web.
URL	O URL da ligação Web.
Weblinks	A matriz de objetos de ligação Web subordinados associada à ligação Web.
[nome lógico do atributo]	Pode aceder a qualquer atributo do registo do Dataverse da ligação Web por nome lógico. Por exemplo, {{ weblink.createdon }}

Atributos da Imagem da Ligação Web

alternate_text	Texto alternativo para a imagem.
Height	Número inteiro que contém a altura especificada da imagem. Se não foi fornecido nenhum valor de altura, este atributo é null.
url	O URL da imagem.
Width	Número inteiro que contém a largura especificada da imagem. Se não foi fornecido nenhum valor de largura, este atributo é null.

website

Refere-se ao site do portal, que permite o acesso a todos os atributos do registo (adx_website) do site do Dataverse para o portal.

Código

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

Saída

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

Atributos

A tabela que se segue lista os atributos desta etiqueta que podem ser utilizados substituindo os predefinidos para evitar a colocação em cache.

Predefinição	Substituto (evita a colocação em cache)	Exemplo
sign_in_url	sign_in_url_substitution	Predefinição: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F Substituição (evita a colocação em cache): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F (neste exemplo, "substitute-page" substitui o URL em cache predefinido.)
sign_out_url	sign_out_url_substitution	Predefinição: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F Substituição (evita a colocação em cache): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F (neste exemplo, "substitute-page" substitui o URL em cache predefinido.)

Consulte também

Tipos de objetos da linguagem Liquid
Etiquetas do Liquid
Filtros do Liquid