Élément Field (List)
S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint En ligne | SharePoint Server 2013
Définit les types de données internes utilisés dans l’infrastructure de liste d’SharePoint web. Un champ est une colonne ou un attribut d’informations qu’un utilisateur peut ajouter à une liste.
<Field
Aggregation = "sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
AllowDeletion = "TRUE" | "FALSE"
AllowHyperlink = "TRUE" | "FALSE"
AllowMultiVote = "TRUE" | "FALSE"
AppendOnly = "TRUE" | "FALSE"
AuthoringInfo = "Text"
BaseType = "Integer" | "Text"
CalType = "Integer"
CanToggleHidden = "TRUE" | "FALSE"
ClassInfo = "Text"
ColName = "Text" ColName2 = "Text"
Commas = "TRUE" | "FALSE"
Customization = "Text"
Decimals = "Integer"
Description = "Text"
Dir = "Text"
Direction = "Text"
DisplaceOnUpgrade = "TRUE" | "FALSE"
DisplayImage = "Text"
DisplayName = "Text"
DisplayNameSrcField = "Text"
DisplaySize = "Integer"
Div = "Number"
EnableLookup = "TRUE" | "FALSE"
EnforceUniqueValues = "TRUE" | "FALSE"
ExceptionImage = "Text"
FieldRef = "Text"
FillInChoice = "TRUE" | "FALSE"
Filterable = "TRUE" | "FALSE"
FilterableNoRecurrence = "TRUE" | "FALSE"
ForcedDisplay = "Text"
ForcePromoteDemote = "TRUE" | "FALSE"
Format = "Text"
FromBaseType = "TRUE" | "FALSE"
Group = "Text"
HeaderImage = "Text"
Height = "Integer"
Hidden = "TRUE" | "FALSE"
HTMLEncode = "TRUE" | "FALSE"
ID = "Text" Id = "Text"
IMEMode = "inactive"
Indexed = "TRUE" | "FALSE"
IsolateStyles = "TRUE" | "FALSE"
IsRelationship = "TRUE" | "FALSE"
JoinColName = "Text"
JoinRowOrdinal = "Integer"
JoinType = "INNER" | "LEFT OUTER" | "RIGHT OUTER"
LCID = "Integer" LinkToItem = "TRUE" | "FALSE"
LinkToItemAllowed = "Text"
List = "Text"
ListItemMenu = "TRUE" | "FALSE"
ListItemMenuAllowed = "Text"
Max = "Number"
MaxLength = "Integer"
Min = "Number"
Mult = "TRUE" | "FALSE"
Name = "Text"
NegativeFormat = "MinusSign" | "Parens"
Node = "Text"
NoEditFormBreak = "TRUE" | "FALSE"
NumLines = "Integer"
Percentage = "TRUE" | "FALSE"
PIAttribute = "Text"
PITarget = "Text"
PrependId = "TRUE" | "FALSE"
Presence = "TRUE" | "FALSE"
PrimaryKey = "TRUE" | "FALSE"
PrimaryPIAttribute = "Text"
PrimaryPITarget = "Text"
ReadOnly = "TRUE" | "FALSE"
ReadOnlyEnforced = "TRUE" | "FALSE"
RelationshipDeleteBehavior = "Text"
RenderXMLUsingPattern = "TRUE" | "FALSE"
Required = "TRUE" | "FALSE"
RestrictedMode = "TRUE" | "FALSE"
ResultType = "Text"
RichText = "TRUE" | "FALSE"
RichTextMode = "Text"
RowOrdinal = "Integer"
Sealed = "TRUE" | "FALSE"
SeparateLine = "TRUE" | "FALSE"
SetAs = "Text"
ShowAddressBookButton = "TRUE" | "FALSE"
ShowAlways = "TRUE" | "FALSE"
ShowField = "Text" | "Choice" | "Counter"
ShowInDisplayForm = "TRUE" | "FALSE"
ShowInEditForm = "TRUE" | "FALSE"
ShowInFileDlg = "TRUE" | "FALSE"
ShowInListSettings = "TRUE" | "FALSE"
ShowInNewForm = "TRUE" | "FALSE"
ShowInVersionHistory = "TRUE" | "FALSE"
ShowInViewForms = "TRUE" | "FALSE"
Sortable = "TRUE" | "FALSE"
SourceID = "Text"
StaticName = "Text"
StorageTZ = "UTC" | "Abstract"
StripWS = "TRUE" | "FALSE"
SuppressNameDisplay = "TRUE" | "FALSE"
TextOnly = "TRUE" | "FALSE"
Title = "Text"
Type = "Data_Type"
UniqueId = "Text"
UnlimitedLengthInDocumentLibrary = "TRUE" | "FALSE"
URLEncode = "TRUE" | "FALSE"
URLEncodeAsUrl = "TRUE" | "FALSE"
UserSelectionMode = "Text"
UserSelectionScope = "Integer"
Version = "Text"
Viewable = "TRUE" | "FALSE"
WebId = "Text"
Width = "Integer"
WikiLinking = "TRUE" | "FALSE"
XName = "Text">
</Field>
É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 |
Argument Text facultatif. Utilisé dans un champ de regroupement sur un formulaire XML pour spécifier la fonction à appliquer à une collection de valeurs ou d’éléments retournée par une expression XPath. 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 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 Ajoutez les valeurs. - count Comptez le nombre de valeurs. - moyenne Recherchez la moyenne des valeurs. - min Recherchez la valeur minimale. - max Recherchez la valeur maximale. - merge Fusionnez les valeurs. - plaintext Convertit le contenu du texte du nœud en texte simple. - first Appliquer la promotion et la rétrogradation des propriétés au premier élément de la collection. - last Appliquer 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, Primary PIAttribute et PrimaryPITarget sont utilisés pour la promotion et la rétrogradation de propriétés dans les documents XML, voir Using Content Types to Specify XML Document Properties. |
| AllowDeletion |
Argument Boolean facultatif. TRUE si le champ peut être supprimé. |
| AllowHyperlink |
Argument Boolean facultatif. TRUE si les liens hypertexte peuvent être utilisés dans le champ. |
| AllowMultiVote |
Argument Boolean facultatif. TRUE si plusieurs réponses sont autorisées dans une enquête. |
| AppendOnly |
Argument Boolean facultatif. Lorsque le contrôle de version est activé dans la liste, TRUE si le texte peut uniquement être ajouté à la fin du texte existant dans le champ Note. |
| AuthoringInfo |
Argument Text facultatif. Chaîne descriptive qui est affichée dans les pages de modification de champ afin d’identifier le champ et son objectif ; par exemple, le champ LinkTitle possède les informations de création « (Lien vers élément) ». Cet attribut est généralement utilisé si un champ du même nom existe dans un autre but. |
| BaseType |
Facultatif. L’attribut BaseType peut être défini sur Integer, qui stocke les valeurs en tant qu’entiers, ou sur Text (par défaut), qui stocke les valeurs en tant que texte. Vous ne pouvez pas créer des champs de choix de type de base d’entier. |
| CalType |
Argument Integer facultatif. Spécifie le type de calendrier. Les valeurs possibles sont les suivantes : 16 Saka Era 15 lunaires chinois 14 Lunaire coréen et japonais 12 Grégorien translitérés en français 11 Grégorien translitéré anglais 10 Grégorien (arabe) 9 Grégorien (Français du Moyen-Orient) 8 Hébreu (lunaire) 7 Thaï 6 Hijri (lunaire arabe) 5 Coréen (ère Tangun) 4 Taïwan (ère) 3 Japonais (ère impériale) 1 Grégorien 0 Aucun type spécifié |
| CanToggleHidden |
Argument Boolean facultatif. TRUE si le champ peut être masqué par le biais de l’interface utilisateur. |
| ClassInfo |
Argument Text facultatif. Spécifie une classe de feuille de style (CSS) en cascade à utiliser pour le champ dans la vue table standard. Si cet attribut est défini, la classe spécifiée est utilisée au lieu de la classe ms-vb2 standard. |
| ColName |
Argument Text facultatif. Attribut interne qui définit le mappage du champ sur le nom de stockage physique de ce champ. Cela doit être un nom valide dans la base de données sous-jacente et doit être identique au nom utilisé dans la table de base de données. Si cet attribut n’est pas spécifié, le serveur génère un nom de colonne qui n’entre en conflit avec aucun nom de colonne existant et qui contient uniquement des caractères autorisés par Microsoft SQL Server. |
| ColName2 |
Texte facultatif. |
| Virgule |
Boolean facultatif. TRUE si les milliers sont séparés à l’aide de virgules. |
| Personnalisation |
Texte facultatif. |
| Décimales |
Argument Integer facultatif. Détermine le nombre de décimales à afficher. La valeur affichée est arrondie à la précision d’affichage supérieure ; par exemple, la valeur 1,05 est affichée sous la forme 1,1 lorsqu’elle est arrondie à une décimale. |
| Description |
Text facultatif. Fournit la description proposée dans le formulaire de modification d’une liste si une description de champ est spécifiée. Par défaut, les champs de Microsoft SharePoint Foundation n’ont pas de descriptions. |
| Dir |
Text facultatif. Spécifie la direction du texte pour un champ qui prend en charge la lecture bidirectionnelle. Les valeurs possibles sont LTR (de gauche à droite), RTL (de droite à gauche) et none. |
| Direction |
Texte facultatif. |
| IleOnUpgrade |
Boolean facultatif. Si une définition de champ existe déjà pour le champ, TRUE pour obliger les mises à jour des propriétés des champs avec les valeurs spécifiées dans cette définition de champ. |
| DisplayImage |
Text facultatif. Spécifie le nom d’une icône affichée pour la colonne. |
| DisplayName |
Text facultatif. Nom affiché pour un champ. Il n’y a aucune restriction sur la taille du texte ou sur l’utilisation des espaces. Le nom complet peut être modifié par l’utilisateur et peut changer après la création initiale du champ. Ce nom est utilisé comme en-tête de colonne quand le champ est affiché dans une vue table et comme libellé de formulaire quand le champ est affiché dans un formulaire. La balise renvoie le nom complet s’il est donné ; sinon, elle est par défaut l’attribut Name. |
| DisplayNameSrcField |
Text facultatif. Généralement utilisé pour un champ calculé qui nécessite le même nom qu’un autre champ. Si le champ source est modifié et que le nom complet est changé par un utilisateur, le nom complet du champ est également modifié. Cette chaîne se réfère au nom de l’autre champ. |
| DisplaySize |
Integer facultatif. |
| Div |
Number facultatif. Facteur d’échelle utilisé dans la division avant d’afficher un nombre. Le numéro d’affichage est (arrondi au nombre spécifié par N * Mult / Div décimales). |
| EnableLookup |
Boolean facultatif. TRUE pour activer les valeurs de recherche dans le champ. |
| EnforceUniqueValues |
Facultatif Boolean. |
| ExceptionImage |
Text facultatif. Utilisé dans un type de champ Recurrence pour spécifier le nom du fichier image à utiliser pour les exceptions. |
| FieldRef |
Argument Text facultatif. Spécifie le nom d’un autre champ auquel le champ fait référence, tel qu’un champ de recherche. |
| FillInChoice |
Boolean facultatif. TRUE si le champ autorise les utilisateurs à remplir des valeurs pour la colonne. |
| Filtrables |
Boolean facultatif. TRUE si le champ peut être filtré. |
| FilterableNoRecurrence |
Boolean facultatif. TRUE si un filtre peut être créé sur le champ d’une vue qui ne développe pas les événements récurrents. Si Filterable contient TRUE, le champ peut être filtré dans toutes les vues, quelle que soit la façon dont FilterableNoRecurrence est défini. |
| ForcedDisplay |
Text facultatif. Spécifie le texte à afficher à la place de la valeur de champ réelle. Cet attribut est utilisé dans les enquêtes pour empêcher que le nom d’utilisateur ne soit affiché. |
| ForcePromoteDemote |
Facultatif Boolean. |
| Format |
Text facultatif. Spécifie la mise en forme à utiliser pour les valeurs numériques. Pour les champs date/heure, les valeurs suivantes sont possibles : - DateOnly Afficher (et autoriser les modifications) uniquement la partie date (la partie heure est définie sur 00:00 A.M. pour toutes les valeurs modifiées). - DateTime Afficher et modifier la date et l’heure de la journée (par défaut). - ISO8601 Affichage de la date et de l’heure au format d’heure ISO8601 converti au format UTC (Temps universel coordonné) : AAAA-MM-JDTHH:MM:SSZ. Il s’agit du format utilisé pour les propriétés de document dans le système Microsoft Office 2007, ainsi que pour le format d’échange standard utilisé dans SharePoint Foundation entre les formulaires Nouveau et Modifier et le serveur. - ISO8601Basic Utilisez la forme abrégée des formats date/heure 8601 : YYYYMMDDTHHMMSSZ. Il s’agit du format utilisé pour vCard/iCal. Pour les champs Choix, cet attribut peut être défini avec la valeur Dropdown (par défaut), qui fournit des options de modification via une une sélection de liste déroulante, ou avec la valeur RadioButtons, qui fournit des options via un groupe de cases d’option. Pour les champs d’URL, cet attribut peut être définie sur Lien hypertexte (par défaut), qui affiche l’URL en tant que balise normale, ou sur Image , qui affiche l’URL sous la <A> valeur <IMG SRC="URL" ALT="Description"> . |
| FromBaseType |
Boolean facultatif. Cet attribut est abandonné au profit de l’attribut Sealed. |
| Group |
Text facultatif. Spécifie le groupe de colonnes auquel le champ appartient. |
| HeaderImage |
Text facultatif. Spécifie le nom d’un fichier image à utiliser comme en-tête du champ. |
| Height |
Integer facultatif. Spécifie la hauteur en pixels des images affichées pour les utilisateurs dans la liste d’informations utilisateur. |
| Hidden |
Boolean facultatif. Si la valeur est TRUE, le champ est totalement masqué dans l’interface utilisateur. La définition de ReadOnly avec la valeur TRUE signifie que le champ n’est pas affiché dans les formulaires Nouveau ou Modifier, mais qu’il peut continuer à être inclus dans les affichages. |
| HTMLEncode |
Boolean facultatif. TRUE pour convertir les caractères incorporés de telle sorte qu’ils s’affichent sous forme de texte dans le navigateur ; les caractères susceptibles d’être confondus avec les balises HTML sont convertis en entités. |
| ID |
Texte facultatif. Spécifie le GUID du champ contenu entre accolades ( {} ). |
| Id |
Texte facultatif. |
| IMEMode |
Text facultatif. Spécifie l’ajustement du mode de l’éditeur de méthode d’entrée à utiliser pour le champ. L’éditeur de méthode d’entrée autorise la conversion de séquences de touches d’une langue à une autre quand un système d’écriture possède plusieurs caractères qui peuvent être codés pour le clavier donné. Les valeurs possibles sont les suivantes : - auto Non utilisé. Pour spécifier ce mode IME, définissez la valeur de la propriété IMEMode sur une chaîne vide ( "" ). - active Tous les caractères sont tapés via l’IME, mais les utilisateurs peuvent toujours désactiver l’IME. - inactif Les caractères sont tapés sans l’IME, même si les utilisateurs peuvent toujours activer l’IME. |
| Indexé |
Boolean facultatif. TRUE si la colonne est indexée pour une utilisation dans les filtres d’affichage. |
| IsolateStyles |
Boolean facultatif. Pour un champ Text dont l’attribut RichText a la valeur TRUE et dont l’attribut RichTextMode a la valeur FullHtml, cet attribut spécifie qu’un serveur réécrira le code HTML du champ pour s’assurer qu’il n’interférera pas avec l’affichage de la page voisine. |
| IsRelationship |
Boolean facultatif. TRUE si le champ est détectable à partir de la liste dans laquelle il cherche sa valeur. |
| JoinColName |
Text facultatif. Cet attribut n’est défini que pour les champs de recherche. Il est très similaire à ColName, si ce n’est qu’il indique le nom de la colonne utilisée dans la jointure SQL (JOIN) entre les listes locale et externe. Ordinairement, cette valeur ne doit pas être personnalisée. Elle n’est actuellement utilisée que dans le schéma du champ de certains champs intégrés ou de type de base pour indiquer les recherches dans la table des URL (DocMd), jointe sur la colonne UrlID. |
| JoinRowOrdinal |
Integer. facultatif. Non destiné à une utilisation directe à partir de votre code. |
| JoinType |
Text facultatif. Spécifie le type d’instruction de jointure (JOIN) utilisé sur le champ. Les valeurs possibles sont INNER, LEFT OUTER et RIGHT OUTER. |
| LCID |
Facultatif Integer. L’attribut LCID peut être utilisé pour spécifier le pays ou la région dont le format monétaire est utilisé : par exemple, 1033 pour les États-Unis. Deux cas spéciaux impliquent le format de symbole de l’euro. Si LCID =-1 (0xFFFFFFF), le symbole de l’euro est ajouté en tant que préfixe au nombre. Si LCID =-2 (0xFFFFFFE), le symbole de l’euro est ajouté comme suffixe au nombre. Le nombre de chiffres décimaux est 2, bien que cela puisse être substitué par l’attribut Decimals du champ. Le symbole monétaire de l’euro est égal à 0x20AC dans UCS-2. |
| LinkToItem |
Facultatif Boolean. |
| LinkToItemAllowed |
Texte facultatif. |
| Liste |
Argument Text facultatif. Spécifie le nom interne d’une liste. |
| ListItemMenu |
Facultatif Boolean. |
| ListItemMenuAllowed |
Texte facultatif. |
| Max |
Number facultatif. Spécifie la valeur maximale autorisée pour le champ. |
| MaxLength |
Valeur de type Integer facultative. Spécifie le nombre maximal de caractères autorisés dans une valeur de champ. Les formulaires d'édition sont ajustés pour permettre l'application de cette valeur, qui est validée sur le client. Si l'utilisateur tente d'entrer plus de caractères que le nombre défini par MaxLength, un message d'erreur s'affiche. |
| Min |
Number facultatif. Spécifie la valeur minimale autorisée pour la champ. |
| Mult |
Argument Boolean facultatif. Facteur d’échelle utilisé dans la multiplication avant l’affichage d’un nombre. |
| Name |
Argument Text obligatoire. Nom d’un champ. Il s’agit du nom interne d’un champ et est conçu de manière à ne pas évoluer durant toute la durée de vie de la définition de champ. Il doit être unique par rapport à l’ensemble des champs dans une liste. Le nom est généré automatiquement en fonction du nom d’un champ défini par l’utilisateur. |
| NegativeFormat |
Text facultatif. Spécifie comment indiquer les valeurs négatives. Peut être défini avec l’une des valeurs suivantes : - MinusSign Utilisez le signe moins comme préfixe. - Parens Entourez-les de parenthèses. |
| Node |
Text facultatif. Utilisé dans les formulaires XML, cet attribut est obligatoire pour tous les champs à l’exception des liens d’instructions de traitement et spécifie l’expression XPath d’un nœud promu. |
| NoEditFormBreak |
Boolean facultatif. TRUE pour empêcher qu’un saut de ligne ne soit ajouté entre les champs d’un nouveau formulaire d’élément et ou d’un formulaire de modification de l’élément. Certains types de champs, comme un texte de champ enrichi, fournissent un espacement par défaut, et cet attribut permet de contrôler l’espacement supplémentaire qui en résulte. |
| NumLines |
Argument Integer facultatif. Recommande le nombre de lignes (lignes) à afficher dans un bloc TEXTAREA pendant la modification. Il s’agit simplement d’une indication de l’interface utilisateur du client ; aucune limitation n’est imposée sur le nombre de lignes de texte qui peut être modifié. |
| Percentage |
Boolean facultatif. TRUE si la valeur est affichée sous forme de pourcentage, à savoir un nombre multiplié par 100 avec ajout du symbole pourcentage (%). |
| PIAttribute |
Text 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 aussi 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. |
| PrependId |
Argument Boolean facultatif. Utilisé dans les listes de suivi des problèmes, TRUE pour afficher les ID de collection des problèmes connexes dans les formulaires d'édition et de création d'éléments. |
| Présence |
Boolean facultatif. TRUE si les informations utilisateur sont présentes pour le champ. |
| PrimaryKey |
Boolean facultatif. TRUE si le champ est la clé primaire des relations entre la liste et une autre liste. |
| PrimaryPIAttribute |
Text facultatif. Utilisé pour la promotion et la rétrogradation de propriétés dans les documents XML. 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. S’il est spécifié, 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. |
| 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. S’il est spécifié, 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. En outre, la définition de ReadOnly avec la valeur TRUE masque le champ dans les pages Paramètres du site pour gérer les colonnes de site et les types de contenu. 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 cet attribut avait la valeur False. |
| ReadOnlyEnforced |
Boolean facultatif. TRUE pour spécifier que l’utilisateur ne peut modifier le champ par aucun moyen et que le champ ne peut être changé que par le système. |
| RelationshipDeleteBehavior |
Text facultatif. Spécifie le comportement de suppression du champ. Les valeurs admises sont Cascade, Restrict et None. |
| RenderXMLUsingPattern |
Boolean facultatif. Utilisé pour les champs calculés pour déterminer le format d’affichage. Si la valeur est TRUE, les valeurs sont restituées à partir du modèle d’affichage du champ calculé, et non sur la valeur de colonne de la première référence de champ non calculé sur laquelle est fondé le champ calculé. Par exemple, dans une bibliothèque d’images, la colonne Taille de l’image est représentée par la largeur x hauteur, mais si cet attribut n’est pas définie sur TRUE, seule la première référence de champ, largeur, est affichée. Si elle est définie sur TRUE, le format de largeur x hauteur s’affiche. |
| Obligatoire |
Facultatif Boolean. Si la valeur est TRUE, le champ ne doit pas se voir affecter une valeur vide. Si aucune valeur de champ nonempty n’est indiquée dans un billet de formulaire, le texte standard du champ obligatoire ou un message explicitement spécifié (c’est-à-dire, via des balises) s’affiche dans le formulaire d’erreur. Cette validation est gérée uniquement par le client (la base de données autorise toujours NULL pour tous les champs définis par l’utilisateur). |
| RestrictedMode |
Boolean facultatif. TRUE pour interdire au champ Note de contenir une mise en forme améliorée de texte enrichi, telle que images, tableaux ou liens hypertexte, ou de coller dans le champ un texte mis en forme. |
| ResultType |
Text facultatif. Spécifie le type de données des valeurs renvoyées depuis le champ. |
| RichText |
Boolean facultatif. TRUE si le champ affiche une mise en forme de texte enrichi. |
| RowOrdinal |
Integer facultatif. Spécifie l’emplacement de base de données pour le champ. |
| Sealed |
Argument Boolean facultatif. La définition de cet attribut sur TRUE pour un champ dans le fichier Schema.xml pour une liste marque le champ comme étant inamovible dans la page Modifier la colonne. |
| SeparateLine |
Boolean facultatif. Utilisé en interne pour prendre en charge la restitution d’un champ (par exemple, Notes ou Commentaire) sur une ligne distincte. Cet attribut n’est pas destiné à une utilisation publique. |
| SetAs |
Non destiné à une utilisation directe depuis votre code. |
| ShowAddressBookButton |
Non destiné à une utilisation directe depuis votre code. |
| ShowAlways |
Facultatif Boolean. |
| ShowField |
Facultatif. L'attribut ShowField peut être défini par le nom du champ à afficher. Par défaut, un texte à lien hypertexte provenant du champ Titre de l'enregistrement dans la liste externe est affiché. Mais l'attribut ShowField peut être utilisé pour substituer cela et afficher un autre champ de la liste externe. Les types de données suivants sont autorisés comme cibles d'un attribut ShowField : Text, Choice et Counter. Pour un champ Lookup, ce paramètre doit être défini sur le nom de champ interne ; définir le nom complet ne déclenche pas d'erreur, mais brise le champ. |
| ShowInDisplayForm |
Boolean facultatif. TRUE pour afficher le champ du formulaire d’affichage en vue de voir l’élément. |
| ShowInEditForm |
Boolean. TRUE pour afficher le champ du formulaire en vue de modifier l’élément. |
| ShowInFileDlg |
Boolean facultatif. Cet attribut n’est valide que pour les champs des schémas de bibliothèque de documents. Si la valeur est FALSE, le champ n’apparaît pas dans la boîte de dialogue Propriétés qui permet d’enregistrer les formulaires et qui s’affiche lors de l’enregistrement à partir des applications clientes. Par exemple, le champ Titre possède cet attribut, car celui-ci est défini directement dans le document enregistré dans la bibliothèque de documents. |
| ShowInListSettings |
Boolean facultatif. TRUE pour afficher la colonne sur la page de personnalisation des paramètres de liste. |
| ShowInNewForm |
Boolean facultatif. 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. Ce paramètre est utilisé en particulier pour masquer les champs sur la page de téléchargement des documents sur la bibliothèque de documents. |
| ShowInVersionHistory |
Boolean facultatif. TRUE pour afficher la colonne sur la page d’affichage des versions des éléments de liste. |
| ShowInViewForms |
Boolean facultatif. TRUE pour spécifier que le champ s’affiche dans les pages utilisées pour visualiser les données de liste. |
| Triable |
Boolean facultatif. TRUE si les valeurs du champ peuvent être triées. |
| SourceID |
Texte facultatif. Contient l’espace de noms qui définit le champ, tel que , ou le GUID de la liste dans laquelle le http://schemas.microsoft.com/sharepoint/v3 champ personnalisé a été créé. |
| StaticName |
Argument Text facultatif. Contient le nom interne du champ. |
| StorageTZ |
Spécifie comment les valeurs date/heure sont stockées. Quand StorageTZ a la valeur UTC, la valeur date/heure est gérée au format UTC. Pour indiquer qu’une valeur date/heure fait référence à une heure « abstraite », ce qui signifie que la valeur date/heure est stockée dans la base de données telle qu’elle a été entrée par l’utilisateur sans conversion ou stockage du fuseau horaire local, omettez l’attribut StorageTZ. |
| StripWS |
Boolean facultatif. TRUE si les espaces blancs sont supprimés en début et en fin des valeurs des champs. |
| SuppressNameDisplay |
Boolean facultatif. TRUE pour ne pas afficher le nom de l’utilisateur dans un champ User. |
| TextOnly |
Boolean facultatif. Si la valeur est TRUE, le champ ne peut contenir que des valeurs Text. |
| Titre |
Facultatif Text. Contient l’intitulé du champ affiché dans l’interface utilisateur. |
| Type (Type) |
Text obligatoire. Type de données du champ (à moins que l’élément Field ne soit un enfant de ProjectedFields). REMARQUE: dans la version d’aperçu de technologie de Microsoft SharePoint Foundation 2010, l’attribut Type a une signification différente et une seule valeur possible (« Recherche ») lorsqu’il est enfant de ProjectedFields. Pour plus d’informations sur cette utilisation de Type, voir ProjectedFields, élément (View). SharePoint Foundation inclut les types de données suivants par défaut : - AllDayEvent Spécifie un événement toute la journée. Correspond au type de données SQL bit. - Pièces jointes Stocke les URL des pièces jointes. Correspond au type de données SQL bit. - Booléen Utilisé pour stocker une valeur TRUE FALSE (stockée dans la base de données sous la valeur / 0 ou 1). Le champ peut être à la fois trié et regroupé. Correspond au bit SQL type de données et est représenté par la classe SPFieldBoolean. - Calculé Spécifie un champ dont la valeur est calculée en fonction d’autres colonnes. Correspond au type sql_variant SQL données et est représenté par la classe SPFieldCalculated. - Choix Permet à l’utilisateur de spécifier un ensemble prédéterminé de valeurs qui peuvent être utilisées pour entrer des données dans le champ. Les types Choice et Lookup sont les champs les plus importants pour le tri et le regroupement. Les attributs BaseType et Format peuvent être utilisés pour les champs Choix. Le champ peut être à la fois trié et regroupé. Lorsqu’une valeur est donnée pour une option de choix, cette valeur est utilisée comme valeur envoyée pour la sélection de champ. Quand aucune valeur n’est fournie, ce choix est soumis comme valeur texte du choix. Dans tous les cas, la valeur texte du choix est ce qui s’affiche dans l’interface utilisateur (texte de liste déroulante ou de case d’option). L’ordre dans lequel les choix apparaissent dans l’interface utilisateur de modification est toujours celui où les éléments sont spécifiés au sein de l’élément CHOICES. Utilisez le type MultiChoice pour spécifier un champ Choice qui implémente les cases à cocher et permet à l’utilisateur de sélectionner plusieurs valeurs. Correspond au type de données SQL nvarchar et est représenté par la classe SPFieldChoice. - Calculé Spécifie un champ qui dépend d’un autre champ pour son contenu. Par exemple, un champ LinkTitleNoMenu revient à entourer une valeur de champ Titre avec un lien hypertexte. Représenté par la classe SPFieldComputed. - ContentTypeId Contient un ID de type de contenu. Pour plus d’informations sur le format des ID de type de contenu, voir Content Type IDs. Correspond au type de données SQL varbinary. - Compteur Généralement utilisé uniquement pour le champ ID interne. Sa valeur, de type entier, est définie automatiquement de façon à être unique par rapport à tout autre élément de la liste courante. Le type Counter est toujours en lecture seule et ne peut pas être défini à travers une publication de formulaire. Ce champ peut être trié, mais non regroupé. Correspond au type de données SQL int. - CrossProjectLink Permet de connecter un événement dans une liste SharePoint à un site d’espace de travail de réunion ; fait référence spécifiquement au type de champ de la case à cocher utilisée dans les formulaires Nouvel et Modifier l’élément pour créer un site d’espace de travail de réunion pour l’élément. Correspond au bit SQL type de données et est représenté par la classe SPFieldCrossProjectLink. - Devise Permet d’entrer une valeur monétaire. Chaque champ monétaire est lié à la devise d’un paramètre local spécifique. Sur tous les autres plans, il est traité comme le type de champ Number. Utilisez l’attribut LCID pour indiquer une devise de paramètre régional spécifique. Les attributs Decimals, Max et Min peuvent être utilisés pour les types monétaires. Le champ peut être à la fois trié et regroupé. Correspond au type de données float SQL et est représenté par la classe SPFieldCurrency. - DateTime Permet le stockage d’une date ou d’une heure complète de la journée. Utilisez l’attribut Format pour spécifier la mise en forme de la date, et utilisez l’attribut StorageTZ pour déterminer comment les valeurs date/heure sont stockées. Ce champ peut être trié et regroupé. Pour le mode Affichage, l’ordre de la mise en forme des données dérive des paramètres régionaux (« M/J/A » ou « J/M/A »). En mode Modifier (ou en mode Nouveau pour la valeur d’élément Default), les dates/heures sont affichées au format universel : M/J/A hh:mm am/pm. Correspond au type de données SQL datetime et est représenté par la classe SPFieldDateTime. - Fichier Contient un fichier. Correspond au type de données SQL uniqueidentifier. - GridChoice Contient une échelle d’évaluation pour les enquêtes. Correspond au type de données SQL ntext et est représenté par la classe SPFieldRatingScale. - Guid Autorise les identificateurs globaux uniques (GUID). Correspond au type de données SQL uniqueidentifier. - Integer Autorise les valeurs d’unger positif ou négatif. Les attributs Commas et NegativeFormat sont utilisés pour spécifier la mise en forme des entiers. Correspond au type de données SQL int. - Recherche Se comporte de la même manière qu’un champ Choice, sauf que les options disponibles proviennent d’une autre liste plutôt qu’une sélection codée en dur de valeurs. Les attributs List et ShowField peuvent être utilisés pour les champs de recherche. Le champ peut être à la fois trié et regroupé. Pour le tri et le regroupement, utilisez la valeur DisplayField (Titre, par défaut), plutôt que la clé étrangère stockée dans la liste. Correspond au type de données SQL int et est représenté par la classe SPFieldLookup. - LookupMulti Champ de recherche qui peut contenir plusieurs valeurs. Type parent : Lookup. - ModStat Contient l’état d’approbation du contenu. Les valeurs possibles incluent Approved (par défaut), Rejected et Pending (stockées respectivement dans la base de données sous la forme 0, 1 ou 2). Correspond au type de données SQL int. - MultiChoice Spécifie un champ Choix qui implémente des cases à cocher et permet à l’utilisateur de sélectionner plusieurs valeurs. Correspond au type de données SQL texte et est représenté par la classe SPFieldMultiChoice. - MultiColumn Champ Note qui émule un champ contenant plusieurs valeurs. Pour obtenir un exemple de type de champ multicolonne, voir Custom Field Type Definition. Pour plus d’informations sur les champs multi-lumn, voir Custom Multicolumn Field Classes. Type parent : Note. - Remarque Permet aux utilisateurs d’entrer plusieurs lignes de texte. Ce champ ne peut être ni trié ni regroupé. Tout le texte est défini comme simples caractères ASCII sans balisage HTML. Tout ce qui s’apparente à du balisage HTML ou à une URL est simplement placé entre guillemets (par exemple, Server.HTMLEncode) pour s’apparenter à du texte simple. Le contrôle de modification du format est un simple bloc TEXTAREA. Utilisez l’attribut NumLines pour spécifier le nombre de lignes à afficher. Correspond au type de SQL ntext et est représenté par la classe SPFieldMultiLineText. - Number Permet d’entrer un nombre à point flottant. Ce champ peut être trié et regroupé. Les nombres entrés sont analysés selon les paramètres régionaux courants relatifs aux virgules décimales et aux séparateurs de milliers. Les nombres négatifs peuvent être indiqués en étant placés entre parenthèses ou à l’aide du symbole moins (-). Les attributs suivants peuvent être utilisés en liaison avec l’attribut Number pour spécifier la mise en forme des nombres : Decimals, Div, Max, Min, Mult et Percentage. Correspond au type de données float SQL et est représenté par la classe SPFieldNumber. - PageSeparator Insère un pause de page dans une liste d’enquêtes. Représenté par la classe SPFieldPageSeparator. - Recurrence Utilisé pour modifier et définir la récurrence d’un élément dans une liste d’événements. Correspond au type de données SQL bit. - Texte Une seule ligne de texte entrée dans une zone d’édition. Le champ peut être à la fois trié et regroupé. Utilisez l’attribut MaxLength pour définir le nombre maximal de caractères autorisé. Correspond au type de données SQL nvarchar et est représenté par la classe SPFieldText. - ThreadIndex Contient l’ID qui indique la position relative d’un message dans un thread de conversation. Correspond au type de données SQL varbinary. - Threading Le type de champ Threading est utilisé dans la création et l’affichage de vues threadées de type discussion. Une liste peut contenir un colonne de threading, mais une interface utilisateur particulière est générée en cas d’utilisation. (Il n’est jamais affiché en tant que champ modifiable standard dans un formulaire ni en tant que colonne normale dans un affichage.) Si un tri est effectué sur un champ de thread, une traversée préalable de tous les enregistrements d’une relation parent-enfant est renvoyée. L’opération est effectuée en enregistrant la concaténation de la date de création et du numéro d’ID de tous les enregistrements parents d’un enregistrement particulier. Correspond au type de données SQL varchar. - URL Utilisé pour créer un lien hypertexte de forme libre. Un champ d’URL s’affiche comme <A HREF="URL">Description</A> . Si aucune description n’est donnée, elle s’affiche comme <A HREF="URL">URL</A> . Le texte de l’URL est lui-même stocké dans la table des URL (DocMd), qui stocke toutes les URL dans les bases de données SharePoint du serveur. De cette façon, toute URL locale au serveur peut être mise à jour au travers d’une correction de lien en cas de déplacement de destination. Quand un enregistrement avec un champ URL en son sein est supprimé, l’enregistrement référencé correspondant de la table des URL est également supprimé. Le champ peut être à la fois trié et regroupé. (Le tri est défini en fonction de la description textuelle plutôt que du contenu de l’URL ; si aucune description n’est donnée, il trie comme vide.) Lorsque Type est une URL, l’attribut LinkType peut être utilisé pour spécifier le type de lien. Correspond au type de données SQL nvarchar et est représenté par la classe SPFieldUrl.- Utilisateur Champ De recherche qui fait référence à la table de base de données UserInfo. Correspond au type de données int SQL et est représenté par la classe SPFieldUser. - UserMulti Champ Utilisateur qui peut contenir plusieurs valeurs. Type parent : LookupMulti. - WorkflowEventType Spécifie un type d’événement de flux de travail tel qu’il est représenté par l’éumération SPWorkflowHistoryEventType. Type parent : Integer. - WorkflowStatus Spécifie l’état du flux de travail tel que représenté par l’éumération SPWorkflowStatus. Correspond au type de données SQL nvarchar. |
| UniqueID |
Text facultatif. Non destiné à une utilisation directe depuis votre code. |
| UnlimitedLengthInDocumentLibrary |
Boolean facultatif. TRUE pour permettre une longueur de champ illimité dans les bibliothèques de documents. |
| URLEncode |
Facultatif Boolean. TRUE pour convertir des caractères spéciaux, tels que des espaces, au format UTF-8, par exemple, %c3%ab pour le caractère ë . |
| URLEncodeAsURL |
Facultatif Boolean. Comme URLEncode, mais TRUE pour spécifier que la chaîne à coder est un composant de chemin d’accès d’une URL afin que les barres obliques ( ) ne soient pas / codées. |
| UserSelectionMode |
Facultatif Text. Spécifie si seuls les noms des utilisateurs individuels peuvent être sélectionnés dans un champ utilisateur d’un formulaire d’élément, ou si les noms des groupes et des individus peuvent être sélectionnés ensemble. Les valeurs possibles sont les suivantes : 0 - Seuls les noms des individus peuvent être sélectionnés. 1 - Les noms des individus et des groupes peuvent être sélectionnés. |
| UserSelectionScope |
Integer facultatif. Spécifie une étendue pour la sélection des noms d’utilisateur dans un champ utilisateur d’un formulaire d’élément. Si la valeur est égale à 0, il n’existe aucune restriction à un groupe SharePoint. Si la valeur est supérieure à 0, la sélection utilisateur est limitée aux membres du groupe SharePoint dont l’ID équivaut à la valeur spécifiée. |
| Version |
Texte facultatif. |
| Consultable |
Boolean facultatif. TRUE pour spécifier que le champ est ajouté à l’affichage par défaut. La valeur par défaut est TRUE. |
| WebId |
Texte facultatif. |
| Width |
Integer facultatif. Spécifie la largeur en pixels des images affichées pour les utilisateurs dans la liste d’informations utilisateur. |
| WikiLinking |
Facultatif Boolean. TRUE pour spécifier que les liens Wiki, qui apparaissent sous la forme de crochets doubles ( ), sont traduits en liens [[…]] HTML, qui utilisent la <A> balise. |
| XName |
Text facultatif. Utilisé en interne dans les formulaires XML pour identifier les champs qui ont été ajoutés, supprimés ou modifiés. Cet attribut n’est pas destiné à une utilisation publique. |
Éléments enfants
- CHOICES
- Personnalisation
- Par défaut
- DefaultFormula
- DisplayBidiPattern
- DisplayPattern
- FieldRefs
- Formule
- FormulaDisplayNames
- MAPPAGES
- Valider
Éléments parents
Occurrences
- Minimum : 0
- Valeur maximale : Illimitée lorsque le parent est Fields. Lorsque le parent est ProjectedFields,le maximum est la différence entre le nombre maximal de champs autorisés dans la liste principale interrogée et le nombre de champs déjà dans la liste.
Remarques
Pour créer une définition de champ personnalisé pour une définition de liste basée sur un type de champ SharePoint Foundation par défaut, utilisez l’élément Field (List - Definition) dans un fichierSchema.xml.
Pour créer une définition de champ personnalisé en tant que fonctionnalité en plug-able basée sur un type de champ par défaut et qui peut être réutilisée sur des sites web et des listes au sein d’une collection de sites, utilisez l’élément Field (Field) pour définir une colonne de sitepersonnalisée.
Pour créer un type de champ personnalisé qui implémente une classe personnalisée pour la validation de données spéciales et le rendu de champ, utilisez l'élément Champ (Types de champs).
Les champs peuvent être référencés à partir de définitions d'affichage ou d'expressions contenues dans des éléments de rendu de champ calculé. Utilisez l'élément Field (View) pour renvoyer une valeur de champ mis en forme à afficher dans une vue et utilisez l'élément Column (View) pour renvoyer la valeur des données brutes du champ.
La syntaxe pour faire référence à un champ se présente comme suit :
<Field Name="FieldName"/>
Par défaut, le champ est rendu avec les attributs par défaut de cette définition de champ comme indiqué dans le tableau précédent. Tous les attributs de champ peuvent être remplacer dans le markup CAML de l’attribut FieldRef, qui remplace la définition donnée pour le champ lui-même (l’attribut Type d’un champ ne peut pas être modifié).
Pour afficher le nom complet défini par l’utilisateur d’un champ, vous pouvez utiliser <Property Select="DisplayName"/> .
Dans une énumération d'éléments Fields, l'attribut Name peut être omis. Pour certaines références de champ, les données brutes stockées pour le champ sont accessibles à l’aide de <Column/> .
Certaines propriétés de champs provenant de formulaires et de certains aspects de l’interface utilisateur de la auteur peuvent être rendues via l’élément Property, par <Property Select="Description"/> exemple, ou <Property Select="Type"/> . Ces éléments récupèrent simplement la valeur de n’importe quel attribut de champ ou élément enfant (Property) par son nom.
Outre les types précédents, les champs prédéfincés suivants sont utilisés avec l’élément Field :
|**Name**|**Description**| |:-----|:-----| |**Created**
|Champ qui contient une valeur **DateTime** spécifiant l’heure à laquelle l’élément a été créé (en UTC).
| |**CreatedBy**
|Champ qui contient une valeur **Lookup** qui fait référence à la table UserInfo et indique l’utilisateur qui a créé l’élément.
| |**Edit**
|Champ calculé (sans schéma supplémentaire) qui contient un lien hypertexte vers le formulaire de modification d’un élément. Ce champ fait référence à la page qui permet de modifier l’élément et au champ ID qui permet de l’identifier.
| |**ID**
|Type de champ **Counter** associé à chaque élément dans chaque liste. L’ID identifie de manière unique l’élément de liste dans les URL et dans les formulaires POST lors de la modification. Spécifier **New** en tant que valeur de l’attribut **ID** dans la commande **Cmd=Save** crée un élément au lieu de modifier un élément actuel.
| |**Modified**
|Champ qui contient une valeur **DateTime** spécifiant l’heure à laquelle l’élément a été modifié pour la dernière fois (en UTC). L’heure **Modified** est également utilisée comme un tri du champ **Version**. La date de la dernière modification d’un élément est toujours publiée lorsqu'un élément existant est en cours de modification. Si elle ne correspond pas à la date de modification actuelle, le serveur ne parvient pas à effectuer la modification et retourne une erreur à l’utilisateur, en fournissant un lien vers les données actuelles sur le serveur (qui apparaissent dans une nouvelle fenêtre), de sorte que les valeurs publiées peuvent être copiées à partir du formulaire ancien vers le nouveau.
| |**ModifiedBy**
|Champ qui contient une valeur **Lookup** de la table UserInfo indiquant le dernier utilisateur ayant modifié l’élément.
| |**Titre**
|Nom générique complet de chaque élément. Il peut avoir un nom complet différent dans différentes listes, mais le même nom de champ interne de **Title**.Le titre est le texte par défaut à afficher pour les champs **Lookup** dans les listes.
| |**LinkTitle**
|Champ calculé qui affiche des liens hypertexte vers des éléments, contenant les textes de titre et générant des URL (et de nouvelles références d’icône) vers les éléments. Il n’existe pas de stockage supplémentaire pour ce champ ; il s’appuie sur les champs d’ID et de titre pour le rendu de son interface utilisateur.
|
Notes
Les champs retournés dans une énumération Fields sont affectés par le mode d’affichage. Les champs qui sont marqués avec l’attribut Hidden ne sont jamais retournés. Les champs qui sont marqués avec l’attribut ReadOnly ne sont pas retournés si un formulaire est en cours de rendu (si Fields est appelé depuis un élément ListForm). Les champs qui sont marqués avec l’attribut ShowInNewForm ne sont pas retournés dans les modes d’affichage NEW ou PREVIEWNEW. Les champs marqués avec l’attribut ShowInFileDlg ne sont pas retournés lors du rendu du formulaire de boîte de dialogue NewForm.
Exemple
L’exemple suivant utilise l’élément Field pour spécifier les options d’une liste nommée Area list :
<Field Type="Choice" BaseType="Text" Name="Area">
<CHOICES>
<CHOICE>Views</CHOICE>
<CHOICE>Site Design</CHOICE>
<CHOICE>Layouts</CHOICE>
<CHOICE>Schema Design</CHOICE>
<CHOICE>Fields</CHOICE>
<CHOICE>Forms</CHOICE>
<CHOICE>Projects</CHOICE>
<CHOICE>Inter-Team Issues</CHOICE>
<CHOICE>Schedule</CHOICE>
<CHOICE>Spec</CHOICE>
<CHOICE>Headcount</CHOICE>
<CHOICE>Misc</CHOICE>
</CHOICES>
</Field>
Voir aussi
- Élément Column (View)
- Élément Column2 (View)
- Élément Field (Field)
- Élément Field (View)
- Élément Field (Site)
- Élément Field (Types de champs)
- Field, élément (Field Types Property Schema)
- Élément Field (DeploymentManifest - DeploymentFieldTemplate)
- Élément Field (DeploymentManifest - FieldDataCollection)
- Élément Field (DeploymentManifest - SPFieldCollection)