Solução de problemas do Word Automation Services

Aplica-se a: SharePoint Server 2010

Tópico modificado em: 2016-11-30

Este artigo descreve como o Word Automation Services lida com erros que podem ocorrer no nível do item ou sistema de conversão e apresenta etapas simples de solução de problemas para resolver esses erros.

Neste artigo:

• Como o Word Automation Services reage a possíveis falhas no sistema

• Como solucionar problemas de falhas de conversão

• Como solucionar problemas de eventos específicos

• Falhas conhecidas que não têm eventos do Word Automation Services para o SharePoint Server 2010

Como o Word Automation Services reage a possíveis falhas no sistema

Os administradores do sistema são alertados sobre as possíveis falhas no sistema de várias maneiras. Por exemplo:

• Os usuários comunicam as falhas ou os eventos observados a um administrador do sistema quando os arquivos não são convertidos com êxito. Por exemplo, durante a conversão, uma mensagem direciona o usuário a entrar em contato com um administrador do sistema.

• Eventos do Windows que listam a origem do "Word Automation Services" ocorrem no servidor em que foi detectada a falha.

• Quando disponível, o System Center Operations Manager (SCOM) indica que o Word Automation Services está com problemas de integridade.

Quando há falha em um trabalho de conversão, a solução normalmente fornece uma cadeia de caracteres exibida na mensagem de erro ConversionItemInfo.ErrorMessage de cada conversão com falha e direciona o usuário na realização de qualquer ação necessária no arquivo. Em alguns casos, a mensagem ConversionItemInfo.ErrorMessage não tem informações suficientes para o administrador diagnosticar e corrigir a possível falha no sistema. Para obter mais informações sobre os detalhes que a mensagem ConversionItemInfo.ErrorMessage oferece referentes a um trabalho de conversão, consulte Membros de ConversionItemInfo (https://go.microsoft.com/fwlink/?linkid=196477&clcid=0x416).

No caso de uma falha conhecida no sistema, o Word Automation Services também gera um Evento do Windows no servidor em que a falha foi detectada. Os eventos ficam disponíveis para que os administradores possam diagnosticar e solucionar problemas de falhas no sistema individuais. Cada evento pode incluir tantas informações que o administrador precisará realizar mais investigação. Os usuários finais não veem os eventos.

Um evento reside no servidor que o emitiu. Os eventos podem ser exibidos acessando o Visualizador de Eventos do servidor. Procure por eventos que tenham o "Word Automation Services" como a fonte de eventos. Você também pode usar um Console SCOM para agregar os eventos emitidos de todo o farm em um único modo de exibição. O SCOM mostra o status da integridade do Word Automation Services e o servidor em que ele está sendo executado.

Interrupções frequentes no Word Automation Services também podem indicar falha no sistema. Consulte Como solucionar problemas de falhas de conversão para obter mais ajuda sobre como solucionar o problema.

Como solucionar problemas de falhas de conversão

Esta seção descreve as etapas para solucionar os problemas de falha de conversão.

1. Verifique se o arquivo que está sendo convertido atende aos seguintes critérios:

   • Não está bloqueado pelo tipo de arquivo

   • Não está protegido por senha

   • Não exige que o IRM seja aberto

   • É do tipo que tem suporte na versão do Word Automation Services para o SharePoint Server 2010 que está usando

2. Se o código de erro ConversionJobItem.ErrorCode for 131182, o arquivo estará possivelmente corrompido. Se o CódigodeErro não for 131182, confirme se o arquivo não está corrompido comparando o CódigodeErro com sua cadeia de caracteres ConversionItemInfo.ErrorMessage correspondente do Word Automation Services. Na sequência, siga as instruções para resolver as falhas de itens no sistema. Além disso, um administrador pode tentar abrir o arquivo na versão do cliente do Microsoft Word e salvá-lo. Esse processo elimina o dano ou repara o arquivo se estiver corrompido. Em seguida, envie o arquivo novamente para conversão.

3. Se o arquivo estiver válido, mas ainda houver falha de conversão, comece a sondagem dos logs de Eventos de cada servidor para os eventos que têm o Word Automation Services como a fonte de eventos. Os eventos do sistema Windows podem ser exibidos usando o Visualizador de Eventos. Se preferir, você pode usar o SCOM para ter uma visão agregada de todos os eventos de todos os servidores no farm. Um número muito alto de eventos do Word Automation Services pode indicar uma condição de falha detectada durante as conversões de vários arquivos. Siga as etapas de solução de problemas especificadas na mensagem do evento de cada tipo de evento e execute as ações necessárias para resolver o problema.

   Observação

   Verifique na página Log de Diagnóstico na Administração Central se a configuração Evento menos crítico a ser relatado no log de eventos para a categoria Word Automation Services está ou não definida como Aviso ou um nível menos grave, como Informativo ou Detalhado. Do contrário, alguns eventos importantes podem não ser gerados pelo Word Automation Services.

4. Se a mensagem do evento e as ações prescritas não resolverem o problema, consulte Como solucionar problemas de eventos específicos.

5. Se as instruções da mensagem do evento e a seção "Como solucionar problemas de eventos específicos" forem insuficientes para resolver o problema, ou se não houver eventos emitidos, consulte os logs de rastreamento ULS referentes aos servidores afetados para saber mais sobre o problema.

   Para preparar esses logs para solução dos problemas, na página Log de Diagnóstico na Administração Central, defina a configuração Evento menos crítico a ser relatado no log de rastreamento para a categoria Word Automation Services.

   Aviso

   A ativação do rastreamento Detalhado afeta o desempenho de todos os servidores de aplicativos. Defina Evento menos crítico a ser relatado no log de rastreamento como Médio depois de concluir as atividades de solução de problemas.

   Com o rastreamento Detalhado ativado, teste o Word Automation Services em condição de carga para manifestar as falhas detectadas. Quando ocorrer a falha, abra os logs de rastreamento ULS em um editor de texto referentes aos servidores em que ocorreram as falhas. Observe que os arquivos de rastreamento são geralmente muito grandes (por exemplo, vários gigabytes em um ambiente de produção) e podem exigir bastante tempo para serem baixados, abertos e analisados. Filtre o log de rastreamento pela área do Word Automation Services do rastreamento.

   A qualidade e legibilidade das entradas do log de rastreamento, também conhecidos como rastreamentos, variam. Os rastreamentos não são localizados e não necessariamente são voltados para uso externo. Os logs de rastreamento podem ter uma quantidade limitada de Informação de Identificação do Usuário sobre os itens ou trabalhos de conversão de arquivo.

   Os logs de rastreamento ULS normalmente podem ser encontrados no seguinte local em cada servidor: %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\14\LOGS

6. Se as etapas anteriores não levarem a uma solução, visite o site de Suporte Técnico para Produtos da Microsoft (https://go.microsoft.com/fwlink/?linkid=15029&clcid=0x416) e entre em contato com o representante de suporte para ajudar no diagnóstico e na solução do problema.

Como solucionar problemas de eventos específicos

Esta seção lista os eventos que são registrados para condições de falha específicas, descreve as causas dos eventos e apresenta etapas de solução para cada erro.

Eventos 8004 e 8005: o conversor de PDF/XPS '[caminho do arquivo & nome]' falhou durante a conversão do arquivo

O Word Automation Services inclui um conversor padrão para converter arquivos nos formatos XPS e PDF. O Word Automation Services também oferece suporte a conversores de terceiros. Os conversores de terceiros podem apresentar bugs que provoquem falha nas conversões de arquivo de maneira imprevisível. O Word Automation Services emite um destes dois eventos quando há falha no conversor de terceiros:

O Word Automation Services também define a mensagem de falha do item de conversão conforme mostrado a seguir:

Resolução

1. Se ocorrerem esses tipos de falha, siga estas etapas para atualizar os conversores:

   1. Adquira com o fornecedor do conversor a DLL mais recente do conversor de PDF ou XPS personalizado.

   2. Substitua a DLL antiga pela nova em %COMMONPROGRAMFILES%\Microsoft Office Servers\14.0\WebServices\WordServer\Core em cada aplicativo no farm.

   3. Se a DLL estiver funcionando corretamente, as novas conversões deverão ser bem-sucedidas.

2. Se os conversores de terceiros continuarem apresentando falha após a aplicação de todas as atualizações disponíveis, desinstale os conversores de terceiros e use os conversores padrão.

   • Exclua a DLL correspondente ao conversor de PDF ou XPS desta pasta: %COMMONPROGRAMFILES%\Microsoft Office Servers\14.0\WebServices\WordServer\Core.

   • As novas conversões agora devem ser bem-sucedidas.

3. Se o arquivo ainda não for convertido, ele provavelmente está corrompido ou inválido. Nesse caso, tente abri-lo na versão do cliente do Word, salve-o novamente e, em seguida, reenvie-o para conversão.

Evento 8010: um arquivo criado usando a nova versão do cliente Office ou do Word Services foi encontrado

O evento 8010 é emitido quando o Word Automation Services encontra um arquivo que foi salvo em uma versão do Microsoft Word mais recente do que a versão instalada do Word Automation Services. Isso pode resultar na redução da qualidade da conversão, dependendo do conteúdo do documento. Se esse evento for emitido, atualize o Word Automation Services assim que possível seguindo o link na mensagem do evento.

Resolução

1. Baixe(https://go.microsoft.com/fwlink/?linkid=157217&clcid=0x416) o conversor mais recente do Word Automation Services do Software Development Kit (SDK) do Microsoft SharePoint 2010.

2. Siga as instruções de instalação do novo conversor.

3. Converta os arquivos. Os arquivos serão convertidos com a melhor qualidade possível, e esse evento não será gerado, exceto se forem encontrados arquivos que exijam uma atualização do conversor do Word Automation Services.

Evento 8012: não foi possível carregar um ou mais componentes localizados para o idioma especificado

Quando há falha em um item de conversão, o código de erro ConversionItemInfo.ErrorCode e a mensagem ConversionItemInfo.ErrorMessage correspondente são gerados. A mensagem de erro deve aparecer ao usuário que enviou o trabalho de conversão. A mensagem de erro aparece localizada no idioma do navegador do usuário que enviou o trabalho de conversão. Entretanto, se os servidores de aplicativo do farm de servidores não tiverem o pacote de idiomas correspondente ao idioma do navegador do usuário, a mensagem de erro não poderá ser apresentada no idioma do navegador do usuário final. Esse evento é emitido quando essa situação ocorre em um item de conversão com falha. Preste atenção também se a mensagem de erro será apresentada no idioma padrão do farm.

Resolução

• Baixe e implante os pacotes de idiomas do SharePoint Server 2010 necessários. Baixe os pacotes de idiomas do Centro de Download da Microsoft (https://go.microsoft.com/fwlink/?linkid=141342&clcid=0x416).

Evento 1001: erro de Acesso ao Banco de Dados SQL. Código de Erro: %1. Mensagem de Erro: %2. Link do Erro: %3

As falhas no sistema do Word Automation Services são geralmente detectadas quando o serviço se comunica com a fila de documentos. Durante cada processo de conversão de arquivo, várias comunicações acontecem entre o serviço e a fila de documentos. Quando há uma falha, o SQL Server gera um erro SQLException com uma grande quantidade de informações relevantes. O Word Automation Services detecta qualquer erro SQLException gerado pelo SQL Server quando o serviço está se comunicando com a fila de documentos e emite este evento:

Essa mensagem de evento apresenta um subconjunto de propriedades SQLException para ajudar os administradores a solucionar os problemas com as falhas que são detectadas quando o Word Automation Services se comunica com a fila de documentos. Esses parâmetros são:

Veja a seguir um exemplo de mensagem de evento que o Word Automation Services gera quando o banco de dados da fila de documentos é removido ou renomeado:

Erro de Acesso ao Banco de Dados SQL. Código de Erro: 0x80131904. Mensagem de Erro: nome do objeto 'dbo.ConversionItemQueue' inválido. Link do Erro: Nenhum.

Código de Erro (SqlException.ErrorCode) é um código do SQL Server não específico ao Word Automation Services. É possível usar o código do SQL Server para relacionar essa falha às informações de solução de problemas do SQL Server existentes.

Mensagem de Erro (SqlException.Message) é uma cadeia de caracteres específica do SQL Server que inclui informações legíveis descrevendo o erro e especifica o banco de dados afetado. Os administradores devem investigar o servidor que mantém o banco de dados referenciado nessa cadeia de caracteres, conforme recomendação da Ajuda de solução de problemas do SQL Server.

Link do Erro (SqlException.HelpLink) é um link específico do SQL Server que leva a mais informações de Ajuda do SQL Server.

Resolução

1. Anote o código, a mensagem e o link do erro na mensagem do evento.

2. Use essas informações para ajudar a solucionar os problemas com os erros do SQL Server. Para obter informações sobre como solucionar problemas com os códigos de erro do SQL Server, consulte o Centro de Soluções do SQL Server (https://go.microsoft.com/fwlink/?linkid=196474&clcid=0x416).

Evento 1002: os trabalhos de conversão podem não ser executados, pois o trabalho de timer '%1' referente ao aplicativo de serviço '%2' não parece estar ativo

O trabalho de timer do Word Automation Services processa e distribui os itens de trabalho na fila aos servidores de aplicativos. Se o trabalho de timer não for executado, a conversão dos itens de trabalho na fila não será iniciada. O evento 1002 será emitido se um novo trabalho for enviado enquanto o trabalho de timer parecer estar inativo. Esse evento será emitido principalmente se uma ou mais das seguintes condições forem verdadeiras:

1. O trabalho de timer não está online. Isso pode ocorrer quando a definição do trabalho não é provisionada corretamente.

2. O trabalho de timer está desabilitado. Isso pode ocorrer quando o administrador desabilita o trabalho de timer na página Editar Trabalho de Timer na Administração Central.

3. O trabalho de timer perdeu duas execuções agendadas de acordo com as configurações atuais na Administração Central.

4. O trabalho de timer perde as execuções agendadas por causa de um problema externo, como a desativação do serviço OWSTimer. O OWSTimer é o Serviço de Timer do SharePoint.

A mensagem desse evento inclui o nome do trabalho de timer que não está sendo executado e o nome do aplicativo de serviço associado ao trabalho de timer. Veja a seguir uma mensagem de exemplo desse evento:

"Os trabalhos de conversão podem não ser executados, pois o trabalho de timer 'e39db2de-1b89-4f74-91da-5da998df0a9c' referente ao aplicativo de serviço 'Word Automation Services' parece não estar ativo."

Resolução

• Habilite o trabalho de Timer do Word Automation Services:

  1. Na home page da Administração Central, clique em Monitoramento.

  2. Na página Monitoramento, em Trabalhos de Timer, clique em Definições de Trabalho.

     Observe se o Trabalho de Timer do Word Automation Services é agendado.

  3. Se o tipo de agendamento do Trabalho de Timer do Word Automation Services estiver desabilitado, clique em Trabalho de Timer do Word Automation Services.

  4. Na página Editar Trabalho de Timer, clique em Habilitar.

     Os trabalhos na fila devem começar a conversão quando o trabalho de Timer for executado.

Se o Trabalho de Timer do Word Automation Services não for agendado, o Word Automation Services não será instalado ou será instalado incorretamente.

Falhas conhecidas que não têm eventos do Word Automation Services para o SharePoint Server 2010

O Word Automation Services não gera Eventos do Windows exclusivos para estas condições de falhas conhecidas:

• Qualquer falha que resulte em SPException (https://go.microsoft.com/fwlink/?linkid=196475&clcid=0x416) que seja gerada pelo SharePoint Server.

• Qualquer falha que resulte em UnauthorizedAccessException (https://go.microsoft.com/fwlink/?linkid=196476&clcid=0x416) que seja gerada pelo SQL Server ou pelo SharePoint Server.

  Exemplo: as permissões de um usuário para acessar um banco de dados de conteúdo foram alteradas.

• Falhas que afetam claramente o servidor inteiro, e não somente o serviço Word Automation Services. Essas falhas são detectadas e mostradas no Windows e no SharePoint Server.

  Exemplo: espaço insuficiente no disco.