Partilhar via

Objetos Liquid disponíveis

  • Artigo

Nota

A partir de 12 de outubro de 2022, os portais do Power Apps passam a ser Power Pages. Mais informações: O Microsoft Power Pages está agora em disponibilidade geral (blogue)
Em breve, vamos migrar e unir a documentação dos portais do Power Apps com a documentação do Power Pages.

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

Importante

Para evitar potenciais problemas de scripts no site (XSS), utilize sempre o filtro de escape para codificar dados HTML sempre que utilizar objetos Líquidos para ler dados não confiados fornecidos pelo utilizador.

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

Objeto Descrição
entidades Permite carregar qualquer tabela do Power Apps 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: este valor é colocado em cache pela aplicação Web do portal e não é atualizado sempre. 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 Power Apps subjacente. Mais informações: página
params 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 Power Apps subjacente. Se nenhum utilizador tiver sessão iniciada, esta variável será nula. 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 Web site do Power Apps (adx_website) para o portal. Mais informações: Web site

ads

Permite aceder e compor 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 Descrição
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 Descrição
[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 listados abaixo.

Atributo Descrição
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.
Nome 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

Nota

Um anúncio é um objeto de tabela, com todos os mesmos atributos, além dos listados abaixo.

Atributo Descrição
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.
Nome 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 será direcionado ao selecionar o anúncio.

Atributos da Imagem do Anúncio

Atributo Descrição
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.
width Devolve a largura em pixéis para a imagem

blogues

Fornece a capacidade para aceder e compor 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 mensagens 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).
título 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

Atenção

Para evitar potenciais problemas de scripting entre sites (XSS), utilize sempre filtro de escape para codificar em HTML os dados de cadeia sempre que se utilizar o objeto Liquid entidades para ler os dados fornecidos pelo utilizador nos quais não se pode confiar.

Nota

Algumas das convenções de nomenclatura do Dataverse mudaram, por exemplo, as entidades do Dataverse são agora denominadas tabelas. As alterações de nome não se aplicam a objetos do Liquid. O objeto de entidades do Liquid continuará a ser referido como entidades.

Permite carregar qualquer tabela do Power Apps por ID. Se a tabela existir, será devolvido um objeto de tabela. Se uma tabela com o ID fornecido não for localizada, será devolvido nulo.

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

{% if account %}

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

{% endif %}

{% assign entity_logical_name = 'contact' %}

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

{% if contact %}

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

{% endif %}

Entity

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

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 Power Apps da tabela.
Notas Carrega quaisquer notas (annotation) associadas à tabela, ordenadas da mais antiga para a 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 URL do sistema de gestão de conteúdos dos portais do Power Apps para a tabela. Se a tabela não tiver um URL válido no Web site atual, devolve null. Normalmente, só devolverá um valor para determinados tipos de tabela que foram integradas no CMS do portal, a menos que tenha personalizado o Fornecedor de URLs na sua aplicação.
[nome do atributo ou relação] Pode aceder a qualquer atributo da tabela do Power Apps 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), será 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 Power Apps da tabela referenciada.
Nome 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 adicionais.

Atributo Descrição
documentbody Carrega o atributo documentbody do registo de annotation da nota, como uma cadeia codificada em Base64. Como o conteúdo deste atributo pode 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 impacto 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 e tiver um ficheiro anexado, um pedido para este URL irá descarregar o anexo de ficheiro da nota.

Nota

Filtros adicionais

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 Descrição
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 false 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 Descrição
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 Dataverse do Power Apps. Fornece acesso a todos os atributos de uma determinada lista.

Nota

Compor a lista associada à página atual

Atributos

Nota

entities

Atributo Descrição
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 Power Apps 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 será 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 será 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 será 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 Power Apps 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.
[attribute logical name] Pode aceder a qualquer atributo do registo da lista (adx_entitylist) do Power Apps por nome lógico, tal como um objeto tabela. Por exemplo, {{ entitylist.adx_name }}

Atributos da Vista de Lista

Atributo Descrição
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 Power Apps 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 Power Apps que será utilizado para selecionar todas as etiquetas localizadas (cabeçalhos de coluna, etc.) da vista.
Nome Devolve o nome a apresentar do Power Apps da vista.
primary_key_logical_name Devolve o nome lógico da chave primária da tabela do Power Apps 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 Descrição
attribute_type Devolve o nome do tipo de atributo do Power Apps 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 Power Apps para a coluna. Por exemplo, createdon
Nome Devolve o nome a apresentar do Power Apps 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 Power Apps 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. Será 1, a menos que não tenham sido devolvidos resultados; neste caso, será null.
ID O ID do GUID da vista do Power Apps que define esta entityview.
language_code O código de idioma de número inteiro do Power Apps 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, será null.
nome O nome da vista do Power Apps 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, será 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, será null.
primary_key_logical_name O nome lógico do Power Apps 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_pages 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 aceder e compor 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 Descrição
occurences 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["Nome do Evento"] %}
{% 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] %}

note que

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

também é possível.

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 atributos associados são apresentados abaixo:

Atributo Descrição
URL O URL da ocorrência.
is_all_day_event Trata-se de um evento de dia inteiro?
start_time 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.

Nota

forloop só pode ser utilizado dentro de uma etiqueta 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

Fornece a capacidade para aceder e compor Fóruns e Tópicos de Fóruns. 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

Nota

entities

Atributo Description
threads Devolve um objeto forumthreads que contém todos os tópicos do fórum para o fórum.
Nome 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

Nota

entidades

Atributo Descrição
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

Nota

entidades

Atributo Descrição
author Devolve o autor da publicação (que é simplesmente objeto de tabela do contacto).
content 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 Power Apps 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 Descrição
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 Descrição
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

article é um objeto entity, com todos os mesmos atributos, além dos listados abaixo.

Atributo Descrição
article_public_number O Número Público do Artigo.
comment_count O valor inteiro da contagem do número de comentários existente para um artigo específico.
content 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

category é um objeto entity, com todos os mesmos atributos, além dos listados abaixo.

Atributo Descrição
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 suporte de várias idiomas 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.

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

Nota

entidades

Atributo Descrição
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, parent será null.
title 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 Power Apps 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), será 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 Dataverse do Power Apps para carregar coleções de entidades.

polls

Permite aceder e compor uma sondagem.

O objeto polls permite selecionar uma sondagem ou colocação de sondagem 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 Sondagens

Atributo Descrição
placements Devolve o objeto pollplacements.
[nome do sondagem ou id] Pode aceder a qualquer sondagem pelas respetivas propriedades Name ou Id. {% assign poll = polls[Poll Name] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Atributos de Colocações de Sondagem

Atributo Descrição
[colocação da sondagem ou id] Pode aceder a qualquer colocação de sondagem 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 Sondagem

Nota

entidades

Atributo Descrição
Nome Devolve o campo Nome da colocação da sondagem.
placement_url O URL que pode ser utilizado para obter o posicionamento da sondagem 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 uma sondagem aleatória a partir da colocação totalmente composta por um modelo.
submit_url O URL para o qual uma sondagem concluída é submetida.

Atributos da Sondagem

Nota

entidades

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

Atributos da Opção de Sondagem

Nota

entidades

Atributo Descrição
answer Devolve o campo Resposta da sondagem.
percentage Devolve a percentagem de votos na sondagem para a opção como um número decimal entre 0 e 100.
votes Devolve o número de votos que foram 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>

Nota

  • Pode compilar URLs de forma dinâmica no Liquid através de Filtros de URL.
  • O URL utilizado no request.url pode ser qualquer valor solicitado e fica em cache para pedidos subsequentes. Para garantir o valor correto em request.url, considere a utilização da etiqueta de substituição, URL parcial como ~ {Caminho do WebFile} ou armazenamento do URL do portal nas Definições do Site.
  • A versão de lançamento dos portais do Power Apps 9.3.8.x ou posterior terá, por predefinição, o filtro Liquid escape imposto para os objetos Liquido user e request. Para desativar esta configuração predefinida e permitir estes objetos Liquid sem filtro Liquid de cláusula de escape, consulte definições do site do portal - Site/EnableDefaultHtmlEncoding.

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.
Caminho 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 Dataverse do Power Apps 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 Descrição
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 pode 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 pode 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 será nula nesses casos.
ID O ID da tabela do Power Apps 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 Power Apps 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 será 11.
score A pontuação de Lucene do resultado, sob a forma de vírgula flutuante. Os resultados serão devolvidos ordenados por este valor.
title 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.

Nota

As definições são devolvidas como cadeias, mas pode utilizar Filtros de tipo para convertê-las noutros tipos.

{{ settings[My Setting] }}

{% assign search_enabled = settings[Search/Enabled] | boolean %}

{% if search_enabled %}

Search is enabled.

{% endif %}

{% assign pagesize = settings['page size'] | integer | default: 10 %}

{% if pagesize > 10 %}

Page size is greater than 10.

{% endif %}

Nota

Compor um cabeçalho de Web site e barra de navegação primária

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 pode conter HTML).
Entidade Devolve as entidades subjacentes do nó. Se o nó não tiver uma tabela subjacente, este valor será 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 será null.
Cargo 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, será devolvido um objeto sitemarker. Se um marcador de site com o nome fornecido não for encontrada, será devolvido nulo.

{{ sitemarkers[Login].url }}

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

{% if my_sitemarker %}

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

{% else %}

Site marker My Site Marker does not exist.

{% endif %}

Nota

Compor um cabeçalho de Web site e barra de navegação primária

Atributos de Sitemarker

Atributo Descrição
URL O URL do destino do marcador do site.
[attribute logical name] Pode aceder a qualquer atributo do registo do Power Apps 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 nulo.

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

Nota

tablerowloop só pode ser utilizado dentro de uma etiqueta 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.

utilizador

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

utilizador é um objeto entity.

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

Nota

A versão de lançamento dos portais do Power Apps 9.3.8.x ou posterior terá, por predefinição, o filtro Liquid escape imposto para os objetos Liquido user e request. Para desativar esta configuração predefinida e permitir estes objetos Liquid sem filtro Liquid de cláusula de escape, consulte definições do site do portal - Site/EnableDefaultHtmlEncoding.

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, será 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, será devolvido nulo.

<!-- Load web link set by ID -->

{{ weblinks[page.adx_navigation.id].name }}

<!-- Load web link set by name -->

{% assign nav = weblinks[Primary Navigation] %}

{% if nav %}

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

<ul>

{% for link in nav.weblinks %}

<li>

<a href={{ link.url | escape }} title={{ link.tooltip | escape }}>

{% if link.image %}

<img src={{ link.image.url | escape }} alt={{ link.image.alternate_text | escape }} />

{% endif %}

{{ link.name | escape }}

</a>

</li>

{% endfor %}

</ul>

{% endif %}

Nota

Compor um cabeçalho de Web site e barra de navegação primária |

Atributos do Conjunto de Ligações Web

Nota

Um conjunto de ligações Web é um objeto entity, com todos os mesmos atributos, além dos listados abaixo.

Atributo Descrição
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.
[attribute logical name] Pode aceder a qualquer atributo do registo do Power Apps do conjunto de ligações Web por nome lógico. Por exemplo, {{ weblinkset.createdon }}

Atributos da Ligação Web

Nota

Uma ligação Web é um objeto entity, com todos os mesmos atributos, além dos listados abaixo.

Atributo Descrição
Descrição 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.
Imagem O objeto de imagem da ligação Web para esta ligação. Este atributo será nulo 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.
[attribute logical name] Pode aceder a qualquer atributo do registo do Power Apps 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.
Altura Número inteiro que contém a altura especificada da imagem. Se não foi fornecido nenhum valor de altura, este atributo será nulo.
URL O URL da imagem.
Largura Número inteiro que contém a largura especificada da imagem. Se não foi fornecido nenhum valor de largura, este atributo será nulo.

website

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

Nota

Web site é um objeto entity, com todos os mesmos atributos.

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

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).