02 - el administrador de proyectos

2 - El Administrador de Proyectos-

Proyectos El proyecto es el ncleo de trabajo para la generacin de aplicaciones Visual FoxPro. Se utiliza

para aadir ficheros nuevos a la aplicacin, modificar los existentes o borrarlos si ya no los necesitamos. Mediante el proyecto no necesitamos recordar qu ficheros se necesitan para compilar la aplicacin, basta con pulsar en el botn Build (Generar) y la aplicacin se generar encontrando automticamente todos los componentes necesarios.

Figura 1 El administrador de proyectos Existen cinco pginas que identifican cada uno de los tipos de ficheros ms una que incluye

todas a todas las dems. Este es el contenido de cada una de ellas:

Data (Datos)

Engloba todos aquellos ficheros relacionados con el manejo de datos.

Tipo Descripcin

Databases (Bases de datos)

Referencias a todas las bases de datos incluidas en la aplicacin.

Free Tables (Tablas libres) Son tablas que no pertenecen a ninguna base de datos.

Queries (Consultas) Consultas SQL no actualizables.

Para cada base de datos se guardan los siguientes datos:

- 2 - El Administrador de Proyectos- 1 -

Tipo Descripcin

Tables (Tablas)

Tablas .DBF asociadas a la base de datos

Local Views (Vistas locales)

Consultas SQL actualizables.

Remove Views (Vistas remotas)

Vista de otras tablas va ODBC.

Connections (Conexiones)

Conexiones que hacen posible las vistas remotas.

Stored Procedures (Procedimientos almacenados)

Procedimientos incorporados a la base de datos.

Documents (Documentos)

Incluye los formularios, informes y etiquetas.

Tipo Descripcin

Forms (Formularios)

Formularios de entrada de datos.

Reports (Informes)

Formatos de diseo de informes.

Labels (Etiquetas)

Formatos de diseo de etiquetas.

Class Libraries (Bibliotecas de clases)

Bibliotecas de clases visuales.

Code (Cdigo)

Cdigo fuente del programa, libreras FLL y otras aplicaciones APP EXE generadas con Visual FoxPro. Tipo Descripcin

Programs (Programas)

Programas .PRG y cualquier otro tipo de programas (SPR,MPR)

API Libraries (Bibliotecas API) Libreras .FLL construidas en C

Applications (Aplicaciones) Otras aplicaciones Visual FoxPro


Other (Otros)

Otro tipo de ficheros: mens, ficheros de texto, bitmaps, etc.

Tipo Descripcin

Menus (Mens)

Ficheros de definicin de mens .MNX

Text Files (Archivos de Texto) Ficheros de texto y ficheros de definicin de constantes .H

Other Files (Otros archivos)

Archivos en alguno de los formatos grficos soportados por Visual FoxPro, por ejemplo BitMap (.BMP) , o archivos de iconos (.ICO)

Ajustes de la ventana del administrador de proyectos Segn las necesidades del programador, la ventana del administrador de proyectos puede

adoptar varias posiciones y tamaos. En primer lugar, si el tamao de la ventana es demasiado grande, sta puede apilarse en el

borde superior de la ventana, debajo de la barra de mens, al estilo de cualquier barra de herramientas. En ese momento lo nico que se visualizar sern las seis pestaas de las pginas de objetos del administrador de proyectos. Para acceder a cualquiera de las pginas basta con pulsar en la etiqueta adecuada.

Los botones de comando existentes en la parte derecha de la ventana de formularios se trasladan de forma automtica al men accesible desde el botn derecho del ratn. Es decir, para acceder a las propiedades de cualquier objeto, habr que pulsar el botn derecho del ratn.

Figura 2 El administrador de proyectos acoplado debajo de la barra de mens Otra posibilidad de minimizar al mximo la ventana del administrador de proyectos consiste en

utilizar el botn de comando situado en la parte superior derecha de la ventana. Este botn de comando minimiza la ventana convirtindola en una especie de barra de herramientas. Siguen estando accesibles todas las pginas de ficheros, sin embargo, para ver su contenido, es necesario pulsar en la pgina deseada y sta se visualiza debajo de la etiqueta elegida.

Figura 3 - El administrador de proyectos como barra de herramientas Otra caracterstica interesante es que las pginas de datos se pueden mover a cualquier parte de

la pantalla. Para ello es necesario que la ventana del administrador de proyectos adopte una de las dos formas descritas anteriormente.

Marque la pestaa de la pgina deseada y arrastre la pgina al lugar deseado. Para que la pgina est siempre visible marque la chincheta.

Cuando desee cerrar la pgina, marque en el botn de comando de cierre. La pgina volver a estar disponible en la ventana del administrador de proyectos.


Figura 4 - Pginas del administrador de proyectos Cada vez que arrancamos Visual FoxPro, ste recuerda la posicin y tamao de la ventana del

ltimo proyecto utilizado, siendo posible adems, abrirlo cada vez.

Opciones de proyectos Existen dos pginas relacionadas con la edicin de proyectos. Son las pginas Ver y Proyectos.

Pgina Projects (Proyectos)

Mediante esta pgina configuramos el acceso a los distintos ficheros del proyecto.


Figura 5 -Opciones de proyecto

Project double-click action (Al hacer doble clic en proyecto). Indica qu accin se realiza al pulsar doble clic en cualquier archivo del proyecto. Run selected file (Ejecutar archivo seleccionado) Ejecuta el archivo

seleccionado en caso de ser un formulario, un informe, una etiqueta, un programa o un men.

Modify selected file (Modificar archivo seleccionado) Modifica el archivo seleccionado en cualquier caso.

Prompt for Wizards (Pedir Asistentes) Cuando se crea un nuevo fichero da opcin a utilizar un asistente para generar el mismo. Un asistente gua al usuario y le pide la informacin necesaria para poder generar el nuevo fichero de forma ms o menos automtica.

Display user-defined container icons (Mostrar iconos contenedores definidos por el usuario)

Por defecto el icono que muestra una clase es el que corresponde a su clase base. No obstante, mediante la activacin de esta casilla de verificacin se puede mostrar en la ventana de proyecto en la pgina clases el icono con el que se haya personalizado cada clase.

Source control options (Opciones del control de cdigo fuente) Existen aplicaciones, como Visual SourceSafe o Surround SCM , que permiten llevar un riguroso control sobre las modificaciones que un grupo de desarrollo efecta en un proyecto. Desde este grupo de opciones es posible indicar qu aplicacin vamos a utilizar y cmo se va a comportar cuando agreguemos, modifiquemos o eliminemos algn componente del proyecto.


Opcin Descripcin

Active source control provider (Proveedor de cdigo activo)

Indica el nombre de la aplicacin que se va a utilizar como control

Automatically add new projects to source control (Agregar automticamente nuevos proyectos al control de cdigo de origen)

Especifica si los nuevos proyectos que se vayan a crear, se incluirn por defecto en la aplicacin de control de cdigo fuente.

Check out files upon modify (Desproteger los archivos al modificarlos)

Los archivos sometidos al control de cdigo de origen, se protegen para evitar que dos usuarios puedan realizar modificaciones al mismo tiempo. Esta opcin indica que si un archivo ya est siendo modificado por otro usuario, cuando un segundo usuario intente modificarlo, ver un mensaje de error, indicndole que no puede realizar modificaciones.

Add files to source control upon add (Agregar archivos al control de cdigo al agregarlos al proyecto)

Si elige esta opcin, cuando aada un nuevo archivo al proyecto, ste entrar a formar parte automticamente dentro del grupo de archivos bajo control de cdigo fuente.

Remove files from source control upon removal from project (Quitar archivos del control de cdigo de origen al quitarlos del proyecto)

Cuando marca esta opcin, al quitar un archivo del proyecto, se elimina automticamente del control de cdigo de origen. Si omite esta opcin, ste permanecer activo en el control de cdigo, aunque ya no est presente en el proyecto.

Display dialog box for shortcut menu commands (Mostrar el cuadro de dilogo para los comandos de men contextual)

Admite varios ficheros a los cuales aplica el comando de control de origen, cuando se selecciona un comando desde el men de contexto.

Text Generation (Generacin de texto)

Indica el nombre del programa cuya misin es generar un fichero de texto representativo de los formularios, etiquetas, mens, informes, bibliotecas de clases cada vez que se protege el proyecto.

Project Class (Clase de proyecto)

Nombre de la clase que generara el objeto ProjectHook del archivo de proyecto actual.


Pgina View (Ver)

Esta pgina permite definir qu elementos se van a visualizar.

Figura 6 -Ver Opciones

Status bar (Barra de estado) Consiste en el rea inferior de la ventana. Se utiliza para visualizar diversa informacin acerca del estado de Visual FoxPro, por ejemplo, el alias de la tabla activa, el mensaje correspondiente a la opcin de men seleccionado, estado de las maysculas, insercin, etc. Modifica el estado de SET STATUS.

Clock (Reloj) Muestra el reloj en la barra de estado. Correspondiente al comando SET CLOCK.

Command results (Resultados de comando) Muestra el resultado de la ejecucin de un comando en la ventana principal de Visual FoxPro.

System messages (Mensajes de sistema) Habilita la visualizacin de los mensajes de sistema en la barra de estado. Correspondiente al comando SET NOTIFY.

Open last project on startup (Abrir el ltimo proyecto al iniciar) Abre el ltimo proyecto utilizado cada vez que arranca Visual FoxPro.

Most recently used list contains (La lista de proyectos usados mas recientemente contiene)

Aade al men File (Archivo) una lista de los proyectos utilizados recientemente.


List display count (Elementos en lista Intellisense) Determina el nmero mximo de elementos que se mostrarn inicialmente en los cuadros combinados de Intellisense. El valor por defecto es 15 asimismo como el valor mnimo.

Compilacin de proyectos Como objetivo final, un proyecto persigue la generacin de aplicaciones distribuibles e

independientes. Existen tres tipos de ficheros como producto de la compilacin de un proyecto:

Fichero Descripcin

Aplicacin (APP) Este tipo de ficheros slo se pueden ejecutar desde el entorno de desarrollo de Visual FoxPro. Son tiles para realizar las pruebas finales de un proyecto.

Ejecutable (EXE) Se deben generar ejecutables cuando la aplicacin est lista para ser instalada en otros lugares. Este ejecutable contiene todos los formularios, informes, etiquetas, programas, mens incluidos en el proyecto.

DLL (DLL) Este tipo de ficheros requiere la presencia de clases OLE pblicas definidas en el proyecto. Cuando se crea un fichero de este tipo, es posible hacer referencia a l desde cualquier otra aplicacin, puesto que lo que se acaba de crear es un servidor de automatizacin.

Incluir / Excluir archivos

La aplicacin / ejecutable contiene todos los ficheros marcados como incluidos en el proyecto. De esta forma, se incluyen todos los formularios, programas, imgenes en la aplicacin. Por tanto, slo hay que llevar al destino de la instalacin la aplicacin / ejecutable. No es aconsejable, sin embargo, incluir ficheros que puedan modificarse en tiempo de ejecucin, tales como tablas, ficheros de inicializacin (INI), si bin, determinadas tablas que no se han de modificar, pueden incluirse en el proyecto para que estn presentes en la aplicacin final. Para incluir / excluir ficheros, proceda del siguiente modo:

1. Pulse el botn derecho sobre el fichero que desee incluir / excluir. Del men de contexto que visualice, escoja la opcin correspondiente. Si un archivo ya estuviera incluido, la opcin que se visualiza es Exclude (Excluir), de otro modo se visualiza Include (Incluir).

2. Escoja la opcin Include / Exclude (Incluir / Excluir) del men Project (Proyecto) en la barra de mens estando posicionado en el archivo correspondiente en el proyecto.

Establecer principal

Para poder generar una aplicacin, sta debe iniciarse desde un fichero de programa, formulario o men. Decimos entonces que este fichero es el inicio de toda la aplicacin, es decir, el principal. Esta propiedad slo la puede tener uno de los ficheros incluidos en el proyecto. Para que un fichero tenga esta propiedad activada, se puede proceder de la siguiente forma:

1. Escoja Set Main (Establecer Principal) del men de contexto que aparece al pulsar el botn derecho sobre el archivo. No es posible establecer como principal el archivo que est excluido del proyecto.

2. Escoja Set Main (Establecer Principal) del men Project (Proyecto) de la barra de mens.


Opciones de generacin

Cuando se propone generar un proyecto, se le pide que complete una informacin relativa al modo en que se va a compilar el prximo proyecto. La generacin y compilacin de los archivos relativos al proyecto se hace siempre de forma incremental, es decir, no se vuelven a compilar aquellos ficheros que no se han modificado desde la ltima generacin. Veamos de qu opciones hablamos:

Figura 7 -Opciones de generacin

Build Action (Accin de generacin) Cuando genere un proyecto, puede escoger una de las cuatro opciones que aqu visualizamos: Rebuild project (Volver a generar el proyecto). Comentemos acerca de esta

opcin en primer lugar que el proyecto no slo guarda informacin acerca de los ficheros que lo componen sino que, adems, incluye la versin compilada de los ficheros ejecutables, tales como formularios, programas, mens o procedimientos almacenados en la base de datos. Esta opcin permite volver a regenerar esta informacin sin necesidad de volver a generar una nueva versin de la aplicacin o el ejecutable. Como ya se ha comentado, la generacin siempre se hace de forma incremental.

Application (app) (Aplicacin (app)). Esta opcin compila todos los archivos y genera un fichero con extensin APP. Este fichero slo se puede ejecutar desde el entorno de desarrollo de VFP.

Win32 executable / COM server (exe) (Ejecutable Win32 o servidor COM (exe)). Esta opcin genera un fichero ejecutable (EXE) directamente desde el sistema operativo. De esta forma, se pueden distribuir aplicaciones libremente.

Single-threaded COM server (dll) (Servidor COM de subproceso nico (dll)) y Multi-threaded COM server (dll) (Servidor COM de subproceso mltiple (dll)) Cuando se escoge esta opcin, el tipo de fichero obtenido es una librera de enlace dinmico (DLL) que se puede utilizar desde cualquier otra aplicacin como un servicio Web por ejemplo.

Options (Opciones) Este grupo de opciones afectan directamente al modo en que se va a generar la aplicacin. Recompile all files (Volver a compilar todos los archivos). Como ya se ha

comentado anteriormente, cada vez que se genera el proyecto, slo se compilan aquellos archivos que han sido modificados desde la ltima generacin. Activando esta opcin impediremos la compilacin incremental y se volvern a compilar todos los archivos.


Display Errors (Mostrar errores). Cuando se realiza la generacin y se producen errores de compilacin, se genera de forma automtica un fichero de seguimiento de errores. Este fichero tiene el mismo nombre que el proyecto que se pretende generar, pero con extensin .ERR. El hecho de activar esta opcin, hace que se visualice por pantalla este fichero despus de realizar la compilacin.

Run after build (Ejecutar despus de generar). Esta opcin permite ejecutar la aplicacin automticamente despus de haber sido generada

Regenerate component Ids (Volver a generar Id. De componentes). Si es la primera vez que se invoca la generacin de la aplicacin, instala y registra los servidores de automatizacin definidos en el proyecto.

Control de versiones

Cuando se genera un ejecutable Windows, existe informacin adicional guardada dentro del propio ejecutable. Esta informacin abarca desde el Copyright de la empresa al nmero de versin de la aplicacin.

Figura 8 - Versin EXE

Version Number (Nmero de versin) Se utiliza el nmero de versin para llevar un completo control sobre las compilaciones que se han efectuado y as poder comparar este nmero de versin con el existente en otras instalaciones. Se divide en tres campos, veamos cual es la utilidad de cada uno: Major (Principal). Aqu indicamos el nmero de versin principal. Admite cuatro

cifras Minor (Secundaria). Nmero de versin secundaria. Admite cuatro cifras Revision (Revisin). Admite cuatro cifras y corresponde al nmero de revisin o

compilacin efectuados hasta el momento. Este nmero se autoincrementa cada vez que se compila si se activa la casilla Auto Increment (Incrementar automticamente). De este modo es posible saber cuntas versiones se han realizado de la aplicacin hasta el momento actual.

Version Information (Informacin de la versin)


Agrupadas en siete categoras, vemos una lista de caractersticas de la aplicacin. El contenido a aplicar para cada categora es el siguiente: Comments (Comentarios). Comentarios acerca de la aplicacin, su utilidad o

aplicacin. Company Name (Nombre de organizacin). Nombre de la empresa a la que

pertenecen los derechos de la aplicacin. File Description (Descripcin del archivo). Descripcin de la aplicacin, en

concreto del fichero ejecutable o librera DLL en cuestin. Legal Copyright (Copyright legal). Datos de los derechos de copia de la

aplicacin. Legal Trademarks (Marcas comerciales legales). Nombre de las marcas

registradas propietarias de la aplicacin. Product Name (Nombre del producto). Nombre genrico del producto o marca. Language ID (Id. De idioma). Identificador de idioma.

Informacin de proyecto La informacin mostrada en este cuadro de dilogo se divide en tres pginas. La funcin de este

cuadro de dilogo es guardar informacin adicional al proyecto que se est desarrollando, as como modificar la inclusin / exclusin de archivos en la aplicacin, o determinar el contenido de la informacin relativa a servidores de automatizacin.

Proyecto

En esta pgina se completa la informacin referente al autor, al directorio actual del proyecto o si ha de guardar informacin para depuracin. Veamos cada una de las opciones:

Figura 9 - Informacin de proyecto.


Campo Descripcin

Datos del autor Este concepto agrupa los campos Author, Company, Address, City, State, Country, Postal code (Autor, Organizacin, Direccin, Ciudad, Estado, Pas, Cdigo Postal). Se utiliza para guardar la informacin relativa al autor de la aplicacin.

Home (Local) Carpeta donde reside el proyecto.

Last built (ltima compilacin)

Fecha y hora de la ltima compilacin.

Debug info (Informacin de depuracin)

Indica si ha de guardar informacin de depuracin en la aplicacin con el fin de visualizar el cdigo fuente cuando se active la ventana de depuracin.

Encrypted (Encriptado)

Crea una aplicacin codificada en la que no se puede visualizar ningn texto reconocible

Attach icon (Adjuntar icono)

Especifica el icono que se va a asociar a la aplicacin. Este fichero ICO se guarda dentro de la aplicacin generada para poder ser visualizado en la ventana del explorador.

Files (Archivos)

Desde esta pgina se accede a la lista de archivos referenciados en el proyecto. La lista est ordenada por orden alfabtico y muestra la siguiente informacin:

Figura 10 - Informacin de archivos.


Desde esta pgina se accede a la lista de archivos referenciados en el proyecto. La lista est ordenada por orden alfabtico y muestra la siguiente informacin:

Columna Descripcin

Type (Tipo)

Muestra un icono identificativo del tipo de archivo.

Name (Nombre)

Nombre fsico del archivo

Last modifiead (ltima modificacin)

Fecha de la ltima modificacin del archivo

Included (Incluido)

Aparte del mtodo que se ha visto anteriormente, para incluir / excluir archivos, se puede utilizar esta columna

Code Page (Pgina de cdigos)

Esta columna identifica la pgina de cdigos con la que fue creado el archivo en cuestin. Para que la informacin que se muestra en esta columna est actualizada, ser necesario utilizar el botn de comando Update native code pages (Actualizar pginas de cdigo nativas).

Servers (Servidores)

Si el objetivo final es crear una aplicacin servidora de automatizacin, es imprescindible consultar el contenido de esta pgina.

Figura 11 - Informacin de servidores.


Para cada clase definida en el servidor, se muestra la siguiente informacin:

Dato Descripcin

Class library (Biblioteca de clases)

Nombre de la biblioteca de clases donde se ha definido esta clase

Class name (Nombre de clase)

Nombre de la clase

Instancing (Creando instancia)

Indica si se van a permitir ejecutar varias instancias del mismo servidor, o por el contrario, cuando se haga referencia a esta clase va a ser la misma instancia siempre.

Description (Descripcin)

Comentario asociado a la clase

Help file (Archivo de ayuda)

Nombre del fichero de ayuda

Help context ID (Id. de contexto de ayuda)

Nmero de tpico de ayuda

Desarrollo de aplicaciones para grupos de trabajo El gran problema del desarrollo en equipo de aplicaciones complejas suele ser la coordinacin

entre todos los usuarios que estn desarrollando mdulos a la vez. Una de las soluciones adoptadas hasta la fecha, suele ser la de dividir la aplicacin en mdulos independientes y asignar a cada usuario uno de esos mdulos. Sin embargo, la actual filosofa de desarrollo propuesta por Visual FoxPro impide continuar con esta prctica, dado que se suceden de forma cntnua cambios que van a afectar a todos los usuarios. Hablemos, por ejemplo, qu ocurre cuando alguien decide modificar una clase definida en una biblioteca de clases propia. Obviamente, si el usuario est trabajando con una copia local de la biblioteca de clases, slo l va a percibir los cambios que est efectuando, dejando a un lado el problema que puede suponer que haya otro usuario modificando la misma clase en su copia local.

Por tanto, se hace necesario utilizar alguna herramienta que permita el desarrollo en equipo y permita mantener una nica versin de cada fichero para todos los usuarios. La herramienta se llama Visual Source Safe, y es el complemento ideal para desarrollo en equipo con Visual FoxPro.

Creacin del control de proyectos Para que un proyecto pueda ser incluido en el control de cdigo de orgen proporcionado por

Visual SourceSafe, hemos de seguir los siguientes pasos :

1. Activar el proveedor de control de cdigo de orgen. Se activa en la pgina Proyectos del cuadro de dilogo Opciones.

2. Elegir la opcin Agregar proyecto al control de cdigo desde el men Proyecto si ya

exista y no estaba bajo control de cdigo de origen.. 3. Agregar automticamente nuevos proyectos. Mantener esta opcin activa por defecto si

se desea que todos los nuevos proyectos que se creen queden bajo el control de cdigo.


Figura 12 Opciones de control de cdigo de origen

Cuando se han completado estos pasos, se muestra el cuadro de dilogo de peticin de cdigo

de usuario, clave y base de datos correspondiente a Visual Source Safe. En el siguiente cuadro de dilogo, al usuario se le pide que introduzca el nombre del proyecto que se desea crear en VSS. Todos los proyectos agregados al control de cdigo de orgen, dependen del directorio raz identificado como $/ dentro de la base de datos actual que ha sido seleccionada previamente desde la ventana de login.

Figura 13 Login de entrada a Visual Source Safe

Figura 14 - Aadiendo el proyecto actual al control de cdigo de orgen

Visual Source Safe analiza a continuacin el contenido del proyecto especificado, mostrando el siguiente cuadro de dilogo. La finalidad del mismo es mostrar todos los archivos presentes en el fichero PJX de VFP, dejando al usuario la posibilidad de eliminar determinados archivos que no deban ser procesados por el control de cdigo de origen.


Figura 15 - Lista de ficheros incluidos en el proyecto PJX

Al finalizar todo este proceso, el proyecto queda incluido dentro del control de cdigo y todas las modificaciones que se hagan sobre el, quedarn reflejadas en la base de datos de VSS. Todos los archivos que estuvieran relacionados en el proyecto de VFP quedarn, a partir de ese momento, protegidos, para evitar que cualquier usuario que no utilice el control de cdigo de orgen pueda modificarlos por error.

Figura 16 - Indicadores de archivos protegidos

Compartir proyectos con VSS Es realmente sencillo compartir ficheros entre grupos de desarrollo y que todos los cambios que

realice cada uno individualmente queden registrados. Lo importante es que, aunque no se puedan compartir proyectos PJX, cada desarrollador trabaje con su copia del proyecto y acceda a los ficheros compartidos desde ste. Debido a la alta integracin que existe entre VFP y VSS, cada vez que se aade un nuevo fichero al proyecto, queda registrado bajo el control de cdigo.

Cada nuevo usuario que pretenda acceder al mismo proyecto, ha de unirse al grupo de desarrollo de la siguiente forma:

Proteger el proyecto desde Source Safe. Esto se hace as para que se pueda realizar una completa del proyecto en el directorio local. Para ello elija la opcin Ckeck In desde el men secundario al pulsar sobre el nombre de proyecto


Figura 17 Proteger el proyecto desde VSS

Combinar proyecto de control de cdigo de origen. Esta opcin est situada en el men archivo. Tras elegirla, se muestra el cuadro de dilogo que visualizamos en la Figura 18. Hemos de introducir la siguiente informacin:

Nombre del directorio local. Especificamos el directorio donde se van a realizar las copias del proyecto y los ficheros relacionados.

Proyecto origen. Seleccione el proyecto desde el que se pretende realizar la copia.

Figura 18 Combinar proyecto de control de codigo de origen

Antes de realizar la copia, se muestra el siguiente cuadro de dilogo como confirmacin de los cambios que se van a realizar. En cuanto haya finalizado el proceso, se habr creado en el directorio local (C:\LOCAL) una copia del proyecto y todos los archivos relacionados del servidor (L:\MASTER).


Figura 19 Opciones de combinacin


Compartir ficheros de un proyecto entre varios usuarios

Cmo compartimos los ficheros de un proyecto entre varios usuarios? Vamos a seguir las siguientes pautas:

Activar la opcin Agregar nuevos proyectos al cdigo de orgen. De esta forma, todos

los proyectos que se vayan creando sern controlados por VSS. Aadir nuevos archivos al proyecto. Cada vez que se aade un nuevo archivo al

proyecto, entra a formar parte del proyecto generado en VFP y VSS

Figura 20 Agregar archivo al control de cdigo de origen

Compartir los archivos del proyecto. Elija la opcin Compartir Archivos del men Control de cdigo de origen, presente en Proyecto. Ver un cuadro de dilogo como el que se muestra en la Figura 18. Marque el proyecto de VSS del que desea compartir sus ficheros. En este caso, el proyecto se llama Admin, marque sobre l, y elija Compartir (Share). A continuacin se muestra un cuadro de dilogo que pide un nombre para el nuevo proyecto que se ha de crear y a continuacin responda si cuando se le pregunte si desea crear el directorio. En este directorio se alojar el nuevo proyecto de VSS que contendr los archivos compartidos.


Figura 21 Compartir el proyecto actual

Control del estado de un fichero Cuando un miembro del grupo de trabajo se dispone a modificar un fichero incluido en un

proyecto, ha de tener en cuenta el estado de ese fichero. Por ejemplo, si algn otro usuario est modificando un programa, si realiza modificaciones en ese momento, ha de tener en cuenta que no ver las modificaciones del otro usuario hasta que ste lo cierre.

Estado Descripcin

El archivo ha sido desprotegido en este proyecto. Por tanto se puede volver a proteger desde este proyecto

El archivo ha sido desprotegido en este proyecto y algn otro ms dentro del mismo grupo de desarrollo. Esto significa que hasta que el ltimo usuario no haya protegido este fichero, no se podr volver a proteger.

El archivo ha sido desprotegido por otro usuario.

El archivo est protegido. Debe desprotegerlo para poder realizar modificaciones.

El archivo ha sido combinado en base a varias versiones. Se puede proteger el archivo tras comprobar las modificaciones.

El archivo se ha combinado pero han aparecido conflictos que se han de resolver antes de proteger el archivo.

En este caso no se puede determinar el estado del archivo.


Trabajo diario con VSS

El uso de VSS por parte de VFP es totalmente transparente de cara al usuario. Para crear, modificar o eliminar cualquier fichero incluido en el proyecto, se han de seguir los mismos pasos que antes, sin ningn cambio aparente. Lo que ocurre es que, cuando intentamos modificar cualquier fichero, VSS nos advierte del cambio que vamos a hacer y nos pide desproteger el fichero.

Porque?. La razn es que cuando un proyecto se agrega al control de cdigo de origen, todos los ficheros de cdigo, exceptuando las bases de datos y tablas, quedan protegidos de solo lectura. Cualquier usuario que no forme parte del grupo de trabajo e intente modificar algn fichero, no podr hacerlo a no ser que lo desproteja el fichero desde el sistema operativo.

Usualmente, slo se permite a un usuario modificar un fichero pero, de todos modos se admite que varios usuarios modifiquen el mismo fichero. Es VSS es que se encarga posteriormente de combinar todas las modificaciones realizadas y obtener una versin final del archivo.

Figura 22 Desproteger archivos.

Si un archivo est desprotegido, para el usuario que lo est modificando el smbolo que ver al

lado del nombre del fichero, ser distinto del usuario que estuviera modificando un proyecto compartido. ste vera una marca como la que puede ver en la tabla, indicando que existe otro usuario modificando el fichero en ese momento. Para tener actualizados los estados de proteccin de cada fichero, se ha de pulsar F5.

Estado Descripcin

Protegido. Ningn usuario est haciendo modificaciones.

Desprotegido. Usuario local

Protegido. Otros usuarios

Cuando se finalizan las modificaciones al fichero, se ha de volver a proteger, para que otro

usuario pueda realizar los cambios que desee.

Control de versiones Entre el maremgnum de modificaciones realizadas por distintos programadores dentro de un

grupo de desarrollo, es frecuente perder la pista a las que hace cada uno. Si alguin realiza un


cambio y no lo comunica a los dems, pueden ocurrir pequeos desastres. Con VSS es posible seguir el rastro de todas las versiones, es decir, modificaciones, realizadas por todos los componentes de un grupo de trabajo.

Para ver el historial de modificaciones de un fichero concreto, pulse el botn derecho del ratn sobre el fichero y elija la opcin Mostrar Historial.

Figura 23 Mostrar Historial

Ver diferencias Al elegir esta opcin, vamos a poder ver las diferencias existentes entre dos versiones. Esto

quiere decir que veremos la versin actual y la versin anterior al mismo tiempo. Para poder distinguir las diferencias, stas se marcan de distinto color. Veamos que cdigos de color se utilizan:

Color Descripcin

Azul Lneas borradas

Rojo Lneas modificadas

Verde Lneas insertadas

En la parte superior de esta ventana vemos tres grupos de botones de comando relacionados.

Botones Descripcin

Este primer grupo se utiliza para realizar bsquedas hacia delante y hacia atrs en todo el texto. Tiene una opcin muy interesante y es que permite marcar todas las lineas que contengan la cadena buscada. De este modo se puede hacer uso de estas marcas para ir directamente a ellas mediante el siguiente grupo de botones de comando

Permiten marcar lneas para volver a ellas dirctamente sin tener que recorrer todo el cdigo. El primer botn permite marcar una lnea, los dos siguientes permiten ir a la marca anterior y posterior, respectivamente. El ltimo permite eliminar la marca actual.


Ir a la anterior/siguiente diferencia.

Figura 24 Diferencias entre versiones

Distribucin de aplicaciones Cuando la aplicacin ya est lista para ser distribuida, se genera un ejecutable y, mediante el

asistente de instalacin, se generan los discos para su distribucin. Para ello necesitamos especificar un directorio de origen de la aplicacin, cuyo contenido se comprimir junto con las bilbiotecas y ficheros del runtime de Visual FoxPro.

Paso 1 Encontrar archivos

Para realizar correctamente la distribucin de una aplicacin, se han de copiar el archivo ejecutable y todos los que ste necesite a un directorio de distribucin. Considere que el ejecutable contiene todos los formulario, informes o mapas de bits marcados como incluidos en la aplicacin. Es conveniente en informacin de proyecto, asignar un icono para identificar la aplicacin desde Windows. Tambin deber copiar a este directorio la base de datos y las tablas relacionadas, as como todos los ficheros marcados como excluidos del proyecto. Posiblemente existan ficheros que no se incluyen directamente en un formulario o informe, y deber tener en cuenta que no se reflejan en el proyecto y, por tanto no se guardan en el ejecutable. Ha de copiarlos tambin. Por ltimo existen ficheros de aplicacin, libreras de enlace dinmico o controles Activex que tambin se han de copiar al directorio de distribucin para la aplicacin funcione correctamente una vez se haya instalado en otro puesto de trabajo.


Figura 1 Paso 1 Encontrar archivos

Paso 2 Especificar componentes

Existe un componente obligatorio que se ha de instalar siempre junto con la aplicacin la primera vez que se instala. Se trata del runtime de Visual FoxPro. Pero, existen otros componentes adicionales que probablemente tambin se deban instalar. Veamos cuales son:


Runtime de Microsoft Graph 5.0. Se debe instalar si la aplicacin hace uso de

este componente. Controladores de ODBC. Se han de instalar los componentes ODBC

necesarios si se accede a otras fuentes de datos externas. Desde esta opcin se eligen los componentes necesarios.

Figura 2 Controladores ODBC disponibles

Servidores de automatizacin. En el caso de que la aplicacin contenga servidores de automatizacin, se agregarn a esta lista aquellos que se tengan que registrar en el momento que se realice la instalacin en el cliente.

Figura 3 Servidores de automatizacin de la aplicacin

Paso 3 Crear directorio imagen de disco

La forma en que se distribuye una aplicacin puede variar dependiendo del formato del soporte elegido para su distribucin. Actualmente se pueden usar disquetes de 35 y de 5 pulgadas, pero se va imponiendo el uso del CDROM como soporte, entonces lo adecuado puede ser la opcin de instalacin en red.


Figura 4 - Paso 3 Crear directorio imagen de disco

Paso 4- Especificar opciones de instalacin

Durante la instalacin se puede pedir informacin acerca de la empresa propietaria de los derechos de copia, as como el nombre de la aplicacin que se est instalando. Despus de realizar la instalacin, puede ser necesario configurar sta para su correcto funcionamiento o mostrar la informacin de los cambios realizados en la ltima instalacin. De esto se encarga el cuadro de texto inferior que llama a un ejecutable inmediatamente despus de finalizar la instalacin. En este caso se ha puesto como ejemplo abrir el fichero leame.txt mediante el programa Bloc de notas (Notepad) .


Figura 5 Paso 4 Especificar opciones de instalacin

Paso 5 Especificar destino predeterminado

En este paso se indica el directorio donde se va a instalar la aplicacin por defecto. Dependiendo del nivel de usuario requerido, se puede dejarle libertad de eleccin de grupo y directorio de trabajo.

Figura 6 Paso 5 Especificar directorio predeterminado

Paso 6 Cambiar configuraciones de archivos

Antes de finalizar definitivamente la generacin de los directorios de instalacin, vemos una lista de todos los archivos que se van a comprimir y distribuir. Vemos una cuadrcula con la lista de archivos:

Columna Descripcin

Archivo Nombre del archivo

Directorio de destino Ubicacin final del archivo. Admite tres posibles lugares: AppDir. Directorio de la aplicacin. Depender del

nombre que le haya dado el usuario durante la instalacin.

WinDir. Directorio donde est instalado Windows. Depende del nombre que le haya dado el usuario en la instalacin de Windows.

WinSysDir. Directorio de sistema de Windows 95, llamado siempre System y dentro del directorio de instalacin de windows (Windir)

Elemento del administrador de programas

Indica si el archivo crear un acceso directo en el grupo donde se ha instalado la aplicacin. Usualmente puede ser la aplicacin ejecutable, pero tambin puede llamarse a un editor de texto con el fin de editar las


ltimas modificaciones, o un fichero de ayuda de la aplicacin

ActiveX Cuando se incluye algn control ActiveX en el directorio de instalacin, ste es detectado como tal. Los controles ActiveX se instalan siempre en el directorio WinSysDir de forma automtica al instalar la aplicacin

Elemento del Administrador de programas

Trato aparte merece este tema, pues es bastante importante. La finalidad de esta casilla de verificacin es abrir un cuadro de dilogo con el que cumplimentar la informacin acerca de este archivo. Contiene tres cuadros de texto Campo Descripcin

Descripcin Descripcin de la aplicacin. Aparece como descripcin del acceso directo en el grupo creado durante la instalacin

Linea de comando. Especifica la lnea de comando del acceso directo. Se utiliza la macro %s como sustitucin del nombre del directorio de instalacin. Si se incluye una referencia concreta a un directorio que no coincide con el nombre que le ha dado el usuario durante la instalacin, probablemente no funcione correctamente.

Icono Especifica el icono asociado al acceso directo. Es necesario que este icono est presente en el directorio de instalacin.


Figura 7 Elemento del administrador de programas

Informe de instalacin

El paso 7 permite la finalizacin del asistente e inicia la secuencia de compresin de archivos y distribucin en directorios. Los elementos de runtime de VFP se comprimen en el directorio Distrib.Src situado a nivel de directorio de instalacin de VFP (Por ejemplo c:\vfp). De los componentes elegidos en el paso 2, se copiarn comprimidos en el directorio Compress, junto con los archivos comprimidos de la instalacin.

Figura 8 Informe de instalacin

Estructura de directorios de distribucin

Del directorio de distribucin parten varios subdirectorios importantes. Por una parte, el directorio Compress, que contiene todos los ficheros de la aplicacin, el runtime de Fox y los componentes elegidos. Por otra parte, los directorios de distribucin segn el dispositivo elegido. Se llaman Disk12, Disk144 y NetSetup. Cada uno de ellos contiene los mismos ficheros que el directorio Compres distribuidos segn sus necesidades de espacio. En este caso, la instalacin ha generado 4 disquetes de 5 y 4 disquetes de 3 .


Figura 9 Estructura de directorios de distribucin

Creacin del directorio de distribucin Para este cometido se puede utilizar una utilidad creada a tal efecto. Consiste en un formulario

que, en base a un proyecto y un directorio de destino, copia todos los ficheros relacionados en el proyecto, incluyendo el ejecutable, al directorio de destino.

Para que el directorio de instalacin no contenga archivos fuente, se ha de incluir en el campo comentarios del fichero que se desee incluir en la instalacin final un asterisco *.

Figura 25 Creacin del directorio de instalacin

CmdAceptar.Click()

LOCAL lExisteProyecto , ; lExisteDirectorio lExisteProyecto=FILE(THISFORM.cProyecto) lExisteDirectorio=Directory(THISFORM.cDirectorio) DO CASE CASE EMPTY(THISFORM.cProyecto) =MessageBox([Debe indicar un proyecto],48,[Error]) THISFORM.SetFocus([TXTPROYECTO]) RETURN CASE EMPTY(THISFORM.cDirectorio) =MessageBox([Debe indicar el directorio destino],48,[Error]) THISFORM.SetFocus([TXTDIRECTORIO]) RETURN CASE !lExisteProyecto =MessageBox([No existe el proyecto solicitado],48,[Error])


THISFORM.SetFocus([TXTPROYECTO]) RETURN CASE !lExisteDirectorio IF MessageBox([No existe el directorio solicitado.]+CHR(13)+; [Desea crearlo?],32,[Pregunta]) = 1 MD (THISFORM.cDirectorio) ENDIF ENDCASE THISFORM.Instalar() THISFORM.Hide() THISFORM.Release()

Este evento se asegura de que no se produzca ningn error durante la introduccin de datos. Comprueba que se hayan introducido los nombres de proyecto y de directorio. Tambin comprueba que el proyecto exista, si es que se ha introducido desde el cuadro de texto. Y finalmente, si el directorio que el usuario especifica no existe, se le pregunta si desea crearlo.

THISFORM.Instalar()

* Declaracin de variables ************************** LOCAL cNombre,cDestino * Activamos fichero de procedimientos ************************************* SET PROCEDURE TO UTILES * Inicializacin de variables ***************************** cNombre = SoloNombre(THISFORM.cProyecto) cRuta = ADDBS(SoloCamino(THISFORM.cProyecto)) cDestino = ADDBS(THISFORM.cDirectorio) * Nombre del fichero ejecutable ******************************* cEjecutable = cRuta + cNombre + [.EXE] * Abrimos el proyecto ********************* USE (THISFORM.cProyecto) IN 0 ALIAS Proyecto SELECT Proyecto * Copiamos el ejecutable ************************ COPY FILE (cEjecutable) TO (cDestino+cNombre+[.EXE]) * Si existe una base de datos * detectar si se ha de copiar tambin ************************************* LOCATE FOR TYPE=[d] IF FOUND() * Guardamos el nombre de la base de datos **************************************** cBaseDatos = LEFT(PROYECTO.NAME,LEN(PROYECTO.NAME)-1) cDirDatos = SoloCamino(cBaseDatos) * Indica si la base de datos est * en otro disco ********************************* lDisco = [:] $ cBaseDatos * Indica si la referencia a la


* base de datos es relativa ****************************** lRelativo = [..] $ cBaseDatos IF !lRelativo and !lDisco cDirBaseDatos = cRuta + addbs(cDirDatos) cDirBaseDatosDestino = cDestino + cDirDatos endif MD (cDirBaseDatosDestino) * Copiamos el directorio donde est * la base de datos *********************************** COPY FILE (cDirBaseDatos+[*.*]) TO (cDirBaseDatosDestino) ENDIF * Cerramos el proyecto ********************** SELECT PROYECTO USE

Este mtodo realiza la copia de ficheros del directorio original al de instalacin. Presupone que el ejecutable se encuentra en el mismo directorio que el proyecto. Copia tambin las bases de datos y tablas relacionadas teniendo en cuenta el directorio donde estn. Se asume tambien que las bases de datos y tablas se encuentran en el mismo directorio.

- INDICE 32 -

INDICE

2 - EL ADMINISTRADOR DE PROYECTOS-...................................................................................... 1 PROYECTOS................................................................................................................................................... 1

Data (Datos)............................................................................................................................................. 1 Documents (Documentos) ........................................................................................................................ 2 Class Libraries (Bibliotecas de clases) .................................................................................................... 2 Code (Cdigo) .......................................................................................................................................... 2 Other (Otros)............................................................................................................................................ 3

AJUSTES DE LA VENTANA DEL ADMINISTRADOR DE PROYECTOS ................................................................... 3 Pgina Projects (Proyectos)..................................................................................................................... 4

Project double-click action (Al hacer doble clic en proyecto). ............................................................................. 5 Prompt for Wizards (Pedir Asistentes).................................................................................................................. 5 Display user-defined container icons (Mostrar iconos contenedores definidos por el usuario) ............................ 5 Source control options (Opciones del control de cdigo fuente)........................................................................... 5

Pgina View (Ver) .................................................................................................................................... 7 Status bar (Barra de estado) .................................................................................................................................. 7 Clock (Reloj)......................................................................................................................................................... 7 Command results (Resultados de comando).......................................................................................................... 7 System messages (Mensajes de sistema)............................................................................................................... 7 Open last project on startup (Abrir el ltimo proyecto al iniciar) ......................................................................... 7 Most recently used list contains (La lista de proyectos usados mas recientemente contiene) ............................... 7 List display count (Elementos en lista Intellisense) .............................................................................................. 8

COMPILACIN DE PROYECTOS ....................................................................................................................... 8 Incluir / Excluir archivos ......................................................................................................................... 8 Establecer principal ................................................................................................................................. 8 Opciones de generacin ........................................................................................................................... 9

Build Action (Accin de generacin).................................................................................................................... 9 Options (Opciones) ............................................................................................................................................... 9

Control de versiones............................................................................................................................... 10 Version Number (Nmero de versin) ................................................................................................................ 10 Version Information (Informacin de la versin)................................................................................................ 10

INFORMACIN DE PROYECTO....................................................................................................................... 11 Proyecto ................................................................................................................................................. 11 Files (Archivos) ...................................................................................................................................... 12 Servers (Servidores) ............................................................................................................................... 13

DESARROLLO DE APLICACIONES PARA GRUPOS DE TRABAJO ....................................................................... 14 CREACIN DEL CONTROL DE PROYECTOS .................................................................................................... 14 COMPARTIR PROYECTOS CON VSS.............................................................................................................. 16 COMPARTIR FICHEROS DE UN PROYECTO ENTRE VARIOS USUARIOS............................................................. 19 CONTROL DEL ESTADO DE UN FICHERO ....................................................................................................... 20 TRABAJO DIARIO CON VSS.......................................................................................................................... 21 CONTROL DE VERSIONES ............................................................................................................................. 21 VER DIFERENCIAS ....................................................................................................................................... 22 DISTRIBUCIN DE APLICACIONES ................................................................................................................ 23

Paso 1 Encontrar archivos.................................................................................................................. 23 Paso 2 Especificar componentes......................................................................................................... 24 Paso 3 Crear directorio imagen de disco ........................................................................................... 25 Paso 4- Especificar opciones de instalacin.......................................................................................... 26 Paso 5 Especificar destino predeterminado........................................................................................ 27 Paso 6 Cambiar configuraciones de archivos .................................................................................... 27 Elemento del Administrador de programas ........................................................................................... 28 Informe de instalacin............................................................................................................................ 29 Estructura de directorios de distribucin............................................................................................... 29

CREACIN DEL DIRECTORIO DE DISTRIBUCIN ............................................................................................ 30 CmdAceptar.Click()................................................................................................................................ 30 THISFORM.Instalar() ............................................................................................................................ 31

- INDICE 33 -

INDICE ..................................................................................................................................................... 33

INDICE ALFABETICO .......................................................................................................................... 35

- INDICE ALFABETICO 34 -

INDICE ALFABETICO

A

Abrir, 7

B

Barra, 7

C

Compartir, 16, 18 Control, 19, 21 Control de versiones, 10 Creacin, 14

D

Desarrollo de aplicaciones para grupos de trabajo, 13 Distribucin de aplicaciones, 22

E

Establecer principal, 8

G

Generacin de proyectos, 8

I

Incluir / Excluir archivos en proyectos, 8 Informacin de la versin, 10 Informacin de proyecto, 11

L

Lista, 7

M

Mensajes, 7

N

Nmero de versin, 10

O

Opciones de generacin, 8 Opciones de proyectos, 4 Opciones del control de cdigo de origen, 5 Opciones., 6

P

Pgina Proyectos, 4 Pedir Asistentes, 5 Proyectos, 1 Proyectos., 1, 2

R

Reloj, 7 Resultados, 7

S

Servidores OLE, 12

T

Trabajo, 20

V

Ver, 21 Visual SourceSafe, 5

- INDICE ALFABETICO 35 -

2 - El Administrador de Proyectos- Proyectos Data (Datos) Documents (Documentos) Class Libraries (Bibliotecas de clases) Code (Cdigo) Other (Otros)

Ajustes de la ventana del administrador de proyectos Pgina Projects (Proyectos) Project double-click action (Al hacer doble clic en proyecto). Prompt for Wizards (Pedir Asistentes) Display user-defined container icons (Mostrar iconos contenedores definidos por el usuario) Source control options (Opciones del control de cdigo fuente)

Pgina View (Ver) Status bar (Barra de estado) Clock (Reloj) Command results (Resultados de comando) System messages (Mensajes de sistema) Open last project on startup (Abrir el ltimo proyecto al iniciar) Most recently used list contains (La lista de proyectos usados mas recientemente contiene) List display count (Elementos en lista Intellisense)

Compilacin de proyectos Incluir / Excluir archivos Establecer principal Opciones de generacin Build Action (Accin de generacin) Options (Opciones)

Control de versiones Version Number (Nmero de versin) Version Information (Informacin de la versin)

Informacin de proyecto Proyecto Files (Archivos) Servers (Servidores)

Desarrollo de aplicaciones para grupos de trabajo Creacin del control de proyectos Compartir proyectos con VSS Compartir ficheros de un proyecto entre varios usuarios Control del estado de un fichero Trabajo diario con VSS Control de versiones Ver diferencias Distribucin de aplicaciones Paso 1 Encontrar archivos Paso 2 Especificar componentes Paso 3 Crear directorio imagen de disco Paso 4- Especificar opciones de instalacin Paso 5 Especificar destino predeterminado Paso 6 Cambiar configuraciones de archivos Elemento del Administrador de programas Informe de instalacin Estructura de directorios de distribucin

Creacin del directorio de distribucin CmdAceptar.Click() THISFORM.Instalar()

INDICE INDICE ALFABETICO A B C D E G I L M N O P R S T V