Comprendre les adaptateurs de service Web

Les rubriques suivantes décrivent la fonctionnalité système de manière plus détaillée.

Importer un WSDL

La configuration d'un adaptateur de service Web commence par l'identification du WSDL (le document de langue de description de service Web utilisé pour définir l'interface) qui sera fourni par le système tiers. Les étapes suivantes décrivent la fonctionnalité de produit de base fournie pour permettre à un utilisateur d'importer un WSDL.

  • Accédez à la page Adaptateur de service Web en mode Ajouter et sélectionnez l'objet métier standard approprié.
  • Entrez un nom de service Web significatif et des descriptions appropriées.
  • Fournissez l'URL du WSDL donné.
  • Cliquez sur Importer pour récupérer les détails du WSDL. Le système analyse ensuite les détails WSDL et renseigne le nom de service WSDL, la source WSDL, le port WSDL, l'URL et une liste des opérations (méthodes) définies dans le WSDL.
  • Déterminez les opérations qui doivent être actives en fonction des conditions métier requises pour appeler ce service Web. Les opérations actives sont celles que l'implémentation prévoit d'appeler à partir du système. Elles requièrent la génération de zones de données de requête et de réponse appropriées. Pour plus d'informations, voir la section suivante.
  • Spécifiez le type de sécurité approprié pour configurer le type de sécurité à utiliser lors de l'appel de ce service Web.
  • Cliquez sur Enregistrer.

A ce moment, un enregistrement d'adaptateur de service Web est créé avec l'état En attente. L'étape suivante consiste à générer les zones de données de requête et de réponse pour les opérations configurées comme étant actives.

Générer des zones de données de requête et de réponse

Chaque opération active pour l'adaptateur de service Web nécessite une paire de zones de données, requête et réponse, qui représentent les messages XML de requête et de réponse pour l'opération.

Le produit de base fournit les étapes permettant de générer les zones de données comme suit :

  • Tel que décrit dans la section Importer un WSDL ci-dessus, les opérations répertoriées dans le WSDL sont générées pour l'adaptateur de service Web et la personne en charge de l'implémentation doit indiquer quelle opération activer.
  • Après avoir enregistré l'adaptateur de service Web en attente, l'affichage répertorie toutes les opérations actives et inclut pour chacune un bouton Générer.
  • Après avoir cliqué sur Générer pour une opération, une fenêtre dans laquelle les noms des nouvelles zones de données de requête et de réponse peuvent être définis apparaît. Cliquez sur Enregistrer pour générer les zones de données.

Les zones de données générées fournissent l'API à utiliser par la personne responsable de l'implémentation de l'appel de service Web dans un algorithme ou service approprié dans le système. Les zones de données contiennent le mappage approprié des éléments avec lesquels la personne responsable de l'implémentation travaille dans le code qui appelle les services Web et les définitions WSDL.

Pour faciliter la génération des zones de données de requête et réponse, le produit de base appelle un service fonctionnel spécial utilisé pour créer le mappage approprié. Le service fonctionnel est défini comme option d'objet métier sur l'objet métier Adaptateur de service Web. Ceci permet à une implémentation de fournir un service fonctionnel personnalisé pour améliorer davantage le mappage de requête et de réponse, si nécessaire.

Remarque :

Zone de données générées. Il est possible de modifier les zones de données une fois celles-ci créées. Une personne responsable de l'implémentation peut modifier les noms d'éléments ou supprimer les éléments inutiles, le cas échéant. La modification manuelle des zones de données générées doit être effectuée uniquement en cas d'absolue nécessité. En effet, le système n'est pas en mesure de valider les modifications manuelles et des problèmes au niveau des zones de données risquent d'être détectés à l'exécution.

Activer les adaptateurs de service Web

Les objets métier fournis par l'installation standard pour les adaptateurs de service Web incluent un cycle de vie simple (En attente et Actif). Configurez l'adaptateur de service Web et les zones de données associées lorsque leur état est En attente et activez-le lorsqu'il est prêt à être implémenté dans la fonctionnalité système appropriée.

Appeler les services Web

Pour appeler un service Web à l'aide de l'adaptateur de service Web, le système a fourni un service fonctionnel de répartiteur de service Web (F1-InvokeWebService) pour soumettre un appel de service Web. Le programme d'appel est responsable de la récupération de toutes les informations permettant de renseigner correctement les données de requête requises par l'appel de service Web avant d'appeler le service fonctionnel.

Remarque :

Reportez-vous à la description détaillée du service fonctionnel pour plus d'informations.

Limitations

Les points suivants mettent en évidence les limitations associées aux types de services Web que le système prend en charge :

  • Il est possible pour un document WSDL de contenir les définitions pour plusieurs services Web. Le système prend actuellement en charge un port ou service par document WSDL.
  • Il est possible pour un WSDL de prendre en charge plusieurs modèles de message. Le système ne prend actuellement en charge que requête / réponse.