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

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:

Cualquier nueva aplicación que se defina y que impacte los componentes Backend debe ser definida en esta tabla.

• 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.

• 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).

• 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.

Se deben crear respetando las siguientes convenciones de acuerdo a la capa de implementación (se toma como ejemplo el componente Login):

• 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.

• Cualquier tipo de datos o control no definido en la tabla anterior no debe ser utilizado en la generación de componentes ni en el consumo de proxys.

• Cualquier tipo de datos o control no definido en la tabla anterior no debe ser utilizado en la generación de componentes ni en el consumo de proxys.

• Cualquier tipo de datawindows no definido en la tabla anterior no debe ser utilizado en la generación de componentes ni en el consumo de proxys.

• No debe utilizar funciones globales.

La siguientes recomendaciones no imponen reglas de utilización sin embargo trate en lo posible de aplicarlas ya que el hacerlo optimiza el código generado:

• Evite el uso de variables globales.
• No utilice cursores en el código (utilice datastore).
• Evite el uso de funciones globales (agrupelas en objetos no visuales).
• Evite el uso de la tabla Dummy (utilice datawindows external).
• Evite el uso de la función RowCount() en un bucle Ej: for i = 1 to ldwg_prueba.RowCount ya que implica un consumo excesivo de ram en su lugar asigne el valor una variable y utilicela en la definición del bucle.
• Evite el uso del tipo de dato Date en su lugar utilice el tipo Datetime.
• No debe utilizar el tipo de datos Any en la capa de implementacion controller, solo puede ser utilizado en la capa model ya que las conversiones implicitas pueden generar comportamientos indefinidos y excepciones en tiempo de ejecución.
• El valor Nulo solo es permitido en las asignaciones implicitas setNull y en los valores de retornos de la base de datos.