Tutorial - SCM para WEBDEV

• Una versión de referencia de cada uno de los proyectos se almacena en un servidor. Este conjunto de versiones se llama "Repositorio".
• Cada desarrollador tiene una copia local de los diferentes proyectos.
  
• Cuando los desarrolladores desean realizar cambios en un elemento de un proyecto (página, reporte, consulta, etc.), deben indicar al SCM que serán propietarios temporales de dicho elemento. Para ello, el desarrollador debe extraer el elemento del repositorio.
• Esta operación permite que el desarrollador obtenga permisos exclusivos sobre el elemento y pueda realizar todos los cambios que desee.
• Los otros desarrolladores siguen trabajando con la copia de la versión de referencia del elemento (que se encuentra en el repositorio).
• Una vez que el desarrollador ha realizado los cambios, reintegra el elemento en el repositorio.
• Los demás desarrolladores reciben una notificación automática cuando se efectúa la reintegración. Así, pueden actualizar su copia local.
  

¿SCM o GitHub?
También se pueden compartir elementos fuente a través de GitHub.
El entorno permite guardar proyectos, ventanas, páginas, reportes, clases, conjuntos de procedimientos y código en un repositorio Git. Para obtener más información, consulte Compartir proyectos a través de Git.
Sin embargo, se recomienda utilizar el SCM. En el SCM, además de comparar texto, se pueden comparar otros objetos (como las propiedades de los controles, por ejemplo). Una interfaz específica del SCM permite fusionar y comparar elementos fácilmente.

• al instalar WEBDEV.
• al importar un proyecto al SCM.
• en cualquier momento, directamente desde WEBDEV o desde el administrador del SCM.

• HFSQL Classic,
• HFSQL Client/Server,
  
  

  Si el repositorio está en formato HFSQL Client/Server, se puede utilizar de forma remota.
• PCSCloud (solución paga, lista para usar). El modo PCSCloud permite acceder a las fuentes de los proyectos desde cualquier lugar, en cualquier momento. Este modo corresponde a una Nube privada (servidor dedicado) y ofrece numerosas opciones (plataforma específica, Centros de Control, etc.). Para obtener más información, consulte PCSCloud.
• SCMDrive (solución paga, lista para usar). El modo SCMDrive permite acceder a las fuentes de los proyectos desde cualquier lugar, en cualquier momento. Esta solución utiliza un servidor compartido. Para obtener más información, consulte SCMDrive.

Para facilitar el proceso, importaremos el proyecto a un nuevo repositorio local HFSQL Classic en el equipo de desarrollo. El funcionamiento es similar para otro tipo de repositorio.

1. Vaya a la página de inicio de WEBDEV (Ctrl +<).
2. En la página de inicio, haga clic en "Tutorial" y, a continuación, en "Tutorial - SCM para WEBDEV", haga clic en "Abrir el proyecto de ejercicio".

1. En la pestaña "SCM", en el grupo "Agregar proyecto", haga clic en "Agregar proyecto al SCM". El asistente para agregar proyectos al SCM se abre:
   
   Anteriormente no habíamos creado un repositorio. Vamos a crear uno.
   
   

   Vamos a crear un repositorio "Cliente/Servidor" en el servidor que instalamos en el tutorial Administrar una base de datos HFSQL Client/Server. Si no ha seguido este tutorial, deberá completar la lección sobre cómo instalar el servidor HFSQL.
2. Haga clic en "HFSQL Client/Server".
   
   

   Si el repositorio está en formato HFSQL Client/Server, se puede utilizar de forma remota.
3. La ventana de creación del repositorio HFSQL Client/Server se abre.
4. Especifique los parámetros del servidor HFSQL instalado previamente:
   
   • El nombre del servidor y el puerto.
   • El nombre y la contraseña del administrador.
5. Valide el nuevo repositorio (haga clic en "Crear repositorio"). Esta operación puede tardar bastante tiempo en modo Cliente/Servidor.
6. El repositorio se crea correctamente. Vamos a agregar el proyecto al repositorio.
7. Pase a la etapa siguiente. El usuario actual no puede acceder al servidor HFSQL.
   
   Vamos a crear un usuario. Introduzca la información necesaria y haga clic en "Crear cuenta".
8. El asistente le pide que guarde el proyecto en el subdirectorio "Proyectos" del repositorio.
   
   Acepte esta ubicación. Pase a la etapa siguiente.
9. Seleccione los elementos del proyecto que se agregarán al repositorio.
   
   Agregue todos los elementos del proyecto. Haga clic en "Todos" y vaya la etapa siguiente.
10. El asistente le pide que seleccione las dependencias del proyecto que se agregarán al repositorio. Las dependencias corresponden a todos los elementos externos necesarios para el proyecto (imágenes, hojas de estilo, etc.).
    Agregue todas las dependencias del proyecto. Pase a la etapa siguiente.
11. Valide la integración del proyecto en el SCM. El proyecto y sus elementos se agregan al repositorio.

Compartir elementos del proyecto
Cuando se agregan proyectos con recursos compartidos (análisis, páginas, etc.) al SCM, estos recursos también pueden compartirse con otros proyectos presentes en el SCM. Así, el elemento compartido solo se importa una vez en el SCM y los cambios realizados en ese elemento se aplican automáticamente a los demás proyectos.

Abrir un proyecto desde el SCM

En nuestro ejemplo, el proyecto se encuentra en el SCM y podemos utilizarlo directamente.

En un caso real, para que otros desarrolladores trabajen en un proyecto que se encuentra en el Administrador de Código Fuente, deben descargar una copia del proyecto en el equipo local.

En ese caso, siga los siguientes pasos:

1. Abra el proyecto desde el Administrador de Código Fuente. Para ello, vaya a la pestaña "Inicio", grupo "General", despliegue "Abrir" y seleccione "Abrir un proyecto desde el SCM".
2. En la pestaña "HFSQL C/S", introduzca los parámetros de ubicación del repositorio y valide (este paso solo es necesario si el proyecto actual no está incluido en el SCM):
   
3. En la ventana que aparece, indique la conexión y el directorio local si es necesario:
   
   Nota: Si ya ha abierto el proyecto desde el SCM, puede abrir el proyecto normalmente o sobrescribir el contenido (para obtener todo el proyecto).

Esta operación debe ser realizada una sola vez por cada desarrollador que utilice el proyecto.
El desarrollador que agregó el proyecto al Administrador de Código Fuente (usted en este caso) no tiene que realizar ninguna operación.

Estas operaciones solo son necesarias al abrir los proyectos alojados en el SCM por primera vez. La próxima vez, solo necesita abrir el archivo del proyecto que corresponde a la copia local.

• Cambiar una característica del proyecto.
• Modificar una página del proyecto.

Cambiar una característica del proyecto

Modificar una página del proyecto

Ahora vamos a modificar la página "PAGE_Product_form". Vamos a desplazar el botón "OK".

Para modificar un elemento del proyecto, éste debe extraerse.

Un elemento extraído (interfaz de usuario, código, etc.) puede modificarse como cualquier otro elemento de un proyecto que no está incluido en el SCM.
Sin embargo, los otros desarrolladores no pueden ver los cambios realizados en el elemento.
Si otros desarrolladores necesitan trabajar en el elemento extraído, utilizarán la versión del repositorio.

Esto permite que una aplicación evolucione conservando una versión estable en el repositorio.

Para modificar la página "PAGE_Product_form":

1. Seleccione "PAGE_Product_form" en el panel "Explorador de proyectos" y haga doble clic en él para abrirlo en el editor de páginas.
   
2. La extracción automática se activa al hacer el primer cambio. Basta con mover un control para extraerlo. También puede hacer clic en "Extraer" en la pestaña SCM de la cinta de opciones ().
3. La ventana de extracción aparece:
   
4. El SCM propone tres modos de extracción:
   • Exclusivo (recomendado): El elemento no estará disponible hasta que se vuelva a reintegrar. El elemento solo se puede extraer para realizar pruebas.
   • Para pruebas: El elemento puede modificarse, pero los cambios no se reintegrarán.
   • Múltiple: Otros usuarios también podrán consultar el elemento. En este caso, se pueden ver las diferencias de las versiones del elemento al reintegrarlo. Este modo está reservado para casos específicos y desarrolladores experimentados.
5. Extraiga la página en modo exclusivo. Conserve la opción "Exclusivo".
6. Escriba un comentario ("Desplazamiento de los botones", por ejemplo). Este comentario será útil para los demás desarrolladores.
7. Confirme la extracción.
   La página ha sido extraída.
8. Seleccione el botón "OK".
9. Desplace el botón hacia la derecha (debajo del control de descarga).
10. Guarde la página (Ctrl + S).

Pruebe los cambios.

1. Abra la página "PAGE_List_of_products".
2. Pruebe la página (haga clic en en los botones de acceso rápido).
3. Haga clic en el enlace "Edit" de uno de los productos.
4. La página con los detalles del producto se abre. El botón "OK" aparece en la nueva posición.
5. Cierre el navegador.

Reintegrar el elemento extraído

• Opciones del proyecto específicas del SCM.
• Modo sin conexión.
• Administrador del SCM.

Le recomendamos hacer copias de seguridad del repositorio de forma regular. Estas copias de seguridad pueden realizarse a través del administrador del SCM.

1. Abra la ventana de descripción del proyecto. Para ello, vaya a la pestaña "Proyecto", grupo "Proyecto", y haga clic en "Descripción".
2. En la pestaña "SCM", seleccione la opción "Sin SCM ni administrador externo (Git)".
3. Valide la ventana de descripción del proyecto.