WES Ricoh - Dépanner le WES

Règles générales pour le dépannage

Afin de permettre à l'équipe Support Doxense® d'établir un diagnostic de panne rapide et fiable, merci de communiquer le maximum d'informations possible lors de la déclaration de l'incident :

  • Quoi ? Quelle est la procédure à suivre pour reproduire l'incident ?

  • Quand ? A quelle date et à quelle heure a eu lieu l'incident ? 

  • Où ? Sur quel périphérique et depuis quel poste de travail a eu lieu l'incident ?

  • Qui ? Avec quel compte utilisateur s'est produit l'incident ?

  • Fichier trace Watchdoc.log : merci de joindre le fichier de trace Watchdoc.

  • Fichier de traces WES : merci d'activer les fichiers de trace sur chaque file pour laquelle vous avez constaté un incident. 

 

Une fois ces informations rassemblées, vous pouvez envoyer une demande de résolution depuis le portail Connect, outil de gestion des incidents dédié aux partenaires.

 

Pour obtenir un relevé optimal des données nécessaires au diagnostic, utilisez l'outil Watchdoc DiagTool fourni avec le programme d'installation de Watchdoc (cf. Créer un rapport de logs avec DiagTool).

Activer les traces du WES (WEStraces)

Pour effectuer un diagnostic du problème rencontré sur les applications embarquées, il convient d'activer les fichiers traces (logs) spécifiques aux communications du WES.

 

Pour activer les traces :

  1. dans l'interface d'administration web de Watchdoc, depuis le Menu Principal, cliquez sur Files d'impression ;

  2. dans la liste des files, cliquez sur la file dotée du WES pour lequel vous souhaitez activer les fichiers traces ;

  3. dans l'interface de gestion de la file, cliquez sur le bouton Propriétés ;

  4. dans la rubrique [Nom_du_WES], cliquez sur le bouton Editer la configuration :


  5. dans la section WES > Diagnostic, cochez la case Activer les traces ;

  6. dans la liste Niveau de traces, sélectionnez :

    • Auto : conserve les traces standard ;

    • Inclure les contenus binaires : conserve les traces détaillées.
  7. dans le champ Chemin, indiquez le chemin du dossier dans lequel doivent être enregistrés les fichiers de trace. Si vous laissez le champ vide, les fichiers trace seront enregistrés par défaut dans le dossier d'installation Watchdoc_install_dir/Logs/Wes_Traces/QueueId :



 

L'activation des journaux risque de ralentir le fonctionnement du serveur.
Il est donc fortement recommandé de désactiver cette option une fois le problème résolu.

Travaux de numérisation, fax et photocopie non comptabilisés

Si les travaux de numérisation, fax et photocopie ne sont pas comptabilisés par Watchdoc, vérifiez que l'adresse (nom d'hôte ou IP) du serveur Watchdoc configurée dans le périphérique est correcte :

  1. dans l'interface de configuration de la file, dans la section WES, cliquez sur le bouton Etat de l'application (affiché lorsque le WES est correctement installé) ;

  2. cliquez sur le bouton Télécharger afin de télécharger les fichiers de logs et de configuration du WES ;

  3. si la configuration de l'adresse et/ou des ports n'est pas correcte, cliquez sur le bouton Configurer de l'interface de configuration de la file ;

  4. vérifiez que la procédure a réglé le problème.

Transformation de travaux (transformation de spools) non prise en compte - oct. 2026

Contexte

En tant qu'administrateur, je configure la transformation des travaux d'impression (transfo de spools) sur le profil WES de périphériques d'impression Canon. Je constate que ces transformations ne sont pas prises en compte. 

 

Cause

Cette anomalie peut être due à la configuration du pilote. Le pilote basique Canon intègre le langage propriétaire CPCA incompatible avec la transformation des travaux. Pour permettre cette fonctionnalité, il convient de configurer le pilote de sorte qu'il soit de type PCL6.

 

Résolution

Il convient de modifier la configuration du pilote du périphérique pour faire en sorte qu'il soit compatible PCL6 et non CPCA (cf. Prérequis et configuration préalable).

Erreur de comptabilisation pour une impression format large (A3) lorsque deux quotas sont configurés

Contexte

Lorsque deux quotas sont appliqués sur une file pour tenir compte de formats d'impression différents (un quota pour le format A4 et un autre pour le format A3), il arrive que l'on constate une erreur de comptabilisation : une impression en grand format est comptée double.


Par exemple, on dispose :

  • d'un quota appliquant un coût unitaire de 1 € pour une impression A4 ;

  • d'un quota appliquant un coût unitaire de 2 € pour une impression A3.

En cas d'impression A3, au lieu d'être débité de 2 €, le quota est débité de 4 € .

 

Cause
L'erreur est due au système de comptabilisation du périphérique qui compte un grand format comme deux petits formats. Le coût est alors doublé, alors que le quota configuré pour un grand format est déjà plus élevé que le quota pour un petit format.

 

Résolution

  1. Rendez-vous sur la file d'impression sur laquelle l'erreur de comptabilisation a été constatée ;

  2. depuis l'interface de consultation de la file, cliquez sur le bouton Editer les propriétés de la file ;

  3. dans l'interface Propriétés de la file d'impression, rendez-vous dans la section Mode Expert ;

  4. pour le paramètre Comptabilisation, cochez la case Redresser la comptabilisation pour les grands formats :

     

  5. Lancez une impression grand format pour vérifier que le quota n'est plus doublé.

 

N.B. : après résolution, si vous constatez que l'anomalie perdure sur les impressions couleur uniquement, mettez à jour Watchdoc en version v.6.1.1.5696 min. qui intègre un correctif (pour un nombre de pages pair uniquement).

Erreur de comptabilisation des impressions redressées : les pages noir & blanc sont redressées, mais pas les pages en couleur - juillet 2026.

Contexte

Lorsque la case "redresser la comptabilisation" est cochées dans la configuration de la file, il arrive que l'on constate une différence de traitement des pages redressées : seules les impressions noir & blanc sont concernées et les pages en couleur ne le sont pas. 

 

Résolution

Il convient de mettre à jour Watchdoc en v.6.1.1.5696 min. qui intègre un correctif (pour un nombre de pages pair uniquement).

Le WES ne trouve plus la file de sortie - Message d'erreur "Impossible de retrouver la file de sortie" - sept. 2026

Contexte

Une file d'impression utilisant la fonction d'impression interserveur est migrée d'un serveur vers un autre serveur. Après avoir lancé son impression sur cette file, l'utilisateur qui tente de la débloquer voit s'afficher le message d'erreur suivant : "Impossible de retrouver la file de sortie" :


Dans les logs du WES, l'administrateur trouve le message suivant : "! WARN [...] WES|RestApi21Controller "Could not find target 'Queue [Id_de_la_file]' in the local config. Any local job will be visible, be not able to print on that remote device!".

 

Cause
Le cache conserve l'identifiant de la file qui a été migrée vers un nouveau serveur. Donc, si la file est sollicitée trop rapidement après sa migration, son identifiant, associé à l'ancien serveur, est toujours présent dans le cache qui n'a pas eu le temps d'être vidé.

 

Résolution
Il convient :

  1. de redémarrer le service Watchdoc afin de vider le cache ;

  2. puis de relancer l'impression pour vérifier que l'opération a résolu le problème.

WES Ricoh - Mise à jour du jeton d'authentification - Echéance : 02/02/2028

Contexte

Lorsque Watchdoc fonctionne avec un WES Ricoh, à l'approche de la date d'expiration du jeton d'authentification, un message d'alerte s'affiche, vous invitant à contacter le revendeur :

Résolution

Ce problème peut être résolu par l'une des opérations suivantes :

  • par la mise à jour de Watchdoc ;

  • par la modification automatique à l'aide du script PowerShell (WatchdocRefreshRicohToken.zip) à appliquer sur tous les serveurs du domaine (master et slaves) ;

  • par la modification manuelle à l'aide de la procédure indiquée ci-dessous.

Procédure

Cette procédure nécessitant une interruption de service, assurez-vous de l'effectuer au moment où elle aura le moins de conséquences sur l'activité d'impression (HNO). En fonction de l'importance de votre parc, cette interruption de service peut prendre entre 15 secondes et 20 minutes.


Vous pouvez également modifier le fichier de configuration de Watchdoc manuellement sur tous les serveurs du domaine (master et slaves) :

  1. rendez-vous dans le serveur hébergeant Watchdoc et arrêtez le service Watchdoc ;

  2. recherchez le fichier config.xml (enregistré par défaut dans C:\Program Files\Doxense\Watchdoc\Data) ;

  3. effectuez une sauvegarde de ce fichier ;

  4. éditez le fichier config. xml et recherchez-y la balise <ricoh-web-api>  ;

  5. si cette balise n'existe pas, créez-la sous la balise <instances><default-instance> ;

  6. modifiez les balises incluses dans la balise <ricoh-web-api> comme suit :

 

<ricoh-web-api>

<remote>

<token>/yRUEU9p0bcbIoN5wA3BTxPAAITn+8LXqRCmNpzb7zGZZIacUXsvz1rEknxlb2yCgisDrak4lTi1EjQYncukK9cMwxi1jShy5fN9qCUy9HRdL8qIYr4mU6aQrJhVVUwE8sWIRaaZG/3aZA07ybuJvUEoTf/OA66ja2I8Cf+9N4oGvErB3D6ZZh3GJ+kYcUZ0
</token>

<valid-until>20280222</valid-until>

</remote>

<browser>

<token>/yRUEU9p0bcbIoN5wA3BTxPAAITn+8LXqRCmNpzb7zGZZIacUXsvz1rEknxlb2yCgisDrak4lTi1EjQYncukK4cxmrZHgFOSkv7Yl2KGKSJhDL4Jw8dRfwat4g6pQkkV8sWIRaaZG/3aZA07ybuJvWtAIrYyDz2ZFxhihx/d5srA+yWYP6Sbn8dufT8VstpiMtpQC6O/rDX3/tY1jGK6jw==
</token>

<valid-until>20280222</valid-until>

</browser>

</ricoh-web-api>

 

Dans la balise <token>, il ne doit exister aucun espace dans la chaîne de caractères.
Si vous constatez des espaces, supprimez-les.

Comme dans l'exemple suivant :



 

5. enregistrez le fichier config.xml ;

6. redémarrez le service Watchdoc ;

7. dans le site web d'administration Watchdoc, vérifiez que le message d'alerte relatif au jeton d'authentification ne s'affiche plus.

Impossible de trouver l’assembly ‘Doxense.Web, Version=5.4.0.0, culture=neutral, PublicKeyToken=94de63351b6ea861’.

Contexte

 

Lors de l'installation du WES Ricoh, l'erreur suivante s'affiche quand on clique sur le bouton Configurer :
Impossible de trouver l'assembly 'Doxense.Web Version=[n°_version], Culture=neutral, PublicKey Token=94de63351b6ea861'


 

Résolution

Installer le WES Ricoh manuellement.

Ne surtout pas utiliser le WESRICOHDEPLOYER

 

Informations à demander au technicien

Disposer des identifiants de connexion au portail web du périphérique d'impression.

Demander l'activation des SP Modes par le technicien sur le site et valider autant de fois que possible avec la touche dièse #

  • 5-113- 002 = 0

  • 5-401-230 = 00000001

  • 5-401-240 = 1000

  • 5-420-041 = OFF

  • 5-490-001 = Allowed

WES Ricoh - Scan natif - Impossible de numériser un document - Messager d'erreur Journal scanner plein

Contexte

Lors de l'utilisation de la fonctionnalité de numérisation native, un message d'erreur s'affiche sur l'écran du périphérique : Journal scanner plein contacter l'administrateur.

 

Cause

Ce message est lié à la gestion du journal des numérisations sur le périphérique.

 

Résolution

  1. Via un navigateur, accédez à l'interface de configuration du périphérique en tant qu'administrateur.

  2. Dans l'interface de configuration, cliquez sur l'entrée de menu Scanner, puis Paramètres généraux.

  3. Pour le paramètre Imprimer et supprimer le journal scanner, sélectionnez : Ne pas imprimer : supprimer le plus ancien :