Déployer les services Web SOAP entrants

Une fois qu'un service Web SOAP entrant a été défini, il n'est pas mis automatiquement à la disposition des clients de service Web qui souhaitent accéder au système. L'état de déploiement et l'indicateur Actif (auquel la valeur Vrai est affectée) indiquent si un service Web est ou non disponible. La dernière étape consiste à déployer les services Web SOAP entrants sur le serveur d'application Web Java EE. Cette phase du déploiement comporte plusieurs étapes exécutées automatiquement au démarrage du déploiement :

  • Les fichiers du service Web sont générés et des règles y sont rattachées.

  • Le document WSDL est généré avec les annotations et les énumérations appropriées.

  • Le code stub Java nécessaire pour implémenter le service Web dans l'application Web Java EE est généré et compilé.

  • Les services Web sont créés dans un fichier WAR (Web Application Archive) valide.

  • (Facultatif) Le fichier WAR de services Web nouvellement créé est déployé sur le serveur d'application Web Java EE. Si vous le souhaitez, vous pouvez également effectuer cette étape manuellement pour les déploiements en cluster.

Deux méthodes sont disponibles pour déployer les services Web SOAP entrants :

  • Déploiement à la ligne de commande au moyen de la commande iwsdeploy[.sh], comme décrit dans le Guide d'administration du serveur. Cette méthode est recommandée sur les installations natives et les implémentations de production.

  • Déploiement via le portail Déploiement de service Web entrant. Cette méthode n'est prise en charge que dans les environnements de développement (hors production).

Portail de déploiement de service Web entrant

Pour utiliser le portail de déploiement de service Web entrant, sélectionnez Administration > Intégration > Déploiement de service Web entrant.

Les sections suivantes décrivent les zones de base fournies avec le portail.

Déployer les services Web SOAP entrants

La zone Déployer les services Web SOAP entrants fournit des informations sur le dernier déploiement. Si la région est une région de développement (hors production), vous pouvez utiliser le bouton Déployer pour déployer ou redéployer des services Web entrants. Tous les services Web entrants dont la bascule Actif a la valeur Oui seront déployés. Le déploiement de tous ceux dont la base Actif a la valeur Non sera annulé.

Remarque :
Lorsqu'un service Web SOAP entrant est déployé, la valeur de son champ Version de service est capturée. Certaines modifications de configuration nécessitent un redéploiement pour être prises en compte. Lorsque l'une des modifications suivantes est effectuée, la valeur Version de service du service Web entrant est incrémentée. Le déploiement passe alors à l'état Déploiement requis.

  • La bascule Actif est modifiée

  • Une annotation est ajoutée ou supprimée

  • Une opération est ajoutée ou supprimée

  • La valeur Nom de l'opération, Type de schéma / Nom du schéma, Schéma de requête ou de réponse, XSL de requête ou de réponse d'une opération est modifiée.

Remarque :
En outre, si l'implémentation prend en charge les services XAI déployés via un service Web entrant, les services entrants XAI appropriés seront également déployés ou leur déploiement annulé, selon vos besoins.

Etat du déploiement

La zone Etat du déploiement affiche la liste des services Web SOAP entrants du produit, notamment leur état de déploiement.

L'état de déploiement est déterminé par une comparaison entre le champ Version de service interne de chaque service Web entrant et la valeur capturée au moment du déploiement.

  • Déployé. Indique que le service Web entrant a été déployé et qu'aucune modification de la configuration n'a été détectée.

  • Déploiement requis. Indique que le service Web entrant n'a jamais été déployé ou qu'il a été déployé, mais que des modifications nécessitant un redéploiement ont été détectées entre temps.

  • Non déployé. Indique que le service Web entrant est marqué comme inactif et qu'il n'a pas été détecté comme étant déployé.

  • Annulation du déploiement requise. Indique que le service Web entrant est marqué comme inactif mais qu'il a été détecté comme étant déployé.

Si le service Web entrant a été déployé, la colonne Vue contient un lien WSDL vous permettant de lancer une fenêtre distincte pour afficher la définition WSDL.

Remarque :
Pour les installations dans le cloud, le système prend en charge la définition de l'URL WSDL par l'intermédiaire d'une valeur de substitution définie pour l'URI jeton : @F1_​BASE_​IWS_​URI@. Le système utilise cette valeur conformément à la fonctionnalité décrite dans la rubrique Substitution d'URI. Lorsqu'aucune valeur n'est définie, le système utilise une URL par défaut, à savoir l'URL appropriée aux installations sur site.

Utilisez le bouton Transmission adjacent à l'un des services Web entrants figurant dans la zone pour afficher les détails de l'enregistrement de service Web entrant. La zone Service Web entrant s'affiche alors. Il s'agit de la même zone qui apparaît dans le portail de maintenance Service Web entrant.

Etat de déploiement de service entrant XAI

La zone Etat de déploiement de service entrant XAI n'est visible que si l'option de configuration Mutualisation de paramètres Prendre en charge un déploiement XAI via un sce Web entrant est configurée dans le type de mutualisation de paramètres Messages externes ou si le système détecte que des services entrants XAI ont été déployés. (Cette dernière condition est vérifiée au cas où l'implémentation contiendrait des services entrants XAI déployés qui ne seraient plus utilisés. Après avoir défini l'option de configuration Mutualisation de paramètres sur faux, un déploiement supplémentaire est nécessaire pour annuler le déploiement des services XAI.) La zone affiche la liste des services entrants XAI du produit qui sont liés à des services de page. Pour plus d'informations, voir Déployer des services entrants XAI via un service Web entrant

L'état de déploiement est déterminé en comparant le champ Version de l'enregistrement à la valeur capturée au moment du déploiement.

  • Déployé. Indique que le service entrant XAI a été déployé et qu'aucune modification n'a été détectée dans la configuration.

  • Déploiement requis. Indique que le service entrant XAI n'a pas été déployé ou a été déployé entre-temps et que des modifications ont été détectées dans la configuration.

  • Non déployé. Indique que le service entrant XAI est marqué comme inactif ou que l'option Prendre en charge un déploiement XAI via un sce Web entrant n'est pas définie avec la valeur vrai et que le service entrant XAI n'est pas déployé actuellement.

  • Annulation du déploiement requise. Indique que le service entrant XAI est marqué comme inactif ou que l'option Prendre en charge un déploiement XAI via un sce Web entrant n'est pas définie avec la valeur vrai mais que le service entrant XAI est déployé actuellement.

Les services entrants XAI ne disposent pas d'un champ équivalent au champ Version de service des services Web entrants, qui est uniquement incrémenté lorsque des modifications qui impactent le déploiement sont apportées à l'enregistrement. Pour les services entrants XAI, c'est le numéro de version figurant dans l'enregistrement qui est utilisé. Ce champ est incrémenté dès lors qu'une modification est apportée, même si elle n'impacte pas le déploiement. En conséquence, certains services entrants XAI peuvent indiquer "Déploiement requis" même si aucun redéploiement n'est nécessaire. Dans ce cas, il est recommandé de déployer le service à nouveau par précaution.

Si le service Web entrant a été déployé, la colonne Vue contient un lien WSDL vous permettant de lancer une fenêtre distincte pour afficher la définition WSDL.