Word Automation Services 疑难解答

适用于： SharePoint Server 2010

上一次修改主题： 2016-11-30

本文介绍 Word Automation Services 如何处理在转换项目或系统级别时可能出现的错误，并提供用于处理这些错误的常用步骤。

本文内容：

• Word Automation Services 如何应对潜在系统故障

• 如何处理失败的转换

• 如何处理特定事件

• 不会为 SharePoint Server 2010 生成 Word Automation Services 事件的已知故障

Word Automation Services 如何应对潜在系统故障

系统会以多种方式向系统管理员发出有关可能出现的系统故障的通知；例如：

• 在未成功转换文件时，用户可将发现的故障或事件传送给系统管理员。例如，在转换期间，会显示一条消息以指示用户与系统管理员联系。

• 在检测到故障的服务器上会发生列出“Word Automation Services”源的 Windows 事件。

• 当 System Center Operations Manager (SCOM) 可用时，它会指示 Word Automation Services 不正常。

在转换作业失败时，解决方案通常会为每个失败的转换提供显示在 ConversionItemInfo.ErrorMessage 中的字符串并指示用户对文件执行任何所需操作。在某些情况下，ConversionItemInfo.ErrorMessage 包含的信息不足，因此，管理员将无法诊断和更正潜在系统故障。有关 ConversionItemInfo.ErrorMessage 为转换作业提供的详情的详细信息，请参阅 ConversionItemInfo 成员（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=196477&clcid=0x804)（该链接可能指向英文页面）。

对于已知系统故障，Word Automation Services 还会在检测到故障的服务器上生成 Windows 事件。管理员可以通过事件来诊断和处理各种系统故障。每个事件可能包含需要管理员进行额外调查的大量信息。最终用户看不到事件。

事件驻留在发出它的服务器上。可通过访问服务器的事件查看器来查看事件。可搜索事件源为“Word Automation Services”的事件。还可以使用 SCOM 控制台来将整个服务器场中发出的事件聚合到一个视图中。SCOM 可显示 Word Automation Services 的运行状况及运行它的服务器。

Word Automation Services 中的持续中断也可能指示系统故障。有关更多问题排查帮助，请参阅如何处理失败的转换。

如何处理失败的转换

本节介绍处理失败的转换的步骤。

1. 确保要转换的文件满足以下条件：

   • 没有按文件类型被阻止

   • 不受密码保护

   • 不需要打开 IRM

   • 是所用 SharePoint Server 2010 的 Word Automation Services 版本支持的类型

2. 如果 ConversionJobItem.ErrorCode 是 131182，则该文件很可能已损坏。如果 ErrorCode 不是 131182，应根据其相应的 Word Automation Services ConversionItemInfo.ErrorMessage 字符串来比较 ErrorCode，从而确认该文件没有损坏。然后按照说明处理转换项故障。另外，管理员还可以尝试在 Microsoft Word 的客户端版本中打开和保存该文件。此过程可以排除损坏情况或修复该文件（如果该文件已损坏）。然后再次提交该文件以进行转换。

3. 如果该文件有效但转换仍失败，请首先轮询各个服务器的事件日志以查找事件源为 Word Automation Services 的事件。可以使用事件查看器来查看 Windows 系统事件。或者，可以使用 SCOM 来查看服务器场中所有服务器的所有事件的聚合视图。异常多的 Word Automation Services 事件可能指示在多个文件转换期间检测到失败情形。按照每种类型事件的事件消息中指定的问题排查步骤执行所需操作，以解决相应问题。

   备注

   确保在管理中心的“诊断日志记录”页上，未设置“Word Automation Services”类别的“要报告给事件日志的关键程度最低的事件”设置，或者将其设置为“警告” 或更低的严重级别，例如“信息”或“详细”。否则，Word Automation Services 可能不会生成一些重要事件。

4. 如果不能通过事件消息和指定操作来解决问题，请参阅如何处理特定事件。

5. 如果事件消息的说明和“如何处理特定事件”一节不足以解决问题，或者没有发出任何事件，请查看受影响服务器的 ULS 跟踪日志以了解更多有关问题的信息。

   若要使用这些日志来排查问题，请在管理中心的“诊断日志记录”页上，设置“Word Automation Services”类别的“要报告给跟踪日志的关键程度最低的事件”设置。

   警告

   启用详细跟踪将影响所有应用程序服务器的性能。应确保在完成问题排查活动后将“要报告给跟踪日志的关键程度最低的事件”设置回“中”。

   启用详细跟踪后，测试负载下的 Word Automation Services 以显示检测到的故障。在故障出现后，在文本编辑器中打开出现故障的服务器的 ULS 跟踪日志。请注意，跟踪文件通常非常大（例如，在生产环境中为多个 GB），并且可能需要大量时间才能下载、打开和查看这些文件。按 Word Automation Services 跟踪区域筛选跟踪日志。

   跟踪日志项（又称为跟踪）的质量和可读性会有所不同。跟踪信息没有本地化，可能无法供外部使用。跟踪日志可能包含有关文件转换项或作业的数量有限的个人身份信息。

   通常可以在每台服务器上的以下位置找到 ULS 跟踪日志：%COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\14\LOGS

6. 如果执行上述步骤后仍不能解决问题，请访问 Microsoft 产品技术支持 (https://go.microsoft.com/fwlink/?linkid=15029&clcid=0x804) 网站并与支持代表联系以帮助诊断和解决问题。

如何处理特定事件

本节列出了为特定故障情形记录的事件，介绍了事件原因并针对每个错误提供了相应解决步骤。

事件 8004 和 8005：PDF/XPS 转换器“[文件路径和名称]”在文件转换期间失败

Word Automation Services 包括用于将文件转换为 XPS 和 PDF 文件格式的默认转换器。Word Automation Services 还支持第三方转换器。第三方转换器可能包含某些错误，这些错误会以不可预测的方式导致文件转换失败。Word Automation Services 在第三方转换器失败时会发出以下两个事件之一：

Word Automation Services 还设置转换项目的失败消息，如下所示：

解决方案

1. 如果出现此类故障，请按照下列步骤更新转换器：

   1. 从转换器供应商处获取自定义 PDF 或 XPS 转换器的最新 DLL。

   2. 在服务器场中每个应用程序上的 %COMMONPROGRAMFILES%\Microsoft Office Servers\14.0\WebServices\WordServer\Core 中使用新 DLL 覆盖旧 DLL。

   3. 如果 DLL 运行正常，新转换现在应成功。

2. 如果在应用所有可用更新后第三方转换器仍失败，请卸载第三方转换器并使用默认转换器。

   • 从以下文件夹中删除 PDF 或 XPS 转换器的对应 DLL：%COMMONPROGRAMFILES%\Microsoft Office Servers\14.0\WebServices\WordServer\Core。

   • 新转换现在应成功。

3. 如果文件仍没有转换，则该文件很可能已损坏或在其他方面无效。在这种情况下，请尝试在 Word 的客户端版本中打开并重新保存该文件，然后重新提交该文件以进行转换。

事件 8010：遇到使用新版本的 Office 客户端或 Word Services 创建的文件

当 Word Automation Service 遇到使用比当前安装的 Word Automation Service 版本新的 Microsoft Word 版本所保存的文件时，会发出事件 8010。这可能导致转换质量降低，具体取决于文档的内容。如果发出此事件，请通过单击事件消息中的链接来尽快升级 Word Automation Services。

解决方案

1. 从 Microsoft SharePoint 2010 软件开发工具包 (SDK) 下载(https://go.microsoft.com/fwlink/?linkid=157217&clcid=0x804) 最新的 Word Automation Services 转换器。

2. 按照说明安装新转换器。

3. 转换文件。将以可能最高的质量转换文件，并且不会生成此事件，除非遇到需要更新 Word Automation Services 转换器的文件。

事件 8012：无法加载一个或多个指定语言的本地化组件

在转换项目失败时，会生成 ConversionItemInfo.ErrorCode 及对应的 ConversionItemInfo.ErrorMessage。会向提交转换作业的用户显示该错误消息，该消息会本地化为提交转换作业的用户的浏览器语言。但是，如果服务器场应用程序服务器上没有与用户的浏览器语言对应的语言包，则错误消息无法显示为最终用户的浏览器语言。在失败的转换项出现这种情况时，会发出此事件。还应注意，错误消息本身将以服务器场的默认语言显示。

解决方案

• 下载并部署所需的 SharePoint Server 2010 语言包。可从 Microsoft 下载中心 (https://go.microsoft.com/fwlink/?linkid=141342&clcid=0x804) 下载相应语言包。

事件 1001：SQL 数据库访问错误。错误代码: %1。错误消息: %2。错误链接: %3

在 Word Automation Services 与文档队列通信时，通常会检测到该服务的系统故障。在每个文件转换过程中，在该服务与文档队列之间会出现多个通信。在出现故障时，SQL Server 会生成 SQLException 错误以及大量相关信息。Word Automation Services 在与文档队列通信时会检测到 SQL Server 生成的任何 SQLException 错误并发出此事件：

此事件消息包含 SQLException 属性的子集，以帮助管理员处理在 Word Automation Services 与文档队列通信时检测到的故障。这些参数如下所示：

下面是在删除或重命名文档队列数据库时 Word Automation Services 生成的事件消息的示例：

Sql 数据库访问错误。错误代码: 0x80131904。错误消息: 对象名称“dbo.ConversionItemQueue”无效。错误链接: 无。

错误代码 (SqlException.ErrorCode) 是不特定于 Word Automation Services 的 SQL Server 代码。可以使用 SQL Server 代码使此故障与现有 SQL Server 问题排查信息相关联。

错误消息 (SqlException.Message) 是特定于 SQL Server 的字符串，其中包含描述错误和指定受影响数据库的用户可读信息。管理员应按照 SQL Server 问题排查帮助中的建议，查看维护此字符串中引用的数据库的服务器。

错误链接 (SqlException.HelpLink) 是指向更多 SQL Server 帮助信息的特定于 SQL Server 的链接。

解决方案

1. 记下事件消息中的错误代码、错误消息和错误链接。

2. 使用这些信息来帮助处理 SQL Server 错误。有关如何处理 SQL Server 错误代码的信息，请参阅 SQL Server 解决方案中心（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=196474&clcid=0x804)（该链接可能指向英文页面）。

事件 1002：转换作业可能无法执行，因为服务应用程序“%2”的计时器作业“%1”似乎不是活动的

Word Automation Service 的计时器作业可处理排队作业项并将其分发到应用程序服务器。如果计时器作业没有运行，则排队的作业项不会开始转换。如果在计时器作业不活动时提交新作业，则会发出事件 1002。具体来说，如果满足以下一个或多个条件，则会发出此事件：

1. 计时器作业未联机。如果未正确设置作业定义，则会出现此情况。

2. 计时器作业已被禁用。如果管理员在管理中心的“编辑计时器作业”页上禁用了计时器作业，则会出现此情况。

3. 根据管理中心的当前设置，计时器作业错过了两次预定运行时间。

4. 由于外部问题（例如 OWSTimer 服务已关闭），计时器作业错过了预定运行时间。OWSTimer 是 SharePoint 定时服务。

此事件消息包含未运行的计时器作业的名称以及与该计时器作业相关的服务应用程序的名称。下面是此事件的消息示例：

“转换作业可能无法执行，因为服务应用程序‘Word Automation Service 应用程序’的计时器作业‘e39db2de-1b89-4f74-91da-5da998df0a9c’似乎不是活动的。”

解决方案

• 启用 Word Automation Services 计时器作业：

  1. 在管理中心主页上，单击“监控”。

  2. 在“监控”页的“计时器作业”下，单击“作业定义”。

     注意 Word Automation Services 计时器作业是否是预定的计时器作业。

  3. 如果 Word Automation Services 计时器作业的计划类型被禁用，请单击“Word Automation Services 计时器作业”。

  4. 在“编辑计时器作业”页上，单击“启用”。

     排队的作业应在计时器作业运行时开始转换。

如果 Word Automation Services 计时器作业不是预定的计时器作业，则表明没有安装 Word Automation Services 或没有正确安装它。

不会为 SharePoint Server 2010 生成 Word Automation Services 事件的已知故障

Word Automation Services 不会为以下这些已知故障情形生成特定 Windows 事件：

• 导致 SharePoint Server 生成 SPException（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=196475&clcid=0x804)（该链接可能指向英文页面） 的任何故障。

• 导致 SQL Server 或 SharePoint Server 生成 UnauthorizedAccessException（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=196476&clcid=0x804)（该链接可能指向英文页面）的任何故障。

  示例：用户访问内容数据库的权限已更改。

• 明显影响整个服务器而非仅影响 Word Automation Services 服务的故障。在 Windows 和 SharePoint Server 中检测到并出现此类故障。

  示例：磁盘空间不足。