Documentos de Académico
Documentos de Profesional
Documentos de Cultura
Tabla de contenido
Funciones o procedimientos................................................................................ 4
Valores de Retorno y Parmetros.....................................................................4
Nomenclatura de Nombre................................................................................ 5
Pantallas (APEX).................................................................................................. 6
Nomenclatura.................................................................................................. 6
Nombre de Pginas de Aplicaciones desarrolladas en Apex.........................6
Tipos de Pginas. (Estos tipos tienen diferente tipo de iconos)....................6
Creacin de Objetos en APEX en Caso de que estos sean Globales..............7
Construccin de Pginas.................................................................................. 8
Dynamic Actions.............................................................................................. 9
Creacin de objetos en APEX en caso de que estos sean a nivel de pgina.
................................................................................................................... 10
Objetos en APEX en caso de que estos sean creados automticamente....11
Grupos de pginas...................................................................................... 11
Archivos Estticos....................................................................................... 11
Tema de la aplicacin................................................................................. 11
Pgina Men Principal/ME-Men.................................................................12
Ttulo.............................................................................................................. 12
Seguridad...................................................................................................... 13
Check de pgina............................................................................................ 14
Gua de Imgenes.......................................................................................... 14
Reportes Dinmicos....................................................................................... 16
Objetos Base de Datos...................................................................................... 17
Estndares de Nomenclatura......................................................................17
Estndares de Documentacin...................................................................22
Pistas de Auditora...................................................................................... 22
Estndares generales a nivel de Programacin..........................................23
Estndares sobre Tablas............................................................................. 24
Estndares sobre Columnas........................................................................24
Estndares en Prefijos de campos a nivel de Base de Datos......................25
Archivos de control..................................................................................... 26
2
Anexo................................................................................................................ 27
Gua de evaluacin de control de calidad......................................................27
3
Gua de Estndares para
Desarrollo Apex
Funciones o procedimientos
- 300 others.
Nomenclatura de Nombre
Agrupar las funciones por proceso o eventos. Con esto se lograr que los
paquetes no crezcan en forma desmedida.
Pantallas (APEX)
Nomenclatura
Nombre de Pginas de Aplicaciones desarrolladas en Apex.
La nomenclatura es la siguiente SSAAXX9999. Se excluye la pantalla home,
loggin y la pantalla global
AA = Prefijo de la aplicacin
XX = Tipo de Pagina
Tipos de Pginas.
El tipo se dividen en los siguientes tipos:
RE = Reporte
GF = Grfico
PP = Pantalla proceso.
PM = Pantalla mantenimiento
PC = Pantalla consulta.
Ejemplo
6
Pantalla consulta solicitudes de SIACO
SCSOPC0001
XX = Tipo de Objeto
PP = Prefijo de la aplicacin
Ejemplo: ITAD100NOMEMPLEADO
TIPOS DE OBJETOS
IT= ITEM
AP=APPLICATION PROCESS
WS=WEB SERVICE
CP = Computations
LV = Listas de valores
Construccin de Pginas
1. Al navegar entre las pginas solo se deben pasar campos ID, no utilizar
nombres o descripciones, ya que los caracteres ocasionan
inconsistencias en las referencias.
7
4. Adems en cada pgina se debe indicar la autorizacin como se muestra
en la imagen, el Schema debe ser para nuestro caso ACCESO_PAGINA.
La excepcin es para pginas declaradas como pblicas.
a. Ejemplo
7. Las pginas deben ser atmicas, no deben ser utilizadas para crear,
modificar y consultar.
12.Para las regiones Tabular Form que se construyen sobre una tabla de
base de datos, en el proceso de eliminar, agregar o modificar debe en
la medida de lo posible dar prioridad a realizar los procesos propios de
pex y las acciones consecuentes de eliminar ese registro deben realizar
mediante un trigger de la tabla.
8
14.En las regiones de tipo Reporte, en la seccin atributos del reporte. Se
deben traducir los mensajes de When more than maximum row data found message y
When No Data Found Message a espaol y deben adatarse a la naturaleza de la
regin.
17.Cuando se crean en el sql de regiones, botones que son link hacia otra
pgina, se debe realizar la preparacin del url con la funcin
EX_UTIL.PREPARE_URL que genera el checksum para el llamado y control
de modificaciones posteriores del url generado.
Ejemplo:
Select codigo, nombre,
'<a href= "'||APEX_UTIL.PREPARE_URL('f?
p='||:app_id||':&APP_PAGE_ID.:'||:app_session||'::::P&APP_PAGE_ID._NUME
ROACTIVO:'||IM_NUMERO_ACTIVO,'UTF-8',2) ||'"><img
src="#WORKSPACE_IMAGES#Documento.png" alt=" Ver adiciones"
WIDTH=25 HEIGHT=25></a>'
) adiciones From ejemplo
Dynamic Actions
9
2. La propiedad Fire on load de los dynamic action, debe restringirse
solamente a casos estrictamente necesarios, en su lugar se debe utilizar
las propiedades propias del campo.
Nomenclatura: XXXFFFFFF
Tipos
CHANGE CHA
MOUSE BUTTON
MBP
PRESS
MOUSE BUTTON
MBR
RELEASE
10
PAGE UNLOAD PUN
RESIZE RES
SCROLL SCR
SELECT SEL
NP = Numero de Pgina
XX = Tipo de Objeto
Tipos de Objetos
AP=APPLICATION PROCESS
B = Botones
Ejemplo: ITSO08NOMEMPLEADO
11
Objetos en APEX en caso de que estos sean creados automticamente.
Los tems y procesos creados automticamente por pex debern mantener su
nombre.
Grupos de pginas
Nomenclatura: XXXXXXXX
Ejemplo PG100SOLICITUDES
Archivos Estticos
Nomenclatura: AAAPPEXTNNNNNNN
AA = Prefijo de la aplicacin
Ejemplo: AD100JS_UTILIDADES
Tema de la aplicacin
12
Ttulo
13
Seguridad
14
Cuando se crean en el sql de regiones, botones que son link hacia otra pgina,
se debe realizar la preparacin del url con la funcin EX_UTIL.PREPARE_URL que
genera el checksum para el llamado y control de modificaciones posteriores del
url generado.
Ejemplo:
Select codigo, nombre,
'<a href= "'||APEX_UTIL.PREPARE_URL('f?
p='||:app_id||':&APP_PAGE_ID.:'||:app_session||'::::P&APP_PAGE_ID._NUME
ROACTIVO:'||IM_NUMERO_ACTIVO,'UTF-8',2) ||'"><img
src="#WORKSPACE_IMAGES#Documento.png" alt=" Ver adiciones"
WIDTH=25 HEIGHT=25></a>'
) adiciones From ejemplo
Check de pgina
Se requiere aplicar el check de la pgina y corregir o modificar los puntos
que de las sugerencias que brinda Apex.
15
Gua de Imgenes
Las siguientes son las imgenes oficiales a utilizar segn el tema, si se debe
respetar la invocacin
Guardar &BOTONGUARDAR.
Aplicar Cambios &BOTONSALVAR.
Regresar &BOTONREGRESAR.
Borrar &BOTONBORRAR.
Agregar Registro &BOTONAGREGARREG.
Buscar &BOTONBUSCAR.
Filtro &BOTONFILTRO.
Remover Filtro &BOTONQUITARFILTRO.
Zoom In &BOTONVERMAS.
Zoom Out &BOTONVERMENOS.
Detallar &BOTONDETALLAR.
16
Existen las variables con mensajes de confirmacin personalizados para cierto
tipo de botones:
Reportes Dinmicos
- Guardado
- Ayuda
- Retrospectiva
- Siempre se debe ocultar la opcin descarga en PDF
17
Esto debe configurarse en cada reporte, en el tab de Report Attributes. Solo
en los reportes que se les solicite deben aparecer ms opciones.
18
Objetos Base de Datos
Estndares de Nomenclatura
a) Nombres de mdulos
SSAATUnnnn.XXX
AA = Prefijo de la aplicacin
P = Posteo / Mantenimiento
R = Reversin
K = Clculo
C = Consulta / Reporte
I = Interface
A = Parmetros
M = Men
U = Uso
T = Temporal
P = Permanente
b) Nombres de Triggers
TRG_TEEE_NNNNNNNNNN_AAAAAAAAAA
SSAATUNNNNNNNNNN
AA = Prefijo de la aplicacin
T = Tipo de objeto
T = Tabla
V = Vista
S = Secuencia
I = Indice
P = Paquete
C = Cluster
Z = Sinnimo
U = Uso
H = Histrico
B = Bitcora
M = Maestro
D = Detalle
I = Interface
P = Parmetro
20
T = Temporal
K = Primario (Indice)
S = Secundario (Indice)
F = Forneo
d) Nombres de dominios
D_TTLLLNNNNNNNN
D = Indicador de dominio
TT = Tipo de dominio
NU = Nmero
PO = Porcentaje
CO = Cdigo
FE = Fecha
PE =Periodo
IN = Indicador
MO = Monto
DE = Descripcin
Para la categora monto, los primeros dos dgitos son la parte entera y el ltimo
es la parte decimal.
Ejemplos:
D_MO122CUENTA
D_DE060CUENTA
D_CO018CUENTA
D_PE006CICLO
D_PO107DEPREV
e) Nombres de usuarios
NNNPPPSS
Ejemplos:
MAXESPJI
22
ROBSANAR
KATMORPA
f) Nombres de roles
TFSSAA_ NNNNNNNNNN
T = Tipo de role.
C = Consulta.
O = Operativo.
S = Supervisin.
M = Men.
A = Aplicacin.
F = Funcional o de dependencia.
AA = Prefijo de la aplicacin.
Ejemplos:
OMSATE_SEGURIDAD
CASAPG_COMPAGOS
23
Estndares de Documentacin
Pistas de Auditora
La tabla de auditoria contiene una columna para cada campo de la tabla que se
desea auditar, adems deben llevar las siguientes columnas:
25
Estndares sobre Tablas
FK01_NomTablaOrigen_NomTablaDestino.
Para los nombres de las columnas se pueden utilizar abreviaturas y a que son
muy largos. No se debe utilizar el nombre de las tablas como parte de ellos,
debido a que ocasionan que los nombres sean ms largos de lo debido.
Prefijo Descripcin
PER_ Periodo
MES_ Mes
CTA_ Cuenta
DES_ Descripcin
OBS_ Observaciones
DIR_ Direccin
DIA_ Da
FEC_ Fecha
ID_ Identificador (id_documento, etc.)
IND_ Indicador, utilizado para campos de control
INT_ Inters
MTO_ Monto
CUR_ Cursor
NOM_ Nombre
NUM_ Nmero
POR_ Porcentaje
SAL_ Saldo
TEL_ Telfono
TOT_ Total
EST_ Estado
IMG_ Imagen
TG_ Grupo de tipo
TE_ Elemento de tipo
CG_ Grupo de cdigo
CE_ Elemento de cdigo
PG_ Grupo de parmetro
PE_ Elemento de parmetro
CANT_ Cantidad
LON_<XXXX> Campo de tabla que se refiere a la longitud en caracteres
es de algo.
COD_<XXXX> Campo de tabla que se refiere a cdigos alfanumricos.
VAL_NUMERICO Valor numrico de algo.
VAL_ALFABETICO Valor alfanumrico.
ACCION Para usar en bitcoras. La accin que provoca el registro
en la bitcora (ACTUALIZAR, BORRAR, INSERTAR).
USUARIO "Loggin" o usuario del sistema. Recomendado solo para
bitcoras ya que generalmente se usar el nmero del
funcionario para hacer referencia a personas.
APL_<XXXX> "Aplica", columna de tabla que contiene la forma en que se
27
afecta a lo que se refiere la columna.
FEC_DESDE Fecha desde la cual empieza a regir algo.
FEC_HASTA Fecha hasta donde algo es vlido o deja de regir.
ANO_<XXXX> Dato que representa un ao.
NOTA Comentario extenso.
COLMODIFICADAS Utilizado en bitcoras. Columnas modificadas en una tabla
y sus nuevos valores.
FEC_ACCION Utilizado en bitcoras. La fecha en que se hace el registro.
COS_<XXXX> Costo.
TIP_<XXXX> Tipo.
Archivos de control
Archivo de control
Archivo de tipos
Archivo de parmetros
Control de rutinas
Nombres de Rutinas
Archivo de funciones java script
Archivo de Roles
Vistas Materializadas
Paquetes y Funciones
Plantilla de Aplicacion
Esquema autorizacin
- Regin men
Imgenes
Manejo errores
Traducciones
Sustituciones
28
tems de aplicacin
Tema
29
Anexo
Apli
ca
(Si/N Observ
Tema a evaluar Elemento a evaluar o ) acion
Interface
Grafica Estndar de Secciones de la pantalla
Aplica estndar nombre de pantallas
Aplica estndar Botones
Las pantallas Pertenecen a un grupo
Uso adecuado de los BreadCum
Aplicaron los niveles de seguridad
establecidos
Identificacin del programa mediante una
rutina
Archivos de
control Actualizacin de archivo de parmetros
Actualizacin de archivo de Tipos
Actualizacin de archivo de funciones
Actualizacin de archivo de Rutinas
Documentacio
n Tecnica Actualizacin del Diseo del programa
Actualizacin del Modelo de Entidad
Relacin de la Base de datos
Actualizacin del Modelo de Datos de la
Base de datos
31
grupo tipo 4680)
<Nombre Objeto>
32
E- Observacio
Server Model BD R nes
33