简介
许多大型和小型企业都将其 Microsoft SharePoint Server 库用作 Microsoft PowerPoint 演示文稿的存储库。所有这些企业在存储、分发和更新演示文稿方面都有其特定的需求。Microsoft PowerPoint Automation Services 是 Microsoft SharePoint Server 2013 的一种新功能，可帮助企业管理其演示文稿。它是一项共享服务，可提供无人参与的、服务器端至其他格式的演示文稿转换。其最初便是针对在服务器上运行而设计的，并能够以可靠且可预测的方式处理许多演示文稿文件。
通过使用 PowerPoint Automation Services，可以从 PowerPoint 二进制文件格式 (.ppt) 和 PowerPoint Open XML 文件格式 (.pptx) 转换为其他格式。例如，您可能需要将一批 PowerPoint 97–2003 文件升级到 Open XML 演示文稿文件。您还可以在"编辑"菜单中创建自定义操作，以允许用户按需创建 PDF 版本的演示文稿。
 注释 |
|---|
| PowerPoint Automation Services 利用 SharePoint 2013 的工具，且作为其功能而存在。您必须安装 SharePoint Server 2013 才能使用 PowerPoint Automation Services。如果您要在服务器场中使用 SharePoint Server 2013，则必须明确启用 PowerPoint Automation Services。 |
下列方案描述了可通过 PowerPoint Automation Services 在服务器上自动处理演示文稿的两种方式：
-
大型企业将其所有年收益演示文稿存储在企业 Intranet 网站上的单个文档库中。该库包含多年累积的大量演示文稿。IT 部门需要将 PowerPoint 97–2003 二进制文件格式 (.ppt) 的所有演示文稿文件转换为 Open XML 演示文稿文件格式 (.pptx)。执行此转换的开发人员决定执行以下操作：将解决方案部署到将循环访问库中的所有文件的服务器，检查以确定该文件的格式是否为 .ppt 并将每个 .ppt 文件转换为 .pptx 文件格式。
-
地区销售部门向其所有客户提供了自定义服务估计值。每个销售人员将在现场会议或在线会议上与其客户审查其报价。在会议结束后，销售人员将向客户提供一份 PDF 格式的报价单副本。该部门聘请了一个供应商在"编辑"菜单中为存储在其 Extranet 中的文档库中的 PowerPoint 文件创建一个自定义动词。单击此动词时，服务器将运行一个程序，此程序会将 PowerPoint 文件转换为位于同一个库中的 PDF。
支持的源演示文稿格式
以下是适用于转换的受支持的源演示文稿格式：
-
Open XML 文件格式演示文稿格式 (.pptx)
-
PowerPoint 97–2003 演示文稿 (.ppt)
支持的目标文档格式
支持的目标文档格式包括所有支持的源文档格式，以及以下格式：
-
.pptx（Open XML 文件格式演示文稿格式）
-
.pdf
-
.xps（Open XML 纸张规范）
-
.jpg
-
.png（可移植网络图形格式）
PowerPoint Automation Services 的限制
PowerPoint Automation Services 不包括打印文档的功能。但是它能够直接将 PowerPoint 演示文稿文件（.ppt 和 .pptx）转换为 PDF 或 XPS，并将它们后台打印至打印机。
若要使用 PowerPoint Automation Services，您需要使用其编程接口将转换请求发送到 SharePoint Server 2013 服务器。对于每个转换请求，您指定要转换的文件和转换作业的输出格式。对于某些转换请求，还可以指定转换哪些类型的内容，包括注释、隐藏幻灯片或文档属性。
PowerPoint Automation Services 使用用于发送和接收转换请求的异步模式方法。因而，您可以编写在发送转换请求后继续执行的代码。如果您需要在完成转换请求后向用户发送通知，可以指定引用在操作完成时执行的回调方法的委托。
| 注释 |
|---|
| 有关如何使用异步设计模式的详细信息，请参阅异步编程概述。 |
以下各节包含了一组有限数量的类，这些类是发送和接收转换请求所必需的。所有这些类都包含在 Microsoft.Office.Server.PowerPoint.Conversion 命名空间中。
请求基类
Request 类是 Microsoft.Office.Server.PowerPoint.Conversion 命名空间中的最基本类。所有其他请求 类型（PresentationRequest、PictureRequest、PdfRequest 和 XpsRequest）都从该类继承。
| 成员名称 | 说明 |
|---|---|
| BeginConvert(Microsoft.SharePoint.SPServiceContext, System.AsyncCallback, System.Object) 方法 | 开始转换操作。第一个参数为 serviceContext，该参数指定要转换的文件所在的 SharePoint 网站的上下文。使用 callback 参数可指定引用在操作完成时执行的方法的委托。如果您需要将任何其他信息从调用代码传递到回调方法，请使用 state 参数。 返回一个 IAsyncResult 对象。 |
| EndConvert(IAsyncResult) 方法 | 结束转换操作。result 参数需要相应的 BeginConvert 转换请求返回的结果 IAsyncResult 对象。如果该请求在调用 EndConvert 时尚未完成，则将阻止调用线程，直到转换操作完成。 不返回值。 |
PresentationRequest 类
PresentationRequest 类（继承自 Request 类）将 PowerPoint 97–2003 文件 (.ppt) 或 Open XML 文件格式演示文稿 (.pptx) 转换为其他演示文稿文件格式。在上面提及的第一种方案中，您使用此类将文档库中的旧的演示文稿文件转换为 Open XML 文件格式演示文稿格式。
PresentationRequest 类的构造函数方法具有三个必需参数：
-
input - 采用需要转换为 Stream 对象的文件。
-
extension - 指定将转换的文件的文件扩展名的字符串。
-
output - 指定将存储输出的 SPFileStream 对象。
PresentationRequest 类具有针对其添加 settings 参数的构造函数方法的单个重载。settings 参数接受 PresentationSettings 对象作为参数。
PdfRequest 类
PdfRequest 类（也继承自 Request 类）将 PowerPoint 97–2003 文件 (.ppt) 或 Open XML 文件格式演示文稿 (.pptx) 转换为 .pdf 文件。在上面提及的第二种方案中，您使用此类将演示文稿转换为 PDF 文件。
PdfRequest 类的构造函数方法也具有三个必需参数（input、extension 和 output），这类似于 PresentationRequest 类。
PdfRequest 类也具有针对其添加 settings 参数的构造函数方法的单个重载。settings 参数接受 FixedFormatSettings 对象作为参数。
PictureRequest 类
PictureRequest 类（也继承自 Request 类）将 PowerPoint 97–2003 文件 (.ppt) 或 Open XML 文件格式演示文稿 (.pptx) 转换为一组 .jpg 或 .png 格式的图像文件。
此外，PictureRequest 类的构造函数方法具有四个必需参数。input、extension 和 output 参数与 PresentationRequest 类构造函数的参数类似。PictureRequest 类的构造函数方法也具有必需的 format 参数，该参数必需是 PictureFormat 枚举中的常数。
PictureRequest 类不具有针对其构造函数方法的任何重载。
说明如何编写使用 PowerPoint Automation Services 的代码的最简单方法是构建控制台应用程序。您必须在 SharePoint Server 上构建和运行控制台应用程序，而不是在客户端计算机上。启动转换请求的代码是类似的，无论转换请求代码是集成到 Web 部件、工作流还是事件处理程序中。通过从控制台应用程序使用 PowerPoint Automation Services，以下过程说明了如何在不增加 Web 部件、事件处理程序或工作流的复杂性的情况下使用 API。
| 注释 |
|---|
| 由于 PowerPoint Automation Services 是 SharePoint Server 2013 的服务，因此您仅能将其用于直接在 SharePoint Server 上运行的应用程序中。您必须将应用程序构建为服务器场解决方案。您无法从沙盒解决方案使用 PowerPoint Automation Services。 |
构建应用程序
-
启动 Microsoft Visual Studio 2012。
-
在"文件"菜单上，指向"新建"，然后选择"项目"。
-
在"新建项目"对话框中的"已安装"下方，依次展开"模板"和"Visual C#"，然后选择"Windows"。
-
在项目模板列表中，单击"控制台应用程序"。
-
请确保，Visual Studio 中的项目面向 .NET Framework 4。
注释 早期版本的 SharePoint Server 需要您面向 .NET Framework 3.5。Microsoft.SharePoint 库现在引用 .NET Framework 4 中的程序集。此外，请确保您的项目面向整个 .NET Framework 4 而非 .NET Framework 4 Client Profile。
-
在"名称"框中，键入您要用于项目的名称，例如 PAS_Sample。
-
在"位置"框中，键入您要放置项目的位置。
-
单击"确定"以创建解决方案。
-
默认情况下，Visual Studio 2012 创建面向 x86 CPU 的项目，但是若要构建 SharePoint Server 应用程序，您必须面向所有 CPU。
如果您要构建 Microsoft Visual C# 应用程序，请在"解决方案资源管理器"中，右键单击项目，然后单击"属性"。
-
在项目"属性"窗口中，单击"构建"。
-
指向"配置"列表，并选择"所有配置"。
-
指向"平台目标"列表，并选择"任何 CPU"。
如果您要构建 Microsoft Visual Basic .NET Framework 应用程序，请在"属性"窗口中，单击"编译"。
-
单击"高级编译选项"。
-
指向"配置"列表，并选择"所有配置"。
-
指向"平台目标"列表，然后选择"任何 CPU"。
-
-
在"项目"菜单上，单击"添加引用"以打开"添加引用"对话框。
-
展开"程序集"，然后执行下列操作：
-
展开"框架"，然后添加对 System.Web 的引用。
-
展开"扩展名"，然后添加对 Microsoft.SharePoint 的引用。
-
-
此外，在"添加引用"对话框中，选择"浏览"，导航到 Microsoft.Office.Server.PowerPoint.dll 的位置（默认位置为 C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.Office.Server.PowerPoint\v4.0_15.0.0.0__71e9bce111e9429c），选择程序集，然后选择"添加"。
下面的 C# 和 Visual Basic 示例说明了一个简单 PowerPoint Automation Services 应用程序，该应用程序将 SharePoint 网站的共享文档文件夹中的 PowerPoint 97–2003 文件 (.ppt) 转换为同一文件夹中的 PowerPoint Open XML 文件 (.pptx)。
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text;
using System.Web; using Microsoft.SharePoint; using Microsoft.Office.Server.PowerPoint.Conversion; namespace PAS_Sample { class Program { static void Main(string[] args) { try { string siteURL = "http://localhost"; using (SPSite site = new SPSite(siteURL)) { using (SPWeb web = site.OpenWeb()) { Console.WriteLine("Begin conversion"); // Get a reference to the "Shared Documents" library // and the presentation file to be converted. SPFolder docs = web.Folders[siteURL + "/Shared Documents"]; SPFile file = docs.Files[siteURL + "/Shared Documents/Pres1.ppt"]; // Convert the file to a stream and create an // SPFileStream object for the conversion output. Stream fStream = file.OpenBinaryStream(); SPFileStream stream = new SPFileStream(web, 0x1000); // Create the presentation conversion request. PresentationRequest request = new PresentationRequest( fStream, ".ppt", stream); // Send the request synchronously, passing // in a ‘null’ value for the callback parameter, // and capturing the response in the result object. IAsyncResult result = request.BeginConvert( SPServiceContext.GetContext(site), null, null); // Use the EndConvert method to get the result. request.EndConvert(result); // Add the converted file to the document library. SPFile newFile = docs.Files.Add( "newPres1.pptx", stream, true); Console.WriteLine("Output: {0}", newFile.Url); } } } catch (Exception ex) { Console.WriteLine("Error: " + ex.Message); } finally { Console.WriteLine("Complete"); Console.ReadKey(); } } } }
构建和运行示例
-
将 PowerPoint 文档（名为 Pres1.ppt ）添加到 SharePoint 网站中的共享文档文件夹。
-
构建和运行示例。
-
等待一分钟以便转换进程开始运行，然后导航至 SharePoint 网站中的共享文档文件夹，并刷新页面。文档库中目前包含一个新的 PowerPoint 文档 Pres1.pptx。
SharePoint Server 2013 上的 PowerPoint Automation Services 为企业提供了用于管理其演示文稿文件的高级功能。此高性能解决方案允许可伸缩的、服务器端演示文稿操作和生成（批量或按需）。
| 注释 |
|---|
| 必须先确保已在 SharePoint 管理中心控制台中启用 PowerPoint Automation Services，然后才能运行此示例。 若要验证是否已启用 PowerPoint Automation Services，请执行以下操作：
|
扫一扫
3253
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
