Considérations relatives à l'ingénierie à rebours dans les solutions existantes

Article
08/21/2008

Mise à jour : novembre 2007

Dans Visual Studio Team System Architecture Edition, vous pouvez définir des applications et des systèmes d'applications de conception dans une solution Visual Studio existante en utilisant les Concepteurs de systèmes distribués. Vous pouvez effectuer cette tâche en ajoutant un diagramme d'application ou diagramme système à votre solution. Lorsque vous exécutez cette tâche, Visual Studio effectue une ingénierie à rebours de la solution et ajoute les définitions d'application au diagramme d'application pour les projets appropriés dans la solution. Vous pouvez ensuite utiliser le Concepteur d'applications pour visualiser, définir, configurer et implémenter des applications. Vous pouvez utiliser le Concepteur de systèmes pour concevoir des systèmes d'applications. Pour plus d'informations, consultez Comment : ajouter des diagrammes d'application aux solutions et Comment : ajouter des diagrammes système aux solutions.

Les sections suivantes décrivent d'autres modifications qui effectuent une ingénierie à rebours d'éléments dans les solutions existantes. Ces sections décrivent également des éléments qui ne prennent pas en charge l'ingénierie à rebours :

Ingénierie à rebours dans les solutions existantes
Éléments non pris en charge pour l'ingénierie à rebours

Vous pouvez également mettre à niveau votre solution d'une version antérieure de Architecture Edition. Toutefois, cette version finale ne prend pas en charge les projets Visual J#. Pour plus d'informations, consultez Mise à niveau des versions antérieures d'Architecture Edition.

Ingénierie à rebours dans les solutions existantes

Après avoir ajouté un diagramme d'application à votre solution, Visual Studio effectue une ingénierie à rebours de certaines modifications apportées à votre solution ou à des projets dans votre solution. Le diagramme affiche ces modifications lorsqu'il est ouvert ou que vous le rouvrez :

Ajoutez un projet pour un type d'application pris en charge par le diagramme d'application.

Vous pouvez effectuer une ingénierie à rebours d'un projet pour un type d'application pris en charge par le diagramme d'application. Une forme de définition d'application pour ce projet apparaîtra sur le diagramme d'application.

Tenez compte des considérations suivantes lorsque vous effectuez une ingénierie à rebours de projets :
- Si vous n'avez pas de privilèges suffisants pour accéder à la métabase IIS, vous ne pouvez pas effectuez une ingénierie à rebours de projets Web ASP.NET sur le diagramme d'application.
- La propriété Framework cible sur une application d'ingénierie à rebours apparaîtra vide et en lecture seule. Vous pouvez afficher et modifier la version cible du .Net Framework dans les propriétés du projet. Par défaut, Visual Studio affecte au paramètre Framework cible de l'application résultante la valeur .NET Framework 3.5. Vérifiez ce paramètre et mettez-le à jour, si nécessaire. Tenez compte de certaines considérations si vous modifiez ce paramètre. Pour plus d'informations, consultez Comment : choisir la version du .NET Framework pour des applications.
- Si vous effectuez une ingénierie à rebours d'un projet Office, la propriété Template de l'application résultante apparaît vide et en lecture seule. Toutefois, le paramètre Version d'Office de l'application reflète la version d'Office utilisée par le projet. Pour plus d'informations, consultez Comment : modifier les modèles de projet d'applications.
- Le diagramme d'application se verrouille si l'Amélioration de Services Web (WSE) n'est pas installée, et si vous effectuez une ingénierie à rebours ou vous ouvrez un projet de service Web qui est activé avec les paramètres de l'Amélioration (WSE) des Services Web dans une solution qui contient un diagramme d'application.
  
  Pour résoudre cette condition, fermez le diagramme, installez WSE, puis rouvrez le diagramme. Pour plus d'informations, consultez Dépannage de diagrammes d'application.
Pour plus d'informations, consultez les rubriques suivantes :
- Comment : procéder à l'ingénierie à rebours des projets dans les solutions existantes.
- Éléments non pris en charge pour l'ingénierie à rebours
- Types et prototypes d'applications pour la définition d'applications
Ajoutez un service Web au projet pour une application ASP.NET sur le diagramme d'application.

Visual Studio ajoute un point de terminaison fournisseur de service Web .NET à la définition d'application ASP.NET correspondante sur le diagramme d'application. Visual Studio ajoute également au projet un fichier .asmx et un fichier de classe de service Web dans votre solution. Pour plus d'informations, consultez Vue d'ensemble des applications ASP.NET dans les diagrammes d'application.
Ajoutez une méthode Web à un fichier de classe de service Web dans un projet d'application ASP.NET.

Visual Studio ajoute une opération au point de terminaison fournisseur de service Web .NET correspondant sur la définition d'application ASP.NET sur le diagramme d'application. Vous pouvez ensuite afficher ou modifier l'opération dans la fenêtre Détails de service Web.

Pour plus d'informations, consultez les rubriques suivantes :
Ajoutez, changez ou supprimez la méthode Web, le service Web ou les propriétés ou attributs connexes WSDL dans le fichier de classe de service Web derrière un point de terminaison fournisseur de service Web sur une définition d'application ASP.NET.

Visual Studio met à jour l'opération correspondante et les propriétés appropriées dans la fenêtre Détails de service Web. Pour plus d'informations, consultez Comment : modifier des opérations pour les services Web ASP.NET.
Ajoutez, modifiez ou supprimez des entrées des fichiers de configuration d'applications.

Visual Studio met à jour les paramètres stockés dans les documents du modèle de définition de système (SDM) et dans l'Éditeur de paramètres et de contraintes. Pour plus d'informations, consultez Vue d'ensemble du modèle de définition de système (SDM) et Éditeur de paramètres et de contraintes.

Ajoutez les entrées au fichier de configuration d'un projet d'application pour les classes du proxy client de service Web personnalisées ou pour les bibliothèques de classes qui contiennent des références Web et des classes du proxy client de service Web personnalisées.

Une classe du proxy client de service Web personnalisée est une classe proxy que vous créez manuellement et qui n'est pas associée à une référence Web dans le projet d'application. Une définition d'application affiche un point de terminaison consommateur de service Web pour chaque référence Web ou classe proxy personnalisée uniquement lorsque vous ajoutez les entrées appropriées au fichier de configuration de l'application.

Remarque :
Si les points de terminaison fournisseurs de services Web .NET appropriés existent dans le diagramme d'application, les connexions apparaissent entre les points de terminaison consommateurs et les points de terminaison fournisseurs de services Web. Sinon, de nouveaux services Web externes apparaissent et se connectent aux points de terminaison consommateurs de services Web.

Pour plus d'informations, consultez les rubriques suivantes :

Ajoutez une référence Web à un projet d'application dans la solution.

Lorsque vous ajoutez une référence Web à un projet d'application, Visual Studio connecte cette application à un service Web ASP.NET existant ou à un service Web externe nouveau ou existant, selon que le diagramme d'application prend ou ne prend pas en charge ce type d'application et l'URL de service Web spécifiée par la référence Web.

Pour plus d'informations, consultez les rubriques suivantes :
- Comment : ajouter et supprimer des références Web
- Types et prototypes d'applications pour la définition d'applications
Ajoutez une connexion de base de données d'entrée au fichier de configuration d'une application.

Par exemple, vous pouvez ajouter une entrée de connexion de base de données au fichier Web.config pour une application ASP.NET ou au fichier App.config pour une application Microsoft Windows ou Office.

Visual Studio ajoute un point de terminaison consommateur de base de données à l'application dans le diagramme d'application. Vous pouvez ensuite connecter ce point de terminaison consommateur à une base de données externe existante ou à une nouvelle base de données externe que vous ajoutez au diagramme. Vous pouvez afficher ou modifier les paramètres de connexion de base de données à partir du point de terminaison consommateur de base de données. Pour plus d'informations, consultez Comment : configurer des connexions à des bases de données externes.

Éléments non pris en charge pour l'ingénierie à rebours

Le Concepteur d'applications a une prise en charge limitée ou nulle pour les éléments d'ingénierie à rebours des catégories suivantes :

Projets d'application
- Le Concepteur d'applications ne prend pas en charge la conception ou représentation directe de bibliothèques de classes.
  
  Vous pouvez utiliser un service Web ASP.NET comme façade pour la fonctionnalité implémentée par une bibliothèque de classes. Il vous est ainsi possible de représenter l'interaction entre une bibliothèque de classes référencée par une application ASP.NET et des applications qui prennent en charge l'implémentation dans le diagramme d'application. Pour plus d'informations, consultez Comment : référencer des bibliothèques de classes d'applications dans des diagrammes d'application. Vous pouvez également afficher des références Web aux services Web et les classes du proxy client de service Web personnalisées dans les bibliothèques de classes comme points de terminaison consommateur de service Web en ajoutant les entrées appropriées au fichier de configuration de l'application consommateur. Pour plus d'informations, consultez Classes de proxy clientes de références Web et de service Web personnalisé dans les bibliothèques de classes.
- Le Concepteur d'applications ne prend pas en charge l'ingénierie à rebours pour les projets de site Web basés sur FTP ou Microsoft SharePoint. Le Concepteur d'applications prend en charge l'ingénierie à rebours uniquement pour les projets de site Web qui s'exécutent sur Internet Information Services (IIS) ou un serveur du développement ASP.NET.

Services Web ASP.NET

Les définitions de classe de service Web qui sont définies en ligne dans les fichiers .asmx.

La fenêtre Détails de service Web n'affiche pas les opérations correspondantes pour les méthodes Web associées à un service Web ASP.NET si ces méthodes ne sont pas déclarées pleinement par une définition de classe unique dans un fichier de code séparé ou fichier "code-behind." Vous pouvez tout de même afficher le service Web en tant que point de terminaison fournisseur de services Web .NET sur une application ASP.NET et y connecter des applications consommateurs. Cependant, le point de terminaison fournisseur de services Web .NET s'affiche avec une icône d'avertissement (!). Pour plus d'informations, consultez Dépannage de diagrammes d'application.

Remarque :
Le fichier code-behind est un fichier de classe spécifique au langage de programmation qui existe généralement dans le dossier code d'application du projet associé à l'application ASP.NET.

Méthodes Web qui sont déclarées par les attributs sur les méthodes d'une interface implémentées par une classe de service Web.

- ou -

Une classe étend une classe de base qui définit des méthodes Web.

Dans ces scénarios, la fenêtre Détails de service Web affiche uniquement les opérations qui correspondent aux méthodes Web déclarées dans la classe référencée par le fichier .asmx. En dépit du fait que la fenêtre Détails de service Web n'affiche pas toutes les opérations de service Web, le point de terminaison fournisseur de service Web .NET apparaît tout de même correctement sur l'application ASP.NET tant que le fichier .asmx existe dans le projet d'application. De plus, les connexions au point de terminaison de service Web sont également implémentées et configurées correctement.

Code qui définit un service Web qui contient plusieurs liaisons.

Si un fichier code-behind définit un service Web dont les méthodes Web comportent des liaisons différentes, la fenêtre Détails de service Web affiche uniquement les opérations associées à la première liaison.

Remarque :
L'attribut WebServiceBinding déclare des liaisons au niveau du service Web. Vous pouvez définir l'attribut SoapDocumentMethod ou SoapRPCMethod pour qu'il utilise ces liaisons au niveau de la méthode Web. Pour plus d'informations, visitez MSDN Library en ligne.

Les fichiers WSDL qui contiennent plusieurs liaisons WSDL ou des fichiers DISCO qui référencent plusieurs services Web.

Les Concepteurs de systèmes distribués prennent en charge uniquement les fichiers WSDL qui contiennent des liaisons WSDL uniques et des fichiers DISCO qui référencent des services Web uniques.