É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 |
---|---|
Renvoie la valeur des données brutes pour un champ précis. |
|
Utilisé dans le rendu d'un type de champ de lien. |
|
Utilisé pour ignorer certains caractères dans des chaînes. |
|
Utilisé dans les sections HeaderPattern de FldTypes.xml pour afficher des menus déroulants de filtre. |
|
Renvoie l'espace de noms Microsoft Office, "urn:schemas-microsoft-com:office:office#". |
|
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. |
|
Renvoie l'URL d'accès au fichier image utilisé pour indiquer comment une colonne est triée. |
|
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. |
|
Permet le rendu conditionnel basé sur la comparaison de deux expressions CAML. |
|
Renvoie TRUE si l'élément est considéré comme nouveau. |
|
Renvoie le chemin d'accès HTTP dans le répertoire des images du projet. |
|
Tronque le texte jusqu'à une taille spécifiée. |
|
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. |
|
Utilisé n'importe où pour renvoyer l'URL codée, absolue, de la page actuelle. |
|
Renvoie la propriété à partir du contexte ForEach actuel. |
|
Utilisé pour le rendu du texte à partir du serveur qui doit être interprété comme une chaîne entre guillemets. |
|
Affiche la date et heure du jour au format ISO. |