Inducció n a Microsoft

Visual SourceSafe 2005

Tito Peralta Benítez - 2010
Contenido
• ¿Qué es Microsoft Visual SourceSafe?
• ¿Cómo funciona Visual SourceSafe?
• Administración de repositorios
• Administración de usuarios
• Administración de repositorios
• Integración con Visual Studio 2005 y 2008
Microsoft Visual SourceSafe 2005
• Software para administrar cambios en el código fuente de una
aplicación o sistema.
• El código fuente es texto plano.
• Consta de dos utilerías.
• Visual SourceSafe Explorer.
• Visual SourceSafe Administrator.
• La información se almacena en un repositorio.
Có mo Funciona
Repositorios – Creació n
• Abrir Visual SourceSafe Administrator
• Acceder al menú File > New Database…
• Debe de estar en una carpeta compartida (En nuestro caso la carpeta debe
estar en \\fileservercolom\sourcesafe\sourcesafe\.
• Requiere de privilegios de lectura y escritura.
Repositorios – Creació n (2)
• Se ejecutará el siguiente asistente:
• Hacemos click en “Next >”
Repositorios – Creació n (3)
• Escribimos la ruta de la nueva base de datos, Hacemos click en
“Next >”
Repositorios – Creació n (4)
• Escribimos el nombre de la base de datos, hacemos click en
“Next >”
Repositorios - Creació n (5)
• Seleccionamos el modelo de control del código. Se
recomienda usar el modelo Lock-Modifi-Unlock, hacemos click
en “Next >”
Repositorios - Creació n (6)
• Hacemos click en “Finish”
Abrir repositorio
• Abrimos la base de datos haciendo click en el menu File >
Open Source Database
Abrir repositorio (2)
• Si la base de datos está presente en la lista, la seleccionamos y
hacemos click en “Open”
Abrir repositorio (3)
• En caso de que no se encuentre en la lista, hacemos click en
“Add”, se ejecutará un asistente.
Abrir repositorio (4)
• Seleccionamos “Connect to existing database”, hacemos click
en “Next >”
Abrir repositorio (5)
• Escribimos la ruta de la base de datos.
• hacemos click en “Next >”
Abrir repositorio (6)
• Escribimos el nombre de la base de datos
• Hacemos click en “Next >”
Abrir repositorio (7)
• Hacemos click en “Finish”
Crear copia local de un repositorio
• Las copias locales de los
repositorios se mantienen
sincronizadas con las versiones
del servidor.
• Para descargarla primero
debemos configurar el directorio
de trabajo (Working folder); para
ello, seleccionamos la raíz de la
base de datos en Visual
SourceSafe y hacemos click con
el botón secundario del mouse y
en el menú contextual
seleccionamos “Set working
folder”.
Crear copia local de un repositorio (2)
• Al seleccionar la opción “Set Working folder”, aparecerá una
ventana donde debemos buscar la carpeta en la que vamos a
almacenar el código:
Crear copia local de un repositorio (3)
• Una vez seleccionada la carpeta,
hacemos click con el botón
secundario sobre la raíz de la
base de datos y seleccionamos en
el menú contextual la opción
“Get latest versión”
Crear copia local de un
repositorio (4)
• Entonces, aparecerá una ventana que nos muestra la ruta del
directorio de trabajo y unas opciones. En esta ventana
marcamos la opciones “Recursive” y “Build tree”, y oprimimos
OK.
Gestió n de usuarios
• Abrimos Microsoft Sourcesafe Administrator
• Abrimos un repositorio
• En la ventana principal encontramos los usuarios del repositorio, los permisos y si están trabajando actualmente
sobre el repositorio:
Editar usuario
• Seleccione uno de los usuarios de la grilla y luego haga click en
“Users > Edit User”
• Puede cambiar el nombre de usuario y los privilegios de acceso al
código fuente.
• Si desea cambiar la contraseña, haga click en el menú “Users >
Change Password”.
Crear usuario
• Haga click en el menu “Users > Add User”
• En “User name” escriba el nombre de login del usuario.
• En “SourceSafe password” escriba la contraseña.
• Si quiere que el usuario tenga acceso de solo lectura al repositorio active
la casilla “Read only”
• Si desea inscribir un usuario del dominio de windows, solo escriba el
nombre del usuario sin la contraseña.
Eliminar usuario
• Seleccione un usuario de la grilla
• Haga click en “Users > Delete user”
• En el mensaje de confirmación, haga click en “Yes”
Mantenimiento de repositorios
• Se realiza mediante la herramienta “Microsoft Visual
SourceSafe”, en donde podemos administrar:
• Consolidar ó deshacer las protecciones pendientes (Get, Checkin,
Checkout y Undo Checkout)
• Obtener la ultima versión (Get last version)
• Historial
• Diferencias
Abrir repositorio
• Para abrir un repositorio se realiza el mismo procedimiento
descrito para la gestión de repositorios.
Agregar archivos
• Seleccionamos un directorio en la lista de arbol del panel
izquierdo y hacemos click en “File > Add files”, seleccionamos
los archivos y hacemos click en “Open”
Eliminar archivos
• Seleccionamos el directorio en árbol del panel izquierdo.
• En el panel derecho seleccionamos los archivos que deseamos eliminar
• Confirmamos la eliminación y si será de forma permanente (incluyendo
la copia local)
Editar archivos
• Hay que tener en cuenta que el usuario tenga los privilegios
lectura y escritura en el repositorio
Editar archivos (2)
• Para editarlo debemos indicarle un directorio de trabajo si no
tenemos ya uno configurado. El directorio de trabajo es una
carpeta en donde se almacenarán las copias locales de Visual
SourceSafe.
Editar archivos (3)
• En el momento de editar el archivo el sistema solicitará el
editor que usaremos y el modo en el que abriremos el archivo,
como copia local ó Bloquear el archivo en el servidor y editarlo
(checkout)
Editar archivos (4)
• El proceso de checkout crea y actualiza una copia local de los
archivos en un directorio local.
Editar archivos (4)
• Una vez editado el archivo, habiendo elegido el bloqueo del archivo,
vemos que aparece el icono en color rojo como se muestra en la pantalla:
Editar archivos (5)
• El icono rojo indica que el archivo está bloqueado y que el
usuario que aparece en la fila lo está editando.
• Una vez finalizadas las modificaciones, se debe hacer
“checkin” a todos los archivos modificados:
Editar archivos (5)
• La acción “checkin” o proteger, sube los cambios en el servidor
y desbloquea el archivo.
Editar archivo (6)
• En caso de que hallamos tenido problemas y nos toque
recuperar el archivo original, hacemos un “Undo checkout”;
esta operación recupera la última versión del código.
Historial de cambios de un
archivo
•Visual SourceSafe genera respaldos cada vez que hacemos cambios sobre
los archivos y los clasifica por versiones.
• También puede mostrarnos las diferencias entre una versión y la otra:
• Para ver el historial, seleccionamos el archivo y hacemos click en “Tools >
Show History”
Historial de cambios de un
archivo (2)
• Luego de acceder desde el menú al historial, Nos aparecerá la
siguiente ventana:

● Si queremos ver todo el historial dejamos tal cual y oprimimos “OK”

● Podemos filtrar con la fecha de inicio (From), Fecha final (To) y usuario.
Historial de cambios de un
archivo (3)
• Luego de oprimir “Ok” sobre la ventana anterior, aparecerá la
siguiente ventana, en donde nos indica la versión, el usuario,
la fecha y la acción sobre el archivo:
Historial de cambios de un
archivo (4)
• En la ventana de historial encontraremos varios comandos:
• Close: Cierra la ventana.
• View: Ver el contenido de la versión seleccionada del archivo.
• Details: En esta ventana podemos ver o configurar la etiqueta y
descripción de la versión del archivo.
• Get: Reemplaza la copia local del archivo por la versión seleccionada.
• Differences: Compara el archivo local con la versión seleccionada y
muestra las diferencias en pantalla.
• Pin: Fija la versión de un archivo y no permite su eliminación aunque
se haga rollback.
• Rollback: Deshace los cambios del código a la versión especificada y
elimina las versiones posteriores que no estén fijadas.
• Report: Imprime un reporte de los detalles y cambios de un archivo.
• Help: muestra la ayuda de Visual SourceSafe.
Integració n con Visual Studio
• Visual SourceSafe solo está soportado hasta la versión 2008 de
Visual Studio y SQL Management Studio.
• Integra todas las funciones de gestión de archivos (Get, Get
latest version, Checkout, Checkin, Compare, View History, etc.)
• Muestra las protecciones pendientes.
• Permite subir las soluciones locales al control de código fuente
desde Visual Studio.
• Se integra de manera automaticamente al Visual Studio, al
instalar el paquete de Visual Source Safe.
Integración con Visual Studio – Añ adir al
control de código fuente
• Debemos tener instalado Visual Source Safe.
• Abrimos Visual Studio ó Sql Server Management Studio y
cargamos la solución. Vamos al menu Archivo > Control de
Codigo Fuente > Agregar proyecto al control de código fuente
Integración con Visual Studio – Añ adir al
control de código fuente (2)
• Aparecerá una ventana para conectarnos a una base de datos
existente, escribimos usuario y contraseña si deseamos
agregar el código a la base de datos actual (La cual se muestra
en el campo Database), en caso contrario hacemos click en el
botón “Browse”
Integración con Visual Studio – Añ adir al
control de código fuente (3)
• Si oprimimos el botón “Browse”, Seleccionamos la base de
datos en donde deseamos agregar el código. Lo recomendable
es crear una base de datos por cada solución (Para lo cual,
hacemos click en Add y seguimos los pasos del apartado de la
creación de repositorios)
Integración con Visual Studio – Gestión de
archivos
• Una vez tengamos nuestra solución en el control de código
fuente, Visual Studio mostrará un icono a la izquierda de cada
archivo de la solución:
Integración con Visual Studio – Gestión de
archivos (2)
• El icono indica el estado del archivo:

Indica que esta siendo editado y que está bloqueado para los
demás usuarios

Indica que el archivo esta disponible para ser editado. Este es el

estado ideal.

Indica que el archivo esta bloqueado por otro usuario

Integración con Visual Studio – Gestión de
archivos (3)
• Las operaciones de control de
código fuente estarán disponibles
en el menú contextual de cada
archivo, en el explorador de
soluciones y funcionan de la
misma forma que se explicó en los
puntos anteriores.
Integración con Visual Studio - Abrir un código
existente en el control de código fuente
• Para descargar una solución para manipularla desde Visual
Studio y que se encuentra en el control de versiones, primero
descargamos una copia local mediante Visual Source Safe
utilizando el procedimiento mencionado en el apartado “Crear
copia local de un repositorio”.
• Luego, abrimos la copia en el disco, la cual se sincronizará con
el servidor cada vez que realicemos una modificación.
Integración con Visual Studio -
Protecciones pendientes
• Cuando instalamos Visual
Source Safe, en visual studio
tenemos una barra en la que
podremos gestionar las
protecciones pendientes
(pending checkins), la cual se
habilita seleccionando en el
menú la opción Ver >
Protecciones pendientes
Integración con Visual Studio -
Protecciones pendientes (2)
• En la ventana de protecciones pendientes podemos ver los
archivos que hemos modificado y que deben ser protegidos.
• Mediante las cajas de verificación a la izquierda de cada icono
en esa ventana, podemos elegir que queremos proteger y que
no.
• Para proteger el código (checkin) hacemos click en el botón
“Proteger”
Integración con Visual Studio -
Recomendaciones
• Siempre que abramos una solución de Visual Studio que tenga
control de código es recomendable Obtener la ultima versión
para tener la copia local completamente actualizada con la
versión del servidor.
• Asegurarnos que lo que subimos al servidor funcione
correctamente.
• Cuando finalicemos nuestra jornada es fundamental realizar
las protecciones para que los demás usuarios puedan tener
acceso a los archivos bloqueados.
Tito Peralta Benítez
tperalta@gilatla.com