Exercício: exibir uma lista de contas

Concluído

A finalidade deste laboratório prático é acessar dados do Microsoft Dataverse usando o 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 Power Platform permite que dados de exemplo sejam adicionados 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 é que você aprenda a:

  • Inserir código do Liquid como parte do conteúdo da página.

  • Acessar os dados do Dataverse usando o Liquid.

  • Adicionar instruções condicionais para exibir somente os dados disponíveis.

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 disponível, siga as instruções de Criar um site com o Power Pages.

  • Acesse o estúdio de design do Power Pages.

Etapas de alto nível

Neste exercício, você exibirá registros selecionados do Dataverse adicionando código HTML e Liquid à seção de cópia da página da Web usando o editor de código do estúdio de design do Power Pages.

  1. Abra seu site no estúdio de design do Power Pages.

  2. Adicione uma página da Web Fornecedores.

  3. Adicione código HTML e do Liquid que lista todas as contas ativas.

  4. Visualize os resultados no estúdio de design e em um navegador.

  5. Adicione permissões de Leitura à tabela de contas e confira os resultados em um navegador.

Etapas detalhadas

Siga as etapas detalhadas nesta seção para concluir o exercício.

Inicie o estúdio de design do Power Pages

Siga estas etapas para iniciar o estúdio de design do Power Pages:

  1. Entre no Power Pages.

  2. Selecione o ambiente correto no canto superior direito.

  3. Selecione o site e, depois, Editar.

Crie a página da Web Fornecedores

Para criar a página da Web Fornecedores, siga estas etapas:

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

  2. Selecione + Página.

    • Insira Fornecedores como o nome da página.

    • Selecione o modelo Iniciar em branco.

    • Selecione Adicionar.

Editar o código-fonte

Para editar o código-fonte para listar todas as contas ativas, siga estas etapas:

  1. Selecione o conteúdo na tela da página e adicione um componente de texto.

  2. Substitua o espaço reservado do componente pelo seguinte texto:

    <h2>List of accounts</h2>
    {% entityview logical_name:'account', name:'Active Accounts' %}
    <p>We have {{ entityview.total_records }} accounts.</p>
    <ul>
      {% for account in entityview.records -%}
      <li>{{ account.name }}
        {% if account.telephone1 %}
        (<a href="tel:{{ account.telephone1 }}">{{ account.telephone1 }}</a>)
        {% endif %}
      </li>
      {% endfor %}
    </ul>
    {% endentityview %}
    
  3. Selecione Sincronizar.

  4. A lista de contas atuais deve ser exibida na tela da página, inclusive números de telefone com hiperlinks onde estão presentes.

    Importante

    O estúdio de design permite que você entre no Liquid usando um componente de texto padrão. Depois de salvar e sincronizar a página, o Power Pages converterá o componente de texto em um componente avançado, indicando que a edição em linha não está mais disponível. Você ainda pode acessar o código Liquid no editor do Visual Studio Code, que pode ser iniciado selecionando o botão Editar código.

  5. Selecione Visualizar > Área de Trabalho. A página da Web exibida só deve conter o texto "Temos 0 contas".

    Observação

    Esse resultado é esperado porque, no runtime, o Power Pages negará o acesso às linhas da tabela, a menos que exista um registro de permissão da tabela para permitir o acesso aos dados.

Adicionar permissões de tabela

Para exibir a lista de registros de contas ao navegar em uma página, você precisará adicionar permissões de tabela.

Aviso

Neste exercício, você adicionará permissões globais de leitura na tabela Conta para todos os visitantes. Essa não é uma configuração de segurança típica; é usada apenas para fins de demonstração.

Para adicionar permissões de tabela, siga estas etapas:

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

  2. Selecione + Novo.

  3. Insira os seguintes valores:

    • Nome: Fornecedores

    • Tabela: selecione a tabela 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.

  7. Selecione Visualizar > Área de Trabalho.

    Uma lista das contas deve ser exibida.