Compartir a través de


Elemento View (List)

Última modificación: jueves, 15 de julio de 2010

Hace referencia a: SharePoint Foundation 2010

En este artículo
Atributos
Elementos secundarios
Elementos primarios
Repeticiones

En una definición de lista (Schema.xml), define una vista para una lista en 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. El esquema View se mantiene para compatibilidad con versiones anteriores. Para obtener información acerca de las vistas de lista XSLT, vea Vistas de lista.

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

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 optional. 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 dentro del contexto de SharePoint Foundation y que analizan el resultado HTML 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 es personalizable por 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 del 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.

List

Integer o Text opcional. Especifica el tipo de lista. Este valor puede ser el identificador de la plantilla para una lista (un entero), o la dirección URL para obtener acceso a una lista ofrecida en el sitio (una cadena). La práctica recomendada es utilizar Text, porque Integer podría no ser lo suficientemente específico (p. ej., si hay dos listas de anuncios en el sitio y 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.

Name

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 de cuadro de diálogo de archivo.

  • DISPLAYFORM   Presentar formulario para elementos de lista.

  • DISPLAYFORMDIALOG   Presentar 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.

  • INVALID   No se utiliza.

  • MAXITEMS   No se utiliza.

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

  • VIEW Vista, incluida la vista predeterminada y la vista normal.

Path

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.

RowLimit

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" como tipo de vista, todas las filas del conjunto de registros se devuelven en una vista.

Cuando se representa una vista, las variables de representación ViewHasNext y ViewHasPrev se definen como 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:

        <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 como valores en blanco cuando existen contenidos de paginación hacia adelante o hacia atrás desde la vista 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 se corresponde con la propiedad Scope de la clase SPView.

SetupPath

Text opcional. Especifica la ruta de acceso, relativa al sitio, a la carpeta en el 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.

Threaded

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.

Type

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 para el elemento web.

Elementos secundarios

Elemento

Aggregations, GroupByFooter, GroupByHeader, Joins, PagedClientCallbackRowset, PagedRecurrenceRowset, PagedRowset, ParameterBindings, ProjectedFields, Query, RowLimit, RowLimitExceeded, Toolbar, ViewBidiHeader, ViewBody, ViewData, ViewEmpty, ViewFields, ViewFooter, ViewHeader, ViewStyle, XslLink

Elementos primarios

Views

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 procesa una iteración en 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 puede estar representada en una página mediante la etiqueta <View/>.

Ejemplo

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 asociadas se pueden incluir en ViewFields, siempre que también se desglosen 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 no sólo especifica un criterio de ordenación (en orden de fecha de modificación), sino también un filtro (sólo mostrar 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

Otros recursos

Vistas de lista