Exercício: colunas de opções do Dataverse

  • 20 minutos

Neste exercício, você ajudará a Contoso a adicionar colunas de opção a uma tabela existente do Dataverse. Em seguida, você modificará o aplicativo Gerenciamento de Produtos para usar as novas colunas.

Objetivos

A meta deste exercício é aprender como:

  • Criar colunas de opção.

  • Usar dados de filtros no aplicativo usando colunas de opção.

  • Usar a função Patch() para atualizar valores de coluna.

Pré-requisito

Para concluir este exercício, você precisará de um ambiente com o Microsoft Dataverse.

Exercício 1: Importar uma solução

Neste exercício, você importará uma solução para o seu ambiente. Essa solução contém uma tabela de produtos e um aplicativo para gerenciamento de produtos.

Tarefa 1: Importar a solução inicial

Nesta tarefa, você importará uma solução para o seu ambiente.

  1. Será necessário baixar o arquivo zip para realizar este exercício. Selecione baixar quando o link abrir.

  2. Vá para o Power Apps Maker Portal e selecione o ambiente que você deseja usar neste laboratório.

  3. Selecione Soluções > Importar solução.

    Captura de tela do botão Importar solução no Power Apps.

  4. Selecione Procurar.

  5. Localize/selecione a solução ContosoProductChoiceLab_1_0_0_0.zip e Abrir.

  6. Selecione Avançar.

  7. Selecione Importar e aguarde a conclusão do processo de importação da solução.

Tarefa 2: Executar o aplicativo

Nesta tarefa, você executará o aplicativo Contoso Product Manager e adicionará linhas de produtos.

  1. Abra a solução Laboratório de Opção de Produtos da Contoso e selecione o aplicativo Contoso Product Manager. (Abra-a no modo de reprodução.)

    Observação

    Verifique as Configurações do aplicativo para garantir que a opção "Desabilitar gerenciamento de erros no nível de fórmula" está Desativada. Em Configurações, selecione Atualizações e procure "Desabilitar gerenciamento de erros no nível de fórmula" para encontrá-lo. Esse recurso agora está na seção Desativado.

  2. Em BrowseScreen1, selecione o botão Criar novo item (o ícone de mais +).

    Captura de tela do botão Criar novo produto.

  3. Insira Gadget de Medição como o Nome e selecione Salvar.

    Captura de tela do botão Salvar novo produto no Power Apps.

  4. Adicione algumas outras linhas de produto.

  5. Você deve ter pelo menos três produtos.

    Captura de tela das linhas de produto no Power Apps.

  6. Feche a janela ou a guia do navegador de aplicativos.

Exercício 2: Criar colunas

Neste exercício, você criará duas colunas de opção de tipo de dados: uma para Visibilidade de produtos e outra para Canais de vendas.

Observação

Verifique a coluna que é de tipo de dados Opção e a coluna que é de tipo de dados Opções.

Tarefa: criar colunas de opções

Nesta tarefa, você criará duas colunas de tipo de dados Opção.

  1. Vá para o Power Apps Maker Portal e selecione Soluções.

  2. Selecione a solução Laboratório de Opção da Contoso que você importou.

  3. Selecione a tabela Produto.

  4. No painel Esquema, selecione Colunas.

    Captura de tela do painel da tabela Produto com Colunas selecionado em Esquema.

  5. Na exibição Colunas, selecione + Nova coluna.

    Captura de tela da exibição Colunas e do botão Adicionar nova coluna.

  6. No painel Nova coluna à direita da tela, insira Visibilidade do produto para o Nome de exibição, selecione Opção em Tipo de dados e selecione Opção na lista suspensa.

    Captura de tela do tipo de dados de coluna Opção no Power Apps.

  7. Em Sincronizar esta opção com, selecione + Nova opção.

  8. No painel Nova opção, no lado direito da tela, digite chProductVisibility no campo Nome de exibição. Adicionar o "ch" antes do nome tornará muito mais fácil determinar que esse é um Conjunto de opções.

  9. Insira Particular para o primeiro item em Opções e selecione + Nova Opção.

    Captura de tela da opção Adicionar novo no painel Nova opção.

  10. Insira Convidar para a segunda opção e selecione + Nova opção.

  11. Insira Público e selecione Salvar.

    Captura de tela dos itens de Opção no Power Apps.

  12. Em Sincronizar esta opção com, insira chProductVisibility no campo de pesquisa para localizar/selecionar o conjunto de opções que você criou. chProductVisibility deve ser exibido agora nesse campo.

  13. Selecione Salvar, e o painel Nova coluna desaparecerá.

  14. Selecione + Nova coluna novamente.

  15. Insira Canais de vendas para o Nome de exibição, selecione Opção para Tipo de dados e selecione Opção no menu suspenso.

  16. Marque a caixa próxima a É permitido selecionar várias opções. Essa é a forma como a coluna permitirá várias opções (não se esqueça dessa etapa).

    Captura de tela do tipo de dados de coluna Opções no Power Apps.

  17. Em Sincronizar esta opção com, selecione + Nova opção.

  18. Insira chSalesChannels para o Nome de exibição e Atacado para o primeiro item e selecione + Nova opção.

  19. Insira Varejo para o segundo item e selecione + Nova opção.

  20. Insira Direto e selecione Salvar.

    Captura de tela do botão Salvar na nova coluna de opções Canais de vendas.

  21. Em Sincronizar esta opção com, insira chSalesChannels no campo de pesquisa para localizar/selecionar o conjunto de opções que você criou. chSalesChannels deve ser exibido agora nesse campo.

  22. Selecione Salvar.

Neste exercício, você modificará o formulário Editar e a galeria do aplicativo Contoso Product Manager.

Tarefa: Editar aplicativo

Nesta tarefa, você editará o aplicativo Contoso Product Manager.

  1. Se você navegou para outro local, encontre suas soluções e selecione para abrir a solução Laboratório de Opção de Produtos da Contoso. Se você ainda estiver na solução, no painel de navegação Objetos, localize/selecione Aplicativos

  2. Selecione para abrir o aplicativo Contoso Product Manager.

    Captura de tela da seção Soluções > Laboratório de Opção de Produtos da Contoso, que mostra o aplicativo Contoso Product Manager realçado.

    O aplicativo será aberto no aplicativo Studio.

  3. Na guia Exibição de árvore, expanda EditScreen1 e selecione EditForm1.

    Captura de tela do controle EditForm1 realçado na guia Modo de exibição de árvore no Power Apps.

  4. Selecione Editar campos.

    Captura de tela da opção Editar campos na guia Propriedades de EditForm1.

  5. Selecione o botão de reticências Mais ações (...) da coluna Criado em e, depois, Remover.

    Captura de tela do botão Remover selecionado na lista suspensa da coluna Criado em.

  6. Selecione + Adicionar campo.

    Captura de tela do botão Adicionar campo no painel Campos do Power Apps.

  7. Selecione as colunas Visibilidade do produto e Canal de vendas e, depois, Adicionar.

    Captura de tela da seção Escolher um campo, com colunas selecionadas e o botão Adicionar.

  8. Feche o painel Campos.

  9. Expanda BrowseScreen1 e selecione BrowseGallery1.

    Captura de tela do controle BrowseGallery1 realçado no Modo de exibição de árvore.

  10. Selecione o ícone Editar na galeria.

    Captura de tela do ícone Editar na galeria.

  11. Altere TemplateSize para 230.

    Captura de tela do TemplateSize alterado para 230.

  12. Selecione o rótulo Título na galeria e mova-o para a parte superior do modelo.

    Captura de tela da posição do controle de rótulo realçada no Power Apps.

  13. Enquanto estiver editando a galeria, selecione Inserir e expanda Entrada e, depois, Lista suspensa.

    Captura de tela da seleção de Inserir > Entrada > Menu suspenso no Power Apps.

  14. Redimensione e reposicione o controle suspenso e altere o valor de Itens da lista suspensa para a fórmula a seguir.

    Choices(Products.'Product visibility')

    Captura de tela do valor da fórmula de Itens no Power Apps.

  15. Defina o valor Padrão do controle suspenso para a fórmula a seguir.

    ThisItem.'Product visibility'

  16. Enquanto estiver editando a galeria, vá para a guia Inserir e selecione Rótulo de texto.

  17. Renomeie o rótulo Canais.

  18. Mova o rótulo Canais para abaixo do controle suspenso e redimensione-o.

  19. Defina o valor de Texto do rótulo Canais que você adicionou como a fórmula a seguir. Essa fórmula concatenará as opções selecionadas.

    Concat(ThisItem.'Sales channels',Text(Value),",")

  20. Verifique se você ainda está editando a galeria. Selecione + Inserir > Retângulo.

    Captura de tela de Inserir selecionado e da opção Retângulo realçada.

  21. Defina os valores X e Y do retângulo como 0.

  22. Defina a Largura do retângulo como 6.

  23. Defina a Altura do retângulo como 220.

  24. Defina o valor Preenchimento do retângulo como a fórmula a seguir. Essa fórmula terá uma cor de preenchimento diferente para cada opção do valor da coluna Visibilidade do produto.

    Switch(ThisItem.'Product visibility', chProductVisibility.Private, Color.Red, chProductVisibility.Public, Color.Green, chProductVisibility.Invite, Color.Blue, Color.Black)

  25. Selecione a galeria e exclua o valor OnSelect, para que o campo de fórmula FX fique em branco.

    Captura de tela do valor OnSelect exibido como vazio.

  26. Selecione NextArrow1 na galeria.

    Captura de tela do controle NextArrow2 na galeria.

  27. Defina o valor OnSelect de NextArrow1 como a fórmula a seguir.

    Navigate(DetailScreen1, ScreenTransition.None)

  28. No canto superior direito da tela, selecione Salvar.

    Captura de tela do botão Salvar no aplicativo Contoso Product Manager.

  29. Selecione Visualizar o aplicativo (ou F5).

    Captura de tela do botão Visualizar o aplicativo no Power Apps.

    O aplicativo deve ser carregado.

  30. Selecione a seta Avançar de um dos produtos.

  31. Selecione o botão Editar.

  32. Para Canal de Vendas, selecione Varejo e Direto. Para Visibilidade do produto, selecione Particular e, depois, Salvar.

    Captura de tela do botão Salvar selecionado em Produtos para salvar as informações inseridas.

  33. Selecione o botão Voltar.

  34. Selecione para abrir outro produto.

  35. Selecione Editar.

  36. Para Canais de vendas, selecione Varejo e para Visibilidade do produto, selecione Público e, depois, Salvar.

  37. Selecione o botão Voltar.

  38. Selecione para abrir outro produto.

  39. Selecione Editar.

  40. Para Canais de vendas, selecione Direto e Convite para Visibilidade do produto e, depois, Salvar.

  41. Selecione o botão Voltar.

  42. A galeria deve ser semelhante à imagem a seguir. Quando terminar de exibir os resultados, feche a versão preliminar.

    Captura de tela da galeria editada com o botão Fechar versão preliminar do aplicativo realçado.

  43. Não saia desta página.

Exercício 4: Usar filtros

Neste exercício, você filtrará as linhas da galeria por visibilidade do produto.

Tarefa: Usar um filtro

Nesta tarefa, você filtrará as linhas da galeria por visibilidade do produto.

  1. Em BrowseScreen1, selecione TextSearchBox1.

    Captura de tela do controle TextSearchBox1 no Modo de exibição de árvore no Power Apps.

  2. Altere a Width da caixa de pesquisa para a fórmula a seguir.

    Parent.Width/2

  3. Na faixa de opções, selecione Inserir e expanda Entrada e, depois, Suspenso.

    Captura de tela do controle suspenso Inserir mostrando a entrada selecionada com a opção Suspenso realçada.

  4. Renomeie o item suspenso como Filtro de visibilidade.

    Captura de tela de Renomear controle no Power Apps.

  5. Redimensione e reposicione o Filtro de visibilidade e coloque-o à direita da caixa de pesquisa.

    Captura de tela da posição do controle ao lado da pesquisa no Power Apps.

  6. Defina o valor Itens do Filtro de visibilidade como a fórmula a seguir.

    Choices(Products.'Product visibility')

  7. Defina o valor AllowEmptySelection do Filtro de visibilidade como verdadeiro.

  8. Defina o valor Padrão do Filtro de visibilidade como a fórmula a seguir.

    Blank()

  9. Na faixa de opções, selecione Inserir e expanda Ícones e, depois, Cancelar.

  10. Redimensione e reposicione o ícone e coloque-o à direita da seta suspensa.

    Captura de tela da posição do controle do ícone no Power Apps.

  11. Defina o valor OnSelect do ícone para a fórmula a seguir.

    Reset('Visibility filter')

  12. Defina o valor Visible do ícone como a fórmula a seguir.

    If(IsBlank('Visibility filter'),false,true)

  13. Selecione BrowseGallery1 e altere o valor de Itens para a fórmula a seguir. Essa fórmula altera a fórmula existente para incluir uma função Filter() que usa os valores selecionados pelo usuário.

    SortByColumns(
    Search(
        Filter([@Products],IsBlank('Visibility filter'.Selected) || 'Product visibility' = 'Visibility filter'.Selected.Value),
        TextSearchBox1.Text,
        "contoso_name"
    ),
    "contoso_name",
    If(
        SortDescending1,
        SortOrder.Descending,
        SortOrder.Ascending
    )
)

    Captura de tela da fórmula OnSelect da galeria no campo Itens.

  14. Selecione Visualizar o aplicativo (ou pressione F5).

  15. Altere o Filtro de visibilidade para Particular. A galeria deve mostrar somente os produtos particulares.

    Captura de tela dos produtos filtrados para Particular no Power Apps.

  16. Selecione o ícone X. A galeria deve mostrar todos os produtos.

    Captura de tela da galeria mostrando todos os produtos.

  17. Feche a versão preliminar.

  18. Não saia desta página.

Exercício 5: usar a fórmula Patch

Neste exercício, você usará a fórmula Patch para atualizar as linhas da tabela de produtos.

Tarefa: Usar a fórmula Patch()

  1. Expanda BrowseGallery1 e selecione o controle Dropdown1.

    Captura de tela do controle Dropdown1 no menu BrowseGallery1.

  2. Defina o valor OnChange do controle suspenso como a fórmula a seguir. Essa fórmula atualizará a linha quando o valor do controle suspenso for alterado.

    Patch(Products,ThisItem,{'Product visibility':Self.Selected.Value})

  3. Selecione a galeria e, depois, o ícone Editar.

    Captura de tela do botão Editar na galeria do Power Apps.

  4. Na faixa de opções, selecione Inserir e expanda Ícones e, depois, Cancelar.

  5. Coloque o ícone no canto inferior direito.

    Captura de tela do posicionamento do ícone no canto inferior direito.

  6. Defina o valor Visible do ícone como a fórmula a seguir.

    If(IsBlank(Channels.Text),false,true)

  7. Defina o valor OnSelect do ícone para a fórmula a seguir. Essa fórmula removerá todos os canais de vendas selecionados quando o ícone for selecionado.

    Patch(Products,ThisItem,{'Sales channels':Blank()})

  8. Selecione Visualizar o aplicativo.

  9. Altere a visibilidade de um dos produtos. O produto deve ser atualizado.

    Captura de tela da linha atualizada no Power Apps.

  10. Selecione o ícone X do primeiro produto. Os canais de vendas do produto devem ser limpos e o botão X deve ficar oculto.

    Captura de tela da linha atualizada no Power Apps mostrando um ponto em branco.

  11. Feche a versão preliminar.

  12. Selecione Salvar.