Release Notes Versión 6.0

Release Notes Versión 6.0

Indice Cambios importantes:... 3 Cambio de forma de autorización de licencias:... 3 Nuevas funcionalidades:... 3 Tabs en K2BEntityServices, K2BPrompt y K2BTrnForm:... 3 Generación de menú básico:... 5 K2BTools Fast Start:... 6 Reportes PDF en PopUp Windows... 8 Posibilidad de encriptar parámetros de la url del entity manager:... 10 Encriptación de prompts:... 11 Otras funcionalidades... 11 Use 90 Transaction Prefix Compatibility:... 11 Slot GridRowSettings pasa a ser fixed:... 12 Propiedad para determinar si ven a generar autolinks dentro de la transacción:... 13 Errores corregidos:... 14 Instalación.... 14 2

Cambios importantes: Cambio de forma de autorización de licencias: A partir de esta versión se elimina el producto K2BTools Trial. Para utilizar versión de prueba se trabajará en el marco de K2BTools Free Edition. Esta versión, permitirá utilizar hasta 20 instancias de cada pattern. Nuevas funcionalidades: Tabs en K2BEntityServices, K2BPrompt y K2BTrnForm: Además de los grupos, líneas separadoras y columnas se encuentra con un nuevo elemento para agrupar o separar la información. Los tabs. Para utilizar los tabs hay que agregar un nodo tabs. Luego agregar un nodo tab por cada tab que se desee tener. Para cada tab se puede configurar la descripción del tab. 3

Esta es la visualización que tienen los tabs en ejecución. Adentro del tab se pueden incluir, atributos, variables, grupos, líneas separadoras, columnas y otros tabs. 4

Nota: Para poder utilizar los tabs correctamente, seguir pasos de actualización de versión, descritos en la última sección del documento. Generación de menú básico: A partir de esta versión se genera un menú básico, donde se incluirán automáticamente todos los workwiths. En ejecución se visualizarán solo los trabajar con a los que el usuario tiene permisos. Es posible configurar para cada workwith, si este objeto se desea incluir en el menú o no, a través de la propiedad IncludeInMenu. 5

Esta propiedad toma el valor true o false. En caso de estar en default el valor es obtenido a partir del settings. En templates/include WorkWithinMenu El componente de menú que viene por defecto es un componente básico, en caso de querer utilizar otro control, se puede invocar al procedimiento K2BListPrograms, que retorna la lista de workwiths de la aplicación a los que el usuario tiene permisos (los chequeos de seguridad se generan automáticamente en K2BListPrograms). K2BTools Fast Start: K2BTools Fast Start está diseñado con el objetivo que el usuario obtenga un inicio rápido de la aplicación; en este caso tendrá una implementación básica de los objetos de seguridad. En el menú K2BTools aparecerá una nueva opción K2BTools Fast Start. Dentro de este nivel se podría escoger las opciones Create Security, Remove Security. 6

Seleccionando Create Security, se consolidaran objetos que implementan el manejo de usuarios y seguridad de la aplicación. Esta implementación es básica y puede ser extendida por el desarrollador. El objetivo es dar un ejemplo funcionando de la forma en la que se puede manejar la seguridad utilizando k2btools. Utilizando Remove Security se remueven los objetos de seguridad consolidados anteriormente. A partir de la incorporación de K2BTools Fast Start se cuenta con una pantalla de login, con un usuario ya creado con permisos para configurar la seguridad de la aplicación. 7

También cuenta con pantallas y lógica para mantenimiento de información del usuario. Por más información consultar el manual de K2BTools Fast Start. Reportes PDF en PopUp Windows Posibilidad de especificar que los reportes PDF se abran en un popup Windows en lugar de en otro tab. 8

Utilizando esta implementación de reportes se solucionan los siguientes inconvenientes: Si se usa automatic refresh el valor de los filtros es el texto que el usuario ingresó, en lugar del último texto seteado la última vez que se refrescó la página. Funcionamiento de Event Keys para el reporte. Es posible setearle una tecla de función que posibilite levantar el reporte. Para la habilitación de esta funcionalidad, se debe ir al settings del pattern k2bentityservices. Nodo StandardActions/Report Ahí se encuentra la propiedad Generate in Pop Up. Se debe setear el valor de la propiedad en true. Es posible también configurar el ancho y largo de la ventana de Pop Up. 9

Posibilidad de encriptar parámetros de la url del entity manager: En versiones anteriores de k2btools, si se colocaba la propiedad encrypt url parameters en true, K2BTools forzaba en No la propiedad EncryptUrlParameters del objeto entity manager. Este comportamiento podía ser modificado utilizando la propiedad del settings del pattern k2bentityservices template\ Allow Entity Manager Url Encryption. Las razones de esto era que k2btools en la transacción genera links dinámicos para determinar su navegación posterior. Estos links dinámicos, GeneXus por defecto no los encripta. A partir de GeneXus XEv1 U6, GeneXus habilitó parámetros en la función link para especificar directamente que el link dinámico se realice encriptado. Para esto, es posible especificarle al patrón que a la hora de generar los links dinámicos, le pase el parámetro adicional para especificar que el link se debe hacer encriptado. A los efectos de configurar la encriptación se cuenta con la propiedad dynamic link encryption, en el nodo transaction del settings. Los valores son No, Session Key y Site Key. Se debe especificar el mismo valor que se debe colocar en las propiedades seteadas en el modelo. 10

Con esta propiedad uno puede encriptar su aplicación sin perder funcionalidad. Es posible configurar esta propiedad a nivel de instancia en el nodo transaction. Tener en cuenta de usar esta funcionalidad en GeneXus Ev1 U6 y versiones posteriores. Encriptación de prompts: A partir de GeneXus XEv1 U6 los prompts pueden ser encriptados. Por defecto las k2btools ponían en No la propiedad encrypt url parameters del prompt porque no se podían encriptar. A partir de GeneXus XEv1 U6 esto sí es posible. En el settings del pattern k2bprompt para aquellos que usan versiones anteriores al U6 de GeneXus es posible deshabilitar la encriptación de los prompts, utilizando esta propiedad disable prompt encryption. Otras funcionalidades Use 90 Transaction Prefix Compatibility: 11

Para conversiones de instancias procedentes de K2Btools para GeneXus 9.0 es que se tiene esta propiedad. Está ubicada en el nodo Objects, ya que se utiliza para determinar el nombramiento de los objetos. Las transacciones al convertirse a la versión XEv1, contienen el prefijo T en su nombre. De esta forma, cuando se generan los objetos al aplicar el patrón los nombres van a contener la letra T. Ejemplo: Transacción=TPais, objeto generado = WWTPais. Para evitar esto, si esta propiedad está en true, el patrón elimina la letra T de sus objetos generados. Para identificar estas transacciones se buscan las transacciones que comienzan con T y son seguidas de una mayúscula. Esto es útil para la conversión de instancias pues objetos generados pasan a tener el mismo nombre en las diferentes versiones. En caso de no querer esta funcionalidad setear la propiedad en No. Slot GridRowSettings pasa a ser fixed: Tanto el K2BTrnForm, como el K2BEntitySErvices (cuando no se tiene el K2BTrnForm aplicado) para las transacciones de más de un nivel generan un slot de nombre GridRowSettings. 12

En caso de querer personalizar este slot, es posible deshabilitarlo a nivel de transacción, para poder realizar las configuraciones pertinentes. También es posible deshabilitar este slot para todas las transacciones en las propiedades generales de las k2btools. Propiedad para determinar si se van a generar autolinks dentro de la transacción: Es posible configurar, si se van a generar o no los autolinks dentro de las transacciones. Para configurar esto, en las propiedades generales de las K2BTools, se cuenta con la propiedad Generate Autolinks In Transactions. En caso de estar en false, no se van a generar más autolinks en las transacciones. 13

Errores corregidos: Generación de instancias por defecto para subworkwith, genera mal los órdenes. No está generando en el default del orden la clave del primer nivel. Add From Default del pattern K2BTrnFrom: cuando se tienen varios niveles paralelos en la transacción, y se está parado en un nodo level del pattern k2btrnform, add default attributes muestra cualquier atributo cuando debería mostrar solo los de ese nivel. Transacciones invocadas con ReturnMode = PopUp se queda en la transacción sin cerrar el popup. Instalación. Siga los siguientes pasos para instalar K2B Tools. 1. Si ya tenía la versión anterior de k2btools recomendamos siempre respaldar la KB usada antes de pasar de versión (crear un xpz o hacer un branch en la KB) 2. Ejecutar el setup de la instalación. 3. Poner como ruta el directorio de instalación de GeneXus. 4. Abrir GeneXus. 5. Si crea una KB desde cero, ya está listo para usar la versión. 6. Dada una KB si ya tiene una versión de K2B Tools anterior aplicada deberá seguir el siguiente proceso a. Si se llegó a modificar en las transacciones de dos niveles, el slot GridRowSettings, colocar la propiedad K2BTools->General->GenerateGridRowSettingsSlot en false. Por más información aquí. b. Si se está usando una versión anterior a GeneXus Upgrade 6, y se están usando urls encriptadas, configurar en Patterns->Prompt->DisablePromptEncryption en true. Por más información aquí. 14

c. Si se quieren utilizar tabs agregar en las master pages que se estén usando y en el promptlayout utilizado (PromptLayout3) la siguiente línea al comienzo del evento start. Form.JScriptSrc.Add("jquery.min.js") d. En caso de querer incluir el K2BMenu en la master page seguir los siguientes pasos (luego de aplicar una instancia) i. Incluir en la master page utilizada en el evento refresh el siguiente código WCLeftSide.Object = K2BMenu.Create() ii. En la celda que tiene el componente WCLeftSide, setear vertical align en Top. iii. En la celda que contiene el ContentPlaceHolder colocar vertical align en Top. e. En esta versión queda en deprecated el pattern K2BMultipleSelection, en caso de tener instancias o obtener el warning que aparece en la siguiente imagen: Realice la siguiente acción: En el menú K2Btools, seleccionar Open K2BTools Folder. Ir al directorio deprecated. Descomprimir el archivo K2BMultipleSelection.rar en el directorio Packages\Patterns (dentro del directorio de instalación de GeneXus). 15

16