Éléments de définition de données
S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013
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. Ceux-ci peuvent apparaître dans les définitions de type de champ ou, plus généralement, dans FldTypes.xml à l’adresse \\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 d’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.
| Name | 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 |
Remarque |
Contient le modèle HTML pour rendre le champ en mode vue ou formulaire. |
| EditPattern |
Remarque |
Contient le modèle HTML pour générer le contrôle de formulaire de modification pour modifier le champ. |
| HeaderPattern |
Remarque |
Contient le modèle HTML pour afficher l'en-tête d'une colonne d'affichage en mode table. |
| InternalType |
Text |
Détermine à la fois le comportement de l’élément Column dans le rendu des données de la base de données SharePoint Foundation et la façon dont les données sont publié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 que référencé dans un attribut Type de l’élément Field : <Field Type="Name"/>. Exemples : Text, Note, Number, etc. |
| NewPattern |
Remarque |
Contient le modèle HTML permettant de générer le nouveau formulaire pour modifier la valeur initiale d'un champ. |
| PreviewDisplayPattern |
Remarque |
Spécifie le mode de rendu des champs lorsqu’un formulaire d’affichage est modifié dans Microsoft SharePoint Designer. |
| PreviewEditPattern |
Remarque |
Spécifie le mode de rendu des champs lorsqu’un formulaire de modification est modifié dans Microsoft SharePoint Designer. |
| PreviewNewPattern |
Remarque |
Spécifie le mode de rendu des champs lorsqu’un nouveau formulaire est modifié dans Microsoft SharePoint Designer. |
| Triable |
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 d’affichage et modèles d’affichage
Chacun des modes d’affichage (Afficher, Modifier et Nouveau) contient une définition du rendu de chacun des types 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 |
|---|---|
| Colonne |
Renvoie la valeur des données brutes pour un champ précis. |
| Colonne2 |
Utilisé dans le rendu d'un type de champ de lien. |
| Échapper |
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 |
Retourne 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. |
| Limite |
Tronque le texte jusqu'à une taille spécifiée. |
| Informations sur les paramètres régionaux |
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. |
| Propriété |
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. |
| Aujourd’huiISO |
Affiche la date et heure du jour au format ISO. |