Compartilhar via

Onet.xml

  • Artigo

Quando você instalar Windows SharePoint Services 3.0, Onet.xml seis arquivos são colocados dentro Diretório a instalação, um em \Arquivos de Shared\Extensões Server Extensions\12\TEMPLATE\GLOBAL\XML \Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\GLOBAL\XML ...\TEMPLATE\SiteTemplates ...\TEMPLATE\SiteTemplates que aplicar a cada uma das definições de site cinco que enviar com Windows SharePoint Services 3.0. Eles são sites Blog, o site de Administração Central, Wiki sites, sites de Espaço de Trabalho de Reunião e sites de equipe SharePoint. Somente os dois últimos esses famílias contêm more than um site definição configuração em Windows SharePoint Services 3.0.

O arquivo Onet.xml global define modelos lista para listas ocultas, tipos de base lista, uma configuração definição usar como padrão e os módulos que aplicar globalmente para a implantação. Os cinco arquivos Onet.xml o Diretório \SiteTemplates \SiteTemplates definir áreas de navegação, lista Modelos, documento modelos, configurações, módulos, componentes e seções rodapé email servidor usadas em Definições de site cinco.

Funções de Onet.xml

Dependendo do seu uso específico, um arquivo Onet.xml pode servir múltiplo funções, such as o seguinte:

  • Defina as parte superior e áreas navegação lateral que aparecem na home page e nos modos de exibição lista para uma definição site.

  • Especificar as definições lista que são usados em cada site definição e se eles estão disponível para criar listas na página Criar.

  • Especificar documento modelos que estão disponível na definição de site para criar listas biblioteca documento na página nova e especificar os arquivos usados nos modelos de documento.

  • Definir os tipos lista de base da qual usar como padrão wssnoversshort Windows SharePoint Services listas são derivado. (Somente o arquivo Onet.xml global serve essa função.)

  • Especifica as configurações das listas e módulos que são usados em cada definição site.

  • Especificar componentes Windows SharePoint Services wssnoversshort.

  • Defina a seção de rodapé usados no servidor email.

Tarefas de definição de sites da Web com Onet.xml

O seguinte tipos de tarefas podem ser executados em um personalizado Onet.xml para criar um personalizado definição site:

  • Especifique um alternativo arquivo folha de estilo em cascata (folhas de estilo em cascata), arquivo JavaScript ou ASPX arquivo cabeçalho para uma definição site.

  • Modificar áreas para navegação para o home page e lista Páginas.

  • Adicione uma definição lista como uma opção para a página Criar.

  • Adicione um modelo do documento para criar bibliotecas documento.

  • Definir uma ou mais configurações para a definição site, especificando a listas, módulos, arquivos e Web Parts incluídas quando uma configuração definição site é instanciado.

Aviso

As alterações para um arquivo Onet.xml originalmente instalado em um servidor execução Windows SharePoint Services podem interromper sites existentes e as alterações podem ser sobrescritos quando você instalar atualizações ou serviço pacotes para Windows SharePoint Services, ou quando você atualizar uma instalação para o próximo versão do produto.Sempre criar um novo Onet.xml; Não modifique o arquivo original.Para obter mais informações, consulte Como a: Criar uma definição de site personalizadas e configuração.

Formato de arquivo

O seguinte seções definem os vários elementos do arquivo Onet.xml.

Elemento do projeto

O de alto nível elemento 2ee96a89-03e9-4283-8a29-05c1e5b4788a Project especifica um nome usar como padrão para sites que são criados por meio de qualquer das configurações de site na definição de site e especifica o Diretório que contém subpastas na qual os arquivos de cada lista definição residir.

Observação

A menos que indicado caso contrário, trechos usados no seguinte exemplos são extraídos o arquivo Onet.xml para a definição do STS do site.

<Project 
  Title="$Resources:onet_TeamWebSite;" 
  Revision="2"
  ListDir="$Resources:core,lists_Folder;" 
  xmlns:ows="Microsoft SharePoint">

Observação

Em todos os trechos neste tópico, as seqüências que começam com "$ Recursos" são constantes que são definidas em um arquivo .RESX.Por exemplo, "Resources:onet_TeamWebSite $" é definidos Core.resx como "Site de Equipe".Quando você cria um arquivo Onet.xml personalizado, você pode usar seqüências de caracteres literais.

Esse elemento também pode ter um atributo AlternateCSS AlternateCSS que especifica um alternativo arquivo folhas de estilo em cascata para obter definições estilo, um CustomJSUrl CustomJSUrl atributo especifica um alternativo arquivo JavaScript para personalizado script e um atributo AlternateHeader AlternateHeader especifica um arquivo ASPX para alternativo cabeçalhos.

O elemento 2ee96a89-03e9-4283-8a29-05c1e5b4788a do projeto não contém nenhum atributo identificando a definição site que ele define. Cada Onet.xml é associado com uma definição site by virtue of o caminho Diretório no qual ele reside, quais (except for o Onet.xml Global) é Program Files\Common Files\Microsoft Shared\Web Server Extensions\12\TEMPLATE\SiteTemplates\ site_type \XML\, onde site_type é o nome da definição de site, such as do STS ou MPS.

Elemento NavBars

O elemento e3e5a204-99e9-47aa-ba25-74f1a7bf5672 NavBars contém definições para o parte superior área navegação que é exibida sobre o home page ou em modos de exibição lista e as definições para a área navegação lateral exibida na home page.

Observação

Um barra de navegação não é necessariamente uma barra de ferramentas.Ele pode ficar, por exemplo, uma árvore de links.

<NavBars>
  <NavBar 
    name="$Resources:core,category_Top;" 
    Separator="&amp;nbsp;&amp;nbsp;&amp;nbsp;" 
    Body="&lt;a ID='onettopnavbar#LABEL_ID#' href='#URL#' accesskey='J'&gt;#LABEL#&lt;/a&gt;" 
    ID="1002" />
  <NavBar 
    name="$Resources:core,category_Documents;" 
    Prefix="&lt;table border=0 cellpadding=4 cellspacing=0&gt;" 
    Body="&lt;tr&gt;&lt;td&gt;&lt;table border=0 cellpadding=0 cellspacing=0&gt;&lt;tr&gt;&lt;td&gt;&lt;img src='/_layouts/images/blank.gif' ID='100' alt='' border=0&gt;&amp;nbsp;&lt;/td&gt;&lt;td valign=top&gt;&lt;a ID=onetleftnavbar#LABEL_ID# href='#URL#'&gt;#LABEL#&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;&lt;/td&gt;&lt;/tr&gt;" 
    Suffix="&lt;/table&gt;" 
    ID="1004" />
    ...
</NavBars>

Um elemento 4ff60a7b-7dc9-4129-add5-0a4e50a47175 NavBarLink define links para o parte superior ou área de navegação lateral e um inteiro Barra de navegação seção grupos novos links na área a lado. Cada elemento 0f997d7b-d1c1-4405-9d83-26e20cd37767 barra de navegação especifica um nome exibir e um identificação exclusiva para a navegação barra e define como para exibir a navegação barra.

Para obter informações sobre como personalizar as áreas navegação em páginas Windows SharePoint Services wssnoversshort, consulte Personalização de navegação do site.

Elemento ListTemplates

O 1da0da4b-bb4d-4a77-802d-57fd43a6a30e ListTemplates seção especifica as definições lista que fazem parte de uma definição site.

Observação

O ListTemplates ListTemplates seção não está incluído no arquivo Onet.xml do padrão Windows SharePoint Services site definição, que utiliza definição lista em vez disso, recursos e arquivos .xml elemento definam seus modelos lista.O seguinte exemplo é tirado do arquivo Onet.xml para a definição site Meetings Workspace.

<ListTemplates>
  <ListTemplate 
    name="meetings" 
    Displayname="$Resources:xml_onet_mwsidmeetingDisp;" 
    Type="200" 
    BaseType="0" 
    Unique="TRUE" 
    Hidden="TRUE" 
    HiddenList="TRUE" 
    DontSaveInTemplate="TRUE" 
    SecurityBits="11" 
    Description="$Resources:xml_onet_mwsidmeetingDesc;" Image="/_layouts/images/itevent.gif">
  </ListTemplate>
  <ListTemplate 
    name="agenda" 
    Displayname="$Resources:xml_onet_mwsidagendaDisp;" 
    Type="201" 
    BaseType="0" 
    FolderCreation="FALSE" 
    DisallowContentTypes="TRUE" 
    SecurityBits="11" 
    Description="$Resources:xml_onet_mwsidagendaDesc" 
    Image="/_layouts/images/itagnda.gif">
  </ListTemplate>
    ...
</ListTemplates>

Cada elemento 37a89367-4fed-46b9-afe9-386844f3e82c ListTemplate especifica um nome interno que identifica a definição lista. O elemento 37a89367-4fed-46b9-afe9-386844f3e82c ListTemplate também especifica um nome para a definição lista exibir e se a opção para adicionar um link no Inicialização rápida barra aparece Por padrão selecionado na página nova. Além disso, esse elemento Especifica a descrição de definição de lista e o caminho para a imagem que representa a definição lista, que ambos são exibidos na página a Criar. Se Hidden="TRUE" for especificado, a definição lista não aparece como uma opção sobre a página criar.

O elemento 37a89367-4fed-46b9-afe9-386844f3e82c ListTemplate tem dois atributos de tipo e Type BaseType. O atributo Type type Especifica um identificador exclusivo para definição de lista, enquanto BaseType identifica o tipo lista de base para definição de lista e corresponde para o valor Type tipo especificado para um dos tipos de lista de base definidos dentro de arquivo ONET.XML global ( \TEMPLATE\GLOBAL\XML).

Para uma tarefa programação que mostra como adicionar um modelo lista, consulte Como a: Criar uma definição de lista personalizado.

Elemento DocumentTemplates

O f3c0c837-6d70-40e9-8d8a-e2064c5dad83 DocumentTemplates seção define os modelos documento que são listados na página nova.

<DocumentTemplates>
  ...
  <DocumentTemplate 
    Path="STS" 
    Displayname="$Resources:core,doctemp_Word;" 
    Type="121" 
    Default="TRUE" 
    Description="$Resources:core,doctemp_Word_Desc;">
    <DocumentTemplateFiles>
      <DocumentTemplateFile 
        name="doctemp\word\wdtmpl.dotx" 
        Targetname="Forms/template.dotx" 
        Default="TRUE" />
    </DocumentTemplateFiles>
  </DocumentTemplate>
  ...
</DocumentTemplates>

Cada elemento 32b6d4ad-df45-44db-8ecd-b0f1b2d24143 DocumentTemplate especifica um nome exibir, um identificador exclusivo e uma descrição para o modelo do documento. Se será definido como Default padrão TRUE, o modelo é o modelo usar como padrão selecionado para bibliotecas documento criadas em sites criados com uma configuração na definição de site que está especificando o Onet.xml. Apesar do nome singular, um elemento 32b6d4ad-df45-44db-8ecd-b0f1b2d24143 DocumentTemplate realmente pode conter uma coleção de elementos c1d81e2f-80b0-4e84-ad0f-48e350708313 DocumentTemplateFile. Especifica o atributo Name Nome de cada elemento c1d81e2f-80b0-4e84-ad0f-48e350708313 DocumentTemplateFile o caminho relativo para um local arquivo que serve como o modelo. O atributo TargetName Nome_do_destino Especifica o destino URL do arquivo de modelo quando uma biblioteca documento é criada. O atributo Default padrão especifica se o arquivo é o arquivo modelo usar como padrão.

Para uma tarefa programação envolvendo documento modelos, consulte Como a: Adicionar um modelo de documento, Tipo de Arquivo e Editar Aplicativos para uma definição de site.

Elemento BaseTypes

O elemento 821c67d7-1799-480a-ae82-2f4c1b0b0655 BaseTypes do arquivo Onet.xml global é usado durante a criação lista ou site para definir os tipos lista cinco no qual lista todas as definições em Windows SharePoint Services se baseiam. Each list template that is specified in the list templates section is identified with one of the base types: Generic List, Document Library, Discussion Forum, Vote or Survey, or Issues List.

Observação

Em Windows SharePoint Services 3.0 a BaseTypes BaseTypes seção é implementada somente no arquivo Onet.xml global ( \TEMPLATE\GLOBAL\XML), do qual o seguinte exemplo é tirado.

<BaseTypes>
  <BaseType 
    Title="Generic List" 
    Image="/_layouts/images/itgen.gif" 
    Type="0">
      <MetaData>
        <Fields>
          <Field 
            ID="{1d22ea11-1e32-424e-89ab-9fedbadb6ce1}" 
            Colname="tp_ID" 
            RowOrdinal="0" 
            ReadOnly="TRUE" 
            Type="Counter" 
            name="ID" 
            PrimaryKey="TRUE" 
            Displayname="$Resources:core,ID" 
            SourceID="https://schemas.microsoft.com/sharepoint/v3" 
            Staticname="ID">
          </Field>
          <Field 
            ID="{03e45e84-1992-4d42-9116-26f756012634}" 
            RowOrdinal="0" 
            Type="ContentTypeId" 
            Sealed="TRUE" 
            ReadOnly="TRUE" 
            Hidden="TRUE" 
            Displayname="$Resources:core,Content_Type_ID;"
            name="ContentTypeId" 
            DisplaceOnUpgrade="TRUE"
            SourceID="https://schemas.microsoft.com/sharepoint/v3" 
            Staticname="ContentTypeId" 
            Colname="tp_ContentTypeId">
          </Field>
          ...
      </Fields>
    </MetaData>
  </BaseType>
  ...
</BaseTypes>

Cada elemento 764911ab-d94c-4829-a1fb-f85d3f359c81 BaseType especifica os campos usados nas listas que são derivado da tipo base. The Type attribute of each Elemento de campo (lista - de definição) element identifies the field with a field type that is defined in FldTypes.xml.

Aviso

Não modificar o conteúdo do arquivo Onet.xml global (arquivo ( \TEMPLATE\GLOBAL\XML), porque fazer caso pode interromper a instalação.Tipos base lista não podem ser adicionados.Para informações sobre como adicionar uma definição lista, consulte Como a: Criar uma definição de lista personalizado.

Elemento configurações

Cada elemento db6728d9-4615-44b0-b651-cdab95706494 de configuração no f05f8b97-90d5-4c7e-99df-0e58bd06be43 seção Configurações especifica as listas e os módulos que são criados Por padrão quando a configuração definição site é instanciado.

<Configurations>
  ...
  <Configuration 
    ID="0" 
    name="Default">
    <Lists>
      <List 
        FeatureId="00BFEA71-E717-4E80-AA17-D0C71B360101" 
        Type="101" 
        Title="$Resources:core,shareddocuments_Title;" 
        Url="$Resources:core,shareddocuments_Folder;" 
QuickLaunchUrl="$Resources:core,shareddocuments_Folder;/Forms/AllItems.aspx" />
      ...
    </Lists>
    <Modules>
      <Module 
        name="Default" />
    </Modules>
    <SiteFeatures>
      <Feature 
        ID="00BFEA71-1C5E-4A24-B310-BA51C3EB7A57" />
      <Feature 
        ID="FDE5D850-671E-4143-950A-87B473922DC7" />
    </SiteFeatures>
    <WebFeatures>
      <Feature 
        ID="00BFEA71-4EA5-48D4-A4AD-7EA5C011ABE5" />
      <Feature 
        ID="F41CC668-37E5-4743-B4A8-74D1DB3FD8A4" />
    </WebFeatures>
  </Configuration>
  ...
</Configurations>

O atributo ID identificação identifica a configuração (exclusivamente relativo às outras configurações na definição de site) e corresponde ao atributo de ID identificação de um elemento db6728d9-4615-44b0-b651-cdab95706494 de configuração em WebTemp.xml.

Cada elemento b2b26fee-eb45-48ac-99f1-65f725da293f lista Especifica o cargo de definição de lista e o URL para onde para criar a lista. O atributo QuickLaunchUrl QuickLaunchUrl pode ser usado para definir a URL de página de exibição para usar ao adicionar um link no Quick Launch a uma lista criada a partir de definição lista. O valor do atributo Type Tipo corresponde ao atributo Type Tipo de um modelo na seção Modelos de lista. Cada elemento cee7eacc-0142-4b33-a363-3ef0873799dc módulo Especifica o nome de um módulo definido a seção Módulos.

O SiteFeatures e 7f810810-c902-405e-9eef-f797a7032e5d WebFeatures elementos contêm referências a coleção site e recursos site\endash Scoped para incluir na definição de site.

Para pós-processamento capacidades, use um elemento 251fbe32-dfee-4bb1-b0c8-098512bec38c ExecuteUrl em um elemento db6728d9-4615-44b0-b651-cdab95706494 de configuração para especificar o URL que é chamado seguinte instanciação do site.

Para obter mais informações sobre configurações definição, consulte Como: usar as configurações de definição de site.

Elemento módulos

O 82288763-45ba-4e6c-b00e-10067da76033 coleção Modules especifica os módulos para incluir Por padrão em criar uma coleção site. Cada elemento cee7eacc-0142-4b33-a363-3ef0873799dc módulo por sua vez Especifica um ou mais arquivos a serem incluem, freqüentemente para Web Parts, que são armazenados em cache na memória no front-end servidor Web along with os arquivos de esquema. Você pode usar o atributo Url URL do elemento cee7eacc-0142-4b33-a363-3ef0873799dc módulo para configurar uma pasta como parte da definição de site.

<Modules>
  <Modules>
    <Module 
      name="Default" 
      Url="" 
      Path="">
      <File 
        Url="default.aspx" 
        NavBarHome="True">
        <View 
          List="$Resources:core,lists_Folder;
          /$Resources:core,announce_Folder;" 
          BaseViewID="0" 
          WebPartZoneID="Left" />
        <View 
          List="$Resources:core,lists_Folder;
          /$Resources:core,calendar_Folder;" 
          BaseViewID="0" 
          RecurrenceRowset="TRUE" 
          WebPartZoneID="Left" 
          WebPartOrder="2" />
        <AllUsersWebPart 
          WebPartZoneID="Right" 
          WebPartOrder="1"><![CDATA[<WebPart 
            xmlns="https://schemas.microsoft.com/WebPart/v2"
            xmlns:iwp="https://schemas.microsoft.com
            /WebPart/v2/Image">
            <Assembly>Microsoft.SharePoint, Version=12.0.0.0, 
              Culture=neutral, 
              PublicKeyToken=71e9bce111e9429c</Assembly>
            <TypeName>Microsoft.SharePoint.WebPartPages.ImageWebPart
            </TypeName>
            <FrameType>None</FrameType>
            <Title>$Resources:wp_SiteImage;</Title>
            <iwp:ImageLink>/_layouts/images/homepage.gif
            </iwp:ImageLink>
            <iwp:AlternativeText>$Resources:core,sitelogo_wss;
            </iwp:AlternativeText>
            </WebPart>]]>
        </AllUsersWebPart>
        <View 
          List="$Resources:core,lists_Folder;
          /$Resources:core,links_Folder;" 
          BaseViewID="0" 
          WebPartZoneID="Right" 
          WebPartOrder="2" />
          <NavBarPage 
            name="$Resources:core,nav_Home;" 
            ID="1002" 
            Position="Start" />
          <NavBarPage 
            name="$Resources:core,nav_Home;" 
            ID="0" 
            Position="Start" />
      </File>
    </Module>
  ...
</Modules>

O elemento cee7eacc-0142-4b33-a363-3ef0873799dc módulo especifica um nome para o módulo, que corresponde ao nome módulo que está especificado em uma configuração em ONET.XML.

O atributo Url URL de cada elemento do arquivo db86d800-9f68-43cc-b7d5-3bd76537dfde em um módulo Especifica o nome de um arquivo para criar quando um site é criado. Quando o módulo inclui um arquivo único, such as default.aspx, NavBarHome="TRUE" especifica que o arquivo servirá como o página de destino para o link Home Home na navegação Barras. O elemento db86d800-9f68-43cc-b7d5-3bd76537dfde de arquivos para default.aspx também especifica o Web Parts para incluir no home page e informações sobre o home page para outras páginas que link para ele.

Para obter mais informações sobre como usar os módulos no Windows SharePoint Services 3.0, consulte Como para: fornecer um arquivo.

Elemento componentes

O elemento 77a1b2e2-b261-45a1-8bd3-92fa821989aa componentes especifica componentes para incluir em sites criados através de definição.

<Components>
  <FileDialogPostProcessor ID="BDEADEE4-C265-11d0-BCED-00A0C90AB50F" />
</Components>

Elemento ServerEmailFooter

O elemento d9df4fb9-7e0a-4699-94d7-4b420f5066f6 ServerEmailFooter especifica o seção de rodapé usado no email enviado do servidor.

<ServerEmailFooter>$Resources:ServerEmailFooter;</ServerEmailFooter>

Consulte também

Conceitos

O esquema do site
Diretrizes para o uso de definições do site personalizado, as configurações e modelos