Расширение форм

Статья
04/21/2015

Дата последнего изменения: 8 февраля 2010 г.

Применимо к: SharePoint Foundation 2010

В этой статье
Создание и регистрация элемента управления запуска
Повышение и понижение уровня свойства
Управление соединением
Объединение форм

В этом разделе дан обзор способов расширения типа контента "Form" в приложении Microsoft SharePoint Foundation.

Сторонние разработчики могут создать файл DLL, предоставляющий элемент управления запуска для открытия XML-файлов типа контента "Form" в редакторе XML, совместимом со службами SharePoint Foundation. Тип контента "Form" является расширением типа контента "Document" и разработан для XML-файлов.

Тип контента "Form" предоставляет следующие функциональные возможности для работы с XML-файлами:

Повышение и понижение уровня свойства С помощью этих свойств можно повысить уровень данных, сохраненных в XML-файле, в виде столбцов в библиотеке SharePoint Foundation и выполнить их обратную запись в документ.
Управление соединением Поддерживает соединения в XML-файлах, связанных с шаблоном формы.
Объединение форм Отправляет несколько XML-файлов в клиентское приложение для объединения.

Создание и регистрация элемента управления запуска

Сторонние разработчики могут создавать файлы DLL, предоставляющие элемент управления запуска для открытия документов XML в XML-редакторе. Элемент управления должен обеспечить такой же интерфейс для создания, изменения и объединения XML-файлов, а также для пользовательской настройки шаблонов, который описан для элемента управления Элемент управления OpenXMLDocuments. Элемент управления должен иметь программный идентификатор (ProgID), например SharePoint.OpenXMLDocuments, и должен быть установлен и зарегистрирован на клиентском компьютере.

Файл Общие сведения о файлах DocIcon.xml для развертывания служб SharePoint Foundation может быть изменен, чтобы программный идентификатор (например, Word.Document) и расширение имени файла отдельного типа документов соответствовали программному идентификатору элемента управления запуска и значку, представляющему документы в библиотеке форм.

Повышение и понижение уровня свойства

SharePoint Foundation обеспечивает как повышение, так и понижение уровня свойства документа для форм XML.

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

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

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

Дополнительные сведения см. в разделе Повышение и понижение уровня свойства XML-документа.

Управление соединением

Управление соединением позволяет синхронизировать формы, назначенные данному типу контента формы с шаблоном типа контента формы. Механизм управления соединением включает следующее:

Автоматическое управление соединением После синхронизации формы с шаблоном, если какой-либо сайт, дочерний сайт или библиотека были переименованы, соединение автоматически продолжает синхронизироваться с URL-адресом шаблона типа контента формы.

Примечание
Управление соединением не происходит сразу. При установленном флаге, и оно выполняется, когда файл запрошен для загрузки.

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

Оба механизма требуют, чтобы столбец "TemplateUrl" в типе контента "Form" указывал местоположение в XML-форме, в котором указан шаблон формы. Это позволяет службам SharePoint Foundation понизить правильное местоположение шаблона в документы XML, назначенные этому типу контента.

Если эти данные сохранены в инструкции обработки в XML-форме, используйте атрибуты PITarget и PIAttribute в определении столбца "TemplateUrl", чтобы указать его местоположение, как показано в следующем примере.

<FieldRef 
  ID="{4B1BF6C6-4F39-45ac-ACD5-16FE7A214E5E}" 
  Name="TemplateUrl" 
  PITarget="PI_Element" 
  PIAttribute="PI_Attribute"/>

Дополнительно можно указать главное местоположение в обработке инструкции, где приложение SharePoint Foundation должно выполнять поиск в первую очередь перед поиском в местоположении, указанном атрибутами PITarget и PIAttribute. Для этого добавьте другую пару атрибутов: PrimaryPITarget и PrimaryPIAttribute. Если эти атрибуты присутствуют, SharePoint Foundation ищет URL-адрес шаблона в местоположении, указанном в первую очередь. Если в этом местоположении имеется какое-либо значение, средство синтаксического разбора использует это значение и пропускает атрибуты PITarget и PIAttribute, как показано в следующем примере.

 
<FieldRef 
  ID="{4B1BF6C6-4F39-45ac-ACD5-16FE7A214E5E}" 
  Name="TemplateUrl" 
  PrimaryPITarget="primaryPI_Element" 
  PrimaryPIAttribute="primaryPI_Attribute" 
  PITarget="PI_Element" 
  PIAttribute="PI_Attribute"/>

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

<FieldRef 
  ID="{4B1BF6C6-4F39-45ac-ACD5-16FE7A214E5E}" 
  Name="TemplateUrl" 
  Node="XPath"/>

Дополнительные сведения о том, как SharePoint Foundation использует атрибуты для повышения и понижения уровня свойств документов, таких как URL-адрес шаблона, см. в разделе Использование типов контента для задания свойств документа XML.

Объединение форм

Объединение форм обеспечивает тип контента "Form" механизмом для объединения представлений форм, имеющих одинаковую схему.

Чтобы включить объединение для типа контента, этот тип контента должен содержать столбец сайта "Объединить" с внутренним именем "Combine." По умолчанию тип контента "Form" включает столбец сайта "Объединить" с соответствующим внутренним именем. Столбец "Объединить" позволяет пользователям выбирать формы, которые нужно объединить.

См. также

Концепции

Повышение и понижение уровня свойства XML-документа

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