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. É 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 Contoso Product Choice Lab.

    Observação

    Verifique as Configurações do aplicativo Contoso Product Manager para garantir que a opção Desabilitar gerenciamento de erros no nível de fórmula esteja Desativada. Abra o aplicativo no modo Editar. Em Configurações, selecione Atualizações e procure Desabilitar gerenciamento de erros no nível de fórmula. (Se você não conseguir encontrar suas configurações, selecione as reticências na parte superior da página, ao lado de Cor da tela de fundo.) Esse recurso agora está na seção Desativado. Desative-o. Salve e feche seu aplicativo.

  2. Agora selecione e abra o aplicativo Contoso Product Manager no modo de execução.

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

    Captura de tela do botão Criar novo produto.

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

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

  5. Adicione algumas outras linhas de produto.

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

    Captura de tela das linhas de produto no Power Apps.

  7. 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 Product visibility e outra para Sales channels.

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 Contoso Choice Lab que você importou.

  3. Navegue até Tabelas, selecione e abra a tabela Product.

  4. No painel Esquema, selecione Colunas.

    Captura de tela do painel da tabela Product com Colunas selecionada 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 Product visibility para o Nome de exibição, selecione Opção em Tipo de dados e selecione Opção novamente 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 torna 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. É assim que nossa coluna permitirá múltiplas escolhas. (Não se esqueça desta etapa porque você não pode alterá-la mais tarde.)

    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 Contoso Product Choice Lab. 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 no modo Editar. (Selecione as reticências ao lado do nome do aplicativo e selecione Editar.)

    Captura de tela da seção Soluções > Contoso Product Choice Lab, que mostra o aplicativo Contoso Product Manager realçado.

    O aplicativo é aberto no estúdio de aplicativo.

  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 no painel Propriedades do lado direito da tela.

    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. De volta ao Modo de Exibição de Árvore no lado esquerdo do tela, 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 dentro do item superior 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 ainda edita a galeria, selecione o cartão principal novamente (para que os campos de texto e ícones dentro da guia não sejam selecionados). Em seguida, selecione Inserir na barra de menus superior, expanda Entrada e selecione Suspenso.

  14. Redimensione e reposicione o controle suspenso imediatamente abaixo do campo de nome que você acabou de posicionar na parte superior. Altere o valor 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 ainda edita a galeria, Selecione o item superior novamente (para que nenhum texto, ícone ou menu suspenso seja selecionado). 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 para a fórmula a seguir. Essa fórmula dá uma cor de preenchimento diferente para cada opção do valor da coluna Product visibility.

    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 dentro do item superior 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 ver os resultados, feche a visualização selecionando X no canto superior direito.

    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 Largura da caixa de pesquisa para a fórmula a seguir.

    Parent.Width/2

  3. Selecione BrowseScreen1 no menu Modo de exibição de árvore à esquerda. Em seguida, na faixa de opções na parte superior, selecione Inserir, expanda Entrada e selecione 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 para a fórmula a seguir.

    Blank()

  9. Selecione BrowseScreen1 no Modo de exibição de árvore no lado esquerdo mais uma vez. Em seguida, na faixa de opções, selecione Inserir, expanda Ícones e selecione Cancelar.

  10. Reposicione o ícone cancelado à direita da seta suspensa e redimensione-o.

    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,
        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 visualização.

  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 Product.

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 atualiza a linha quando o valor do controle suspenso é 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 remove todos os canais de vendas selecionados quando o ícone é 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 para esse item.

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

  11. Feche a visualização.

  12. Selecione Salvar.