Cette documentation est archivée et n’est pas conservée.

FieldRef, élément (ContentType)

Windows SharePoint Services 3

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


<FieldRef
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  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>

Attribut Description

Aggregation

Si vous utilisez l'attribut Node pour spécifier une expression XPath retournant une collection de valeurs, vous pouvez également inclure un attribut Aggregation spécifiant l'action à effectuer sur le jeu de valeurs retourné.

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

Les valeurs possibles sont les suivantes :

  • sum

  • count

  • average

  • min

  • max

  • merge

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

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

  • last   Applique la promotion et la rétrogradation des propriétés 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 des propriétés dans des documents XML, voir Utilisation de types de contenu pour spécifier des propriétés de document XML.

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 Windows SharePoint Services n'ont pas de descriptions.

DisplayName

Text facultatif. Nom affiché de la colonne. La longueur maximale est de 255 caractères.

Ce nom est utilisé en tant qu'étiquette de formulaire lorsque la colonne est affichée dans un formulaire.

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 la partie date et autorise les modifications (la partie heure a la valeur 12:00 pour toutes les valeurs modifiées).

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

  • ISO8601     Affiche les date et heure dans le format d'heure ISO8601 converti en temps UTC : aaaa-mm-JJTHH:MM:SSZ.

    Il s'agit du format utilisé pour les propriétés de document dans le système Microsoft Office, ainsi que pour le format d'échange standard utilisé dans Windows SharePoint Services entre les formulaires Nouveau et Modifier et le serveur.

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

    Il s'agit du format utilisé pour VCard/iCal.

Pour les champs Choice, cet attribut peut prendre la valeur Dropdown (par défaut), qui fournit des options d'édition par le biais d'une sélection contextuelle, ou la valeur RadioButtons, qui fournit des options par le biais d'un groupe de cases d'option.

Pour les champs d'URL, cet attribut peut prendre la valeur Hyperlink (par défaut), qui affiche l'URL en tant que balise normale <A>, ou la valeur Image, qui affiche l'URL en tant que <IMG SRC=”URL” ALT=” Description”>.

Filterable

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

FilterableNoRecurrence

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

FromBaseType

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

Hidden

Boolean facultatif. Si la valeur est TRUE, le champ est complètement masqué dans l'interface utilisateur. L'affectation au paramètre ReadOnly de la valeur TRUE signifie que le champ n'est pas affiché dans les formulaires New ou Edit mais qu'il peut toujours être inclus dans les vues.

Si vous n'incluez pas cet attribut, Windows SharePoint Services traite la colonne comme si cet attribut avait la valeur FALSE.

ID

Text facultatif. Spécifie l'ID de champ de la colonne auquel cet élément FieldRef fait référence.

Locked

Obsolète.

Name

Text facultatif. 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. Il est généré automatiquement en fonction du nom défini par l'utilisateur d'un champ.

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 Utilisation de types de contenu pour spécifier des propriétés de document XML.

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

Text facultatif. Spécifie l'attribut dans l'instruction de traitement du document (indiquée par l'attribut PITarget) à utiliser en tant que valeur de colonne. Utilisé pour la promotion et la rétrogradation des propriétés dans des 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 des documents XML, voir Utilisation de types de contenu pour spécifier des propriétés de document XML.

PITarget

Text facultatif. Spécifie l'instruction de traitement du document dans laquelle la valeur de la colonne est stockée dans les documents de ce type de contenu. Utilisé pour la promotion et la rétrogradation des propriétés dans des 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 des documents XML, voir Utilisation de types de contenu pour spécifier des propriétés de document XML.

PrimaryPIAttribute

Text facultatif. Spécifie un attribut de remplacement dans l'instruction de traitement du document, indiquée par l'attribut PrimaryPITarget, à utiliser en tant que valeur de la colonne.

Si vous spécifiez l'attribut PrimaryPIAttribute, vous devez également spécifier l'attribut PrimaryPITarget. S'il est précisé, Windows SharePoint Services utilise ces valeurs avant celles qui sont précisées dans les attributs PITarget et PIAttribute.

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 Utilisation de types de contenu pour spécifier des propriétés de document XML.

PrimaryPITarget

Text facultatif. Spécifie une autre instruction de traitement du document dans laquelle la valeur de la 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. S'il est indiqué, Windows SharePoint Services utilise ces valeurs avant celles qui sont indiqué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 des documents XML, voir Utilisation de types de contenu pour spécifier des propriétés de document XML.

ReadOnly

Boolean facultatif. Si la valeur est TRUE, le champ n'est pas affiché dans les formulaires New ou Edit mais il peut être inclus dans les vues. L'affectation à l'attribut Hidden de la valeur TRUE masque complètement le champ de l'interface utilisateur.

Si vous n'incluez pas cet attribut, Windows SharePoint Services traite la colonne comme si cet attribut avait la valeur False.

Required

Boolean facultatif. Si la valeur est TRUE, aucune valeur vide ne doit être affectée au champ. Si une valeur de champ non vide n'est pas attribuée dans une publication de formulaire, le texte du champ obligatoire standard ou un message spécifié explicitement (via les balises < ErrorText >) est affiché 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).

Sealed

Boolean facultatif. TRUE pour définir la colonne comme étant scellée. Vous ne pouvez pas modifier les colonnes scellées par le biais de l'interface utilisateur ou du modèle objet Windows SharePoint Services.

Si vous n'incluez pas cet attribut, Windows SharePoint Services traite la colonne comme si cet attribut avait la valeur FALSE.

ShowInDisplayForm

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

ShowInEditForm

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

ShowinFileDlg

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

ShowInListSettings

Boolean facultatif. Si la valeur est FALSE, le champ n'apparaît pas dans une énumération Fields lorsque le mode d'affichage est défini sur New. Les champs auxquels ce paramètre est attribué n'apparaissent pas dans la page Nouvel élément par défaut pour une liste donnée.

ShowInNewForm

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

Sortable

Boolean facultatif. TRUE si des valeurs dans le champ peuvent être triées.

Minimum : 0

Maximum : aucune limite

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

  • Nom complet

  • Attributs de promotion et de rétrogradation XML

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

Pour plus d'informations sur les références de champs, voir Références d'un ou plusieurs champs.

L'exemple suivant illustre l'utilisation des éléments FieldRef en spécifiant l'inclusion de plusieurs colonnes dans le type de contenu.

<FieldRefs>
  <FieldRef ID=FID_FileLeafRef Name="FileLeafRef" Required="TRUE"/>
  <FieldRef ID=FID_Created Name="Created" Hidden="TRUE" /> 
  <FieldRef ID=FID_Title Name="Title" Required="FALSE" ShowInNewForm="FALSE" ShowInEditForm="TRUE"/> 
  <FieldRef ID=FID_Modified Name="Modified"  Hidden="TRUE" /> 
</FieldRefs>
Afficher: