Элемент ListTemplate (шаблон списка)

Статья
04/08/2023

Область применения: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Задает определение списка, которое можно будет использовать при создании списков на странице Создание.

Определение

<ListTemplate
  AllowDeletion = "TRUE" | "FALSE"
  AllowEveryoneViewItems = "TRUE" | "FALSE"
  AlwaysIncludeContent = "TRUE" | "FALSE"
  BaseType = "0" | "1" | "3" |"4" | "5"
  CacheSchema = "TRUE" | "FALSE"
  Catalog = "TRUE" | "FALSE"
  Category = "Libraries" | "Communications" | "Tracking" |
    "Custom Lists"
  Default = "TRUE" | "FALSE"
  Description = "Text"
  DisableAttachments = "TRUE" | "FALSE"
  DisallowContentTypes = "TRUE" | "FALSE"
  DisplayName = "Text"
  DocumentAsEnclosure = "TRUE" | "FALSE"
  DocumentTemplate = "Integer"
  DontSaveInTemplate = "TRUE" | "FALSE"
  EditPage = "Text"
  EnableModeration = "TRUE" | "FALSE"
  EnablePeopleSelector = "TRUE" | "FALSE"
  EnableResourceSelector = "TRUE" | "FALSE"
  FeatureId = "Text"
  FolderCreation = "TRUE" | "FALSE"
  Hidden = "TRUE" | "FALSE"
  HiddenList = "TRUE" | "FALSE"
  Image = "URL"
  MultipleTypes = "TRUE" | "FALSE"
  MustSaveRootFiles = "TRUE" | "FALSE"
  Name = "Text"
  NewPage = "Text"
  NoCrawl = "TRUE" | "FALSE"
  OnQuickLaunch = "TRUE" | "FALSE"
  Path = "Text"
  RootWebOnly = "TRUE" | "FALSE"
  SecurityBits = "Text"
  Sequence = "Integer"
  SetupPath = "Text"
  SyncType = "Text"
  Type = "Integer"
  Unique = "TRUE" | "FALSE"
  UseRootFolderForNavigation = "TRUE" | "FALSE"
  VersioningEnabled = "TRUE" | "FALSE">
</ListTemplate>

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

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

Атрибуты

Атрибут	Описание
AllowDeletion	Необязательный параметр Boolean. TRUE, чтобы указать, что списки, созданные с помощью шаблона, не могут быть удалены; В противном случае — FALSE*.
AllowEveryoneViewItems	Необязательный параметр Boolean. TRUE, чтобы разрешить любому пользователю просматривать элементы в библиотеке. Атрибут AllowEveryoneViewItems* используется, например, в коллекции главных страниц, чтобы предоставить всем пользователям доступ к эталонным страницам.
AlwaysIncludeContent	Необязательный параметр Boolean. TRUE, чтобы указать, что содержимое списка будет по умолчанию включаться, когда списки, созданные с помощью шаблона, сохраняются в пользовательском интерфейсе как шаблоны списков; В противном случае — FALSE*.
Basetype	Обязательный Integer. Определяет для списков, создаваемых на основе определения, базовый тип или схему по умолчанию. * 0 — GenericList * 1 — DocumentLibrary * 3 — Доска обсуждений * 4 — опрос * 5 — проблема
CacheSchema	Необязательный параметр Boolean. TRUE для включения кэширования схемы списка при подготовке сайта. Атрибут CacheSchema используется, например, в глобальном файлеOnet.xml для включения кэширования списка пользователей для текущего семейства веб-сайтов.
Каталог	Необязательный параметр Boolean. TRUE*, чтобы указать, что определение списка предназначено для коллекции сайтов, коллекции списков или коллекции веб-частей.
Категории	Необязательный параметр Text. Задает категорию, с которой должны быть связаны списки, созданные на основе определения списка. Могут быть следующие значения: *Библиотеки *Коммуникаций *Отслеживания * Настраиваемые списки
По умолчанию	Необязательный параметр Boolean. TRUE*, чтобы указать, что новые сайты SharePoint будут включать этот список.
Описание	Необязательный параметр Text. Предоставляет описание определения списка.
DisableAttachments	Необязательный параметр Boolean. TRUE, чтобы указать, что пользователи могут вложить файлы в элементы списков, созданных с помощью шаблона; В противном случае — FALSE*.
DisallowContentTypes	Необязательный параметр Boolean. TRUE, чтобы указать, что типы контента не могут управляться списками, созданными с помощью шаблона; В противном случае — FALSE*.
Displayname	Обязательный Текст. Задает отображаемое имя определения списка.
DocumentAsEnclosure	Необязательный параметр Boolean. Указывает, содержит ли список документы в качестве объекта вложения.
DocumentTemplate	Необязательно Integer. В настоящее время не используется. Это допустимо только в элементе ListTemplate, для которого BaseType задано значение 1 (библиотеки документов). Для обеспечения совместимости в будущем он должен быть пустым или соответствовать атрибуту Type элемента DocumentTemplate в перечислении DocumentTemplates. [То же, что и предыдущая версия, но не рекомендуется.]
DontSaveInTemplate	Необязательный параметр Boolean. TRUE для исключения содержимого списка при сохранении списка в качестве пользовательского шаблона списка или при сохранении сайта, которому принадлежит список, в пользовательском интерфейсе.
EditPage	Необязательный параметр Text. Указывает имя настраиваемой страницы приложения (`/_layouts`), используемой в качестве страницы для редактирования свойств списка для списков, созданных с помощью шаблона списка.
EnableModeration	Необязательный параметр Boolean. TRUE, чтобы указать, что утверждение содержимого включено по умолчанию в списках, созданных с помощью шаблона; В противном случае — FALSE.
EnablePeopleSelector	Необязательный параметр Boolean. Задает значение свойства EnablePeopleSelector.
EnableResourceSelector	Необязательный параметр Boolean. Задает значение свойства EnableResourceSelector.
FeatureId	Необязательный параметр Text. Определяет GUID, идентифицирующий компонент, с которым связан этот шаблон.
FolderCreation	Необязательный параметр Boolean. TRUE, чтобы включить создание папок в списке и указать, что команда Создать папку* отображается в меню Создать в представлениях списка; В противном случае — FALSE.
Скрытые	Необязательный параметр Boolean. TRUE, чтобы указать, что определение списка недоступно на странице Создание* для создания списков.
HiddenList	Необязательный параметр Boolean. TRUE*, чтобы указать, что список, созданный из определения списка, скрыт.
Изображения	Необязательный URL-адрес. Задает URL-адрес значка, используемого для представления списка.
MultipleMtgDataList	Необязательный параметр Boolean. Если указан параметр MultipleMtgDataList="TRUE", список на сайте рабочей области для собраний содержит данные для нескольких экземпляров собраний на сайте.
MultipleTypes	Необязательный параметр Boolean. Указывает, существует ли несколько типов списков.
MustSaveRootFiles	Необязательный параметр Boolean. TRUE* для сохранения страниц, содержащихся в специальной библиотеке документов, которая используется внутри сайта рабочей области для собраний, когда шаблон списка сохраняется без содержимого. Этот атрибут не предназначен для общего использования.
Имя	Обязательный Текст. Задает внутреннее имя определения списка. Пробелы и специальные символы не должны использоваться. Имя используется также для поиска папки, содержащей файл Schema.xml, который определяет используемую схему.
NewPage	Необязательный параметр Text. Задает имя настраиваемой страницы, используемой при создании нового списка посредством шаблона списка.
NoCrawl	Необязательный параметр Boolean. TRUE, чтобы указать, что список не отображается в результатах поиска; В противном случае — FALSE*.
OnQuickLaunch	Необязательный параметр Boolean. TRUE для отображения списков, созданных из определения списка, на панели QuickLaunch.
Путь	Необязательный параметр Text. Указывает имя определения сайта, содержащего определение списка; например, STS. Предполагается, что это путь относительно каталога 12\TEMPLATE. Путь может быть направлен на схему компонентов; например, Компоненты\Объявления. [То же, что и предыдущая версия, но не рекомендуется.]
RootWebOnly	Необязательный параметр Boolean. TRUE*, чтобы указать, что список, созданный на основе определения, существует только на корневом веб-сайте семейства веб-сайтов. [То же, что и предыдущая версия, но не рекомендуется.]
SecurityBits	Необязательный параметр Text. Определяет разрешения на уровне элементов в списке для пользователей, имеющих права на чтение или изменение элементов списка. Атрибут SecurityBits содержит строку из двух цифр. Первая цифра в строке контролирует права на чтение, вторая цифра — права на изменение. Допустимые значения, определяющие права на чтение: * 1 Пользователи могут читать все элементы. * 2 Пользователи могут читать только собственные элементы. Для доступа на изменение используются следующие допустимые цифры: * 1 Пользователи могут редактировать все элементы. * 2 Пользователи могут изменять только собственные элементы. * 4 Пользователи не могут редактировать элементы. Примечание. Пользователи с разрешением ManageLists могут читать и изменять все элементы независимо от значения атрибута SecurityBits. Этот атрибут не применим к библиотекам документов.
Последовательности	Необязательно Integer. Указывает приоритет упорядочения, используемый для шаблона списка на странице Создание. Если параметр Sequence не задан, шаблон отображается последним в произвольном порядке с другими шаблонами, в которые также отсутствует значение Sequence. Два шаблона, указывающие одну последовательность, сортируются в произвольном порядке.
SetupPath	Необязательный параметр Text. Указывает путь к папке в каталоге установки SharePoint Foundation (%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\\TEMPLATE), содержащей файл для включения в шаблон.
SyncType	Необязательный параметр Boolean. TRUE для переопределения типа списка клиентов по умолчанию, связанного с базовым шаблоном SharePoint Foundation.
Тип	Необязательно Integer. Представляет уникальный идентификатор шаблона. Этот идентификатор должен быть уникальным внутри компонента, но не обязан быть уникальным во всех определениях компонентов или сайтов. Список типов шаблонов списков по умолчанию см. в разделе SPListTemplateType. Этот атрибут соответствует атрибуту Type элемента List .
Уникальный	Необязательный параметр Boolean. TRUE, чтобы указать, что определение списка или шаблон списка можно использовать для создания списка только во время создания сайта и не может использоваться для создания списка с помощью объектной модели или пользовательского интерфейса после применения шаблона сайта или определения. Установка этого атрибута в значение TRUE* приводит к скрытию списка, чтобы он не отображался в качестве параметра на странице Создать или на странице Документы и списки.
UseRootFolderForNavigation	Необязательный параметр Boolean. TRUE, чтобы указать, что ссылка на список, отображаемый в разделе Быстрый запуск* указывает на корневую папку, чтобы пользователи переходили на настраиваемую страницу приветствия, а не на страницу представления списка по умолчанию. Если настраиваемый начальный URL-адрес не установлен для списка, визуализация ссылки на корневую папку функционально эквивалентна ссылке на применяемое по умолчанию представление списка.
Управление версиямиEnabled	Необязательный параметр Boolean. TRUE, чтобы указать, что управление версиями включено по умолчанию в списках, созданных с помощью шаблона; В противном случае — FALSE*.

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

Нет

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

Элементы
Элементы

Пример

Пример использования этого элемента см. в разделе List Template Files.

Атрибут	Описание
AllowDeletion	Необязательный параметр Boolean. TRUE, чтобы указать, что списки, созданные с помощью шаблона, не могут быть удалены; В противном случае — FALSE*.
AllowEveryoneViewItems	Необязательный параметр Boolean. TRUE, чтобы разрешить любому пользователю просматривать элементы в библиотеке. Атрибут AllowEveryoneViewItems* используется, например, в коллекции главных страниц, чтобы предоставить всем пользователям доступ к эталонным страницам.
AlwaysIncludeContent	Необязательный параметр Boolean. TRUE, чтобы указать, что содержимое списка будет по умолчанию включаться, когда списки, созданные с помощью шаблона, сохраняются в пользовательском интерфейсе как шаблоны списков; В противном случае — FALSE*.
Basetype	Обязательный Integer. Определяет для списков, создаваемых на основе определения, базовый тип или схему по умолчанию. * 0 — GenericList * 1 — DocumentLibrary * 3 — Доска обсуждений * 4 — опрос * 5 — проблема
CacheSchema	Необязательный параметр Boolean. TRUE для включения кэширования схемы списка при подготовке сайта. Атрибут CacheSchema используется, например, в глобальном файлеOnet.xml для включения кэширования списка пользователей для текущего семейства веб-сайтов.
Каталог	Необязательный параметр Boolean. TRUE*, чтобы указать, что определение списка предназначено для коллекции сайтов, коллекции списков или коллекции веб-частей.
Категории	Необязательный параметр Text. Задает категорию, с которой должны быть связаны списки, созданные на основе определения списка. Могут быть следующие значения: *Библиотеки *Коммуникаций *Отслеживания * Настраиваемые списки
По умолчанию	Необязательный параметр Boolean. TRUE*, чтобы указать, что новые сайты SharePoint будут включать этот список.
Описание	Необязательный параметр Text. Предоставляет описание определения списка.
DisableAttachments	Необязательный параметр Boolean. TRUE, чтобы указать, что пользователи могут вложить файлы в элементы списков, созданных с помощью шаблона; В противном случае — FALSE*.
DisallowContentTypes	Необязательный параметр Boolean. TRUE, чтобы указать, что типы контента не могут управляться списками, созданными с помощью шаблона; В противном случае — FALSE*.
Displayname	Обязательный Текст. Задает отображаемое имя определения списка.
DocumentAsEnclosure	Необязательный параметр Boolean. Указывает, содержит ли список документы в качестве объекта вложения.
DocumentTemplate	Необязательно Integer. В настоящее время не используется. Это допустимо только в элементе ListTemplate, для которого BaseType задано значение 1 (библиотеки документов). Для обеспечения совместимости в будущем он должен быть пустым или соответствовать атрибуту Type элемента DocumentTemplate в перечислении DocumentTemplates. [То же, что и предыдущая версия, но не рекомендуется.]
DontSaveInTemplate	Необязательный параметр Boolean. TRUE для исключения содержимого списка при сохранении списка в качестве пользовательского шаблона списка или при сохранении сайта, которому принадлежит список, в пользовательском интерфейсе.
EditPage	Необязательный параметр Text. Указывает имя настраиваемой страницы приложения (`/_layouts`), используемой в качестве страницы для редактирования свойств списка для списков, созданных с помощью шаблона списка.
EnableModeration	Необязательный параметр Boolean. TRUE, чтобы указать, что утверждение содержимого включено по умолчанию в списках, созданных с помощью шаблона; В противном случае — FALSE.
EnablePeopleSelector	Необязательный параметр Boolean. Задает значение свойства EnablePeopleSelector.
EnableResourceSelector	Необязательный параметр Boolean. Задает значение свойства EnableResourceSelector.
FeatureId	Необязательный параметр Text. Определяет GUID, идентифицирующий компонент, с которым связан этот шаблон.
FolderCreation	Необязательный параметр Boolean. TRUE, чтобы включить создание папок в списке и указать, что команда Создать папку* отображается в меню Создать в представлениях списка; В противном случае — FALSE.
Скрытые	Необязательный параметр Boolean. TRUE, чтобы указать, что определение списка недоступно на странице Создание* для создания списков.
HiddenList	Необязательный параметр Boolean. TRUE*, чтобы указать, что список, созданный из определения списка, скрыт.
Изображения	Необязательный URL-адрес. Задает URL-адрес значка, используемого для представления списка.
MultipleMtgDataList	Необязательный параметр Boolean. Если указан параметр MultipleMtgDataList="TRUE", список на сайте рабочей области для собраний содержит данные для нескольких экземпляров собраний на сайте.
MultipleTypes	Необязательный параметр Boolean. Указывает, существует ли несколько типов списков.
MustSaveRootFiles	Необязательный параметр Boolean. TRUE* для сохранения страниц, содержащихся в специальной библиотеке документов, которая используется внутри сайта рабочей области для собраний, когда шаблон списка сохраняется без содержимого. Этот атрибут не предназначен для общего использования.
Имя	Обязательный Текст. Задает внутреннее имя определения списка. Пробелы и специальные символы не должны использоваться. Имя используется также для поиска папки, содержащей файл Schema.xml, который определяет используемую схему.
NewPage	Необязательный параметр Text. Задает имя настраиваемой страницы, используемой при создании нового списка посредством шаблона списка.
NoCrawl	Необязательный параметр Boolean. TRUE, чтобы указать, что список не отображается в результатах поиска; В противном случае — FALSE*.
OnQuickLaunch	Необязательный параметр Boolean. TRUE для отображения списков, созданных из определения списка, на панели QuickLaunch.
Путь	Необязательный параметр Text. Указывает имя определения сайта, содержащего определение списка; например, STS. Предполагается, что это путь относительно каталога 12\TEMPLATE. Путь может быть направлен на схему компонентов; например, Компоненты\Объявления. [То же, что и предыдущая версия, но не рекомендуется.]
RootWebOnly	Необязательный параметр Boolean. TRUE*, чтобы указать, что список, созданный на основе определения, существует только на корневом веб-сайте семейства веб-сайтов. [То же, что и предыдущая версия, но не рекомендуется.]
SecurityBits	Необязательный параметр Text. Определяет разрешения на уровне элементов в списке для пользователей, имеющих права на чтение или изменение элементов списка. Атрибут SecurityBits содержит строку из двух цифр. Первая цифра в строке контролирует права на чтение, вторая цифра — права на изменение. Допустимые значения, определяющие права на чтение: * 1 Пользователи могут читать все элементы. * 2 Пользователи могут читать только собственные элементы. Для доступа на изменение используются следующие допустимые цифры: * 1 Пользователи могут редактировать все элементы. * 2 Пользователи могут изменять только собственные элементы. * 4 Пользователи не могут редактировать элементы. Примечание. Пользователи с разрешением ManageLists могут читать и изменять все элементы независимо от значения атрибута SecurityBits. Этот атрибут не применим к библиотекам документов.
Последовательности	Необязательно Integer. Указывает приоритет упорядочения, используемый для шаблона списка на странице Создание. Если параметр Sequence не задан, шаблон отображается последним в произвольном порядке с другими шаблонами, в которые также отсутствует значение Sequence. Два шаблона, указывающие одну последовательность, сортируются в произвольном порядке.
SetupPath	Необязательный параметр Text. Указывает путь к папке в каталоге установки SharePoint Foundation (%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\\TEMPLATE), содержащей файл для включения в шаблон.
SyncType	Необязательный параметр Boolean. TRUE для переопределения типа списка клиентов по умолчанию, связанного с базовым шаблоном SharePoint Foundation.
Тип	Необязательно Integer. Представляет уникальный идентификатор шаблона. Этот идентификатор должен быть уникальным внутри компонента, но не обязан быть уникальным во всех определениях компонентов или сайтов. Список типов шаблонов списков по умолчанию см. в разделе SPListTemplateType. Этот атрибут соответствует атрибуту Type элемента List .
Уникальный	Необязательный параметр Boolean. TRUE, чтобы указать, что определение списка или шаблон списка можно использовать для создания списка только во время создания сайта и не может использоваться для создания списка с помощью объектной модели или пользовательского интерфейса после применения шаблона сайта или определения. Установка этого атрибута в значение TRUE* приводит к скрытию списка, чтобы он не отображался в качестве параметра на странице Создать или на странице Документы и списки.
UseRootFolderForNavigation	Необязательный параметр Boolean. TRUE, чтобы указать, что ссылка на список, отображаемый в разделе Быстрый запуск* указывает на корневую папку, чтобы пользователи переходили на настраиваемую страницу приветствия, а не на страницу представления списка по умолчанию. Если настраиваемый начальный URL-адрес не установлен для списка, визуализация ссылки на корневую папку функционально эквивалентна ссылке на применяемое по умолчанию представление списка.
Управление версиямиEnabled	Необязательный параметр Boolean. TRUE, чтобы указать, что управление версиями включено по умолчанию в списках, созданных с помощью шаблона; В противном случае — FALSE*.

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