Устранение неполадок Word Automation Services

 

Применимо к: SharePoint Server 2010

Последнее изменение раздела: 2016-11-30

В данной статье показано, как компонент Word Automation Services обрабатывает ошибки, которые могут возникнуть на уровне элемента преобразования или системы, и приведены инструкции по их устранению.

Содержание:

  • Реакция Word Automation Services на потенциальные системные сбои

  • Устранение неполадок при ошибках преобразования

  • Устранение неполадок, связанных с конкретными событиями

  • Известные ошибки, не связанные с событиями Word Automation Services для SharePoint Server 2010

Реакция Word Automation Services на потенциальные системные сбои

Системные администраторы могут узнать о потенциальных сбоях системы несколькими способами, некоторые из которых приведены ниже.

  • При сбое преобразования файлов пользователи сообщают системному администратору о возникших ошибках или событиях. Например, во время преобразования может появиться сообщение с предложением обратиться к системному администратору.

  • На сервере, где возникла ошибка, фиксируются события Windows, в качестве источника которых указан компонент Word Automation Services.

  • System Center Operations Manager (SCOM) (если доступен) сообщает о неисправности Word Automation Services.

При сбое задания преобразования решение обычно предоставляет строку, отображаемую в сообщении ConversionItemInfo.ErrorMessage для каждого неудачного преобразования и предлагает пользователю выполнить с файлом необходимые действия. В некоторых случаях сведений, приведенных в сообщении ConversionItemInfo.ErrorMessage, недостаточно для диагностики и устранения возможного системного сбоя. Дополнительные сведения об информации, содержащейся в сообщении ConversionItemInfo.ErrorMessage для задания преобразования, см. в статье, посвященной элементам ConversionItemInfo (Возможно, на английском языке) (https://go.microsoft.com/fwlink/?linkid=196477&clcid=0x419) (Возможно, на английском языке).

В случае известного системного сбоя компонент Word Automation Services также создает на сервере, где была обнаружена ошибка, событие Windows. События позволяют администраторам диагностировать и устранять отдельные системные сбои. Каждое событие может включать дополнительные сведения, требующие дополнительного изучения со стороны администратора. Конечные пользователи этих событий не видят.

Событие записывается на том сервере, где оно возникло. Для просмотра событий необходимо запустить на сервере средство просмотра событий. Найдите все события, в качестве источника которых указано "Word Automation Services". Чтобы свести в единое представление события всей фермы, воспользуйтесь консолью SCOM. Консоль SCOM предоставляет сведения об исправности компонента Word Automation Services и серверов, на которых он запущен.

Постоянные перебои в работе Word Automation Services также могут указывать на системный сбой. Дополнительные сведения об устранении неполадок см. в разделе Устранение неполадок при ошибках преобразования.

Устранение неполадок при ошибках преобразования

В данном разделе приведены инструкции по устранению неполадок при преобразовании.

  1. Убедитесь, что преобразуемый файл удовлетворяет указанным ниже условиям.

    • Файл не заблокирован по типу файла

    • Файл не защищен паролем

    • Для открытия файла не требуется управление правами на доступ к данным

    • Тип файла поддерживается используемой версией Word Automation Services для SharePoint Server 2010

  2. Код ошибки ConversionJobItem.ErrorCode 131182 указывает на то, что файл, возможно, поврежден. При возврате кода ошибки, отличного от 131182, убедитесь, что файл не поврежден, сравнив код ошибки ErrorCode с соответствующей строкой ConversionItemInfo.ErrorMessage компонента Word Automation Services. После этого выполните инструкции по устранению неполадок с элементом преобразования. Кроме того, администратор может попытаться открыть и сохранить файл в клиентской версии 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 для серверов, на которых произошли ошибки. Помните, что файлы трассировки, как правило, имеют очень большой размер (в производственной среде — до нескольких гигабайт), поэтому для их загрузки, открытия и просмотра может потребоваться продолжительное время. Отфильтруйте журнал трассировки по области Word Automation Services.

    Качество и удобочитаемость записей журнала трассировки, также известных как просто трассировки, неоднородны. Трассировки не локализованы и могут быть не предназначены для внешнего использования. Журналы трассировки могут содержать ограниченный объем персональных данных об элементах преобразования файлов и заданиях преобразования.

    Как правило, журналы трассировки ULS хранятся на каждом сервере в следующей папке: %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\14\LOGS

  6. Если с помощью приведенных выше инструкций проблему устранить не удалось, посетите сайт технической поддержки Майкрософт (https://go.microsoft.com/fwlink/?linkid=15029&clcid=0x419) и обратитесь к представителю службы поддержки.

Устранение неполадок, связанных с конкретными событиями

В данном разделе перечислены события, записываемые в журнал при определенных условиях сбоя, описаны причины этих событий и приведены инструкции по устранению неполадок для каждой ошибки.

Примечание

События, код которых начинается с 80, очень часто создаются при сбоях системы. Эти события создаются для каждой попытки преобразования, во время которой происходит соответствующая ошибка. По умолчанию Microsoft SharePoint Server 2010 запрещает создавать более пяти событий с одинаковым кодом на одном и том же сервере каждые две минуты. Такая настройка по умолчанию позволяет сократить количество событий, записываемых в журнал при наличии постоянной ошибки. При просмотре в журнале событий Windows тех событий, код которых начинается с 80, можно обнаружить пять событий с одинаковым кодом, вскоре после которых следует событие SharePoint Server с кодом 2159. В сообщении события 2159 будет указано, какое событие было подавлено и сколько раз.

Примечание

В пакет управления SharePoint Server 2010 для Microsoft System Center Operations Manager 2007 входит средство SCOM Monitor, предназначенное для обнаружения каждого события Windows и предоставления администраторам сведений о исправности Word Automation Services. Дополнительные сведения о средстве SCOM Monitor см. в статье, в которой описывается пакет управления для продуктов Microsoft SharePoint 2010 (бета-версия) (https://go.microsoft.com/fwlink/?linkid=196473&clcid=0x419).

События 8004 и 8005: "Ошибка конвертера PDF/XPS "[путь к файлу и имя файла]" при преобразовании файла"

В состав Word Automation Services входит конвертер по умолчанию, предназначенный для преобразования файлов в форматы XPS и PDF. Word Automation Services также поддерживается конвертерами сторонних производителей. В конвертерах сторонних производителей могут быть ошибки, приводящие при преобразовании файлов к непредсказуемым сбоям. При сбое конвертера стороннего производителя Word Automation Services выдает одно из двух указанных ниже событий.

Идентификатор события Строка сообщения о событии Идентификатор связанного сообщения Дополнительные сведения

8004

При преобразовании файла "[путь к файлу и имя файла]" произошел сбой конвертера PDF. Обратитесь к поставщику данного компонента, чтобы узнать, доступна ли обновленная версия. Если проблему устранить не удастся, удалите конвертер PDF стороннего производителя, чтобы предотвратить повторение этой ошибки.

131183

Имя журнала: приложение

Источник: Word Automation Services

Уровень события: ошибка

8005

При преобразовании файла "[путь к файлу и имя файла]" произошел сбой конвертера XPS. Обратитесь к поставщику данного компонента, чтобы узнать, доступна ли обновленная версия. Если проблему устранить не удастся, удалите конвертер XPS стороннего производителя, чтобы предотвратить повторение этой ошибки.

131184

Имя журнала: приложение

Источник: Word Automation Services

Уровень события: ошибка

Компонент Word Automation Services также формирует сообщение об ошибке элемента преобразования указанным ниже образом.

Код сообщения Строка ConversionItemInfo.ErrorMessage Код связанного события

131183

Произошел сбой конвертера PDF стороннего производителя. Обратитесь к системному администратору.

8004

131184

Произошел сбой конвертера XPS стороннего производителя. Обратитесь к системному администратору.

8005

Решение

  1. При возникновении этих ошибок обновите конвертеры, выполнив указанные ниже действия.

    1. Получите у поставщика последнюю версию DLL-библиотеки конвертера PDF или XPS.

    2. Замените в папке %COMMONPROGRAMFILES%\Microsoft Office Servers\14.0\WebServices\WordServer\Core для каждого приложения в ферме старую DLL-библиотеку на новую.

    3. Если DLL-библиотека работает правильно, последующие преобразования должны выполняться успешно.

  2. Если после установки всех обновлений конвертеры все равно не работают, удалите их и воспользуйтесь конвертерами по умолчанию.

    • Удалите из папки %COMMONPROGRAMFILES%\Microsoft Office Servers\14.0\WebServices\WordServer\Core соответствующую DLL-библиотеку конвертера PDF или XPS.

    • Последующие преобразования должны выполняться успешно.

  3. Если преобразовать файл не удается, скорее всего, он поврежден или недопустим по какой-либо другой причине. В этом случае попробуйте открыть файл в клиентской версии Word, сохраните его и повторно отправьте на преобразование.

Событие 8010: "Обнаружен файл, созданный с помощью новой версии клиента Office или служб Word"

Событие 8010 возникает, если компонент Word Automation Services обнаруживает файл, сохраненный в более новой версии Microsoft Word, чем текущая версия Word Automation Services. Это может привести к снижению качества преобразования в зависимости от содержимого документа. При возникновении этого события немедленно обновите компонент Word Automation Services, перейдя по ссылке, указанной в сообщении события.

Примечание

Это событие необязательно указывает на сбой преобразования, поэтому с данным событием не связан конкретный код сообщения об ошибки.

Идентификатор события Строка сообщения о событии Идентификатор связанного сообщения Дополнительные сведения

8010

Обнаружен файл, созданный в новой версии клиентского приложения Office или служб Word Services. Перейдите по ссылке https://go.microsoft.com/fwlink/?linkid=157217&clcid=0x419

Неприменимо

Имя журнала: приложение

Источник: Word Automation Services

Уровень события: ошибка

Решение

  1. Загрузите(https://go.microsoft.com/fwlink/?linkid=157217&clcid=0x419) последнюю версию конвертера Word Automation Services из пакета SDK для Microsoft SharePoint 2010.

  2. Следуйте инструкциям по установке нового конвертера.

  3. Преобразуйте файлы. Файлы будут преобразованы с максимальным качеством, а это событие перестанет возникать, пока не будут обнаружены файлы, требующие обновления конвертера Word Automation Services.

Событие 8012: "Не удалось загрузить один или несколько компонентов для указанного языка"

При сбое элемента преобразования создается код ошибки ConversionItemInfo.ErrorCode и соответствующее сообщение об ошибке ConversionItemInfo.ErrorMessage. Сообщение об ошибке предназначено для пользователя, запустившего задание преобразования, и переведено на язык браузера этого пользователя. Однако если на серверах приложений фермы серверов не установлен языковой пакет, соответствующий языку браузера пользователя, сообщения об ошибках не будут переведены на этот язык. Это событие возникает при возникновении подобной ситуации для сбойного элемента преобразования. Также необходимо быть готовым к тому, что сообщение об ошибке будет выведено на языке фермы по умолчанию.

Идентификатор события Строка сообщения о событии Идентификатор связанного сообщения Дополнительные сведения

8012

Не удалось загрузить один или несколько компонентов для указанного языка. Убедитесь, что требуемый языковой пакет установлен и правильно настроен.

Неприменимо

Имя журнала: приложение

Источник: Word Automation Services

Уровень события: ошибка

Решение

Событие 1001: "Ошибка доступа в базу данных SQL. Код ошибки: %1. Сообщение об ошибке: %2. Ссылка на ошибку: %3"

Системные сбои для Word Automation Services обычно обнаруживаются при взаимодействии службы с очередью документов. При каждом преобразовании файла служба несколько раз обращается к очереди документов. В случае ошибки SQL Server создает исключение SQLException с большим объемом релевантной информации. Компонент Word Automation Services обнаруживает все исключения SQLException, созданные SQL Server при взаимодействии службы с очередью документов, и выдает указанное ниже событие.

Идентификатор события Строка сообщения о событии Идентификатор связанного сообщения Дополнительные сведения

1001

Ошибка доступа в базу данных SQL. Код ошибки: %1. Сообщение об ошибке: %2. Ссылка на ошибку: %3.

6, 7

Имя журнала: приложение

Источник: Word Automation Services

Уровень события: критический

Это сообщение события содержит подмножество свойств SQLException, позволяющих администраторам устранить неполадки, обнаруженные при взаимодействии Word Automation Services с очередью документов. Эти параметры перечислены ниже.

Имя Описание MSDN

ErrorCode

Возвращает HRESULT ошибки. (Унаследовано от ExternalException.)

HelpLink

Возвращает или задает ссылку на файл справки, связанный с данным исключением. (Унаследовано от Exception.)

Message

Перегружено.

Ниже приведен пример сообщения события, создаваемого Word Automation Services при удалении или переименовании базы данных очереди документов.

Ошибка доступа в базу данных SQL. Код ошибки: 0x80131904. Сообщение об ошибке: недопустимое имя объекта "dbo.ConversionItemQueue". Ссылка на ошибку: нет.

Код ошибки (SqlException.ErrorCode) представляет собой код SQL Server, не являющийся специфическим для Word Automation Services. По коду 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=0x419) (Возможно, на английском языке).

Событие 1002: "Возможно, задания преобразования не выполняются из-за того, что задание таймера "%1" для приложения-службы "%2" не является активным"

Задание таймера для Word Automation Services обрабатывает поставленные в очередь элементы задания и распределяет их между серверами приложений. Если задание таймера не запускается, поставленные в очередь элементы задания не будут запущены для преобразования. Событие 1002 возникает при отправке нового задания, если задание таймера неактивно. В частности, это событие возникает при выполнении одного или нескольких из приведенных ниже условий.

  1. Задание таймера не находится в оперативном режиме. Это может произойти из-за неправильного определения задания.

  2. Задание таймера отключено. Это может произойти, если администратор отключил задание таймера на странице "Изменение задания таймера" в центре администрирования.

  3. Для задания таймера было пропущено два запланированных запуска в соответствии с текущими параметрами в центре администрирования.

  4. Запланированные запуски задания таймера были пропущены из-за внешней проблемы, например из-за отключения службы OWSTimer. OWSTimer — это служба таймеров SharePoint.

Примечание

На обработку условия ошибки и создание этого события SharePoint Server может уйти приблизительно 90 минут.

Идентификатор события Строка сообщения о событии Идентификатор связанного сообщения Дополнительные сведения

1002

Возможно, задания преобразования не выполняются из-за того, что задание таймера "%1" для приложения-службы "%2" не является активным.

Неприменимо

Имя журнала: приложение

Источник: Word Automation Services

Уровень события: предупреждение

Это сообщение события содержит имя незапущенного задания таймера и имя приложения-службы, связанного с этим заданием. Ниже приведен пример сообщения для данного события.

"Возможно, задания преобразования не выполняются из-за того, что задание таймера "e39db2de-1b89-4f74-91da-5da998df0a9c" для приложения-службы "Приложение Word Automation Service" не является активным."

Решение

  • Включите задание таймера Word Automation Services.

    1. На домашней странице центра администрирования выберите пункт Мониторинг.

    2. На странице мониторинга щелкните в разделе Задания таймера пункт Определения заданий.

      Проверьте, является ли задание таймера Word Automation Services запланированным заданием.

    3. Если тип планирования для задания таймера Word Automation Services отключен, щелкните Задание таймера Word Automation Services.

    4. На странице "Изменение задания таймера" нажмите кнопку Включить.

      После запуска задания таймера должно начаться преобразование поставленных в очередь заданий.

Если задание таймера Word Automation Services не является запланированным заданием, это означает, что компонент Word Automation Services не установлен или установлен неправильно.

Известные ошибки, не связанные с событиями Word Automation Services для SharePoint Server 2010

Word Automation Services не создает уникальные события Windows при указанных ниже условиях.

  • Любые ошибки, в результате которых возникает исключение SPException (https://go.microsoft.com/fwlink/?linkid=196475&clcid=0x419), созданное SharePoint Server.

  • Любые ошибки, в результате которых возникает исключение UnauthorizedAccessException (https://go.microsoft.com/fwlink/?linkid=196476&clcid=0x419), созданное SQL Server или SharePoint Server.

    Пример: изменение разрешений пользователя на доступ к базе данных контента.

  • Ошибки, затрагивающие сервер целиком, а не только Word Automation Services. Подобные ошибки обнаруживаются и отображаются в Windows и SharePoint Server.

    Пример: недостаточно места на диске.