Uso de etiquetas para hacer una captura de los archivos

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 | TFS 2017 | TFS 2015 | VS 2017 | VS 2015 | VS 2013

Las etiquetas permiten obtener una instantánea de los archivos que podrá consultarse posteriormente. Mediante una etiqueta, puede ver, compilar o incluso revertir un amplio conjunto de archivos al estado en el que estaban cuando se aplicó la etiqueta.

Permisos necesarios

Para aplicar una etiqueta, debe tener el permiso Etiqueta establecido en Permitir. Para buscar, enumerar o ver etiquetas, debe tener el permiso Leer establecido en Permitir. Para modificar o eliminar una etiqueta, debe ser propietario de la etiqueta o tener el permiso Administrar etiquetas establecido en Permitir.

Usar etiquetas

En muchos proyectos de software, cuando el código ha alcanzado un nivel razonable de calidad y estabilidad, el equipo compilará y lanzará una nueva versión del producto. El equipo necesita marcar la versión actual de cada archivo para que, aunque se sigan modificando los archivos, el equipo pueda obtener y compilar la nueva versión de cada archivo del proyecto.

En teoría, se podría grabar manualmente el identificador de cada conjunto de cambios para cada archivo; pero este tipo de proceso no es nada práctico. El control de versiones de Team Foundation simplifica el trabajo: se aplica una etiqueta a la carpeta, rama o proyecto que contiene los archivos. Puede dar un nombre a la etiqueta que cumpla cualquier convención de nomenclatura que prefiera. Algunos ejemplos de nombres de etiqueta: "Sprint 5", "M1", "Beta2" y "Opción de versión 0".

Después de haber aplicado la etiqueta, puede utilizarla para calificar operaciones como compilar, crear una bifurcación, combinar, comparar y obtener versiones concretas de archivos y carpetas.

A veces, después de aplicar una etiqueta, decide cambiarla. El control de versiones de Team Foundation permite aplicar una etiqueta a archivos adicionales, quitar una etiqueta de determinados archivos e incluso modificar la versión de un archivo específico al que se aplica la etiqueta.

Aplicar una etiqueta

Aplicar una etiqueta

1. En Explorador de control de código fuente, abra el menú contextual de la colección, el proyecto, la rama, la carpeta o el archivo al que desea aplicar una etiqueta y elija Avanzado ,Aplicar etiqueta.

   Aparece el cuadro de diálogo Nueva etiqueta.

2. En el cuadro Nombre , escriba un nombre para la etiqueta.

3. (Opcional) Escriba los comentarios en el cuadro Comentario.

4. En la lista Versión, la versión más reciente está seleccionada de forma predeterminada. Normalmente, esta opción es la que más se utiliza, pero si necesita que la etiqueta especifique una versión concreta, seleccione:

   • Conjunto de cambios:especifique el número del conjunto de cambios en el cuadro Conjunto de cambios. Como alternativa, elija los puntos suspensivos (...) para abrir el cuadro de diálogo Buscar conjuntos de cambios. Para obtener más información, vea Buscar y ver conjuntos de cambios.

   • Fecha:especifique una fecha en el cuadro Fecha o seleccione una fecha del calendario en el menú desplegable.

   • Etiqueta:especifique una etiqueta existente en la que basar la nueva etiqueta. Escriba el nombre de etiqueta en el cuadro Etiqueta o elija los puntos suspensivos (...) para abrir el cuadro de diálogo Buscar etiqueta. Para obtener más información, vea Buscar, editar y quitar etiquetas.

   • Versión del áreade trabajo: la etiqueta se crea para la versión del área de trabajo.

5. Si está de acuerdo con los valores, siga uno de estos pasos:

   • Para aplicar la etiqueta, elija Crear.

   • Para aplicar la etiqueta y modificarla después de aplicarla, elija Crear y editar. Esto aplica la etiqueta y, a continuación, muestra la ventana Etiqueta. Para obtener más información sobre cómo usar la ventana Etiqueta para editar una etiqueta, vea Usar la ventana Etiqueta para trabajar con etiquetas.

Cambiar el nombre de una etiqueta

Aunque no puede modificar el nombre de una etiqueta existente, puede aplicar con facilidad una nueva etiqueta exactamente a los mismos archivos y a las mismas versiones a los que se aplica otra etiqueta.

Aplicar una etiqueta basada en una etiqueta existente

1. En Explorador de control de código fuente, abra el menú contextual del nodo de colección de proyectos (el nodo raíz) y, a continuación, elija Avanzado, Aplicar etiqueta.

   Aparece el cuadro de diálogo Nueva etiqueta.

2. En el cuadro Nombre , escriba un nombre para la etiqueta.

3. (Opcional) En el cuadro Comentario , escriba un comentario.

4. En la lista Versión, seleccione Etiqueta.

   Aparece el cuadro Etiqueta.

5. Realice uno de estos pasos:

   • Escriba el nombre de la etiqueta existente.

   • Si no está seguro del nombre de la etiqueta existente, elija el botón Examinar con los puntos suspensivos (...) junto al cuadro Etiqueta.

     Aparece el cuadro de diálogo Buscar etiqueta.

     Use las opciones del cuadro de diálogo Buscar etiqueta para filtrar la lista de etiquetas y buscar la etiqueta existente a la que desea aplicar la nueva etiqueta. (Para obtener más información, vea Buscar, editar y quitar etiquetas).

6. Seleccione Create.

7. (Opcional) Después de haber creado la nueva etiqueta, puede quitar la etiqueta anterior. Para obtener más información, vea Buscar, editar y quitar etiquetas.

Mostrar, buscar, ver, editar y quitar etiquetas

Hay dos maneras de enumerar y buscar etiquetas: el cuadro de diálogo Buscar etiqueta y la pestaña Etiqueta de la ventana Historial. Una vez encontrada la etiqueta que le interesa, puede verla, editarla, quitarla o trabajar con los archivos a los que se aplica.

Buscar y trabajar con etiquetas mediante el cuadro de diálogo Buscar etiqueta

1. En Explorador de control de código fuente, en la barra de menús, elija Archivo, Control de códigofuente , Buscar, Buscar etiqueta.

   Aparece el cuadro de diálogo Buscar etiqueta.

2. (Opcional) Refine su búsqueda realizando uno o varios de estos pasos:

   • En el cuadro de texto Nombre, escriba el nombre de la etiqueta.

   • En la Project, seleccione el proyecto que contiene la etiqueta que desea buscar.

   • En el cuadro de texto Propietario, escriba el nombre o alias del propietario de la etiqueta.

3. Elija Buscar.

   La lista Resultados muestra etiquetas que coinciden con los criterios de búsqueda especificados.

4. (Opcional) Realice uno de estos pasos:

   • Para ver o editar una etiqueta, selecciónelo y elija Editar.

     Aparece la ventana Etiqueta. Para obtener más información, vea Usar la ventana Etiqueta para trabajar con etiquetas.

   • Para eliminar una etiqueta, selecciónelo y elija Eliminar.

   • Elija Cerrar.

A veces, puede dudar del nombre de una etiqueta, pero sabe que la etiqueta se aplicó a un elemento determinado en el control de versiones. En el siguiente procedimiento se explica cómo buscar y trabajar con una etiqueta en esta situación.

Mostrar y trabajar con etiquetas que se aplican a un elemento específico

1. En Explorador de control de código fuente, abra el menú contextual del elemento al que se aplica la etiqueta que desea buscar y, a continuación, elija Ver historial.

   Aparece la ventana Historial.

2. Elija la pestaña Etiquetas para mostrar la lista de etiquetas que se aplican a este elemento.

3. (Opcional) Realice uno de estos pasos:

   • Para ver o editar una etiqueta, abra su menú contextual y elija Editar etiqueta.

     Aparecerá la ventana Etiqueta. Para obtener información sobre cómo usar esta ventana, vea Usar la ventana Etiqueta para trabajar con etiquetas.

   • Para eliminar una etiqueta, abra su menú contextual y elija Eliminar etiqueta.

   • Abra el menú contextual de la etiqueta y elija otras acciones, como Obtener esta versióny Comparar.

Para obtener más información sobre cómo usar la pestaña etiqueta en la ventana Historial, vea Obtener el historial de un elemento.

Descargar versiones con etiquetas de archivos al área de trabajo

Etiquetar un conjunto de archivos es como obtener una captura de cómo eran en determinado punto del tiempo. Semanas o meses después de haber obtenido esa captura, puede necesitar ver o trabajar con los archivos tal y como existían en dicha captura. En el siguiente procedimiento se explica cómo descargar las versiones con etiquetas de un conjunto de archivos al área de trabajo.

Descargar versiones con etiquetas de archivos al área de trabajo

1. En Explorador de control de código fuente, abra el menú contextual de la colección de proyectos, el proyecto, la rama o la carpeta que contiene los elementos que desea descargar y, a continuación, elija Avanzadas,Obtener versión específica.

   Aparece el cuadro de diálogo Obtener.

2. En la lista Tipo, seleccione Etiquetay, a continuación, escriba el nombre de la etiqueta en el cuadro Etiqueta o elija los puntos suspensivos (...) para abrir el cuadro de diálogo Buscar etiqueta . Para obtener más información sobre cómo usar este cuadro de diálogo, vea Buscar, editar y quitar etiquetas.

3. Revise y, si procede, seleccione cualquiera de las opciones adicionales en el cuadro de diálogo Obtener.

4. Elija Obtener.

Usar la ventana Etiqueta para trabajar con etiquetas

Una vez abierta la ventana Etiqueta mediante uno de los procedimientos anteriores, ya está listo para empezar a trabajar con la etiqueta. En la parte superior de la ventana hay un cuadro que muestra el comentario, que puede modificar si lo desea.

Puede utilizar la ventana Etiqueta para realizar las tareas siguientes:

• Agregar un elemento a la etiqueta

• Quitar un elemento de la etiqueta

• Cambiar la versión de un archivo

• Realizar otras acciones en un elemento

Agregar un elemento a la etiqueta

1. En la ventana Etiqueta, elija Agregar elemento.

   Aparece el cuadro de diálogo Elegir versión del elemento.

2. En el cuadro de diálogo Elegir versión del elemento , vaya a y, a continuación, seleccione el elemento que desea agregar.

   Sugerencia

   Puede mantener presionadas las teclas CONTROL o MAYÚS y seleccionar varios elementos.

3. (Opcional) Si necesita que la etiqueta tenga como destino una versión específica, en la lista Versión, seleccione:

   • Versión másreciente: la etiqueta se aplicará a la versión más reciente que se encuentra en el control de versiones.

   • Conjunto de cambios:especifique el número del conjunto de cambios en el cuadro Conjunto de cambios. Como alternativa, elija los puntos suspensivos (...) para abrir el cuadro de diálogo Buscar conjuntos de cambios. Para obtener más información, vea Buscar y ver conjuntos de cambios.

   • Fecha:especifique una fecha en el cuadro Fecha o seleccione una fecha del calendario en el menú desplegable.

   • Etiqueta:especifique una etiqueta existente en la que basar la nueva etiqueta. Escriba el nombre de la etiqueta en el cuadro Etiqueta o elija los puntos suspensivos (...) para abrir el cuadro de diálogo Buscar etiqueta . Para obtener más información, vea Buscar, editar y quitar etiquetas.

   • Versión del áreade trabajo: la etiqueta se crea para la versión del área de trabajo.

4. Elija Aceptar.

5. Elija Archivoy guarde.

Quitar un elemento de la etiqueta

1. En la ventana Etiqueta, busque la colección, el proyecto, la rama, la carpeta o el archivo que desea quitar de esta etiqueta.

2. Abra el menú contextual del elemento y elija Quitar de la etiqueta.

   La etiqueta se quita del elemento. Si el elemento es una colección de proyectos, un proyecto, una rama o una carpeta, la etiqueta también se quita de todos los elementos que contiene.

3. Elija Archivoy guarde.

Cambiar la versión de un archivo

1. En la ventana Etiqueta, busque el archivo que desea modificar.

2. Abra el menú contextual del archivo y elija Cambiar versión etiquetada.

3. Aparece el cuadro de diálogo Cambiar versión etiquetada.

4. Seleccione:

   • Versión más reciente:aplique la etiqueta a la versión más reciente que se encuentra en el control de versiones.

   • Conjunto de cambios:especifique el número del conjunto de cambios en el cuadro Conjunto de cambios. Como alternativa, elija los puntos suspensivos (...) para abrir el cuadro de diálogo Buscar conjuntos de cambios. Para obtener más información, vea Buscar y ver conjuntos de cambios.

   • Fecha:especifique una fecha en el cuadro Fecha o seleccione una fecha del calendario en el menú desplegable.

   • Etiqueta:especifique una etiqueta existente en la que basar la nueva etiqueta. Escriba el nombre de la etiqueta en el cuadro Etiqueta o elija los puntos suspensivos (...) para abrir el cuadro de diálogo Buscar etiqueta . Para obtener más información, vea Buscar, editar y quitar etiquetas.

   • Versión del áreade trabajo: la etiqueta se crea para la versión del área de trabajo.

5. Elija Archivoy guarde.

Realizar otras acciones en un elemento con etiquetas

Cuando abra el menú contextual de un elemento de la ventana Etiqueta, también podrá elegir uno de los siguientes comandos:

• Ver (solo archivos)

• Ver historial

• Comparar (solo archivos)

• Anotar (solo archivos)

• Obtener esta versión

Trabajar desde el símbolo del sistema

• Comando Label (Control de versiones de Team Foundation) Aplique o quite una etiqueta.

  Sugerencia

  Cuando use este comando para aplicar una etiqueta, puede especificar un ámbito distinto del proyecto.

• Labels (Comando) Enumerar etiquetas.

Consulte también

Otros recursos

Buscar y ver conjuntos de cambios

Crear y trabajar con áreas de trabajo

Referencia de permisos y grupos

Usar bifurcaciones para aislar riesgos en el control de versiones de Team Foundation

Uso Explorador de control de código fuente para administrar archivos bajo control de versiones