Umbenennen eines Projekts in Azure DevOps

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 – TFS 2015

Erfahren Sie, wie Sie ein Projekt umbenennen. Wenn Sie ein Projekt umbenennen, wird der Projektname in den folgenden Bereichen aktualisiert:

  • Versionskontrollpfade
  • Arbeitsaufgaben
  • Abfragen
  • andere Projektartefakte

Projekte können mehrmals umbenannt werden, und ältere Namen können wiederverwendet werden. Nach dem Umbenennen gibt es möglicherweise einige erforderliche Teammitgliedsaktionen.

Warnung

Durch das Umbenennen eines Projekts werden E-Mail-Benachrichtigungen an alle Benutzer im Projekt gesendet, wenn weniger als 1.000 Benutzer vorhanden sind. Wenn ihr Projekt mehr als 1.000 Benutzer enthält, erhalten nur Projektsammlungsadministratoren E-Mail-Benachrichtigungen.

Voraussetzungen

Sie müssen Mitglied der Gruppe Projektauflistungsadministratoren sein. Als Organisationsbesitzer werden Sie automatisch der Gruppe Project Sammlungsadministratoren hinzugefügt. Wenn Sie kein Mitglied sind, können Sie jetzt hinzugefügt werden. Weitere Informationen finden Sie unter Festlegen von Berechtigungen auf Projekt- oder Sammlungsebene.

Sie müssen Mitglied der Gruppe Projektauflistungsadministratoren sein. Wenn Sie kein Mitglied sind, können Sie jetzt hinzugefügt werden. Weitere Informationen finden Sie unter Festlegen von Berechtigungen auf Projekt- oder Sammlungsebene.

Sie müssen Mitglied der Gruppe Projektauflistungsadministratoren sein. Wenn Sie kein Mitglied sind, können Sie jetzt hinzugefügt werden. Weitere Informationen finden Sie unter Festlegen von Berechtigungen auf Projekt- oder Sammlungsebene.

Sie benötigen die Berechtigung Informationen auf Projektebene bearbeiten für ein Projekt, um es umzubenennen.

Umbenennen eines Projekts

  1. Melden Sie sich bei Ihrer Organisation () an, https://dev.azure.com/{yourorganization} und öffnen Sie dann das Projekt, das Sie umbenennen möchten.

  2. Wählen Sie Project Einstellungen > Übersicht aus, geben Sie einen neuen Namen ein, und wählen Sie Speichern aus.

    Geben Sie einen neuen Namen ein, und wählen Sie dann Speichern aus, um Ihr Projekt umzubenennen.

  3. Um die Umbenennung zu bestätigen, geben Sie den neuen Projektnamen ein, aktivieren Sie das Kontrollkästchen neben "Ich kann die Konsequenzen der Umbenennung dieses Projekts verstehen", und wählen Sie dann Speichern aus.

    Geben Sie einen neuen Projektnamen ein, aktivieren Sie das Kontrollkästchen, und speichern Sie es.

    Ihr Projekt wird umbenannt.

  1. Melden Sie sich bei Ihrer Organisation an.

  2. Wählen Sie auf der Seite Projekte Aktionen für das Projekt aus, das Sie umbenennen möchten, und wählen Sie dann Umbenennen aus.

    Wählen Sie Umbenennen aus.

  3. Bearbeiten Sie den Namen.

    Geben Sie einen neuen Projektnamen ein.

    Wenn das Dialogfeld Project umbenennen nicht angezeigt wird, sind Sie kein Mitglied der Gruppe Project Administratoren für dieses bestimmte Projekt. Erfahren Sie, wie Sie der Gruppe Project Administratoren hinzugefügt werden.

  1. Melden Sie sich bei Ihrer Organisation an.

  2. Öffnen Sie auf der Registerkarte Übersicht das Menü für das Projekt, das Sie umbenennen möchten, und wählen Sie dann Umbenennen aus.

    Klicken Sie auf Umbenennen.

  3. Bearbeiten Sie den Namen.

    Geben Sie einen neuen Projektnamen ein.

    Wenn das Dialogfeld Project umbenennen nicht angezeigt wird, sind Sie kein Mitglied der Gruppe Project Administratoren für dieses bestimmte Projekt. Erfahren Sie, wie Sie der Gruppe Project Administratoren hinzugefügt werden.

Erforderliche Benutzeraktionen für die Arbeit mit dem umbenannten Projekt

Jeder Benutzer in Ihrem Team muss seine Clients neu starten und andere Aktionen basierend auf den verwendeten Features ausführen.

Neustarten Ihrer Clients

Geöffnete Clients behalten einen Cache aller Projektnamen im Arbeitsspeicher bei, dieser Cache wird jedoch nicht automatisch gelöscht, nachdem ein Projekt umbenannt wurde. Um den Cache zu löschen, starten Sie den Client neu, damit er den neuen Projektnamen auffüllt. Wenn Sie den Client nicht neu starten, tritt bei Vorgängen, die den zwischengespeicherten Projektnamen verwenden, ein Fehler auf, und es wird eine Ausnahme vom Projekt nicht gefunden.

Speichern Sie für die folgenden Clients Ihre Arbeit in jedem , und starten Sie dann neu:

  • Visual Studio/Team Explorer

  • Eclipse, wenn Ihr Team das Team Explorer Everywhere-Plug-In verwendet

  • Microsoft Excel, PowerPoint oder Project, wenn Ihr Team die Team Foundation Server-Erweiterung für diese Office Produkte verwendet

  • Weitere Clients, die das .NET Team Foundation Server Clientobjektmodell verwenden

Aktualisieren Ihrer Git-Remotes

Wenn Ihr Projekt Git verwendet, müssen Ihre Remoteverweise für jedes Repository aus dem umbenannten Projekt aktualisiert werden. Diese Updates sind erforderlich, da die Remote-Repository-URL das Projekt und den Repositorynamen enthält. Git verwendet Remoteverweise, um Änderungen zwischen Ihrem lokalen Repository und der Remoteversion abzurufen und zu pushen, die auf dem Server gespeichert ist. Jedes Mitglied Ihres Teams muss seine lokalen Git-Repositorys aktualisieren, um die Verbindung von den Entwicklungscomputern aus fortzusetzen.

Weitere Informationen zum Aktualisieren Ihrer Git-Remotes finden Sie unter Aktualisieren der Git-Remotes auf Ihren Entwicklungscomputern.

Aktualisieren Ihrer TFVC-Serverarbeitsbereiche

Wenn Ihr Projekt TFVC mit Serverarbeitsbereichenverwendet, müssen diese Arbeitsbereiche mit dem neuen Projektnamen aktualisiert werden. Führen Sie für die folgenden Clients einen Get- oder Check-In aus, und dann wird die Arbeitsbereichszuordnung korrigiert, um den neuen Projektnamen zu verwenden:

  • Visual Studio 2015 (RC oder neuer)
  • Visual Studio 2013
  • Visual Studio 2012
  • Visual Studio 2010 (unterstützt nur Serverarbeitsbereiche)
  • Team Explorer Everywhere (2012 oder höher)

Quellcodeverwaltungs-Explorer, aktuelle Version abrufen

Aktualisieren Ihrer lokalen TFVC-Arbeitsbereiche

Wenn Ihr Team TFVC mit lokalen Arbeitsbereichenverwendet, müssen diese Arbeitsbereiche mit dem neuen Projektnamen aktualisiert werden. Führen Sie für die folgenden Clients einen Get- oder Check-In aus, und die Arbeitsbereichszuordnung wurde korrigiert, um den neuen Projektnamen zu verwenden:

Es wird empfohlen, Ihre Clients nach Möglichkeit auf das neueste Update oder Release zu aktualisieren. Für alle anderen unterstützten Visual Studio Versionen müssen Sie einen neuen lokalen Arbeitsbereich erstellen, der dem neuen Projektnamen zugeordnet ist. Zwei Ausnahmen sind Visual Studio 2010, die nur Serverarbeitsbereiche unterstützt, und Team Foundation Server Plug-In für Eclipse.

  1. Legen Sie Die Änderungen auf einen Schieberab.

  2. Erstellen Sie einen neuen Arbeitsbereich, der dem neuen Projektnamen zugeordnet ist.

  3. Schränken Sie Ihre Änderungen ein.

Lokale Arbeitsbereiche werden lokal und nicht auf dem Server verwaltet. Ältere Clients ohne die aktualisierte Umbenennungslogik können lokale Arbeitsbereiche nicht auf den neuen Projektnamen aktualisieren.

Aktualisieren Ihrer Team Foundation Server SharePoint- und Berichtsintegrationen (lokal)

Sowohl SharePoint als auch Reporting Services Integrationen funktionieren weiterhin, aber einige Berichte funktionieren nicht wie erwartet, bis der neue Projektname aufgefüllt wird. Der alte Projektname ist immer noch vorhanden, bis Caches mit dem neuen Namen aktualisiert werden. Der Berichts- und SharePoint Serveradministrator kann diese Aufträge manuell ausführen, um den neuen Namen sofort aufzufüllen.

  • Wenn Ihr Team Berichte verwendet, geben sie die neuen Namen nach der Ausführung des nächsten inkrementellen Analyseauftrags für das Data Warehouse an. Standardmäßig wird der Auftrag alle zwei Stunden ausgeführt. Sie können die Warehouseaufträge und den inkrementellen Analyseauftragjedoch manuell ausführen. Anschließend wird der neue Name mit dem Warehouse synchronisiert, und Berichte verwenden den neuen Namen. Berichte funktionieren nicht wie erwartet, bis die Aufträge ausgeführt wurden.

  • Wenn Ihr Team SharePoint Integration verwendet und über benutzerdefinierte Abfragen oder Webparts verfügt, die direkt auf den Projektnamen verweisen, aktualisieren Sie den Namen in jedem in den neuen Projektnamen. Sie müssen keine Standardabfragen und Webparts aktualisieren, da sie weiterhin funktionieren. Die Verwendung von @project funktioniert auch nach dem Umbenennen eines Projekts weiterhin und muss ebenfalls nicht aktualisiert werden.

  • Excel Berichte und Excel Webparts in MOSS zeigen erst dann die richtigen Daten an, wenn Sie Folgendes ausführen.

    1. Warehouseauftrag: Führen Sie die Warehouseaufträge aus, damit Excel Berichte die richtigen Daten enthalten. Wenn der neue Projektname nicht mit dem Warehouse synchronisiert wird, zeigen Excel Berichte nicht die richtigen Daten an. Um dieses Ergebnis zu vermeiden, führen Sie Manuell Warehouse-Aufträge aus.

    2. SharePoint Zeitgeberauftrag: Führen Sie den Auftrag "Team Foundation Server Dashboardupdate" vom SharePoint zentralen Administrator aus, um Excel Webparts auf dem Dashboard zu aktualisieren. Standardmäßig wird sie alle 30 Minuten ausgeführt. Bis dieser Auftrag ausgeführt wird, funktionieren die Excel Webparts auf dem Dashboard und die Berichte, die direkt aus dem Berichtsordner stammen, nicht. Diese Webparts verwenden entweder den falschen Projektnamen oder den falschen Berichtsordner.

    3. SharePoint Cache: Löschen Sie den SharePoint Cache manuell, um veraltete Daten wie Berichtsordnerspeicherorte zu vermeiden, die in den Dashboards angezeigt werden. Standardmäßig löscht dieser Cache etwa jede Stunde. Sie können auch einen TFS-spezifischen Cache löschen, indem Sie die TFS-Umleitungs-URL verwenden und einen Clearcache-Parameter angeben. Beispiel:

      http://<SharePointServer>/sites/<TeamProjectCollectionName>/<TeamProjectName>/_layouts/TfsRedirect.aspx?tf:type=Report&tf:clearcache=1
      

Ergebnisse des Umbenennungsvorgangs

  • Arbeitselement-IDs sind in der Organisation eindeutig. Die URL funktioniert weiterhin sowohl für den neuen Teamnamen als auch für den alten Teamnamen. Diese Funktionalität ist vorgesehen, um Breaking Links zu vermeiden.

  • Solange das Projekt in der URL ein gültiges Projekt in der Organisation ist, wird die angegebene Arbeitselement-ID angezeigt. Das folgende Beispiel zeigt eine Organisation mit Projekten namens "Example1" und "Example2".

    https://dev.azure.com/MyOrg/Example1/_workitems/edit/40/ – Zeigt Arbeitselement 40 an – https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/ Zeigt Arbeitselement 40 an – https://dev.azure.com/MyOrg/Potato/_workitems/edit/40/ Zeigt einen 404-Fehler an.

  • Arbeitselementlinks laufen nicht ab.

  • Der alte Projektname kann erneut verwendet werden.