Manual de utilização da ferramenta SSIMtdn.totvs.com.br/download/attachments/27674346/Manual+de... · Web viewes el mapeo de carpetas en el control de versión del TFS para carpetas

Manual de utilización del TFS

(Team Foundation Server)Revisión 02

Página 1 de 81


TOC

Página 2 de 81


1. INTRODUCCIÓN

Este documento contiene informaciones de uso del Team Foundation Server (TFS) para el control de versión de archivos, definido por el proyecto PHOENIX etapa II.

2. INSTALACIÓN DEL CLIENT DEL TFS (TEAM EXPLORER)

El TFS (Team Foundation Server) es un repositorio centralizado que almacena todos los archivos contenidos en su control de versión. Así, para tener acceso al contenido del repositorio es necesario tener herramientas que permitan consultar al TFS. Son ejemplos de estas herramientas el Team Explorer que se puede vincular o no al IDE Visual Studio, y el Team Explorer Everywhere, un plugin para el IDE Eclipse. Vea los procedimientos para instalar el Team Explorer 2010.

2.1 Copie el directorio ftp.totvs.com.br/tdi/VS2010TE en un directorio local y ejecute el archivo setup.exe contenido en el mismo (Link para descargar el Team Explorer: http://www.microsoft.com/downloads/en/details.aspx?FamilyID=fe4f9904-0480-4c9d-a264-02fedd78ab38);

2.2 Haga clic en Next:

Página 3 de 81

http://www.microsoft.com/downloads/en/details.aspx?FamilyID=fe4f9904-0480-4c9d-a264-02fedd78ab38


2.3 Marque la opción I have read and accept the license terms y haga clic en Next:

Haga clic en Install:

Página 4 de 81


2.3 Haga clic en Finish:

3. CONEXIÓN AL TFS

El TFS está organizado en Team Projects, unidad que centraliza, controla y almacena todos los artefactos producidos por un proyecto como los códigos fuente. Por su lado, los Team Projects están agrupados en Team Projects Collections con el objetivo de facilitar la gestión de los Team Projects con aspectos en común. TOTVS adoptó como estándar de uso un Team Projects Collection para cada CD y una para el área de TI Corporativa. Dentro de cada CD se decidió adoptar la creación de un Team Project para cada producto de responsabilidad del CD. De este modo, los siguientes pasos muestran el procedimiento de como conectarse a un Team Project para tener acceso a los datos del producto:

Página 5 de 81


3.1 Haga clic en Iniciar > Todos los Programas > Microsoft Visual Studio 2010 > Microsoft Visual Studio 2010:

3.2 En primer lugar es necesario configurar el Proxy del TFS. Para ello haga clic en tools > options>Visual Studio team fondation Server. En el Proxy se debe informar: tfscdjv.totvs.com.br:8081

Página 6 de 81


3.3 Haga clic en Team > Connect to Team Foundation Server:

Página 7 de 81


3.4 Haga clic en Servers:

3.5 Haga clic en Add:

Página 8 de 81


3.6 En Name or URL of Team Foundation Server, informe el valor tfscdjv.totvs.com.br y haga clic en Ok:

3.7 Haga clic en Close:

Página 9 de 81


3.8 En Team Project Collections, seleccione su centro de desarrollo (CD) o seleccione TI si Ud. es de la TDI. En Team Projects, seleccione un producto y haga clic en Connect:

4. MAPEO DEL WORKSPACE

Un Workspace es el mapeo de carpetas en el control de versión del TFS para carpetas locales en la estación. A partir de este programa, se pueden obtener copias locales de los archivos, así se podrá modificarlos localmente hasta que estén listos para actualizarlos en el control de versión, por medio de la operación de Check In, también disponible a partir de un Workspace.

UD. puede sincronizar su Workspace con las modificaciones más recientes en el control de versión, utilizando la operación Get Latest Version, o incluso recuperar una versión específica de algun archivo utilizando la operación Get Specific Version.

Si desea tener varias copias de los archivos del control de versión en su computadora, puede crear más de un Workspace para un mismo control de versión en el TFS.

Los siguiente pasos contienen el procedimiento para realizar la gestión de un Workspace:

Página 10 de 81


4.1 Expanda un producto de su CD y haga doble clic en Source Control:

4.2 Expanda la caja de selección Workpace y seleccione la opción Workpaces:

Página 11 de 81


4.3 Haga clic en Add:

4.4 En Name informe el nombre Capacitación (Privado). En Working folders haga clic en Source Control Folder y seleccione el directorio raíz ($/) del CD. En Local Folder cree la carpeta C:\ControlVersión y haga clic en Ok:

Página 12 de 81



4.6 Expanda la caja de selección Workspace, valide la creación del workpace privado y haga clic en Workspace nuevamente:

Página 13 de 81


4.7 En Name informe el nombre Capacitación (Público). En Permissions seleccione la opción Public workpace y haga clic en Ok:


Página 14 de 81


4.9 Expanda la caja de selección Workspace, valide la creación del workspace público y haga clic en Workpaces nuevamente:

4.10 Seleccione el workspace Capacitación (Público) y haga clic en Remove. Seleccione el workspace con el nombre de la estación y haga clic en Remove:

Página 15 de 81


4.11 Seleccione el workspace Capacitación (Privado) y haga clic en Close.

5. GET, MODIFICACIÓN Y CHECK IN DE ARCHIVOS

A partir del workspace es posible recuperar los archivos del control de versión para la estación local, modificarlos y hacer el check in de los mismos enviando las modificaciones para el control de versión.Los siguientes pasos contienen el procedimiento para realizar dichas operaciones:

Página 16 de 81


5.1 En Folders, seleccione un producto de su CD y seleccione una carpeta del producto que no contenga carpetas internas, solamente archivos. Haga clic con el botón derecho sobre la carpeta y haga clic en la opción Get Latest Version:

Página 17 de 81


5.2 Seleccione un archivo de la carpeta recuperada, haga clic con el botón derecho y seleccione la opción Check Out for Edit:

5.3 Haga clic en Check Out:

Página 18 de 81


5.4 Haga doble clic en el archivo con check out, inserte, por ejemplo, la línea de comentario //Modificación realizada en la capacitación, grabe y cierre el archivo:

5.5 Haga doble clic en el archivo en otro archivo que no está con check out, inserte, por ejemplo, la línea de comentario //Segunda modificación realizada en la capacitación, grabe y cierre el archivo:

Página 19 de 81


5.6 Vea que se hizo un check out automático del archivo al realizar la modificación:

5.7 Haga clic con el botón derecho sobre el archivo modificado y por último haga clic en Shelve Pending Changes:

Página 20 de 81


5.8 En Shelveset name, informe el nombre Capacitación, desmarque la opción Preserve pending changes locally y haga clic en Shelve:

5.9 Seleccione otro archivo, haga clic con el botón derecho sobre éste y haga clic en Lock:

Página 21 de 81


5.10 Haga clic en Lock:

5.11 Seleccione otro archivo, haga clic con el botón derecho sobre éste y haga clic en Delete:

Página 22 de 81


5.12 Seleccione otro archivo, haga clic con el botón derecho sobre éste, haga clic en Rename y modifique el nombre del archivo:

5.13 Seleccione otro archivo, haga clic con el botón derecho sobre éste y haga otro clic en Move:

Página 23 de 81


5.14 En To, seleccione un directorio para mover el archivo y haga clic en Ok:

5.15 Haga clic con el botón derecho sobre el archivo modificado y seleccione Check In Pending Changes:

Página 24 de 81


5.16 En Comment, informe el comentario Capacitación, marque todos los archivos modificados para hacer check in y haga clic en Check In:

5.17 Verifique el mensaje y error indicando que se debe informar el código del llamado o del Proyecto\Requisito:

Página 25 de 81



5.19 Haga clic en Check-in Notes:

Página 26 de 81


5.20 En Chamado, informe el código del llamado y haga clic en Check In:

5.21 Verifique el mensaje y error informando que el llamado informado no tiene una tarea de desarrollo en ejecución para el usuario:

Página 27 de 81




Página 28 de 81


5.24 En Chamado, informe el número del llamado y haga clic en Check In:

6. CONSULTA DEL HISTORIAL, RECUPERACIÓN DE VERSIONES Y COMPARACIÓN DE ARCHIVOS

6.1 Haga clic con el botón derecho sobre el archivo modificado y seleccione View History:

Página 29 de 81


6.2 Haga clic con el botón derecho sobre la primera línea del historial de versiones y haga clic en Changeset Details:

6.3 Verifique los datos del check in y haga clic en Check-in Notes:

Página 30 de 81


6.4 Verifique los datos del check in notes y haga clic en Cancel:

6.5 Haga clic con el botón derecho sobre la segunda línea del historial de versiones y haga clic en Compare:

Página 31 de 81


6.6 Verifique la diferencia entre las versiones apuntadas y cierre la ventana:

6.7 Haga clic con el botón derecho sobre la primera línea del historial de versiones y haga clic en Compare:

Página 32 de 81


6.8 Verifique cual es el último check in realizado en cada línea del archivo, cierre el mismo y también cierre el historial de versiones:

6.9 Haga clic con el botón derecho sobre el archivo modificado y seleccione Check Out for Edit:

Página 33 de 81


6.10 Haga clic con el botón derecho sobre el archivo modificado y seleccione Get Specific Version:

6.11 En Type, seleccione la opción Changeset y haga clic en el botón de búsqueda (...) del changeset:

Página 34 de 81


6.12 En Find options, haga clic en Find:

Página 35 de 81


6.13 En Results, seleccione la última línea y haga clic en Ok:

6.14 Haga clic en Merge Changes In Merge Tool:

Página 36 de 81


6.15 Valide la modificación y haga clic en Ok:

6.16 Haga clic en Yes:

Página 37 de 81


6.17 Haga clic con el botón derecho sobre el archivo modificado y seleccione Undo Pending Changes:

6.18 Haga clic en Undo Changes:

Página 38 de 81


7. GESTIÓN DE BRANCHES

Un Branch de archivos o carpetas son copias inteligentes de los mismos que no replica todo el contenido de origen, pero sí replica solamente la diferencia entre el contenido de origen y las modificaciones que se realizan en el contenido del Branch. La relación del Branch también permite el Merge de las modificaciones, tanto del origen para el Branch como del Branch para el origen de manera simple.

La estrategia del Branches base adoptada por TOTVS será: Cada producto del CD tendrá un Branch base (vBase) a partir del cual se originarán todos los demás Branches. Para cada versión de innovación o sustentación del producto, se creará un Branch del Branch base de acuerdo con la siguiente figura:

Los siguientes pasos ejercitan el procedimiento de gestión de Branches:

Página 39 de 81


7.1 Haga clic con el botón derecho sobre el branch vBase de un producto o sobre la carpeta Maxime, haga clic en Branching and Merging y otro clic en Branch:

7.2 En Target, después del Codigo Fuente, sustituya el valor existente por /Inovacion/Capacitacion-<su login de red> y haga clic en Ok:

Página 40 de 81


7.3 Cree un archivo en el área de trabajo.

7.4 Haga clic con el botón derecho sobre el branch creado y haga otro clic en Add Items to Folder:

Página 41 de 81


7.5 Haga clic en Browse:

7.6 Seleccione el Área de Trabajo y haga clic en Ok:

Página 42 de 81


7.7 Seleccione el archivo creado y haga clic en Next:


Página 43 de 81


7.9 Haga clic en File > Source Control > Unshelve Pending Changes:

7.10 Haga clic en Details:

Página 44 de 81


7.11 Desmarque la opción Preserver shelveset on Server y haga clic en Unshelve:

7.12 En el Branch creado, haga clic con el botón derecho sobre el archivo que se modificó en los pasos anteriores con la inserción, por ejemplo, de la línea de comentario //Modificación realizada en la capacitación, y haga otro clic en Get Latest Version:

Página 45 de 81


7.13 Haga un doble clic en el archivo e inserte la linea, por ejemplo, de comentario //Modificación realizada en el Branch, grabe y cierre el archivo:

7.14 Haga clic en View > Other Windows > Pending Changes:

Página 46 de 81




Página 47 de 81


7.17 Haga clic con el botón derecho sobre el archivo modificado y seleccione la opción View History:

7.18 Expanda el registro de branch del archivo (último registro del historial de versiones con la columna Change y con el valor branch) y vea las versiones del archivo antes del Branch:

Página 48 de 81


7.19 Seleccione la primera versión del archivo y haga clic en Track Changeset:

7.20 Haga clic en Visualize:

Página 49 de 81


7.21 Arrastre el branch secundario (verde) sobre el branch principal:


Página 50 de 81




Página 51 de 81




Página 52 de 81



7.28 Cierre la solapa Pending Changes:

Página 53 de 81


7.29 Haga clic en Rerun:

7.30 Haga clic en Visualize:

Página 54 de 81


7.31 Valide el merge del changeset y haga clic en Timeline Tracking:

7.32 Valide el merge del changeset y cierre la ventana Tracking Changeset:

Página 55 de 81


7.33 Haga clic con el botón derecho sobre el branch creado, seleccione la opción Branching and Merging y haga clic en View Hierarchy:

7.34 Haga clic con el botón derecho sobre el branch y haga otro clic en Get Specific Version:

Página 56 de 81


7.35 En Target Path, haga clic en el lado derecho del botón Browse y haga otro clic en Server Path:

7.36 Seleccione el branch principal y haga clic en Ok:

Página 57 de 81


7.37 En Target Version, seleccione la opción Latest Version en la caja de selección Type y haga clic en Ok:

7.38 Valide las diferencias entre los branches y cierre la solapa Folder Difference:

Página 58 de 81


7.39 Arrastre el branch secundario sobre el branch principal:


Página 59 de 81




Página 60 de 81


7.43 Haga clic con el botón derecho sobre el branch creado y haga otro clic en Delete:


Página 61 de 81




Página 62 de 81


8. GESTIÓN DE LABELS

Los Label permiten que Ud. tome una “fotografía” de sus archivos, de tal manera que después se pueda recuperarlos para consulta, compilación o para devolver los archivos a la misma situación de cuando se creó el Label. Los siguientes pasos ejercitan el procedimiento de gestión de Labels:

8.1 Haga clic con el botón derecho sobre el branch de la versión de un producto del CD o de la carpeta Maxime para TDI, y haga clic en Apply Label:

Página 63 de 81


8.2 Informe en Name el valor Paquete – Capacitación y haga clic en Create:

8.3 Haga clic con el botón derecho sobre el archivo del branch y haga otro clic en View History:

Página 64 de 81


8.4 Haga clic en Labels:

8.5 Valide la creación del Label, haga clic con el botón derecho sobre éste y haga otro clic en Edit Label:

Página 65 de 81


8.6 Haga clic con el botón derecho sobre un archivo del label, haga clic en Remove from Label, cierre la solapa Label y grabe el label:

8.7 Haga clic en File > Source Control > Label > Find Label:

Página 66 de 81


8.8 Haga clic en Find:

8.9 Seleccione el label creado y haga clic en Delete, después haga otro clic en Close:

Página 67 de 81


9. GESTIÓN DE PERMISOS

9.1 Haga clic con el botón derecho sobre el CD, seleccione la opción Team Project Collection Settings y haga otro clic en Group Membership:

9.2 Haga clic en New:

Página 68 de 81


9.3 En Group Name informe el nombre Capacitación. En Description, informe la descripción Grupo creado para capacitación y haga clic en Ok:

9.4 Haga clic en Properties:

Página 69 de 81


9.5 En Add member, seleccione la opción Windows User or Group y haga clic en Add:

9.6 Informe el login de red de un usuario del CD y haga clic en Ok:

Página 70 de 81


9.7 Haga clic en OK:


Página 71 de 81


9.9 Haga clic con el botón derecho sobre el CD, seleccione la opción Team Project Collection Settings y haga otro clic en Security:

9.10 En Add users and groups, seleccione la opción Team Foundation Server Group y haga clic en Add:

Página 72 de 81


9.11 Seleccione el grupo <CD>\Capacitación creado anteriormente y haga clic en Ok:

9.12 En Permissions for <CD>\Capacitación, seleccione la autorización View collection-level information, marque la opción Allow y haga clic en Close:

Página 73 de 81


9.13 Seleccione una carpeta de una versión de un producto del CD, haga cli con el botón derecho sobre ésta y haga clic en Properties:

9.14 Haga clic en la solapa Security:

Página 74 de 81


9.15 En Add users and groups, marque la opción Team Foundation Server Group y haga clic en Add:

9.16 Seleccione el grupo <CD>\Capacitación creado anteriormente y haga clic en Ok:

Página 75 de 81


9.17 En Permissions for <CD>\Capacitación, seleccione la autorización Read, marque la opción Allow y haga clic en Ok:

9.18 Haga clic con el botón derecho sobre el CD, seleccione la opción Team Project Collection Settings y haga otro clic en Group Membership:

Página 76 de 81


9.19 Haga clic en Remove y haga otro clic en Close:

10. BUSCADOR DE FUENTES EN EL TFS

Este buscador permite buscar y/o consultar los archivos del TFS, para un eventual mantenimiento. Esta opción facilita la ubicación del archivo dentro del TFS si Ud. no sabe el camino en que éste se encuentra.

Para obtener esta opción dentro del TFS, debe acceder a la dirección del FTP (ftp.totvs.com.br/TDI/TFS) y copiar la carpeta TFS Power Tools - Utilitario de Búsqueda y Retirada de Check-in e instalar en la maquina local:

Página 77 de 81

ftp://ftp.totvs.com.br/TDI/TFS


Después de instalar, el usuario debe seleccionar la carpeta donde se encuentran los fuentes del TFS y hacer clic sobre ésta con el botón derecho del mouse. En el menú aparecerá el ítem “Find in Source Control”, seleccione la opción Widcard.

Página 78 de 81


Al seleccionar la opción Wildcard se presentará la pantalla para buscar los fuentes, como indicado a continuación:

Digite el nombre del programa que desea buscar y haga clic en el botón Find.

Página 79 de 81


Se abrirá la pantalla con el resultado de la consulta, como se puede ver abajo:

Página 80 de 81


11. GLOSARIO

Un Branch de archivos o carpetas son copias inteligentes de los mismos que no replica todo el contenido de origen, pero sí replica solamente la diferencia entre el contenido de origen y las modificaciones que se realizan en el contenido del Branch. La relación del Branch también permite el Merge de las modificaciones, tanto del origen para el Branch como del Branch para el origen de manera simple.

Changeset – Un changeset es un conjunto de modificaciones confirmadas para uno o más ítems que están almacenados en el repositorio de control de la versión del TFS. También puede contener datos de ítems de trabajo, notas de check in e informaciones de sustitución de directrices.

Check In – Esta funcionalidad permite que el usuario libere el archivo y envíe el archivo modificado al servidor.

Check Out – Esta funcionalidad permite que el usuario reserve el archivo.

Get – Vea en Workspace.

Label - permite que Ud. tome una “fotografía” de sus archivos, de tal manera que después se pueda recuperarlos para consulta, compilación o para devolver los archivos a la misma situación de cuando se creó el Label.

Shelving - Permite que el usuario almacene en un local de su máquina (espacio creado por el TFS) el archivo al que aun no se le puede aplicar el Check In.

Team Projects - controla y almacena todos los artefactos producidos por un proyecto como los códigos fuente. Dentro de cada CD se decidió adoptar que se crearía un Team Project para cada producto de responsabilidad del CD.

Team Projects Collections – Tiene el objetivo de facilitar la gestión de los Team Projects con aspectos en común. TOTVS adoptó como estándar utilizar un Team Projects Collection para cada CD y una para el área de TI Corporativa.

TFS - El TFS (Team Foundation Server) es un repositorio centralizado que almacena todos los archivos contenidos en su control de versión.

Workspace - Es el mapeo de carpetas en el control de versión del TFS para carpetas locales en la estación. A partir de dicho programa Ud. logra obtener copias locales de los archivos, así podrá modificarlos localmente hasta que estén listos para que sean actualizados en el control de versión por medio de la operación de Check In, también disponible a partir de un Workspace. Ud. puede sincronizar su Workspace con las modificaciones más recientes en el control de versión utilizando la operación Get Latest Version, o incluso recuperar una versión específica de algún archivo utilizando la operación Get Specific Version.

Si desea tener varias copias de los archivos del control de versión en su computadora, puede crear más de un Workspace para un mismo control de versión en el TFS.

Página 81 de 81

Documents

Manual de utilização da ferramenta SSIMtdn.totvs.com.br/download/attachments/27674346/Manual+de... · Web viewes el mapeo de carpetas en el control de versión del TFS para carpetas