View, élément (List)

Article
04/08/2023

S’applique à : | SharePoint 2016 SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013

Dans une définition de liste (Schema.xml), définit une vue pour une liste dans un site web basé sur Microsoft SharePoint Foundation, où chaque liste peut contenir un certain nombre d’affichages.

Remarque

SharePoint Foundation 2010 utilise XSLT pour définir les affichages de liste, et le schéma d’affichage est conservé à des fins de compatibilité descendante. Pour plus d’informations sur les affichages de liste XSLT, voir List Views.

<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>

Éléments et attributs

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut	Description
AggregateView	Facultatif Boolean. 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	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é.
Feuille CssStyle	Texte facultatif.
DefaultView	Facultatif Boolean. TRUE pour spécifier que l’affichage est l’affichage par défaut.
DefaultViewForContentType	Facultatif Boolean. 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	Facultatif Boolean. 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	Facultatif Boolean. TRUE pour spécifier que l’affichage est affiché dans les boîtes de dialogue de fichier pour les applications utilisées dans le contexte de SharePoint Foundation, et qui analysent le code HTML de sortie pour déterminer le contenu de la liste.
FPModified	Facultatif Boolean. TRUE si l’affichage a été modifié par modification dans un éditeur de page web et que l’affichage n’est plus personnalisable par l’interface utilisateur de SharePoint Foundation.
Freeform	Facultatif Boolean. 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	Facultatif Boolean. TRUE pour masquer l’affichage.
Imageurl	Texte facultatif. Spécifie l’URL relative du serveur pour l’image affichée dans la zone de titre de l’affichage de liste, par exemple. `/_layouts/images/pgrpicon.png`
IncludeRootFolder	Facultatif Boolean. 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	Facultatif Boolean. 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	Entier facultatif.
MobileUrl	Texte facultatif.
Mobileview	Facultatif Boolean. 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	Texte 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	Texte 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	Facultatif Boolean. 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 : DEFAULTVIEW Affichage par défaut. DIALOGVIEW Affichage de la boîte de dialogue Fichier. DISPLAYFORM Formulaire d’affichage des éléments de liste. DISPLAYFORMDIALOG Formulaire d’affichage d’une boîte de dialogue de fichier. EDITFORM Modifier le formulaire pour les éléments de liste. EDITFORMDIALOG Modifier le formulaire d’une boîte de dialogue de fichier. NON VALIDE Non utilisé. MAXITEMS Non utilisé. NEWFORM Nouveau formulaire pour les éléments de liste. NEWFORMDIALOG Nouveau formulaire pour une boîte de dialogue de fichier. NORMALVIEW Affichage normal. SOLUTIONFORM Formulaire de solution. VUE Affichage, y compris l’affichage par défaut et l’affichage normal.
Chemin	Text facultatif. Spécifie le nom de fichier pour l’affichage.
ReadOnly	Facultatif Boolean. TRUE pour que l’affichage soit disponible en lecture seule.
RecurrenceRowset	Facultatif Boolean. 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	Facultatif Boolean.
RequiresClientIntegration	Facultatif Boolean. 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	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 une seule vue. Lorsqu’une vue est rendue, les variables `ViewHasNext` de rendu et `ViewHasPrev` sont définies sur TRUE ou FALSE, selon que l’affichage actuel a atteint la limite de lignes du jeu 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 : `XML<Switch> <Expr><GetVar Name="ViewHasPrev"/></Expr> <Case Value="TRUE"> <![CDATA[...Previous button defined here... ]]> </Case></Switch>` Les variables `NextPageURL` et `PrevPageURL` sont également définies sur des valeurs non vides lorsqu’il existe du contenu de pagination vers l’avant ou vers l’arrière à partir de l’affichage actuel. Ces variables peuvent être utilisées en créant les boutons Next et Previous de manière à ce qu’ils aient l’URL qui permet d’accéder à la page de contenu suivante.
Scope	Text facultatif. Spécifie l'étendue récursive pour un affichage d’une bibliothèque de documents. Les valeurs possibles sont les suivantes : FilesOnly : montre uniquement les fichiers d’un dossier spécifique. Recursive : montre tous les fichiers de tous les dossiers. RecursiveAll : montre tous les fichiers et tous les sous-dossiers de tous les dossiers. 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	Texte facultatif. Spécifie le chemin d’accès relatif du site au dossier dans le répertoire d’installation qui contient la page .aspx de la vue, par exemple. `pages\viewpage.aspx`
ShowHeaderUI	Facultatif Boolean. 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	Facultatif Boolean.
TargetId	Texte facultatif.
TargetType	Texte facultatif. Les valeurs possibles sont notamment List et ContentType.
Fileté	Facultatif Boolean. 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	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	Entier facultatif. Spécifie le positionnement vertical du composant WebPart dans une zone.
WebPartZoneID	Texte facultatif. Spécifie la zone pour le composant WebPart.

Éléments enfants

Éléments parents

Views

Occurrences

Minimum : 0
Maximum : pas de limite

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 vues dans Microsoft SharePoint Foundation 2010, consultez 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. La vue peut être affichée sur une page à l’aide de la <balise View/> .

Exemples

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>

Remarque

Si la vue a un élément Joins, les champs des listes jointes peuvent être inclus dans ViewFields, à condition qu’ils soient également inclus 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 Query spécifie non seulement un ordre de tri (par ordre de date de modification), mais également un filtre (afficher uniquement les éléments dont la propriété Expires est supé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>

Voir aussi

Affichages de liste

Partager via