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.