Pièces jointes référencées et de type swaRef
Les pièces jointes référencées et de type swaRef-type peuvent être ajoutées aux exportations avec une liaison de services Web.
Cette rubrique traite des types de pièces jointes suivants :
- Pièces jointes référencées
- Pièces jointes de type swaRef
Pièces jointes référencées
Ce type de pièce jointe peut être modélisé dans un fichier WSDL. Vous souhaitez, par exemple, envoyer un C.V. d'un employé à un service Web à partir d'une application créée dans IBM® Integration Designer. Dans ce C.V. il peut être utile d'inclure une photo de l'employé en pièce jointe.
Pour prendre en charge les messages SOAP avec des pièces jointes référencées pour les exportations, les opérations de l'interface doivent utiliser le style de liaison en littéral de document non encapsulé ou le style de liaison en littéral RPC (voir Type de liaison), et l'entrée ou la sortie dans l'opération contenant la référence doit être binaire. En outre, la liaison WSDL doit contenir une liaison de transport MIME. Une liaison de transport MIME est gérée pour vous lorsque vous utilisez les éditeurs de IBM Integration Designer. Etant donné que les pièces jointes référencées sont associées à des messages en plusieurs parties, nous vous conseillons de lire la rubrique Utilisation d'un type de liaison de document avec des messages composites pour comprendre comment fonctionne l'association entre la norme WS-I (Web Services Interoperability) et le style de liaison.
L'éditeur d'interface permet de modéliser les pièces jointes référencées. La procédure ci-après indique comment modéliser la pièce jointe.
Pour ce faire, nous partons du principe que vous disposez déjà d'un module équipé d'une interface contenant une ou plusieurs opérations en entrée. Les instructions partent également du principe que vous avez une exportation et que l'interface lui a été ajoutée.
- Ouvrez votre interface dans l'éditeur d'interface.
- Dans l'éditeur d'interface, sélectionnez l'opération à laquelle sera associée une pièce jointe. Si le style de liaison n'est pas littéral de document non encapsulé, cliquez sur Changer le style de liaison en littéral de document non-encapsulé et validez le changement de style.
- Dans la colonne Type, sélectionnez un type binaire, par exemple hexBinary, pour les données en entrée/sortie transmises via une pièce jointe.
- Cliquez sur l'onglet Propriétés et sélectionnez une entrée ou une sortie avec le type binaire.
- En regard de la zone Type de contenu binaire, cliquez sur Ajouter. La fenêtre Sélectionner le contenu binaire s'affiche.
- Dans la zone Type de contenu binaire, sélectionnez la catégorie du type, par exemple image/jpg, ou tapez-la directement dans la zone.
- Cliquez sur OK.
- Dans l'éditeur d'assemblage, cliquez avec le bouton droit sur l'exportation et sélectionnez Générer la liaison > Liaison de service Web. L'assistant Sélection du protocole de transport s'ouvre.
- Selon la version du protocole SOAP que vous souhaitez utiliser, sélectionnez l'une des options suivantes :
- SOAP1.2/HTTP
- SOAP1.1/HTTP
Ces deux options prennent en charge les liaisons de services Web XML (JAX-WS).
- Cliquez sur Terminer. Si vous avez sélectionné au moins un type binaire à utiliser pour les pièces jointes, le nouveau fichier de liaison WSDL sera généré avec une liaison de transport MIME.
- Déployez votre application et exécutez-la.
Pièces jointes de type swaRef
En utilisant la spécification Web Services Interoperability Organization (WS-I) Attachments, vous pouvez transmettre une pièce jointe de type swaRef via SOAP.
Pour transmettre une pièce jointe en tant que type swaRef au moyen de la spécification WS-I Attachments Profile, procédez comme suit :
- Ajoutez le profil de pièce jointe WS-I à votre module. Ouvrez Dépendances dans la vue Intégration métier et, dans la rubrique Ressources prédéfinies, sélectionnez Profil de connexion WS-I 1.0 : fichier schéma swaRef. Sauvegardez votre travail.
- Pour ajouter une pièce jointe à un objet métier, créez un objet métier et, pour le type, sélectionnez swaRef, qui est disponible car vous avez ajouté le schéma précédemment.
- Pour ajouter une pièce jointe en tant que type pour l'entrée ou la sortie d'une opération, créez l'opération dans l'interface. Ajoutez une entrée ou une sortie à l'opération. Si l'objet métier créé précédemment est utilisé, sélectionnez alors cet objet en tant que type de votre entrée ou sortie. Dans le cas contraire, ajoutez une autre entrée ou sortie et choisissez swaRef comme type.
- Générez la liaison, déployez votre application et exécutez-la.