Résolution des problèmes de Word Automation Services

S’applique à : SharePoint Server 2010

Dernière rubrique modifiée : 2016-11-30

Cet article décrit la manière dont Word Automation Services gère les erreurs qui peuvent se produire au niveau de l’élément de conversion ou du système et indique les procédures courantes de résolution de ces erreurs.

Dans cet article :

• Réactions de Word Automation Services aux éventuelles défaillances du système

• Comment résoudre les échecs de conversion

• Comment résoudre des événements spécifiques

• Échecs connus sans événements Word Automation Services pour SharePoint Server 2010

Réactions de Word Automation Services aux éventuelles défaillances du système

Les administrateurs système sont avertis des éventuelles défaillances du système de diverses manières ; par exemple :

• Les utilisateurs rapportent les défaillances ou événements perçus à un administrateur système lorsque des fichiers ne sont pas convertis avec succès. Par exemple, au cours d’une conversion, un message indique à l’utilisateur de contacter un administrateur système.

• Des événements Windows qui indiquent « Word Automation Services » comme source sont générés sur le serveur sur lequel une défaillance a été détectée.

• S’il est disponible, System Center Operations Manager (SCOM) indique que Word Automation Services est défectueux.

Lorsqu’un travail de conversion échoue, la solution fournit généralement la chaîne qui est affichée dans le message d’erreur ConversionItemInfo.ErrorMessage pour chaque échec de conversion et demande à l’utilisateur de réaliser les actions nécessaires sur le fichier. Dans certains cas, le message d’erreur ConversionItemInfo.ErrorMessage ne contient pas suffisamment d’informations pour qu’un administrateur puisse diagnostiquer et corriger une éventuelle défaillance du système. Pour plus d’informations sur les détails fournis par le message d’erreur ConversionItemInfo.ErrorMessage pour un travail de conversion, voir ConversionItemInfo Members (éventuellement en anglais) (https://go.microsoft.com/fwlink/?linkid=196477&clcid=0x40C).

En cas de défaillance connue du système, Word Automation Services génère également un événement Windows sur le serveur sur lequel la défaillance a été détectée. Les événements sont destinés à aider les administrateurs à diagnostiquer et à résoudre des défaillances individuelles du système. Chaque événement peut inclure beaucoup d’informations nécessitant des recherches approfondies de la part de l’administrateur. Les utilisateurs finaux ne voient pas les événements.

Un événement réside sur le serveur qui l’a émis. Les événements peuvent être affichés à l’aide de l’observateur d’événements du serveur. Recherchez les événements dont la source est « Word Automation Services ». Vous pouvez également utiliser une console SCOM pour agréger les événements émis pour l’ensemble de la batterie dans un affichage unique. SCOM présente l’état de santé de Word Automation Services et les serveurs sur lesquels il s’exécute.

Des interruptions répétées de Word Automation Services peuvent également indiquer une défaillance du système. Pour plus d’informations, voir Comment résoudre les échecs de conversion.

Comment résoudre les échecs de conversion

Cette section décrit les étapes de résolution d’un échec de conversion.

1. Confirmez que le fichier en cours de conversion répond aux critères suivants :

   • Il n’est pas bloqué par type de fichier

   • Il n’est pas protégé par un mot de passe

   • Il ne requiert pas l’ouverture de Gestion des droits relatifs à l’information (IRM)

   • Son type est prise en charge par la version de Word Automation Services pour SharePoint Server 2010 que vous utilisez

2. Si le code d’erreur ConversionJobItem.ErrorCode est 131182, le fichier est vraisemblablement endommagé. Si le code d’erreur n’est pas 131182, confirmez que le fichier n’est pas endommagé en comparant le code d’erreur à la chaîne ConversionItemInfo.ErrorMessage correspondante de Word Automation Services. Suivez ensuite les instructions pour résoudre les échecs de l’élément de conversion. Par ailleurs, un administrateur peut essayer d’ouvrir le fichier dans la version client de Microsoft Word et d’enregistrer le fichier. Ce processus prévient tout endommagement du fichier ou répare le fichier corrompu. Relancez ensuite la conversion du fichier.

3. Si le fichier est valide, mais que la conversion continue d’échoue, recherchez dans les journaux des événements des serveurs individuels des événements ayant comme source Word Automation Services. Les événements système Windows peuvent être affichés à l’aide de l’observateur d’événements. Vous pouvez également utiliser SCOM pour afficher une vue agrégée de tous les événements de tous les serveurs de la batterie. Un nombre exceptionnellement élevé d’événements Word Automation Services peut indiquer une condition d’échec qui est détectée au cours de conversions multiples de fichiers. Suivez les étapes de résolution des problèmes spécifiées dans le message d’événement pour chaque type d’événement et réalisez l’action nécessaire pour résoudre le problème.

   Notes

   Vérifiez que sur la page Journalisation des diagnostics de l’Administration centrale, le paramètre Événement le moins critique à enregistrer dans le journal d’événements de la catégorie Word Automation Services n’est pas défini ou qu’il est défini sur Avertissement ou un niveau moins critique, comme Information ou Commentaire. Sinon, des événements importants risquent de ne pas être générés par Word Automation Services.

4. Si le message d’événement et les actions préconisées ne permettent pas de résoudre le problème, voir Comment résoudre des problèmes spécifiques.

5. Si les instructions du message d’événement et la section « Comment résoudre des événements spécifiques » ne suffisent pas à résoudre le problème, ou en l’absence d’événements émis, recherchez les serveurs affectés dans les journaux de suivi ULS pour en savoir plus sur le problème.

   Pour préparer ces journaux en vue de la résolution des problèmes, dans la page Journalisation des diagnostics de l’Administration centrale, définissez le paramètre Événement le moins critique à enregistrer dans le journal de suivi pour la catégorie Word Automation Services.

   Avertissement

   L’activation du suivi Commentaire affectera les performances de tous les serveurs d’applications. Veillez à rétablir le paramètre Événement le moins critique à enregistrer dans le journal de suivi sur Moyen après avoir réalisé les activités de résolution des problèmes.

   Lorsque le suivi Commentaire est activé, effectuez un test de charge de Word Automation Services pour reproduire les échecs détectés. Lorsque les échecs se produisent, ouvrez les journaux de suivi ULS dans un éditeur de texte pour les serveurs sur lesquels les échecs se sont produits. Notez que les fichiers de suivi sont généralement très volumineux (jusqu’à plusieurs gigaoctets dans un environnement de production) et qu’ils peuvent de ce fait être longs à télécharger, ouvrir et passer en revue. Filtrez le journal de suivi pour n’afficher que le suivi relatif à Word Automation Services.

   La qualité et la lisibilité des entrées du journal de suivi, également appelées traces, peuvent varier. Les traces ne sont pas localisées et ne sont pas nécessairement destinées à un usage externe. Les journaux de suivi peuvent contenir une quantité limitée d’informations d’identification personnelle sur les éléments ou le travaux de conversion de fichiers.

   Les journaux de suivi ULS se trouvent généralement sur chaque serveur à l’emplacement suivant : %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\14\LOGS

6. Si les étapes précédentes ne permettent pas de résoudre le problème, visitez le site Web Aide et Support Microsoft (https://go.microsoft.com/fwlink/?linkid=15029&clcid=0x40C) et contactez un représentant du support technique qui vous aidera à diagnostiquer et à résoudre le problème.

Comment résoudre des événements spécifiques

Cette section répertorie les événements qui sont consignés dans le journal pour des conditions d’échec spécifiques, décrit les causes de ces événements et fournit la procédure de résolution de chaque erreur.

Event 8004 et Event 8005 : The PDF/XPS converter ’[chemin d’accès du fichier & nom]’ failed during file conversion

Word Automation Services inclut un convertisseur par défaut pour la conversion de fichiers aux formats XPS et PDF. Word Automation Services prend également en charge des convertisseurs tiers. Les convertisseurs tiers peuvent avoir des bogues à l’origine de l’échec inopiné des conversions de fichiers. Word Automation Services émet l’un de ces deux événements lorsqu’un convertisseur tiers échoue :

Word Automation Services définit également le message d’échec de l’élément de conversion de la manière suivante :

Résolution

1. Si ces types d’échecs se produisent, suivez les étapes ci-après pour mettre à jour les convertisseurs :

   1. Procurez-vous la dernière DLL du convertisseur PDF ou XPS personnalisé auprès du fournisseur du convertisseur.

   2. Remplacez l’ancienne DLL par la nouvelle dans le dossier %COMMONPROGRAMFILES%\Microsoft Office Servers\14.0\WebServices\WordServer\Core dans chaque application de la batterie.

   3. Si la DLL fonctionne correctement, les nouvelles conversions doivent maintenant réussir.

2. Si les convertisseurs tiers continuent d’échouer une fois toutes les mises à jour disponibles appliquées, désinstallez les convertisseurs tiers et utilisez les convertisseurs par défaut.

   • Supprimez la DLL du convertisseur PDF ou XPS du dossier %COMMONPROGRAMFILES%\Microsoft Office Servers\14.0\WebServices\WordServer\Core.

   • Les nouvelles conversions devraient maintenant réussir.

3. Si le fichier n’est toujours pas converti, il est probablement endommagé ou n’est pas valide pour une autre raison. Dans ce cas, essayez d’ouvrir le fichier dans la version client de Word, enregistrez de nouveau le fichier, puis relancez la conversion du fichier.

Event 8010: A file that was created using a new version of Office client or Word Services has been encountered

L’événement 8010 est émis lorsque Word Automation Service rencontre un fichier qui a été enregistré par une version de Microsoft Word plus récente que la version actuellement installée de Word Automation Service. Cela peut conduire à une conversion d’une qualité inférieure, selon le contenu du document. Si cet événement est émis, mettez à niveau Word Automation Services aussi tôt que possible en suivant le lien fourni dans le message d’événement.

Résolution

1. Téléchargez(https://go.microsoft.com/fwlink/?linkid=157217&clcid=0x40C) le dernier convertisseur Word Automation Services à partir du Kit de développement logiciel (SDK) Microsoft SharePoint 2010.

2. Suiviez les instructions d’installation du nouveau convertisseur.

3. Convertissez les fichiers. Les fichiers seront convertis avec la meilleure qualité possible et cet événement ne sera pas généré sauf si des fichiers requièrent une mise à jour du convertisseur Word Automation Services.

Event 8012: One or more localized components could not be loaded for the specified language

Lorsqu’un élément de conversion échoue, un code d’erreur ConversionItemInfo.ErrorCode et un message d’erreur ConversionItemInfo.ErrorMessage correspondant sont générés. Le message d’erreur est présenté à l’utilisateur ayant soumis le travail de conversion. Il est localisé dans la langue du navigateur de l’utilisateur ayant soumis le travail de conversion. Cependant, si les serveurs d’applications de la batterie de serveurs ne contiennent pas le module linguistique correspondant à la langue du navigateur de l’utilisateur final, les messages d’erreur ne peuvent pas être présentés dans la langue du navigateur de l’utilisateur final. Cet événement est émis lorsque cette situation se produit pour un élément de conversion ayant échoué. Notez également que le message d’erreur lui-même sera présenté dans la langue par défaut de la batterie.

Résolution

• Téléchargez et déployez les modules linguistiques SharePoint Server 2010 requis. Téléchargez les modules linguistiques depuis le Centre de téléchargement Microsoft (https://go.microsoft.com/fwlink/?linkid=141342&clcid=0x40C).

Event 1001: SQL Database Access Error. Error Code: %1. Error Message: %2. Error Link: %3

Les défaillances du système pour Word Automation Services sont généralement détectées lorsque le service communique avec la file d’attente de documents. Au cours de chaque processus de conversion de fichier, plusieurs communications se produisent entre le service et la file d’attente de documents. En cas d’échec, SQL Server génère une erreur SQLException accompagnée de nombreuses informations pertinentes. Word Automation Services détecte toute erreur SQLException générée par SQL Server lorsque le service communique avec la file d’attente de documents et émet cet événement :

Ce message d’événement contient un sous-ensemble des propriétés SQLException afin d’aider les administrateurs à résoudre les défaillances détectées lorsque Word Automation Services communique avec la file d’attente de documents. Ces paramètres sont les suivants :

Vous trouverez ci-dessous un exemple de message d’événement généré par Word Automation Services si la base de données de file d’attente de documents est supprimée ou renommée :

Sql Database Access Error. Error Code: 0x80131904. Error Message: Invalid object name ’dbo.ConversionItemQueue’. Error Link: None.

Error Code (SqlException.ErrorCode) est un code SQL Server qui n’est pas spécifique à Word Automation Services. Vous pouvez utiliser le code SQL Server pour associer cette défaillance à des informations de dépannage SQL Server existantes.

Error Message (SqlException.Message) est une chaîne spécifique à SQL Server qui contient des informations lisibles par l’homme décrivant l’erreur et spécifiant la base de données affectée. Les administrateurs doivent examiner le serveur qui gère la base de données référencée dans cette chaîne comme recommandé dans les informations de dépannage de SQL Server.

Error Link (SqlException.HelpLink) est un lien spécifique à SQL Server avec des informations d’aide supplémentaires sur SQL Server.

Résolution

1. Notez le code d’erreur, le message d’erreur et le lien de l’erreur dans le message d’événement.

2. Utilisez ces informations pour vous aider à résoudre les erreurs SQL Server. Pour plus d’informations sur la résolution des codes d’erreur SQL Server, voir SQL Server Solution Center (éventuellement en anglais) (https://go.microsoft.com/fwlink/?linkid=196474&clcid=0x40C).

Event 1002: Conversion jobs may not execute because the timer job ’%1’ for service application ’%2’ does not appear to be active

Le travail du minuteur de Word Automation Service traite et distribue les éléments de travail mis en file d’attente sur les serveurs d’applications. Si le travail de minuteur ne s’exécute pas, les éléments de travail mis en file d’attente ne seront pas convertis. L’événement 1002 sera émis si un nouveau travail est émis alors que le travail de minuteur est inactif. Plus précisément, cet événement sera émis si une ou plusieurs des conditions suivantes sont vraies :

1. Le travail de minuteur n’est pas en ligne. Cela peut se produire si la définition du travail n’a pas été correctement fournie.

2. Le travail de minuteur est désactivé. Cela peut se produire si un administrateur a désactivé le travail de minuteur dans la page Modifier le travail du minuteur de l’Administration centrale.

3. Le travail de minuteur a manqué deux exécutions planifiées selon les paramètres actuels de l’Administration centrale.

4. Le travail de minuteur manque les exécutions planifiées en raison d’un problème externe, par exemple la désactivation du service OWSTimer. OWSTimer est le service de minuteur de SharePoint .

Ce message d’événement contient le nom du travail de minuteur qui ne s’exécute pas et le nom de l’application de service associée au travail de minuteur. Voici un exemple de message pour cet événement :

"Conversion jobs may not execute because the timer job ’e39db2de-1b89-4f74-91da-5da998df0a9c’ for service application ’Word Automation Service Application’ does not appear to be active."

Résolution

• Activez le travail du minuteur de Word Automation Services :

  1. Dans la page d’accueil de l’Administration centrale, cliquez sur Analyse.

  2. Dans la page Analyse, sous Travaux du minuteur, cliquez sur Définitions des travaux.

     Notez si le travail du minuteur de Word Automation Services est un travail de minuteur planifié.

  3. Si le type de planification pour le travail du minuteur de Word Automation Services est désactivé, cliquez sur Travail du minuteur des services d’automatisation Word.

  4. Dans la page Modifier le travail du minuteur, cliquez sur Activer.

     Les travaux mis en file d’attente devraient démarrer dès que le travail du minuteur s’exécutera.

Si le travail du minuteur de Word Automation Services n’est pas un travail de minuteur planifié, Word Automation Services n’est pas installé ou est installé de manière incorrecte.

Échecs connus sans événements Word Automation Services pour SharePoint Server 2010

Word Automation Services ne génère pas d’événements Windows uniques pour les conditions d’erreur connues suivantes :

• Tout échec qui se traduit par une SPException (https://go.microsoft.com/fwlink/?linkid=196475&clcid=0x40C) générée par SharePoint Server.

• Tout échec qui se traduit par une UnauthorizedAccessException (https://go.microsoft.com/fwlink/?linkid=196476&clcid=0x40C) générée par SQL Server ou SharePoint Server.

  Exemple : les autorisations d’accès d’un utilisateur à une base de données de contenu ont changé.

• Les échecs qui affectent clairement le serveur dans son ensemble et pas seulement le service Word Automation Services. Ces échecs sont détectés et indiqués dans Windows et SharePoint Server.

  Exemple : espace disque insuffisant.