Compartilhar via


Marcas de modelo

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 aprender mais sobre como consultar os dados usando fetchxml em use 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 de resultados na variável fornecida (como 'resultVariable' no exemplo acima) contém FetchXML resultados da consulta 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 do 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
version
count
page
paging-cookie
utc-offset
aggregate
distinct
min-active-row-version
output-format
returntotalrecordcount
no-lock
order
entity
order attribute
alias
decrescente
entity name
all-attributes
no-attrs
atributo
order
filter
link-entity
filter type
hint
isquickfindfields
condition
filter
link-entity name
from
to
alias
link-type
visible
intersect
all-attributes
no-attrs
atributo
order
filter
link-entity
condition column
entityname
attribute
operator
aggregate
alias
uiname
uitype
uihidden
value
value

incluir

Incluem o conteúdo de um modelo em outro, por nome. No Power Pages, a origem deste outro modelo geralmente será um modelo da Web. Este operador permite a reutilização de fragmentos 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 parâmetros serão definidos como variáveis no modelo incluído.

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

block

Usado com extends para fornecer a herança modelo. Confira extends para uso.

extends

Usado com a marca block, fornece a herança modelo. Este operador permite que vários modelos utilizem o layout compartilhado, substituindo as áreas específicas do layout principal.

No Power Pages, o nome do modelo principal fornecido para a marca em geral 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 bloco definido no modelo principal não for substituído, o conteúdo do modelo principal (caso exista) será renderizado.

comment

Permite manter o código não renderizado em um modelo Liquid. Qualquer conteúdo no bloco não será renderizado, e qualquer código Liquid não será executado.

Code

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. Este operador é ú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 Liquid.

Confira também

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