High Quality
Open the downloaded document, and select print from the file menu (PDF reader required).
Curso Básico de Introducción a
GeneXus
Nomenclatura
http://www.GxSoft.com.GxSoft ARGENTINA.
1
Nicolás:
El escrito que sigue nunca fue terminado, no obstante nosotros, en GxSoft, usamos un conjunto de reglasmucho mas extenso que abarcó a los subtipos, tablas, procedures, etc. .También esta nomenclatura la usamos en otros ámbitos e hicimos un “codificador” de nombres que seusaba para usuarios y también se usó para localidades (en un sistema de transporte que usaba 4 letraspara sus nombres)El fuerte de esta regla es que nosotros “
calculamos”
el nombre de los atributos y objetos, por ejemplo, sitenemos un programa corriendo, en el FORM de la transacción “vemos” las descripciones o títulos de losatributos en la pantalla y con certeza
sabemos
cuál es el nombre exacto del atributo que contiene lainformación.Elegimos el juego entre 4 y 3 para que llegar a 10 fácilmente, esto dependerá de los gustos y podría ser configurado, más ahora que piensan levantar el límite de 10 caracteres para los nombres de los objetosGeneXus, no obstante, la cantidad de caracteres debe ser fijo y previamente conocido por el equipo quetrabaja sobre una KB.
La idea sería implementarlo como un asistente de escritura en tiempo de diseño de la KB, tepuedo mandar un programa que simule esto que te estoy diciendo, también debería existir undiccionario de sinónimos para asistir en run-time al diseñador, luego podría existir un re-nomenclador a partir de una KB existente (usando GxPublic no habría problemas).
Por último y lomás delicado
: el orden de toma de datos en la creación de atributos debería ser al revés queahora 1ro descripción del atributo y luego el nombre.Si te parece, te puedo mandar más KBs nuestras que usan esta nomenclatura. La que te mandoesta escrita por 3 personas y la hicimos usando esta nomenclatura.La otro que acá no está es que la nomenclatura alcanza o debería alcanzar TODOS los objetosGeneXus, desde un atributo, pasando por los dominios y llegando a folder.Léelo y contéstame. Mientras me pondré a trabajar en el programa que hace de asistente de lanomenclatura... .
Nota: Al Final hay un ANEXO que comparaGIK .vs. Nomenclatura GxSoft
Curso Básico de Introducción a
GeneXus
Nomenclatura
http://www.GxSoft.com.GxSoft ARGENTINA.
2
Nomenclatura GxSoft(adaptada a
GeneXus
tm
)1.
Introducción.
Antes de comenzar con la “escritura” de un sistema debemos acordar los nombres de las entidades de larealidad, a partir de los cuales se deducirá la denominación. La Nomenclatura presente esta pensada parasistemas de gran porte y para maximizar las posibilidades de trabajo en equipo que brinda
GeneXus
.
1.1.
DEDUCIR UN NOMBRE
Cuando nos enfrentamos a desarrollos de gran porte, no es fácil conocer o memorizar todos los nombres delos elementos de un sistema. Cuando decimos elementos nos referimos a los Objetos GeneXus a las tablas alas Variables, Funciones, etc..Puede uno recordar los nombres que ha ido usando a través del desarrollo de una aplicación, pero por cuánto tiempo?. Es probable entonces que en el corto plazo de una aplicación y mientras estemos “sobre” ... recordemosgran cantidad de nombres y si no fuera así quizá consultando un diccionario de datos, si lo fuimosconstruyendo, podamos encontrar la denominación de un elemento dado. Pero qué pasará cuandotrabajemos en equipo?, cómo podrá cada integrante del equipo entender lo que otro integrante ha escrito?.
1.2.
ENTENDER LOS NOMBRES:
Para solucionar este problema de “entender” lo que cada uno escribe, o tener que “recordar” los nombresde los objetos que se irán usando a través de la aplicación hay que “acordar” una nomenclatura en común para cada uno de los elementos que se deban denominar en un desarrollo. La nomenclatura elegida debeindicarnos de que se trata sino además debe ser también “deducible” (que dado un nombre de la“realidad” exista una regla de denominación tal que el nombre del elemento sea único) es decir, partiendode la denominación de un elemento en la “vida real” se llegue a una única denominación. Estos objetivosno son fáciles de conseguir, pero tampoco son poco importantes como para que no hagamos el esfuerzonecesario para alcanzarlo.
1.3.
MINIMIZAR LA “DISYUNCIÓN”
A diferencia de otras nomenclaturas, la propuesta es más rígida que otras existentes, pero obtenemos comoventaja su “deducibilidad”. Con el objetivo de que el mismo objeto de la realidad se denomine igual encada “cita” interna en la Knowledge Base.
1.4.
MINIMIZAR LA “COLISIÓN”
Un problema que se puede dar es que la raíz de dos objetos de la realidad sea la misma, en este caso se puede prevenir Nombrando los Objetos de la realidad que participaran en el sistema antes de comenzar aescribir la KB. El largo total de un nombre es de 10 (diez) caracteres de manera que se respetará este límite. Lanomenclatura para la mayor parte de los elementos es de 4 letras a las cuales se le agregarán Sufijos y/o prefijos de 3 letras llegando a 10 caracteres cuando se le agreguen ambos ( un prefijo y un sufijo).
Curso Básico de Introducción a
GeneXus
Nomenclatura
http://www.GxSoft.com.GxSoft ARGENTINA.
3
2.
Reglas de Nomenclatura.
Nota:Las preposiciones
de, del se Ignoran!.
2.1.
Regla General 1. Los Nombres se truncan a 4 letras.
Todo nombre tiene cuatro caracteres, el mismo deriva de la denominación en la realidad (Cliente, Factura, Artículos, Calles)
. Este componente de 4 Letras se denominará de aquí enadelante
NUCLEO
de la nomenclatura.
2.1.1.
Si es de una Palabra.
La palabra se corta sin abreviar a sus cuatro primeros caracteres.
2.1.2.
Si es de dos Palabras.
El nombre resulta de la primera letra de la primera palabra concatenada a las tres primerasletras de la segunda palabra.
2.1.3.
Si es de tres Palabras.
El nombre resultará de la primera letra de la primera palabra concatenada a la primera letrade la segunda palabra y las dos primeras letras de la tercera palabra.
2.1.4.
Si es de cuatro Palabras.
El nombre resultará de concatenar la primera letra de cada una de las cuatro palabras
.
2.1.5.
Si hay Colisión de nombres.
Cuando de dos objetos de la realidad a nomenclar y aplicando la REGLA 1 se produzca elmismo resultado, se buscarán sinónimos del elemento en la vida real (p.e.
Producto
s = Artículos, Materiales, Parte, Repuesto, etc.) y si de todas maneras sigue ocurriendo lacolisión se le eliminarán vocales, en el nombre menos importante y si se volviera a colisionar se usará la primera letra de cada silaba. ver anexo 1.
Add a Comment