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

SharePoint 2021-09-22 10:24:37

在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 //设置并执行转换job14 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);}}

标签： Word转换PDF服务

上一篇：SharePoint 图像呈现形式介绍下一篇：Sharepoint Farm Backup Error:Administration 2010 Service is not started

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

热门文章

最新文章

标签列表