Compartilhar via

Vincular listas usando uma coluna de pesquisa no Power Apps

Este tutorial mostra como você pode conectar duas listas com uma coluna de pesquisa em um aplicativo de tela no Power Apps.

O SharePoint fornece dois tipos de colunas de pesquisa:

  • Pesquisa: vincula para outra lista. Por exemplo, uma lista de Ordens pode ter uma coluna de pesquisa que é vinculada aos clientes em uma lista do Cliente.
  • Opção: ao selecionar uma coluna exibe um menu de itens que você pode escolher.

Observação

Ao criar ou exibir uma lista no SharePoint, você é redirecionado automaticamente para Listas da Microsoft. A lista sempre pode ser encontrada em Listas da Microsoft e no SharePoint. Saiba mais em O que é uma lista no Microsoft 365?

Pré-requisitos

Por que usar uma coluna de pesquisa?

Os dados em uma empresa são grandes e complexos. Os dados em uma lista geralmente estão relacionados aos dados em outra lista. As colunas de pesquisa se referem à principal forma de reunir esses dados corporativos.

Por exemplo, você pode ter uma lista de Ordens com uma coluna de pesquisa que é vinculada à lista Clientes, mostrando qual cliente fez o pedido. A coluna de pesquisa na lista Ordens permite que você acesse outros dados da lista Clientes.

Você também pode usar uma coluna de pesquisa para conectar a lista Ordens à lista Produto e exibir as informações necessárias sobre o produto solicitado, como imagens, especificações, detalhes do fabricante etc.

Para que servem as colunas de opção?

As colunasOpção são usadas para listas curtas. Em vez de criar uma lista separada, inclua os valores da lista em um pequeno menu. Esse menu aparece quando você seleciona uma coluna de Opção e, em seguida, você pode selecionar um dos valores no menu.

Exemplos incluem dados como Código de Status do Cliente, Disponibilidade do Produto, Códigos de Estado, qualquer lista fixa que seja relativamente curta.

Os dados de opção podem permanecer como uma lista separada, se você usar uma coluna de Pesquisa para vinculá-los. No entanto, uma implementação de coluna de Opção é mais fácil e rápida do que uma implementação de coluna de Pesquisa.

Saiba mais em Visão Geral da Integração do SharePoint Online no Power Apps.

Criar as listas

Neste tutorial, você vai vincular duas listas: Assets e RepairShop. A lista Assets é usada para monitorar o equipamento de hardware em uma equipe. Como o hardware é danificado de tempos em tempos, usamos a lista RepairShop para rastrear as lojas locais que podem realizar o reparo.

A coluna de pesquisa é usada neste exemplo

A lista RepairShop usa a coluna ContactEmail para identificar a loja. Essa lista é definida primeiro para que cada linha da lista de Assets aponte para algum item.

A lista Assets tem duas colunas de pesquisa:

  • RepairShop, do tipo Pesquisa, que usa endereços de email para apontar entradas na lista RepairShop.
  • AssetType, do tipo Opção, lista os tipos de ativos para hardware.

Você pode definir mais colunas, dependendo das informações a serem rastreadas.

Definir a lista RepairShop e adicionar dados

Crie esta lista primeiro, assim, ao adicionar dados à lista Assets, as entradas de RepairShop ficarão disponíveis da coluna de pesquisa Assets.RepairShop.

  1. Em qualquer site do SharePoint, crie uma nova lista RepairShop de um modelo de Lista em branco.

    Captura de tela do local de uma opção da Lista no menu Novo de um site do SharePoint.

  2. Selecione Adicionar uma coluna do tipo Texto e nomeie-a ContactEmail e, em seguida, escolha Salvar.

  3. Selecione + Adicionar novo item para inserir pelo menos três linhas com valores de amostra ContactEmail. Quando um ativo precisar ser reparado, escolha uma dessas oficinas.

    Captura de tela do local do botão Adicionar novo item em uma página do site do SharePoint.

Definir a lista Assets

  1. No mesmo site do SharePoint, crie uma nova lista Assets de um modelo da Lista em branco.

  2. Selecione + Adicionar coluna e escolha o tipo de coluna Opção. Selecione Avançar e nomeie-o AssetType. Preencha os valores de Opção na seção Opções com ativos de exemplo, como Desktop, Laptop, Telefone Android, iPhone e tablet do Windows.

    Captura de tela mostrando onde você pode definir as opções de coluna ao criar uma coluna.

  3. Selecione Salvar.

  4. Selecione + Adicionar coluna e escolha o tipo de coluna Pesquisa, em seguida, selecione Avançar.

  5. No painel Criar uma coluna, adicionar RepairShop ao campo Nome. Vá para Selecione uma lista como fonte e escolha RepairShop. Vá para Selecione uma coluna na lista acima e escolha ContactEmail.

  6. Selecione Salvar.

    Você vê que a coluna RepairShop tem um ícone de duas setas que indica que é uma coluna do tipo de pesquisa.

    Captura de tela mostrando a coluna RepairShop na lista Ativos.

Criar um aplicativo a partir da lista Assets

Crie um aplicativo de tela a partir da Lista de recursos criada antes.

Adicionar dados à lista Assets

Vamos visualizar o aplicativo e adicionar itens à sua lista Assets.

  1. Pressione F5 ou selecione Visualizar ( Ícone de visualização. ).

  2. Selecione o símbolo + no canto superior direito de seu aplicativo para adicionar uma entrada.

  3. Insira um Título para esse ativo, por exemplo Laptop de Miqueias.

  4. Selecione a seta suspensa AssetType. Os valores exibidos são fornecidos por você ao criar essa coluna. Escolha uma das entradas.

    Captura de tela que mostra a lista

  5. Selecione a seta suspensa RepairShop. Escolha uma das entradas.

    Captura de tela que mostra a lista RepairShop quando você seleciona a seta suspensa.

  6. Selecione a marca de seleção para salvar a nova entrada.

  7. (Opcional) Adicionar mais itens à lista.

  8. Pressione Esc para retornar ao espaço de trabalho padrão.

  9. Salve e publique o aplicativo.