文档转换器定义架构
上次修改时间: 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>