Элемент Configuration (Site)

Статья
04/08/2023

Применимо к: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Указывает списки и модули, используемые при создании веб-сайта SharePoint Foundation, основанного на конфигурации определения сайта , представленной элементом Configuration . Эти элементы также представляют конфигурации в веб-шаблонах.

Для простоты в этом разделе используется фраза "конфигурация определения сайта", хотя этот раздел также относится к конфигурациям веб-шаблонов. За исключением случаев, когда указано иное, следующие описания атрибутов применяются к элементам конфигурации как в определениях сайтов, так и в веб-шаблонах.

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

Элементы и атрибуты

В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Атрибут	Описание
AllowGlobalFeatureAssociations	Необязательный логический. Указывает, разрешены ли глобальные связи компонентов для сайтов, созданных с конфигурацией определения сайта.
CustomMasterUrl	Необязательный текст. Указывает URL-адрес альтернативной master-страницы, которую можно использовать на страницах веб-сайтов, созданных с помощью конфигурации определения сайта, без настройки этих страниц. ПРИМЕЧАНИЕ. Простое изменение значения атрибута MasterPageFile на страницах, которым требуется альтернативная главная страница, приведет к настройке этих страниц и их хранению в базе данных контента, а не в файловой системе интерфейсных веб-серверов. Дополнительные сведения об использовании значения CustomMasterUrl см. в разделе Главные страницы на страницах приложений.
Описание	Необязательный текст. Содержит описание конфигурации определения сайта, которая отображается в пользовательском интерфейсе SharePoint Foundation, специфичное для языкового стандарта.
DisplayCategory	Необязательный текст. Указывает категорию, в которой конфигурация определения сайта будет отображаться в пользовательском интерфейсе SharePoint Foundation, например Совместная работа, Собрания или какое-либо пользовательское имя.
Категории фильтров	Необязательный текст. Этот атрибут не используется SharePoint Foundation. Он доступен для расширенных решений для портала или управления содержимым, созданных на основе SharePoint Foundation, таких как Microsoft SharePoint Server, для использования в качестве средства классификации конфигураций сайтов таким образом, чтобы они не сопоставлялись точно с категориями, отображаемыми в пользовательском интерфейсе. (См. также атрибут DisplayCategory .)
Hidden	Необязательный логический. Указывает, отображается ли конфигурация определения сайта как параметр в пользовательском интерфейсе SharePoint Foundation.
ID	Обязательный атрибут типа Integer. Указывает идентификатор конфигурации определения сайта, которая является уникальной в определении сайта. Определение, например STS или MPS, определяется элементом Template в `WebTemp.xml` файле и соответствующим `Onet.xml` файлом для определения. См. раздел Родительские элементы* и примечания ниже.
Imageurl	Обязательный текст. Содержит URL-адрес изображения предварительного просмотра, отображаемого в пользовательском интерфейсе SharePoint Foundation.
MasterUrl	Необязательный текст. Указывает главную страницу по умолчанию для веб-сайтов, созданных с помощью конфигурации определения сайта.
Имя	Необязательный текст. Содержит имя конфигурации определения сайта.
ProvisionAssembly	Необязательный текст. Указывает имя сборки, содержащей класс подготовки, если он есть. (См. раздел ProvisionClass ниже.) Например: `ProvisionAssembly="MyCompany.SharePoint.ProvisionHelper, Version=1.0.0.0, Culture=neutral, PublicKeyToken=82f0cdf222f0530d"`
ProvisionClass	Необязательный текст. Задает полное имя класса, предоставляющего функции подготовки, которые будут выполняться по завершении создания сайта из конфигурации средой выполнения. Такой класс не требуется, но если он нужен для настраиваемой конфигурации, он должен быть производным от SPWebProvisioningProvider . Например: `ProvisionClass="MyCompany.SharePoint. ProvisionHelper.MySiteProvisioningProvider"`
ProvisionData	Необязательный текст. Указывает данные, которые будут использоваться методом Provision(SPWebProvisioningProperties)класса ProvisionClass (см. выше). Это может быть путь к файлу, который содержит структурированные данные. Например: `ProvisionData="SiteTemplates\\MySiteManifest.xml"`
RootWebOnly	Необязательный логический. ЗНАЧЕНИЕ TRUE , чтобы указать, что сайт, созданный из конфигурации, существует только в качестве корневого веб-сайта в семействе веб-сайтов. Этот атрибут не применяется в веб-шаблонах, которые хранятся в решении (`.wsp` файлы).
SubWebOnly	Необязательный логический. ЗНАЧЕНИЕ TRUE , чтобы указать, что сайт, созданный из конфигурации, существует только в качестве дочернего сайта в семействе веб-сайтов. Этот атрибут не применяется в веб-шаблонах, которые хранятся в решении (`.wsp` файлы).
SupportsMultilingualUI	Необязательный логический. ЗНАЧЕНИЕ TRUE (значение по умолчанию), чтобы указать, что администраторы могут включать альтернативные языки для сайтов, созданных на основе конфигурации. Значение FALSE не позволяет администраторам включить эту функцию.
Title	Необязательный текст. Содержит заголовок конфигурации определения сайта, отображаемой в пользовательском интерфейсе SharePoint Foundation.
Тип	Необязательный текст. Определяет определение сайта, например STS или MPS.
VisibilityFeatureDependency	Необязательный текст. Используется в `WebTemp*.xml` файле для скрытия конфигурации определения сайта на основе состояния активации указанного компонента. Если конфигурация содержит компоненты, зависящие от другого компонента, установка этого атрибута предотвращает появление конфигурации в качестве параметра в пользовательском интерфейсе SharePoint Foundation, если указанный компонент не установлен или активирован. Данный атрибут не поддерживается для компонентов с областью веб-приложения.

Дочерние элементы

Родительские элементы

Occurrences

Минимум: 0
Максимум: без ограничений

Замечания

Элемент Configuration используется в файлах WebTemp*.xml (см .WebTemp.xml) для определения доступной конфигурации определения сайта в определении сайта.

Он используется в файлахOnet.xml для определения конфигурации списков, модулей и компонентов, используемых для создания сайта на основе конфигурации определения сайта.

WebTemp*.xml В файле этот элемент содержится в элементе Template, который указывает определение сайта. В Onet.xmlэтот элемент содержится в элементе Configurations , который указывает конфигурации, списки которых определены в Onet.xml.

В файле есть один элемент WebTemp*.xmlTemplate и один Onet.xml файл для каждого определения сайта.

Атрибут ID связывает элемент Configuration для заданного определения сайта в файле с соответствующим элементом WebTemp*.xmlConfiguration для этого же определения сайта в Onet.xml.

Веб-шаблон, отличный от конфигурации определения сайта, определяется с помощью элемента WebTemplate в elements.xml файле внутри WSP-файла, хранящегося в базе данных SharePoint. Кроме того, в WSP-файле находится Onet.xml файл с одним элементом Configuration , который указывает сведения о веб-шаблоне.

Пример

В следующем примере изWebTemp.xml указываются три конфигурации для определения веб-сайта службы безопасности .

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

Поделиться через