文档转换器定义架构

上次修改时间: 2010年3月8日

适用范围: SharePoint Server 2010

必须在功能中包含一个 XML 文件,该文件根据文档转换器定义架构来定义文档转换器。下面是该架构。

<?xml version="1.0" encoding="utf-8" ?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <DocumentConverter ID="GUID"
    Name="DisplayName"
    App="ExecutableLeafName"
    From="FileExtension"
    To="FileExtension"
    ConverterUIPage="ConverterUIPage.aspx"
    ConverterSpecificSettingsUI="ConverterConfig.aspx"
    ConverterSettingsForContentType="ConverterConfig.ascx"
  />
</Elements>

以下是文档转换器定义架构及其定义中的元素列表。

Element   包含功能元素声明的功能清单文件中的顶级元素。

DocumentConverter 单个文档转换器。DocumentConverter 元素具有以下属性:

  • **ID   **必需属性,类型为 String。表示此文档转换器的 GUID。

  • Name   必需属性,类型为 String。表示文档转换器的显示名称。Microsoft SharePoint Server 2010 在用户界面中显示此名称。

  • App   必需属性,类型为 String。表示文档转换器可执行文件的短名称。

  • From   必需属性,类型为 String。表示要传递给文档转换器的原始文件的文件扩展名。文件扩展名不得以句点开始。

  • To   必需属性,类型为 String。表示文档转换器生成的已转换副本的文件扩展名。文件扩展名不得以句点开始。

  • ConverterUIPage   可选属性,类型为 String。表示 .aspx 页的文件名,用于向用户显示以指定所选文档的转换选项。该字段是可选的。如果您未指定自定义页面,SharePoint Server 2010 将显示默认页面 DocTrans.aspx。

    对于文档到页面转换器,要显示默认的文档到页面转换器用户界面页,请将此元素设置为"CreatePage.aspx"。

    有关详细信息,请参阅自定义转换设置页

  • ConverterSpecificSettingsUI   可选属性,类型为 String。表示要在现有转换器配置页面上承载的 .ascx 控件的文件名。使用此控件可以将配置选项添加到现有页面。

    这是一项主要用来实现文档到页面转换器的功能。有关详细信息,请参阅其他转换器设置控件。有关文档到页面转换器的详细信息,请参阅使用文档转换器发布页面

  • ConverterSettingsForContentType   可选属性,类型为 String。表示 .aspx 页面的名称,显示此页面后,管理员能够根据网站内容类型为此转换器设置配置设置。

    这是一项主要用来实现文档到页面转换器的功能。要显示默认的文档到页面转换器配置设置页面,请将此元素设置为"ConverterSettings.aspx"。

    有关详细信息,请参阅自定义转换器配置设置页。有关文档到页面转换器的详细信息,请参阅使用文档转换器发布页面

文档转换器架构示例

下面是示例文档转换器架构,它适用于将 Microsoft Excel 2010 (.xls) 文件转换为 Microsoft PowerPoint 2010 (.ppt) 文件的文档转换器。

<?xml version="1.0" encoding="utf-8" ?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <DocumentConverter ID="{3f8ae556-93ec-46de-bcb3-0a89616a20b3}"
    Name="Excel to PowerPoint"
    App="XL2PPT.exe"
    From="xls"
    To="ppt"
    ConverterUIPage="XL2PPT.aspx"
    ConverterSpecificSettingsUI="XL2PPTConfig.aspx"
    ConverterSettingsForContentType="XL2PPTConfig.ascx"
  />
</Elements>

请参阅

概念

文档转换器概述

文档转换器

文档转换器部署

自定义转换器配置设置页

其他转换器设置控件

自定义转换设置页

使用文档转换器发布页面