SDM-Dokumente (System Definition Model) unter Quellcodeverwaltung
Aktualisiert: November 2007
In den Designern für verteilte Systeme umfasst der Gültigkeitsbereich verteilter Systemdiagramme, z. B. des Anwendungsdiagramms oder der Systemdiagramme, die jeweilige Projektmappe, während der Gültigkeitsbereich von SDM (System Definition Model)-Dokumenten, z. B. Anwendungsdefinitionsdateien (.sdm), die Projektebene umfasst. Sie können diese Dateien wie jede andere Datei in die Quellcodeverwaltung einchecken und aus ihr auschecken. Beachten Sie jedoch die folgenden Hinweise zur Interaktion dieser Dokumente mit der Quellcodeverwaltung, insbesondere beim Synchronisieren der Dokumente.
Weitere Informationen finden Sie unter den folgenden Themen:
Die folgenden Abschnitte enthalten weitere Informationen über die Interaktion von SDM-Dokumenten mit der Quellcodeverwaltung:
Auschecken von lokalen Versionen oder Serverversionen
Hinzufügen von SDM-Dokumenten oder bestimmten Projektdateien von einer freigegebenen Projektmappe
Synchronisierung unter der Quellcodeverwaltung
Auschecken von lokalen Versionen oder Serverversionen
Je nach den Einstellungen für die Quellcodeverwaltung können Sie eine lokale Version oder eine Serverversion einer Datei auschecken. SDM-Dokumente unterstützen jedoch nicht das erneute Laden während der Synchronisierung. Daher kann das Ändern von Dateien, während sie eingecheckt sind, und das anschließende Auschecken der Serverversion dieser Dateien verhindern, dass sie mit der Projektmappe synchronisiert werden, falls sie gerade erneut geladen werden. Wenn Sie zum Beispiel die Einbindung der Quellcodeverwaltung von Microsoft FrontPage für vom Anwendungs-Designer generierte Webprojekte verwenden, werden Änderungen dieser Projekte möglicherweise ohne entsprechenden Hinweis von der Synchronisierung ausgeschlossen, falls sie gerade neu geladen werden.
.gif "Tipp") Tipp: |
|---|
Um dieses Problem zu vermeiden, checken Sie die Datei vor Operationen aus, die ein erneutes Laden der Datei erfordern, oder legen Sie die Optionen der Quellcodeverwaltung so fest, dass immer die lokale Version der Datei ausgecheckt wird. |
Hinzufügen von SDM-Dokumenten oder bestimmten Projektdateien von einer freigegebenen Projektmappe
Wenn Sie Team Foundation-Versionskontrolle verwenden und ein SDM-Dokument oder bestimmte Projektdateien (z. B. Codedateien) aus einer anderen Projektmappe Ihrer Projektmappe hinzufügen möchten, können Sie über das Dialogfeld Aus Quellcodeverwaltung öffnen das Element nicht der Projektmappe hinzufügen. Das Dialogfeld zeigt nicht die Option an, aus allen Dateien auszuwählen oder ein Element mit einer SDM-Dateierweiterung oder bestimmten anderen Dateierweiterungen von Projektdateien (z. B. Erweiterungen von Codedateien) auszuwählen. Weitere Informationen finden Sie unter Gewusst wie: Öffnen von Projektmappen und Projekten aus der Versionskontrolle.
Informationen zum Hinzufügen dieser Dateien zur Projektmappe finden Sie unter Gewusst wie: Hinzufügen von SDM-Dokumenten und Projektdateien von freigegebenen Projektmappen unter der Quellcodeverwaltung.
Synchronisierung unter der Quellcodeverwaltung
Beim Implementieren bestimmter Anwendungsdefinitionen im Anwendungsdiagramm wird für jede dieser Definitionen ein Anwendungsprojekt generiert. Das Projekt enthält z. B. Codedateien, Konfigurationsdateien (.config) und eine SDM-Datei. Die SDM-Datei ist ein SDM-Dokument, das Metadaten zur Anwendungsdefinition enthält.
Wenn Sie das Anwendungsdiagramm, einem Projekt zugeordneten Code oder einem Projekt zugeordnete CONFIG-Dateien ändern, müssen das Anwendungsdiagramm und ggf. vorhandene SDM-Dateien aktualisiert werden. Nach der Implementierung einer Anwendung ist der Code die Masterdefinition, obwohl Code und Diagramme miteinander synchronisiert werden. Wenn das Anwendungsdiagramm geöffnet ist, versucht Visual Studio, diese Änderungen sofort zu synchronisieren. Beispielsweise wird durch das Hinzufügen einer Webdienstdefinition und einer ASMX-Datei zum Projekt einer ASP.NET-Anwendung oder durch Änderungen des Anwendungsdiagramms, die sich auf SDM-Dateien auswirken, die Synchronisierung ausgelöst. Weitere Informationen finden Sie unter Synchronisierung zwischen SDM (System Definition Model)-Dokumenten.
Szenarien, die das Auschecken für die Synchronisierung erfordern, und Szenarien, die kein Auschecken für die Synchronisierung erfordern
Je nach Szenario kann das Auschecken während der Synchronisierung erforderlich oder nicht erforderlich sein. Wenn für die Synchronisierung erforderliche Dateien, zum Beispiel die AD-Datei für das Anwendungsdiagramm oder SDM-Dateien, in die Quellcodeverwaltung von Visual Studio eingecheckt werden, checkt Visual Studio je nach den Benutzereinstellungen der Quellcodeverwaltung die erforderlichen Dateien entweder automatisch aus oder fordert Sie auf, diese Dateien auszuchecken.
| Hinweis: |
|---|
Je nach der Anzahl erforderlicher Dateien werden ein oder mehrere Aufforderungen zum Auschecken angezeigt. |
Wenn die Projektmappe beispielsweise ein Anwendungsdiagramm (AD-Datei) enthält und über die Quellcodeverwaltung Projekte (die zuvor für Anwendungen im Anwendungsdiagramm generiert wurden) zur Projektmappe hinzugefügt werden, checkt Visual Studio entweder die SDM-Dateien in diesen Projekten automatisch aus oder fordert Sie zum Auschecken auf. Sie sollten das Auschecken nicht abbrechen, da das Anwendungsdiagramm gesperrt wird, wenn es geöffnet ist oder das nächste Mal geöffnet wird. Weitere Informationen finden Sie unter Abbrechen des Auscheckens und Problembehandlung bei Anwendungsdiagrammen.
| Tipp: |
|---|
Wenn Sie Ihre Arbeit an SDM-Dokumenten wie SDM-Dateien beenden, sollten Sie diese einchecken, damit andere Benutzer sie auschecken können, um beispielsweise Projektmappen, die Anwendungsdiagrammdateien enthalten, Projekte mit SDM-Dateien hinzuzufügen. |
Einstellungen, die Einträge in Konfigurationsdateien (.config) darstellen, werden sowohl in SDM-Dateien als auch in CONFIG-Dateien gespeichert, auch nach der Implementierung. Daher erfordern Änderungen, die Sie mit dem Einstellungs- und Einschränkungs-Editor oder in einer CONFIG-Datei an Einstellungen (oder Einschränkungen) vornehmen, die auch in der SDM-Datei dargestellt werden, das Auschecken der Anwendungsdiagramm- und SDM-Datei. Weitere Informationen finden Sie unter Anwenden von Einstellungen.
Wenn hingegen eine ASP.NET-Anwendung mit einem Webdienst implementiert ist, werden Webdienstoperationen von der Webdienstklassendatei definiert und nicht mehr in der Anwendungsdiagrammdatei (.ad) dargestellt. Daher erfordern Änderungen, die Sie im Fenster Webdienstdetails oder direkt im Code an Webdienstoperationen vornehmen, kein Auschecken des Anwendungsdiagramms, da sich diese Änderungen auf die Webdienstklassendatei auswirken. Weitere Informationen finden Sie unter Übersicht über ASP.NET-Anwendungen in Anwendungsdiagrammen.
Abbrechen des Auscheckens
Sie können das Auschecken abbrechen, wenn Sie dazu aufgefordert werden. Jedoch verhindert der Abbruch des Auscheckens das Synchronisieren der erforderlichen Dateien durch Visual Studio. Je nach den Änderungen, die das Auschecken erforderlich machten, bewirkt das Abbrechen des Auscheckens möglicherweise Folgendes:
Für Änderungen, die über den Designer erfolgt sind, wird ein Rollback ausgeführt. Für die ursprüngliche Änderung und alle folgenden Änderungen wird ein Rollback ausgeführt.
Für Änderungen von Code oder Konfigurationsdateien kann kein Rollback ausgeführt werden.
Die Anwendungsdiagrammdatei (.ad) wird gesperrt und einem schreibgeschützten Zustand angezeigt. Im Fenster Fehlerliste wird eine Fehlermeldung angezeigt, die angibt, dass die Synchronisierung nicht abgeschlossen werden konnte. Der schreibgeschützte Zustand des Anwendungsdiagramms gibt an, dass es nicht mit den zugeordneten Projektdateien synchronisiert werden kann und möglicherweise nicht synchronisierte Informationen enthält.
Um diese Bedingung aufzulösen, schließen Sie das Diagramm, machen Sie alle Änderungen rückgängig, für die kein Rollback ausgeführt wurde, und öffnen Sie das Diagramm erneut, um das Diagramm zu synchronisieren. Weitere Informationen finden Sie unter Problembehandlung bei Anwendungsdiagrammen.
Code wird möglicherweise nicht kompiliert, und es könnten Buildfehler auftreten.
Wenn das Anwendungsdiagramm in die Quellcodeverwaltung eingecheckt ist, muss es zum Synchronisieren des Diagramms ausgecheckt werden. Wenn jedoch für die Quellcodeverwaltung das Auschecken der Serverversion des Diagramms festgelegt ist, muss das Diagramm neu geladen werden. Da SDM-Dokumente das erneute Laden während der Synchronisierung nicht unterstützen, kann das Diagramm nicht ausgecheckt werden. Wenn das Auschecken des Anwendungsdiagramms nicht möglich ist, kann es nicht synchronisiert werden und wird gesperrt. Um die Sperre eines Anwendungsdiagramms aufzuheben, können Sie das Diagramm schließen und erneut öffnen und das Diagramm auf diese erneut zu synchronisieren versuchen.
Um dieses Problem zu vermeiden, checken Sie die Datei vor Operationen aus, die ein erneutes Laden der Datei erfordern, oder legen Sie die Optionen der Quellcodeverwaltung so fest, dass immer die lokale Version der Datei ausgecheckt wird.
Abrufen der neuesten Version von SDM-Dokumenten
Beim Abrufen der neuesten Version eines SDM-Dokuments, während die Anwendungsdiagrammdatei (AD-Datei) geöffnet ist, wird das Diagramm gesperrt und befindet sich dann scheinbar in einem schreibgeschützten Zustand. Aufgrund dieser Operation muss das Anwendungsdiagramm erneut geladen werden. Möglicherweise sind diese Dateien auch nicht mehr synchron. Weitere Informationen finden Sie unter Problembehandlung bei Anwendungsdiagrammen.
Um die Sperre eines Anwendungsdiagramms aufzuheben, schließen Sie das Diagramm, und öffnen Sie es dann erneut.
Siehe auch
Referenz
Gleichzeitiges Auschecken und Durchführen von Änderungen an SDM (System Definition Model)-Dokumenten