View, élément (List)
Dernière modification : jeudi 15 juillet 2010
S’applique à : SharePoint Foundation 2010
Dans cet article
Attributs
Éléments enfants
Éléments parents
Occurrences
Dans une définition de liste (Schema.xml, définit un affichage pour une liste dans un site Web basé sur Microsoft SharePoint Foundation, où chaque liste peut contenir une série d’affichages.
Notes
SharePoint Foundation 2010 utilise XSLT pour définir les affichages de liste, et le schéma d’affichage est conservé pour des raisons de compatibilité descendante. Pour plus d’informations sur les affichages de liste XSLT, voir Affichages de liste.
<View
AggregateView = "TRUE" | "FALSE"
BaseViewID = "Integer"
ContentTypeID = "Text" CssStyleSheet = "Text"
DefaultView = "TRUE" | "FALSE"
DefaultViewForContentType = "TRUE" | "FALSE"
DisplayName = "Text"
FailIfEmpty = "TRUE" | "FALSE"
FileDialog = "TRUE" | "FALSE"
FPModified = "TRUE" | "FALSE"
FreeForm = "TRUE" | "FALSE"
Hidden = "TRUE" | "FALSE"
ImageUrl = "Text"
IncludeRootFolder = "TRUE" | "FALSE"
List = "Integer" | "Text"
MobileDefaultView = "TRUE" | "FALSE" MobileItemLimit = "Integer" MobileUrl = "Text"
MobileView = "TRUE" | "FALSE"
ModerationType = "Text"
Name = "Text"
OrderedView = "TRUE" | "FALSE"
PageType = "Text"
Path = "Text"
ReadOnly = "TRUE" | "FALSE"
RecurrenceRowset = "TRUE" | "FALSE"
ReqAuth = "TRUE" | "FALSE"
RequiresClientIntegration = "TRUE" | "FALSE"
RowLimit = "Integer"
Scope = "Text"
SetupPath = "Text"
ShowHeaderUI = "TRUE" | "FALSE" TabularView = "TRUE" | "FALSE"
TargetId = "Text"
TargetType = "List" | "ContentType"
Threaded = "TRUE" | "FALSE"
ToolbarTemplate = "Text"
Type = "HTML" | "Chart" | "Pivot"
Url = "Text"
WebPartOrder = "Integer"
WebPartZoneID = "Text">
</View>
Attributs
|
Attribut |
Description |
|
|---|---|---|
|
AggregateView |
Argument Boolean facultatif. TRUE pour spécifier que l’affichage est un vue Fusionner les formulaires utilisée dans une bibliothèque de formulaires XML. Par défaut, une bibliothèque de formulaires XML possède une vue Fusionner les formulaires qui est initialement masquée. Lorsqu’un éditeur XML est utilisé pour publier un fichier XFP (XML Form Properties) dans le répertoire Forms de la bibliothèque avec un modèle utilisé par l’éditeur, l’attribut AggregateView identifie la vue Fusionner les formulaires. Cette vue peut être rendue visible ou masquée selon que la définition ou le modèle de liste pour la bibliothèque prend ou non en charge la fusion des données. |
|
|
BaseViewID |
Argument Integer facultatif. Spécifie l’ID de l’affichage de base. |
|
|
ContentTypeID |
Argument Text facultatif. Spécifie l’ID du type de contenu auquel l’affichage est associé. |
|
|
CssStyleSheet |
Argument Text facultatif. |
|
|
DefaultView |
Argument Boolean facultatif. TRUE pour spécifier que l’affichage est l’affichage par défaut. |
|
|
DefaultViewForContentType |
Argument Boolean facultatif. TRUE pour spécifier que l’affichage est l’affichage par défaut d’un type de contenu. |
|
|
DisplayName |
Argument Text facultatif. Spécifie le nom de l’affichage qui apparaît sur la barre Lancement rapide. |
|
|
FailIfEmpty |
Argument Boolean facultatif. Si l’affichage ne retourne aucun élément, la valeur TRUE permet de retourner une page vierge et un code d’erreur HTTP au lieu de restituer l’élément ViewEmpty. Utilisé pour la manipulation par programme des affichages à partir d’une application cliente, afin que celle-ci n’ait pas besoin d’analyser un document pour découvrir si l’affichage est vide. |
|
|
FileDialog |
Argument Boolean facultatif. TRUE pour spécifier que la vue est affichée dans les boîtes de dialogue de fichier pour les applications qui sont utilisées dans le contexte de SharePoint Foundation et qui analysent la sortie HTML pour déterminer le contenu de la liste. |
|
|
FPModified |
Argument Boolean facultatif. TRUE si l’affichage a été modifié par le biais d’un éditeur de page Web et qu’il n’est plus personnalisable par l’interface utilisateur SharePoint Foundation. |
|
|
FreeForm |
Argument Boolean facultatif. TRUE pour spécifier une autre mise en forme de champ pour certains types de champs lorsque des champs sont restitués. En particulier, cet attribut affecte l’alignement des colonnes de nombres, ce qui est notamment utile dans les types d’affichages non tabulaires personnalisés. |
|
|
Hidden |
Argument Boolean facultatif. TRUE pour masquer l’affichage. |
|
|
ImageUrl |
Argument Text facultatif. Spécifie l'URL relative au serveur pour l'image qui est affichée dans la zone de titre de l'affichage de liste, par exemple /_layouts/images/pgrpicon.png. |
|
|
IncludeRootFolder |
Argument Boolean facultatif. TRUE pour spécifier que le dossier racine est renvoyé dans l'affichage de liste. |
|
|
List |
Argument Integer ou Text facultatif. Spécifie le type de liste. Cette valeur peut être l'ID du modèle pour une liste (un entier) ou l'URL vers une liste mise en service dans le site (une chaîne). La méthode conseillée consiste à utiliser Text, car Integer peut ne pas être suffisamment spécifique (par exemple, s'il existe deux listes d'annonces dans le site et que vous spécifiez List=104). |
|
|
MobileDefaultView |
Argument Boolean facultatif.TRUE pour spécifier que l’affichage de liste SharePoint standard est l'affichage mobile par défaut. Un seul affichage par liste peut être désigné comme affichage mobile par défaut. |
|
|
MobileItemLimit |
Argument Integer facultatif. |
|
|
MobileUrl |
Argument Text facultatif. |
|
|
MobileView |
Argument Boolean facultatif. TRUE pour spécifier que l’affichage de liste SharePoint standard est également un affichage mobile. Cet attribut ne s’applique pas aux affichages Calendrier, Feuille de données ou de Gantt. |
|
|
ModerationType |
Argument Text facultatif. Spécifie le type d'approbation de contenu, qui peut être HideUnapproved, Contributor ou Moderator. L'affichage HideUnapproved masque les éléments brouillons non approuvés aux utilisateurs ayant uniquement l'autorisation de lire des éléments. L'affichage Contributor affiche les éléments en attente ou rejetés pour l'utilisateur actuel. L'affichage Moderator est accessible uniquement aux utilisateurs qui ont des autorisations de gérer les listes et affiche les éléments en attente et rejetés pour tous les utilisateurs. |
|
|
Name |
Argument Text facultatif. Nom donné à l’affichage ; utilisé pour sélectionner un affichage nommé différent dans l’interface utilisateur, ainsi que pour faire référence à un affichage nommé lors de la spécification d’un filtre pour un champ Lookup. |
|
|
OrderedView |
Argument Boolean facultatif. TRUE pour spécifier que l’affichage est trié. |
|
|
PageType |
Argument Text facultatif. Spécifie le type du formulaire dans lequel l’affichage est utilisé. Les valeurs possibles sont les suivantes :
|
|
|
Path |
Argument Text facultatif. Spécifie le nom de fichier pour l’affichage. |
|
|
ReadOnly |
Argument Boolean facultatif. TRUE pour que l’affichage soit disponible en lecture seule. |
|
|
RecurrenceRowset |
Argument Boolean facultatif. TRUE pour développer les événements périodiques dans l’affichage et afficher chaque instance de chaque événement périodique. La valeur par défaut est FALSE. |
|
|
ReqAuth |
Argument Boolean facultatif. |
|
|
RequiresClientIntegration |
Argument Boolean facultatif. TRUE pour utiliser des fonctions qui lancent des applications clientes ; sinon, les utilisateurs doivent travailler sur les documents localement et télécharger les modifications. |
|
|
RowLimit |
Argument Integer facultatif. S’applique uniquement au type d’affichage HTML. Spécifie le nombre maximal de lignes à rendre sur n’importe quelle page. Lorsque la limite de ligne est dépassée, les boutons Next et Previous de la page permettent d’afficher la totalité du jeu d’enregistrements retourné. Si RowLimit n’est pas spécifié, le nombre de lignes retournées par défaut est 50. Si « Aucun » est spécifié pour le type d’affichage, toutes les lignes du jeu d’enregistrements sont retournées dans un seul affichage. Lorsqu’un affichage est restitué, les variables de rendu ViewHasNext et ViewHasPrev sont définies sur TRUE ou FALSE, selon que l’affichage actuel a atteint ou non la limite de lignes du groupe de données. Ces variables peuvent être utilisées dans des définitions de pages successives pour restituer les boutons Next et Previous sur la page, comme dans l’exemple suivant :
Les variables NextPageURL et PrevPageURL prennent également des valeurs non vides si la mémoire tampon contient des données pour la page qui précède ou suit la page actuelle. Ces variables peuvent être utilisées en créant les boutons Next et Previous afin qu’ils disposent de l’URL correcte pour accéder à la page de contenu suivante. |
|
|
Scope |
Argument Text facultatif. Spécifie l'étendue récursive pour un affichage d’une bibliothèque de documents. Les valeurs possibles sont les suivantes :
Si cet attribut n’est pas défini, l’affichage montre uniquement les fichiers et les sous-dossiers d’un dossier spécifique. La valeur de cet attribut correspond à la propriété Scope de la classe SPView. |
|
|
SetupPath |
Argument Text facultatif. Spécifie le chemin d'accès relatif au site vers le dossier dans le répertoire d'installation qui contient la page .aspx pour l'affichage, par exemple pages\viewpage.aspx. |
|
|
ShowHeaderUI |
Argument Boolean facultatif. FALSE pour afficher tous les éléments FieldRef utilisés dans le mode d’affichage d’en-tête sans décoration de l’interface utilisateur avec du code HTML. En d’autres termes, lorsque ce mode est défini, l’interface utilisateur ne fournit pas le tri et le filtrage sous forme de liens hypertexte dans l’en-tête de colonne. La valeur par défaut est TRUE. |
|
|
TabularView |
Argument Boolean facultatif. |
|
|
TargetId |
Argument Text facultatif. |
|
|
TargetType |
Argument Text facultatif. Les valeurs possibles sont notamment List et ContentType. |
|
|
Threaded |
Argument Boolean facultatif. TRUE pour appliquer le regroupement interne dans l’affichage. Un affichage thématique est construit selon la colonne de threading intégrée (supposée exister pour la liste). L’affichage est trié sur ce champ en tant que tri secondaire. Si d’autres colonnes de l’affichage sont spécifiées comme étant triées ou regroupées, ces règles sont appliquées avant l’ordre de tri des colonnes de threading. Ainsi, toutes les discussions regroupées par une rubrique peuvent être rassemblées, et le threading de message peut être affiché sous la collection. Lorsque la valeur est TRUE, l’élément RowLimit a une signification différente s’il est utilisé sur un affichage de liste de forum de discussion à thème. Au lieu de spécifier le nombre d’éléments à retourner, il spécifie le nombre de discussions thématiques à retourner, où un thème peut être constitué d’un ou plusieurs éléments. Outre le fait d’avoir l’attribut Threaded défini sur TRUE, un affichage thématique doit être trié par l’ID de thread ; sinon, ce comportement de limite de ligne n’entre pas en vigueur. |
|
|
ToolbarTemplate |
Argument Text facultatif. Spécifie le nom du modèle de barre d'outils prédéfini qui est utilisé pour la barre d'outils de l'affichage. |
|
|
Type |
Argument Text facultatif. Spécifie le type de rendu de l’affichage. Le type est l’affichage HTML énuméré courant et peut être défini sur HTML,Chart ou Pivot. |
|
|
Url |
Argument Text facultatif. Spécifie l’URL de l’affichage. |
|
|
WebPartOrder |
Argument Integer facultatif. Spécifie le positionnement vertical du composant WebPart dans une zone. |
|
|
WebPartZoneID |
Argument Text facultatif. Spécifie la zone pour le composant WebPart. |
|
Éléments enfants
Éléments parents
Occurrences
Minimum : 0 Maximum : illimité |
Remarques
Le type d’affichage principal pour les informations de synthèse de liste et de document est l’affichage HTML. Un affichage HTML est généralement une vue en colonnes qui affiche les informations d’une ou plusieurs listes. Les données à afficher sont décrites par les champs qui sont affichés dans la vue. Pour plus d’informations sur le fonctionnement des affichages dans Microsoft SharePoint Foundation 2010, voir Affichages de liste.
Les attributs principaux qui définissent un mode HTML sont les suivants :
son nom ;
la spécification de la source de données (généralement une seule liste ou bibliothèque de documents) ;
le filtre à appliquer à la source de données ;
la collection de champs à afficher ;
l’ordre de tri des éléments à afficher. Un cas particulier d’ordre de tri est le regroupement ;
un modèle HTML pour restituer l’affichage.
L’élément View est central pour le rendu des pages et génère une requête SQL pour les champs, les tris et les filtres qui sont appliqués dans un affichage particulier. L’élément View effectue une itération dans le jeu de données retourné par la requête et exécute l’élément ViewBody pour chaque ligne qui est retournée. Dans l’élément ViewBody, une énumération d’élément Fields peut être utilisée pour gérer chaque champ, ou chaque champ peut être référencé individuellement par son nom à l’intérieur d’un élément Field.
Chaque affichage a un nom interne qui est généralement représenté par un GUID. L’affichage peut être restitué sur une page à l’aide de la balise <View/>.
Exemple
L’exemple suivant illustre l’utilisation d’une énumération des champs dans le corps d’un affichage, définissant la présentation d’un tableau de base en vue d’afficher une liste dans le navigateur.
<View Name="MyCustomView">
<ViewHeader>
<HTML><![CDATA[<TABLE><TR>]]></HTML>
<Fields>
<HTML><![CDATA[<TH>]]></HTML>
<Field/>
<HTML><![CDATA[</TH>]]></HTML>
</Fields>
<HTML><![CDATA[</TR>]]></HTML>
</ViewHeader>
<ViewBody>
<HTML><![CDATA[<TR>]]></HTML>
<Fields>
<HTML><![CDATA[<TD>]]></HTML>
<Field/>
<HTML><![CDATA[</TD>]]></HTML>
</Fields>
<HTML><![CDATA[</TR>]]></HTML>
</ViewBody>
<ViewFooter>
<HTML><![CDATA[</TABLE>]]></HTML>
</ViewFooter>
Remarquez que dans la section précédente, l’énumération des champs est utilisée dans une section ViewHeader pour créer des en-têtes de colonne pour l’affichage.
Dans la section suivante de l’exemple, une section ViewFields est incluse dans l’élément View afin de spécifier les champs qui seront énumérés dans l’affichage.
<ViewFields>
<FieldRef Name="Created_x0020_By"/>
<FieldRef Name="Last_x0020_Modified"/>
</ViewFields>
Notes
Si l’affichage possède un élément Joins, les champs des listes jointes peuvent être inclus dans ViewFields, sous réserve qu’ils soient également détaillés dans un élément ProjectedFields.
Dans la dernière partie de l’exemple, l’élément Query est utilisé pour spécifier un jeu de résultats qui répond à certains critères, comme dans l’exemple suivant, qui retourne une liste de tous les documents d’une bibliothèque qui sont écrits par Mary ou John.
<Query>
<Where>
<Or>
<Eq>
<FieldRef Name="Created_x0020_By"/>
<Value Type="Text">
Mary
</Value>
</Eq>
<Eq>
<FieldRef Name="Created_x0020_By"/>
<Value Type="Text">
John
</Value>
</Eq>
</Or>
</Where>
<OrderBy>
<FieldRef Name="Last_x0020_Modified"/>
</OrderBy>
</Query>
</View>
L’exemple d’affichage suivant affiche une séquence de paragraphes. L’élément Requête de service Web spécifie non seulement un ordre de tri (par ordre de date de modification), mais aussi un filtre (seuls sont affichés les éléments dont la propriété Expires est postérieure ou égale à la date du jour).
<View Type="HTML" Name="Summary">
<ViewBody ExpandXML="TRUE">
<![CDATA[ <p><SPAN class=DocTitle><ows:Field Name="Title"/></SPAN>
(<ows:Field Name="Author"/>, <ows:Field Name="Modified"/>)
<ows:Limit><Field Name="Body"/></ows:Limit>
</p> ]]>
</ViewBody>
<Query>
<Where>
<Geq>
<FieldRef Name="Expires"/>
<Value Type="DateTime">
<Today/>
</Value>
</Geq>
</Where>
<OrderBy>
<FieldRef Name="Modified"/>
</OrderBy>
</Query>
<ViewFields>
<FieldRef Name="Summary"/>
<FieldRef Name="Author"/>
<FieldRef Name="Modified"/>
<FieldRef Name="Body"/>
</ViewFields>
</View>