Вы находитесь на странице: 1из 24

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

ESTNDARES DE DESARROLLO CRM


Definicin de estndares y normas de codificacin.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

OBJETIVO .................................................................................................................................................. 3 HERRAMIENTAS RECOMENDADAS .............................................................................................................. 4 DEFINICIONES............................................................................................................................................ 6


Definicin de estndares generales de codificacin. ......................................................................... 6 Definiciones generales de la estructura de los componentes:........................................................ 10 Definiciones generales de formato para codificacin en PHP: ...................................................... 11 Definiciones generales de estructura para codificacin en PHP: .................................................. 13 Definiciones generales de interaccin con la base de datos para el cdigo en PHP:............ 14 Definiciones generales de formato para codificacin en Java Script: ........................................ 15 Definiciones generales de estructura para codificacin en Java Script:..................................... 17 Definiciones generales de interaccin entre clases en Java Script: .............................................. 18 Definiciones generales de formato para la creacin de objetos en la Base de Datos: .......... 19

CONCLUSIONES: ..................................................................................................................................... 23

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Objetivo

Establecer las normas y convenciones necesarias para el desarrollo e integracin de mdulos y funcionalidades al sistema CRM para que de esa manera se eleve la calidad, portabilidad, eficiencia y legibilidad del cdigo.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Herramientas recomendadas

CRM fue creado con la finalidad de integrar la mayor cantidad posible de herramientas existentes en nuestra empresa que participen directa o indirectamente en la operacin, principalmente los elementos que se encuentren dentro de las fases necesarias desde la labor de pre-venta hasta la entrega de los servicios y el aseguramiento de los mismos. De tal manera que para el desarrollo de CRM se eligi una tecnologa web que fuese capaz de integrar a otras herramientas en un mismo ambiente y que adems les proporcione la capacidad de compartir informacin, ofreciendo as al usuario una interfaz nica que le ayude a agilizar los procesos que hoy realiza, es por esto que se recomienda el uso de las siguientes herramientas que adems de cumplir con estos requisitos permiten la creacin de aplicaciones basadas en un modelo Vista Controlador especialmente para la creacin de nuevos mdulos, las herramientas ya existentes debern en la medida de lo posible adaptarse a las siguientes definiciones.

Tipo

Tecnologa

Versin

Caractersticas -Framework muy ligero que permite explotar todas las caractersticas de la web 2.0, Ajax, DHTML, DOM, Air, etc. -Proporcionar una gran cantidad de componentes de desarrollo web cada vez ms similares a los utilizados en el desarrollo de aplicaciones de escritorio.

Front-End

Javascript ExtJS

3.3.1 o 4

-Soporta el manejo de informacin a travs de JSON y XML. -Al estar basado en un lenguaje de scripting permite gran control al programador sobre el nivel al que desea programar y especialmente la carga de objetos que tendr su aplicacin, el programador podr incluso modificar el ncleo del framework a su conveniencia o simplemente utilizar las clases ya definidas. -Lenguaje de programacin orientado a objetos de libre distribucin creado con la finalidad del desarrollo de aplicaciones web dinmicas. -Dentro de las bibliotecas nativas presenta las

Back-End

PHP

5o superior.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

libreras necesarias para el trabajo con la gran mayora de los motores de base de datos existentes. -Expandible, seguro y confiable. -Creado con la finalidad de la creacin de aplicaciones web que se adapten a una arquitectura de Modelo Vista Controlador. -De licencia libre. -Manejador de base de datos relacional con alta estabilidad y escalabilidad. -Soporte multiplataforma. Base de Datos Oracle 10g o superior -Capaz de gestionar grandes cantidades de transacciones y usuarios concurrentes. -Sistema de alta disponibilidad. -Capacidad de ser un sistema distribuido.

El uso de estas herramientas solo es impositivo para la creacin de nuevos mdulo.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Definiciones.

Definicin de estndares generales de codificacin.


Definicin de nombres:

Todas las aplicaciones y objetos debern seguir las siguientes definiciones.


Ubicacin:

Cada mdulo deber tener su propia carpeta la cual deber encontrarse dentro de la carpeta de la aplicacin a la que pertenece, el nombre de la misma debe ser el ttulo del objeto o aplicacin. Todas las subcarpetas debern seguir la misma lgica agregando niveles al rbol de archivos.
Referencias:

Todas las referencias entre programas debern realizarse a travs de la nomenclatura de navegacin que utilice la herramienta en la cual se desarrollan, esto es se deber evitar el direccionamiento directo permitiendo a la aplicacin la capacidad de transporte sin la necesidad de configuracin extra.

Ttulo:

El ttulo de la aplicacin u objeto debe iniciar con un acrnimo de 3 letras que identifique el paquete al que pertenece seguidos por un guin bajo y el nombre del componente o modulo utilizando el formato lower Camel Case, se recomienda buscar una definicin corta y que no exceda las 2 palabras. Para todos los subcomponentes del mdulo se deber utilizar la misma nomenclatura, siendo el nombre lo ms conciso y preciso posible en cuanto a la funcin del componente.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Se recomienda adems dividir los componentes por tecnologa utilizada para agilizar su ubicacin y facilitar su reutilizacin.
Ejemplo:

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Estructura:

Cabecera: La cabecera de todos los componentes debern presentar los siguientes comentarios dependiendo de la tecnologa utilizada ser el formato de los mismos, lo importante es que contengan la siguiente informacin.

Tipo: El tipo de componente del que forma parte el encabezado como puede ser mdulo, clase, control, estilo, etc.

Paquete: Si el componente es parte de una estructura ms compleja, como paquetes o contenedores se deber nombrar en este campo. Si es necesario mencionar la ruta del componente o paquete.

Nombre: El nombre del componente utilizando la nomenclatura utilizada para el nombre del archivo y en formato lower Camel Case.

Autor: El nombre del grupo encargado del desarrollo, como puede ser Mercado Empresarial, EIDON, Blitz, Zentrum, etc.

Versin: Nmero de versin del componente.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Fecha: Fecha de creacin del componente. El formato de la fecha debe ser da, mes y ao separados por /, da y mes debern expresarse en dos dgitos y ao en cuatro.

Descripcin: Enunciado que describa la funcionalidad del componente de la forma ms precisa y concisa posible.

Ejemplo de cabecera para un componente en Javascript:

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Definiciones generales de la estructura de los componentes:

Debido a que la primera fase de la construccin de CRM se basa principalmente en la integracin de diferentes tecnologas se recomienda utilizar el estndar definido generalmente por la empresa desarrolladora de la herramienta para cada una de estas, en este documento solo haremos mencin de las convenciones especficas para PHP, JS, EXTJS y Oracle que sern las herramientas utilizadas en la creacin de nuevos componentes, sin embargo primero enumeraremos algunas normas que deben ser cubiertas para todas las tecnologas.

Indentacin: Debe permitir identificar a simple vista los diferentes bloques de cdigo que contiene nuestro componente, subrutinas, bloques condicionales, etc. Sin permitir que se confundan con elementos de la misma ndole, generando as la cantidad de niveles necesarios, se sugiere que para cada nivel se utilice un espacio igual a un tabulador.

Nombres: Debido a la diferencia de la notacin de las diferentes tecnologas se recomienda apegarse a los estndares establecidos para cada una de las tecnologas para nombrar cada uno de los elementos como son: Clases, objetos, variables, mtodos, etc. En caso de no existir una definicin clara para algn elemento en especfico se utilizar la notacin hngara para definir el nombre y utilizando el formato lower Camel Case.

Codificacin: Para lenguajes interpretados se debe guardar los archivos en formato ASCII utilizando la codificacin ISO-8859-1. Para las dems tecnologas se podr utilizar cualquier codificacin aunque se recomienda ampliamente utilizar la misma que para los lenguajes interpretados.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Definiciones generales de formato para codificacin en PHP:

A continuacin se detallan las convenciones que deben ser utilizadas para codificar algn componente en PHP:

Bloques PHP: Evitar en la medida de lo posible incluir bloques PHP dentro de archivos o bloques de cdigo de una tecnologa diferente especialmente si estas son client-side. Utilizar AJAX para la comunicacin entre las diferentes tecnologas. Para definir el inicio de un bloque en PHP utilice las etiquetas largas <?PHP y > para evitar depender de la configuracin del host para el correcto funcionamiento de las aplicaciones.

Comentarios: Para los comentarios deber utilizarse el formato de /* y */ para un bloque o // para una lnea deber evitarse el uso de #.

Inclusiones: Para incluir un archivo o dependencia debern utilizarse las instrucciones require_once para cuando se incluya un archivo de configuracin que no sea indispensable para la ejecucin del mdulo e include_once para cuando la inclusin sea indispensable.

Estructuras de control: Las estructuras de control debern codificarse sin dejar espacio en blanco desde el keywordy el parntesis que indica la apertura de las mismas, la llave de apertura deber de estar en la misma lnea.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Namespaces: Todos los namespaces debern estar formados por una palabra o inciales sin puntos entre las mismas en minsculas, las cuales definan de la forma ms precisa el objetivo del namespace.

Clases: Todas las clases debern nombrarse utilizando la notacin hngara y el formato Upper Camel Case. Debern expresar de forma precisa el objetivo de la clase y en la mayora de los casos debera estar formada por una sola palabra.

Funciones: Las funciones debern nombrarse utilizando la notacin hngara y el formato Lower Camel Case. El nombre deber expresar de forma concisa la labor de la misma.

Variables: Las variables debern nombrarse utilizando la notacin hngara y el formato Lower Camel Case. El nombre deber expresar de forma concisa el objetivo de la misma.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Definiciones generales de estructura para codificacin en PHP:

El modelado y programacin de las aplicaciones deber ser orientado a objetos, creando clases que no sean exclusivas del mdulo que las implementa si no que puedan convertirse en un componente reutilizable para otros mdulos. Las clases debern estar en un solo archivo el cual contendr la definicin completa de las mismas, siguiendo las normas de formato descritas en este mismo documento previamente, deben pertenecer a un namespace. De esta forma no deber existir cdigo de inicializacin o de cualquier otra ndole dentro del archivo y fuera de la definicin de la clase a menos que este sea parte del proceso nativo de la misma. La definicin de los namespaces deber coincidir con el rbol de directorios en los cuales se implemente el mismo, ya que esto no contrapone las reglas de formato establecidas y nos ayudan a identificar de manera ms gil cualquier referencia a otras clases, sin necesidad de ubicarla dentro de la documentacin. PHP solo se utilizar del lado del servidor, permitiendo que otras tecnologas de scripting sean las utilizadas para el front-end y harn las llamadas a PHP a travs de AJAX. La llamada y respuesta a estos objetos a travs de AJAX deber ser en formato JSON. Lo ms importante de esta estructura es hacer del cdigo lo ms legible y reutilizable posible, es importante documentar cada uno de los procesos y registrarlos dentro del namespace permitiendo a otros desarrolladores la utilizacin de los mismos. Todas las referencias internas a elementos de la clase debern hacerse a travs del objeto predefinido por PHP $this->evitando el uso de referencias a travs del nombre de la clase o la variable del tipo del objeto.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Definiciones generales de interaccin con la base de datos para el cdigo en PHP:

Se utilizar la librera Dupral para la interaccin entre PHP y la base de datos. Todos los objetos que utilicen esta librera debern de cerciorarse que las conexiones a la base de datos sean cerradas despus de la ltima transaccin entre PHP y la base de datos, este punto es de suma importancia para evitar bloqueos en la base de datos as como bajo rendimiento en la aplicacin. No se debern de abrir ms conexiones a la base de datos a menos que sea necesario tener diferentes cursores abiertos al mismo tiempo. Para las llamadas a procedimientos o consultas a la base de datos, la cadena deber escribirse en maysculas entre comillas dobles ( ) y utilizando comillas simples ( ) para los valores que tengan relacin con un campo en cualquiera de los formatos de texto definidos por la base de datos. Todas las variables dentro de una consulta o llamada a un procedimiento debern ser asignadas a la variable en PHP en una sola operacin de asignacin a menos que el flujo del proceso requiera la concatenacin condicional de las instrucciones. Las variables relacionadas con un campo en cualquiera de los formatos de texto definidos por la base de datos no debern concatenarse a travs del operador de concatenacin (.) si no que debern formar parte de la cadena en una sola asignacin. Para la obtencin de valores desde un procedimiento o funcin desde la base de datos la variable que los recibe deber ser declarada previamente e igualada a una cadena vaca con el uso de comillas simples ( ) y no a la constante predefinida NULL ni a ningn otro valor como 0 para datos numricos. Todas las consultas a la base de datos debern de presentar el comando AS para definir un alas a los campos obtenidos por las mismas, se evitar el uso del operador * previniendo as que si se presenta un cambio en la base de datos el programa deba ser modificado. Cualquier operacin de INSERT deber especificar exactamente los campos que se agregarn evitando as que si se presenta un cambio en la base de datos el programa deba ser modificado. Cuando se utilice una secuencia en cualquier instruccin no se generar un query u operacin adicional para obtener el valor de la misma, si no que se integrar dentro de la operacin utilizando el comando NEXTVAL.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Definiciones generales de formato para codificacin en Java Script:

A continuacin se detallan las convenciones que deben ser utilizadas para codificar algn componente en Java Script:

Bloques Java Script: Evitar en la medida de lo posible incluir bloques Java Script dentro de archivos o bloques de cdigo de una tecnologa diferente especialmente si estas son serverside. Las llamadas a cualquier componente en server-side debern de ser asncronas.

Comentarios: Para los comentarios deber utilizarse el formato de /* y */ para un bloque y // para una lnea.

Inclusiones: Existirn dos tipos de inclusiones en Java Script, inclusiones realizadas al inicio de la ejecucin del componente e inclusiones en tiempo de ejecucin. Las inclusiones que se realicen al inicio de la ejecucin del componente debern realizarse a travs de cdigo HTML mediante el tag <SCRIPT>es de suma importancia definir el tipo de script que se est incluyendo, la definicin de la fuente no deber contener la ruta completa del componente si no que deber acceder al mismo a travs de referencias mediante la navegacin del directorio valindose de los comandos ../ Para subir a travs del rbol de directorios y especificando los diferentes directorios para bajar a travs de los mismos. Las inclusiones que se realicen en tiempo de ejecucin y que deben utilizarse solo en el caso de componentes que su carga est condicionada por el flujo del programa y que no sean indispensables en la carga inicial del mismo. Para realizar esta carga se deber acceder al cabecero del documento HTML e introducir el componente necesario a travs de Java Script.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Estructuras de control: Las estructuras de control debern codificarse sin dejar espacio en blanco desde el keyword y el parntesis que indica la apertura de las mismas, la llave de apertura deber de estar en la misma lnea.

Namespaces: Todos los namespaces debern estar formados por una palabra o inciales sin puntos entre las mismas en minsculas, las cuales definan de la forma ms precisa el objetivo del namespace.

Clases: Todas las clases debern nombrarse utilizando la notacin hngara y el formato Upper Camel Case. Debern expresar de forma precisa el objetivo de la clase y en la mayora de los casos debera estar formada por una sola palabra.

Funciones: Las funciones debern nombrarse utilizando la notacin hngara y el formato Lower Camel Case. El nombre deber expresar de forma concisa la labor de la misma.

Variables: Las variables debern nombrarse utilizando la notacin hngara y el formato Lower Camel Case. El nombre deber expresar de forma concisa el objetivo de la misma.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Definiciones generales de estructura para codificacin en Java Script:

El modelado y programacin de las aplicaciones deber ser orientado a objetos, creando clases que no sean exclusivas del mdulo que las implementa si no que puedan convertirse en un componente reutilizable para otros mdulos. Las clases debern estar en un solo archivo el cual contendr la definicin completa de las mismas, siguiendo las normas de formato descritas en este mismo documento previamente, deben pertenecer a un namespace. De esta forma no deber existir cdigo de inicializacin o de cualquier otra ndole dentro del archivo y fuera de la definicin de la clase a menos que este sea parte del proceso nativo de la misma. La definicin de los namespaces deber coincidir con el rbol de directorios en los cuales se implemente el mismo, ya que esto no contrapone las reglas de formato establecidas y nos ayudan a identificar de manera ms gil cualquier referencia a otras clases, sin necesidad de ubicarla dentro de la documentacin. Lo ms importante de esta estructura es hacer del cdigo lo ms legible y reutilizable posible, es importante documentar cada uno de los procesos y registrarlos dentro del namespace permitiendo a otros desarrolladores la utilizacin de los mismos. Todas las referencias internas a elementos de la clase debern hacerse a travs del objeto predefinido por Java Script this evitando el uso de referencias a travs del nombre de la clase o la variable del tipo del objeto, es muy importante siempre tener el control del scope de los diferentes elementos. Si es necesario acceder a elementos de un diferente scope del cual nos encontramos parados evitaremos nuevamente las referencias directas en lugar de esto deberemos cambiar el scope actual al scope que necesitamos.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Definiciones generales de interaccin entre clases en Java Script:

Para la definicin de los parmetros recibidos por las funciones de un objeto deberemos definir dos tipos de parmetros.

Parmetros indispensables: Parmetros que son indispensables para la ejecucin exitosa de la funcin, estos parmetros debern definirse de forma explcita en la definicin de la funcin.

Parmetros opcionales: Parmetros que no son indispensables para la ejecucin exitosa de la funcin pero que su definicin modifica el comportamiento de la misma, estos parmetros debern definirse a travs de un solo parmetro el cual ser capaz de recibir un arreglo de valores en formato JSON y que podrn ser utilizados dentro de la funcin.

La respuesta de una funcin se dar dependiendo del tipo de dato que retorne, en caso de ser un valor se regresar el valor en tal cual sin importar el tipo del mismo ya sea objeto o tipo de dato nativo, si deseamos regresar un conjunto de valores se deber de hacer a travs de un objeto en formato JSON.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Definiciones generales de formato para la creacin de objetos en la Base de Datos:

A continuacin se detallan las convenciones que deben ser utilizadas para la creacin de algn componente en la base de datos: Tablas: Las tablas debern ser nombradas de la siguiente forma: Se antepone el prefijo CRM_ seguido del nombre de la misma el cual deber reflejar de manera concisa la descripcin de los objetos que contiene el cual ser definido en plural y se escribir en maysculas, en caso de que sea necesaria ms de una palabra para la definicin de la misma estas estarn separadas por un guin bajo (_). Campos: Antes de definir los campos de una tabla es necesario hacer un anlisis completo de los que debern formar parte de la misma para poder ordenarlos con el siguiente orden de precedencia. -ndices primarios. -ndices compuestos. -Llaves forneas. -Campos en orden lgico en base a la definicin de los registros. Los nombres de los campos deben reflejar de forma precisa el dato que contienen, el nombre debe estar formado por un prefijo a tres caracteres del nombre de la tabla seguido por un guin bajo (_), todo esto seguido por el nombre del campo en singular, en caso de ser necesario el uso de ms de una palabra estas estarn separadas por un guin bajo (_).

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

ndices:
Primarios: El nombre de los ndices deber definirse utilizando el prefijo CRM_IDX_ seguido por el nombre del mismo que describa de forma precisa su objetivo.

Compuestos: El nombre de los ndices deber definirse utilizando el prefijo CRM_IDC_ seguido por el nombre del mismo que describa de forma precisa su objetivo.

Llaves Forneas: El nombre de las llaves forneas deber definirse utilizando el prefijo CRM_FK_ seguido por el nombre de la misma que describa de forma precisa su objetivo.

Procedimientos:

Nombre: El nombre de los procedimientos deber estar formado por el prefijo CRM_P_ seguido del nombre del mismo que describa de forma precisa la labor del mismo.

Parmetros: La nombres de los parmetros recibidos por el procedimiento debern declararse utilizando notacin hngara y en maysculas, el tipo de dato de los mismos debe ser el ms adecuado para el dato que reciben teniendo siempre en cuenta el rendimiento y evitando reservar memoria que no ser utilizada.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Variables: Las variables dentro de un procedimiento debern nombrarse anteponiendo el prefijo v_ seguidos por el nombre de las mismas el cual se crear utilizando notacin hngara y el formato lower Camel Case el tipo de dato de la variable debe ser el ms adecuado para el dato que almacena teniendo siempre en cuenta el rendimiento y evitando reservar memoria que no ser utilizada.

Estructura: El cdigo dentro de un procedimiento deber ser escrito en maysculas.

Indentacin: Debe permitir identificar a simple vista los diferentes bloques de cdigo que contiene nuestro procedimiento, subrutinas, bloques condicionales, etc. Sin permitir que se confundan con elementos de la misma ndole, generando as la cantidad de niveles necesarios, se sugiere que para cada nivel se utilice un espacio igual a un tabulador.

Funciones:
Nombre: El nombre de las funciones deber estar formado por el prefijo CRM_F_ seguido del nombre del mismo que describa de forma precisa la labor del mismo.

Parmetros: La nombres de los parmetros recibidos por el procedimiento debern declararse utilizando notacin hngara y en maysculas, el tipo de dato de los mismos debe ser el ms adecuado para el dato que reciben teniendo siempre en cuenta el rendimiento y evitando reservar memoria que no ser utilizada.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Variables: Las variables dentro de un procedimiento debern nombrarse anteponiendo el prefijo v_ seguidos por el nombre de las mismas el cual se crear utilizando notacin hngara y el formato lower Camel Case el tipo de dato de la variable debe ser el ms adecuado para el dato que almacena teniendo siempre en cuenta el rendimiento y evitando reservar memoria que no ser utilizada. Estructura: El cdigo dentro de un procedimiento deber ser escrito en maysculas.

Indentacin: Debe permitir identificar a simple vista los diferentes bloques de cdigo que contiene nuestro procedimiento, subrutinas, bloques condicionales, etc. Sin permitir que se confundan con elementos de la misma ndole, generando as la cantidad de niveles necesarios, se sugiere que para cada nivel se utilice un espacio igual a un tabulador

Secuencias:
El nombre de las secuencias deber estar formado por el prefijo CRM_SEQ_ seguido del nombre del mismo que describa de forma precisa la labor del mismo.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

Conclusiones:

Este documento cubre los aspectos bsicos e indispensables que son necesarios para la codificacin de nuevos componentes a integrar al sistema CRM, el presente no pretende cubrir todos los aspectos involucrados en el desarrollo de los mismos, solo de los ms utilizados debido a que por la naturaleza del proyecto esto podra representar un esfuerzo extra el adaptar mdulos y sistemas que ya funcionan con diferentes definiciones, cualquier definicin no establecida en este documento se deber utilizar la propuesta por el proveedor de la tecnologa en cuestin y apegarse a las normas de programacin que el mismo propone. La aplicacin de estas nos permitir obtener un software que pueda ser reutilizado y expandible, ya que podr ser interpretado por cualquier otro desarrollador que se interese en el mismo. Es de suma importancia que todos los grupos involucrados tengan siempre presente que el objetivo final es entregar un software de calidad que cumpla con la mayor cantidad de estndares y normas no solo en la codificacin s no tambin en la administracin de recursos, la interaccin con el usuario, la fiabilidad y expansibilidad del mismo.

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

, S.A.B. DE C.V.

Subdireccin de Sistemas Comerciales

ESTNDARES DE DESARROLLO CRM

ANEXO 1.

Tabla de notacin hngara sugerida. Por alcance: Alcance Local Privada Global Parmetro Por tipo: Tipo Arreglo Carcter Moneda Fecha Fecha y Hora Doble Flotante Lgico Numrico Objeto Desconocido Notacin a c y d t b f l n o u Notacin l p g t

PARA USO INTERNO NICAMENTE/ PROPIEDAD DE TELMEX

Вам также может понравиться