Etiquetas de modelos

Nota

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

As etiquetas de modelo controlam o resultado de um modelo de várias formas e permitem a combinação de vários modelos num único resultado.

fetchxml

Permite ao utilizador consultar os dados do Microsoft Dataverse, e compor os resultados numa página.

Nota

Pode obter mais informações sobre como consultar os dados com fetchxml em utilizar FetchXML para consultar os dados.

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

Ao utilizar o fetchxml para consultar dados, certifique-se de que não utiliza etiquetas de fecho de si mesmos. Por exemplo, em vez de <attribute name="title"/>, utilizar <attribute name="title"></attribute> com etiqueta de fecho explícita </attribute>.

Atributo de resultados

O atributo de resultados na variável fornecida (por exemplo, "resultVariable" no exemplo acima) retém os resultados da consulta FetchXML e mais alguns atributos.

• Entidades

  Este atributo contém o resultado da consulta fetchxml. Pode iterar o resultado e utilizá-lo no seu modelo 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 adicionais.

• MinActiveRowVersion

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

• MoreRecords

  Obtém se existem mais registos disponíveis.

• PagingCookie

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

• TotalRecordCount

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

• TotalRecordCountLimitExceeded

  Obtém se os resultados da consulta excederem a contagem total de registos.

Atributo XML

O atributo XML na variável fornecida (por exemplo, "resultVariable" acima) contém a consulta resultante que pode ser utilizada para obter dados a partir do Microsoft Dataverse. Este atributo é útil para depurar o propósito quando pretende compreender como a permissão de tabela está a ser aplicada nesta etiqueta fetchxml.

Outros elementos e atributos suportados

A etiqueta liquid fetchxml suporta os seguintes atributos e elementos subordinados.

Elemento/Elemento subordinado	Atributos	Elemento subordinado
obter	mapeamento versão contagem página paging-cookie utc-offset aggregate distinct min-active-row-version output-format returntotalrecordcount no-lock	ordenar entidade
ordenar	atributo alias descendente
entidade	nome all-attributes no-attrs atributo	ordenar filtrar link-entity
filtrar	tipo hint isquickfindfields	condição filtrar
link-entity	nome de para alias link-type visível interseção all-attributes no-attrs atributo	ordenar filtrar link-entity
condição	colunas entityname atributo operador aggregate alias uiname uitype uihidden valor	valor

incluir

Inclui os conteúdos de um modelo noutro, pelo nome. Nos portais do Power Apps, normalmente a origem deste outro modelo será um modelo Web. Isto permite a reutilização dos fragmentos de modelo comuns em vários locais.

Quando um modelo é incluído noutro, o modelo incluído terá acesso a quaisquer variáveis definidas no modelo principal.

{% include 'My Template' %}

Também é possível transmitir qualquer número de parâmetros nomeados para a etiqueta include. Em seguida, estes serão definidos como variáveis no modelo incluído.

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

block

Utilizado em conjunto com extends para fornecer a herança de modelo. Consulte extends para conhecer a utilização.

extends

Utilizado em conjunto com a etiqueta block, fornece a herança de modelo. Isto permite que vários modelos utilizem um esquema partilhado, ao mesmo tempo que definem manualmente as áreas específicas do esquema principal.

Nos portais do Power Apps, normalmente o nome do modelo principal fornecido à etiqueta fará referência ao nome de um modelo Web.

Quando é utilizado extends , tem de ser o primeiro conteúdo no modelo e só pode ser seguido por uma ou mais etiquetas block.

Se um bloco definido no modelo principal não for definido manualmente, será composto o respetivo conteúdo no modelo principal (se existir).

comentário

Permite deixar o código não composto dentro de um modelo Liquid. Qualquer conteúdo dentro do bloco não será composto e código da linguagem Liquid dentro dele não será executado.

Código

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

Saída

Hello. My name is Charles.

raw

Permite a saída de código Liquid numa página sem que seja analisado ou executado.

Saída

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

substituição

Quando ativar a colocação em cache do cabeçalho e do rodapé e quiser evitar a colocação em cache de determinadas saídas de secção, pode utilizar esta etiqueta. Esta etiqueta fornece o bloco de conteúdo no cabeçalho ou rodapé no qual a saída do bloco de conteúdo quebrado não é colocado em cache. Isto é útil nos cenários em que o utilizador está a utilizar um objeto que pode ser atualizado com frequência, tal como pedido, página, idioma e data. Por exemplo, consulte os cenários de atualização do código-fonte do modelo de origem quando o cache de cabeçalho e rodapé está ativado.

Gorjeta

O URL utilizado no request.url pode ser qualquer valor solicitado e fica em cache para pedidos subsequentes. Para garantir o valor correto em request.url, considere a utilização da etiqueta de substituição, URL parcial como ~{Caminho do WebFile} ou armazenamento do URL do portal nas Definições do Site.

codecomponent

Consulte Compreender a etiqueta de entidade do Dataverse codecomponent, Utilizar componentes de código da etiqueta de modelo Liquid.

Consulte também

Etiquetas de fluxo de controlo
Etiquetas de iterações
Etiquetas de variáveis
Etiquetas de entidade do Power Apps Dataverse
Utilizar a etiqueta de modelo Liquid dos componentes de código

Nota

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

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