Compartir a través de

Schema.xml

  • Artículo

Cada definición de lista que aparece como una opción en la página Crear tiene su propia subcarpeta de características en unidad_local:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\FEATURES que incluye un archivo Schema.xml. El archivo Schema.xml define las vistas, los formularios, las barras de herramientas y los campos especiales para las listas que se crean mediante la definición de lista.

Tareas de definición de lista con Schema.xml

Los siguientes tipos de tareas se pueden realizar en un archivo Schema.xml para personalizar una definición de lista:

  • Agregar campos personalizados integrados en los tipos de campo base definidos en FldTypes.xml (no se pueden crear tipos de campo base personalizados)

  • Crear una vista personalizada de las listas creadas mediante la definición de lista

  • Especificar páginas de formularios personalizados para trabajar con elementos de lista

  • Especificar la descripción predeterminada que se muestra para la lista en la interfaz de usuario (UI)

  • Definir el área de acciones que se muestra en el área de exploración lateral de las vistas de listas

Advertencia

Si realiza cambios en un archivo Schema.xml instalado originalmente en un servidor que ejecuta Windows SharePoint Services se pueden romper las listas existentes y los cambios se pueden sobrescribir al instalar las actualizaciones o Service Pack para Windows SharePoint Services, o cuando se actualiza una instalación a la siguiente versión del producto. Cree una definición de lista personalizada en lugar de modificar archivos de esquema originales. Para obtener más información sobre el procedimiento recomendado, consulte Procedimiento para crear una definición de lista personalizada.

Formato de archivo

Elemento List

El elemento List de nivel superior especifica el nombre interno y de presentación para la definición de lista, así como la dirección del texto usado en listas y la dirección URL relativa al sitio donde se crean las listas.

Nota

En todos los ejemplos XML de este tema, las cadenas que comienzan con "$Resources" son constantes definidas en un archivo .resx en C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\Resources.

<List 
  xmlns:ows="Microsoft SharePoint" 
  Title="Tasks" 
  FolderCreation="FALSE" 
  Direction="$Resources:Direction;" 
  Url="Lists/Tasks" 
  BaseType="0">

Al igual que la mayoría de los atributos del elemento List de un archivo Schema.xml, la especificación de la dirección URL relativa al sitio es irrelevante en gran medida porque se reemplaza con la configuración de lista del archivo Onet.xml de la definición del sitio. Este elemento especifica opcionalmente Microsoft SharePoint como un espacio de nombres XML. El atributo BaseType especifica un tipo de lista base que está definido dentro del elemento BaseTypes de un archivo Onet.xml. Use el atributo VersioningEnabled para especificar si el control de versiones está habilitado de forma predeterminada para las bibliotecas de documentos creadas mediante la definición de lista.

Elemento MetaData

El elemento MetaData agrupa metadatos de lista dentro del elemento List y puede contener los siguientes subelementos.

Elemento ContentTypes

El elemento ContentTypes especifica tipos de contenido que se van a asociar a las listas que se crean mediante la definición de lista.

<MetaData>
  <ContentTypes>
    <ContentTypeRef 
      ID="0x0108">
      <Folder 
      TargetName="Task" />
    </ContentTypeRef>
    <ContentTypeRef 
      ID="0x0120" />
  </ContentTypes>

Elemento Fields

El elemento Fields contiene definiciones de campo para campos especiales que pueden ser necesarios en la definición de una lista.

<Fields>
  <Field 
    ID="{a8eb573e-9e11-481a-a8c9-1104a54b2fbd}" 
    Type="Choice" 
    Name="Priority" 
    DisplayName="$Resources:core,Priority;" 
    SourceID="https://schemas.microsoft.com/sharepoint/v3" 
    StaticName="Priority">
    <CHOICES>
      <CHOICE>$Resources:core,Priority_High;</CHOICE>
      <CHOICE>$Resources:core,Priority_Normal;</CHOICE>
      <CHOICE>$Resources:core,Priority_Low;</CHOICE>
    </CHOICES>
    <MAPPINGS>
      <MAPPING Value="1">$Resources:core,Priority_High;</MAPPING>
      <MAPPING Value="2">$Resources:core,Priority_Normal;</MAPPING>
      <MAPPING Value="3">$Resources:core,Priority_Low;</MAPPING>
    </MAPPINGS>
    <Default>$Resources:core,Priority_Normal;</Default>
  </Field>
  ...
  <Field 
    ID="{d2311440-1ed6-46ea-b46d-daa643dc3886}" 
    Type="Number" 
    Name="PercentComplete" 
    Percentage="TRUE" 
    Min="0" 
    Max="1" 
    DisplayName="$Resources:core,Percent_Complete;" 
    SourceID="https://schemas.microsoft.com/sharepoint/v3" 
    StaticName="PercentComplete">
  </Field>
  <Field 
    ID="{53101f38-dd2e-458c-b245-0c236cc13d1a}" 
    Type="User" 
    List="UserInfo" 
    Name="AssignedTo" 
    DisplayName="$Resources:core,Assigned_To;" 
    SourceID="https://schemas.microsoft.com/sharepoint/v3" 
    StaticName="AssignedTo">
  </Field>
  ...
</Fields>

Cada elemento Field especifica un nombre (DisplayName), un nombre interno (Name), un tipo de campo (Type) definido en FldTypes.xml para mostrar el campo en que se basa y otras propiedades de campo, según sea necesario.

Para una tarea de programación que muestra el procedimiento para agregar un campo personalizado a un archivo Schema.xml, consulte Procedimiento para crear una definición de lista personalizada.

Elemento Views

El elemento Views contiene las definiciones de vista que están disponibles de forma predeterminada cuando se crea una lista.

<Views>
  ...
  <View 
    BaseViewID="2" 
    Type="HTML" 
    WebPartZoneID="Main" 
    DisplayName="$Resources:core,My_Tasks;" 
    MobileView="True" 
    MobileDefaultView="True" 
    SetupPath="pages\viewpage.aspx" 
    ImageUrl="/_layouts/images/issues.png" 
    Url="MyItems.aspx" 
    ReqAuth="TRUE">
    <GroupByHeader>
      ...
    <GroupByFooter>
      ...
    <ViewHeader>
      ...
    <ViewBody>
      ...
    <ViewFooter>
      ...
    <PagedRowset>
      ...
    <PagedClientCallbackRowset>
      ...
    <PagedRecurrenceRowset>
      ...
    <RowLimit
      Paged="TRUE">100</RowLimit>
    <ViewEmpty>
      ...
    <Toolbar Type="Standard" />
    <ViewFields>
      <FieldRef Name="LinkTitle" />
      <FieldRef Name="Status" /> 
      <FieldRef Name="Priority" /> 
      <FieldRef Name="DueDate" /> 
      <FieldRef Name="PercentComplete" /> 
    </ViewFields>
  <Query>
    <Where>
      <Eq>
        <FieldRef Name="AssignedTo" />
        <Value Type="Integer">
          <UserID />
        </Value>
      </Eq>
    </Where>
    <OrderBy>
      <FieldRef Name="Status" /> 
      <FieldRef Name="Priority" /> 
    </OrderBy>
  </Query>
  </View>
  ...
</Views>

Cada elemento View especifica el tipo de formato usado en la presentación (normalmente HTML) y un identificador único de la vista. Cuando la vista se muestra en un elemento web, el elemento View también especifica el título de la vista. El atributo Url se usa en la creación de listas para especificar el nombre base de la página ASPX en la que se muestra la vista. View también especifica el identificador de zona de elementos web del elemento web en el que se muestra la vista.

El elemento View contiene subelementos que definen lo siguiente:

  • Las distintas partes de una vista (incluidos el encabezado, el cuerpo y el pie de página)

  • La sección Agrupar por

  • Un límite en el número de filas, o elementos, que se van a mostrar

  • Conjuntos de filas que definen cómo se muestran los elementos cuando el número supera el límite de filas

  • Lo que debe mostrar cuando no se devuelven elementos en la vista

  • El área de la barra de herramientas que se muestra encima de las listas

  • Los campos que se muestran en la vista

  • La consulta que filtra la vista

El elemento Toolbar define el tipo de barra de herramientas que se muestra en el área de exploración de la vista de lista. Los valores posibles son:

  • RelatedTasks para la sección Acciones que se muestra en el área de exploración lateral de las vistas de listas

  • Standard para las vistas normales

  • Freeform para vistas de resumen en las páginas principales

Elemento Forms

El elemento Forms contiene las referencias a los formularios usados cuando se trabaja con elementos individuales de la lista.

<Forms>
  <Form Type="DisplayForm" Url="DispForm.aspx" SetupPath="pages\form.aspx" WebPartZoneID="Main" />
  <Form Type="EditForm" Url="EditForm.aspx" SetupPath="pages\form.aspx" WebPartZoneID="Main" />
  <Form Type="NewForm" Url="NewForm.aspx" SetupPath="pages\form.aspx" WebPartZoneID="Main" />
</Forms>

Cada elemento Form especifica el tipo de formulario, que puede ser DisplayForm, EditForm o NewForm, así como el nombre de la página aspx usada para el formulario y el identificador de la zona de elementos web del elemento web en el que se muestra el formulario en la página.

Elemento DefaultDescription

Un elemento DefaultDescription especifica la descripción que se muestra para la definición de lista en la interfaz de usuario.

<DefaultDescription>$Resources:core,camlidT13;</DefaultDescription>

Este elemento se reemplaza con el atributo Description del elemento List correspondiente a la actual definición de lista que se especifica en una configuración de Onet.xml.

Importante

Debe especificarse un valor para este elemento en las definiciones de lista personalizadas.

Vea también

Otros recursos

Esquema de lista
Instrucciones para usar plantillas y definiciones