Mise à jour d'un fichier WSDL modifié

Si vous avez créé un projet qui utilise un document WSDL et que celui-ci est modifié, vous pouvez tenter de mettre à jour le WSDL existant avec le nouveau WSDL.

Pourquoi et quand exécuter cette tâche

La mise à jour d'un fichier WSDL implique que les entités constituant l'interface avec celui-ci peuvent être affectées par la modification. Par exemple, le fichier WSDL définit les paramètres d'entrée et de sortie de l'opération et si le schéma définissant ces paramètres est modifié dans le nouveau fichier WSDL, les noeuds qui représentent ces paramètres dans les tâches Mapper les entrées et Mapper les sorties des activités de services Web risquent de ne plus exister. Les liens vers ces noeuds ne sont alors plus valides. Vous devez recréer les liens pour que l'orchestration soit à nouveau valide. La mise à jour d'un fichier WSDL peut nécessiter des modifications dans le projet autres que la recréation de liens. Pour plus de détails, reportez-vous au tableau 1. Dans certains cas, le nouveau fichier WSDL n'est pas chargé comme décrit dans les trois premières lignes du tableau suivant.
Remarque : La mise à jour d'un fichier WSDL existant est différente du chargement de plusieurs fichiers WSDL dans un projet en faisant glisser un fichier vers l'onglet Projet ou en cliquant avec le bouton droit de la souris sur le dossier WSDL de l'onglet Projet et en sélectionnant Ajouter un document. La mise à jour d'un fichier WSDL existant remplace celui-ci dans le projet alors que le téléchargement du même fichier dans l'onglet Projet crée deux instances du fichier WSDL dans le projet.
Tableau 1.
Modification du fichier WSDL Le nouveau fichier WSDL remplace le fichier WSDL initial Incidence sur le projet
Le nouveau fichier WSDL n'est pas un fichier WSDL valide. Par exemple, la balise </definitions> finale est manquante à la fin du fichier WSDL. Non, la mise à jour n'a pas lieu Aucune, le nouveau fichier WSDL n'est pas chargé. Aucune mise à jour n'est effectuée sur les entités du projet.
Le téléchargement du nouveau fichier WSDL pour remplacer le fichier existant se traduirait par un projet non valide. Non, la mise à jour n'a pas lieu Aucune, le nouveau fichier WSDL n'est pas chargé. Aucune mise à jour n'est effectuée sur les entités du projet.
Tentative de mise à jour du fichier WSDL en cours avec un autre fichier WSDL dans une orchestration ou un noeud final faisant référence au fichier WSDL en cours.
Remarque : Vous pouvez charger plusieurs fichiers WSDL dans un projet.
Non, la mise à jour n'a pas lieu Aucune, le nouveau fichier WSDL n'est pas chargé. Aucune mise à jour n'est effectuée sur les entités du projet.
La définition de liaison de service du fichier WSDL est définie par les éléments de service, de port et d'emplacement. Si les valeurs des éléments de service, de port et d'emplacement sont modifiées dans le fichier WSDL, les valeurs de ces éléments stockées dans le noeud final de service Web doivent être mises à jour. Oui, la mise à jour a lieu Les valeurs du noeud final de service Web sont mises à jour avec les dernières valeurs spécifiées dans le fichier WSDL. Pour plus d'informations sur ces éléments, voir Création ou édition d'un noeud final de service Web.
Le nom d'une opération est modifié dans le fichier WSDL et l'orchestration démarre cette opération dans l'activité Appeler service. Oui, la mise à jour a lieu Si le nom de l'opération est modifié et que celle-ci est utilisée par l'activité Appeler service, la première opération du fichier WSDL est par défaut affecté à l'activité Appeler service. Cette réaffectation à la première opération peut ne pas être le résultat souhaité. Les paramètres d'entrée et de sortie de la première opération du fichier WSDL peuvent être différents de ceux de l'opération spécifiée initialement. Par conséquent, les liens risquent de ne plus exister dans les tâches Mapper les entrées et Mapper les sorties. Vous devez configurer à nouveau l'activité Appeler service pour que l'orchestration soit valide.
Le nom d'une opération est modifié dans le fichier WSDL mais l'orchestration ne démarre pas cette opération dans des activités Appeler service. Oui, la mise à jour a lieu Si le nom de l'opération est modifié et que celle-ci n'est utilisée dans aucune activité Appeler service, cette modification du fichier WSDL n'a pas d'incidence.
Des éléments <part> supplémentaires sont ajoutés aux éléments qui définissent les paramètres d'entrée et de sortie de l'opération. Cette modification affecte toute entité du projet faisant référence à ce composant du fichier WSDL. Les entités affectées possibles sont les suivantes :
  • Mappes autonomes
  • Activité de mappage de variables
  • Variables basées sur ce composant du fichier WSDL
  • Une orchestration contenant une activité Appeler service qui démarre une opération utilisant ce type de message. Par exemple, l'élément <message> dans l'exemple suivant

Par exemple, voir Figure 1.

Oui, la mise à jour a lieu Comme les éléments <part> ont uniquement été ajoutés à l'élément <message>, cette modification n'a généralement pas d'incidence sur les mappes et variables existantes basées sur le fichier WSDL. Pour l'exemple du message <Helloin>, l'ajout d'un nouvel élément de ville n'a pas d'incidence sur les liens vers l'élément <part> d'adresse existant dans les tâches Mapper les entrées ou Mapper les sorties de l'activité Appeler service. Si nécessaire, vous pouvez créer des liens vers le nouvel élément.
Modification du type d'un élément <part> dans un élément <message> qui définit les paramètres d'entrée et de sortie de l'opération. Cette modification affecte toute entité de projet faisant référence à ce composant du fichier WSDL. Les entités affectées possibles sont les suivantes :
  • Mappes autonomes
  • Activité de mappage de variables
  • Variables basées sur ce composant du fichier WSDL
  • Une orchestration contenant une activité Appeler service qui démarre une opération utilisant ce type de message.
Oui, la mise à jour a lieu Les liens existants des mappes ne sont pas supprimés même si le type a peut-être été modifié.
ATTENTION :
Le changement de type peut avoir un impact sur l'exécution se traduisant par des données de sortie potentiellement incorrectes. Vérifiez si des conversions de type effectuées sur les liens de mappes ne provoquent pas le renvoi de données de sortie incorrectes lors de l'exécution.
Modification de l'élément <message> du paramètre d'entrée ou de sortie de l'opération.

Cette modification affecte toute entité de projet faisant référence à ce composant du fichier WSDL. Les entités affectées possibles sont les suivantes :

  • Mappes autonomes
  • Activité de mappage de variables
  • Variables basées sur ce composant du fichier WSDL
  • Une orchestration contenant une activité Appeler service qui démarre une opération utilisant ce type de message.
Oui, la mise à jour a lieu Les liens vers le paramètre d'entrée ou de sortie qui ont été modifiés dans la mappe sont supprimés. Vous devez créer les liens vers le paramètre modifié dans les mappes. Par exemple, si l'élément <message> est modifié pour le paramètre d'entrée de l'opération appelée par une activité Appeler service, les liens vers les noeuds de la tâche Mapper les entrées de l'activité Appeler service sont supprimés. Vous devez créer des liens depuis des variables vers le nouvel ensemble de noeuds apparaissant dans le panneau Vers l'activité de la tâche Mapper les entrées.
Figure 1. Exemple d'éléments <part> supplémentaires
<message name="HelloIn">
	<part name="address" type="xsd:string>
</message>
Ajouter l'élément <part> supplémentaire suivant
<message name="HelloIn">
<part name="address" type="xsd:string>
<part name="city" type="xsd:string>
</message>