Elemento Join (View)

Artículo
09/24/2014

Última modificación: viernes, 25 de diciembre de 2009

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones

Se usa para combinar dos listas para consultas.

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

Atributos

Atributo	Descripción
Type	Obligatorio. "LEFT" significa una combinación externa izquierda. "INNER" significa una combinación interna.
ListAlias	Opcional. Especifica un nombre alternativo para la lista externa. Esto puede resultar útil cuando hay dos combinaciones para la misma lista. Se necesitan alias distintos para diferenciar las combinaciones. No es necesario asignar explícitamente el alias al nombre real de la lista externa, ya que las combinaciones solo se permiten por medio de una relación de campo de búsqueda y la lista externa se especifica en la definición del campo de búsqueda. Una vez definido este valor en un elemento Join, se usa como valor de un atributo List en dos lugares: En un elemento FieldRef secundario del elemento Eq del elemento Join. En un elemento Field secundario de un elemento ProjectedFields.

Type

Obligatorio. "LEFT" significa una combinación externa izquierda. "INNER" significa una combinación interna.

ListAlias

Opcional. Especifica un nombre alternativo para la lista externa. Esto puede resultar útil cuando hay dos combinaciones para la misma lista. Se necesitan alias distintos para diferenciar las combinaciones.

No es necesario asignar explícitamente el alias al nombre real de la lista externa, ya que las combinaciones solo se permiten por medio de una relación de campo de búsqueda y la lista externa se especifica en la definición del campo de búsqueda.

Una vez definido este valor en un elemento Join, se usa como valor de un atributo List en dos lugares:

En un elemento FieldRef secundario del elemento Eq del elemento Join.
En un elemento Field secundario de un elemento ProjectedFields.

Elementos secundarios

Elementos primarios

Joins

Repeticiones

Mínimo: 1

Máximo: el valor de la propiedad MaxQueryLookupFields para el objeto SPWebApplication que contiene la lista principal que se está consultando. El valor predeterminado del sistema es 8.

Comentarios

El elemento Join se traslada a la instrucción SQL JOIN. El elemento Join refactoriza el elemento Eq para especificar los campos principales y externos en los que se realizará la combinación. El campo principal debe definirse como un campo de búsqueda para el campo externo.

Ejemplo

El siguiente es un ejemplo de dos elementos Join; ambos son combinaciones externas izquierdas. NombreDelCliente es un campo de búsqueda de una lista de pedidos que busca en el campo de identificación de una lista de clientes. La lista de clientes, a su vez, tiene un campo Ciudad que es un campo de búsqueda de una lista de ciudades. El primer elemento Join asigna ‘clientes’ como alias de la lista de clientes. El elemento Eq secundario define la combinación mediante los mismos campos de origen y de destino que constituyen la relación de búsqueda. El segundo elemento Join asigna ‘ciudadesDeClientes’ como alias de la lista de ciudades. Define la combinación en paralelo a la relación de búsqueda existente entre las listas de clientes y de ciudades.

Los alias son importantes para las listas debido a que puede haber más de una combinación para la misma lista y se necesitan alias distintos para diferenciar estas combinaciones. Por ejemplo, además de las combinaciones de pedidos a clientes y de clientes a ciudades, también puede haber combinaciones de pedidos a proveedores y de proveedores a ciudades. En el caso de la última combinación, se asignaría un alias distinto, por ejemplo ‘ciudadesDeProveedores’, a la lista de ciudades a partir del que se usa para la combinación de clientes a ciudades.

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