Partager via


Éléments de définition de données

Dernière modification : vendredi 26 mars 2010

S’applique à : SharePoint Foundation 2010

Le langage CAML (Collaborative Application Markup Language) possède deux principaux types d’éléments : ceux utilisés pour le rendu des pages et ceux utilisés pour le rendu des champs et pour les définitions de schéma. Les éléments de rendu de champ CAML sont destinés à être utilisés lors du rendu des valeurs de champs individuels. Ces valeurs peuvent apparaître dans les définitions de type de champ ou, plus généralement, dans FldTypes.xml sous \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATES\XML.

Rendu de champ et définition de schéma

Un champ est une colonne ou un attribut contenant des informations qu’un utilisateur peut ajouter à une liste. Chaque liste sur un site Web basé sur Microsoft SharePoint Foundation contient des métadonnées stockées dans la base de données. Le format du schéma est une structure XML, telle que la suivante :

<Fields>
  <Field Type="Counter" Name="ID"/>
  ...other field definitions...
</Fields>

Pour simplifier l’implémentation des différents types de champs et pour autoriser un niveau supérieur de souplesse dans leur rendu, le fichier FldTypes.xml contient des informations sur le rendu et le comportement de chaque type de champ. L’élément Field rend un HTML différent en fonction du type de données du champ concerné, et le fichier FldTypes.xml définit les types de données et les modèles de rendu pour chaque type de champ. Le tableau suivant présente le schéma utilisé dans ce fichier.

Nom

Type de données

Description

Column2Suffix

Text

Contient le texte à ajouter au nom de la colonne de base pour dériver ColumnName2 de ColumnName (pour les champs à deux colonnes tels que URL).

DisplayPattern

Note

Contient le modèle HTML pour rendre le champ en mode vue ou formulaire.

EditPattern

Note

Contient le modèle HTML pour générer le contrôle de formulaire de modification pour modifier le champ.

HeaderPattern

Note

Contient le modèle HTML pour afficher l'en-tête d'une colonne d'affichage en mode table.

InternalType

Text

Détermine le comportement de l'élément Column pour le rendu des données de la base de données SharePoint Foundation et la façon dont les données sont republiées dans la base de données. Les valeurs possibles sont les suivantes : Text, Note, Number, Currency, Integer, Boolean, DateTime, Threading, Lookup, Choice, URL, Counter ou DisplayOnly. Notez qu'un type de champ DisplayOnly ne contient aucun stockage qui lui est propre.

Name

Text

Contient le nom du type de données interne tel qu’il est référencé dans un attribut Type de l’élément Field : <Field Type="Name"/>. Exemples : Text, Note, Number, etc.

NewPattern

Note

Contient le modèle HTML permettant de générer le nouveau formulaire pour modifier la valeur initiale d'un champ.

PreviewDisplayPattern

Note

Spécifie la façon dont les champs sont rendus lorsqu’un formulaire d’affichage est modifié dans Microsoft SharePoint Designer.

PreviewEditPattern

Note

Spécifie la façon dont les champs sont rendus lorsqu’un formulaire de modification est édité dans Microsoft SharePoint Designer.

PreviewNewPattern

Note

Spécifie la façon dont les champs sont rendus lorsqu’un nouveau formulaire est modifié dans Microsoft SharePoint Designer.

Sortable

Text

Spécifie si un champ peut être trié. Peut prendre la valeur TRUE ou FALSE.

TypeName

Text

Spécifie un nom dans la définition d'un type de champ.

SQLType

Text

Détermine le type de données SQL sous-jacent pour le champ donné. Exemples : nvarchar(255), memo, integer, float. Utilisé pour générer le code SQL approprié (CREATE TABLE) permettant de créer un champ de ce type.

SQLType2

Text

Si une valeur est indiquée, donne le type d'une colonne secondaire à créer pour le champ actuel (voir Type de champ d'URL, par exemple).

Modes et modèles d'affichage

Chaque mode d'affichage (Display, Edit et New) contient une définition qui spécifie comment rendre chaque type de données de champ pris en charge par SharePoint Foundation.

Pour chaque mode d'affichage, il existe un modèle d'affichage ou une expression de rendu CAML. Certains éléments CAML sont utilisés spécifiquement dans des modèles d'affichage. D'autres sont utilisés soit pour le rendu des pages, soit pour le rendu des champs, mais principalement pour le rendu des champs. Les éléments de rendu CAML intrinsèques suivants, sont utilisés pour créer des modèles qui peuvent inclure du HTML statique et des données, ainsi que les métadonnées du champ rendu.

Élément

Description

Column

Renvoie la valeur des données brutes pour un champ précis.

Column2

Utilisé dans le rendu d'un type de champ de lien.

Escape

Utilisé pour ignorer certains caractères dans des chaînes.

FieldFilterOptions

Utilisé dans les sections HeaderPattern de FldTypes.xml pour afficher des menus déroulants de filtre.

FieldPrefix

Renvoie l'espace de noms Microsoft Office, "urn:schemas-microsoft-com:office:office#".

FieldRef

Utilisé dans les champs calculés pour faire référence aux champs constitutifs et dans les affichages afin de définir les champs présents.

FieldSortImageURL

Renvoie l'URL d'accès au fichier image utilisé pour indiquer comment une colonne est triée.

FieldSortParams

Renvoie le sens du tri sur une liste, le rendu Asc ou Desc selon que le champ a été trié, et le sens du tri par défaut actuel pour le champ.

IfEqual

Permet le rendu conditionnel basé sur la comparaison de deux expressions CAML.

IfNew

Renvoie TRUE si l'élément est considéré comme nouveau.

ImagesPath

Renvoie le chemin d'accès HTTP dans le répertoire des images du projet.

Limit

Tronque le texte jusqu'à une taille spécifiée.

LocaleInfo

Transfère les informations de paramètres régionaux du serveur au client afin d'afficher et de modifier correctement les dates et les nombres.

PageUrl

Utilisé n'importe où pour renvoyer l'URL codée, absolue, de la page actuelle.

Property

Renvoie la propriété à partir du contexte ForEach actuel.

ScriptQuote

Utilisé pour le rendu du texte à partir du serveur qui doit être interprété comme une chaîne entre guillemets.

TodayISO

Affiche la date et heure du jour au format ISO.

Voir aussi

Référence

Éléments de rendu HTML