Documents modèles de définition de système (SDM) sous contrôle de code source
Dans les concepteurs de systèmes distribués, les diagrammes de systèmes distribués, tels que le diagramme d'application ou les diagrammes système, ont une portée limitée au niveau de la solution, tandis que les documents modèles de définition de système (SDM), tels que les fichiers de définition d'application (.sdm), peuvent avoir une portée limitée au niveau du projet. Vous pouvez archiver ces fichiers dans le contrôle de code source et les extraire comme tout autre fichier. Toutefois, tenez compte des points suivants concernant la façon dont ces documents interagissent avec le contrôle de code source, surtout lorsque vous les synchronisez.
Pour plus d'informations, consultez les rubriques suivantes :
Les sections suivantes contiennent des informations supplémentaires sur le mode d'interaction des documents SDM avec le contrôle de code source :
Extraction de versions locales par rapport à des versions serveur
Ajout de documents SDM ou de certains fichiers projet à partir d'une solution partagée
Synchronisation sous contrôle de code source
Extraction de versions locales par rapport à des versions serveur
En fonction de vos paramètres de contrôle de code source, vous pouvez choisir d'extraire une version locale ou une version serveur d'un fichier. Toutefois, les documents SDM ne prennent pas en charge le rechargement pendant la synchronisation. Par conséquent, si vous apportez des modifications à des fichiers alors qu'ils sont archivés, puis extrayez la version serveur de ces fichiers, ceux-ci peuvent ne plus être synchronisés avec la solution s'ils sont en cours de rechargement. Par exemple, si vous utilisez l'intégration du contrôle de code source Microsoft FrontPage avec des projets Web générés par le Concepteur d'applications, les modifications apportées à ces projets peuvent être exclues silencieusement de la synchronisation s'ils sont en cours de rechargement.
Conseil
Pour éviter cette condition, extrayez le fichier avant toute opération nécessitant le rechargement du fichier ou définissez vos options de commande de code source de manière à toujours extraire la version locale du fichier.
Ajout de documents SDM ou de certains fichiers projet à partir d'une solution partagée
Si vous utilisez le contrôle de code source Team Foundation et souhaitez ajouter un document SDM ou certains fichiers projet, tels que les fichiers de code, d'une autre solution à votre solution, vous ne serez pas en mesure d'utiliser la boîte de dialogue Ouvrir à partir du contrôle de code source pour ajouter l'élément à votre solution. Cette boîte de dialogue n'affiche pas l'option pour que vous puissiez choisir parmi tous les fichiers ou sélectionner un élément avec une extension de fichier SDM ou certaines autres extensions de fichier projet, telles que les extensions de fichier de code. Pour plus d'informations, consultez Comment : ouvrir des projets et des solutions à partir du contrôle de code source.
Pour ajouter ces fichiers à votre solution, consultez Comment : ajouter des documents SDM et des fichiers projet à partir de solutions partagées sous contrôle de code source.
Synchronisation sous contrôle de code source
Lorsque certaines définitions d'application sur le diagramme d'application sont implémentées, un projet d'application est généré pour chacune de ces définitions. Le projet contient des fichiers tels que les fichiers de code, les fichiers de configuration (.config) et un fichier .sdm. Ce fichier .sdm est un document SDM qui contient les métadonnées sur la définition d'application.
Lorsque vous apportez des modifications au diagramme d'application, ou aux fichiers de code ou .config associés à un projet, le diagramme d'application et tous les fichiers .sdm doivent être mis à jour. Une fois une application implémentée, le code devient la définition maître, bien que le code et les diagrammes se synchronisent entre eux. Si le diagramme d'application est ouvert, Visual Studio tente de synchroniser immédiatement ces modifications. Par exemple, l'ajout d'une définition de service Web et d'un fichier .asmx au projet d'une application ASP.NET ou l'apport de modifications sur le diagramme d'application qui affecte les fichiers .sdm déclenche la synchronisation. Pour plus d'informations, consultez Synchronisation dans les documents modèles de définition de système (SDM).
Scénarios qui requièrent ou non l'extraction pour la synchronisation
Selon le scénario, l'extraction peut être requise ou non pendant la synchronisation. Si tous les fichiers requis pour la synchronisation, tels que le fichier de diagramme d'application (.ad) ou les fichiers .sdm, sont archivés dans le contrôle de code source Visual Studio, Visual Studio extrait les fichiers requis automatiquement ou vous invite à les extraire, en fonction de la définition des paramètres utilisateur de contrôle de code source.
Notes
Une ou plusieurs invites d'extraction peuvent s'afficher selon le nombre de fichiers requis.
Par exemple, si votre solution contient un fichier de diagramme d'application (.ad) et que vous ajoutez un ou plusieurs projets (précédemment générés pour les applications sur le diagramme d'application) à la solution du contrôle de code source, Visual Studio extrait automatiquement les fichiers .sdm dans ces projets ou vous invite à les extraire. N'annulez pas l'extraction car le diagramme d'application sera verrouillé si le diagramme est ouvert ou lors de sa prochaine ouverture. Pour plus d'informations, consultez Annulation de l'extraction et Dépannage de diagrammes d'application.
Conseil
Lorsque vous avez fini d'utiliser des documents SDM tels que des fichiers .sdm, archivez-les afin que d'autres utilisateurs puissent les extraire, par exemple, lorsqu'ils souhaitent ajouter des projets avec des fichiers .sdm à des solutions contenant des fichiers de diagramme d'application.
Les paramètres qui représentent des entrées dans les fichiers de configuration (.config) sont stockés dans les fichiers .sdm et les fichiers .config, même après l'implémentation. Par conséquent, les modifications que vous apportez aux paramètres (ou contraintes) à l'aide de l'Éditeur de paramètres et de contraintes ou aux paramètres dans un fichier .config, qui sont aussi représentés dans le fichier .sdm, nécessitent l'extraction du diagramme d'application et du fichier .sdm. Pour plus d'informations, consultez Application des paramètres.
Par contre, lorsqu'une application ASP.NET avec un service Web est implémentée, les opérations de services Web sont définies par le fichier de classe de services Web et ne sont plus représentées dans le fichier de diagramme d'application (.ad). Par conséquent, les modifications que vous apportez aux opérations de service Web à l'aide de la fenêtre Détails de service Web ou directement dans le code ne nécessitent pas l'extraction du diagramme d'application puisque ces modifications affectent le fichier de classe de service Web. Pour plus d'informations, consultez Vue d'ensemble des applications ASP.NET dans les diagrammes d'application.
Annulation de l'extraction
Vous pouvez choisir d'annuler l'extraction lorsque vous y êtes invité ; toutefois, l'annulation de l'extraction empêche Visual Studio de synchroniser les fichiers nécessaires. Selon les modifications qui exigeaient une extraction, les résultats suivants peuvent se produire :
Les modifications apportées par le biais du concepteur seront restaurées. La modification initiale et toutes les modifications suivantes sont restaurées.
Les modifications apportées au code ou aux fichiers de configuration ne peuvent pas être restaurées.
Le fichier du diagramme d'application (.ad) sera verrouillé et apparaîtra dans un état en lecture seule. Une erreur apparaît dans la fenêtre Liste d'erreurs qui indique que la synchronisation n'a pas pu être effectuée. L'état en lecture seule du diagramme d'application indique qu'il ne peut pas se synchroniser avec les fichiers projet associés et qu'il peut contenir des informations désynchronisées.
Pour résoudre cette condition, fermez le diagramme, annulez les modifications qui n'ont pas été restaurées et rouvrez le diagramme, ce qui provoque une tentative de synchronisation du diagramme. Pour plus d'informations, consultez Dépannage de diagrammes d'application.
Si le diagramme d'application est archivé dans le contrôle de code source, la synchronisation du diagramme exigera son extraction. Toutefois, si le contrôle de code source est défini de manière à extraire la version serveur du diagramme, le diagramme doit être rechargé. Les documents SDM ne prenant pas en charge le rechargement pendant la synchronisation, le diagramme ne peut pas être extrait. Si le diagramme d'application ne peut pas être extrait, il ne peut pas être synchronisé et sera verrouillé. Pour résoudre un diagramme d'application verrouillé, vous pouvez fermer et rouvrir le diagramme, ce qui provoque une tentative de synchronisation du diagramme.
Pour éviter cette condition, extrayez le fichier avant toute opération nécessitant le rechargement du fichier ou définissez vos options de commande de code source de manière à toujours extraire la version locale du fichier.
Obtention de la dernière version de documents SDM
Si vous obtenez la dernière version d'un document SDM pendant que le fichier du diagramme d'application (.ad) est ouvert, le diagramme est verrouillé et apparaît en lecture seule. Cette opération nécessite le rechargement du diagramme d'application et risque de désynchroniser ces fichiers. Pour plus d'informations, consultez Dépannage de diagrammes d'application.
Pour résoudre un diagramme d'application verrouillé, fermez le diagramme, puis rouvrez-le.
Voir aussi
Référence
Extraction et modifications simultanées des documents modèles de définition de système (SDM)
Autres ressources
Documentation Visual SourceSafe
Documentation Team Foundation
Vue d'ensemble du concepteur de systèmes distribués