Risoluzione dei problemi relativi a Word Automation Services

SharePoint 2010
 

Si applica a: SharePoint Server 2010

Ultima modifica dell'argomento: 2016-11-30

In questo articolo viene descritta la modalità con cui Word Automation Services gestisce gli errori che possono verificarsi a livello di elementi per la conversione o a livello di sistema. Vengono indicate inoltre le comuni procedure per la risoluzione di questi problemi.

Contenuto dell'articolo:

Gli amministratori di sistema vengono avvisati relativamente a potenziali errori di sistema in diversi modi, ad esempio:

  • Gli utenti segnalano errori o eventi a un amministratore di sistema quando i file non vengono convertiti correttamente, ad esempio se durante un'operazione di conversione viene visualizzato un messaggio in cui si indica all'utente di contattare un amministratore di sistema.

  • Vengono registrati eventi di Windows con un'origine evento "Word Automation Services" nel server in cui viene rilevato un errore.

  • In System Center Operations Manager (SCOM), se disponibile, viene indicato uno stato di non integrità di Word Automation Services.

Quando si verifica un errore di un processo di conversione, nella soluzione in genere viene fornita la stringa visualizzata in ConversionItemInfo.ErrorMessage per ogni conversione non riuscita e viene indicato all'utente di eseguire tutte le azioni necessarie nel file. In alcuni casi in ConversionItemInfo.ErrorMessage non sono contenute informazioni sufficienti per consentire a un amministratore di diagnosticare e correggere un potenziale errore di sistema. Per ulteriori informazioni sui dettagli forniti in ConversionItemInfo.ErrorMessage per un processo di conversione, vedere Membri di ConversionItemInfo (le informazioni potrebbero essere in lingua inglese) (http://go.microsoft.com/fwlink/?linkid=196477&clcid=0x410).

Nel caso di un errore di sistema conosciuto, Word Automation Services genera inoltre un evento di Windows nel server in cui è stato rilevato l'errore. Gli eventi sono destinati agli amministratori, per consentire loro di diagnosticare e risolvere singoli errori di sistema. Ogni evento può includere informazioni che richiedono ulteriori indagini da parte dell'amministratore. Gli eventi non sono visibili per gli utenti finali.

Gli eventi vengono registrati nel server in cui sono stati generati. Possono essere visualizzati accedendo al Visualizzatore eventi del server. Cercare gli eventi con origine evento "Word Automation Services". È inoltre possibile utilizzare una console di SCOM per aggregare gli eventi generati nell'intera farm in una singola visualizzazione. SCOM presenta lo stato di integrità di Word Automation Services e dei server in cui viene eseguito.

Un errore di sistema viene inoltre indicato da frequenti interruzioni in Word Automation Services. Per ulteriore assistenza per la risoluzione dei problemi, vedere Risoluzione dei problemi relativi a conversioni non riuscite.

In questa sezione vengono descritti i passaggi per la risoluzione dei problemi relativi a una conversione non riuscita.

  1. Verificare che il file da convertire soddisfi i criteri seguenti:

    • Non deve essere bloccato per tipo di file

    • Non deve essere protetto da password

    • Non deve richiedere l'apertura di Information Rights Management (IRM)

    • Deve essere di un tipo supportato dalla versione di Word Automation Services per SharePoint Server 2010 in uso

  2. Se il valore di ConversionJobItem.ErrorCode è 131182, è probabile che il file sia danneggiato. Se il valore di ErrorCode è diverso da 131182, verificare che il file non sia danneggiato confrontando il valore di ErrorCode con la stringa corrispondente ConversionItemInfo.ErrorMessage di Word Automation Services. Seguire quindi le istruzioni per correggere gli errori dell'elemento per la conversione. Un amministratore inoltre può tentare di aprire e salvare il file nella versione client di Microsoft Word. Con questo processo viene eliminato il danneggiamento o viene riparato il file, se danneggiato. A questo punto è possibile inviare di nuovo il file per la conversione.

  3. Se il file è valido, ma l'errore di conversione persiste, iniziare a eseguire il polling dei registri eventi nei singoli server per ricercare eventi con origine evento Word Automation Services. Gli eventi di sistema di Windows possono essere visualizzati utilizzando il Visualizzatore eventi. In alternativa, è possibile utilizzare SCOM per accedere a una visualizzazione aggregata di tutti gli eventi in tutti i server della farm. Un numero insolitamente elevato di eventi di Word Automation Services può indicare una condizione di errore rilevata nel corso di più processi di conversione di file. Seguire i passaggi per la risoluzione dei problemi specificati nel messaggio di ogni tipo di evento ed eseguire l'azione richiesta per correggere l'errore.

    NotaNote
    Verificare che nella pagina Registrazione diagnostica in Amministrazione centrale l'opzione Evento meno critico da includere nel registro eventi per la categoria Word Automation Services non sia impostata oppure sia impostata su Avviso o su un livello di gravità inferiore, ad esempio Informazioni o Dettagliato. In caso contrario, è possibile che alcuni eventi importanti non vengano generati da Word Automation Services.
  4. Se il messaggio di evento e le azioni richieste non consentono di risolvere il problema, vedere Risoluzione dei problemi relativi a eventi specifici.

  5. Se le istruzioni fornite nel messaggio di evento e nella sezione "Risoluzione dei problemi relativi a eventi specifici" non sono sufficienti per risolvere il problema oppure non sono stati generati eventi, per ottenere ulteriori informazioni sul problema esaminare i registri di traccia ULS per i server interessati.

    Per preparare questi registri per la risoluzione dei problemi, nella pagina Registrazione diagnostica in Amministrazione centrale impostare l'opzione Evento meno critico da includere nel registro di traccia per la categoria Word Automation Services.

    AvvisoWarning
    L'attivazione della registrazione di traccia con livello dettagliato ha effetto sulle prestazioni di tutti i server applicazioni. Ricordarsi di reimpostare Evento meno critico da includere nel registro di traccia sul livello Medio dopo aver terminato le attività di risoluzione dei problemi.

    Con la registrazione di traccia impostata sul livello dettagliato, testare Word Automation Services sotto carico per manifestare gli errori rilevati. Quando si verificano gli errori, aprire i registri di traccia ULS in un editor di testo per i server in cui si sono verificati gli errori. I file di traccia in genere sono molto estesi (possono raggiungere ad esempio dimensioni di diversi gigabyte in un ambiente di produzione) e possono richiedere tempo per il download, l'apertura e la visualizzazione. Filtrare il registro di traccia in base all'area Word Automation Services della traccia.

    La qualità e la leggibilità delle voci dei registri di traccia, note anche come tracce, variano. Le tracce non sono localizzate e non sono necessariamente destinate a un utilizzo esterno. Nei registri di traccia può essere contenuta una quantità limitata di informazioni personali sugli elementi o i processi di conversione dei file.

    I registri di traccia ULS in genere sono disponibili in ogni server nel percorso seguente: %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\14\LOGS

  6. Se i passaggi precedenti non consentono di risolvere il problema, visitare il sito Web Supporto tecnico Microsoft (http://go.microsoft.com/fwlink/?linkid=15029&clcid=0x410) e contattare un rappresentante del servizio clienti per ottenere assistenza per la diagnosi e la risoluzione del problema.

In questa sezione vengono elencati gli eventi registrati per condizioni di errore specifiche, vengono descritte le cause degli eventi e vengono fornite le procedure per la risoluzione di ogni errore.

NotaNote
Gli eventi con ID che iniziano con 80 possono essere generati con una frequenza elevata quando si verifica un errore di sistema. Questi eventi vengono generati per ogni tentativo di conversione per cui si verifica l'errore corrispondente. Per impostazione predefinita, Microsoft SharePoint Server 2010 non consente la generazione di più di cinque eventi con lo stesso ID nello stesso server nell'arco di due minuti. Questa impostazione predefinita riduce il numero di eventi registrati in situazioni di errore persistente. Quando nel registro eventi di Windows sono presenti ID evento che iniziano con 80, è possibile che vi siano cinque eventi con lo stesso ID seguiti immediatamente da un ID evento 2159 di SharePoint Server. Nel messaggio per l'evento 2159 viene indicato quale evento è stato eliminato e per quante volte.
NotaNote
Il Management Pack di SharePoint Server 2010 per Microsoft System Center Operations Manager 2007 include un monitor di System Center Operations Manager per rilevare ogni evento di Windows e visualizzare più facilmente per gli amministratori informazioni sull'integrità relative a Word Automation Services. Per ulteriori informazioni sul monitor di System Center Operations Manager, vedere Management Pack di Prodotti Microsoft SharePoint 2010 Products (versione beta) (le informazioni potrebbero essere in lingua inglese) (http://go.microsoft.com/fwlink/?linkid=196473&clcid=0x410).

Word Automation Services include un convertitore predefinito per la conversione dei file nei formati XPS e PDF. Word Automation Services supporta inoltre convertitori di terze parti. È possibile che i convertitori di terze parti contengano bug che danno origine a comportamenti imprevisti durante le conversioni dei file. Word Automation Services genera uno di questi due eventi quando si verifica un errore di un convertitore di terze parti:

 

ID evento Stringa messaggio di evento ID messaggio correlato Dettagli aggiuntivi

8004

Errore del convertitore PDF '[percorso e nome file]' durante la conversione. Verificare la disponibilità di una versione aggiornata del componente presso il fornitore. Se il problema persiste, disinstallare il convertitore PDF di terze parti per evitare che l'errore si verifichi di nuovo.

131183

Nome registro: Applicazione

Origine: Word Automation Services

Livello evento: Errore

8005

Errore del convertitore XPS '[percorso e nome file]' durante la conversione. Verificare la disponibilità di una versione aggiornata del componente presso il fornitore. Se il problema persiste, disinstallare il convertitore XPS di terze parti per evitare che l'errore si verifichi di nuovo.

131184

Nome registro: Applicazione

Origine: Word Automation Services

Livello evento: Errore

Word Automation Services imposta inoltre il messaggio di errore dell'elemento per la conversione come indicato di seguito:

 

ID messaggio Stringa ConversionItemInfo.ErrorMessage ID evento correlato

131183

Errore del convertitore PDF esterno. Contattare l'amministratore del sistema.

8004

131184

Errore del convertitore XPS esterno. Contattare l'amministratore del sistema.

8005

Soluzione
  1. Se si verificano questi tipi di errori, eseguire la procedura seguente per aggiornare i convertitori:

    1. Contattare il produttore del convertitore per acquisire la DLL più recente per il convertitore PDF o XPS personalizzato.

    2. Sovrascrivere la DLL precedente con la nuova DLL in %COMMONPROGRAMFILES%\Microsoft Office Servers\14.0\WebServices\WordServer\Core in ogni applicazione della farm.

    3. Se la DLL funziona correttamente, le nuove conversioni dovrebbero avere esito positivo.

  2. Se l'errore dei convertitori di terze parti persiste dopo aver applicato tutti gli aggiornamenti disponibili, disinstallare i convertitori di terze parti e utilizzare quelli predefiniti.

    • Eliminare la DLL corrispondente per il convertitore PDF o XPS dalla cartella seguente: %COMMONPROGRAMFILES%\Microsoft Office Servers\14.0\WebServices\WordServer\Core.

    • A questo punto le nuove conversioni dovrebbero avere esito positivo.

  3. Se l'errore di conversione del file persiste, è possibile che il file sia danneggiato o non valido. In questo caso, provare ad aprire il file nella versione client di Word, risalvarlo e quindi sottoporlo di nuovo al processo di conversione.

L'evento 8010 viene generato quando Word Automation Services rileva un file salvato da una versione di Microsoft Word più recente rispetto alla versione di Word Automation Services attualmente installata. Questa situazione può dare origine a una conversione di qualità ridotta, a seconda del contenuto del documento. Se viene generato questo evento, aggiornare Word Automation Services il prima possibile utilizzando il collegamento fornito nel messaggio di evento.

NotaNote
Con questo evento non viene necessariamente indicato che le conversioni hanno esito negativo. Non vi sono pertanto ID di messaggi di errore correlati a questo evento.

 

ID evento Stringa messaggio di evento ID messaggio correlato Dettagli aggiuntivi

8010

È stato rilevato un file creato con una nuova versione del client di Office o con Word Services. Visitare il sito Web all'indirizzo http://go.microsoft.com/fwlink/?linkid=157217&clcid=0x410

Non applicabile

Nome registro: Applicazione

Origine: Word Automation Services

Livello evento: Errore

Soluzione
  1. Scaricare (http://go.microsoft.com/fwlink/?linkid=157217&clcid=0x410) il convertitore di Word Automation Services più recente da Microsoft SharePoint 2010 Software Development Kit (SDK).

  2. Seguire le istruzioni per installare il nuovo convertitore.

  3. Convertire i file. I file verranno convertiti con la migliore qualità possibile e questo evento verrà generato solo se vengono rilevati file che richiedono un aggiornamento al convertitore di Word Automation Services.

Quando un elemento per la conversione ha esito negativo, vengono generati un codice ConversionItemInfo.ErrorCode e un messaggio ConversionItemInfo.ErrorMessage corrispondenti. Il messaggio di errore deve essere visualizzabile per l'utente che ha inviato il processo di conversione. Il messaggio di errore è localizzato nella lingua del browser dell'utente che ha eseguito il processo di conversione. Se tuttavia nei server applicazioni della server farm non sono presenti i Language Pack corrispondenti alla lingua del browser dell'utente, il messaggio di errore non potrà essere visualizzato nella lingua del browser dell'utente finale. Questo evento viene generato quando questa situazione si verifica per un elemento per la conversione che ha avuto esito negativo. Considerare inoltre che il messaggio di errore verrà visualizzato nella lingua predefinita della farm.

 

ID evento Stringa messaggio di evento ID messaggio correlato Dettagli aggiuntivi

8012

Impossibile caricare uno o più componenti localizzati per la lingua specificata. Verificare che il Language Pack necessario sia installato e configurato correttamente.

Non applicabile

Nome registro: Applicazione

Origine: Word Automation Services

Livello evento: Errore

Soluzione
  • Scaricare e distribuire i Language Pack di SharePoint Server 2010 necessari dall'Area download Microsoft (http://go.microsoft.com/fwlink/?linkid=141342&clcid=0x410).

Gli errori di sistema per Word Automation Services in genere vengono rilevati quando il servizio comunica con la coda documenti. Durante ogni processo di conversione di file, vengono scambiate diverse comunicazioni tra il servizio e la coda documenti. Quando si verifica un errore, SQL Server genera un errore SQLException in cui vengono fornite numerose informazioni. Word Automation Services rileva un errore SQLException generato da SQL Server quando comunica con la coda documenti e genera questo evento:

 

ID evento Stringa messaggio di evento ID messaggio correlato Dettagli aggiuntivi

1001

Errore di accesso database SQL. Codice errore: %1. Messaggio di errore: %2. Collegamento errore: %3.

6, 7

Nome registro: Applicazione

Origine: Word Automation Services

Livello evento: Errore

In questo messaggio di evento è contenuto un sottoinsieme delle proprietà di SQLException per consentire agli amministratori di risolvere i problemi rilevati quando Word Automation Services comunica con la coda documenti. I parametri sono i seguenti:

 

Nome Descrizione MSDN

ErrorCode

Ottiene il valore HRESULT dell'errore. (Ereditato da ExternalException)

HelpLink

Ottiene o imposta un collegamento al file della Guida associato a questa eccezione. (Ereditato da Exception)

Message

In overload.

Viene riportato di seguito un messaggio di evento generato da Word Automation Services se il database della coda documento è stato rimosso o rinominato:

Errore di accesso database SQL. Codice errore: 0x80131904. Messaggio di errore: Il nome di oggetto 'dbo.ConversionItemQueue' non è valido. Collegamento errore: Nessuno.

Codice errore (SqlException.ErrorCode) è un codice di SQL Server non specifico di Word Automation Services. È possibile utilizzare il codice di SQL Server per correlare questo errore a informazioni per la risoluzione dei problemi di SQL Server esistenti.

Messaggio di errore (SqlException.Message) è una stringa specifica di SQL Server contenenti informazioni leggibili per gli utenti in cui viene descritto l'errore e viene indicato il database interessato. È consigliabile che gli amministratori esaminino il server in cui è contenuto il database indicato nella stringa, come specificato dalla Guida per la risoluzione dei problemi di SQL Server.

Collegamento errore (SqlException.HelpLink) è un collegamento specifico di SQL Server a ulteriori informazioni della Guida di SQL Server.

Soluzione
  1. Prendere nota del codice di errore, del messaggio di errore e del collegamento errore contenuti nel messaggio di evento.

  2. Utilizzare queste informazioni per la risoluzione dei problemi relativi a SQL Server. Per informazioni su come risolvere i problemi segnalati da codici di errore di SQL Server, vedere Centro di supporto di SQL Server (http://go.microsoft.com/fwlink/?linkid=196474&clcid=0x410).

Il processo timer per Word Automation Services elabora e distribuisce gli elementi dei processi in coda ai server applicazioni. Se il processo timer non viene eseguito, gli elementi dei processi in coda non inizieranno la conversione. L'evento 1002 verrà generato se viene inviato un nuovo processo quando il processo timer non è attivo. In particolare verrà generato se si verifica una o più delle condizioni seguenti:

  1. Il processo timer non è online. Questo problema può verificarsi se il provisioning della definizione del processo non è stato eseguito correttamente.

  2. Il processo timer è disabilitato. Questo problema può verificarsi se un amministratore ha disabilitato il processo timer nella pagina Modifica processo timer in Amministrazione centrale.

  3. Il processo timer ha ignorato due esecuzioni pianificate in base alle impostazioni correnti di Amministrazione centrale.

  4. Il processo timer ignora le esecuzioni pianificate a causa di un problema esterno, ad esempio se è disattivato il servizio OWSTimer, ovvero il servizio Timer di SharePoint.

NotaNote
SharePoint Server può richiedere circa 90 minuti per elaborare la condizione di errore e generare questo evento.

 

ID evento Stringa messaggio di evento ID messaggio correlato Dettagli aggiuntivi

1002

È possibile che i processi di conversione non vengano eseguiti perché il processo timer '%1' per l'applicazione di servizio '%2' non è attivo.

Non applicabile

Nome registro: Applicazione

Origine: Word Automation Services

Livello evento: Avviso

In questo messaggio di evento sono contenuti il nome del processo timer non in esecuzione e il nome dell'applicazione di servizio a esso associata. Viene riportato di seguito un messaggio di esempio per questo evento:

"È possibile che i processi di conversione non vengano eseguiti perché il processo timer 'e39db2de-1b89-4f74-91da-5da998df0a9c' per l'applicazione di servizio 'applicazione di Word Automation Services' non è attivo".

Soluzione
  • Abilitare il processo timer di Word Automation Services:

    1. Nella home page Amministrazione centrale fare clic su Monitoraggio.

    2. In Processi timer nella pagina Monitoraggio fare clic su Definizioni processi.

      Controllare se il processo timer di Word Automation Services è un processo timer pianificato.

    3. Se il tipo di pianificazione per il processo timer di Word Automation Services è disabilitato, fare clic su Processo timer di Word Automation Services.

    4. Nella pagina Modifica processo timer fare clic su Attiva.

      I processi in coda dovrebbero iniziare la conversione quando viene eseguito il processo timer.

Se il processo timer di Word Automation Services non è un processo timer pianificato, Word Automation Services non è installato correttamente oppure non è installato affatto.

Word Automation Services non genera eventi di Windows univoci per queste condizioni di errore note:

  • Qualsiasi errore risultante in un'eccezione SPException (le informazioni potrebbero essere in lingua inglese) (http://go.microsoft.com/fwlink/?linkid=196475&clcid=0x410) generata da SharePoint Server.

  • Qualsiasi errore risultante in un'eccezione UnauthorizedAccessException (http://go.microsoft.com/fwlink/?linkid=196476&clcid=0x410) generata da SQL Server o SharePoint Server.

    Esempio: le autorizzazioni di un utente per l'accesso a un database del contenuto sono cambiate.

  • Errori che influiscono chiaramente sull'intero server e non solo sul servizio Word Automation Services. Questi errori vengono rilevati e visualizzati in Windows e SharePoint Server.

    Esempio: spazio su disco insufficiente.

Mostra: