Prueba de Test
Páginas: 16 (3843 palabras)
Publicado: 22 de abril de 2014
ANEXO I. Estándares de Programación del Framework COBISExplorer.NET
Como complemento al presente documento, a continuación de relacionan algunas observaciones a aquellos estándares aplicables al proyecto de la CFN en los que se hace necesario efectuar aclaraciones sobre su uso, aplicabilidad, opcionalidad y manejo del idioma en la implementación de funcionalidades que hacen uso delFramework de COBISExplorer.NET
Es de anotar que los ejemplos de código adjuntos al presente documento, son únicamente referenciales, corresponden a la propuesta inicial, sobre la cual y de acuerdo a las necesidades podrá ser extendido o complementado en el tiempo.
ITEM
Observaciones
1.3.1.1 Tipos de proyectos Visual Studio
a) COBISModule Project
El nombre correspondiente al producto dentro delnamespace se especificará en español, para el caso de funcionalidades o componentes comunes por estándar se agruparán dentro de la subdivisión Commons, las demás subdivisiones se especificarán en español.
El nombre del módulo a crear estará en español, con la terminación de la palabra Module la cual es generada automáticamente por el asistente.
b) Proyecto DTO
El nombre del proyecto DTO,los nombres de las clases DTO y sus atributos estarán especificados en español, la excepción será para los objetos comunes que se agruparán bajo el namespace terminado en Commons.
Los proyectos y DTO´s se generarán automáticamente por medio del generador de Servicios COBIS CEN SG, por lo que los demás nombres, observaciones, comentarios y demás código generado automáticamente estará en inglés.c) Proyecto Services
El nombre del proyecto de servicios, nombre de métodos y observaciones estarán especificados en español, la excepción será para los servicios comunes que se agruparán bajo el namespace terminado en Commons.
El resto identificadores, variables, código y comentarios, propios de la implementación del servicio, al ser generados automáticamente por COBIS CEN SG, estarán eninglés.
1.3.1.2 Estructura de namespaces
Los nombres de “Subsistema de Negocio” y “División Funcional” estarán en español a excepción de las divisiones funcionales comunes de cada módulo o producto a desarrollar los cuales estarán agrupados bajo la División Funcional “Commons”.
1.3.1.3 Estructura de carpetas de aplicaciones estándar
Por estándar y con el fin de dar mayor aplicabilidadal patrón MVP, se crearán los siguientes proyectos a saber para el desarrollo de una funcionalidad estándar:
a) Proyecto DTO
b) Proyecto Service
c) Proyecto Presenter
d) Proyecto Vistas
1.3.2.2.3.2 Implementación de Rastreos dentro de código
El registro de errores y excepciones de funcionalidades a nivel de Presenter deberá ser registrado con nivel logDebug.
Para elcaso de Componentes dependiendo de la complejidad se usarán los diferentes niveles de logs, como mínimo los niveles logDebug y logInfo
1.3.2.3.1.1 Lineamiento para la definición de los Identificadores de los Recursos
El idioma para la definición de los nombres de las constantes será en español, respetándose los valores del dominio y estructura de las mismas.
Para referencia a los estándarespara el Manejo de Recursos, referirse al documento: “Estándares de Programación de COBIS Explorer .NET” capítulo: 1.3.2.3 Manejo de Recursos.
1.3.2.3.2 Creación de una librería de recursos
La librería de recursos será administrada por medio de un proyecto C# cuyo nombre estará bajo el siguiente namespace: “COBISCorp.eCOBIS.[Subsistema de Negocio].Commons.Resources “, en donde, el nombredel subsistema de negocio estará en español.
El código que se debe adicionar en el evento post-build del proyecto para Visual Studio 2010 y FrameWork 4 es el siguiente:
"$(DevEnvDir)..\..\..\Microsoft SDKs\Windows\v7.0A\bin\resgen"
"$(ProjectDir)Properties\ResourcesES.resx" "$(ProjectDir)$(ProjectName).resources"
"$(DevEnvDir)..\..\..\Microsoft SDKs\Windows\v7.0A\bin\al" /t:lib...
Como complemento al presente documento, a continuación de relacionan algunas observaciones a aquellos estándares aplicables al proyecto de la CFN en los que se hace necesario efectuar aclaraciones sobre su uso, aplicabilidad, opcionalidad y manejo del idioma en la implementación de funcionalidades que hacen uso delFramework de COBISExplorer.NET
Es de anotar que los ejemplos de código adjuntos al presente documento, son únicamente referenciales, corresponden a la propuesta inicial, sobre la cual y de acuerdo a las necesidades podrá ser extendido o complementado en el tiempo.
ITEM
Observaciones
1.3.1.1 Tipos de proyectos Visual Studio
a) COBISModule Project
El nombre correspondiente al producto dentro delnamespace se especificará en español, para el caso de funcionalidades o componentes comunes por estándar se agruparán dentro de la subdivisión Commons, las demás subdivisiones se especificarán en español.
El nombre del módulo a crear estará en español, con la terminación de la palabra Module la cual es generada automáticamente por el asistente.
b) Proyecto DTO
El nombre del proyecto DTO,los nombres de las clases DTO y sus atributos estarán especificados en español, la excepción será para los objetos comunes que se agruparán bajo el namespace terminado en Commons.
Los proyectos y DTO´s se generarán automáticamente por medio del generador de Servicios COBIS CEN SG, por lo que los demás nombres, observaciones, comentarios y demás código generado automáticamente estará en inglés.c) Proyecto Services
El nombre del proyecto de servicios, nombre de métodos y observaciones estarán especificados en español, la excepción será para los servicios comunes que se agruparán bajo el namespace terminado en Commons.
El resto identificadores, variables, código y comentarios, propios de la implementación del servicio, al ser generados automáticamente por COBIS CEN SG, estarán eninglés.
1.3.1.2 Estructura de namespaces
Los nombres de “Subsistema de Negocio” y “División Funcional” estarán en español a excepción de las divisiones funcionales comunes de cada módulo o producto a desarrollar los cuales estarán agrupados bajo la División Funcional “Commons”.
1.3.1.3 Estructura de carpetas de aplicaciones estándar
Por estándar y con el fin de dar mayor aplicabilidadal patrón MVP, se crearán los siguientes proyectos a saber para el desarrollo de una funcionalidad estándar:
a) Proyecto DTO
b) Proyecto Service
c) Proyecto Presenter
d) Proyecto Vistas
1.3.2.2.3.2 Implementación de Rastreos dentro de código
El registro de errores y excepciones de funcionalidades a nivel de Presenter deberá ser registrado con nivel logDebug.
Para elcaso de Componentes dependiendo de la complejidad se usarán los diferentes niveles de logs, como mínimo los niveles logDebug y logInfo
1.3.2.3.1.1 Lineamiento para la definición de los Identificadores de los Recursos
El idioma para la definición de los nombres de las constantes será en español, respetándose los valores del dominio y estructura de las mismas.
Para referencia a los estándarespara el Manejo de Recursos, referirse al documento: “Estándares de Programación de COBIS Explorer .NET” capítulo: 1.3.2.3 Manejo de Recursos.
1.3.2.3.2 Creación de una librería de recursos
La librería de recursos será administrada por medio de un proyecto C# cuyo nombre estará bajo el siguiente namespace: “COBISCorp.eCOBIS.[Subsistema de Negocio].Commons.Resources “, en donde, el nombredel subsistema de negocio estará en español.
El código que se debe adicionar en el evento post-build del proyecto para Visual Studio 2010 y FrameWork 4 es el siguiente:
"$(DevEnvDir)..\..\..\Microsoft SDKs\Windows\v7.0A\bin\resgen"
"$(ProjectDir)Properties\ResourcesES.resx" "$(ProjectDir)$(ProjectName).resources"
"$(DevEnvDir)..\..\..\Microsoft SDKs\Windows\v7.0A\bin\al" /t:lib...
Leer documento completo
Regístrate para leer el documento completo.