SharePoint 2013 Word 转换PDF服务介绍及示例

wojkxlq

　　前言：在SharePoint使用过程中，经常会发现将文档进行格式转换的需求，之前，看到SharePoint 2013有将PPT转换PDF文档的服务，后来，才发现SharePoint 2010开始，就有将Word文档转换PDF的服务了，用起来还是不错的。
　　下面，我们就来看看这个服务，如何将一个Word文档库批量转换成PDF文件，或者，将单一Word文档转换为PDF文档。
一、             效果展示
新建测试Word文档，如下图：

新建文档库inputList作为word存放库，上传测试文档，如下图：

         新建文档库outputList，作为输出PDF库，里面没有文件，如下图：

执行文件转换程序，执行后outputList文档库，如下图：

发现outputList还是没有文件，因为该服务是TimerJob的计时器任务，所以需要定时执行，去管理中心，找到该计划任务，立即运行，如下图：
         再一次刷新outputList文档库，如下图：

下载一个PDF文件到本地，PDF阅读器打开，如下图：

二、             操作步骤
1、  新建项目，添加引用Microsoft.Office.Word.Server.dll，如下图：

位置如下：

C:\Windows\Microsoft.NET\assembly\GAC_MSIL\Microsoft.Office.Word.Server\v4.0_15.0.0.0__71e9bce111e9429c\Microsoft.Office.Word.Server.dll

2、  引用类库

using Microsoft.Office.Word.Server;

using Microsoft.Office.Word.Server.Conversions;

主要用于转换操作的是Microsoft.Office.Word.Server.Conversions，详细请参考附后的msdn文档。
3、  编写添加核心代码之文档库批量转换



1 //创建一个转换job
2 ConversionJob myJob = newConversionJob("Word Automation Services");
3
4 //设置转换job的UserToken、转换格式
5 myJob.UserToken = site.UserToken;
6 myJob.Settings.OutputFormat = SaveFormat.PDF;
7 myJob.Settings.OutputSaveBehavior = SaveBehavior.AppendIfPossible;
8
9 //获取转出、转入文档库
10 SPList inputLibrary = web.Lists["inputlist"];
11 SPList outputLibrary = web.Lists["outputlist"];
12
13 //设置并执行转换job
14 myJob.AddLibrary(inputLibrary, outputLibrary);
15 myJob.Start();
　　4、  编写核心代码之单一文件转换



1 //创建一个异步转换
2 SyncConverter sc = newSyncConverter("Word Automation Services");
3
4 //设置转换UserToken、转换类型等
5 sc.UserToken = site.UserToken;
6 sc.Settings.UpdateFields = true;
7 sc.Settings.OutputFormat = SaveFormat.PDF;
8
9 //读取需要转换的文件
10 SPFolder docs = web.Folders[siteURL +
11     "/Word_Transfer"];
12 SPFile file = docs.Files[siteURL +
13     "/Word_Transfer/SharePoint2013Word转换PDF服务测试文档.docx"];
14
15 //生成保存转换后文档的文件流
16 Stream fStream = file.OpenBinaryStream();
17 SPFileStream stream = newSPFileStream(web, 0x1000);
18
19 //启动异步转换
20 ConversionItemInfo info = sc.Convert(fStream, stream);
21
22 //转换后文档添加到文档库
23 SPFile newFile = docs.Files.Add(
24     "SharePoint2013Word转换PDF服务测试文档.pdf",
25     stream,
26     true);
　　5、  单一文件转换效果图，如下图：

三、             Word Automation Services介绍
1、  简单介绍
　　Word Automation Services 是一项新的 SharePoint Server 2010 技术，它允许以无人参与的方式从服务器端转换 Microsoft Word 支持的文档。简言之，Word Automation Services 采用 Word 客户端应用程序的“另存为…”功能并为服务器复制该功能。
　　通过 Word Automation Services，以前需要您运行 Word 客户端应用程序的任务现在可以无人参与模式自动运行，并且比以前的解决方案更可靠、伸缩性更强。
　　以上是msdn上，关于Word Automation Services的说明，msdn很清楚的说到，这个服务的本质是采用Word客户端另存为的功能，所以，打开和另存的格式，和word2013客户端基本一致。

2、  Word Automation Services体系结构

　　如上图，可以看到Word Automation Services服务的原理，通过对象模型将操作进入队列管理器，排队等候计时器作业（TimerJob）定时执行，然后调用Word文件转换服务引擎，将转换后的文件存入SharePoint内容数据库。
　　特别的是，这个服务并不需要在服务器端，安装Office Word各种版本，即可完成操作，并且支持SharePoint2010和SharePoint2013版本。
3、  Word Automation Services三个基本概念
　　Word Automation Services 包含三个基本概念，即转换、转换作业和文档队列。转换是一个过程，在此过程中，Word Automation Services 会接收一个具有给定格式的文件，然后以不同的格式将该文件输出。例如，服务可以将 Word 2010 文档 (.docx) 转换为 PDF 文档。
所有转换都通过以下步骤进行：
Ø  创建一个转换作业。
Ø  提供该作业的设置（例如，所需的输出文件格式）。
Ø  向该作业添加一个或多个文件。
Ø  将该作业提交到文档队列。
　　所有转换操作都基于转换作业 的创建或使用。转换作业将描述要转换的文件和要对这些文件执行的操作。每个文件都将构成一个转换项，并且每个转换项都将映射到一个转换作业。一个转换作业可包含多个转换项。
文档队列 是一个“先进先出”队列，Word Automation Services 使用它根据为转换作业设置的计划来启动转换。
4、  支持打开的文档格式
Ø  打开 XML 文件格式文档（.docx, .docm, .dotx, .dotm）。
Ø  Word 97-2003 文档（.doc, .dot）。
Ø  RTF 格式文件 (.rtf)。
Ø  单个文件网页（.mht, .mhtml）。
Ø  Word 2003 XML 文档 (.xml)。
Ø  Word XML 文档 (.xml)。
5、  保存 Word 可以保存的文档类型，除去支持以上支持打开的类型，还包括一下两种：
Ø  可移植文档格式 (PDF) 文件。
Ø  XML 纸张规范 (XPS) 文件。
四、             完整代码
1、文档库批量转换代码





using (SPSite site = new SPSite(siteURL))
{
using (SPWeb web = site.OpenWeb())
{
ConversionJob myJob = new ConversionJob("Word Automation Services");
myJob.UserToken = site.UserToken;
myJob.Settings.OutputFormat = SaveFormat.PDF;
myJob.Settings.OutputSaveBehavior = SaveBehavior.AppendIfPossible;
SPList inputLibrary = web.Lists["inputlist"];
SPList outputLibrary = web.Lists["outputlist"];
myJob.AddLibrary(inputLibrary, outputLibrary);
myJob.Start();
}
}
View Code 　　2、文档单独转换代码





using (SPSite site = new SPSite(siteURL))
{
using (SPWeb web = site.OpenWeb())
{
SyncConverter sc = new SyncConverter("Word Automation Services");
sc.UserToken = site.UserToken;
sc.Settings.UpdateFields = true;
sc.Settings.OutputFormat = SaveFormat.PDF;
SPFolder docs = web.Folders[siteURL +
"/Word_Transfer"];
SPFile file = docs.Files[siteURL +
"/Word_Transfer/SharePoint2013Word转换PDF服务测试文档.docx"];
Stream fStream = file.OpenBinaryStream();
SPFileStream stream = new SPFileStream(web, 0x1000);
ConversionItemInfo info = sc.Convert(fStream, stream);
SPFile newFile = docs.Files.Add(
"SharePoint2013Word转换PDF服务测试文档.pdf",
stream,
true);
}
}
View Code 　　参考文献
Word Automation Services
http://msdn.microsoft.com/zh-cn/library/ee558278(v=office.14).aspx