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

Wenn Sie ein Projekt umbenennen, werden E-Mail-Benachrichtigungen an alle Benutzer im Projekt gesendet, wenn weniger als 1.000 Benutzer zur Verfügung stehen. Wenn ihr Projekt mehr als 1.000 Benutzer umfasst, erhalten nur Projektsammlungsadministratoren E-Mail-Benachrichtigungen.

Voraussetzungen

Sie müssen Mitglied der Gruppe Projektauflistungsadministratoren sein. Wenn Sie der Organisationsbesitzer sind, 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 müssen über die Berechtigung Informationen auf Projektebene bearbeiten für ein Projekt verfügen, um es umzubenennen.

Umbenennen eines Projekts

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

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

    Enter a new name, and then select Save to rename your project

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

    Enter new project name, check the box, and then save

    Ihr Projekt wurde 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.

    Choose Rename.

  3. Bearbeiten Sie den Namen.

    Enter a new project name

    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.

    Choose Rename.

  3. Bearbeiten Sie den Namen.

    Enter a new project name

    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 basierend auf den features, die er verwendet, andere Aktionen ausführen.

Starten Sie Ihre Clients neu.

Geöffnete Clients behalten einen Cache aller Projektnamen im Arbeitsspeicher, aber dieser Cache wird nach dem Umbenennen eines Projekts nicht automatisch gelöscht. 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, können Vorgänge, die den zwischengespeicherten Projektnamen verwenden, nicht mit einer Ausnahme vom Projekt nicht gefunden werden.

Speichern Sie ihre Arbeit für die folgenden Clients in jedem, und starten Sie 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 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 Remoterepository-URL das Projekt und den Repositorynamen enthält. Git verwendet Remoteverweise zum Abrufen und Übertragen von Änderungen zwischen Ihrem lokalen Repository und der Remoteversion, die auf dem Server gespeichert ist. Jedes Mitglied Ihres Teams muss seine lokalen Git-Repositorys aktualisieren, um die Verbindung von seinen Entwicklungscomputern aus fortsetzen zu können.

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 Serverarbeitsräumen verwendet,müssen diese Arbeitsbereiche mit dem neuen Projektnamen aktualisiert werden. Führen Sie für die folgenden Clients ein 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)

Source control explorer, get latest version

Aktualisieren Ihrer lokalen TFVC-Arbeitsbereiche

Wenn Ihr Team TFVC mit lokalen Arbeitsbereichen verwendet,müssen diese Arbeitsbereiche mit dem neuen Projektnamen aktualisiert werden. Führen Sie für die folgenden Clients ein 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 müssen Sie einen neuen lokalen Arbeitsbereich erstellen, der dem neuen Projektnamen zugeordnet ist. Zwei Ausnahmen sind Visual Studio 2010, das nur Serverarbeitsbereiche unterstützt, und Team Foundation Server-Plug-In für Eclipse.

  1. Ändern Sie ihre Änderungen.

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

  3. Verunsichern Sie Ihre Änderungen.

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 Reporting Integrations (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 weiterhin vorhanden, bis Caches mit dem neuen Namen aktualisiert werden. Der Berichts- SharePoint Serveradministrator kann diese Aufträge manuell ausführen, um den neuen Namen sofort zu füllen.

  • Wenn Ihr Team Berichte verwendet, spiegeln sie die neuen Namen wider, nachdem der nächste inkrementelle Analyseauftrag für das Data Warehouse ausgeführt wurde. Standardmäßig wird der Auftrag alle zwei Stunden ausgeführt. Sie können jedoch die Warehouseaufträge und den inkrementellen Analyseauftrag manuell ausführen. Anschließend wird der neue Name mit dem Warehouse synchronisiert, und berichte beginnen mit dem 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 auf den neuen Projektnamen. Standardabfragen und Webparts müssen nicht aktualisiert werden, da sie weiterhin funktionieren. Die Verwendung @project funktioniert auch nach dem Umbenennen eines Projekts weiterhin und muss 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 die richtigen Daten enthalten. Wenn der neue Projektname nicht mit dem Warehouse synchronisiert wird, Excel die Berichte nicht die richtigen Daten anzeigen. Um dieses Ergebnis zu vermeiden, führen Sie Warehouseaufträge manuell aus.

    2. SharePoint Timerauftrag: Führen Sie den Auftrag "Team Foundation Server Dashboard Update" über den SharePoint-Zentraladministrator aus, um Excel Webparts auf dem Dashboard zu aktualisieren. Standardmäßig wird sie alle 30 Minuten ausgeführt. Bis dieser Auftrag ausgeführt wird, Excel Webparts auf dem Dashboard und die Berichte, die direkt aus dem Berichtsordner kommen, nicht funktionieren. 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. Zum 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.