Como ligar listas do SharePoint com campos de pesquisaHow to link SharePoint lists using lookup fields

Este tutorial mostra como pode ligar duas listas do SharePoint com campos de pesquisa.This tutorial shows how you can connect two SharePoint lists with lookup fields.

Descrição geralOverview

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

  • Pesquisa: liga a noutra lista: por exemplo, uma lista Encomendas pode ter um campo de pesquisa que contém ligações para clientes numa lista Clientes;Lookup: links to another list: for example an Orders list may have a lookup field that links to customers in a Customer list;
  • Escolha: clicar ou tocar no campo apresenta um menu pequeno dos itens que pode selecionar.Choice: clicking or tapping the field displays a small menu of items that you choose from.

Neste tutorial, irá criar uma aplicação que utiliza estes tipos de campos de pesquisa.In this tutorial, you build an app that uses these kinds of lookup fields.

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

Os dados numa empresa são grandes e complexos.Data in an enterprise is large and complex. Os dados numa lista do SharePoint estão frequentemente relacionados com os dados de outra lista.Data in one SharePoint list often relates to data in another list. Os campos de pesquisa são a forma principal de juntar esses dados empresariais.Lookup fields are the primary way such business data comes together.

Por exemplo, poderá ter uma lista Encomendas que tem um campo de pesquisa que liga a uma lista Clientes, para mostrar o cliente que fez a encomenda.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 Encomenda permite também obter outros dados da lista Clientes.The lookup field in the Orders list lets you get other data from the Customers list as well. Também pode utilizar um campo de pesquisa para ligar a lista Encomendas a uma lista Produto e obter as informações necessárias sobre o produto encomendado, como fotografias de produto, 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 utilizados os campos Escolha?What are Choice fields used for?

Os campos Escolha são utilizados para listas muito pequenas mas, em vez de criar uma lista separada, inclui os valores da lista num pequeno menu, que é apresentado quando clica ou toca no campo Escolha 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.

Os exemplos incluem dados como o Código de Estado do Cliente, Disponibilidade do Produto, Códigos de Estado, ou seja, qualquer lista fixa que seja relativamente pequena.Examples include data like Customer Status Code, Product Availability, State Codes; basically any fixed list that is relatively short. De facto, estes dados poderiam ser implementados como listas separadas, e utilizaria então um campo Pesquisa para ligar aos mesmos mas, normalmente, é mais fácil e rápido implementá-los como campos Escolha.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, irá ligar duas listas personalizadas do SharePoint em conjunto, Recursos e RepairShop.In this tutorial, you link two SharePoint custom lists together, Assets and RepairShop. A lista Recursos é utilizada para monitorizar o equipamento de hardware numa equipa.The Assets list is used to track hardware equipment in a team. Uma vez que o hardware avaria ocasionalmente, utilizamos a lista RepairShop para manter o registo das lojas locais que o podem reparar.Since hardware gets broken from time to time, we use the RepairShop list to track the local shops which can fix it.

Os campos de pesquisa utilizados neste exemploThe lookup fields used in this example

A lista RepairShop utiliza o campo ContactEmail para identificar a loja.The RepairShop list uses the ContactEmail field to identify the shop. Esta lista é definida em primeiro lugar, para que cada linha na lista Recursos tenha algo para onde apontar.This list is defined first so that each row in the Assets list has something to point to.

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

  • um com o nome RepairShop, do tipo Pesquisa, que utiliza endereços de e-mail para apontar para as entradas na lista RepairShop;one called RepairShop, of type Lookup, which uses email addresses to point to entries in the RepairShop list;
  • outro com o nome AssetType, do tipo Escolha, que lista os possíveis tipos de hardware deste recurso.one called AssetType, of type Choice, which lists the kinds of hardware that this asset might be.

Provavelmente, definiria campos adicionais, consoante as informações que precisasse de monitorizar.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 isto primeiro, para que quando adicionar dados à lista Recursos, as entradas em RepairShop fiquem disponíveis para 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 site do SharePoint, crie uma nova lista RepairShop.On your SharePoint site, create a new RepairShop list.

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

  3. Adicione quaisquer outros campos necessários.Add any other fields you need.
  4. Clique ou toque em + Novo para introduzir dados de exemplo na lista, pelo menos 3 linhas com valores ContactEmail diferentes.Click or tap + New to enter sample data into the list, at least 3 rows with different ContactEmail values. Quando um recurso tiver de ser reparado, escolha um deles.When an asset needs to be repaired, you choose one of these.

Definir a lista RecursosDefine the Assets list

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

  3. Adicione um campo AssetType do tipo Escolha e, na caixa de texto Escreva cada escolha numa linha separada, preencha os valores que pretende ver apresentados no menu de escolha.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. Em seguida, clique ou toque em OK.Then click or tap OK.
  4. Comece a adicionar outro campo, como no passo 2: clique ou toque no sinal de adição e escolha Mais.Start to add another field, just like in step 2: click or tap the plus sign and choose More.
  5. Adicione um campo RepairShop do tipo Pesquisa, escolha RepairShop da caixa de texto Obter informações de caixa e escolha 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. Em seguida, clique ou toque em OK.Then click or tap OK.
  6. Adicione quaisquer outros campos adicionais.Add any additional fields you want.

Criar uma aplicação a partir da lista RecursosCreate an app from the Assets list

Utilize esta aplicação para adicionar dados à lista Recursos.You use this app to add data to the Assets list.

  1. Abra o PowerApps Studio.Open PowerApps Studio. Se é a primeira vez que utiliza o PowerApps, inscreva-se gratuitamente, utilizando o endereço de e-mail da sua organização, e siga as instruções para transferir o PowerApps Studio da Loja Windows.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 Ficheiro (junto ao lado esquerdo), clique ou toque em Novo e 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 o seu site do SharePoint da lista Sites recentes ou introduza o 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 do seu site do SharePoint, neste exemplo, Recursos.Choose the main list from your SharePoint site, in this example, Assets. Clique ou toque no botão Ligar no canto inferior direito.Click or tap the Connect button in the lower-right corner.

Adicionar dados à lista RecursosAdd data to the Assets list

Agora, pode executar a aplicação e ver o aspeto do ecrã de detalhes da vista para os campos de pesquisa.Now you can run the app and see how the view details screen looks for the lookup fields.

  1. Prima F5 ou selecione Pré-visualização ( ).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. Introduza um Título para este recurso.Enter a Title for this asset.
  4. Clique ou toque na seta da lista pendente AssetType.Click or tap the AssetType dropdown arrow. Os valores apresentados são aqueles que introduziu quando criou este 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 da lista pendente 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 verificação para guardar 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 os itens que quiser à lista.(optional) Repeat this procedure to add as many items to the list as you want.
  8. Prima Esc para voltar à área de trabalho predefinida.Press Esc to return to the default workspace.

Para mais informaçõesFor more information