Добавление шаблона документа, типа файла и приложения редактирования к определению сайта

  • Статья

Дата последнего изменения: 1 ноября 2010 г.

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

В этой статье
Добавление шаблона документа
Добавление определения сопоставления для типа файла
Добавление приложения редактирования

В этой задаче программирования рассмотрены операции по настройке системы Microsoft SharePoint Foundation таким образом, чтобы можно было создавать или изменять документы из приложений сторонних производителей.

Задача состоит из трех подзадач:

  • Создание файла шаблона документа, который фактически добавляет элемент DocumentTemplate в файл Onet.xml определения сайта.

  • Добавление элемента Mapping в файл DocIcon.xml для определения значка типа файлов и элемента управления, используемого для открытия файла.

  • Создание библиотеки DLL, предоставляющей функциональные возможности, схожие с элементом управления OpenDocuments — т. е. создание, открытие и редактирование документов типа файла.

Для выполнения настроек, описанных в этом разделе, необходимо иметь полномочия администратора на сервере, на котором работает система SharePoint Foundation.

Предупреждающая заметкаВнимание!

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

Добавление шаблона документа

Чтобы добавить документ приложения в качестве шаблона, который можно было бы использовать в библиотеках документов, можно либо определить элемент DocumentTemplate в компоненте типа контента (см. раздел Развертывание типов контента), либо определить элемент DocumentTemplate в файле Onet.xml настраиваемого определения сайта (см. раздел Создание настраиваемого определения и конфигурации сайта).

В следующем примере показано использование элемента DocumentTemplate в файле Onet.xml.

<DocumentTemplates>
   <DocumentTemplate DisplayName="Blank Document" Type="105" 
      Default="FALSE" Description="A blank document.">
      <DocumentTemplateFiles>
         <DocumentTemplateFile 
            Name="doctemp/Template_Folder/psdtmp1.psd" 
            TargetName="Forms/template.psd" Default="True"/>
      </DocumentTemplateFiles>
   </DocumentTemplate>
</DocumentTemplates>

Атрибут DisplayName элемента DocumentTemplate определяет текст, который отображается в раскрывающемся списке для выбора типа шаблона документа при создании новой библиотеки документов. Атрибут Type однозначно определяет тип документа и может быть любым целым числом, которое еще не используется для другого шаблона документа. Атрибут Default определяет, выбирается ли шаблон по умолчанию в раскрывающемся списке. Атрибут Name элемента DocumentTemplateFile определяет физический путь к файлу шаблона на сервере, а атрибут TargetName — адрес шаблона относительно библиотеки документов.

Перезапустите службы IIS, чтобы изменения вступили в силу.

Добавление определения сопоставления для типа файла

Чтобы сопоставить расширение файла с типом документов и определить элемент управления, который необходимо использовать при открытии документа, имеющего данное расширение файла, добавьте элемент Mapping в файл DocIcon.xml. Файл DocIcon.xml хранится в каталоге %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\XML.

Добавление следующей строки в элемент ByExtension в файле DocIcon.xml сопоставляет расширение PSD с файлом изображения с именем icpsd.gif, после чего в библиотеке документов для файлов этого типа отображается соответствующий значок:

<Mapping Key="psd" Value="icpsd.gif"/>

Чтобы разрешить редактирование в приложении, элемент Mapping должен также включать в себя атрибуты EditText и OpenControl следующим образом:

<Mapping Key="psd" Value="icpsd.gif" EditText="Application" OpenControl="ProgID"/>

Атрибут EditText определяет имя приложения, которое отображается в раскрывающемся меню, когда пользователь щелкает стрелку Изменить документа. Атрибут OpenControl определяет программный идентификатор элемента управления, используемого для открытия файлов определенного типа.

Файл изображения, определенный атрибутом Value, должен храниться в каталоге %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\IMAGES. Если указанного файла изображения в данном каталоге нет, рядом с документом появляется значок "изображение отсутствует".

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

Настройка наследуемых разрешений для файла изображения

  1. Щелкните правой кнопкой мыши файл изображения в папке IMAGES, а затем выберите Свойства.

  2. На вкладке Безопасность в диалоговом окне Свойства выберите пункт Дополнительно.

  3. На вкладке Разрешения в диалоговом окне Дополнительные параметры безопасности убедитесь, что флажок Разрешить наследование разрешений от родительского объекта к этому объекту и его дочерним объектам, добавляя их к разрешениям, явно заданным в этом окне установлен.

ПримечаниеПримечание

По умолчанию размер значков в SharePoint Foundation составляет 16 x 16 пикселей.

Перезапустите службы IIS, чтобы изменения вступили в силу.

Добавление приложения редактирования

Создайте библиотеку DLL, предоставляющую элемент управления для загрузки документа определенного типа, чей программный идентификатор определяет элемент управления, например SharePoint.OpenDocuments. Создаваемый элемент управления должен предусматривать такие же методы для создания, открытия и просмотра документов, что и элемент управления OpenDocuments.

См. также

Концепции

Общие сведения о файлах Onet.xml

Общие сведения о файлах DocIcon.xml