Uso de etiquetas para hacer una captura de los archivos
Las etiquetas permiten obtener una captura de los archivos para que en una fecha posterior se pueda consultar dicha captura. 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 con etiquetas en la línea de comandos
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.
.gif "Sugerencia") 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
Aplicar una etiqueta
En el Explorador de control de código fuente, haga clic con el botón secundario en la colección, proyecto de equipo, carpeta o archivo al que desee aplicar una etiqueta y haga clic en Aplicar etiqueta.
Aparecerá el cuadro de diálogo Nueva etiqueta.
En el cuadro Nombre, escriba un nombre para la etiqueta.
(Opcional) Escriba comentarios en el cuadro Comentario.
En la lista Versión, Última versión aparece seleccionado de forma predeterminada. Esta opción es normalmente la más utilizada, pero si necesita que la etiqueta especifique una versión concreta, puede seleccionar una de las siguientes opciones:
Si hace clic en Conjunto de cambios, puede especificar el número del conjunto de cambios en el cuadro Conjunto de cambios. También puede hacer clic en 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 información sobre un conjunto de cambios.
Si hace clic en Fecha, puede especificar una fecha en el cuadro Fecha o seleccionar una fecha del calendario en el menú desplegable.
Si hace clic en Etiqueta, puede especificar una etiqueta existente en la que se basará la nueva etiqueta. Escriba el nombre de la etiqueta en el cuadro Etiqueta o haga clic en 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.
Si hace clic en Versión del área de trabajo, la etiqueta se crea para la versión del área de trabajo.
Si está de acuerdo con los valores, siga uno de estos pasos:
Para aplicar la etiqueta, haga clic en Crear.
Para aplicar la etiqueta y modificarla una vez aplicada, haga clic en 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 hace clic en 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
En el Explorador de control de código fuente, haga clic con el botón secundario en el nodo de colección (el nodo raíz) del proyecto y, a continuación, haga clic en Aplicar etiqueta.
Aparecerá el cuadro de diálogo Nueva etiqueta.
En el cuadro Nombre, escriba un nombre para la etiqueta.
(Opcional) En el cuadro Comentario, escriba un comentario.
En la lista Versión, seleccione Etiqueta.
Aparecerá el cuadro Etiqueta.
Realice uno de estos pasos:
Escriba el nombre de la etiqueta existente.
Si no está seguro del nombre de la etiqueta existente, haga clic en el botón de puntos suspensivos (…) al lado del 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.)
Haga clic en Crear.
(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
En el Explorador de control de código fuente, en el menú Archivo, elija Control de código fuente, Etiqueta y, a continuación, haga clic en Buscar etiqueta.
Aparece el cuadro de diálogo Buscar etiqueta.
(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.
Haga clic en Buscar.
La lista Resultados muestra etiquetas que coinciden con el criterio de búsqueda especificado.
(Opcional) Realice uno de estos pasos:
Para ver o modificar una etiqueta, selecciónela y haga clic en 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 haga clic en Eliminar.
Haga clic en 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
En el Explorador de control de código fuente, haga clic con el botón secundario en el elemento al que se aplica la etiqueta que desea buscar y, a continuación, haga clic en Ver historial.
Aparecerá la ventana Historial.
Haga clic en la pestaña Etiquetas para mostrar la lista de etiquetas que se aplican a este elemento.
(Opcional) Realice uno de estos pasos:
Para ver o modificar una etiqueta, haga clic con el botón secundario en ella y seleccione 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, hacer clic con el botón secundario en ella y seleccione Eliminar etiqueta.
Haga clic con el botón secundario en la etiqueta y seleccione 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 Ver datos del historial.
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
En el Explorador de control de código fuente, haga clic con el botón secundario en la colección de proyectos, proyecto de equipo, bifurcación o carpeta que contiene los elementos que desea descargar y haga clic en Obtener versión específica.
Aparecerá el cuadro de diálogo Obtener.
En la lista Tipo, seleccione Etiqueta y, a continuación, escriba el nombre de la etiqueta en el cuadro Etiqueta o haga clic en 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.
Revise y, en su caso, seleccione cualquiera de las opciones adicionales del cuadro de diálogo Obtener.
Haga clic en 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
En la ventana Etiqueta, haga clic en Agregar elemento.
Aparecerá el cuadro de diálogo Elegir versión del elemento.
En el cuadro de diálogo Elegir versión del elemento, navegue hasta el elemento que desee agregar y selecciónelo.
SugerenciaPuede mantener presionadas las teclas CONTROL o MAYÚS y seleccionar varios elementos.
(Opcional) Si necesita que la etiqueta especifique una versión concreta, puede seleccionar una de las siguientes opciones en la lista Versión:
Si hace clic en Última versión, la etiqueta se aplicará a la última versión que esté en el control de versiones.
Si hace clic en Conjunto de cambios, puede especificar el número del conjunto de cambios en el cuadro Conjunto de cambios. También puede hacer clic en 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 información sobre un conjunto de cambios.
Si hace clic en Fecha, puede especificar una fecha en el cuadro Fecha o seleccionar una fecha del calendario en el menú desplegable.
Si hace clic en Etiqueta, puede especificar una etiqueta existente en la que se basará la nueva etiqueta. Escriba el nombre de la etiqueta en el cuadro Etiqueta o haga clic en 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.
Si hace clic en Versión del área de trabajo, la etiqueta se crea para la versión del área de trabajo.
Haga clic en Aceptar.
Haga clic en el menú Archivo y, a continuación, en Guardar.
Quitar un elemento de la etiqueta
En la ventana Etiqueta, busque la colección, proyecto de equipo, bifurcación, carpeta o archivo que desea quitar de esta etiqueta.
Haga clic con el botón secundario en el elemento y seleccione 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.
Haga clic en el menú Archivo y, a continuación, en Guardar.
Cambiar la versión de un archivo
En la ventana Etiqueta, busque el archivo que desea modificar.
Haga clic con el botón secundario en el archivo y seleccione Cambiar versión del elemento.
Aparecerá el cuadro de diálogo Elegir versión del elemento.
Realice uno de estos pasos:
Haga clic en Última versión para aplicar la etiqueta a la última versión que esté en el control de versiones.
Haga clic en Conjunto de cambios y, a continuación, especifique el número del conjunto de cambios en el cuadro Conjunto de cambios. También puede hacer clic en 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 información sobre un conjunto de cambios.
Haga clic en Fecha y especifique una fecha en el cuadro Fecha o seleccione una fecha del calendario en el menú desplegable.
Haga clic en Etiqueta y especifique una etiqueta existente en la que se basará la nueva etiqueta. Escriba el nombre de la etiqueta en el cuadro Etiqueta o haga clic en 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.
Haga clic en Versión del área de trabajo, la etiqueta se crea para la versión del área de trabajo.
Haga clic en el menú Archivo y, a continuación, en Guardar.
Realizar otras acciones en un elemento con etiquetas
Al hacer clic con el botón secundario en un elemento de la ventana Etiqueta, también puede seleccionar uno de los siguientes comandos:
Ver (solo archivos)
Ver historial
Comparar (solo archivos)
Anotar (solo archivos)
Obtener esta versión
Revertir archivos a una versión con etiquetas
Puede utilizar el comando tf rollback para revertir un conjunto de archivos al estado en el que estaban en las versiones marcadas por una etiqueta. Para obtener más información, vea Comando Rollback (Control de versiones de Team Foundation).
Trabajar con etiquetas en la línea de comandos
En esta sección se muestran algunas maneras típicas de trabajar con etiquetas en la línea de comandos.
Mostrar etiquetas en la línea de comandos
Para mostrar etiquetas en la línea de comandos
Haga clic en Inicio y en Todos los programas, elija Microsoft Visual Studio 2010 y Visual Studio Tools y, a continuación, haga clic en Símbolo del sistema de Visual Studio (2010).
Escriba cd ruta de acceso, donde ruta de acceso es el directorio que contiene el área de trabajo aplicable.
Escriba tf labels.
Aplicar y editar etiquetas en la línea de comandos
Aplicar una etiqueta en la línea de comandos tiene un efecto distinto a aplicar una etiqueta mediante Visual Studio ALM (tal y como se describe anteriormente en este tema). Al utilizar Visual Studio ALM para aplicar una etiqueta que ya existe, la operación quita la etiqueta de todas las versiones del archivo y aplica la etiqueta.
En la línea de comandos, sin embargo, la operación de la etiqueta es aditiva. Por ejemplo, suponga que aplica la etiqueta mylabel a $/DinnerNow/Features/FeatureTeamA. Si posteriormente aplica la etiqueta mylabel a $/DinnerNow/Features/FeatureTeamB, mylabel se aplicará a ambas carpetas.
Para aplicar una etiqueta desde la línea de comandos
Haga clic en Inicio y en Todos los programas, elija Microsoft Visual Studio 2010 y Visual Studio Tools y, a continuación, haga clic en Símbolo del sistema de Visual Studio (2010).
Escriba cd ruta de acceso, donde ruta de acceso es la ruta de acceso a la carpeta que desea etiquetar.
Escriba tf label mylabel . /recursive.
El sistema aplica la etiqueta mylabel a la versión del área de trabajo de la carpeta "ruta de acceso" y a todos los archivos y carpetas que contiene.
Quitar una etiqueta en la línea de comandos
Para quitar etiquetas de la línea de comandos
Haga clic en Inicio y en Todos los programas, elija Microsoft Visual Studio 2010 y Visual Studio Tools y, a continuación, haga clic en Símbolo del sistema de Visual Studio (2010).
Escriba cd ruta de acceso, donde ruta de acceso es el directorio que contiene el área de trabajo aplicable.
Escriba tf label /delete nombre de etiqueta, donde nombre de etiqueta es el nombre de la etiqueta que desea eliminar.
Vea también
Referencia
Label (Comando, Control de versiones de Team Foundation)
Conceptos
Trabajar con conjuntos de cambios
Crear un área de trabajo para trabajar con el proyecto de equipo
Permisos de Team Foundation Server
Utilizar el Explorador de control de código fuente