Élément Joins (View)

Article
04/08/2023

S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

Contient les éléments de jointure nécessaires pour une requête.

<Joins>  <Join ... >  </Join>    <Join ... >  </Join>  ...</Joins>

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Aucun

Éléments enfants

Join

Éléments parents

View

Remarque

Lorsqu’un élément Joins est utilisé dans le cadre d’une requête dynamique plutôt que dans le cadre de la définition d’un affichage de liste ; autrement dit, lorsqu’il s’agit de la valeur de la propriété SPQuery.Joins plutôt que de la propriété Joins , elle n’a pas vraiment d’élément parent.

Occurrences

Minimum : 0
Maximum : 1

Exemple

Voici un exemple de d’un élément Joins avec deux jointures externes gauches. CustomerName est un champ de recherche sur une liste Orders. Il recherche le champ ID d’une liste Customers. La liste Customer a à son tour un champ CityName qui est un champ de recherche pour une liste Cities.

Le premier élément Join affecte 'customers' en tant qu’alias pour la liste Customers. L’enfant de l’élément Eq définit la jointure en utilisant les mêmes champs source et cible qui constituent la relation de recherche. Le deuxième élément Join attribue « customerCities » en tant qu’alias à la liste Cities. Il définit la jointure parallèlement à la relation de recherche existante entre les listes Customer et Cities.

Les alias sont nécessaires pour les listes car il peut exister plusieurs jointures sur la même liste et des alias différents sont alors nécessaires pour différencier les jointures. Par exemple, en plus des jointures de Orders avec Customer et de Customer avec Cities, il pourrait également y avoir des jointures de Orders avec Suppliers et de Suppliers avec Cities. Dans le cas de la dernière jointure, un alias différent, par exemple « supplierCities », est attribué à la liste des villes de celui utilisé pour la jointure Client à Villes.

<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='customer' Name='CityName' RefType='Id' />
      <FieldRef List='customerCities' Name='ID' />
    </Eq>
  </Join>
</Joins>

Partager via