Compartilhar via

Objetos do Liquid disponíveis

  • Artigo

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

Para acessar um atributo de objeto por nome, use um ponto (.). Para renderizar um atributo de objeto em um modelo, coloque-o entre {{ and }}.

Importante

Para evitar possíveis problemas de script entre sites (XSS), sempre use o filtro de escape para codificar dados em HTML sempre que usar objetos do Liquid para ler dados não confiáveis fornecidos pelo usuário.

{{ page.title }}

Os atributos de um objeto também podem ser acessados usando um nome de cadeia de caracteres e []. Esse formato é útil nos casos em que o atributo exigido é determinado dinamicamente, ou em que o nome do atributo contém caracteres, espaços, caracteres especiais etc. que seriam inválidos ao usar um período (.) dentro da sintaxe.

{{ page[title] }}

{% assign attribute_name = Name with spaces %}

{{ object[attribute_name] }}

Os objetos a seguir podem ser usados e acessados em qualquer lugar e em qualquer modelo.

Object Description
entidades Permite a você carregar qualquer tabela do Microsoft Dataverse por ID. Mais informações: entidades
agora O objeto data/hora que se refere ao horário UTC atual, no momento em que o modelo é renderizado.
Observação: o aplicativo Web do portal armazena em cache este valor e ele não é sempre atualizado. Mais Informações: Filtros de data
página Consulte a página de solicitação do portal atual. O objeto página fornece acesso a itens, como trilha para a página atual, o título ou a URL da página atual e quaisquer outros atributos ou entidades relacionados do registro de Dataverse subjacente. Mais informações: página
parâmetros Um atalho conveniente para request.params. Mais informações: solicitação
solicitação Contém informações sobre a solicitação HTTP atual. Mais informações: solicitação
configurações Permite carregar qualquer Configuração de site por nome. Mais informações: configurações
sitemap Permite acesso ao mapa do site do portal. Mais informações: mapa do site
marcadores de site Permite a você carregar qualquer marcador de site por nome. Mais informações: marcadores de site
snippets Permite carregar qualquer trecho de conteúdo por nome. Mais informações: trechos
usuário Refere-se ao usuário do portal atual, permitindo acesso a todos os atributos do registro de contato do Dataverse. Se nenhum usuário estiver conectado, essa variável será nula. Mais informações: usuário
weblinks Permite a você carregar qualquer Conjunto de Links da Web por nome ou ID. Mais informações: links da Web
website Refere-se ao portal do registro do site, permitindo acesso a todos atributos de registro do site do Dataverse (adx_website) do portal. Mais informações: site

ads

Habilita a recuperação e a exibição de um anúncio.

O objeto de anúncios permite selecionar um anúncio ou posicionamento 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 anúncios

Atributo Description
posicionamentos Retorna o objeto adplacements.
[nome do anúncio ou id] Você pode acessar qualquer anúncio pelo seu Nome ou propriedades de Id.
{% assign ad = ads[Ad Name] %}
{% assign ad = ads["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Atributos de posicionamentos de anúncio

Atributo Description
[nome do posicionamento do anúncio ou id] Você pode acessar qualquer posicionamento de anúncio por Nome ou propriedades de Id.
{% assign placement = ads.placements[Placement Name or Id] %}
{% assign placement = ads.placements[2423d713-abb3-44c3-8a7d-c445e16fccad] %}

Atributos de posicionamentos de anúncio

Um posicionamento de anúncio é um objeto de tabela com os mesmos atributos gerais e os seguintes atributos:

Atributo Description
Anúncios Retorna a coleção de objetos de anúncio associados ao posicionamento. Marcas de iteração e Filtros de matriz podem ser usados com essa coleção.
Name Retorna o campo Nome para o posicionamento de anúncio.
placement_url A URL que pode ser usada para recuperar o posicionamento de anúncio totalmente renderizado por um modelo.
random_url A URL que pode ser usada para recuperar um anúncio aleatório do posicionamento totalmente renderizado por um modelo.

Atributos de anúncios

Observação

O anúncio é um objeto de tabela, com todos os mesmos atributos, além dos seguintes:

Atributo Description
ad_url A URL que pode ser usada para recuperar o anúncio totalmente renderizado por um modelo.
Texto Retorna o campo Texto para o anúncio.
imagem Retorna o objeto de imagem (se houver) para o anúncio.
Name Retorna o campo Nome para o anúncio.
open_in_new_window Retorna verdadeiro se a URL especificada por redirect_url precisar ser aberta em uma nova janela.
redirect_url A URL à qual o usuário é direcionado quando seleciona o anúncio.

Atributos de imagem de anúncio

Atributo Description
alternate_text Retorna o texto que deve aparecer no atributo alt da marca.
height Retorna a altura em pixels da imagem
URL Retorna a URL de origem da imagem.
largura Retorna a largura em pixels da imagem

blogs

Habilita a recuperação e a exibição de Blogs e Postagens em Blogs.

O objeto blogs permite que você selecione um blog ou postagem em blog específico.

{% 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 que você acesse qualquer blog específico no portal ou acesse todas as postagens em blog no portal.

A tabela a seguir descreve os atributos associados ao objeto blogs.

Atributo Descrição
postagens Retorna um objeto blogposts que contém todas as postagens em blog no portal.
[nome do blog ou id] Você pode acessar qualquer blog pelas propriedades Nome ou Id. 
{% assign blog = blogs["Blog Name"] %}                             

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

Objeto blog

O objeto blog permite a você trabalhar com um único blog e acessar as postagens nesse blog.

A tabela a seguir descreve vários atributos associados ao objeto blog.

Atributo Descrição
postagens Retorna um objeto blogposts que contém todas as postagens no blog.
Nome O nome do blog.
title O título do blog.
URL A URL do blog.

Objeto blogposts

O objeto blogposts permite que você acesse uma coleção de objetos de postagem em blog. Você pode ordenar as postagens em blog e alcançar paginação, além de usar filtros líquidos:

{% 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 postagens no blog)
  • blogs.posts | from\_index: 0 | take: 2

A tabela a seguir descreve vários atributos associados ao objeto blogposts.

Atributo Descrição
Todas Retorna todos os objetos blogpost no conjunto

Objeto blogpost

Refere-se a uma única postagem em blog.

A tabela a seguir descreve vários atributos associados ao objeto blogpost.

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

entidades

Cuidado

Para evitar possíveis problemas de script entre sites (XSS), sempre use filtro de escape para HTML codificar dados de string sempre que usar o Objeto Liquid entidades para ler dados fornecidos pelo usuário que não são confiáveis.

Observação

Algumas das convenções de nomenclatura do Dataverse foram alteradas, por exemplo, as entidades do Dataverse agora chamam-se tabelas. As alterações de nome não se aplicam a objetos Liquid. O objeto de entidades Liquid continuará a ser mencionado como entidades.

Permite a você carregar qualquer tabela do Dataverse por ID. Se a tabela existir, será retornado um objeto de tabela. Se uma tabela com uma determinada ID não for encontrada, nulo será retornado.

{% 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 registro da tabela do Dataverse.

Atributo Descrição
Id A ID da GUID da tabela, como uma cadeia de caracteres. Por exemplo, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name O nome lógico do Dataverse da tabela.
Notes Carrega quaisquer anotações associadas à tabela, ordenadas da mais antiga para a mais recente (createdon). As anotações são retornadas como objetos de anotação.
permissões Carrega resultados da declaração de Permissão de Tabela para a tabela. Os resultados são retornados como um objeto de permissão.
url Retorna o caminho da URL do sistema de gerenciamento de conteúdo do Power Pages para a tabela. Se a tabela não tiver nenhuma URL válida no site atual, retorna nulo. Geralmente, retorna um valor para determinados tipos de tabela que foram integrados ao CMS do portal, a menos que você tenha personalizado o Provedor de URL em seu aplicativo.
[nome do atributo ou do relacionamento] Você pode acessar qualquer atributo da tabela do Dataverse por nome lógico. {{ entity.createdon }}{% assign attribute_name = 'name' %}{{ entity[attribute_name] }}
Os valores da maioria dos atributos de tabela mapeiam diretamente para tipos Liquid: campos de duas opções mapeiam para boolianos, campos de texto para cadeia de caracteres, campos numéricos/de moeda para números; campos de data/hora para objetos de data. Porém, alguns tipos de atributo são retornados como objetos:
  • Os campos Consulta (Referência de Tabela Associada) são retornados como objetos de referência de tabela associados.
  • Os campos Conjunto de Opções/Lista de Seleção são retornados como objetos de valor do conjunto de opções.
  • Você também pode carregar quaisquer entidades relacionadas pelo nome do esquema de relacionamento.
    • {{ page.adx_webpage_entitylist.adx_name }}No caso de o relacionamento ser reflexivo (ou seja, autorreferencial), será retornado um objeto de relacionamento reflexivo. (Caso contrário, o resultado seria ambíguo.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Observação: carregar um grande número de entidades relacionadas ou acessar um grande número de relacionamentos em um único modelo pode ter um impacto negativo no desempenho da renderização do modelo. Evite carregar entidades relacionadas para cada item em uma matriz, dentro de um loop. Quando possível, use as marcas de tabela do Dataverse para carregar as coleções de entidades.

Referência da Tabela Associada

Os valores de atributos de pesquisa são retornados como objetos de referência de tabela associados, com os seguintes atributos.

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

Anotação

Uma anotação é um objeto de tabela que fornece acesso aos atributos e relacionamentos de um registro de anotação. Além de todos os atributos de um objeto de tabela, uma anotação tem os seguintes atributos extras.

Atributo Description
documentbody Carrega o atributo documentbody do registro da anotação, como uma cadeia de caracteres codificada na Base 64. Como o conteúdo deste atributo pode ser grande, ele não é carregado com o restante dos atributos de anotação; ele só é carregado mediante solicitação.
Observação: o uso do atributo documentbody pode ter um efeito negativo no desempenho da renderização do modelo e deve ser feito com cuidado.
Em vez disso, use o atributo URL para fornecer um link para o anexo de anotação, se possível.
URL Retorna o caminho da URL do manipulador de anexo de anotação do portal interno. Se o usuário tiver permissão e a anotação tiver um arquivo anexo, uma solicitação para esta URL baixa o anexo do arquivo de anotação.

Observação

Filtros adicionais

Valor de conjunto de opções

Os valores de atributos de Conjunto de Opções/Lista de Seleção são retornados como objetos de referência da tabela, com os seguintes atributos.

Atributo Descrição
Etiqueta O rótulo localizado do valor do conjunto de opções/lista de seleção. Por exemplo, Active
Valor O valor inteiro do valor do conjunto de opções/lista de seleção. Por exemplo, 0

Permissões de Tabela

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

Atributo Description
can_append Retorna verdadeiro se o usuário atual tiver permissão para acrescentar registros a relacionamentos desse registro. Caso contrário, retorna falso.
can_append_to Retorna verdadeiro se o usuário atual tiver permissão para acrescentar este registro ao relacionamento de uma outra tabela. Caso contrário, retorna falso.
can_create Retorna verdadeiro se o usuário atual tiver permissão para criar novos registros desse tipo de tabela. Caso contrário, retorna falso.
can_delete Retorna verdadeiro se o usuário atual tiver permissão para excluir esse registro. Caso contrário, retorna falso.
can_read Retorna verdadeiro se o usuário atual tiver permissão para ler esse registro. Caso contrário, retorna falso.
can_write Retorna verdadeiro se o usuário atual tiver permissão para atualizar esse registro. Caso contrário, retorna falso.
rules_exist Retorna verdadeiro se os resultados de permissão representados por esse objeto são o resultado de regras de permissão definidas explicitamente. Retorna falso quando são os resultados padrão na ausência de permissões definidas explicitamente.

Relacionamento reflexivo

As tentativas de carregar relacionamentos reflexivos (ou seja, autorreferenciais) em entidades são retornadas como objetos com os atributos a seguir.

Atributo Description
is_reflexive Retorna verdadeiro. Pode ser usado para testar se um objeto retornado por um relacionamento é um objeto de relacionamento reflexivo.
referenciado Retorna uma matriz de entidades referenciadas para um determinado relacionamento.
referencial Retorna uma tabela de referência para um determinado relacionamento. Retorna nulo se não existir nenhuma tabela de referência. Se o relacionamento for do tipo muitos para muitos (N:N), retorna uma matriz de entidades de referência.

entitylist

O objeto de lista de entidades é usado dentro das Tags da tabela do Dataverse. Proporciona acesso a todos os atributos de uma determinada lista.

Observação

Renderizar a lista da tabela associada à página atual

Atributos

Observação

entidades

Atributo Description
create_enabled Retorna verdadeiro se a criação de novos registros for definida na lista. Caso contrário, retorna falso.
create_url Retorna o caminho da URL configurado para um link para criação/botão da lista.
detail_enabled Retorna verdadeiro se uma exibição dos detalhes dos registros individuais for definida na lista. Caso contrário, retorna falso.
detail_id_parameter Devolve o nome de parâmetro de cadeia de consulta para usar para o registro de ID quando criar um detalhe de registro na visualização da URL. Consulte Filtros de URL para obter detalhes sobre o uso de filtros Liquid para criar URLs. Por exemplo, id
detail_label Retorna o rótulo localizado configurado para botões/links de exibição de detalhes da lista.
detail_url Retorna um caminho de URL configurado para botões/links de exibição de detalhes da lista.
empty_list_text Retorna os textos localizados configurados a serem exibidos quando a exibição da lista de tabelas não retornar os resultados.
enable_entity_permissions Retorna verdadeiro se a filtragem de Permissão de Tabela estiver ativada para essa lista. Caso contrário, retorna falso.
entity_logical_name Retorna o nome lógico da tabela do Dataverse para que os registros sejam exibidos nessa lista. Exemplo: contato
filter_account_attribute_name Retorna o nome lógico de atributo da pesquisa para a conta que é usado para filtrar registros pelo resultado da conta principal do portal do usuário atual. Por exemplo, accountid
filter_apply_label Retorna o rótulo localizado configurado a ser usado para o link/botão que aplica um filtro avançado de atributo aos resultados da lista.
filter_definition Retorna a definição de filtragem para JSON de atributo da lista. Consulte Filtros de lista para obter detalhes sobre como usar o filtro Liquid de metafiltros para processar essa definição.
filter_enabled Retorna verdadeiro se a filtragem de atributo avançada for habilitada para a lista. Caso contrário, retorna falso.
filter_portal_user_attribute_name Retorna o nome lógico de atributo da pesquisa para o contato que será usado para filtrar registros pelo resultado do contato do portal do usuário atual. Por exemplo, contactid
filter_website_attribute_name Retorna o nome lógico de atributo da pesquisa para adx_website que será usado para filtrar registros pelo resultado da do site atual do portal. Por exemplo, adx_websiteid
language_code Retorna o código de idioma inteiro do Dataverse que será usado para selecionar todos os rótulos localizados para essa lista.
page_size Retorna o tamanho da página configurado para os resultados da lista.
primary_key_name Retorna o nome lógico do atributo de chave primária para que os registros sejam exibidos nesta lista.
search_enabled Retorna verdadeiro se a busca estiver ativada para essa lista. Caso contrário, retorna falso.
search_placeholder Retorna os textos localizados configurados com espaço reservado de campo de pesquisa na lista.
search_tooltip Retorna os textos localizados configurados para a dica de ferramenta de busca da lista.
modos de exibição Retorna as exibições disponíveis para a lista como objetos de exibição de lista.
[nome lógico do atributo] Você pode acessar qualquer atributo do registro da lista de entidade (adx_entitylist) do Dataverse por nome lógico, assim como em um objeto da tabela. Por exemplo, {{ entitylist.adx_name }}

Atributos de Lista de Exibição

Atributo Description
colunas Retorna as colunas da exibição como objetos de coluna de exibição da lista.
entity_logical_name Retorna o nome lógico da tabela do Dataverse para os registros inclusos nele. Exemplo: contato
Identificação Retorna a ID do GUID da exibição.
language_code Retorna o código de idioma inteiro do Dataverse que é usado para selecionar todos os rótulos localizados (cabeçalhos de coluna etc.) para a exibição.
Name Devolve o nome da exibição do Dataverse da visualização.
primary_key_logical_name Retorna o nome lógico da chave primária da tabela do Dataverse para os registros inclusos nele. Por exemplo, contactid
sort_expression Devolve a expressão de classificação padrão para a exibição. Por exemplo, name ASC, createdon DESC

Atributos da coluna da exibição em lista

Atributo Description
attribute_type Retorna o tipo de atributo do Dataverse para a coluna, como uma cadeia de caracteres. Por exemplo, pesquisa, lista de seleção, cadeia de caracteres, booliano, DateTime
logical_name Retorna o nome lógico de atributo do Dataverse para a coluna. Por exemplo, createdon
Nome Retorna o nome de exibição do Dataverse localizado para a coluna. Por exemplo, Created On
sort_ascending Retorna uma cadeia de caracteres da expressão do tipo de classificação da coluna em ordem crescente. Por exemplo, createdon ASC
sort_descending Retorna uma cadeia de caracteres da expressão do tipo de classificação da coluna em ordem descendente. Por exemplo, createdon DESC
sort_disabled Retorna verdadeiro se a classificação for desabilitada para a coluna. Caso contrário, retorna falso.
sort_enabled Retorna verdadeiro se a classificação for habilitada para a coluna. Caso contrário, retorna falso.
width Retorna a largura configurada para a coluna, em pixels.

entityview

O objeto entityview é usado na marca entityview e fornece acesso aos metadados da exibição, além de registros de resultados de exibição.

Atributos

Atributo Descrição
colunas Retorna as colunas na exibição, como objetos de coluna de exibição em tabela.
entity_permission_denied Retorna verdadeiro se o acesso aos resultados de exibição foi negado por causa de Permissões de Tabela insuficientes para o usuário atual. Retorna falso se é concedido acesso para exibir resultados.
entity_logical_name O nome lógico da tabela do Dataverse dos registros de resultados de exibição. Exemplo: contato
first_page O número da página da primeira página de resultados de exibição. É 1, a menos que nenhum resultado seja retornado; nesse caso, será nulo.
Identificação A ID de GUID de exibição do Dataverse que define essa entityview.
language_code O código de idioma do inteiro do Dataverse que está sendo usado para carregar rótulos localizados para a exibição atual.
last_page O número da página da última página de resultados de exibição. Se não houver nenhum resultado, este valor será nulo.
nome O nome da exibição do Dataverse que define essa entityview, como Contatos Ativos.
next_page O número da página da próxima página de resultados de exibição. Se não houver uma página seguinte de resultados, o valor será nulo.
Página O número da página da primeira atual de resultados de exibição.
páginas Retorna uma matriz de números de página contendo todas as páginas de resultados da exibição atual.
page_size O número de resultados retornados por página para a exibição atual.
previous_page O número da página da próxima página de resultados de exibição. Se não houver uma página anterior de resultados, esta será nula.
primary_key_logical_name O nome lógico do atributo de chave primária da tabela de resultado do Dataverse para esta exibição. Exemplo: contactid.
registros A página atual de registros de resultados para a exibição, como objetos de tabela.
sort_expression A expressão de classificação padrão para a exibição. Por exemplo, nameASC, createdon DESC.
total_pages O número total de páginas de resultados para a exibição.
total_records O número total de resultados para a exibição (em todas as páginas).

eventos

Habilita a recuperação e a exibição de eventos. O objeto eventos permite que você selecione um evento específico ou todos os eventos.

Objeto eventos

O objeto eventos permite que você acesse qualquer evento específico no portal ou acesse todos os eventos no portal (independentemente do evento).

O objeto eventos tem os atributos a seguir:

Atributo Description
ocorrências Retorna um eventoccurancessobject que contém todas as ocorrências de evento no portal
[nome e ID do evento] Você pode acessar qualquer evento pelas propriedades Nome ou Id.
{% assign event = events["Event Name"] %}
{% assign event = events["da8b8a92-2ee6-476f-8a21-782b047ff460"] %}

Objeto evento

O objeto evento permite a você trabalhar com um único evento, possibilitando acesso às programações e ocorrências daquele evento.

O objeto evento tem os atributos a seguir:

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

Objeto eventoccurences

O objeto eventoccurrences permite que você acesse um conjunto de ocorrências de evento. Você pode classificar as ocorrências de evento e especificar um intervalo de datas das ocorrências para recuperar e atingir a paginação, usando 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 são associados ao objeto eventoccurrences

Atributo Descrição
Todas Retorna todos os objetos eventoccurance no conjunto.

Objeto eventoccurence

Representa uma ocorrência única do evento. A seguir estão os atributos associados:

Atributo Description
url A URL da ocorrência.
is_all_day_event É um evento de dia inteiro?
start_time Hora de início do evento.
end_time Hora de término do evento.

forloop

Contém propriedades úteis em um bloco de loop for.

Observação

O forloop só pode ser usado em uma marca for.

Code

{% 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
primeira Retorna verdadeiro se for a primeira iteração do loop. Retorna falso se não for a primeira iteração do loop.
index A posição do item atual na coleção, onde o primeiro item fica na posição 1.
index0 A posição do item atual na coleção, onde o primeiro item fica na posição 0.
Última Retorna verdadeiro se for a última iteração do loop. Retorna falso se não for a última iteração do loop.
comprimento Retorna o número de iterações do loop ߝ o número de itens na coleção que está sendo iterada.
rindex O número de itens restantes no loop (duração - índice) em que 1 é o índice do último item.
rindex0 O número de itens restantes no loop (duração - índice) em que 0 é o índice do último item.

fóruns

Habilita a recuperação e a exibição de Fóruns e Threads do Fórum. A possibilidade de usar Liquid para renderizar dados de fórum se estende a postagens. Porém, para criar uma nova postagem ou thread, você deve usar um Modelo de Página de formulários de várias etapas do ASP.NET com a funcionalidade interna (como Modelos padrão da página Thread do Fórum e Postagem do Fórum).

O objeto dos fóruns permite que você selecione um grupo ou threads de grupos:

<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 dos fóruns

O objeto de fóruns permite que você acesse qualquer fórum específico no portal ou acesse todas as postagens em fórum threads no portal (independentemente do fórum).

O objeto fórum permite a você trabalhar com um único fórum, permitindo que você acesse os threads desse fórum.

O objeto threads de fórum permite que você acesse um conjunto de objetos de thread de fóruns. Você pode ordenar os threads de fórum e alcançar paginação, bem como usar filtros líquidos.

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

Um único thread de grupo

O objeto postagens em fórum permite que você acesse um conjunto de objetos de postagem em fórum.

Atributos

Atributo Descrição
threads Retorna um objeto forumthreads que contém todos os objetos forumthreads no portal.
Todas Retorna todos os objetos fórum no portal. Observe que website.forums também é um equivalente.
thread_count Retorna o valor inteiro da contagem de quantos threads há no site inteiro.
post_count Retorna o valor inteiro do número total de postagens no portal.
[nome e ID do fórum] Você pode acessar qualquer fórum pelas propriedades Nome ou Id.
`{% assign forum = forums[Forum Name] %}
{% assign forum = forums[da8b8a92-2ee6-476f-8a21-782b047ff460] %}

Objeto forum

Atributos

Observação

entidades

Atributo Description
threads Retorna um objeto forumthreads que contém todos os threads de fórum do fórum.
Name O nome do fórum.
thread_count Retorna o valor inteiro da contagem de quantos threads há no fórum.
post_count Retorna o valor inteiro de contagem de quantas postagens há no fórum inteiro.

Objeto forumthreads

Atributos

Atributo Descrição
Todas Retorna todos os objetos forumthread no conjunto.

Objeto forumthread

Atributos

Observação

entidades

Atributo Description
postagens Retorna um objeto forumposts que contém todas as postagens de fórum para o thread.
autor Retorna o autor do thread (que é simplesmente um objeto de tabela de contato).
latest_post Postagem retorna à última no thread.
first_post Postagem retorna à primeira no thread.
post_count Retorna o valor inteiro da contagem de quantas postagens há no thread.
is_answered O thread foi atendido ou não?
is_sticky O thread é um thread fixo?

Objeto forumposts

Atributos

Atributo Descrição
Todas Retorna todos os objetos forumthread no conjunto.

Uma única postagem de grupo

Atributos

Observação

entidades

Atributo Description
autor Retorna o autor da postagem (que é simplesmente um objeto de tabela de contato).
conteúdo O conteúdo da postagem.
is_answer Esta postagem é um resposta ao thread?

conhecimento

Fornece acesso aos registros de tabela knowledgearticle e category do Dataverse para renderizar artigos e categorias em um portal.

Atributos

Atributo Descrição
artigos Retorna um objeto articles com objetos article para os registros de tabela knowledgearticle disponíveis no portal.
categorias Retorna um objeto categories com objetos category para os registros de tabela category disponíveis no portal.

objeto articles

O objeto articles permite que você acesse uma coleção de objetos article. Você pode classificar os artigos e obter a paginação, bem como usar filtros líquidos.

{% 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 Retorna uma coleção de objetos article com a maioria dos modos de exibição. {% assign popular_articles = knowledge.articles.popular %}
recent Retorna uma coleção de objetos article com a data da última modificação. {% assign recent_articles = knowledge.articles.recent %}
principais Retorna uma coleção de objetos article com a classificação mais alta. {% assign top_articles = knowledge.articles.top %}

Filtros

Os filtros a seguir podem aceitar parâmetros opcionais para tamanho e idioma de página. O primeiro parâmetro é o número de registros a serem recuperados. O tamanho de página padrão é 5. O segundo parâmetro é o código de um idioma para recuperar artigos de um determinado idioma. Os filtros podem ser combinados com os 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 Retorna uma coleção de objetos article com a maioria dos modos de exibição. {% assign popular_articles = knowledge.articles \| popular: 10, en-US %}
recent Retorna uma coleção de objetos article com a data da última modificação. {% assign recent_articles = knowledge.articles \| recent: 5 %}
principais Retorna uma coleção de objetos article com a classificação mais alta. {% assign top_articles = knowledge.articles \| top: 3, en-US %}

objeto categories

O objeto categories permite que você acesse uma coleção de objetos category. Você pode classificar as categorias e obter a paginação, bem como usar filtros líquidos.

{% 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 Retorna uma coleção de objetos category com a data da última modificação.
top_level Retorna uma coleção de objetos category que não têm uma categoria principal.

Filtros

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

{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
Atributo Description
recent Retorna uma coleção de objetos category com a data da última modificação. Você pode oferecer parâmetros {% assign recent_categories = knowledge.categories \| recent: 10 %}
top_level Retorna uma coleção de objetos category que não têm uma categoria principal. {% assign root_categories = knowledge.categories \| top_level %}

objeto article

O objeto article permite trabalhar com um único knowledgearticle para exibir os detalhes do artigo no portal.

Atributos

O artigo é um objeto da entidade, com os mesmos atributos, além dos atributos a seguir:

Atributo Description
article_public_number O Número Público do Artigo.
comment_count O valor inteiro da contagem de quantos comentário há para um determinado artigo.
conteúdo O conteúdo do artigo.
current_user_can_comment Retorna um valor Booliano que indica se o usuário atual pode adicionar comentários ao artigo.
is_rating_enabled Retorna um valor booliano que indica se a classificação está habilitada no artigo.
keywords As palavras-chave no artigo.
nome Um alias alternativo para o título do artigo.
classificação O valor de classificação decimal do artigo.
title O título do artigo.
view_count O valor inteiro do número de vezes que um artigo foi exibido.

objeto category

O objeto category permite trabalhar com uma única categoria para exibir seus detalhes no portal.

Atributos

A categoria é um objeto da entidade, com os mesmos atributos, além dos atributos a seguir:

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.

language

Fornece o nome do idioma atual e o código do idioma se o suporte a vários idiomas estiver ativado.

Atributos

Atributo Descrição
url O URL da solicitação atual prefixado com o código do idioma atual.
url_substitution O URL de solicitação atual prefixado com o código do idioma atual, ignorando o 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 suspensa de idiomas usa este objeto Liquid por padrão para listar os idiomas disponíveis quando vários idiomas estão disponíveis.

log

Os criadores têm a capacidade de incorporar instruções de log em seu código do Liquid. Quando o site do Power pages está em execução, os logs adicionados pelo criador no código do Liquid são mostrados na Extensão da ferramenta do desenvolvedor do Power Pages. Esses logs, incorporados pelo criador, são exibidos na extensão da ferramenta do desenvolvedor quando a configuração de diagnóstico está habilitada.

A sintaxe a seguir pode ser usada no código do Liquid para registrar mensagens personalizadas:

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

Atributos do log

Atributo Description
log Nome do objeto do Liquid
message Uma cadeia de caracteres que representa todas as mensagens personalizadas a serem registradas
nível Registre a mensagem como Informações, 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

Consulte a página de solicitação do portal atual. Este objeto combina os atributos do sitemap e a solicitação atual entidades (geralmente uma página da web).

O objeto página fornece acesso a itens, como trilha para a página atual, o título ou a URL da página atual e quaisquer outros atributos ou entidades relacionados do registro de 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 de página

Observação

entidades

Atributo Description
trilhas de navegação Retorna os objetos de nó de mapa do site da trilha da página, começando no nó raiz do mapa do site e terminado no primário.
filhos Retorna os objetos do nó do mapa do site filho da página.
primário Retorna o nó de mapa do site pai da página. Se a página for a Página Inicial, o pai será nulo.
cargo O título da página.
url A URL da página.
[nome do atributo ou do relacionamento] Você pode acessar qualquer atributo do registro do Dataverse de páginas subjacentes por nome lógico.
{{ page.createdon }}
{% assign attribute_name = 'name' %}
{{ page[attribute_name] }}
Os valores da maioria dos atributos de tabela mapeiam diretamente para tipos Liquid: campos de duas opções mapeiam para boolianos, campos de texto para cadeia de caracteres, campos numéricos/de moeda para números; campos de data/hora para objetos de data. Porém, alguns tipos de atributo são retornados como objetos:
  • Os campos Consulta (Referência de Tabela Associada) são retornados como objetos de referência de tabela associados..
  • Os campos de conjunto de opções/lista de seleção são retornados como objetos de valor de conjunto de opções.
    • Você também pode carregar quaisquer entidades relacionadas pelo nome do esquema de relacionamento.
    {{ page.adx_webpage_entitylist.adx_name }}
    No caso de o relacionamento ser reflexivo (isto é, autorreferencial), um objeto entidades será retornado. (Caso contrário, o resultado seria ambíguo.){{ page.adx_webpage_webpage.referencing.adx_name }}
    Observação: carregar um grande número de entidades relacionadas ou acessar um grande número de relacionamentos em um único modelo pode ter um impacto negativo no desempenho da renderização do modelo. Evite carregar entidades relacionadas para cada item em uma matriz, dentro de um loop. Quando possível, use as marcas de Tags da tabela do Dataverse para carregar coleções de entidades.

votações

Habilita a recuperação e a exibição de uma votação.

O objeto votações permite que você selecione uma consulta específica ou posicionamento de consulta:

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

Atributo Description
posicionamentos Devolve o objeto de posicionamento de votação.
[nome ou id da votação] Você pode acessar qualquer votação pelas propriedades Nome ou Id. {% assign poll = polls[Poll Name] %}
{% assign poll = polls["41827a5c-33de-49b8-a0c7-439e6a02eb98"] %}

Atributos de posicionamentos de votação

Atributo Description
[posicionamento ou ID da votação] Você pode acessar qualquer posicionamento de votação pelas propriedades Nome ou Id.{% assign placement = polls.placements[Placement Name or Id] %}
{% assign placement = polls.placements[7677c5d4-406e-4b6c-907c-916ac17dba0f] %}

Atributos de posicionamentos de votação

Observação

entidades

Atributo Description
Name Retorna o campo Nome para o posicionamento de votação.
placement_url A URL que pode ser usada para recuperar o posicionamento de votação totalmente renderizado por um modelo.
votações Retorna a coleção de objetos de votação associados ao posicionamento. Marcas de iteração e Filtros de matriz podem ser usados com essa coleção.
random_url A URL que pode ser usada para recuperar uma votação aleatória do posicionamento de votação totalmente renderizado por um modelo.
submit_url A URL para qual uma votação concluída será enviada.

Atributos de votação

Observação

entidades

Atributo Description
has_user_voted Retorna verdadeiro se o usuário atual (conectado ou anônimo) já votou nessa votação.
Nome Retorna o campo Nome para a votação.
opções Retorna a coleção de objetos de opção de votação associados à votação. Marcas de iteração e entidades podem ser usadas com essa coleção.
poll_url A URL que pode ser usada para recuperar a votação totalmente renderizado por um modelo.
Pergunta do Retorna o campo Pergunta para a votação.
submit_button_label Retorna uma cadeia de caracteres que pode ser usada para substituir o rótulo do botão para votação.
submit_url A URL para qual uma votação concluída será enviada.
user_selected_option Retorna o objeto de opção de votação selecionado pelo usuário (se eles já votaram).
votos Retorna o número de votos que estão tabulados para a votação.

Atributos de Opção de Votação

Observação

entidades

Atributo Description
resposta Retorna o campo Resposta para a votação.
porcentagem Retorna a porcentagem de votos na votação para a opção como número decimal entre 0 e 100.
votos Retorna o número de votos que estão tabulados para a opção.

solicitação

Contém informações sobre a solicitação HTTP atual.

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

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

Observação

Atributos

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

searchindex

O objeto searchindex é usado nas marcas da 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 Retorna um número aproximado do total de ocorrências correspondentes à consulta de índice. Por causa da maneira como o índice de pesquisa funciona em relação à filtragem de segurança e a outros fatores de design, este número é apenas uma aproximação e pode não corresponder exatamente ao número total de resultados disponíveis para o usuário atual em algumas situações.
Página Retorna o número da página da consulta atual.
page_size Retorna o tamanho máximo da página da consulta atual. Se quiser obter o número real de resultados retornados para a página atual (como isso pode ser menor do que o tamanho de página máximo especificado), use results.size.
resultados Retorna a página de resultados da consulta, como os objetos de resultado de índice de pesquisa.

Resultados de índice de pesquisa

Atributo Descrição
Entidade As entidades subjacentes para o resultado.
fragmento Um fragmento de texto curto relevante para o resultado, com termos correspondentes à consulta especificada realçada com a marca HTML <em>. Determinados tipos de consulta não oferecem suporte a fragmentos realçados, como consultas difusas (~) e consultas com curinga (*). Esta propriedade é nula nesses casos.
Identificação A ID da tabela do Dataverse do registro subjacente do resultado, como uma cadeia de caracteres. Por exemplo, 936DA01F-9ABD-4d9d-80C7-02AF85C822A8
logical_name O nome lógico da tabela do Dataverse do registro subjacente do resultado. Por exemplo, adx_webpage
número O número do resultado, em todas as páginas de resultados, começando com 1. Por exemplo, o primeiro resultado da segunda página de resultados, com um tamanho de página igual a 10, este valor será 11.
pontuação A contagem de resultados Lucene, como um valor de ponto flutuante. Os resultados são retornados e ordenados por esse valor.
cargo O título do resultado.
url A URL do resultado. Em geral, mas não necessariamente, esse será um caminho absoluto para o aplicativo atual, e não uma URL completa. Por exemplo: /articles/article1/

configurações

Permite carregar qualquer configuração de site por nome. Se uma configuração com um determinado nome não for encontrada, null será retornado.

Observação

As configurações são retornadas como cadeiras de caracteres, mas você pode usar filtros de tipo para convertê-las para outros 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 %}

Observação

Renderizar um cabeçalho de site e uma barra de navegação primária

sitemap

Permite 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
Atual Retorna o objeto do nó do mapa do site da página atual.
Raiz Retorna o objeto do nó do mapa do site da página (home page) raiz do site.

Atributos do nó do mapa do site

Atributo Descrição
Trilhas de navegação Retorna os objetos de nó de mapa do site da trilha do nó, começando no nó raiz do mapa do site e terminado no primário.
Filhos Retorna os objetos do nó do mapa do site filho do nó.
Descrição A descrição/conteúdo de resumo do nó. (Esse campo pode conter HTML.)
Entity Retorna as entidades subjacentes do nó. Se o nó não tiver uma tabela subjacente, esse valor será nulo.
is_sitemap_ancestor Retorna verdadeiro se o nó do mapa do site for um ancestral do nó atual; caso contrário, retornará falso.
is_sitemap_current Retorna verdadeiro se o nó do mapa do site for o nó atual; caso contrário, retornará falso.
Primário Retorna o nó de mapa do site pai do nó. Se o nó for o nó raiz, o primário será nulo.
Tĩtulo O título do nó.
url A URL do nó.

marcadores de site

Permite a você carregar qualquer marcador de site por nome. Se o marcador de site existir, será retornado um objeto de marcador de site. Se marcador de site com um determinado nome não for encontrado, será retornado 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 %}

Observação

Renderizar um cabeçalho de site e uma barra de navegação primária

Atributos de marcador de site

Atributo Description
url A URL de destino do marcador de site.
[nome lógico do atributo] Você pode acessar qualquer atributo do registro do Dataverse de objetivo do marcador de site por nome lógico. Por exemplo, {{ sitemarker.adx_name }}

snippets

Permite a você carregar qualquer trecho de código de conteúdo por nome. Se um trecho com um determinado nome não for encontrado, será retornado nulo.

{{ snippets[Header] }}

{% assign footer = snippets[Footer] %}

{% if footer %}

{{ footer }}

{% else %}

No footer snippet was found.

{% endif %}

tablerowloop

Contém propriedades úteis dentro de um bloco de loop Marcas de iteração.

Observação

O tablerowloop só pode ser usado em uma marca de marcas de iteração.

Atributos

Atributo Descrição
Col Retorna o índice de linha atual, começando com 1.
col0 Retorna o índice de linha atual, começando com 0.
col_first Retorna verdadeiro se a coluna atual for a primeira coluna de conclusão em uma linha, e devolve falso se não.
col_last Retorna verdadeiro se a coluna atual for a última coluna de conclusão em uma linha, e devolve falso se não.
Primeira Retorna verdadeiro se for a primeira iteração do loop. Retorna falso se não for a primeira iteração do loop.
Índice A posição do item atual na coleção, onde o primeiro item fica na posição 1.
index0 A posição do item atual na coleção, onde o primeiro item fica na posição 0.
Última Retorna verdadeiro se for a última iteração do loop. Retorna falso se não for a última iteração do loop.
Comprimento Retorna o número de iterações do loop ߝ o número de itens na coleção que está sendo iterada.
Rindex O número de itens restantes no loop (duração - índice) em que 1 é o índice do último item.
rindex0 O número de itens restantes no loop (duração - índice) em que 0 é o índice do último item.

User

Refere-se ao usuário do portal atual, permitindo acesso a todos os atributos do registro de contato do Dataverse. Se nenhum usuário estiver conectado, essa variável será nula.

O usuário é um objeto da entidade.

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

Observação

A versão de lançamento do Power Pages 9.3.8.x ou posterior terá o filtro do Liquid escape imposto para os objetos do Liquid usuário e solicitação. Para desabilitar essa configuração padrão e permitir esses objetos do Liquid sem o filtro Liquid escape, consulte as configurações do site do portal – Site/EnableDefaultHtmlEncoding.

Atributos

Além de ter todos os atributos de um objeto entidade, o usuário tem os seguintes atributos.

Atributo Descrição
funções Retornar as funções às quais o usuário pertence, como matriz.
{% if user.roles contains 'Administrators' %} User is an administrator. {% endif %}
Observação: você também pode usar o filtro has_role para testar associações de funções individuais.
basic_badges_url Retorna a URL do serviço para recuperar os selos de um usuário.
Para renderizar selos para um usuário, você deve incluir uma marca com os atributos "data-badge" e "data-uri". Para renderizar os selos do usuário atual:
<div data-badge data-uri='{{user.basic_badges_url }}'></div>
Para renderizar selos de um usuário por ID (userid variável):
`<div data-badge data-uri='{{user.basic_badges_url

Permite carregar qualquer link da Web por nome ou ID.

Se o conjunto de links da Web existir, será retornado um objeto de conjunto de links da Web. Se um conjunto de links da Web com um determinado nome ou ID não for encontrado, será retornado 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 %}

Observação

Renderizar um cabeçalho de site e uma barra de navegação primária |

Observação

Um conjunto de links da Web é um objeto de entidade, com os mesmos atributos, além dos listados para os seguintes atributos:

Atributo Description
Copiar O texto HTML do conjunto de links da Web.
Nome O nome do conjunto de links da Web.
Cargo O título do conjunto de links da Web.
Weblinks A matriz de objetos de links da Web associados ao conjunto de links da Web.
[nome lógico do atributo] Você pode acessar qualquer atributo do registro do Dataverse de conjuntos de links da Web por nome lógico. Por exemplo, {{ weblinkset.createdon }}

Observação

Um link da Web é um objeto de entidade, com os mesmos atributos, além dos listados para os seguintes atributos:

Atributo Description
Description A descrição HTML do link da Web.
display_image_only Atributo booliano que indica se o link da Web deve ser exibido apenas como imagem, sem texto.
display_page_child_links Atributo booliano que indica se o link da Web deve exibir links para as páginas filho do mapa do site da página vinculada como sublinks.
Image O objeto da imagem do link da Web para este link. O atributo será nulo, se não houver nenhuma imagem.
is_external Atributo booliano que indica se a URL de destino do link da Web é destinada a um site externo (e não a uma página interna do portal).
is_sitemap_ancestor Retorna verdadeiro se a URL de weblink referenciar um ancestral do nó do mapa do site atual; caso contrário, retornará falso.
is_sitemap_current Retorna verdadeiro se a URL de weblink referenciar o nó do mapa do site atual; caso contrário, retornará falso.
Nome O nome/título do link da Web.
Nofollow Atributo booliano que indica se o link da Web deve ser marcado como rel=nofollow.
open_in_new_window Atributo booliano que indica se o link da Web deve ser aberto em uma nova janela/guia do navegador quando selecionado.
Dica de ferramenta Texto da dica de ferramenta do link da Web.
URL A URL do link da Web.
Weblinks A matriz de objetos de link da Web filho associados ao link da Web.
[nome lógico do atributo] Você pode acessar qualquer atributo do registro do Dataverse de links da Web por nome lógico. Por exemplo, {{ weblink.createdon }}
alternate_text Texto alternativo para a imagem.
Height Inteiro que contém a altura especificada da imagem. Se nenhum valor de altura tiver sido fornecido, o atributo será nulo.
url A URL da imagem.
Espessura Inteiro que contém a largura especificada da imagem. Se nenhuma largura tiver sido fornecida, o atributo será nulo.

website

Refere-se ao site do portal, permitindo acesso a todos atributos do registro do site Dataverse (adx_website) para o portal.

Observação

O site é um objeto entidade, com todos os mesmos atributos.

Código

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

Saída

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

Atributos

A tabela a seguir lista os atributos para esta tag que podem ser usados substituindo os padrões para evitar o armazenamento em cache.

Padrão Substituto (evita cache) Exemplo
sign_in_url sign_in_url_substitution Padrão: website.sign_in_url: /en-US/SignIn?returnUrl=%2Fen-US%2F
Substituição (evita cache): website.sign_in_url_substitution: /en-US/SignIn?returnUrl=%2Fen-US%2Fsubstitute-page%2F
("página substituta" neste exemplo substitui o URL padrão em cache.)
sign_out_url sign_out_url_substitution Padrão: website.sign_out_url: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2F
Substituição (evita cache): website.sign_out_url_substitution: /en-US/Account/Login/LogOff?returnUrl=%2Fen-US%2Fsubstitute-page%2F
("página substituta" neste exemplo substitui o URL padrão em cache.)

Confira também

Tipos do Líquido
Marcas do Líquido
Filtros do Líquido