Código

Algunas utilidades para agilizar la edición del código en GeneXus. Se encuentran en el menú Lsi.Extensiones > Código

Autocompletado extendido

Esta extensión añade una función de autocompletado en el editor de código de Genexus, donde Genexus no lo hace. No reemplaza el que ya hace Genexus cuando se muestran miembros miembros de un SDT, BC, etc ni el de variables.

Para que esta extensión funcione correctamente, el Automatic outlining del editor de texto de Genexus debe estar habilitado (por defecto lo está).

Este autocompletado está soportado sólo en lo siguientes sitios:

• Parte Procedure de objetos Procedure
• Parte Events de Transacciones, Workpanels, Webpanels y Panel for Smart Devices
• Parte Conditions de Procedures, Workpanels y Webpanels y Panel for Smart Devices

Cuando se empieza a escribir una palabra, automáticamente aparece una lista con los objetos y palabras del lenguaje que empiezan por el texto escrito. Si se selecciona un elemento de la lista, con el raton o con el teclado (Tab, Enter, Espacio), se autocompleta la palabra:

Esta extensión se puede habilitar / deshabilitar en la configuración.

Por rendimiento, la extensión muestra un número máximo de resultados (15 entradas por cada "espacio de nombres"). Cada vez que se añade o quita una letra, se actualiza la lista.

En algunos (pocos) casos la exensión intenta dar prioridad a alguna de las opciones de la lista de autocompletado. En estos casos, cuando se muestra la lista de palabras probables, la que la extensión considera más probable aparece seleccionada. Esto puede hacerlo con algunas palabras clave, o cuando se escriben parametros en una llamada.

El contexto del lenguaje está parcialmente soportado. Por ejemplo, la palabra clave "WHERE" sólo debería aparecer dentro de un bloque "FOR EACH / ENDFOR", y la extensión sólo la propone en la lista si este es el caso. También, por ejemplo, en procedures sólo se proponen nombres de atributos si se está dentro de un bloque de código donde tengan sentido ("FOR EACH"/ "XFOR" / "NEW"...). No todo el lenguaje está soportado.

La extensión también intenta auto-cerrar bloques de código. Por ejemplo, cuando se escribe "IF" en una línea vacia, automáticamente se añade una segunda línea de código con un "ENDIF" (el cursor queda detrás del IF). Esto intenta hacer con todos los bloques de código (FOR - ENDFOR, Event - EndEvent, etc)

En LSI no tenemos un estandar sobre si escribir las palabras clave en mayusculas o minúsculas. La extensión soporta dos formas de poner las mayusculas/minusculas al autocompletar: Todo en mayusculas ("FOR EACH") o la primera letra en mayusculas ("For each"). Esto se indica en la configuración.

Existe otra extensión que funciona sobre esta, y que intenta predecir cual es la palabra más probable de las que aparecen en la lista de autocompletado. Esta extensión se describe aquí.

En caso de querer mostrar la lista de autocompletado sin tener que escribr una letra, la opción del menú es Lsi.Extensions > Edit > Autocomplete (tecla rápida Ctrl+May+T). La tecla Ctrl+Espacio sigue mostrando el autocompletado original de Genexus.

IF &a = &b msg( 'Cierto' ) ELSE msg ( 'Falso' ) ENDIF

Información extendida de parametros

Esta extensión reemplaza la función de Genexus de mostrar información de los parametros mientras se escribe una llamada a un objeto:

Muestra más información de la que muestra Genexus, y que a nosotros nos es útil. En concreto:

• La longitud y/o decimales del parametro.
• El atributo / dominio en el que está basado
• Si es un array
• Si el parámetro es in: / inout: / out:
• La documentación del parámetro en el que se está posicionado.

Además, la información del parametro se muestra si la llamada al objeto ocupa más de una línea de código. El cuadro con la información de Genexus no aparece la segunda o posteriores líneas de código.

Los parametros se documentan de la siguiente forma:

parm(
        in:&Parametro1,     // Información del parametro 1
        inout:&Parametro2,  // Información del parametro 2. Información del parametro 2...
                            // Información del parametro 2. Información del parametro 2...
        out:&Parametro3, out:&Parametro4    // Información de los parametros 3 y 4 (aparece la misma en los dos)...
);
	    

Esta extensión se puede habilitar / deshabilitar en la configuración. Requiere que la extensión de Autocompletado extendido esté habilitada. Se puede configurar para reemplazar la información de Genexus siempre, nunca, o mostrarla sólo cuando Genexus no muestra la suya (en la segunda o posterior línea de código de la llamada).

Auto-cierre de parentesis y comillas

Esta extensión autocierra los paréntesis de y comillas al escribir código en el editor. Intenta hacer lo mismo que hace el Visual Studio Code (y otros): Cuando escribes "(", automáticamente añade el carácter ")". Hace los mismo con las comillas simples y dobles.

Esta extensión se puede habilitar / deshabilitar en la configuración. Requiere que la extensión de Autocompletado extendido esté habilitada.

Tecla rápida para crear una variable

Añade una tecla rápida para crear una variable desde el editor de código. Es parecido a la opción Add variable que aparece cuando se pulsa botón derecho sobre un nombre de variable en el editor de código:

La tecla rápida es Ctrl+May+C. Si la variable sobre la que está posicionado el cursor no existe, la crea. Si Genexus le da un tipo de datos (p.ej., basado en un atributo o en un dominio), el tipo de la variable se respeta.

Si va a crear con el tipo por defecto ( N(4) ), la extensión mira si en alguno de los objetos abiertos existe una variable con el mismo nombre. Si es así, se asigna el tipo de dicha variable. Si en el editor se tiene seleccionado parte del nombre de la variable a crear (p.ej. "Attribute" en "&AttributeInfo"), la variable se intentará crear basada en "Attribute". Si se usa la tecla rápida cuando el cursor está en una posición en una llamada a un objeto (p.ej. Procedure( &Variable|)), la variable se creará basada en el tipo del parámetro.

Si se pulsa la tecla rápida y la variable ya existe, mueve el foco a la ventana de Properties, y posiciona el foco en la propiedad Based on. Para que esto funcione, la ventana de Properties tiene que estar visible. La idea es no tener que coger el ratón para cambiar el tipo de la variable.

Si se pulsa la tecla rápida, y el foco está en la ventana de Properties, se devuelve el foco al editor de código. Otra vez, la idea es no tener que coger el ratón.

La opción del menú para esta tecla rápida es Lsi.Extensions > Code > Add/edit variable.

Copiar parm del obj. seleccionado al portapapeles (Atajo de teclado: Ctrl+F10)

En LSI, en algunas aplicaciones, documentamos los parametros de los objetos de una forma parecida a como se hace con javadoc o en C#. Un ejemplo del formato de documentación que usamos es este:

///**** REGLAS DEL OBJETO PUCliNomFis ****///
parm(
        in:&EmpCod,     // Código de la empresa base
        in:&CliCod,     // Código del cliente
        in:&Flag,       // Tipo de nombre del cliente a obtener. 'F' = Nombre fiscal, 'C': Nombre comercial
        out:&CliNomFis	// El nombre del cliente
);
	    

Al escribir una llamada a un objeto en el editor GeneXus, este muestra los parametros que el objeto espera recibir, pero, evidentemente, no muestra el formato de nuestros comentarios. Si un objeto tiene muchos parametros, o si la documentación es relevante para hacer la llamada, esta extensión tiene utilidad. Al seleccionar un objeto en el editor de código (poniendo el cursor encima del nombre del objeto a llamar) y pulsando Ctrl+F10, copia al portapapeles la regla parm del objeto comentada. Si se pega (Ctrl+V) encima del código de la llamada, se tiene la información completa de como hacer la llamada:

///**** OBJETO QUE QUIERE LLAMAR A PUCliNomFis ****///
/* parm(
		in:&EmpCod,     // Código de la empresa base
        in:&CliCod,     // Código del cliente
		in:&Flag,       // Tipo de nombre del cliente a obtener. 'F' = Nombre fiscal, 'C': Nombre comercial
        out:&CliNomFis	// El nombre del cliente
); */
PUCliNomFis.Call( |
	    

Copiar un FOR EACH de una tabla al portapapeles... (Atajo de teclado: Ctrl+F11)

Pide al usuario seleccionar una tabla de la kbase y copia al portapapeles el código de un FOR EACH para leer un único registro de dicha tabla. Pulsando Ctrl+V se pega el código en el editor GeneXus. Por ejemplo, si la tabla seleccionada tiene como atributos clave EmpCod y CliCod copia esto:

FOR EACH
	WHERE EmpCod = &EmpCod
	WHERE CliCod = &CliCod


ENDFOR
	    

Copiar un NEW de una tabla al portapapeles... (Atajo de teclado: Ctrl+F12)

Pide al usuario seleccionar una tabla de la kbase y copia al portapapeles el código de un NEW para leer crear un registro en dicha tabla. Pulsando Ctrl+V se pega el código en el editor GeneXus. El NEW no contiene atributos que sean formulas. Por ejemplo:

NEW
	EmpCod = &EmpCod
	CliCod = &CliCod
	CliNomFis = &CliNomFis
	...
ENDNEW