Etiquetas de modelos

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 true 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" na amostra 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 cookie de paginação utc-offset agregação distinto min-active-row-version output-format returntotalrecordcount no-lock	ordem entidade
ordenar	atributo alias descendente
entidade	nome all-attributes no-attrs atributo	ordem filtrar link-entity
filtrar	tipo sugestão isquickfindfields	condição filtrar
link-entity	nome de para alias link-type visível interseção all-attributes no-attrs atributo	ordem filtrar link-entity
condição	coluna entityname atributo operador agregação alias uiname uitype uihidden valor	valor

incluir

Inclui os conteúdos de um modelo noutro, pelo nome. No Power Pages, normalmente, a origem deste outro modelo será um modelo Web. Este operador permite a reutilização de 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. Estes parâmetros serão definidos como variáveis no modelo incluído.

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

block

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

extends

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

No Power Pages, 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. Este operador é ú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 Liquid do Dataverse
Utilizar a etiqueta de modelo Liquid dos componentes de código