Значения по умолчанию для метаданных на основе расположения
Дата последнего изменения: 15 апреля 2010 г.
Применимо к: SharePoint Server 2010
В этой статье
Общие сведения о значениях метаданных по умолчанию на основе расположений
Условия и приоритеты
Регистрация приемников событий для применения значений метаданных по умолчанию
Настройка значений метаданных по умолчанию для расположений
Поддержка программирования значений метаданных по умолчанию на основе расположений
В этом разделе описываются значения метаданных по умолчанию на основе расположений, соответствующие параметры конфигурации, применяющиеся к приложениям правила приоритетов, а также принципы использования таких значений для применения метаданных по умолчанию.
Общие сведения о значениях метаданных по умолчанию на основе расположений
Значения метаданных по умолчанию на основе расположений определяют значения по умолчанию для полей метаданных, которые отображаются пользователю при редактировании документа на основе расположения. При работе пользователя с сайтом Microsoft SharePoint Server 2010SharePoint Server применяет значения по умолчанию, которые отображаются при первом открытии формы редактирования документа пользователем. Приложения Microsoft Office 2010, например, Microsoft Word 2010, получают значения по умолчанию для расположения при сохранении документа. При сохранении документа клиентское приложение получает сведения о типе контента для расположения, в котором сохраняется этот элемент контента, а сервер применяет полученные значения по умолчанию и создает схему свойств в документе Office 2010.
Условия и приоритеты
Место применения значений метаданных по умолчанию на основе расположений в документе определяется на основе условных правил. В этом разделе сначала приводятся условия, а затем правила приоритета, определяющие порядок их применения.
Значения по умолчанию применяются:
При отправке отдельного файла.
При пакетном добавлении файлов с помощью представления проводника или элемента ActiveX "Отправить несколько документов".
При создании новой страницы публикации.
При создании нового документа по умолчанию в наборе документов.
При создании документа в рабочем процессе.
При сохранении непосредственно из клиентских приложений Office 2010 или рабочего пространства SharePoint.
После завершения преобразования документа.
В SharePoint Server 2010 перед применением значений по умолчанию метаданных на основе расположений устанавливается набор общих правил приоритета, которые определяют применяемые значения метаданных по умолчанию, а также порядок их применения. Например, используются отдельные правила приоритета для применения значений по умолчанию на сервере, для регистрации приемников событий, определения последовательности событий, вызываемых при отправке документа на сервер, и т. д.
Способ и порядок применения значений метаданных по умолчанию на основе расположений к элементам в SharePoint Server 2010 регламентируется порядком установки приоритета в компоненте. Сначала при отправке документа в папку в библиотеке документов получаются значения метаданных по умолчанию на основе расположений из разных мест, в том числе:
Отправляемый документ, который может содержать значение столбца, встроенный столбец, например, "Заголовок", или документ, к которому при сохранении была применена схема с таким же столбцом. Только в этих двух случаях отправляемый документ может содержать значение столбца.
Определение поля в списке, которое может задавать значение по умолчанию.
Местоположение в библиотеке документов, в которое отправляется документ (может задавать значение столбца по умолчанию).
Правила приоритета, которые определяют применяемое к столбцу значение:
Если отправляемый документ содержит значение поля, соответствующее заданному по умолчанию в определении поля, в SharePoint Server 2010 текущее значение поля перезаписывается значением по умолчанию, определяемым на основе расположения (если такое существует), на основе правил приоритета.
Если отправляемый документ содержит значение, отличающееся от заданного по умолчанию, то в SharePoint Server 2010 это значение сохраняется, даже если для него определено значение по умолчанию на основе расположения.
Если поле не существует, сервер использует значение по умолчанию, заданное в определении поля.
Регистрация приемников событий для применения значений метаданных по умолчанию
Если настройка значений метаданных по умолчанию на основе расположений выполняется в первый раз для любого расположения в библиотеке документов, в SharePoint Server 2010 регистрируется новый синхронный приемник последующих событий ItemAdded для этой библиотеки. После регистрации события сервер применяет его к значениям по умолчанию на основе расположений. Последовательность событий влияет на то, как значения метаданных по умолчанию на основе расположений повышаются с уровня документа до соответствующего столбца в списке SharePoint Server 2010, какие значения по умолчанию задаются для расположения, а также на необходимость обновления или исправления значений любых свойств.
Пользователь отправляет документ в расположение. В этом случае метаданные повышаются с уровня документа.
Запускается новый приемник событий ItemAdded. Этот приемник проверяет, какие значения метаданных по умолчанию заданы для этого расположения и обновляет значения свойств, для которых указано значение по умолчанию и текущее значение эквивалентно значению по умолчанию для заданного типа контента.
Пользователю отображается стандартная форма редактирования элемента, предварительно заполненная значениями по умолчанию.
Если удалить последнее значение по умолчанию на основе расположения из библиотеки документов, сервер отменит регистрацию приемника событий.
После отправки документа на сервер вызывается событие ItemAdded, и значения метаданных документа для всех столбцов повышаются до уровня соответствующего столбца в списке. В SharePoint Server 2010 отображается форма редактирования документа. При этом сервер изменяет фактические значения метаданных с использованием общих правил приоритета.
Настройка значений метаданных по умолчанию для расположений
Значения метаданных по умолчанию для расположений можно настроить для столбцов в иерархии папок, которые поддерживают установку значений по умолчанию. Если значения по умолчанию настраиваются для родительской папки, вложенные в нее папки наследуют соответствующие значения, если они не заданы явно. В зависимости от используемого способа управления папками и метаданными (пользовательский интерфейс или API-интерфейс) могут затрагиваться значения метаданных для родительских и вложенных папок.
Если не заданы значения по умолчанию для каких-либо родительских и вложенных папок, список содержит только один столбец (с именем "TheOnlyColumn" и пустой строкой в качестве значения по умолчанию), для изменения значений метаданных по умолчанию для родительских и вложенных папок, построенных на основе принципа наследования, потребуется последовательность из трех действий. Рассмотрим следующий пример структуры:
Папка DocLib является родительской.
Папки Alpha и Beta вложены в папку DocLib.
Папки AlphaOne и AlphaTwo вложены в папку Alpha.
Папка BetaOne вложена в папку Beta.
Первое действие. Переход в папку Beta и установка значения по умолчанию
Пользователь переходит в папку Beta и устанавливает для столбца TheOnlyColumn значение по умолчанию "Z".
Табл. 1. Результаты установки значений метаданных для папок — первое действие
Если добавить элемент в эту папку... |
Значение TheOnlyColumn по умолчанию — ... |
|---|---|
DocLib (корень) |
(Пусто) |
Alpha |
(Пусто) |
AlphaOne |
(Пусто) |
AlphaTwo |
(Пусто) |
Beta |
Z |
BetaOne |
Z |
Изменение затрагивает и папку, Beta и папку BetaOne. При изменении значения метаданных для папки Beta затрагивается вложенная в нее папка BetaOne, которая наследует значение метаданных от своей родительской папки.
Первое действие. Переход в папку Alpha и установка значения по умолчанию
На втором этапе пользователь переходит в папку Alpha и устанавливает значение по умолчанию "Y".
Табл. 2. Результаты установки значений метаданных для папок — второе действие
Если добавить элемент в эту папку... |
Значение TheOnlyColumn по умолчанию — ... |
DocLib (корень) |
(Пусто) |
Alpha |
Y |
AlphaOne |
Y |
AlphaTwo |
Y |
Beta |
Z |
BetaOne |
Z |
Изменение затрагивает папку Alpha и вложенные в нее папки. Папки Beta не затрагиваются.
Третье действие. Переход в папку AlphaOne и установка значения по умолчанию
В завершение, пользователь переходит в папку AlphaOne и устанавливает значение по умолчанию "X".
Табл. 3. Результаты установки значений метаданных для папок — третье действие
Если добавить элемент в эту папку... |
Значение TheOnlyColumn по умолчанию — ... |
|---|---|
DocLib (корень) |
(Пусто) |
Alpha |
Y |
AlphaOne |
X |
AlphaTwo |
Y |
Beta |
Z |
BetaOne |
Z |
Папка AlphaTwo по-прежнему имеет значение "Y". Изменение папки AlphaOne не затрагивает папку AlphaTwo, поскольку она не является вложенной в папку AlphaOne.
Поддержка программирования значений метаданных по умолчанию на основе расположений
Объектная модель для значений метаданных по умолчанию на основе расположений базируется преимущественно на типе MetadataDefaults. Она включает методы для применения значений метаданных по умолчанию на основе расположений; обеспечивает получение, установку и удаление метаданных по умолчанию в объектах String и SPFolder, а также получение значений по умолчанию для полей. Фрагменты кода, демонстрирующие эти функциональные возможности, представлены в управляемой справочной документации для MetadataDefaults.
См. также
Концепции
Модель программирования управления документами