Exercício: criar um modelo extensível da Web

• 20 minutos

A finalidade deste laboratório prático é apresentar o conceito de criação e extensão de modelos Liquid.

Os exercícios funcionam melhor quando você tem dados de exemplo para trabalhar. Dependendo do ambiente em que você está trabalhando, convém instalar dados de exemplo para facilitar os exercícios. O Microsoft Dataverse oferece a capacidade de adicionar dados de exemplo conforme necessário. Se o ambiente em que você está trabalhando não tiver dados de exemplo instalados, siga as etapas da documentação Adicionar ou remover dados de exemplo para instalar os dados de exemplo em seu ambiente.

Objetivos de aprendizagem

O objetivo desses exercícios é ajudar você a aprender a:

• Estender os modelos Liquid usando as marcas extend e block.
• Reutilizar os modelos Liquid usando a marca include.
• Aplicar permissões de tabela aos resultados do novo modelo.

Pré-requisitos

Neste exercício, você precisará ter os seguintes parâmetros configurados em seu ambiente:

• Um site do Power Pages provisionado. Se você não tiver um site do Power Pages disponível, siga as instruções de Criar um site com o Power Pages para criar um.
• Acesso ao aplicativo Power Pages Management.

Etapas de alto nível

Para concluir o exercício, você precisará concluir as seguintes tarefas de alto nível:

• Crie um modelo parcial acessando dados do Dataverse para usar como bloco de layout.

• Crie um novo modelo que estenda um modelo de layout de duas colunas da Web.

• Substitua o painel lateral para incluir o modelo parcial.

• Altere o modelo de uma página da Web existente.

• Configure permissões de tabela para exibir dados para usuários anônimos.

Etapas detalhadas

Para concluir o exercício, você criará um novo modelo de página que inclui um painel lateral que lista todas as contas no Dataverse.

Crie um modelo parcial

A primeira tarefa é criar um modelo parcial, que não será usado para renderizar uma página, mas será inserido em outro modelo.

1. Entre na Página inicial do Power Pages.

2. Selecione o ambiente de destino no canto superior direito.

3. Localize seu site, expanda o menu de extensão (reticências) e selecione Gerenciamento de portal para abrir o aplicativo Power Pages Management.

4. Selecione Modelos da Web.

5. Selecione Novo.

6. Insira os seguintes valores:

   • Nome: Diretório

   • Site da Web: selecione seu site atual

   • Origem: insira o seguinte conteúdo:

   {% fetchxml accounts %}
   <fetch>
     <entity name="account">
       <attribute name="name" />
     </entity>
   </fetch>
   {% endfetchxml %}
   
   {% if accounts.global_permission_granted %}
     <ul>
       {% for account in accounts.results.entities %} 
       <li>{{ account.name }}</li>
       {%- endfor -%}
     </ul>
   {% else %}
     <div class="alert alert-warning">You do not have permissions to access the directory.</div>
   {% endif %}
   

7. Selecione Salvar e Fechar.

Estenda um modelo existente

Em seguida, você criará um novo modelo que estende um modelo Liquid existente e, em seguida, inserirá o modelo criado anteriormente.

1. Selecione Modelos da Web.

2. Selecione Novo.

3. Insira os seguintes valores:

   • Nome: Modelo de Diretório

   • Site da Web: selecione seu site atual

   • Origem: insira o seguinte conteúdo:

   {% extends "Layout 2 Column Wide Left" %}
   
   {% block aside %}
     <h2>Directory</h2>
     {% include 'Directory' %}
   {% endblock %}
   

4. Selecione Salvar e Fechar.

Criar um modelo de página e associar a essa página

Nesta tarefa, você criará um modelo de página que usa seu novo modelo da Web e incluirá a Saída do diretório.

1. Selecione Modelos de Página.

2. Selecione Novo.

3. Insira os seguintes valores:

   • Nome: Modelo de Página de Diretório

   • Site da Web: selecione o site atual

   • Tipo: selecione Modelo da Web

   • Modelo da Web: selecione Modelo de Diretório

   • Nome da Tabela: selecione Página da Web

4. Opcional: adicione um elemento de texto ao conteúdo da página e insira o texto de sua escolha.

5. Selecione Salvar e Fechar.

Testar o modelo inicial

A próxima etapa é testar se o novo modelo funciona:

1. Retorne à guia início do Power Pages ou abra uma nova.

2. Localize o site e selecione Editar para abrir o estúdio de design do Power Pages.

3. Selecione Sincronizar para sincronizar as alterações.

4. Selecione o espaço de trabalho Páginas.

5. Selecione + Página. Na caixa de diálogo Adicionar uma página, conclua as seguintes etapas:

   1. Insira Diretório como o nome da página.

   2. Selecione Layouts personalizados e Modelo de Página de Diretório.

   3. Selecione Adicionar.

A página vazia será exibida com a mensagem "Você não tem permissão para acessar o diretório" no painel direito.

Adicionar permissões de tabela

Siga estas etapas para adicionar permissões de tabela.

1. Selecione Configurar espaço de trabalho e Permissões de Tabela.

2. Selecione + Novo.

3. Insira os seguintes valores:

   • Nome: Diretório da Conta

   • Tabela: selecione a tabela Conta (conta)

   • Tipo de acesso: selecione Acesso global

   • Permissão para: selecione Ler

4. Selecione Adicionar funções.

5. Selecione Usuários anônimos e Usuários autenticados.

6. Selecione Salvar.

Testar o modelo

A tarefa final é testar o novo modelo:

1. Selecione o espaço de trabalho Páginas e a página Diretório.

2. Selecione Visualizar > Área de Trabalho.

   Observação

   Uma página simples de navegador não será suficiente para atualizar os dados. Se usado em vez disso, esse comando recria o cache do site.

Agora, a página deve ser exibida e incluir a lista de contas no painel direito.