Comprender cómo las herramientas de actualización de VSS convierten los datos

Las herramientas de actualización de Visual SourceSafe son un método práctico para una actualización única y unidireccional de la base de código de Visual SourceSafe a Team Foundation Server (TFS).Debe usar las herramientas para actualizar los datos solo cuando esté preparado para detener el acceso a ellos en Visual SourceSafe e iniciar el mantenimiento en TFS.

TFS y Visual SourceSafe tienen diferencias funcionales significativas.Como resultado, las herramientas de actualización de Visual SourceSafe modifican ciertos tipos de datos durante la actualización.

En este tema

• Cómo se crean los conjuntos de cambios

• Cómo se actualizan los elementos compartidos y anclados

• Cómo se trasladan los datos históricos

  • Cómo se trasladan el nombre de usuario y la marca de fecha y hora

  • Cómo se convierten determinados tipos de eventos

• Cómo se trasladan los enlaces de control de versiones

Cómo se crean los conjuntos de cambios

El control de versiones de TFS agrupa los cambios a varios archivos en una única unidad cuando un usuario protege un conjunto de cambios.Esta unidad única se denomina conjunto de cambios.

Visual SourceSafe no tiene ninguna característica equivalente a los conjuntos de cambios.Sin embargo, durante el proceso de conversión, cada serie de cambios se agrupa en un conjunto de cambios siempre y cuando las siguientes condiciones sean verdaderas:

• Los cambios no están en conflicto entre sí.Por ejemplo, no hay dos acciones que afecten al mismo archivo o carpeta.

• Los cambios se produjeron con unos pocos minutos de diferencia entre sí.

• El mismo usuario protegió los cambios.

• Los cambios tienen el mismo comentario de protección.

Cómo se actualizan los elementos compartidos y anclados

En Visual SourceSafe, puede compartir un archivo en varias carpetas.Los cambios que realiza en un archivo compartido se replican en las carpetas en las que se comparte el archivo.El control de versiones de TFS no tiene ninguna característica equivalente.Durante la actualización, los archivos compartidos del proyecto Visual SourceSafe se actualizan al crear una copia independiente adicional del elemento en el servidor para el control de versiones de TFS.

El control de versiones de TFS tampoco tiene una característica equivalente a la característica Anclar de Visual SourceSafe.Durante la actualización, los elementos anclados en el proyecto Visual SourceSafe se convierten en elementos con etiqueta en el servidor para el control de versiones de TFS.Para obtener más información, vea la siguiente sección.

Cómo se trasladan los datos históricos

Cada evento en el historial de un elemento de la base de datos de Visual SourceSafe se transfiere al servidor de Team Foundation Server como un conjunto de cambios.Una vez completada la actualización, puede ver estos datos en la ventana Historial.Para obtener más información, vea Obtener el historial de un elemento.

Algunos cambios a los datos se producen durante la actualización.

Cómo se trasladan el nombre de usuario y la marca de fecha y hora

A medida que cada entrada del historial de un elemento de la base de datos de Visual SourceSafe se actualiza a un conjunto de cambios en el servidor Team Foundation Server, se producen los cambios siguientes:

• La marca de fecha y hora del conjunto de cambios se establece en la fecha y la hora en que se actualizó el elemento.

• La marca de hora original se almacena en el campo Comentarios del conjunto de cambios.

• El nombre de usuario se almacena en el campo Usuario o en el campo Comentarios del conjunto de cambios, dependiendo del resultado del proceso de asignación de usuarios.

  [!NOTA]

  Si desea controlar cómo los nombres de usuario están asignados a los datos históricos, debe utilizar VssUpgrade.Vea Especificar cómo se actualizan los nombres de usuario.

Cómo se convierten determinados tipos de eventos

Eventos como la edición, el cambio de nombre y la eliminación se actualizan de la base de datos de Visual SourceSafe a conjuntos de cambios en el servidor de Team Foundation Server de una manera sencilla.Sin embargo, las herramientas de actualización convierten algunos eventos de maneras inesperadas, como se muestra en la tabla siguiente.

Evento de Visual SourceSafe	Cómo se actualiza en el control de versiones de TFS
Agregar archivo o carpeta	Este conjunto de cambios es el primer evento del historial de cada archivo y carpeta que se actualiza.A diferencia de lo que ocurre en Visual SourceSafe, no se registra ningún evento para el elemento primario de cada elemento secundario que contiene.
Bifurcación	El uso compartido es una condición previa de la bifurcación en Visual SourceSafe, pero el control de versiones de TFS no es compatible con el uso compartido. Por consiguiente, la actualización de un archivo bifurcado crea una copia del archivo en la carpeta de destino. Los archivos compartidos de la base de datos de Visual SourceSafe se actualizan al control de versiones de TFS copiando la versión del archivo que existía cuando se compartió y colocando la copia en la carpeta de destino.Después de esto, cada conjunto de cambios se replica en ambas copias del archivo hasta que se produzca el evento de bifurcación.
Etiqueta	Elementos con etiqueta implícitamente: en Visual SourceSafe, cuando se etiqueta una carpeta, los elementos que contiene se etiquetan implícitamente.El proceso de actualización etiqueta explícitamente todos los elementos actualizados en el proyecto de equipo. Archivos etiquetados explícitamente: en Visual SourceSafe, cuando se etiqueta explícitamente un archivo individual, se crea una nueva versión del archivo. El proceso de actualización sirve de intermediario entre la etiqueta y la versión aplicable en el control de versiones de TFS, pero no crea una versión nueva. Nota Si la base de datos de Visual SourceSafe contiene muchas etiquetas que se aplican a muchos archivos, es posible que se prolongue el proceso de actualización.Si desea excluir estos datos, debe utilizar VssUpgrade y configurarlo para que omita las etiquetas.Vea <Label migrate="false" />.
Mover carpeta	El evento de mover carpeta crea una nueva versión de la carpeta en el control de versiones de TFS. Si utiliza VssUpgrade, no actualizará el historial completo de elementos en carpetas movidas a menos que se actualicen las carpetas de origen y de destino al mismo tiempo.Vea Examinar y resolver problemas encontrados por la característica Analyze. Nota Si el evento de mover carpeta se combina con un evento de restaurar, puede que los datos del historial no se actualicen correctamente.
Restaurar	No se actualiza ningún dato del historial que se produzca antes que un evento de restaurar.
Anclar y desanclar	El control de versiones de TFS no es compatible con anclar.Las herramientas de actualización actualizan un archivo anclado creando dos etiquetas. La etiqueta PINNED_LATEST se aplica a las versiones ancladas de los archivos anclados y a la versión más reciente de los archivos desanclados.La etiqueta PINNED solo se aplica a las versiones ancladas de los archivos anclados.Después de la actualización, la etiqueta PINNED_LATEST recuperará los mismos archivos que la acción Obtener la última versión de Visual SourceSafe.Sin embargo, una excepción es que la etiqueta PINNED_LATEST podría devolver archivos diferentes si se produjeron eventos distintos de proteger archivo una vez anclado un archivo, como cambiar el nombre o eliminar el archivo.
Compartir	El control de versiones de TFS no es compatible con el uso compartido.Los archivos compartidos de la base de datos de Visual SourceSafe se actualizan al control de versiones de TFS copiando la versión del archivo que existía cuando se compartió y colocando la copia en la carpeta de destino.Después, cada conjunto de cambios se replica en ambas copias del archivo.
Recuperar archivo o carpeta	Durante una actualización de eventos de recuperación de un archivo o una carpeta, las herramientas reproducen el evento para crear una nueva versión del archivo y la carpeta en el control de versiones de TFS. Las herramientas de actualización crean un conjunto de cambios que incluye el nombre del archivo o de la carpeta, la fecha y la hora en que se recuperó, y el nombre de usuario.

Cómo se trasladan los enlaces de control de versiones

Las herramientas de actualización sirven como intermediario de los enlaces de control de versiones para cada solución.

Paso siguiente

Prepararse para actualizar de Visual SourceSafe