Uso de etiquetas para hacer una captura de los archivos

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, el permiso Etiqueta debe estar establecido en Permitir. Para buscar, mostrar o ver etiquetas, el permiso Leer debe estar establecido en Permitir. Para modificar o eliminar una etiqueta, debe ser propietario de la etiqueta o tener el permiso Administrar etiquetas establecido en Permitir.

En este artículo

• Usar etiquetas

• Aplicar una etiqueta

• Cambiar el nombre de una etiqueta

• Mostrar, buscar, ver, editar y quitar etiquetas

• Descargar versiones con etiquetas de archivos al área de trabajo

• Usar la ventana Etiqueta para trabajar con etiquetas

• Revertir archivos a una versión con etiquetas

• Trabajar desde el símbolo del sistema

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 facilita el trabajo: aplica una etiqueta a la carpeta, bifurcación o proyecto de equipo 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 en particular al que se aplica la etiqueta.

Sugerencia
Al aplicar una etiqueta, se proporcionan muchas de las ventajas que se obtienen al crear una bifurcación, pero normalmente con un costo y complejidad menores.

Aplicar una etiqueta

Sugerencia
Cuando usa Visual Studio para aplicar una etiqueta que ya existe, la operación quita la etiqueta de todas las versiones del archivo para aplicarla después.En la línea de comandos, sin embargo, la operación label es aditiva.Vea Label Command.

Aplicar una etiqueta

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

   Aparecerá el cuadro de diálogo Nueva etiqueta.

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

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

4. En la lista Versión, Última versión aparece seleccionado 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. Si lo desea, también puede elegir el botón de 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 en el calendario del menú desplegable.

   • Etiqueta: especifique una etiqueta existente en la que se basará la nueva etiqueta. Escriba el nombre de la etiqueta en el cuadro Etiqueta o elija el botón de 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 área de 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 una vez aplicada, seleccione Crear y editar. Esto aplica la etiqueta y muestra la ventana Etiqueta. Para obtener más información sobre cómo utilizar la ventana Etiqueta para editar una etiqueta, vea Usar la ventana Etiqueta para trabajar con etiquetas.

Nota
Al aplicar una etiqueta mediante un nombre que ya existe, el sistema le advierte y pregunta si desea continuar.Si elige Aceptar para continuar, cualquier elemento no incluido en la ruta de acceso al que está aplicando la etiqueta carecerá de esa etiqueta.

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 el Explorador de control de código fuente, abra el menú contextual del nodo de la colección de proyectos (el nodo raíz) y, a continuación, elija Opciones avanzadas, Aplicar etiqueta.

   Aparecerá 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.

   Aparecerá 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 de puntos suspensivos (…) que se encuentra junto al cuadro Etiqueta.

     Aparece el cuadro de diálogo Buscar etiqueta.

     Utilice 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. Elija Crear.

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 mostrar y buscar etiquetas: el cuadro de diálogo Buscar etiqueta y la pestaña Etiqueta en 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 el Explorador de control de código fuente, en la barra de menús, elija Archivo, Control de código fuente, 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 lista Proyecto, seleccione el proyecto de equipo 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 el criterio de búsqueda especificado.

4. (Opcional) Realice uno de estos pasos:

   • Para ver o modificar una etiqueta, selecciónela y elija Editar.

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

   • Para eliminar una etiqueta, selecciónela 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 el Explorador de control de código fuente, abra el menú contextual del elemento al que se aplica la etiqueta que desea encontrar y, a continuación, elija Ver historial.

   Aparecerá 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 modificar una etiqueta, abra el menú contextual y elija Editar etiqueta.

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

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

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

Para obtener más información sobre cómo usar la pestaña de 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 el Explorador de control de código fuente, abra el menú contextual de la colección de proyectos, el proyecto de equipo, la bifurcación o la carpeta que contiene los elementos que desea descargar y luego elija Opciones avanzadas, Obtener versión específica.

   Aparecerá el cuadro de diálogo Obtener.

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

3. Revise y, en su caso, seleccione cualquiera de las opciones adicionales del 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.

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

2. En el cuadro de diálogo Elegir versión del elemento, navegue hasta el elemento que desee agregar y selecciónelo.

   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 concreta, en la lista Versión, seleccione:

   • Última versión: la etiqueta se aplicará a la última versión que esté en el control de versiones.

   • Conjunto de cambios: especifique el número del conjunto de cambios en el cuadro Conjunto de cambios. Si lo desea, también puede elegir el botón de 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 en el calendario del menú desplegable.

   • Etiqueta: especifique una etiqueta existente en la que se basará la nueva etiqueta. Escriba el nombre de la etiqueta en el cuadro Etiqueta o elija el botón de 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 área de trabajo: la etiqueta se crea para la versión del área de trabajo.

4. Elija Aceptar.

5. Elija Archivo, Guardar.

Quitar un elemento de la etiqueta

1. En la ventana Etiqueta, busque la colección, proyecto de equipo, bifurcación, carpeta o 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, proyecto de equipo, bifurcación o carpeta, la etiqueta se quita también de todos los elementos que contiene.

3. Elija Archivo, Guardar.

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:

   • Última versión: aplique la etiqueta a la última versión que esté en el control de versiones.

   • Conjunto de cambios: especifique el número del conjunto de cambios en el cuadro Conjunto de cambios. Si lo desea, también puede elegir el botón de 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 en el calendario del menú desplegable.

   • Etiqueta: especifique una etiqueta existente en la que se basará la nueva etiqueta. Escriba el nombre de la etiqueta en el cuadro Etiqueta o elija el botón de 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 área de trabajo: la etiqueta se crea para la versión del área de trabajo.

5. Elija Archivo, Guardar.

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

• Label Command: aplica o quita una etiqueta.

  Sugerencia
  Cuando utilice este comando para aplicar una etiqueta, puede especificar un ámbito distinto al del proyecto de equipo.

• Labels Command: muestra las etiquetas.

Vea también

Conceptos

Buscar y ver conjuntos de cambios

Crear y trabajar con áreas de trabajo

Referencia de permisos para Team Foundation Server

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

Otros recursos

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