Tutorial - Un 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.
• El desarrollador adquiere permisos exclusivos sobre el elemento: puede realizar los cambios que desea en dicho elemento.
• 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 crear un proyecto que utiliza el SCM.
• 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", luego en "Tutorial - Create a WEBDEV website (Back Office and Front Office)", haga doble clic en "Full WEBDEV Site - Answers".

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 el 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: en la pestaña "Inicio", en el 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:
   
   Observación: 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.

La próxima vez, podrá abrir un proyecto importado en el SCM como cualquier otro proyecto: solo tiene que abrir la copia local del proyecto.

• 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 extraer el elemento. También puede hacer clic en "Extraer" en la pestaña SCM de la cinta de opciones ().
3. La ventana de extracción se abre:
   
4. El SCM propone tres modos de extracción:
   • Exclusivo (modo recomendado): nadie puede extraer el elemento si no se ha reintegrado. El elemento solo se puede extraer para realizar pruebas.
   • Para pruebas: el elemento se puede modificar, pero las modificaciones no se pueden reintegrar.
   • Múltiple: otros usuarios también pueden extraer 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

Una vez realizados los cambios, podemos reintegrar la página en el repositorio. Así, otros desarrolladores podrán acceder a los cambios realizados.

En la pestaña "SCM", en el grupo "Elemento actual", haga clic en "Reintegrar". La siguiente ventana se abre:

Esta ventana permite:

• ver los cambios realizados comparando el elemento del repositorio con el elemento extraído (botón "Mis cambios").
  
  

  Combinar código
  Puede comparar un elemento con una de sus versiones anteriores. Esto permite comparar el código para recuperar una sección de código "perdida" o eliminada por error por otro desarrollador.
• acceder al historial del elemento en el repositorio (botón "Propiedades").
• introducir un comentario sobre los cambios realizados. De forma predeterminada, WEBDEV muestra el comentario escrito cuando se extrajo el elemento.
• enviar un mensaje a otros desarrolladores.
• reintegrar los cambios realizados sin reintegrar el elemento (opción "Conservar elemento extraído").
  
  

  Si utiliza los Centros de Control, puede finalizar la tarea actual al reintegrar el elemento en el Administrador de Código Fuente. Esta funcionalidad es útil para hacer un seguimiento de tareas, corregir errores, etc.

Valide la ventana de reintegración.

• Opciones del proyecto específicas del SCM.
• El modo sin conexión.
• El 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: en la pestaña "Proyecto", en el grupo "Proyecto", 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.