Herramientas de usuario
ada:tips:sicoferp:general:pbtows:procesos:developmentstandards:nomenclature:pb
¡Esta es una revisión vieja del documento!
Tabla de Contenidos
PBtoWS - Procesos - Backend Powerbuilder (WS-SOAP) - Estándares de Desarrollo - Nomenclatura: Powerbuilder
Este capitulo contiene información relacionada con la nomenclatura de códificación para el lenguaje Powerbuilder, la cual ha sido definida por la organización.
Se implementará la nomenclatura estandar sugerida por sybase/SAP. La cual puede consultarse desde la url: http://www.pbdr.com/pbstd/varnmstd.htm
Organización de los Componentes
Todos los componentes que se definan en el proceso de migración y posteriomente en el legunaje Powerbuilder que sean expuestos en servicios SOAP por medio del framework PBtoWS SICOF deben seguir los siguientes lineamientos:
Tabla de Código de Aplicaciones
| Aplicación | Prefijo |
|---|---|
| Presupuesto | 01 |
| Tesorería | 02 |
| Contabilidad | 03 |
| Compras | 04 |
| Nómina | 05 |
| Talento | 10 |
| Core/Framework/Main | 00 |
Cualquier nueva aplicación que se defina y que impacte los componentes Backend debe ser definida en esta tabla.
Tipos de Librerías
- Librerías Lanzadoras: Son las que exponen las operaciones de los servicios SOAP (Generan la estructura del WSDL).
- Librerías Invocadoras: Contienen las clases que orquestan la ejecución de los procesos asociados a las operaciones de los servicios expuestos.
- Librerías Modelo (Lógica del Negocio): Contiene las clases de la lógica del negocio.
Capas de Implementación
- Capa Core: Capa relacionada con los procesos internos de ejecución. Por lo general está asociada a las operaciones del Framework.
- Capa Controller: Capa relacionada con los procesos de orquestación de servicios.
- Capa Model: Capa relacionada con los procesos de la lógica del negocio (código migrado).
Prefijos
- ws: (WebService): Prefijo asociado a la exposición de servicios. Es utilizado por las librerías lanzadoras.
- sf: (Software): Prefijo asociado a las librerias de implementación de los procesos y la exposición de los servicios.
Librerías
Se deben crear respetando las siguientes convenciones de acuerdo a la capa de implementación (se toma como ejemplo el componente Login):
| Tipo Libreria | Prefijo | Código Aplicación | Capa de implementación | Nombre Componente | Ejemplo |
|---|---|---|---|---|---|
| Lanzadora | ws | 00 | No Aplica | login | ws00_login.pbl |
| Invocadora | sf | 00 | controller | login | sf00controller_login.pbl |
| Modelo | sf | 00 | model | login | sf00model_login.pbl |
Observaciones
- Todos los nombres de librerías deben ser en minuscula.
- La capa de implementación de la libreria Lanzadora no aplica porque esa capa es gestionada automaticamente por powerbuilder al desplegar las operaciones de los servicios SOAP.
- Los nombres pueden contener el separador _
- Los nombres deben representar las funcionalidades contenidas, debe evitar acronimos.
- Los nombres no deben estar duplicados incluso en otros proyectos.
Codificación
Calificadores de Alcance
| Alcance | Prefijo | Ejemplo | Restricciones |
|---|---|---|---|
| Argumento | a | al_variable | Ninguna |
| Global | g | gl_variable | No permita en la implementación |
| Instance | i | il_variable | Ninguna |
| Local | l | ll_variable | Ninguna |
| Shared | s | sl_variable | No permita en la implementación |
Calificadores de Alcance
| Tipo Dato | Prefijo | Ejemplo | Observaciones |
|---|---|---|---|
| Any | a | la_raw | Solo se puede utilizar en las librerias Modelo |
| Blob | blb | lblb_image | Se recomienda hacer uso limitado de este tipo y solo en las librerías Modelo |
| Boolean | b | lb_exit | |
| Character | c | lc_letra | |
| Date | d | ld_fecha | Evaluar el uso de este tipo en procesos que van a la base de datos. Se recomienda usar el tipo Datetime |
| Datetime | dt | ldt_fecha | |
| Decimal | dec | ldec_numero | |
| Double | db | ldb_numero | |
| Integer | i | li_numero | |
| Long | l | ll_numero | |
| Real | r | lr_numero | Se recomienda el uso del tipo Double |
| String | s | ls_cadena | |
| Time | t | lt_tiempo | Evaluar el uso de este tipo en procesos que van a la base de datos. Se recomienda usar el tipo Datetime |
| Unsigned Integer | ui | lui_numero | |
| Unsigned Long | ul | lul_numero |
Prefijos de Tipo de Datos de Objetos Estándar
| Tipo Dato | Prefijo | Código Aplicación | Ejemplo | Observaciones |
|---|---|---|---|---|
| Application | ws | 00 | ws00_login | Solo para proyectos de exposición de servicios |
| Application | app | 00 | app00_login | Solo para proyectos de consumo de servicios (Proxy) |
| ClassDefinition | cldef | lcldef_Object | ||
| ClassDefinitionObject | cldefo | lcdefo_ThatObject | ||
| Connection | cn | lcn_Known | ||
| ConnectionInfo | cni | lcni_ServerInfo | ||
| ConnectObject | cno | scno_ConObj | ||
| Datastore | ds | lds_source | ||
| Datawindow Grid | dwg | dwg_lista | Solo aplica para la definición del control. No para utilización en la implementación | |
| Datawindow Free | dwf | dwf_consulta | Solo aplica para la definición del control. No para utilización en la implementación |
ada/tips/sicoferp/general/pbtows/procesos/developmentstandards/nomenclature/pb.1571349089.txt.gz · Última modificación: 2019/10/17 21:51 por administraidor
Herramientas de la página
