Cambiar el nombre de un proyecto en Azure DevOps

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

Aprenda a cambiar el nombre de un proyecto. Al cambiar el nombre de un proyecto, actualiza el nombre del proyecto en las áreas siguientes:

  • rutas de acceso de control de versiones
  • elementos de trabajo
  • Consultas
  • otros artefactos de proyecto

Se puede cambiar el nombre de los proyectos varias veces y se pueden reutilizar los nombres más antiguos. Después del cambio de nombre, puede haber algunas acciones necesarias para los miembros del equipo.

Advertencia

El cambio de nombre de un proyecto envía notificaciones por correo electrónico a todos los usuarios del proyecto, si hay menos de 1000 usuarios. Si hay más de 1000 usuarios en el proyecto, solo los administradores de recopilación de proyectos reciben notificaciones por correo electrónico.

Requisitos previos

Debe ser miembro del grupo administradores de Project recopilación. Cuando sea el propietario de la organización, se le agregará automáticamente al grupo Project de recopilación. Si no es miembro, se agrega ahora. Para obtener más información, vea Establecer permisos en el nivel de proyecto o colección.

Debe ser miembro del grupo administradores de Project recopilación. Si no es miembro, se agrega ahora. Para obtener más información, vea Establecer permisos en el nivel de proyecto o colección.

Debe ser miembro del grupo administradores de Project recopilación. Si no es miembro, se agrega ahora. Para obtener más información, vea Establecer permisos en el nivel de proyecto o colección.

Debe tener el permiso Editar información de nivel de proyecto en un proyecto para cambiar su nombre.

Cambiar el nombre de un proyecto

  1. Inicie sesión en su organización ( ) y abra el proyecto cuyo nombre https://dev.azure.com/{yourorganization} desea cambiar.

  2. Seleccione Project información general y, a continuación, escriba un nuevo nombre y seleccione > Guardar.

    Escriba un nuevo nombre y, a continuación, seleccione Guardar para cambiar el nombre del proyecto.

  3. Para confirmar el cambio de nombre, escriba el nuevo nombre del proyecto, active la casilla situada junto a "I understand the consequences of renaming this project" (Comprenda las consecuencias de cambiar el nombre de este proyecto) y, a continuación, seleccione Guardar.

    Escriba el nuevo nombre del proyecto, active la casilla y, a continuación, guarde.

    Se cambia el nombre del proyecto.

  1. Inicie sesión en su organización.

  2. En la página Proyectos, elija las acciones del proyecto cuyo nombre desea cambiar y, a continuación, elija Cambiar nombre.

    Elija Cambiar nombre.

  3. Edite el nombre.

    Escriba un nuevo nombre de proyecto.

    Si no aparece Project cuadro de diálogo Cambiar nombre, no es miembro del grupo administradores de Project para ese proyecto en particular. Obtenga información sobre cómo agregarse al grupo Project administradores.

  1. Inicie sesión en su organización.

  2. En la pestaña Información general, abra el menú del proyecto cuyo nombre desea cambiar y, a continuación, elija Cambiar nombre.

    Elija Cambiar nombre.

  3. Edite el nombre.

    Escriba un nuevo nombre de proyecto.

    Si no aparece Project cuadro de diálogo Cambiar nombre, no es miembro del grupo administradores de Project para ese proyecto en particular. Obtenga información sobre cómo agregarse al grupo Project administradores.

Acciones de usuario necesarias para trabajar con el proyecto cuyo nombre ha cambiado

Cada usuario del equipo debe reiniciar sus clientes y realizar otras acciones en función de las características que use.

Reinicio de los clientes

Los clientes abiertos mantienen una memoria caché de todos los nombres de proyecto en memoria, pero esta caché no se borra automáticamente después de cambiar el nombre de un proyecto. Para borrar la memoria caché, reinicie el cliente para que rellene el nuevo nombre del proyecto. Si no reinicia el cliente, las operaciones que usan el nombre del proyecto almacenado en caché producirán un error con una excepción de proyecto no encontrado.

Para los clientes siguientes, guarde el trabajo en cada uno de ellos y, a continuación, reinicie:

  • Visual Studio/Team Explorer

  • Eclipse, si el equipo usa el complemento Team Explorer Everywhere.

  • Microsoft Excel, PowerPoint o Project, si el equipo usa la extensión Team Foundation Server para estos Office productos

  • Más clientes que usan el modelo de objetos de cliente Team Foundation Server .NET

Actualización de los remotos de Git

Si el proyecto usa Git, se deben actualizar las referencias remotas para cada repositorio del proyecto cuyo nombre ha cambiado. Estas actualizaciones son necesarias porque la dirección URL del repositorio remoto contiene el proyecto y el nombre del repositorio. Git usa referencias remotas para capturar e insertar cambios entre el repositorio local y la versión remota almacenada en el servidor. Cada miembro del equipo debe actualizar sus repositorios de Git locales para seguir conectándose desde sus máquinas de desarrollo.

Para obtener más información sobre cómo actualizar los remotos de Git, consulte Actualización de los remotos de Git en las máquinas de desarrollo.

Actualización de las áreas de trabajo del servidor TFVC

Si el proyecto usa TFVC con áreas de trabajo de servidor,estas áreas de trabajo deben actualizarse con el nuevo nombre del proyecto. Para los clientes siguientes, ejecute una get o check-in y, a continuación, se corrija la asignación del área de trabajo para usar el nuevo nombre de proyecto:

  • Visual Studio 2015 (RC o posterior)
  • Visual Studio 2013
  • Visual Studio 2012
  • Visual Studio 2010 (solo admite áreas de trabajo de servidor)
  • Team Explorer Everywhere (2012 o versiones posteriores)

Explorador de control de código fuente, obtener la versión más reciente

Actualización de las áreas de trabajo locales de TFVC

Si el equipo usa TFVC con áreas de trabajo locales,estas áreas de trabajo deben actualizarse con el nuevo nombre del proyecto. Para los clientes siguientes, ejecute una get o check-in y se corrija la asignación del área de trabajo para usar el nuevo nombre del proyecto:

Se recomienda actualizar los clientes a la última actualización o versión, si es posible. Para todas las demás versiones Visual Studio compatibles, debe crear un área de trabajo local asignada al nuevo nombre del proyecto. Dos excepciones incluyen Visual Studio 2010, que solo admite áreas de trabajo de servidor, y Team Foundation Server complemento para Eclipse.

  1. A la vez que los cambios se han realizado.

  2. Cree un área de trabajo asignada al nuevo nombre del proyecto.

  3. Desenlazen los cambios.

Las áreas de trabajo locales se administran localmente y no en el servidor. Los clientes anteriores sin la lógica de cambio de nombre actualizada no pueden actualizar las áreas de trabajo locales al nuevo nombre del proyecto.

Actualización de Team Foundation Server SharePoint e integraciones de informes (local)

Las SharePoint y Reporting Services continuarán funcionando, pero algunos informes no funcionarán según lo previsto hasta que se rellene el nuevo nombre del proyecto. El nombre del proyecto anterior sigue estando presente hasta que las memorias caché se actualizan con el nuevo nombre. El administrador de informes SharePoint servidor puede ejecutar manualmente estos trabajos para rellenar inmediatamente el nuevo nombre.

  • Si el equipo usa informes, reflejan los nuevos nombres después de que se ejecute el siguiente trabajo de análisis incremental para el almacenamiento de datos. De forma predeterminada, el trabajo se ejecuta cada dos horas. Sin embargo, puede ejecutar manualmente los trabajos de almacenamiento y el trabajo de análisis incremental. A continuación, el nuevo nombre se sincroniza con el almacenamiento y los informes comienzan a usar el nuevo nombre. Los informes no funcionan según lo previsto hasta que se han ejecutado los trabajos.

  • Si el equipo usa SharePoint Integration y tiene consultas personalizadas o elementos web que hacen referencia directamente al nombre del proyecto, actualice el nombre de cada uno al nuevo nombre del proyecto. No es necesario actualizar las consultas predeterminadas y los elementos web, ya que siguen funcionando. El uso de también sigue funcionando después de cambiar el nombre de un @project proyecto y tampoco es necesario actualizarlo.

  • Excel informes y Excel web en MOSS no muestran los datos correctos hasta que ejecute lo siguiente.

    1. Trabajo de almacenamiento: ejecute los trabajos de almacenamiento para que Excel los informes contengan los datos correctos. Si el nuevo nombre del proyecto no se sincroniza con el almacenamiento, Excel los informes no muestran los datos correctos. Para evitar este resultado, ejecute manualmente trabajos de almacenamiento.

    2. SharePoint de temporizador: ejecute el trabajo "Team Foundation Server Dashboard Update" desde el administrador central de SharePoint para actualizar Excel elementos web en el panel. De forma predeterminada, se ejecuta cada 30 minutos. Hasta que se ejecute este trabajo, los Excel web del panel y los informes procedentes directamente de la carpeta de informes no funcionarán. Esos elementos web usan el nombre de proyecto incorrecto o la carpeta de informes incorrecta.

    3. SharePoint caché: borre manualmente la caché de SharePoint para evitar que los datos obsoletos, como las ubicaciones de carpetas de informe, aparezcan en los paneles. De forma predeterminada, esta caché se borra aproximadamente cada hora. También puede borrar algunas cachés específicas de TFS mediante la dirección URL de redireccionamiento de TFS y proporcionando un parámetro "clearcache". Por ejemplo:

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

Resultados de la operación de cambio de nombre

  • Los identificadores de elementos de trabajo son únicos en la organización. La dirección URL sigue funcionando tanto para el nuevo nombre de equipo como para el antiguo. Esta funcionalidad está pensada para evitar vínculos de última hora.

  • Siempre que el proyecto de la dirección URL sea un proyecto válido de la organización, se mostrará el identificador de elemento de trabajo proporcionado. En el ejemplo siguiente se muestra una organización con proyectos denominados "Example1" y "Example2".

    https://dev.azure.com/MyOrg/Example1/_workitems/edit/40/ - Muestra el elemento de trabajo 40: muestra el elemento de trabajo https://dev.azure.com/MyOrg/Example2/_workitems/edit/40/ 40: https://dev.azure.com/MyOrg/Potato/_workitems/edit/40/ muestra un error 404.

  • Los vínculos de elementos de trabajo no expiran.

  • El nombre del proyecto anterior se puede usar de nuevo.