FieldRef, élément (ContentType)

  • Article

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

Spécifie une colonne à référencer dans ce type de contenu.

Définition

<FieldRef
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  Customization="Text"
  DefaultValue="Text"
  Description="Text"
  DisplayName="Text"
  Format="Text"
  Filterable="TRUE" | "FALSE"
  FilterableNoRecurrence="TRUE" | "FALSE"
  FromBaseType="TRUE" | "FALSE"
  Hidden="TRUE" | "FALSE" | "orResource"
  ID="Text"
  Locked="TRUE" | "FALSE"
  Name="Text"
  Node="Text"
  NumLines="Integer"
  PIAttribute="Text"
  PITarget="Text"
  PrimaryPIAttribute="Text"
  PrimaryPITarge="Text"
  ReadOnly="TRUE" | "FALSE"
  ReadOnlyClient="TRUE" | "FALSE"
  Required="TRUE" | "FALSE"
  Sealed="TRUE" | "FALSE"
  ShowInDisplayForm="TRUE" | "FALSE"
  ShowInEditForm="TRUE" | "FALSE"
  ShowInFileDlg="TRUE" | "FALSE"
  ShowInListSettings="TRUE" | "FALSE"
  ShowInNewForm="TRUE" | "FALSE"
  Sortable="TRUE" | "FALSE">
</FieldRef>

Éléments et attributs

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

Attributs

Attribut Description
Agrégation

Si vous utilisez l’attribut Node pour spécifier une expression XPath qui retourne une collection de valeurs, vous pouvez également inclure un attribut Aggregation qui spécifie l’action à effectuer sur le jeu de valeurs qui est retourné.

Cette action peut être une fonction d'agrégation ou une indication de l'élément particulier au sein de la collection.

Les valeurs possibles sont les suivantes :

  • Somme

  • count

  • Moyenne

  • Min

  • Max

  • Fusionner

  • texte clair Convertit le contenu du texte du nœud en texte brut.

  • first Applique la promotion et la rétrogradation de propriété au premier élément de la collection.

  • last Applique la promotion et la rétrogradation de propriété au dernier élément de la collection.

Pour plus d’informations sur la façon dont les attributs Node, PIAttribute, PITarget, PrimaryPIAttribute et PrimaryPITarget sont utilisés pour la promotion et la rétrogradation de propriétés dans les documents XML, consultez Utilisation de types de contenu pour spécifier des propriétés de document XML.
Personnalisation

Texte facultatif. Chaîne en CAML (Collaborative Application Markup Language) qui définit des propriétés de champ personnalisées.
DefaultValue

Obsolète.
Description

Text facultatif. Fournit la description qui s'affiche dans le formulaire de modification d'une liste si une description de colonne est spécifiée. Par défaut, les colonnes dans SharePoint Foundation n’ont pas de description.
DisplayName

Texte obligatoire. Nom affiché de la colonne. La longueur maximale est de 255 caractères.

La valeur de cet attribut est utilisée comme en-tête de colonne lorsque le champ est affiché dans une vue de tableau et comme étiquette de formulaire lorsque le champ est affiché dans un formulaire. Vous utilisez l’attribut DisplayName pour remplacer le nom d’affichage par une valeur différente du nom défini sur le champ lui-même.
Format

Text facultatif. Spécifie la mise en forme à utiliser pour les valeurs numériques.

Pour les colonnes de date/heure, les valeurs suivantes sont possibles :

  • DateOnly Affiche uniquement (et autorisez les modifications à) la partie date (la partie heure est définie sur 12:00 A.M. pour toutes les valeurs modifiées).

  • DateTime Affiche et modifie la date et l’heure du jour (valeur par défaut).

  • ISO8601 Affiche la date et l’heure au format d’heure ISO8601 converties en UTC : AAAA-MM-DDTHH:MM:SSZ.

    Il s’agit du format utilisé pour les propriétés de document dans Microsoft Office System, ainsi que pour le format d’échange standard utilisé dans Microsoft SharePoint Foundation entre les formulaires Nouveau et Modifier et le serveur.

  • ISO8601Basic Utilisez la forme abrégée des formats de date/heure 8601 : AAAAMMDDTHHMMSSZ.

    Il s’agit du format utilisé pour vCard/iCal.

Pour les champs Choix , cet attribut peut être défini sur Liste déroulante (par défaut), qui fournit des options d’édition via une sélection déroulante, ou sur RadioButtons, qui fournit des options via un groupe de cases d’option.

Pour les champs d’URL, cet attribut peut être défini sur Hyperlink (valeur par défaut), qui affiche l’URL sous la forme d’une balise normale <A> , ou sur Image, qui affiche l’URL sous la forme <IMG SRC="URL" ALT="Description">.
Filtrables

Facultatif Boolean. TRUE pour définir la colonne comme étant filtrable.
FilterableNoRecurrence

Facultatif Boolean. TRUE pour définir la colonne comme étant filtrable sans valeur périodique.
FromBaseType

Facultatif Boolean. Cet attribut a été désapprouvé en faveur de l'attribut Sealed.
Hidden

Facultatif Boolean. Si la valeur est TRUE, le champ est totalement masqué dans l’interface utilisateur. Définir ReadOnly sur TRUE signifie que le champ n’est pas affiché dans les formulaires Nouveau ou Modifier , mais peut toujours être inclus dans les affichages.

Si vous n’incluez pas cet attribut, SharePoint Foundation traite la colonne comme si l’attribut avait la valeur FALSE.
ID

Texte obligatoire. Spécifie l’ID de champ de la colonne référencée par cet élément FieldRef . L’ID de champ est la représentation sous forme de chaîne d’un GUID, y compris les accolades. La valeur respecte la casse.

Vous trouverez les ID des champs intégrés dans le fichier fieldswss.xml situé sur le chemin d’accès suivant :
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\FEATURES\fields
Locked Obsolète.
Name

Texte obligatoire. Nom d'une colonne. Il s'agit du nom interne d'une colonne qui ne changera pas pendant la durée de vie de la définition de champ. Ce nom doit être unique par rapport à l'ensemble des champs d'une liste.
Node

Text facultatif. Spécifie le nœud XML du document qui contient la valeur de la colonne. Utilisé pour la promotion et la rétrogradation des propriétés dans des documents XML.

Pour plus d'informations sur la façon dont les attributs Node, PIAttribute, PITarget, Primary PIAttribute et PrimaryPITarget sont utilisés pour la promotion et la rétrogradation des propriétés dans des documents XML, voir Using Content Types to Specify XML Document Properties.
NumLines

Integer facultatif. Recommande le nombre de lignes à afficher dans un bloc TEXTAREA pendant la modification. Il s'agit simplement d'une indication de l'interface utilisateur du client ; il n'existe aucune limitation quant au nombre de lignes de texte modifiables.
PIAttribute Texte facultatif. Spécifie l’attribut de l’instruction de traitement du document (définie par l’attribut PITarget) à, utiliser comme valeur de colonne. Utilisé pour la promotion et la rétrogradation de propriétés dans les documents XML.

Si vous spécifiez l’attribut PIAttribute, vous devez également spécifier l’attribut PITarget.

Pour plus d’informations sur la façon dont les attributs Node, PIAttribute, PITarget, Primary PIAttribute et PrimaryPITarget sont utilisés pour la promotion et la rétrogradation des propriétés dans les documents XML, voir Using Content Types to Specify XML Document Properties.
PITarget

Text facultatif. Spécifie l’instruction de traitement du document où la valeur de colonne est stockée dans les documents de ce type de contenu. Utilisé pour la promotion et la rétrogradation de propriétés dans les documents XML.

Si vous spécifiez l’attribut PIAttribute, vous devez également spécifier l’attribut PITarget.

Pour plus d’informations sur la façon dont les attributs Node, PIAttribute, PITarget, Primary PIAttribute et PrimaryPITarget sont utilisés pour la promotion et la rétrogradation des propriétés dans les documents XML, voir Using Content Types to Specify XML Document Properties.
PrimaryPIAttribute

Texte facultatif. Spécifie un attribut de remplacement dans l’instruction de traitement du document, définie par l’attribut PrimaryPITarget, à utiliser comme valeur de colonne.

Si vous spécifiez l’attribut PrimaryPIAttribute, vous devez également spécifier l’attribut PrimaryPITarget. Si elle est spécifiée, SharePoint Foundation utilise ces valeurs avant celles spécifiées dans les attributs PITarget et PIAttribute .

Utilisé pour la promotion et la rétrogradation de propriétés dans les documents XML.

Pour plus d'informations sur la façon dont les attributs Node, PIAttribute, PITarget, Primary PIAttribute et PrimaryPITarget sont utilisés pour la promotion et la rétrogradation des propriétés dans des documents XML, voir Using Content Types to Specify XML Document Properties.
PrimaryPITarget

Text facultatif. Spécifie une autre instruction de traitement de document dans laquelle la valeur de colonne est stockée pour les documents de ce type de contenu.

Si vous spécifiez l’attribut PrimaryPIAttribute, vous devez également spécifier l’attribut PrimaryPITarget. Si elle est spécifiée, SharePoint Foundation utilise ces valeurs avant celles spécifiées dans les attributs PITarget et PIAttribute .

Pour plus d’informations sur la façon dont les attributs Node, PIAttribute, PITarget, Primary PIAttribute et PrimaryPITarget sont utilisés pour la promotion et la rétrogradation des propriétés dans les documents XML, voir Using Content Types to Specify XML Document Properties.
ReadOnly

Facultatif Boolean. Si la valeur est TRUE, le champ n’est pas affiché dans les formulaires Nouveau ou Modifier , mais peut être inclus dans les affichages. La définition de l’attribut Hidden avec la valeur TRUE masque complètement le champ dans l’interface utilisateur.

Si vous n’incluez pas cet attribut, SharePoint Foundation traite la colonne comme si l’attribut avait la valeur FALSE.
Obligatoire

Boolean obligatoire. Si la valeur est TRUE, la valeur du champ doit lui être affectée avant qu’un élément créé à l’aide de ce type de contenu puisse être enregistré.

Si une valeur de champ vide est donnée dans un billet de formulaire, le texte du champ obligatoire standard ou un message explicitement spécifié (c’est-à-dire, via <des balises ErrorText> ) s’affiche dans le formulaire d’erreur. Cette validation est gérée par le client uniquement (la base de données autorise toujours la valeur NULL pour tous les champs définis par l'utilisateur).
Scellé

Facultatif Boolean. TRUE pour définir la colonne comme étant scellée. Vous ne pouvez pas modifier des colonnes scellées via l’interface utilisateur ou le modèle objet SharePoint Foundation. Si vous n’incluez pas cet attribut, SharePoint Foundation traite la colonne comme si l’attribut avait la valeur FALSE.
ShowInDisplayForm

Facultatif Boolean. TRUE pour afficher la colonne sur le formulaire d'affichage pour des éléments de ce type de contenu.
ShowInEditForm

Facultatif Boolean. TRUE pour afficher le champ dans la page Modifier l'élément.
ShowinFileDlg

Facultatif Boolean. TRUE pour afficher la colonne dans la boîte de dialogue de fichier pour des éléments de ce type de contenu.
ShowInListSettings

Facultatif Boolean. Si la valeur est FALSE, le champ n’apparaît pas dans une énumération Fields lorsque le mode d’affichage a la valeur New. Les champs avec ce paramètre n’apparaissent pas dans la page Nouvel élément par défaut d’une liste donnée.
ShowInNewForm

Facultatif Boolean. TRUE pour afficher la colonne sur le formulaire Nouveau pour des éléments de ce type de contenu.
Triable

Facultatif Boolean. TRUE si les valeurs du champ peuvent être triées.

Éléments enfants

Aucun

Éléments parents

Occurrence

  • Minimum : 0
  • Maximum : illimité

Remarques

L'élément FieldRef est une référence à une colonne définie ailleurs, au niveau du site ou de la liste. Dans la référence de champ, vous pouvez redéfinir un sous-ensemble des propriétés de colonne, dont :

  • Nom complet
  • Attributs XML de promotion et de rétrogradation
  • Possibilité de spécifier le champ comme étant en lecture seule, obligatoire ou masqué

La modification de ces propriétés dans la référence de champ ne s'effectue que lorsque celles-ci s'appliquent au type de contenu spécifique qui contient la référence de champ.

Importante

Les attributs ID, Name, DisplayName et Required sont toujours requis, même lorsque l’élément FieldRef fait référence à un champ défini dans le même manifeste d’élément.

Exemple

L’exemple suivant montre deux éléments FieldRef spécifiant des colonnes à inclure dans un type de contenu.

<FieldRefs>
  <!--  Built-in Title field -->
  <FieldRef ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" Name="Title" DisplayName="Item" Required="TRUE" Sealed="TRUE"/>
  <!--  Custom CostCenter field -->
  <FieldRef ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}" Name="CostCenter" DisplayName="Department" Required="TRUE"/>
</FieldRefs>

Voir aussi