Elemento Join (Exibição)

Artigo
04/08/2023

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Usado para ingressar em duas listas para consultas.

<Join   Type= "LEFT" | "INNER"  ListAlias= "TEXT"></Join>

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo	Descrição
Tipo	Obrigatório. "LEFT" significa uma junção externa à esquerda. "INNER" significa uma junção interna.
ListAlias	Opcional. Especifica um nome alternativo para a lista estrangeira. Isso pode ser útil quando há duas junções na mesma lista. Diferentes aliases são necessários para diferenciar as junções. Não é necessário mapear explicitamente o alias para o nome real da lista estrangeira porque as junções só são permitidas por meio de uma relação de campo de pesquisa, e a lista estrangeira é especificada na definição do campo Pesquisa. Depois que esse valor é definido em um elemento Join , ele é usado como o valor de um atributo List em dois lugares: - Em um elemento FieldRef que é uma criança para o elemento Eq do elemento Join . - Em um elemento Field que é filho de um elemento ProjectedFields .

Atributo

Descrição

Tipo

Obrigatório. "LEFT" significa uma junção externa à esquerda. "INNER" significa uma junção interna.

ListAlias

Opcional. Especifica um nome alternativo para a lista estrangeira. Isso pode ser útil quando há duas junções na mesma lista. Diferentes aliases são necessários para diferenciar as junções.

Não é necessário mapear explicitamente o alias para o nome real da lista estrangeira porque as junções só são permitidas por meio de uma relação de campo de pesquisa, e a lista estrangeira é especificada na definição do campo Pesquisa.

Depois que esse valor é definido em um elemento Join , ele é usado como o valor de um atributo List em dois lugares:
- Em um elemento FieldRef que é uma criança para o elemento Eq do elemento Join .
- Em um elemento Field que é filho de um elemento ProjectedFields .

Elementos filho

Elementos pai

Junta

Occurrences

Mínimo: 1
Máximo: o valor da propriedade MaxQueryLookupFields para o objeto SPWebApplication que contém a lista primária que está sendo consultada. O padrão do sistema é 8.

Comentários

O elemento Join se traduz na instrução JOIN do SQL. O elemento Join refatora o elemento Eq para especificar os campos primários e estrangeiros nos quais fazer a junção. O campo primário deve ser definido como um campo De pesquisa para o campo estrangeiro.

Exemplo

A seguir está um exemplo de dois elementos join ; ambos são junções externas à esquerda. CustomerName é um campo de pesquisa em uma lista de pedidos. Ele pesquisa o campo ID de uma lista de clientes. A lista de clientes, por sua vez, tem um campo CityName que é um campo de pesquisa para uma lista cidades.

O primeiro elemento Join atribui 'clientes' como um alias para a lista Clientes. O filho do elemento Eq define a junção usando os mesmos campos de origem e de destino que constituem a relação de pesquisa. O segundo elemento Join atribui 'customerCities' como um alias à lista Cidades. Ele define a junção em paralelo à relação de pesquisa existente entre as listas Cliente e Cidades.

Os aliases são valiosos para as listas porque pode haver mais de uma junção à mesma lista e diferentes aliases são necessários para diferenciar as junções. Por exemplo, além das junções de Pedidos ao Cliente e de Cliente para Cidades, também pode haver junções de Pedidos a Fornecedores e de Fornecedores para Cidades. No caso da última junção, um alias diferente, por exemplo, "supplierCities", seria atribuído à lista Cidades da que é usada para a junção Cliente para Cidades.

<Joins>
  <Join Type='LEFT' ListAlias='customers'>
    <Eq>
      <FieldRef Name='CustomerName' RefType='Id' />
      <FieldRef List='customers' Name='ID' />
    </Eq>
  </Join>
  <Join Type='LEFT' ListAlias='customerCities'>
    <Eq>
      <FieldRef List='customers' Name='CityName' RefType='Id' />
      <FieldRef List='customerCities' Name='ID' />
    </Eq>
  </Join>
</Joins>

Compartilhar via