Identification et résolution des incidents liés au service de messagerie Web

La section suivante contient des informations concernant l'identification et la résolution des incidents rencontrés lors de l'utilisation du service de messagerie Web.


Référence de l'activation de l'environnement d'exécution

L'environnement d'exécution du service de messagerie Web doit être installé et activé avant qu'une application compatible avec une messagerie Web soit installée. Si vous installez une application compatible avec une messagerie Web sans avoir installé ni activé l'environnement d'exécution, le message d'erreur suivant s'affiche avec une erreur de servlet 503 lorsque vous essayez d'accéder à l'URI d'une messagerie Web :

    CWPSB1701E : Le service de messagerie Web n'est pas configuré pour l'URI entrant suivant : /uri

Lorsque vous rencontrez ce message, vous devez d'abord vérifier si le service de messagerie Web est installé et activé. Pour obtenir plus de détails, reportez-vous à la section Activation du service de messagerie Web. Si l'installation et l'activation du service de messagerie Web se sont déroulées normalement, les messages de journal suivants s'affichent au démarrage du serveur :

     CWPSB1102I : Le service de messagerie Web est activé.

Si vous rencontrez une erreur de configuration même après avoir installé et activé le service de messagerie Web, vérifiez les points suivants :

Référence des messages d'erreur affichés côté client

Le service de messagerie Web utilise le protocole Bayeux. La plupart des zones de message du protocole Bayeux présentent une zone booléenne correcte et une zone d'erreur correspondante. Si une opération effectuée à l'aide du protocole Bayeux n'a pas abouti, le service de messagerie Web tente d'envoyer des informations sur l'erreur qui s'est produite, afin d'aider les développeurs d'application ainsi que les utilisateurs finaux à déterminer l'origine de l'échec. Le format de la chaîne de l'erreur figurant sur le protocole Bayeux comporte 3 arguments séparés par des deux-points. Le premier argument correspond à un code d'erreur permettant d'effectuer de simples comparaisons. Le deuxième argument correspond à une liste séparée par des virgules, contenant des arguments à l'origine de l'échec. Le dernier argument correspond à une brève description du message d'erreur. Voici des exemples de message d'erreur :

Le tableau suivant répertorie la plupart des messages que le service de messagerie Web envoie aux clients utilisant le protocole Bayeux, lorsqu'une opération échoue. Référez-vous à ce tableau pour déboguer les échecs rencontrés côté client. Si vous rencontrez ces types d'erreur côté client, consultez les journaux du serveur pour obtenir des informations supplémentaires.

Code d'erreur Description simple Arguments Description
300 Le numéro de la version n'est pas approprié. Les versions minimale et maximale sont transmises au serveur Le serveur a été incapable de trouver une version appropriée à la zone correspondant à la version fournie par le client et à celle de la version minimale. Dans la plupart des cas, le serveur invite le client à établir une nouvelle connexion via un numéro de version fourni par le serveur dans les zones : version et minimumVersion.
301 Le type de connexion n'est pas approprié. Les types de connexion fournis par le client Le client a essayé d'établir une connexion avec un type de connexion qui n'est pas pris en charge par le serveur. La réponse relative à l'établissement de la connexion comprend la liste des types de connexion pris en charge. Si ce message d'erreur s'affiche lors d'une demande d'établissement de connexion, le client doit essayer de se reconnecter à l'aide d'une valeur valide figurant dans la liste des types de connexion pris en charge. Si ce message d'erreur est généré à la suite d'une demande de connexion, le serveur invite le client à établir une nouvelle connexion et à trouver un type de connexion commun.
302 L'extension n'est pas appropriée. L'extension fournie Le protocole Bayeux fournit un mécanisme d'extension qui permet d'utiliser une fonction au-dessus de ce qu'il peut prendre en charge. Dans certains cas, une extension fournie peut être non valide. Dans cette version, le serveur ignore toute extension inconnue.
400 La demande n'est pas reconnue par le serveur aucun La demande envoyée par le client n'est pas reconnue par le serveur. Vous recevez ce message d'erreur pour les raisons suivantes :
  • la demande envoyée par le client contient un format JSON non valide ;
  • la demande JSON n'a pas été envoyée en tant que zone de message sous forme de post-demande codée.
401 L'ID client fourni est inconnu. L'ID client fourni Ce message s'affiche lorsqu'un serveur ne reconnaît pas l'ID client fourni. Dans la plupart des cas, ce message d'erreur s'affiche avec le mécanisme de suggestion Bayeux qui invite le client à établir une nouvelle connexion et à effectuer une inscription dans toute rubrique dans laquelle des inscriptions ont été effectuées auparavant. Cette erreur se produit le plus souvent dans l'un des cas suivants :
  • le client tente inconsidérément de se connecter via un ID client non valide ;
  • un échec au niveau du serveur ou au niveau de l'affinité de session s'est produit dans un environnement groupé ;
  • le client a essayé de se connecter avec une session Bayeux expirée.
402 Un paramètre requis ne figure pas dans la demande Le paramètre manquant Le protocole Bayeux exige les zones requises dans plusieurs messages Bayeux. Si une zone requise est manquante, un message d'erreur indiquant la zone manquante est généré.
403 Le canal indiqué est non autorisé. Le canal non autorisé Si un client a essayé d'effectuer une inscription ou une publication dans un canal sans l'autorisation requise, ce message d'erreur est renvoyé au client.
404 Le canal indiqué est inconnu Le canal inconnu Le client a essayé d'effectuer une inscription, une désinscription ou une publication dans un canal inconnu. Cette erreur est souvent générée lorsque le format du canal multipleDestination est indiqué et que le premier argument ne correspond pas à l'espace de rubrique du bus d'intégration de service ou à l'alias de l'espace de la rubrique.
405 La syntaxe du canal indiqué n'est pas valide Le format du canal non valide Ce message est émis lorsqu'un format de canal non valide est indiqué. Reportez-vous à la section relative au protocole Bayeux pour obtenir des informations sur les formats de canal Bayeux valides.
406 La zone d'extension indiquée n'est pas valide La zone d'extension non valide Ce message est émis lorsqu'une zone d'extension non valide est fournie. L'implémentation du service de messagerie Web ignore les zones d'extension qu'elle ne reconnaît pas ; ce message d'erreur ne doit donc pas être visible côté client.
407 La demande de publication n'a pas abouti. Le canal sur lequel la demande de publication a été créée Ce message d'erreur indique l'échec de la demande de publication. Dans la plupart des cas, ce message indique que l'option clientCanPublish est définie sur false.
408 Le client n'est pas autorisé à établir une connexion pour une réception ou une publication de messages. aucun Ce message d'erreur est généré lors de l'établissement d'une connexion ou lors d'une demande de connexion. Dans la plupart des cas, ce message d'erreur indique un problème lié à la configuration de la sécurité du bus d'intégration de services, en particulier en attribuant le rôle du connecteur de bus à cet utilisateur entrant.
500 Le serveur a rencontré une erreur interne et a été incapable d'effectuer la demande. aucun Une erreur interne s'est produite au sein du serveur. Pour plus d'informations, consultez les journaux du serveur.
503 Service indisponible. aucun Une erreur de communication avec un bus d'intégration de services a été rencontrée. Cela se produit classiquement en cas de défaillance de la communication avec un moteur de messagerie, par exemple, lorsque ce dernier s'arrête. Pour plus d'informations, consultez les journaux du serveur.


Conditions d'utilisation | Commentaires