Objetos do Liquid disponíveis
Observação
Desde o dia 12 de outubro de 2022, os portais do Power Apps passaram a ser Power Pages. Mais Informações: O Microsoft Power Pages já está disponível para todos (blog)
Em breve, migraremos e mesclaremos a documentação dos portais do Power Apps com a documentação do Power Pages.
Os objetos líquidos 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.
| Objeto | Descrição |
|---|---|
| entidades | Permite a você carregar qualquer tabela do Power Apps por ID. Para obter 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: esse valor é armazenado em cache pelo aplicativo Web do portal e não é sempre atualizado. Para obter 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 Power Apps subjacente. Para obter mais informações: página |
| params | Um atalho conveniente para request.params. Para obter mais informações: solicitação |
| request | Contém informações sobre a solicitação HTTP atual. Para obter mais informações: solicitação |
| settings | Permite carregar qualquer Configuração de site por nome. Para obter mais informações: configurações |
| sitemap | Permite acesso ao mapa do site do portal. Para obter mais informações: mapa do site |
| sitemarkers | Permite a você carregar qualquer marcador de site por nome. Para obter mais informações: marcadores de site |
| snippets | Permite carregar qualquer trecho de conteúdo por nome. Para obter mais informações: trechos |
| user | Refere-se ao usuário do portal atual, permitindo acesso a todos os atributos do registro de contato do Power Apps. Se nenhum usuário estiver conectado, essa variável será null. Para obter mais informações: usuário |
| weblinks | Permite a você carregar qualquer Conjunto de Links da Web por nome ou ID. Para obter mais informações: links da Web |
| website | Refere-se ao portal do registro do site, permitindo acesso a todos atributos de Power Apps registro de site (adx_website) do portal. Para obter mais informações: site |
ads
Oferece a capacidade de acessar e renderizar 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 | Descrição |
|---|---|
| posicionamentos | Retorna o objeto adplacements. |
| [nome e ID do anúncio] | 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 | Descrição |
|---|---|
| [posicionamento ou ID do anúncio] | 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 atributos listados abaixo.
| Atributo | Descrição |
|---|---|
| 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. |
| Nome | 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 da relação listada abaixo.
| Atributo | Descrição |
|---|---|
| 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. |
| Nome | 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 será direcionado quando selecionar o anúncio. |
Atributos de imagem de anúncio
| Atributo | Descrição |
|---|---|
| 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. |
| width | Retorna a largura em pixels da imagem |
blogs
Oferece a capacidade de acessar e renderizar 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>
–
<a href={{ post.author_url }}> {{ post.author_name }} </a>
–
<a href={{ post.application_path }}#comments>
<span class=fa fa-comment aria-hidden=true></span> {{ post.comment_count }}
</a>
</div>
</li>
{% endfor %}
</ul>
</div>
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 e ID do blog] | 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). |
| título | 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 líquido 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 Power Apps por ID. Se a tabela existir, será retornado um objeto de tabela. Se uma tabela com uma determinada ID não for encontrada, null 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 Power Apps.
| 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 Power Apps da tabela. |
| Notas | 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 de portais do Power Apps para a tabela. Se a tabela não tiver nenhuma URL válida no site atual, retorna nulo. Geralmente, retornará 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 da relação] | Você pode acessar qualquer atributo da tabela do Power Apps 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 líquidos: 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:
{{ 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 Power Apps da tabela referenciada. |
| Nome | 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 adicionais.
| Atributo | Descrição |
|---|---|
| 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 impacto 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 baixará o anexo do arquivo de anotação. |
Observação
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 | Descrição |
|---|---|
| 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 | Descrição |
|---|---|
| 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 marcas de tabela do Power Apps Dataverse. Proporciona acesso a todos os atributos de uma determinada lista.
Atributos
Observação
| Atributo | Descrição |
|---|---|
| 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 líquidos 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 Power Apps 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 será 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 líquido 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 Power Apps 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 Power Apps por nome lógico, assim como em um objeto de tabela. Por exemplo, {{ entitylist.adx_name }} |
Atributos de Lista de Exibição
| Atributo | Descrição |
|---|---|
| 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 Power Apps para os registros inclusos nele. Exemplo: contato |
| ID | Retorna a ID do GUID da exibição. |
| language_code | Retorna o código de idioma inteiro do Power Apps que será usado para selecionar todos os rótulos localizados (cabeçalhos de coluna etc.) para a exibição. |
| Nome | Devolve o nome da exibição do Power Apps da visualização. |
| primary_key_logical_name | Retorna o nome lógico da chave primária da tabela do Power Apps 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 | Descrição |
|---|---|
| attribute_type | Retorna o tipo de atributo do Power Apps 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 Power Apps para a coluna. Por exemplo, createdon |
| Nome | Retorna o nome de exibição do Power Apps 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 Power Apps 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. Será 1 a menos que nenhum resultado seja retornado; nesse caso, será nulo. |
| ID | A ID de GUID de exibição do Power Apps que define essa entityview. |
| language_code | O código de idioma do inteiro do Power Apps 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, será nulo. |
| nome | O nome da exibição do Power Apps 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, ela será nula. |
| 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, ela será nula. |
| primary_key_logical_name | O nome lógico do atributo de chave primária da tabela de resultado do Power Apps 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
Oferece a capacidade de acessar e renderizar 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 | Descrição |
|---|---|
| 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 líquidos
{% assign occurances = event.occurrences.from[today].to[advance_date] %}
observe que
{% assign occurances = event.occurrences.min[today].max[advance_date] %}
também é possível.
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. Os atributos associados são exibidos abaixo:
| Atributo | Descrição |
|---|---|
| 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.
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 |
|---|---|
| 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
Oferece a capacidade de acessar e renderizar fóruns e threads de fóruns. 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
| Atributo | Description |
|---|---|
| threads | Retorna um objeto forumthreads que contém todos os threads de fórum do fórum. |
| Nome | 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
| Atributo | Descrição |
|---|---|
| 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
| Atributo | Descrição |
|---|---|
| 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 Power Apps 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 líquidos.
{% 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 | 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 líquidos.
{% assign page_size = 5 %}
{% assign recent_categories = knowledge.categories | recent: page_size %}
| Atributo | Descrição |
|---|---|
| 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
article é um objeto entity, com os mesmos atributos, além dos relacionados abaixo.
| Atributo | Descrição |
|---|---|
| article_public_number | O Número Público do Artigo. |
| comment_count | O valor inteiro da contagem de comentários 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. |
| rating | 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
category é um objeto entity, com os mesmos atributos, além dos relacionados 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. |
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 líquido por padrão para listar os idiomas disponíveis quando vários idiomas estão disponíveis.
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 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 de página
Observação
| Atributo | Descrição |
|---|---|
| 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 principal será nulo. |
| title | O título da página. |
| URL | A URL da página. |
| [nome do atributo ou da relação] | Você pode acessar qualquer atributo do registro do Power Apps 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 líquidos: 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:
{{ 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 tabela do Power Apps Dataverse para carregar as coleções de entidades. |
votações
Oferece a capacidade de acessar e renderizar uma consulta.
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 | Descrição |
|---|---|
| posicionamentos | Devolve o objeto de posicionamento de votação. |
| [nome e 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 | Descrição |
|---|---|
| [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
| Atributo | Descrição |
|---|---|
| Nome | Retorna o campo Nome para o posicionamento de votação. |
| posicionamento_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. |
| aleatório_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
| Atributo | Descrição |
|---|---|
| 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 por usuário (se eles já votaram). |
| votos | Retorna o número de votos que foram tabulados para a votação. |
Atributos de Opção de Votação
Observação
| Atributo | Descrição |
|---|---|
| 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 foram 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
- Você pode criar URLs de forma dinâmica em Líquido usando Filtros de URL.
- A URL usada em request.url pode ser qualquer valor solicitado e obtém em cache para solicitações subsequentes. Para garantir o valor correto em request.url, considere usar etiqueta de substituição, URL parcial como ~{Caminho do WebFile } ou armazenar o URL do portal em Configurações do site.
- A versão de lançamento 9.3.8.x ou posterior dos portais do Power Apps, por padrão, terá o filtro Liquid escape aplicado para os objetos usuário e solicitação do Liquid. 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
| 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. |
| Caminho | 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 |
| query | 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 de tabela do Power Apps 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 | Descrição |
|---|---|
| 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 será null nessas ocorrências. |
| Id | A ID da tabela do Power Apps 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 Power Apps 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, será 11. |
| pontuação | A contagem de resultados Lucene, como um valor de ponto flutuante. Os resultados serão retornados e ordenados por esse valor. |
| title | 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 %}
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.) |
| Entidade | 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. |
| Cargo | 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, null será retornado.
{{ sitemarkers[Login].url }}
{% assign my_sitemarker = sitemarkers["My Site Marker"] %}
{% if my_sitemarker %}
<a href={{ my_sitemarker.url }}>{{ my_sitemarker.adx_name }}</a>
{% else %}
Site marker My Site Marker does not exist.
{% endif %}
Atributos de marcador de site
| Atributo | Descrição |
|---|---|
| URL | A URL de destino do marcador de site. |
| [nome lógico do atributo] | Você pode acessar qualquer atributo do registro do Power Apps 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, null será retornado.
{{ 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. |
Usuário
Refere-se ao usuário do portal atual, permitindo acesso a todos os atributos do registro de contato do Power Apps. Se nenhum usuário estiver conectado, essa variável será null.
O usuário é um objeto entidade.
{% if user %}
Hello, {{ user.fullname | escape }}!
{% else %}
Hello, anonymous user!
{% endif %}
Observação
A versão de lançamento 9.3.8.x ou posterior dos portais do Power Apps, por padrão, terá o filtro Liquid escape aplicado para os objetos usuário e solicitação do Liquid. 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 |
weblinks
Permite carregar qualquer link da Web por nome ou ID.
Se o conjunto de links da Web existir, um objeto de conjunto de links da Web será retornado. Se um conjunto de links da Web com um determinado nome ou ID não for encontrado, null será retornado.
<!-- Load web link set by ID -->
{{ weblinks[page.adx_navigation.id].name }}
<!-- Load web link set by name -->
{% assign nav = weblinks[Primary Navigation] %}
{% if nav %}
<h1>{{ nav.title | escape }}</h1>
<ul>
{% for link in nav.weblinks %}
<li>
<a href={{ link.url | escape }} title={{ link.tooltip | escape }}>
{% if link.image %}
<img src={{ link.image.url | escape }} alt={{ link.image.alternate_text | escape }} />
{% endif %}
{{ link.name | escape }}
</a>
</li>
{% endfor %}
</ul>
{% endif %}
Atributos do Conjunto de Links da Web
Observação
Um conjunto de links da Web é um objeto entidade, com os mesmos atributos, além dos listados abaixo.
| Atributo | Descrição |
|---|---|
| Texto | 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 Power Apps de conjuntos de links da Web por nome lógico. Por exemplo, {{ weblinkset.createdon }} |
Atributos de Links da Web
Observação
Um link da Web é um objeto entidade, com os mesmos atributos, além dos listados abaixo.
| Atributo | Descrição |
|---|---|
| Descrição | 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. |
| Imagem | O objeto da imagem do link da Web para este link. O atributo será null 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 Power Apps de links da Web por nome lógico. Por exemplo, {{ weblink.createdon }} |
Atributos de imagem de link da Web
| alternate_text | Texto alternativo para a imagem. |
|---|---|
| Altura | Inteiro que contém a altura especificada da imagem. Se nenhum valor de altura tiver sido fornecido, o atributo será null. |
| URL | A URL da imagem. |
| Largura | Inteiro que contém a largura especificada da imagem. Se nenhuma largura tiver sido fornecida, o atributo será null. |
website
Refere-se ao site do portal, permitindo acesso a todos atributos do registro do Power Apps do site (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.) |
Consulte também
Tipos do Líquido
Marcas do Líquido
Filtros do Líquido
Observação
Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)
A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de