Join-Element (View)
Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013
Wird zum Verknüpfen von zwei Listen für Abfragen verwendet.
<Join Type= "LEFT" | "INNER" ListAlias= "TEXT"></Join>
Elemente und Attribute
In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.
Attribute
| Attribut | Beschreibung |
|---|---|
| Typ |
Erforderlich. "LEFT" bedeutet einen linken äußeren Join. "INNER" bedeutet eine innere Verknüpfung. |
| ListAlias |
Optional. Gibt einen alternativen Namen für die fremde Liste an. Dies kann hilfreich sein, wenn zwei Verknüpfungen mit der gleichen Liste vorhanden sind. Zum Unterscheiden der Verknüpfungen werden unterschiedliche Aliase verwendet. Es ist nicht erforderlich, den Alias explizit dem tatsächlichen Namen der Fremdliste zuzuordnen, da Verknüpfungen nur über eine Nachschlagefeldbeziehung zulässig sind und die Fremdliste in der Definition des Nachschlagefelds angegeben wird. Wenn dieser Wert in einem Join-Element definiert wurde, wird der Wert an zwei Stellen für ein List-Attribut verwendet: – In einem FieldRef-Element , das dem Eq-Element des Join-Elements untergeordnet ist. – In einem Field-Element , das ein untergeordnetes Element eines ProjectedFields-Elements ist. |
Untergeordnete Elemente
Übergeordnete Elemente
Vorkommen
- Minimum: 1
- Maximum: Der Wert der MaxQueryLookupFields-Eigenschaft für das SPWebApplication-Objekt , das die primäre Liste enthält, die abgefragt wird. Der Systemstandard ist 8.
HinwBemerkungeneise
Das Join-Element wird in die SQL JOIN-Anweisung übersetzt. Mit dem Join-Element wird das Eq-Element umgestaltet, um die primären und fremden Felder anzugeben, in denen die Verknüpfung hergestellt werden soll. Das primäre Feld muss als Nachschlagefeld für das fremde Feld definiert sein.
Beispiel
Es folgt ein Beispiel für zwei Join-Elemente . beide sind linke äußere Joins. CustomerName ist ein Nachschlagefeld in einer Liste "Bestellungen". Es wird bis zum ID-Feld einer Kundenliste nachschlagen. Die Kundenliste verfügt wiederum über ein Feld "CityName", bei dem es sich um ein Nachschlagefeld für eine Städteliste handelt.
Das erste Join-Element weist "customers" als Alias für die Kundenliste zu. Das untergeordnete Eq-Element definiert den Join mithilfe der gleichen Quell- und Zielfelder, die die Nachschlagebeziehung bilden. Das zweite Join-Element weist der Liste Cities "customerCities" als Alias zu. Der Join wird parallel zur vorhandenen Suchbeziehung zwischen den Listen Kunde und Städte definiert.
Aliase sind für Listen wertvoll, da mehrere Verknüpfungen mit der gleichen Liste vorhanden sein können, die anhand von Aliasen unterschieden werden. Zusätzlich zu den Verknüpfungen zwischen Orders und Customer sowie zwischen Customer und Cities sind auch Verknüpfungen zwischen Orders und Suppliers sowie zwischen Suppliers und Cities möglich. Im Fall des letzten Joins wird der Liste Städte ein anderer Alias zugewiesen, z. B. "supplierCities", als für den Beitritt zwischen Kunden und Städten verwendet wird.
<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>