Élément View (List)

S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | SharePoint En ligne | SharePoint Server 2013

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 un certain nombre d’affichages.

Notes

SharePoint Foundation 2010 utilise XSLT pour définir des affichages de liste et le schéma d’affichage est conservé pour des raisons de compatibilité ascendante. 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
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
Texte 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
Facultatif Boolean. TRUE pour spécifier que l’affichage est affiché dans les boîtes de dialogue de fichier pour les applications qui sont utilisées dans le contexte de SharePoint Foundation, et qui parse 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 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
Texte facultatif. Spécifie l’URL relative de serveur pour l’image qui est affichée dans la zone de titre de l’affichage 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
Integer facultatif.
MobileUrl
Texte 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.
Nom
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 :

DEFAULTVIEW Affichage par défaut.
DIALOGVIEW Affichage de la boîte de dialogue fichier.
DISPLAYFORM Formulaire d’affichage pour les éléments de liste.
DISPLAYFORMDIALOG Formulaire d’affichage d’une boîte de dialogue de fichier.
EDITFORM Formulaire de modification pour les éléments de liste.
EDITFORMDIALOG Formulaire de modification d’une boîte de dialogue de fichier.
INVALID 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.
VIEW Affichage, y compris l’affichage par défaut et l’affichage normal.
Chemin
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
Facultatif Boolean.
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
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 aucune n’est spécifiée pour le type d’affichage, toutes les lignes du recordset sont renvoyées dans un seul affichage.

Lorsqu’un affichage est restituer, les variables de rendu et sont définies sur TRUE ou FALSE, selon que l’affichage actuel a atteint la limite de ligne à partir du ViewHasNext ViewHasPrev 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 sont également définies sur des valeurs non déverrables lorsqu’il existe du contenu de pagination vers l’avant ou vers l’arrière à partir de PrevPageURL 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 au site vers le dossier dans le répertoire d’installation qui contient la page .aspx de 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
Facultatif Boolean.
TargetId
Texte 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
Integer facultatif. Spécifie le positionnement vertical du partie Web Dans une zone.
WebPartZoneID
Texte facultatif. Spécifie la zone pour le partie Web.

Éléments enfants

Éléments parents

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 affichages 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 rendu sur une page à l’aide de la <View/> balise.

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>

Notes

Si l’affichage possède un élément Joins, les champs des listes jointes peuvent être inclus dans ViewFields,à condition qu’ils soient également indiqué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 Query spécifie non seulement un ordre de tri (par ordre de date de modification), mais aussi 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