Elemento View (List)

Artículo
04/08/2023

Se aplica a: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

En una definición de lista (Schema.xml), define una vista para una lista de un sitio web basado en Microsoft SharePoint Foundation, donde cada lista puede contener varias vistas.

Nota:

SharePoint Foundation 2010 usa XSLT para definir vistas de lista y el esquema View se mantiene por compatibilidad con versiones anteriores. Para obtener información acerca de las vistas de lista de XSLT, vea 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>

Elementos y atributos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo	Descripción
AggregateView	Boolean opcional. TRUE para especificar que se trata de una vista Combinar formularios usada en una biblioteca de formularios XML. De forma predeterminada, una biblioteca de formularios XML tiene una vista Combinar formularios que está oculta inicialmente. Cuando un editor XML se usa para publicar un archivo de propiedades de formulario XML (XFP) en el directorio de formularios de la biblioteca, junto con una plantilla usada por el editor, el atributo AggregateView identifica la vista Combinar formularios. Esta vista se puede hacer visible u ocultar, en función de si la plantilla de lista o la definición de la biblioteca admite la combinación de datos.
BaseViewID	Integer opcional. Especifica el identificador de la vista base.
ContentTypeID	Text opcional. Especifica el identificador del tipo de contenido con el que está asociada la vista.
CssStyleSheet	Text opcional.
DefaultView	Boolean opcional. TRUE para especificar que la vista es la vista predeterminada.
DefaultViewForContentType	Boolean opcional. TRUE para especificar que la vista es la vista predeterminada para un tipo de contenido.
DisplayName	Text opcional. Especifica el nombre de la vista que se muestra en la barra Inicio rápido.
FailIfEmpty	Boolean opcional. Si la vista no devuelve ningún elemento, TRUE para devolver una página en blanco y un código de error HTTP en lugar de representar el elemento ViewEmpty. Se usa para manipular mediante programación las vistas desde una aplicación cliente, de forma que la aplicación cliente no tendrá que analizar un documento para detectar si la vista está vacía.
FileDialog	Boolean opcional. TRUE para especificar que la vista se muestra en cuadros de diálogo de archivo para las aplicaciones que se usan en el contexto de SharePoint Foundation y que analizan el HTML de salida para determinar el contenido de la lista.
FPModified	Boolean opcional. TRUE si la vista se ha modificado mediante la edición en un editor de páginas web y la vista ya no se puede personalizar mediante la interfaz de usuario (UI) de SharePoint Foundation.
Freeform	Boolean opcional. TRUE para especificar un formato de campo alternativo para ciertos tipos de campo cuando se representan los campos. En concreto, este atributo afecta a la alineación de las columnas de número, lo que resulta especialmente útil en tipos de vistas personalizadas no tabulares.
Hidden	Boolean opcional. TRUE para ocultar la vista.
Imageurl	Text opcional. Especifica la dirección URL relativa al servidor de la imagen que se muestra en el área de título de la vista de lista, por ejemplo, `/_layouts/images/pgrpicon.png`.
IncludeRootFolder	Boolean opcional. TRUE para especificar que la carpeta raíz se devuelve en la vista de lista.
Lista	Integer o Text opcional. Especifica el tipo de lista. Este valor puede ser el identificador de la plantilla de una lista (un número), o la URL para una lista que se proporciona en el sitio (una cadena). Lo ideal es utilizar Text, porque es posible que Integer no sea suficientemente específico (por ejemplo, si en el sitio hay dos listas de anuncios y se especifica List=104).
MobileDefaultView	Boolean opcional. TRUE para especificar que la vista de lista de SharePoint es la vista móvil predeterminada. Sólo una vista por lista puede designarse como la vista móvil predeterminada.
MobileItemLimit	Integer opcional.
MobileUrl	Text opcional.
MobileView	Boolean opcional. TRUE para especificar que la vista de lista de SharePoint estándar es también una vista móvil. Este atributo no se aplica a las vistas de Gantt, Hoja de datos o Calendario.
ModerationType	Text opcional. Especifica el tipo de aprobación de contenido, que puede ser HideUnapproved, Contributor o Moderator. La vista HideUnapproved oculta elementos provisionales pendientes de aprobación de usuarios que sólo tienen permiso para leer elementos. La vista Contributor muestra los elementos pendientes y los rechazados para el usuario actual. La vista Moderator sólo es accesible para los usuarios que tienen permisos para administrar listas, y muestra los elementos pendientes y los rechazados para todos los usuarios.
Nombre	Text opcional. El nombre dado a la vista, usado para seleccionar una vista con nombre diferente en la interfaz de usuario, así como para hacer referencia a una vista con nombre al especificar un filtro para el campo Lookup.
OrderedView	Boolean opcional. TRUE para especificar que la vista está ordenada.
PageType	Text opcional. Especifica el tipo de formulario en el que se usa la vista. Los valores posibles son: DEFAULTVIEW Vista predeterminada. DIALOGVIEW Vista del cuadro de diálogo Archivo. DISPLAYFORM Mostrar formulario para elementos de lista. DISPLAYFORMDIALOG Mostrar formulario para un cuadro de diálogo de archivo. EDITFORM Editar formulario para elementos de lista. EDITFORMDIALOG Editar formulario para un cuadro de diálogo de archivo. NO VÁLIDO No se usa. MAXITEMS No se usa. NEWFORM Nuevo formulario para elementos de lista. NEWFORMDIALOG Nuevo formulario para un cuadro de diálogo de archivo. NORMALVIEW Vista normal. SOLUTIONFORM Formulario de solución. VISTA Vista, incluida la vista predeterminada y la vista normal.
Ruta de acceso	Text opcional. Especifica el nombre de archivo para la vista.
ReadOnly	Boolean opcional. TRUE para hacer que la vista sea de sólo lectura.
RecurrenceRowset	Boolean opcional. TRUE para expandir eventos periódicos en la vista y mostrar cada instancia de cada evento periódico. El valor predeterminado es FALSE.
ReqAuth	Boolean opcional.
RequiresClientIntegration	Boolean opcional. TRUE para utilizar características que ejecutan aplicaciones cliente; de lo contrario, los usuarios deben trabajar con documentos de forma local y cargar los cambios.
Límite de fila	Integer opcional. Se aplica sólo al tipo de vista HTML. Especifica el número máximo de filas que se van a representar en una única página. Cuando se supera el límite de filas, los botones Next y Previous permiten ver todo el conjunto de registros devueltos. Si no se especifica RowLimit, el número predeterminado de filas devueltas es 50. Si se especifica None para el tipo de vista, todas las filas del conjunto de registros se devuelven en una vista. Cuando se representa una vista, las variables `ViewHasNext` de representación y `ViewHasPrev` se establecen en TRUE o FALSE, en función de si la vista actual ha alcanzado el límite de filas del conjunto de datos. Estas variables se pueden usar en definiciones de página sucesivas para representar los botones Next y Previous en la página, como en el siguiente ejemplo: `XML<Switch> <Expr><GetVar Name="ViewHasPrev"/></Expr> <Case Value="TRUE"> <![CDATA[...Previous button defined here... ]]> </Case></Switch>` Las variables `NextPageURL` y `PrevPageURL` también se establecen en valores que no están en blanco cuando hay contenido de paginación hacia delante o hacia atrás desde la pantalla actual. Estas variables se pueden usar mediante la construcción de los botones Next y Previous de forma que tengan la dirección URL correcta para obtener acceso a la siguiente página de contenido.
Scope	Text opcional. Especifica el ámbito recursivo de una vista de una biblioteca de documentos. Los valores posibles son: FilesOnly: mostrar sólo los archivos de una carpeta específica. Recursive: mostrar todos los archivos de todas las carpetas. RecursiveAll: mostrar todos los archivos y todas las subcarpetas de todas las carpetas. Si no se define este atributo, la vista sólo muestra los archivos y subcarpetas de una carpeta específica. El valor de este atributo corresponde a la propiedad Scope de la clase SPView .
SetupPath	Text opcional. Especifica la ruta de acceso relativa al sitio a la carpeta del directorio de instalación que contiene la página .aspx de la vista, por ejemplo, `pages\viewpage.aspx`.
ShowHeaderUI	Boolean opcional. FALSE para representar todos los elementos FieldRef usados en el modo de presentación de encabezado sin agregar a la interfaz de usuario código HTML. En otras palabras, cuando se establece este modo, la interfaz de usuario no proporciona la ordenación y filtrado como hipervínculos en el encabezado de columna. El valor predeterminado es TRUE.
TabularView	Boolean opcional.
TargetId	Text opcional.
TargetType	Text opcional. Entre los posibles valores se incluyen List y ContentType.
Roscado	Boolean opcional. TRUE para aplicar agrupación interna en la vista. Una vista encadenada se construye basándose en la columna de subprocesamiento integrada (se supone que existe para la lista). La vista se ordena en este campo como la ordenación secundaria. Si otras columnas en la vista se especifican como ordenadas o agrupadas, estas reglas se aplican antes del criterio de ordenación de columna de subprocesamiento. Como resultado, todas las discusiones agrupadas por tema se pueden recopilar juntas, y el subprocesamiento de mensaje se puede mostrar bajo la colección. Si es TRUE, el elemento RowLimit tiene un significado diferente a cuando se usa en una vista de lista de panel de discusión encadenada. En lugar de especificar el número de elementos que deben devolverse, especifica el número de líneas de discusión que se van a devolver, teniendo en cuenta que una línea se compone de uno o más elementos. Además de tener el atributo Threaded establecido como TRUE, se debe ordenar una vista encadenada por el identificador de subproceso; en caso contrario, este comportamiento de límite de fila no tendrá efecto.
ToolbarTemplate	Text opcional. Especifica el nombre de la plantilla de barra de herramientas predefinida que se utiliza para la barra de herramientas de vista.
Tipo	Text opcional. Especifica el tipo de representación de la vista. El tipo es la vista HTML enumerada común y se puede establecer en HTML, Chart o Pivot.
Url	Text opcional. Especifica la dirección URL de la vista.
WebPartOrder	Integer opcional. Especifica el posicionamiento vertical del elemento web dentro de una zona.
WebPartZoneID	Text opcional. Especifica la zona del elemento web.

Elementos secundarios

Elementos principales

Vistas

Repeticiones

Mínimo: 0
Máximo: sin límite

Comentarios

El tipo de vista principal para la información de resumen de listas y documentos es la vista HTML. Una vista HTML es generalmente una vista de columnas que muestra información de una o varias listas. Los datos que se van a mostrar se describen en los campos que se muestran en la vista. Para obtener información sobre cómo funcionan las vistas en Microsoft SharePoint Foundation 2010, vea Vistas de lista.

Los atributos principales que definen una vista HTML son los siguientes:

Su nombre.
La especificación del origen de los datos (normalmente una única lista o biblioteca de documentos).
El filtro que se va a aplicar al origen de datos.
La colección de campos que se va a mostrar.
El criterio de ordenación de los elementos que se van a mostrar. Un caso especial de criterio de ordenación es agrupar.
Una plantilla HTML para representar la vista.

El elemento View es fundamental para la representación de páginas y genera una consulta SQL para los campos, clasificaciones y filtros que se aplican en una vista determinada. El elemento View recorre en iteración el conjunto de datos devueltos por la consulta y ejecuta el elemento ViewBody para cada fila que se devuelve. Dentro del elemento ViewBody, se puede usar una enumeración de elementos Fields para controlar cada campo, o se puede hacer referencia a cada campo de forma individual por su nombre dentro de un elemento Field.

Cada vista tiene un nombre interno que normalmente está representado por un GUID. La vista se puede representar en una página mediante la <etiqueta View/> .

Ejemplos

El siguiente ejemplo muestra el uso de una enumeración de campos dentro de un cuerpo de vista y dispone una tabla básica para mostrar una lista en el explorador.

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

Observe que en la sección anterior se usa la enumeración de campos dentro de una sección ViewHeader para crear encabezados de columna para la vista.

En la siguiente sección del ejemplo, se incluye una sección ViewFields en el elemento View para especificar los campos que se enumerarán en la vista.

    <ViewFields>
      <FieldRef Name="Created_x0020_By"/>
      <FieldRef Name="Last_x0020_Modified"/>
    </ViewFields>

Nota:

Si la vista tiene un elemento Joins , los campos de las listas combinadas se pueden incluir en ViewFields, siempre que también estén detallados en un elemento ProjectedFields .

En la última sección del ejemplo, se usa el elemento Query para especificar un conjunto de resultados que cumple determinados criterios, como en el ejemplo siguiente, que devuelve una lista de todos los elementos en una biblioteca que están escritos por Mary o 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>

En el siguiente ejemplo de vista se muestra una secuencia de párrafos. El elemento Query especifica no solo un criterio de ordenación (en orden de fecha de modificación), sino también un filtro (solo muestra elementos cuya propiedad Expires es mayor o igual que la fecha de hoy).

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

Vea también

Vistas de lista

Compartir a través de