Elemento de configuração (Site)

Artigo
04/08/2023

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Especifica as listas e módulos usados na criação de um site do SharePoint Foundation que se baseia na configuração de definição do site representada pelo elemento Configuration . Esses elementos também representam configurações em Modelos Web.

Para simplificar, a frase "configuração de definição de site" é usada em todo este tópico, embora o tópico também se aplique às configurações de modelo da Web. Exceto quando especificado caso contrário, as descrições de atributo a seguir se aplicam a elementos de configuração em definições de site e modelos da Web.

<Configuration
    AllowGlobalFeatureAssociations = "TRUE" | "FALSE"
    CustomMasterUrl = "Text"
    Description = "Text"
    DisplayCategory = "Text"
    FilterCategories = "Text"
    Hidden = "TRUE" | "FALSE"
    ID = "Integer"
    ImageUrl = "Text"
    MasterUrl = "Text"
    Name = "Text"
    ProvisionAssembly = "Text"
    ProvisionClass = "Text"
    ProvisionData = "Text"
    RootWebOnly = "TRUE" | "FALSE"
    SubWebOnly = "TRUE" | "FALSE"
    SupportsMultilingualUI = "TRUE" | "FALSE"
    Title = "Text"
    Type = "Text"
    VisibilityFeatureDependency = "Text">
</Configuration>

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo	Descrição
AllowGlobalFeatureAssociations	Booliano opcional. Especifica se associações de recursos globais são permitidas para sites criados com a configuração de definição do site.
Custommasterurl	Texto opcional. Especifica a URL de uma página alternativa .master que pode ser usada em páginas em sites criados por meio da configuração de definição do site sem personalizar essas páginas. OBSERVAÇÃO: simplesmente alterar o valor do atributo MasterPageFile em páginas que precisam de uma página mestra alternativa personalizaria essas páginas e faria com que elas fossem armazenadas no banco de dados de conteúdo em vez do sistema de arquivos dos servidores Web front-end. Para obter mais informações sobre como o valor do CustomMasterUrl é usado, consulte Páginas Mestras em Páginas de Aplicativo.
Descrição	Texto opcional. Contém a descrição específica da localidade da configuração de definição do site que aparece na interface do usuário do SharePoint Foundation.
DisplayCategory	Texto opcional. Especifica a categoria na qual a configuração de definição do site será exibida na interface do usuário do SharePoint Foundation, por exemplo, Colaboração, Reuniões ou algum nome personalizado.
FilterCategories	Texto opcional. Esse atributo não é usado pelo SharePoint Foundation. Ele está disponível para soluções avançadas de portal ou gerenciamento de conteúdo criadas no SharePoint Foundation, como o Microsoft SharePoint Server, para usar como um meio de categorizar as configurações do site de maneiras que não mapeiem precisamente para as categorizações que aparecem na interface do usuário. (Consulte também o atributo DisplayCategory .)
Oculto	Booliano opcional. Especifica se a configuração de definição do site aparece como uma opção na interface do usuário do SharePoint Foundation.
ID	Obrigatório Integer. Especifica uma ID para a configuração de definição do site exclusiva dentro da definição do site. Uma definição, como STS ou MPS, é definida por um elemento Template em um `WebTemp.xml` arquivo e por um arquivo correspondente `Onet.xml` para a definição. Confira Elementos pai* e comentários abaixo.
Imageurl	Texto obrigatório. Contém a URL da imagem de visualização exibida na interface do usuário do SharePoint Foundation.
Masterurl	Texto opcional. Especifica a página mestra padrão a ser usada para sites criados por meio da configuração de definição do site.
Nome	Texto opcional. Contém o nome da configuração de definição do site.
ProvisionAssembly	Texto opcional. Especifica o nome do assembly que contém a classe de provisionamento, se houver um. (Confira ProvisionClass abaixo.) Por exemplo: `ProvisionAssembly="MyCompany.SharePoint.ProvisionHelper, Version=1.0.0.0, Culture=neutral, PublicKeyToken=82f0cdf222f0530d"`
ProvisionClass	Texto opcional. Especifica o nome totalmente qualificado de uma classe que fornece a funcionalidade de provisionamento que será executada quando o runtime terminar de criar um site a partir da configuração. Não é necessário que haja tal classe, mas se você precisar de uma para uma configuração personalizada, ela deve derivar do SPWebProvisioningProvider . Por exemplo: `ProvisionClass="MyCompany.SharePoint. ProvisionHelper.MySiteProvisioningProvider"`
ProvisionData	Texto opcional. Especifica os dados que serão usados pelo método Provision(SPWebProvisioningProperties) do ProvisionClass (consulte acima). Esse pode ser um caminho para o arquivo que contém dados estruturados. Por exemplo: `ProvisionData="SiteTemplates\\MySiteManifest.xml"`
RootWebOnly	Booliano opcional. TRUE para especificar que o site criado a partir da configuração existe apenas como o site raiz em uma coleção de sites. Esse atributo não é imposto em modelos Da Web, que são armazenados em Solução (`.wsp` arquivos).
SubWebOnly	Booliano opcional. TRUE para especificar que o site criado a partir da configuração existe apenas como um subsite dentro de uma coleção de sites. Esse atributo não é imposto em modelos Da Web, que são armazenados em Solução (`.wsp` arquivos).
SupportsMultilingualUI	Booliano opcional. TRUE (o padrão) para especificar que os administradores podem habilitar idiomas alternativos para sites criados a partir da configuração. FALSE impede que os administradores habilitem essa funcionalidade.
Título	Texto opcional. Contém o título da configuração de definição do site exibida na interface do usuário do SharePoint Foundation.
Tipo	Texto opcional. Identifica a definição do site, como STS ou MPS.
VisibilityFeatureDependency	Texto opcional. Usado em um `WebTemp*.xml` arquivo para ocultar a configuração de definição do site com base no estado de ativação do Recurso especificado. Quando uma configuração contém Recursos que dependem de outro Recurso, definir esse atributo impede que a configuração apareça como uma opção na interface do usuário do SharePoint Foundation se o recurso especificado não estiver instalado ou ativado. Esse atributo não tem suporte para recursos com escopo de aplicativo Web.

Elementos filho

Elementos pai

Occurrences

Mínimo: 0
Máximo: Desvinculado

Comentários

Um elemento Configuration é usado em WebTemp*.xml arquivos (consulte WebTemp.xml) para identificar uma configuração de definição de site disponível dentro de uma definição de site.

Ele é usado em Onet.xml arquivos para definir uma configuração de listas, módulos e recursos que são usados para criar um site a partir da configuração de definição do site.

Em um WebTemp*.xml arquivo, esse elemento está contido em um elemento Template que especifica a definição do site. No Onet.xml, esse elemento está contido em um elemento Configurations que especifica as configurações cujas listas são definidas dentro do Onet.xml.

Há um elemento Template em um WebTemp*.xml arquivo e um Onet.xml arquivo para cada definição de site.

O atributo ID associa o elemento Configuration a uma determinada definição de site em um WebTemp*.xml arquivo ao elemento De configuração correspondente para a mesma definição de site no Onet.xml.

Um modelo Da Web, diferente de uma configuração de definição de site, é definido com um elemento WebTemplate em um elements.xml arquivo dentro de um arquivo .wsp armazenado no banco de dados do SharePoint. Também no arquivo .wsp há um Onet.xml arquivo com um único elemento Configuration que especifica os detalhes do modelo Web.

Exemplo

O exemplo a seguir de WebTemp.xml especifica as três configurações para a definição do site do STS .

<Template Name="STS" ID="1">
    <Configuration ID="0" Title="Team Site" Hidden="FALSE" ImageUrl="/_layouts/images/stts.png" Description="A site for teams to quickly organize, author, and share information. It provides a document library, and lists for managing announcements, calendar items, tasks, and discussions." DisplayCategory="Collaboration" >    </Configuration>
    <Configuration ID="1" Title="Blank Site" Hidden="FALSE" ImageUrl="/_layouts/images/stbs.png" Description="A blank site for you to customize based on your requirements." DisplayCategory="Collaboration" AllowGlobalFeatureAssociations="False" >    </Configuration>
    <Configuration ID="2" Title="Document Workspace" Hidden="FALSE" ImageUrl="/_layouts/images/stdw.png" Description="A site for colleagues to work together on a document. It provides a document library for storing the primary document and supporting files, a tasks list for assigning to-do items, and a links list for resources related to the document." DisplayCategory="Collaboration" >    </Configuration>
 </Template>

Compartilhar via