Como vincular listas do SharePoint usando campos de pesquisaHow to link SharePoint lists using lookup fields

Este tutorial mostra como é possível conectar duas listas do SharePoint com campos de pesquisa.This tutorial shows how you can connect two SharePoint lists with lookup fields.

Visão geralOverview

O SharePoint fornece dois tipos de campos de pesquisa:SharePoint provides two types of lookup fields:

  • Pesquisa: links para outra lista: por exemplo, uma lista de Pedidos pode ter um campo de pesquisa que vincula aos clientes em uma lista de Cliente;Lookup: links to another list: for example an Orders list may have a lookup field that links to customers in a Customer list;
  • Seleção: ao clicar ou tocar no campo, um pequeno menu de itens será exibido, e você pode selecioná-los.Choice: clicking or tapping the field displays a small menu of items that you choose from.

Neste tutorial, você aprenderá a criar um aplicativo que usa esses tipos de campos de pesquisa.In this tutorial, you build an app that uses these kinds of lookup fields.

Para que são usados os campos de pesquisa?What do you use lookup fields for?

Os dados em uma empresa são grandes e complexos.Data in an enterprise is large and complex. Os dados em uma lista do SharePoint geralmente são relacionados aos dados em outra lista.Data in one SharePoint list often relates to data in another list. Os campos de pesquisa são a principal forma de reunir tais dados corporativos.Lookup fields are the primary way such business data comes together.

Por exemplo, você pode ter uma lista de Pedidos com um campo de pesquisa vinculando-a à lista de Clientes, mostrando qual cliente fez qual pedido.For example, you might have an Orders list which has a lookup field that links to a Customers list, to show which customer placed the order. O campo de pesquisa na lista Pedidos permite que você também acesse outros dados da lista Clientes.The lookup field in the Orders list lets you get other data from the Customers list as well. Você também pode usar um campo de pesquisa para conectar a lista Pedidos à lista Produto e exibir as informações que você precisa sobre o produto solicitado, como imagens, especificações, detalhes do fabricante, etc.You might also use a lookup field to connect the Orders list to a Product list, and bring in information you need about the product ordered, such as product pictures, specifications, manufacturer details, etc.

Para que são usados os campos de Seleção?What are Choice fields used for?

Os campos de Seleção são usados para listas muito curtas, mas em vez de criar uma lista separada, você inclui os valores da lista em um pequeno menu que aparece quando você clica ou toca no campo Seleção e seleciona um dos valores.Choice fields are used for very short lists, but instead of actually creating a separate list, you include the list values in a small menu, which appears when you click or tap on the Choice field, and you select one of the values.

Exemplos incluem dados como código de status do cliente, disponibilidade do produto, códigos de status; basicamente, qualquer lista fixa que seja relativamente curta.Examples include data like Customer Status Code, Product Availability, State Codes; basically any fixed list that is relatively short. Esses dados poderiam ser implementados como listas separadas, e você usaria um campo de Pesquisa para vinculá-los, mas costuma ser mais fácil e rápido implementá-los como campos de Seleção.This data could in fact be implemented as separate lists, and then you would use a Lookup field to link to them, but it is usually easier and quicker to implement them as Choice fields.

Criar as listas no SharePointCreate the lists in SharePoint

Neste tutorial, você vinculará duas listas personalizadas do SharePoint, Assets e RepairShop.In this tutorial, you link two SharePoint custom lists together, Assets and RepairShop. A lista Assets é usada para monitorar o equipamento de hardware em uma equipe.The Assets list is used to track hardware equipment in a team. Como o hardware é danificado de tempos em tempos, usamos a lista RepairShop para monitorar as lojas locais que podem realizar o reparo.Since hardware gets broken from time to time, we use the RepairShop list to track the local shops which can fix it.

Campos de pesquisa usados neste exemploThe lookup fields used in this example

A lista RepairShop usa o campo ContactEmail para identificar a loja.The RepairShop list uses the ContactEmail field to identify the shop. Essa lista é definida primeiro para que cada linha da lista Assets tenha algo para apontar.This list is defined first so that each row in the Assets list has something to point to.

A lista Assets tem dois campos de pesquisa:The Assets list has two lookup fields:

  • um chamado RepairShop, do tipo pesquisa, que usa endereços de email para apontar entradas na lista RepairShop;one called RepairShop, of type Lookup, which uses email addresses to point to entries in the RepairShop list;
  • um chamado AssetType, do tipo Seleção, que lista os tipos de hardware que esse ativo pode ser.one called AssetType, of type Choice, which lists the kinds of hardware that this asset might be.

Você pode definir campos adicionais, dependendo das informações que você precisa monitorar.You most likely would define additional fields, depending on the information you need to track.

Definir a lista RepairShop e adicionar dadosDefine the RepairShop list and add data

Faça isso primeiro, para que ao adicionar dados à lista Assets, as entradas da lista RepairShop estejam disponíveis para você escolher do campo de pesquisa Assets.RepairShop.You do this first, so that when you add data to the Assets list, RepairShop entries are available for you to choose from the Assets.RepairShop lookup field.

  1. No seu site do SharePoint, crie uma nova lista RepairShop.On your SharePoint site, create a new RepairShop list.

  2. Adicione um campo ContactEmail do tipo Única linha de texto.Add a ContactEmail field of type Single line of text.

  3. Adicione outros campos desejados.Add any other fields you need.
  4. Clique ou toque em +Novo para inserir dados de exemplo na lista, pelo menos 3 linhas com valores diferentes de ContactEmail.Click or tap + New to enter sample data into the list, at least 3 rows with different ContactEmail values. Quando um ativo precisar ser reparado, escolha uma destas opções.When an asset needs to be repaired, you choose one of these.

Definir a lista AssetsDefine the Assets list

  1. No seu site do SharePoint, crie uma nova lista Assets.On your SharePoint site, create a new Assets list.
  2. Clique ou toque no sinal de mais e selecione Mais.Click or tap the plus sign and choose More.

  3. Adicionar um campo AssetType do tipo Seleção e na caixa de texto Digite cada opção em uma linha separada, preencha os valores que você deseja exibir no menu de opções.Add an AssetType field of type Choice, and in the Type each choice on a separate line text box, fill in the values you want to appear in the choice menu. Clique ou toque em OK.Then click or tap OK.
  4. Comece a adicionar outro campo, assim como na etapa 2: clique ou toque no sinal de mais e selecione Mais.Start to add another field, just like in step 2: click or tap the plus sign and choose More.
  5. Adicionar um campo RepairShop do tipo Pesquisa, selecionar RepairShop da caixa de texto Obter informações de e selecionar ContactEmail da caixa de texto Nesta coluna.Add a RepairShop field of type Lookup, choose RepairShop from the Get information from text box, and choose ContactEmail from the In this column text box. Clique ou toque em OK.Then click or tap OK.
  6. Adicione os campos adicionais desejados.Add any additional fields you want.

Criar um aplicativo da lista AssetsCreate an app from the Assets list

Use este aplicativo para adicionar dados à lista Assets.You use this app to add data to the Assets list.

  1. Abra o PowerApps Studio.Open PowerApps Studio. Se você for novo no PowerApps, inscreva-se gratuitamente usando o seu endereço de email organizacional e siga as instruções para baixar o PowerApps Studio na Windows Store.If you are new to PowerApps, sign up for free using your organizational email address and follow the instructions to download PowerApps Studio from the Windows store.
  2. No menu Arquivo (na borda esquerda), clique ou toque em Novoe, em seguida, clique ou toque em SharePoint.In the File menu (along the left edge), click or tap New, and then click or tap SharePoint.

  1. Escolha seu site do SharePoint na lista de Sites recentes ou insira a URL do site diretamente na caixa de texto.Choose your SharePoint site from the Recent sites list or enter your site's url directly into the text box. Clique ou toque em IR.Click or tap GO.

  1. Escolha a lista principal de seu site do SharePoint, neste exemplo, Assets.Choose the main list from your SharePoint site, in this example, Assets. Clique ou toque no botão Conectar no canto inferior direito.Click or tap the Connect button in the lower-right corner.

Adicionar dados à lista AssetsAdd data to the Assets list

Agora você pode executar o aplicativo e ver a aparência da tela de detalhes para os campos de pesquisa.Now you can run the app and see how the view details screen looks for the lookup fields.

  1. Pressione F5 ou selecione Visualizar ().Press F5 or select Preview ( ).
  2. Clique ou toque no símbolo + no canto superior direito para adicionar uma entrada.Click or tap the + symbol in the upper right corner to add an entry.
  3. Insira um Título para esse ativo.Enter a Title for this asset.
  4. Clique ou toque na seta suspensa AssetType.Click or tap the AssetType dropdown arrow. Os valores exibidos são aqueles fornecidos por você ao criar esse campo.The values displayed are those you entered when you created this field. Escolha uma das entradas.Choose one of the entries.

  5. Clique ou toque na seta suspensa RepairShop.Click or tap the RepairShop dropdown arrow. Escolha uma das entradas.Choose one of the entries.

  6. No canto superior direito, clique ou toque na marca de seleção para salvar a nova entrada.In the upper-right corner, click or tap the check mark to save the new entry.
  7. (opcional) Repita este procedimento para adicionar quantos itens desejar à lista.(optional) Repeat this procedure to add as many items to the list as you want.
  8. Pressione Esc para retornar ao espaço de trabalho padrão.Press Esc to return to the default workspace.

Para obter mais informaçõesFor more information