Como poner en Producción un módulo
De GrialWIKI
(→Paso 1: Verificar el código.) |
(→Paso 1: Verificar el código.) |
||
| (4 ediciones intermedias no se muestran.) | |||
| Línea 1: | Línea 1: | ||
{{Hierarchy header}} | {{Hierarchy header}} | ||
| - | = | + | =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. | Deben verificarse los siguientes puntos antes de poner en producción cualquier módulo. | ||
| Línea 7: | Línea 7: | ||
====Paso 1: Verificar el código.==== | ====Paso 1: Verificar el código.==== | ||
| - | * Asegurarse que se hayan seguido todas las recomendaciones de programación | + | * 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). | * 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). | ||
| Línea 33: | Línea 33: | ||
· Tab “Generar”, Que se encuentre marcada la casilla de “Incremento Automático”, Verificar el Título de la Aplicación. | · 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 “Componente”, Debe estar en modo “compatibilidad binaria”. (excepto para nuevos proyectos) | ||
| Línea 40: | Línea 42: | ||
====Paso 3: Compilar el Ejecutable (DLL)==== | ====Paso 3: Compilar el Ejecutable (DLL)==== | ||
| - | Una vez verificado el proyecto, regenerar el ejecutable. Guarde el código fuente del proyecto: | + | 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”==== | ====Paso 4: Transferir el package a “Producción”==== | ||
| Línea 58: | Línea 60: | ||
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. | 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==== | ====Paso 1: Desarrollo Inicial==== | ||
| Línea 66: | Línea 68: | ||
====Paso 2: Verificar el código.==== | ====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.==== | ====Paso 3: Verificar Propiedades del Proyecto.==== | ||
| Línea 78: | Línea 80: | ||
· Tab “Generar”, Que se encuentre marcada la casilla de “Incremento Automático”, controle el Título de la Aplicación. | · 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 “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 “Componente”, Debe estar en modo “sin compatibilidad”, ya que aún no se ha generado ninguna DLL para este proyecto. | ||
| Línea 86: | Línea 88: | ||
====Paso 4: Generar el primer DLL==== | ====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 | + | 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”==== | ====Paso 5: Primer transferencia a “Producción”==== | ||
| Línea 100: | Línea 102: | ||
====Paso 6: IMPORTANTE: Colocar el proyecto en modo “Compatibilidad Binaria”==== | ====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 | + | 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”.''' |
| - | + | <blockquote style="background-color: lightlightgrey; border: solid steelblue; padding:10px; font-size:120%"> | |
| - | + | IMPORTANTE: Para la compatibilidad '''BINARIA''' debe usarse la DLL ubicada en la carpeta '''/PACKAGE/SUPPORT''' | |
| - | IMPORTANTE: Para la compatibilidad | + | </blockquote> |
| - | Una vez cambiado el proyecto a “Compatibilidad Binaria”, guardar el proyecto (Menú Archivo / Guardar Proyecto), y | + | Una vez cambiado el proyecto a “Compatibilidad Binaria”, guardar el proyecto (Menú Archivo / Guardar Proyecto), y '''Cerrar el Visual Basic.''' |
| - | ====Paso 7 | + | ====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” | 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” | ||
última version al 16:26 1 may 2011
| Introducción al Framework Grial |
|
|
|
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.
