Como poner en Producción un módulo

De GrialWIKI

Introducción al Framework Grial

Índice


Contenido

Cómo poner en producción modificaciones a un módulo existente

Deben verificarse los siguientes puntos antes de poner en producción cualquier módulo.

Paso 1: Verificar el código.

  • Asegurarse que se hayan seguido todas las recomendaciones de programación Ver:Control de Errores
  • Asegurarse que exista la línea “Option Explicit” al principio de cada módulo. (se recomienda marcar la casilla “Requerir declaración de Variables” en el menú Herramientas”/”Opciones”de Visual Basic).
  • Verificar el  modo de Compatibilidad Binaria:

Acceder en VB al Menú “Proyecto“ / Propiedades de … / Tab “Componente”. Si el proyecto NO SE ENCUENTRA en modo de compatibilidad binaria, primero agregue la cláusula Private a todos los Subs y Functions del módulo, luego coloque el proyecto en modo Compatibilidad Binaria y establezca como DLL de compatibilidad (caja de texto en la parte inferior del frame), la DLL que se encuentra en el directorio "Package/Support". Al no indicar la cláusula Private, los Sub y Functions de un User Document son Public, esto implica que pueden ser llamados desde el exterior y que poseen un identificador único de método, por lo que son tomados en cuenta para mantener la compatibilidad binaria. Una vez que un módulo esta en modo compatibilidad binaria, no se puede modificar ni el nombre ni los parámetros de cualquier procedimiento que no sea Private.

Debe usar la cláusula Private para cualquier Sub o Function que se agregue al módulo.

Paso 2: Verificar Propiedades del Proyecto.

Acceder al Menú “Proyecto“ / Propiedades de …  y Verificar:

·    Tab “Generar”, Que se encuentre marcada la casilla de “Incremento Automático”, Verificar el Título de la Aplicación.

·    Tab “Compilar”, Marcar la casilla compilar a P-Code.

·    Tab “Componente”, Debe estar en modo “compatibilidad binaria”. (excepto para nuevos proyectos)

·    Tab “Depurar”, desmarcar la casilla “usar Explorador existente”.

Paso 3: Compilar el Ejecutable (DLL)

Una vez verificado el proyecto, regenerar el ejecutable. Guarde el código fuente del proyecto: Menú Archivo / Guardar Proyecto. Elija luego la opción del menú “Archivo / Generar xxxx.DLL”. Deberá generar la DLL en el mismo directorio del proyecto.

Paso 4: Transferir el package a “Producción”

Una vez generado el DLL,  acceda al módulo de Grial “Fuentes Locales”,  ingrese en la asignación utilizada para modificar este módulo y seleccione el botón de status “Producción” y luego haga clic en “Ejecutar cambio de Status”

El sistema le pedirá confirmación para acceder al utilitario de Visual Basic “Package & Deployment Wizard”, el cual nos servirá para crear el package (archivo .CAB) para poder poner en producción el módulo. Ver Cómo usar el “Package&Deployment Wizard”

Luego de generar correctamente el Package, aparecerá nuevamente el módulo Grial de Fuentes Locales. Confirme el pase a producción. El sistema controlará que el package se halla generado correctamente, y de ser así, enviará los archivos al servidor Web de producción.

Paso 5: Opcional: Finalizar la asignación

Si se considera que ha finalizado con los cambios en el contexto de la asignación, debe hacerse un Check-In de los fuentes del módulo.

Vuelva al módulo Grial Fuentes Locales, a la asignación utilizada para crear este nuevo módulo, y seleccione “Check-In” en la barra de Status. Luego pulse “Ejecutar Cambio de Status”

El sistema le pedirá confirmación para generar un archivo .ZIP conteniendo los fuentes, y luego confirmación para transmitir los fuentes comprimidos al servidor de control de versiones, cerrándose la asignación y dejando disponibles los fuentes para otros usuarios.

Cómo Poner en producción un Módulo Nuevo

Paso 1: Desarrollo Inicial

Al inicio de un nuevo proyecto, y mientras se trabaja en modo diseño, no se genera ningún archivo ejecutable para el proyecto (archivo .DLL). Durante este período el modo de compatibilidad estará en “Sin Compatibilidad”, y se ejecutará y probará el módulo mediante la tecla F5 de Visual Basic.

Paso 2: Verificar el código.

  • Controle que todos los Eventos de tipo xxx_Click tengan un control de Errores (On Error Goto ErrH) y que se hayan seguido todas las recomendaciones de programación. Ver:Control de Errores.
  • Controle que TODOS  los Sub y Functions del User Document tengan la cláusula Private.
  • Controle que exista la línea Option Explicit al principio de cada módulo. (se recomienda marcar la casilla “Requerir declaración de Variables” en el menú Herramientas”/”Opciones”de Visual Basic).

Paso 3: Verificar Propiedades del Proyecto.

Acceda al Menú “Proyecto“ / Propiedades de …  y controle:

·    Tab “Generar”, Que se encuentre marcada la casilla de “Incremento Automático”, controle el Título de la Aplicación.

·    Tab “Compilar”, Marcar la casilla compilar a P-Code.

·    Tab “Componente”, Debe estar en modo “sin compatibilidad”, ya que aún no se ha generado ninguna DLL para este proyecto.

·    Tab “Depurar”, desmarque la casilla “usar Explorador existente”.

Paso 4: Generar el primer DLL

Guardar el código fuente del proyecto: Menú Archivo / Guardar Proyecto.

Elija luego la opción del menú “Archivo / Generar xxxx.DLL”. Deberá generar la DLL en el mismo directorio del proyecto.

Paso 5: Primer transferencia a “Producción”

Una vez generada la primer DLL,  vuelva al módulo de Grial “Fuentes Locales”,  ingrese en la asignación utilizada para crear este nuevo módulo y seleccione el botón de status “Producción” y luego haga clic en “Ejecutar cambio de Status”

El sistema le pedirá confirmación para acceder al utilitario de Visual Basic “Package & Deployment Wizard”, el cual nos servirá para crear el package (archivo .CAB) para poder poner en producción el nuevo módulo. Ver Cómo usar el “Package&Deployment Wizard”

Luego de generar correctamente el Package, aparecerá nuevamente el módulo Grial de Fuentes Locales. Confirme el pase a producción. El sistema controlará que el package se halla generado correctamente, y de ser así, enviará los archivos al servidor Web de producción.

Paso 6: IMPORTANTE: Colocar el proyecto en modo “Compatibilidad Binaria”

Una vez generado el primer package y puesto en producción, acceder nuevamente al proyecto Visual Basic para cambiar el proyecto a modo Compatibilidad Binaria. Para esto acceder al Menú “Proyecto“ / Propiedades de … / Tab “Componente”, especificar Compatibilidad Binaria y establecer como DLL de compatibilidad (caja de texto en la parte inferior del frame), la DLL que se encuentra en el directorio Package/Support”.

IMPORTANTE: Para la compatibilidad BINARIA debe usarse la DLL ubicada en la carpeta /PACKAGE/SUPPORT

Una vez cambiado el proyecto a “Compatibilidad Binaria”, guardar el proyecto (Menú Archivo / Guardar Proyecto), y Cerrar el Visual Basic.

Paso 7: Finalizar la asignación

Luego de poner en producción debe hacerse un Check-In de los fuentes del módulo.

Vuelva al módulo Grial Fuentes Locales, a la asignación utilizada para crear este nuevo módulo, y seleccione “Check-In” en la barra de Status. Luego pulse “Ejecutar Cambio de Status”

El sistema le pedirá confirmación para generar un archivo .ZIP conteniendo los fuentes, y luego confirmación para transmitir los fuentes comprimidos al servidor de control de versiones, cerrándose la asignación y dejando disponibles los fuentes para otros usuarios.



Normas de Programación

Herramientas personales