FieldRef, élément (Query)

Article
04/08/2023

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

Représente une référence à un champ au sein d'une requête.

<FieldRef
  Alias = "Text"
  Ascending = "TRUE" | "FALSE"
  CreateURL = "Text"
  DisplayName = "Text"
  Explicit = "TRUE" | "FALSE"    Format = "Text"
  ID = "Text"
  Key = "Text"  List = "Text"
  LookupId = "TRUE" | "FALSE"
  Name = "Text"
  RefType = "Text"
  ShowField = "Text"
  TextOnly = "TRUE" | "FALSE"
  Type = "Text">
</FieldRef>

Éléments et attributs

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

Attributs

Attribut	Description
Alias	Texte facultatif.
Ascending	Facultatif Boolean. Ceci spécifie l'ordre de tri sur un élément FieldRef défini dans un affichage. La valeur par défaut est TRUE.
CreateURL	Text facultatif. Spécifie l'URL du fichier .aspx utilisé pour créer un site d'espace de travail de réunion.
DisplayName	Text facultatif. Cet attribut fournit le nom complet du champ référencé.
Explicit	Facultatif Boolean. Cet attribut est uniquement pris en charge dans l'élément ViewFields. Valeur TRUE si le champ est explicitement déclaré dans la définition de l'affichage et n'est pas retourné dans une énumération Fields à l'intérieur d'un affichage.
Format	Texte facultatif.
ID	Valeur Text facultative. Spécifie le GUID qui identifie le champ.
Clé	Texte facultatif. Si défini sur Primary, spécifie que le champ est la clé primaire de sa table et qu'il identifie par conséquent de manière unique chaque enregistrement de la table.
List	Texte facultatif. Spécifie la liste étrangère parente lorsque l’élément FieldRef est un enfant d’un élément Eq dans l’élément Join . La valeur est un alias pour la liste définie par l’attribut ListAlias de l’élément Join .
LookupId	Facultatif Boolean. Lorsque le champ est un type Lookup, spécifie que les requêtes doivent rechercher l’élément par son ID d’élément unique plutôt que par la valeur du champ. Cela peut être utile, par exemple, lorsque plusieurs éléments ont des valeurs identiques dans le champ et que vous souhaitez interroger un élément spécifique. La valeur par défaut est false.
Name	Texte facultatif. Cet attribut fournit le nom interne du champ référencé.
RefType	Text facultatif. Spécifie le type de référence d'un champ dans une liste d'événements.
ShowField	Texte facultatif. L'attribut ShowField peut être défini sur le nom de champ à afficher. Par défaut, un texte sous forme de lien hypertexte à partir du champ Titre de l'enregistrement dans la liste externe est affiché. Mais l'attribut ShowField peut être utilisé pour remplacer cela et afficher un autre champ à partir de la liste externe. Les types de données suivants sont autorisés en tant que cibles d'un attribut ShowField : Text, Choice et Counter.
TextOnly	Valeur Boolean facultative. Spécifie que le champ ne contient que des valeurs de texte.
Type	Text facultatif. Spécifie la fonction appliquée à une colonne de totaux ou une colonne calculée. Les valeurs possibles sont les suivantes : AVG Valeur moyenne. S'applique aux types de champs DateTimeNumber, Integer et Currency. COMPTER Nombre d’éléments. S'applique à tous les types de champs qui autorisent l'agrégation. MAX Valeur maximale. S'applique aux types de champs DateTimeNumber, Integer et Currency. MIN Valeur minimale. S'applique aux types de champs DateTimeNumber, Integer et Currency. SOMME Somme des valeurs. S'applique aux types de champs Number, Integer et Currency. STDEV Écart. S'applique aux types de champs Number, Integer et Currency. VAR Variance. S'applique aux types de champs Number, Integer et Currency. Les valeurs de l'attribut Type ne respectent pas la casse.

Éléments enfants

Aucun

Éléments parents

Occurrences

Minimum : 0
Maximum : 1 (sans limite dans OrderBy)

Exemples

L'exemple de requête suivante recherche les cas où le champ Date d'expiration a la valeur null ou contient une valeur supérieure ou égale à la date du jour.

<Query>
   <Where>
      <Or>
         <IsNull>
            <FieldRef Name="Expires" />
         </IsNull>
         <Geq>
            <FieldRef Name="Expires" />
            <Value Type="DateTime">
               <Today />
            </Value>
         </Geq>
      </Or>
   </Where>
   <OrderBy>
      <FieldRef Name="Modified" Ascending="FALSE" />
   </OrderBy>
</Query>

Cet exemple du fichier Schema.xml des contacts répertorie les champs à afficher dans la barre d’outils.

<ViewFields>
   <FieldRef Name="LinkTitleNoMenu"></FieldRef>
   <FieldRef Name="FirstName"></FieldRef>
   <FieldRef Name="WorkPhone"></FieldRef>
   <FieldRef Name="Email"></FieldRef>
</ViewFields>

Partager via