Guide pratique pour mapper des orchestrations à des services web
Une orchestration peut avoir plusieurs ports de réception. À l'aide de l'Assistant Publication de services Web BizTalk, vous sélectionnez les ports de réception à publier en tant que services Web. L'Assistant crée un seul service Web (fichier .asmx) pour chaque port de réception. L'Assistant peut également créer un service Web pour tous les ports de réception s'il s'agit du même type de port de réception (unidirectionnel ou requête-réponse). Les opérations deviennent des appels de fonction. Chaque opération au niveau du port de réception devient une méthode Web. Les opérations de requête deviennent des paramètres d'entrée. Les opérations de réponse deviennent des types de retours.
Si les opérations de demande et de réponse sont du même type de message Web, le paramètre d’entrée devient une référence et le type de retour est void. Les clients Web ASP.NET peuvent changer la signature de la méthode Web en combinant les paramètres d'entrée et de sortie du même type. Par exemple, un client web ASP.NET peut modifier une méthode Web BizTalk de chaîne myService(string part) en void myService(ref string part).
Les types de messages d'opération définissent les signatures de méthode Web. Chaque partie de type de message est un paramètre dans la méthode Web.
Noms des parties de type de message et espaces de noms cibles
Les schémas de document et les classes définies par l’utilisateur avec XmlRootAttribute spécifiés sont des parties de type de message qui ont des espaces de noms cibles définis. Les schémas EDI, les classes définies par l’utilisateur sans xmlRootAttribute spécifié et les types intégrés, tels que System.String , sont des parties de type de message sans espaces de noms cibles définis.
| Si le nom de la partie de type de message a un | Nom de paramètre utilisé |
|---|---|
| Espace de noms cible défini | Nom d'élément racine |
| Aucun espace de noms cible défini | Nom de la partie de type de message |
Notes
Lorsqu'un type de message à parties multiples est utilisé pour le message de réponse, l'Assistant Publication de services Web BizTalk utilise la première partie de message pour la valeur de retour et les parties de message restantes sont utilisées en tant que paramètres de sortie.
Orchestrations avec plusieurs opérations
Si votre orchestration a plusieurs opérations, vous devez concevoir vos orchestrations pour avoir un seul port de réception à la place de plusieurs ports de réception. Cette conception empêche l'Assistant Publication de services Web BizTalk de créer plusieurs fichiers de service Web (.asmx) et fonctionne uniquement lorsque toutes les opérations ont le même modèle d'appel : toutes les opérations unidirectionnelles ou toutes les opérations de requête-réponse. Un port de réception unique ne peut pas contenir à la fois des opérations unidirectionnelles et de requête-réponse.
Notes
L'Assistant Publication de services Web BizTalk affiche des ports de réception publics. Les ports de réception publics sont des types de ports avec un modificateur de type public. Vous pouvez publier uniquement des ports publics en tant que service Web. Le type de port par défaut est interne.
Notes
Si votre port de réception est défini comme unidirectionnel, le type de réponse de la méthode Web est void et aucune information n’est retournée au client Web. Les exceptions générées par l'adaptateur SOAP ou une orchestration ne sont pas renvoyées au client Web.
Conventions d'affectation de noms des services Web pour les orchestrations publiées
L’Assistant Publication des services web BizTalk génère des noms de fichiers de service Web (.asmx) en fonction de l’espace de noms des orchestrations, suivis d’un trait de soulignement (), suivi du nom du type, d’un trait de soulignement (\) et du nom du port de réception. Un trait de soulignement (_) remplace l'une des parties contenant des points. Le nom du service Web a toujours le nom du port ajouté.
Le tableau suivant montre comment l'Assistant Publication de services Web BizTalk génère des noms de service Web.
| Orchestration(s) avec port(s) Web | Nom de service Web généré |
|---|---|
| Une seule orchestration avec un seul port Web | orchestration1_port1.asmx |
| Une orchestration avec deux ports Web | orchestration1_port1.asmx et orchestration1_port2.asmx |
| Deux orchestrations avec un port Web chacune | orchestration1_port1.asmx et orchestration2_port2.asmx |
Voir aussi
Publication d’une orchestration en tant que service web
Guide pratique pour utiliser l’Assistant Publication des services web BizTalk pour publier une orchestration en tant que service web