Marcas de modelo

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.

As marcas de modelo controlam a saída de um modelo de várias maneiras e permitem a combinação de vários modelos em uma única saída.

fetchxml

Permite ao usuário consultar dados do Microsoft Dataverse e renderizar os resultados em uma página.

Observação

Você pode saber mais sobre como consultar os dados usando fetchxml em usar FetchXML para consultar dados.

{% fetchxml resultVariable %}
<!— Fetchxml query -->
...
{% endfetchxml %}

Ao usar fetchxml para consultar dados, não use marcas de fechamento automático. Por exemplo, em vez de<attribute name="title"/>, use <attribute name="title"></attribute> com </attribute> da marca de fechamento explícita.

Atributo Results

O atributo Results na variável fornecida (como 'resultVariable' no exemplo acima) contém os resultados da consulta do FetchXML e alguns outros atributos.

• Entidades

  Esse atributo contém o resultado da consulta fetchxml. Você pode iterar o resultado e usá-lo em seu modelo da Web.

  <table> 
  {% for entityVariable in resultVariable.results.entities %} 
  <tr> 
  <td>Attribut-1: {{ entityVariable.attribute1 }}</td> 
  <td>Attribut-2: {{ entityVariable.attribute2 }}</td> 
  </tr> 
  {% endfor %} 
  </table> 
  

• TableName

  Obtém o nome lógico da entidade.

• ExtensionData

  Obtém a estrutura que contém dados extras.

• MinActiveRowVersion

  Obtém o valor mais baixo da versão da linha ativa.

• MoreRecords

  Mostra se há mais registros disponíveis.

• PagingCookie

  Obtém as informações atuais de paginação.

• TotalRecordCount

  Obtém o número total de registros na coleção.
  ReturnTotalRecordCount era verdadeiro quando a consulta foi executada.

• TotalRecordCountLimitExceeded

  Mostra se os resultados da consulta excedem a contagem total de registros.

Atributo XML

O atributo XML na variável fornecida (como 'resultVariable' no exemplo acima) contém a consulta resultante, que pode ser usada para obter dados de Microsoft Dataverse. Este atributo é útil para fins de depuração quando você deseja entender como a permissão de tabela está sendo aplicada nesta marca fetchxml.

Outros elementos e atributos compatíveis

A tag fetchxml liquid é compatível com os seguintes atributos e elementos filhos.

Elemento/elemento filho	Atributos	Elemento filho
fetch	mapping versão contagem page paging-cookie utc-offset aggregate distinct min-active-row-version output-format returntotalrecordcount no-lock	order entity
order	atributo alias decrescente
entity	name all-attributes no-attrs atributo	order filter link-entity
filter	type hint isquickfindfields	condition filter
link-entity	name de até alias link-type visível interseção all-attributes no-attrs atributo	order filter link-entity
condition	column entityname atributo operador aggregate alias uiname uitype uihidden value	value

incluir

Incluem o conteúdo de um modelo em outro, por nome. Nos portais do Power Apps, a origem deste outro modelo geralmente será um modelo da Web. Isso permite a reutilização de informações do modelo comuns em diversos locais.

Quando um modelo está incluso em outro, o modelo incluído terá acesso a outras variáveis definidas no modelo principal.

{% include 'My Template' %}

Também é possível passar qualquer número de parâmetros nomeados à marca incluída. Estes serão definidos nas variáveis no modelo incluído.

{% include 'My Template' a:x, b:y %}

bloquear

Feito em conjunto com estender para fornecer a herança modelo. Confira extends para uso.

estender

Feita em conjunto com a marca de bloqueio, fornece a herança modelo. Isso permite que vários modelos utilizem o layout compartilhado, substitua as áreas específicas do layout principal.

Nos portais do Power Apps, o nome do modelo principal fornecido para a marca geralmente se refere ao nome de um modelo da Web.

Quando extends é usado, deve ser o primeiro conteúdo no modelo, e só pode ser seguido por uma ou mais marcas de bloqueio.

Se um pacote primário definido no modelo não é substituído, seu conteúdo do modelo primário (se for o caso) será renderizado.

comentário

Permite manter o código não renderizado dentro de um modelo Líquido. Qualquer conteúdo no tópico não será renderizado, e qualquer código do Líquido não será executado.

Código

Hello{% comment %}, {{ user.fullname }}{% endcomment %}. My name is Charles.

Saída

Hello. My name is Charles.

bruto

Permite a saída do código Líquido em uma página sem ter de analisar ou executá-la.

Saída

Hello, {{ user.fullname }}. My name is Charles.

substituição

Quando você habilita o cache de cabeçalho e rodapé e deseja evitar o cache de determinada saída de seção, pode usar esta tag. Essa marca fornece o bloco de conteúdo no cabeçalho ou rodapé em que a saída do bloco de conteúdo encapsulado não é armazenada em cache. Isso é útil nos cenários em que o usuário utiliza um objeto que pode ser atualizado com frequência, como solicitação, página, idioma e data. Por exemplo, consulte os cenários de atualização do código-fonte do modelo da Web de cabeçalho e rodapé quando o cache de cabeçalho e rodapé está habilitado.

Dica

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.

codecomponent

Consulte Entenda a marca da entidade do Dataverse de codecomponent, Use componentes de código da Marca de modelo líquido.

Confira também

Marcas de fluxo de controle
Marcas de iteração
Marcas de variável
Marcas de entidade do Power Apps Dataverse
Usar componentes da marca de modelo do Liquid

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