如何:向网站定义中添加文档模板、文件类型和编辑应用程序

上次修改时间: 2010年11月1日

适用范围: SharePoint Foundation 2010

本文内容
添加文档模板
添加文件类型的映射定义
添加编辑应用程序

此编程任务提供用于自定义 Microsoft SharePoint Foundation 的步骤,以便使用第三方应用程序创建或编辑文档。

此任务包含以下子任务:

  • 创建文档模板文件,也就是将 DocumentTemplate 元素添加到网站定义的 Onet.xml 文件中。

  • Mapping 元素添加到 DocIcon.xml 中,以指定文件类型图标和确定用户用于打开文件的控件。

  • 创建一个 DLL 以提供与 OpenDocuments 控件中所述功能类似的功能,即,创建、打开和编辑该文件类型的文档的能力。

若要执行此主题中所述的自定义操作,您必须是运行 SharePoint Foundation 的服务器上的管理员。

警告注释警告

在为 SharePoint Foundation 安装更新或 Service Pack 时,或者将安装升级到下一产品版本时,您对原始安装文件所做的更改可能会被覆盖。

添加文档模板

若要将应用程序文档作为可用于文档库的模板添加,您可以指定内容类型功能(请参阅部署内容类型)中的 DocumentTemplate 元素,或指定自定义网站定义(请参阅如何:创建自定义网站定义和配置)的 Onet.xml 文件中的 DocumentTemplate 元素。

下面的示例演示如何使用 Onet.xml 文件中的 DocumentTemplate 元素。

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

DocumentTemplate 元素的 DisplayName 属性指定显示在下拉列表中、用于在创建新文档库时选择文档模板类型的文本。Type 属性唯一标识文档类型,并且可以是尚未用于其他文档模板的任何整数。Default 属性指定默认情况下是否在下拉列表中选择该模板。DocumentTemplateFile 的 Name 属性指定模板文件在服务器计算机上的物理路径,而 TargetName 属性指定模板相对于文档库的地址。

重置 Internet Information Services (IIS) 以使更改生效。

添加文件类型的映射定义

若要将文件扩展名映射到某一文档类型以及确定打开具有该文件扩展名的某个文档时使用的控件,请将 Mapping 元素添加到 DocIcon.xml 中。DocIcon.xml 位于 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\XML 目录中。

将下面的行添加到 DocIcon.xml 的 ByExtension 元素中时,会将 .psd 扩展名映射到名为 icpsd.gif 的图像文件,该图像文件可提供文档库中显示的此类型文件的图标:

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

为了能够在应用程序中进行编辑,Mapping 元素还必须包括 EditText 和 OpenControl 属性,如下所示:

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

EditText 属性指定在用户单击文档对应的 Edit 箭头时显示在下拉菜单中的应用程序名称。OpenControl 属性指定用于打开指定类型文件的控件的编程标识符 (ProgID)。

由 Value 属性指定的图像文件必须位于 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\IMAGES 目录中。如果此目录中缺少指定的图像文件,则文档旁边会显示"缺少图像"图标。

若要防止在启用匿名访问时提示用户输入用于查看图标的凭据,则必须对图像文件设置可继承的权限。

对图像文件设置可继承的权限

  1. 右键单击 IMAGES 文件夹中引用的图像文件,再单击"属性"。

  2. 在"属性"对话框的"安全"选项卡上,单击"高级"。

  3. 在"高级安全设置"对话框的"权限"选项卡上,确保选中"允许父项的继承权限传播到该对象和所有子对象。包括那些在此明确定义的项目。"复选框。

备注

SharePoint Foundation 中图标的默认大小为 16 x 16 像素。

重置 IIS 以使更改生效。

添加编辑应用程序

创建一个 DLL,该 DLL 可提供要为指定类型的文档加载的控件,该文档的 ProgID 可标识该控件,例如 SharePoint.OpenDocuments。您所创建的控件必须提供如 OpenDocuments 控件中所述的用于创建、打开和查看文档的方法。

请参阅

概念

了解 Onet.xml 文件

了解 DocIcon.xml 文件