Manual Del Programador para Correcto Envío de Pases

MANUAL DEL PROGRAMADOR PARA 2017
EL CORRECTO ENVO DE PASES
1.- INTRODUCCION
El envo de pases a produccin, en sentido ms exacto, el subir un aplicativo desarrollado a la web

de sistemas de Efectiva, es una parte fundamental en el flujo del aplicativo, por no decir el ms
importante; mediante ste proceso el App ser sometido a pruebas tanto de fbrica como por
pruebas dentro de financiera, que buscarn que el aplicativo tenga la forma correcta y el
funcionamiento ideal, para que sea ejecutado con xito y sea til para el negocio al que est
orientado.
Para esto y como se sabe, se tiene un estndar de programacin, que se debe respetar para cada
tipo de aplicativo a desarrollar y un manual de buenas prcticas que el programador consulta para
poder realizar su labor
El presente documento es un apoyo final y extra al manual de usuario para que el analista pueda
enviar un pase de manera satisfactoria, evitando las observaciones de forma, que pueden retrasar
el envo de un proyecto, que aunque ste considere tal vez nimios para el desarrollo, constituyen
una parte importante a seguir en un esquema organizado de crear y desarrollar aplicativos a usar;
se figura adems en el documento pasos sencillos que pueden ser olvidados como la separacin de
fuentes u otras que pueden resultar simples pero importantes en la elaboracin de un pase
Se tendr en cuenta la actualizacin de este pequeo documento cuando nuevos estndares

aparezcan dependiendo de las coordinaciones hechas.
PGINA WEB DEL REA DE SISTEMAS

La Pgina web del rea de sistemas de efectiva (En adelante, Pgina de Produccin) es la
herramienta principal para el envo de pases una vez estos han sido enviados. Es por naturaleza, la
pgina que muestra el flujo de un pase paso a paso, desde su asignacin hasta su instalacin en
produccin.
Login de la pgina de Produccin
Una vez logueado, Segn el tipo de usuario que se tenga (con el que se ingrese), se tendrn
distintas opciones que se podrn realizar desde aqu.
Para el caso del presente documento y para no explayar indicaciones que figuran en el manual de
buenas practica y estndar de base de datos, se indicarn los pasos necesarios para el correcto
envo de un aplicativo.
ENTRANDO EN EL FLUJO
Por cada paso del flujo que se realiza, el requerimiento obtiene un estado que identifica en que
parte del flujo de envo de pases se encuentra.
Estados en Pases de fbrica
Estados en requerimiento de fbrica

Para nuestro flujo usado y el que debemos tener encuentra en nuestros desarrollos debemos
tener en cuenta los siguientes estados.
ASIGNADO
El requerimiento en cuestin est ya a cargo de un analista, y se est desarrollando.
En este estado del flujo, el analista programador debe verificar los tiempos/fechas en la que debe
culminar y poder enviar el requerimiento al siguiente estado
ASIGNADO ATRASADO
El requerimiento super la fecha del lmite de entrega.
Mucho cuidado aqu, pues ya estamos en las fechas de entrega, el analista debe terminar ASAP, si
se encuentra en este estado, recordar que esto no es muy favorable para la empresa, as que hay
que cuidar los tiempos.
En esta parte del flujo (Asignado o Asignado Atrasado) el analista debe ahora subir a la pgina de
produccin su desarrollo hecho, en resumen debe convertir su REQUERIMIENTO en un PASE.
No es cuestin de subir el aplicativo hecho as como as, para poder subir un app y convertirlo en
pase se deben tener las siguientes indicaciones y recomendaciones para poder pasar nuestro
estado al siguiente flujo exitosamente.
SUBIENDO UN PASE
Para subir un pase primero debemos ir a requerimientos de fbrica, donde veremos nuestro
requerimiento que hemos desarrollado.
Supongamos que ya hemos culminado nuestro desarrollo y tras terminar nuestros documentos de
pruebas, manual de usuario y aplicativo en si (mas importante), Procedemos a crear un pase, para
que este pueda seguir su flujo.
Buscamos nuestro requerimiento, filtramos por el nmero que tenemos (1) y hacemos clic en el
botn buscar (2), como se ve se tiene otras opciones para filtrar la bsqueda, que pueden ser
usadas si es que se necesitan
Como ya se cuenta con el app terminado esta vez crearemos un pase accediendo al botn de
opciones del requerimiento (1) y luego haciendo clic en Pases de fbrica (2)
Si es que no se ha hecho algn pase antes, obviamente no nos saldr nada al hacer clic en Pases
Fbrica, para hacer el pase hacemos clic en el siguiente botn
Si es que ya existen pases hecho, ser lo mismo pero con la ubicacin del botn cambiada.
Una vez hecho esto nos aparecern los campos a llenar para la realizacin del pase,
Como apoyo y finalidad de este documento se procede a explicar el correcto llenado de cada
cuadro de texto y o adjunto a subir para que el pase a nivel de forma este correcto.
Ttulo
Colocar aqu el ttulo del pase, de preferencia el que ya se viene usando como requerimiento,
salvo que se decida cambiar el nombre por alguno ms especfico a la funcionalidad, para esto,
siempre consultar con el jefe de proyecto del pase.
Sistema
La pgina llena de manera automtica este campo, basndose en el que tiene el requerimiento, no
mover a menos que sea necesario ose indique por parte del jefe de proyecto.
Tipo Solicitud
Colocar aqu lo que se est enviando en el pase, si el app cuenta con ddls (Procedimientos
almacenados), marcar ddl, y si lleva Querys, marcar Querys, respectivamente.
Si se envan ejecutables informix (Extensin 4gi) marcar Programas, y si tambin se envan
archivos batch, marcar batch etc.
Si el app lleva varios de estas caractersticas marcar las que se requieran y crean conveniente, el
marcado es mltiple.
ATENCION
No colocar u olvidar algo que se est enviando y no marcarlo ser considerado una observacin y
el pase ser devuelto!
Horas de Desarrollo
Colocar las horas que ha tomado en realizar el aplicativo
Descripcin
Colocar una descripcin breve de la funcionalidad del aplicativo a enviar.
Primero campos antes descritos
Instrucciones
Colocar las instrucciones de instalacin del pase.
Las instrucciones deben ser especficas y breves, no las leer el usuario, sino el operador que
instalar el pase en produccin cuando este ya est aprobado y llegue a esa parte del flujo.
Para su llenado correcto tenemos que tener en cuenta siempre poner dos ttulos INSTALACION y
REVERSIN
Veamos esta imagen de ejemplo
Como se nota, las instrucciones son especficas y breves, de esta imagen podemos sacar los
siguientes puntos:
El pase es para sistema SFI por lo que dice que debe ejecutarse en SFI cada paso siguiente.
Este pase en concreto enva querys, que son los primeros que deben ejecutarse, de all
que en la parte instalacin, se especifica que debe ejecutarse primero LA PARTE SUPERIOR
DE LA PESTAA QUERY, se explicar ms adelante el uso de esta pestaa.
Este pase tambin enva archivos batch que deben ser instalados tras los querys.
Una vez esto se instala en la base de datos tbsfi, los compilados que se envan en el
archivo que adjuntamos donde esta nuestro app.
La parte REVERSON indica el modo de desinstalar nuestro pase por lo que siguiendo el
ejemplo redactamos lo contrario a realizar, destacando que hay que realizar el orden de
desinstalacin: querys, batch, app.
Estas instrucciones variarn dependiendo del tipo de pase, para indicaciones siempre consultar
con el jefe de proyecto.
ATENCION
No incluir instrucciones correctas o ambiguas y principalmente olvidar redactar la REVERSION,
ser considerado una observacin y el pase ser devuelto!
Extra: Pestaa querys
Si nuestro pase necesita enviar consultas (querys) que deben ser ejecutadas en el pase, debemos
adjuntarlas, para esto, procedemos a colocar nuestros querys haciendo clic en la pestaa querys
mostrada en la imagen de arriba.
Hay que tener en cuenta que al igual que con las instrucciones de instalacin, debemos poner
pequeas instrucciones y estndares en nuestros querys a enviar.
Tomemos esta imagen como ejemplo:
Como vemos especificamos en que base o bases de datos nuestros querys sern ejecutados, esto
es importante y es considerado como la PARTE SUPERIOR DE LA PESTAA QUERYS o
INSTALACION DE QUERYS.
En la imagen se pone --========== EJECUTAR EN TBSFI ===========--Sin embargo puede tener
variaciones dependiendo del analista como por ejemplo: --------Instalar en tbase----, ----instalar
en sai efe, sai curacao, sai motocorp----- etc. etc.
Tambin como se aprecia, se enva la reversin de los querys, donde se indica que hay que hacer
para revertir los cambios que nuestras consultas realizaran en la base de datos.
ATENCION
Olvidar la reversin de querys u olvidar poner en que base de datos se ejecutan se considerar
observacin y el pase ser devuelto!
NOTAS TCNICAS IMPORTANTES AL ENVIAR QUERYS
Si se envan querys para la creacin de tablas:

Especificar el crecimiento aproximado de la tabla, por registros al da, mes o ao o las 3
No olvidar agregar las columnas de auditora a la tabla ni los ndices que debe tener,
respetar el manual de buenas prcticas que se debe conocer.
No olvidar referirse al manual de buenas pracgicas para verificar nombres de tabla y de

sus columnas.
Si se estn enviando consultas INSERT

Si es en caso de una gbcon o una efpar (tablas de parmetros) insertar antes del INSERT un
query SELECT COUNT (*) para verificar que lo que se va a ingresar no exista y as evitar
duplicados en produccin. Imagen de ejemplo:
Siempre especificar cuantos registros se van a llenar (5, 4 o 1) Ver imagen anterior para
notar el detalle. Este caso tambin aplica al revertir el query, indicando cuantos registro se
quitarn.
Siempre separa por puntos y comas por consulta (aplica a la mayora de querys), recordar
que el operador COGERA TODA LA PARTE DE INSTALACION, COPIARA Y PEGARA EN
CONSOLA Y EJECUTAR LOS QUERYS, a menos que se indique otra instruccin.
ATENCION
Si cualquier de las notas tcnica anteriores no se presenta o no se toma en cuenta al enviar, es
decir no se encuentra al momento de enviar el pase, ser considerada observacin y el pase ser
devuelto!
Tras la explicacin de esta parte continuaremos con el llenado de datos para el pase, continuando
ahora con los archivos adjuntos y a adjuntar
Archivos Adjuntos
Colocar los archivos que se estn adjuntando, que estn dentro del archivo ZIPEADO adjuntos, que
se sube en el siguiente campo.
Tener en cuenta que hay que poner exactamente lo que se encuentra en cada carpeta del apse
como muestra el ejemplo.
Adjuntos
En esta parte hacemos clic en el botn adjuntos (1) y seleccionamos nuestro archivo zipeado (2)
adjuntos y los subimos a la pgina de produccin (3).
Hay que tener las siguientes consideraciones al subir nuestro Zip de adjuntos, ya que este contiene
nuestro aplicativo y es parte vital al realizar el pase.
NOTAS TCNICAS Y CONSIDERACIONES EN ENVIO DE ADJUNTOS PARA APPS 4GL
Primero que nada y yendo paso a paso supongamos que ya tenemos nuestro aplicativo terminado,
para poder crear nuestro Zip adjunto debemos primero crear una carpeta con nombre SFI o SAI
(en minsculas) dependiendo de a qu base de datos nuestro aplicativo apunta a ser instalado.
En este ejemplo tenemos un app ya desarrollado para SFI y procederemos a crear nuestro adjunto.
Procedemos a crear nuestra carpeta sfi.
Ahora dentro de esa carpeta crearemos una carpeta llamada fuentes (en minsculas)
Ahora procedemos a copiar FUERA DE LA CARPETA FUENTES NUESTROS COMPILADOS, es decir

nuestros archivos 4GI y FRM en caso se tengan.
Y Ahora dentro de la carpeta fuentes, pondremos recin nuestras fuentes, archivos de extensin
4GL y PER (SH es opcional).
OJO AQU: No se pasan las libreras usadas A MENOS QUE se estn realizando cambios tambin en
las libreras y hay que recordar que nuestras fuentes deben estar separadas! Para ms
informacin VER EL ANEXO 1: SEPARACION DE FUENTES
Asegurarse adems que las fuentes tengan las marcas correctas y sigan el estndar
VER EL ANEXO 2: MARCAS Y PRACTICAS EN FUENTES 4GL
En caso tengamos un batch tambin a pasar, lo creamos dentro de una carpeta llamada batchero
que se ubica en la raz de la carpeta sfi.
Recordar adjuntar la reversin del batchero as como el batchero en s.
En caso se deba enviar un documento con instrucciones al operador (como por ejemplo correos a
parametrizar u opciones de ejecucin automtica, se debe crear una carpeta aparte QUE NO EST
DENTRO DE LA CARPETA SFI, llamado operador
Y dentro los instructivos a enviar
Una vez acabado ponemos nuestras carpetas dentro de un archivo CON EXTENSION ZIP y lo
subimos a la web de produccin.
ATENCION
No considerar esta forma de envo o si la carpeta no cuenta con la forma correcta de estructura,
ser considerado observacin y el pase ser devuelto
Continuando con los campos
DDLS
Ajuntamos nuestros ddls si es que se estn pasando.
Tener en cuenta que la forma correcta de enviar ddl no dista mucho del envo de 4gl a diferencia
que el adjunto ahora se llama ddl y contiene solo una carpeta llamada reversin, donde se
pondrn los ddl anteriores al pase (si es que se pasan modificados) o un SQL donde se indique el
hacer drop al PA (en caso sean nuevos).
Ejemplo en imagen:
Plan de pruebas
Se adjunta el plan de pruebas hechos por el analista, debe estar en documento Word y ser
especfico, un plan de pruebas a medias puede causar una devolucin
Manual de usuario
Adjuntar el manual de usuario, recordar que este va dirigido al usuario as que hay que hacerlo
sencillo y fcil de entender, NO PONER QUERYS DENTRO DEL MANUAL.
Diagrama ER
Se adjunta un diagrama entidad relacin y uno de procesos SOLO EN CASO que el app este
creando ms de 5 tablas y se est dentro de un proyecto. Generalmente no suele subirse nada,
pero siempre consultar al jefe de proyectos y al analista funcional si se considerarn.
Estado
Colocar en que estado debe colocarse el pase, generalmente primero debe ser en estado BANDEJA
FBRICA, Pero si el jefe de proyectos lo aprueba, ir a QA de fbrica.
Ahora si, tras dar a guardar, la pgina nos otorga ahora un NMERO DE PASE, por el cual ahora el
requerimiento es ya un pase y continuar su flujo.
BANDEJA FBRICA
El desarrollo ha sido terminado (ahora el requerimiento se convierte en un PASE) por el analista
y est en un estado de entregado a nivel de fbrica.
Si el pase est aqu y debemos editar algo solo ubicamos nuestro pase en pases de fbrica
ubicando el nmero que se nos otorg al subir nuestro app.
Ubicamos nuestro pase como ubicaos antes nuestro requerimiento y damos a modificar
Y nos enva a modificar los datos ingresados en el momento que se subi el pase.
Damos a guardar si modificamos algo, incluyendo el estado.
QA DE FBRICA
El pase ahora est en pruebas por parte de control de calidad de un analista QA a nivel de fbrica,
el pase se est sometiendo apruebas funcionales y de forma para verificar que sea correcto y
pueda ser ya enviado a siguiente estado.
Desde aqu, solo un usuario con perfil de control de calidad podr aprobar el pase y hacer que siga
su flujo, el trabajo de desarrollador ha culminado.
El pase continuar su flujo con los siguientes estados:
BANDEJA
El pase se encuentra en bandeja de efectiva, por lo que en este instante el ANALISTA FUNCIONAL
se encargar de revisarlo y verificar que se cumpla la funcionalidad establecida entre l y el
usuario.
DBA
El pase se encuentra en revisin del administrador de base de datos, que verificar si las tablas
que se crean o querys estn correctos.
QA
El pase ahora est en prueba por parte de control de calidad de un analista interno de la financiera
EFECTIVA, en este estado el pase se est revisando en el servidor de control de calidad de QA EFE y
se valida, como en QA de fbrica, funcionalidad y forma de envo de pase.
PRUEBAS DE USUARIO
Nuestro app esta ahora siendo probado por el mismo usuario que pidi su desarrollo, el decidir si
el aplicativo es correcto y si lo aprueba segn sus expectativas.
JEFE DE PRODUCCION
El pase tras aprobacin del funcional y de usuario ahora pasa que e el jefe de produccin de su OK
para la instalacin del pase.
OPERADOR
El pase ya est siendo instalado por el operador.
PRODUCCION:
El pase ya est instalado en servidor de produccin y est ya siendo usado en casos reales, ventas,
financiera etc. etc.
TERMINADO:
Cuando el requerimiento/pase ya est en produccin, el analista programador ver su pase como
terminado y se dar fin a la atencin.
SIN EMBARGO, si tras enviar el pase a QA de fbrica, se presentan observaciones o algn error o
dato que no cuadra, este pase ser lastimosamente:
DEVUELTO: El pase se devolvi por alguna observacin hecha tanto por algn analista de QA como
por el Analista funcional O DE ALGUNA PARTE DEL FLUJO DESCRITO.
En este estado el pase vuelve a estar en un estado de bandeja de fbrica, por lo que se debe editar
y volver a subir correctamente con los cambios requeridos.
Con esto Ya el analista sabe ahora como subir un aplicativo y su correcta forma de subirlo, para
ms datos se deja al final 2 anexos tiles al programador.
Suerte y esfuerzo en el mundo de la programacin!

ANEXO 1
SEPARACION DE FUENTES Y NUEVO NMERO
Antes de subir un pase se debe cerciorar que las fuentes que modificaremos estn separadas, de
tal manera podemos nosotros bloquearla y hacer saber a otros analistas, que nosotros estamos
modificando la fuente y que hasta que nuestro desarrollo no acabe, no podrn usar la fuente en
cuestin.
Para ejecutar este proceso vamos primero a la pgina de produccin y all vamos a la ruta
Control de fuentes y tablas -> Separar fuentes
Damos al signo de aadir para separar la fuente que se necesite
Ahora en los filtros que se nos presentan procedemos a ubicar la fuente que se neceista separar
Agregamos una fecha tentativa de liberacin de la fuente.
Tras eso digitamos el nmero de requerimiento por el cual vamos a separar la fuente.
Como se aprecia la web nos marca cual es el requerimiento y su nombre
Y ahora en el campo CodPase, nos muestra los o el pase que ese requerimiento ya tiene (que se ha
creado).
Ahora filtramos la fuente y a donde pertenece, la web nos mostrara las fuentes disponibles a
separar, por nombre de fuente nos indica un nmero, donde 4 indica una fuente libre y que puede
ser separada y 1 una fuente bloqueada que no podremos separar
En el campo revisin, ponemos el nmero de revisin de la fuente actual
Para saber el nmero de revisin correcto vamos a nuestro repositorio y ubicamos la fuente a
separar (1) (recomendable actualizar repositorios antes de realizar este proceso), con click
derecho seleccionamos las opciones de tortoise (2) y seleccionar la opcin show log (3).
Revisamos la revisin y la ponemos en la web
Colocamos la descripcin, bloqueamos la fuente marcando bloqueado y damos a guardar

Una vez hecho eso el pase que pusimos debe figurar ya con las fuentes separadas respectivas.
Ejemplo viendo un pase con fuentes separadas.
Para separar un nuevo nmero, es decir, registrar en la web que se est usando una nueva fuente,
se accede a la ruta Control de fuentes y tablas -> Nuevo Nmero
Usar el botn de aadir, (similar a cuando se separaron las fuentes)
Los pasos a seguir son similares a la separacin de fuentes iniciando por los campos de fecha de
liberacin e incluso el requerimiento que se asigna y el pase que debe estar asignado.
Los campos nuevos que aparecen en este caso son:
Opcin
Aqu se debe digitar el nombre de la opcin que tendr la fuente cuando se ubique en el men del
SAI o del SFI.
Modulo
Modulo al que pertenece el aplicativo, consultar con el jefe de proyecto cual debe ser el modulo
adecuado para la fuente y si en caso ya se tiene analizado solo elegir.
Programa
Esta es la lista de las fuentes que pueden ser separas, con cdigo 5, indica que puede ser separada,
con cdigo 7, no puede usarse.
Tipo
La naturaleza del programa, si es un reporte, mantenedor etc etc.
Una vez llenado el formulario, poner en estado nuevo bloqueado y dar a guardar, la nueva fuente
ser registrada y separada.
ANEXO 2
MARCAS Y BUENAS PRCTICAS EN FUENTES 4GL
Este pequeo apartado muestra la forma correcta de hacer marca en fuentes a modificar.
Cuando se coge una fuente y se est haciendo un pase con un cambio en esta, como bien dice el
manual de programacin, las marcas deben ser respetadas. Para no dar mayor rodeo en cuestin
de como marcar cambios (puesto que est en el manual de programador) se dejan unas
consideraciones a tener en cuenta al realizar marcas en fuentes.
CONSIDERACIONES:
1.- Nunca poner dentro de un bloque de marca cdigo que no pertenece al cambio, por mas
pequeo que sea este, pues en una reversin posible este al ser eliminado se podra borrar y
generar error en el aplicativo.
INCORRECTO:
CORRECTO:
2.- Cuando haya ms de 4 cambios seguidos, siempre poner en un bloque de marca y de

preferencia no a uno.
INCORRECTO
CORRECTO
3.- El cambio en declaracin de variables AL UBICAR UNA VARIABLE AL FINAL siempre ubicar la
coma tras la nueva variable creada.
INCORRECTO
CORRECTO

Manual Del Programador para Correcto Envío de Pases

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Manual Del Programador para Correcto Envío de Pases

Cargado por

Copyright:

Formatos disponibles

MANUAL DEL PROGRAMADOR PARA 2017

EL CORRECTO ENVO DE PASES

El envo de pases a produccin, en sentido ms exacto, el subir un aplicativo desarrollado a la web

Se tendr en cuenta la actualizacin de este pequeo documento cuando nuevos estndares

PGINA WEB DEL REA DE SISTEMAS

Login de la pgina de Produccin

Estados en Pases de fbrica

Estados en requerimiento de fbrica

Primero campos antes descritos

Extra: Pestaa querys

NOTAS TCNICAS IMPORTANTES AL ENVIAR QUERYS

Si se envan querys para la creacin de tablas:

No olvidar referirse al manual de buenas pracgicas para verificar nombres de tabla y de

Si se estn enviando consultas INSERT

NOTAS TCNICAS Y CONSIDERACIONES EN ENVIO DE ADJUNTOS PARA APPS 4GL

Ahora procedemos a copiar FUERA DE LA CARPETA FUENTES NUESTROS COMPILADOS, es decir

Recordar adjuntar la reversin del batchero as como el batchero en s.

Y dentro los instructivos a enviar

Continuando con los campos

El pase continuar su flujo con los siguientes estados:

Suerte y esfuerzo en el mundo de la programacin!

Damos al signo de aadir para separar la fuente que se necesite

En el campo revisin, ponemos el nmero de revisin de la fuente actual

Revisamos la revisin y la ponemos en la web

Colocamos la descripcin, bloqueamos la fuente marcando bloqueado y damos a guardar

Usar el botn de aadir, (similar a cuando se separaron las fuentes)

2.- Cuando haya ms de 4 cambios seguidos, siempre poner en un bloque de marca y de

También podría gustarte