Acessar os dados do Dataverse

  • 5 minutos

Os criadores do Power Pages podem usar o HTML para criar a saída que inclui conteúdo estático. Da mesma forma, os criadores podem usar o Liquid ao trabalhar com várias páginas e conteúdo dinâmico do Microsoft Dataverse e ao fazer alterações de uma página para a outra. Os elementos do Liquid funcionam como espaços reservados; antes do envio da saída para o navegador, os elementos do Liquid são substituídos por dados do Dataverse.

O Power Pages implementa muitas extensões projetadas para funcionar com o Dataverse. Alguns objetos do Liquid específicos do Dataverse disponíveis são descritos na tabela a seguir.

Objeto Descrição
page Refere-se à página solicitação do site atual. O objeto page fornece acesso a componentes como a navegação estrutural da página atual, o título ou a URL da página atual, como {{ page.title }}, e quaisquer outras colunas ou tabelas relacionadas da linha subjacente do Power Apps.
user Refere-se ao usuário atual do site, permitindo acesso a todas as colunas da linha de contato subjacente do Power Apps. Se nenhum usuário estiver conectado, essa variável será null.
website Refere-se ao site do site, permitindo acesso a todas as colunas da linha do site do Power Apps (adx_website) para o site.
Tabelas genéricas Um objeto de tabela fornece acesso às linhas e colunas em uma tabela do Dataverse. Uma coleção de todas as tabelas é conhecida como entities. Por exemplo, {{ entities.contact[request.params.contactid].firstname }} se refere à coluna de nome na linha de contato, identificada pelo parâmetro de solicitação contactid.

Você pode usar marcas específicas do Microsoft Dataverse para carregar e exibir dados do Dataverse ou para usar outros serviços de estrutura do Power Pages. Essas marcas são extensões específicas do Dataverse para a linguagem Liquid. A tabela a seguir descreve algumas dessas marcas.

Marca Descrição
chart Adiciona um gráfico do Power Apps a uma página da Web. Para obter etapas para adicionar um gráfico do Power Apps a uma página da Web, consulte Adicionar um gráfico a uma página da Web no portal.
powerbi Adiciona painéis e relatórios do Microsoft Power BI em páginas. Para obter as etapas para adicionar um relatório ou painel do Power BI a uma página da Web no site, consulte Adicionar um relatório ou painel do Power BI a uma página da Web.
entitylist Uma marca de bloco do Liquid que carrega determinada lista, por nome ou ID. Se a lista for carregada com êxito, o conteúdo do bloco será renderizado.
entityview Uma marca de bloco do Liquid que carrega determinada exibição do Dataverse, por nome ou ID. Se a exibição for carregada com êxito, o conteúdo do bloco será renderizado.
fetchxml Permite que os usuários consultem dados do Dataverse e renderiza os resultados em uma página.
codecomponent Permite que você incorpore componentes de código usando uma marca do Liquid. Para obter mais informações, consulte Usar marca de modelo do Liquid para componentes de código.

No exemplo a seguir, a exibição Moedas Ativas está sendo carregada e todas as linhas retornadas são exibidas. No estúdio de design do Power Pages, esse código gera uma saída devido aos privilégios implícitos de tempo de design do criador. No entanto, no site, o usuário precisa ter privilégios de Leitura atribuídos na tabela de moeda para que o fragmento retorne os dados.

{% entityview logical_name:'transactioncurrency', name:'Active Currencies' %}
<p>We support {{ entityview.total_records }} currencies.</p>
<ul>
  {% for cur in entityview.records -%}
  <li>{{ cur.currencyname }}</li>
  {% endfor %}
</ul>
{% endentityview %}

A saída será semelhante ao seguinte exemplo:

Aceitamos quatro moedas.

  • Dólar australiano
  • Dólar canadense
  • Euro
  • Dólar americano

Usando o Liquid no Power Pages, você pode:

Nesses cenários, você terá acesso dinâmico a recursos do Power Pages, como configurações do site, trechos de conteúdo, listas, formulários básicos etc.

Importante

As instruções do Liquid são processadas somente como saída. O Liquid não pode estender o código do servidor que processa as interações do usuário, como envios de formulários.