Release Notes Versin 7.

ndice
ndice ............................................................................................................................................................. 2 Novedades de la versin ............................................................................................................................... 4 Patrones bsicos K2BTools ........................................................................................................................... 5 Aplicaciones multi-tenant con K2BTools .................................................................................................. 5 Mejoras en generacin de Reportes PDF ................................................................................................. 6 Ms opciones para personalizar los objetos generados ........................................................................... 6 Posibilidad de ocultar grilla de segundo nivel en transacciones .............................................................. 7 Seguridad .................................................................................................................................................. 7 Mejoras en K2BLoadActivityList............................................................................................................ 8 Actividades diferentes de seguridad para reportes PDF y Excel........................................................... 8 Integracin con GAM en XEv2 .............................................................................................................. 8 Chequeo de seguridad en los business components ............................................................................ 9 Mejoras en la bsqueda............................................................................................................................ 9 Mejoras en traduccin de aplicaciones generadas con K2BTools .......................................................... 10 Errores corregidos:.................................................................................................................................. 11 K2B Web Panel Designer............................................................................................................................. 13 Mayor flexibilidad: .................................................................................................................................. 13 Propiedad Custom Render ................................................................................................................. 13 Paginado correcto con automatic refresh en XEv2............................................................................. 13 Personalizacin de cdigo de paginado .............................................................................................. 13 Configuracin completa de seguridad en las acciones ....................................................................... 14 Grillas desde DataProvider ..................................................................................................................... 14 Add Grid From DataProvider............................................................................................................... 14 Invocacin al Data Provider ................................................................................................................ 16 Paginado.............................................................................................................................................. 17 Customizacion ..................................................................................................................................... 17 2

Errores corregidos:.................................................................................................................................. 17 Licenciamiento K2BWebPanelDesigner. ..................................................................................................... 18 Instalacin ................................................................................................................................................... 19 Anexos......................................................................................................................................................... 21 Cambios en el theme usado por K2BTools ............................................................................................. 21

Novedades de la versin
La principal novedad de la versin 7.0 es la inclusin de K2BWebPanelDesigner como parte de la suite K2BTools, al terminar su proceso de beta. La versin incluida de K2BWebPanelDesigner es distinta a la versin RC, ya que incluye correcciones de errores detectados en esa versin, y tambin algunas funcionalidades nuevas. Las mejoras respecto a la versin RC se encuentran en la seccin K2BWebPanelDesigner. Los patrones bsicos de K2BTools tambin han recibido mejoras en esta versin, estas mejoras pueden encontrarse en la seccin Patrones bsicos K2BTools. La inclusin de K2BWebPanelDesigner en K2BTools, finalizando al mismo tiempo su proceso de beta, provoca algunos cambios referentes a cmo es licenciado K2BWebPanelDesigner. Estos cambios estn detallados en la seccin Licenciamiento. Por ltimo, se incluye, en la seccin Instalacin una gua para instalar el producto y evitar posibles problemas en el proceso. Esta versin de K2BTools est disponible solo para clientes que estn con mantenimiento al da. Por tanto debern seguir unos pasos para actualizar su licencia que sern detallados en la seccin de Instalacin

Patrones bsicos K2BTools

Aplicaciones multi-tenant con K2BTools
En esta versin se incorporan funcionalidades orientadas a que sea ms sencillo construir aplicaciones multi tenant. Ahora, se puede establecer un data selector universal dentro de las configuraciones de K2BTools que ser aplicado en todas las grillas generadas con K2BTools.

Para poder usar un data selector universal, este deber recibir un nico parmetro que se corresponda con la variable &Context utilizada en los objetos generados con K2BTools. Una vez establecido, el data selector ser usado en todas las grillas, siempre que no se defina en el nodo correspondiente otro data selector de forma explcita.

Tambin puede indicarse en cualquier nodo con grilla que no se desea usar ningn data selector, en el caso en que no se desee usar un data selector para esa grilla particular.

Para completar esta funcionalidad, fue necesario tambin realizar mejoras en el manejo de Data Selectors dentro de los patterns de K2BTools. En particular, se mejoraron los siguientes aspectos: 5

1. El Data Selector asociado a una grilla es usado tanto en el work with como en los reportes PDF y Excel asociados al nodo donde fue agregado. 2. Es posible ahora agregar argumentos al nodo Data Selector en la instancia de K2BEntityServices y K2BPrompt.

Mejoras en generacin de Reportes PDF

Se hicieron mejoras en esta versin en la generacin de reportes PDF para mejorar la apariencia de estos en algunos casos. La mejora est relacionada a cmo se muestran los atributos y variables en la grilla. Para el caso en que se tienen atributos basados en dominios enumerados, se muestra el resultado de aplicar la funcin EnumerationDescription() al atributo/variable (con lo que se mostrar la descripcin del valor dentro del enumerado, y no el valor en s). Se agreg en k2bentityservices settings una propiedad que permite deshabilitar esta funcionalidad debido a un error que est detallado en el SAC #32972. Esta propiedad la pueden encontrar dentro de standardactions->report y la misma es show Enumerated Domains Descriptions.

En el caso en que se tienen variables con nodos Control Info dinmico donde se indica que se muestren descripciones, y se establecen las propiedades Item Value e Item Description, se agrega cdigo en el reporte generado para recuperar la descripcin correspondiente al valor del atributo/variable.

Ms opciones para personalizar los objetos generados

En esta versin se agregaron opciones para aumentar las posibilidades que posee un usuario de K2BTools para modificar la apariencia de las instancias generadas. Se agreg la posibilidad de modificar la posicin donde se muestra el botn search en los objetos work with y sub work with. Esta propiedad se encuentra en las configuraciones de K2BTools, bajo la categora filters con nombre SearchButtonLayout.

Sus valores posibles son Right o Bottom e indican la posicin del botn con respecto a los filtros.

Adems, en las configuraciones generales de K2BTools, en la categora filtros y transaccin, se agreg la propiedad Descriptions Layout. Los valores posibles para este campo son Left (es el valor por defecto, con esto se generan los objetos de la misma forma que hasta la versin 6.0) o Top para ubicar las descripciones por encima del campo.

Description Layout: Top

Description Layout: Left

Relacionada con la propiedad anterior, se agreg una propiedad de nombre Description Layout en cada nodo que contiene atributos planos (no en grilla) por ejemplo los filtros. Sus valores posibles son Default, Left, Top. El valor Default indica a patterns que debe seguir lo establecido en las configuraciones generales de K2BTools, mientras que los valores Top y Left indican que en ese nodo particular debe usarse esa lgica, sin importar lo establecido en el settings. Importante: 1. Los cambios realizados sobre las configuraciones generales de K2BTools son utilizados en las aplicaciones del pattern posteriores a la modificacin. Por lo tanto, si se modifica alguna de las propiedades mencionadas, y no se vuelven a aplicar los patrones, estos cambios no sern visibles. En casos de KBs grandes con muchas instancias de patterns, para aplicar todas las instancias se puede modificar el settings del pattern K2B Entity Services, y correr la aplicacin con F5 (si la versin tiene Dynamic pattern update en Yes, antes de generar la aplicacin se actualizarn todas las instancias de patterns). 2. En caso de querer hacer uso de esta funcionalidad, y estar trabajando en una KB creada usando una versin anterior de K2BTools, lea el anexo Cambios en el theme usado por K2BTools para obtener instrucciones sobre cmo actualizar el theme de la KB para lograr la misma apariencia que en las imgenes mostradas arriba

Posibilidad de ocultar grilla de segundo nivel en transacciones

En esta versin la grilla y la seccin superior que permite ocultarla o mostrarla, se agrupan en un div con control name. De esta forma en GeneXus X Evolution 2 es posible ocultarlo con una nica lnea de cdigo.

Seguridad
Esta versin incorpora varias mejoras en el manejo de la seguridad tanto para Genexus X Evolution 1 como para la Evolution 2.

Mejoras en K2BLoadActivityList En la versin anterior, existan casos en los que el texto del programa era muy largo y generaba problemas. En esta versin se intent mitigar este problema mediante el agregado de dos propiedades. Estas son: Ignore Standard Activity Type: Si su valor es True, no se agrega el cdigo correspondiente a las actividades estndar en la generacin de este procedimiento. Ignore Pgm Name: Si su valor es True, se ignoran los nombres de programa. Ambas propiedades se encuentran en el nodo Templates de la configuracin del patrn K2B Entity Services. Usando estas propiedades puede disminuirse significativamente el tamao del programa generado. Si se elige realizar esta modificacin, es necesario asociar a todas las entidades las actividades estndar en los objetos que invoquen a este procedimiento.

Actividades diferentes de seguridad para reportes PDF y Excel En esta versin pueden definirse actividades diferentes para el PDF y Excel. Para esto en el nodo Templates del K2BEntityServices Settings se agregaron dos propiedades Export User Activity Type y PDF User Activity Type. Si tienen algn valor, este es utilizado como User Activity Type en la generacin de PDFs y Excels Integracin con GAM en XEv2 Para mantener el mismo esquema de seguridad de K2BTools y adems poder usar el GAM (GeneXus Access Management), en los objetos generados por K2BTools se setear la propiedad permisin prefix del objeto generado. Su valor ser el nombre de la transaccin asociada al objeto. Esto har que no sea necesario usar k2bloadactivitylist, dado que los permisos sern dados de alta automticamente por el GAM. Ms informacin sobre el GAM puede ser encontrada aqu: http://wiki.gxtechnical.com/commwiki/servlet/hwiki?Category%3ABuilt-in+Security+Module++GeneXus+Access+Manager+%28GAM%29, En caso de no querer esta funcionalidad pueden deshabilitarla en el K2BTools Settings bajo el nombre SetPermissionPrefixInAllObjects.

Chequeo de seguridad en los business components Se agregaron dos propiedades en el nodo Transaction de la configuracin del patrn Entity Services: Check security in BC y Not Authorized In BC Error Message (dentro de la categora General), que indican si debe chequearse seguridad en las transacciones cuando son usadas como BC, y cul es el mensaje de error a emitir cuando el usuario no est autorizado. Adems, se modific el cdigo generado en el evento Start de las transacciones, pasando la llamada al proc K2BIsAuthorizedActivityList al interior de un tag web. Esto elimina algunos errores asociados al uso de transacciones como BC en contextos donde no est disponible la sesin web.

Mejoras en la bsqueda
Se agreg la posibilidad de que al generar la instancia por defecto del pattern K2BEntityServices; se pueda elegir si las conditions las genera por like o por like + % o cualquier otra condicin. Para esto se cuenta con la propiedad StringSearch Cuando se genera la condition para un string, lo que hace k2btools es sustituir donde dice <attName> por el nombre del atributo y &<varname> por el nombre de la variable. Para que las instancias que ya estn generadas puedan actualizar estos cambios se cuenta con la herramienta avanzada Update All Conditions.

Para esto hay que indicarle a la herramienta cul es el formato anterior que tenan las conditions y el la reemplazar con el que est especificado en el general settings.

Mejoras en traduccin de aplicaciones generadas con K2BTools

En esta versin, todos los textos incluidos en objetos generados por patterns pueden modificarse a travs de las configuraciones de Patterns. Para aquellos que vienen ya trabajando con K2BTools, pueden seguir utilizando el mecanismo actual, en tal caso pueden en EntityServices settings -> Labels->Use Deprecated Transaction Scheme en true y seguir trabajando como lo estaban haciendo antes. 10

En caso de tenerla en false, los literales podrn ser modificados en el nodo labels.

Errores corregidos:
En la versin 6.0U1 de K2BTools, si se tiene una transaccin que indica que no debe chequear seguridad, y esta transaccin es referenciada en un Sub Work With se genera cdigo de seguridad a la hora de mostrar el tab en el EntityManager asociado. En esta versin este problema fue corregido (Se agrega el cdigo de seguridad slo si la transaccin asociada al Sub Work With indica que se debe chequear seguridad). Se solucion un problema presente en versiones anteriores de K2BTools, donde no funciona establecer el valor de las propiedades After Insert y After Update en None. Se solucion problema en K2BTrnForm, que causaba errores cuando se indicaba que un atributo de la transaccin fuera no visible en la instancia del pattern. Fixed Data en K2BEntityServices con visible en false en la primera variable, la misma no apareca en el Web Form y adems se generaba en el evento start cdigo para hacerla invisible (esto generaba un warning durante el build). La parte Web Form de la transaccin deja de quedar en rojo al aplicar el pattern K2BEntityServices o K2BTrnForm. Nota: esto elimina el provider de la transaccin. Si se remueve el pattern K2BEntityServices volver a recuperar su provider. En caso de error al remover la instancia de patterns hay una herramienta que vuelve a agregar el provider a la transaccin. Esta herramienta se encuentra en K2BTools-> Advanced-> Recover Transaction GeneXus Default. Si se aplicaba patterns a una transaccin que tena una paralela; agregaba un tab asociado a esa transaccin y colocaba cdigo para crear la transaccin en un web component. Si esta transaccin no tena el type en component daba error de spec. En esta versin hasta que no sea 11

web component no se agregar el tab y se dar un warning al aplicar el patrn advirtiendo de la situacin. Se corrige problema que provocaba que cuando se cerraba la KB quedaba la licencia de K2BTools tomada. Se mejor la subrutina SaveGridState generada en Work Withs y Sub Work Withs para manejar correctamente fechas anteriores al ao especificado en la propiedad First year of 20th century del generador. Si un atributo clave de la transaccin comenzaba con Mode se produca un error al generar el componente general ya que el pattern remplazaba el string Mode por K2BTrnMode. En los filtros con combo dinmico se colocaba de valor por defecto para el texto de empty item GX_EmptyItemText. Al ser un filtro este no era el valor correcto. Por tanto en esta versin el valor por defecto pasa a ser GX_AllItems.

12

K2B Web Panel Designer

Mayor flexibilidad:
Propiedad Custom Render En esta versin se podr configurar la propiedad custom render en el WebPanelDesigner. A nivel de grilla se habilita esa propiedad.

Paginado correcto con automatic refresh en XEv2 En la XEv2 es posible usar automatic refresh tanto en grillas con tabla base como sin tabla base. Cuando se cambia un filtro automticamente se va a la pgina uno. Personalizacin de cdigo de paginado Ahora ser posible para que en los eventos de paginado se invoquen a subrutinas que comiencen con U_. Este comportamiento hay que habilitarlo por grilla.

Una vez seteado en true se invocar una subrutina de usuario en cada evento de paginado.

13

Configuracin completa de seguridad en las acciones

Es posible configurar de forma completa la seguridad dentro de las acciones del WebPanelDesigner.

Grillas desde DataProvider

En las aplicaciones cada vez es ms necesario encapsular la navegacin sobre los datos, independizarlos de la fuente desde la que son obtenidos y lograr una buena performance en su carga. Esto se puede hacer en GeneXus mediante el objeto Data Provider.

Add Grid From DataProvider De una manera sencilla, es posible utilizar un Data Provider para cargar las grillas. Para ello, K2BWebPanelDesigner incorpora un nuevo tipo de grilla basada en Data Provider. Se agregan las

14

acciones Add FreeStyle Grid / Add Grid from Data Provider para permitir seleccionar el Data Provider con el que se desea cargar la grilla y automticamente se crear la grilla basada en ste.

Esta grilla contendr los campos especificados en el SDT de salida. Por ejemplo si el SDT de salida es el siguiente:

La grilla cargada desde ese Data Provider tendr las siguientes variables

15

Se leer la regla parm del Data Provider. Si en la parm la primera variable tiene como nombre OrderedBy o OrderBy se agregar un nodo order en la instancia.

Por cada variable de la parm, que no se llame PageNumber ni PageSize y que est basada en un dominio u atributo se crear un filtro.

Invocacin al Data Provider A la hora de invocar al Data Provider, se pasar como parmetro en caso de tener el orden seleccionado en la grilla. Para los filtros intentar mapear cada uno de ellos con los que recibe el Data Provider. En caso de que el nombre del filtro, sea igual al nombre del parmetro o al nombre del parmetro + _filter el mapeo se har automtico. En caso contrario, el usuario deber mapear los filtros manualmente. Para esto: Por cada parmetro filtro del Data Provider se definir una variable de nombre &DP_Filter_
+ <paramterName> + _<GridName>

Se invoca a una subrutina de usuario de nombre U_PrepareDataProvider(<GridName>) para que el usuario pueda hace el mapeo manualmente.

16

Paginado El Data Provider puede ser sin paginado o con paginado. Si es sin paginado, la paginacin de los datos se hace en el web panel, de la misma forma que est implementado para grillas sin tabla base ni for each inferido. Si el Data Provider posee paginado propio, se utiliza haciendo ms eficiente la carga. Para detectar que un Data Provider posee paginado los ltimos dos parmetros del Data Provider tienen que tener como nombre &PageNumber y &PageSize respectivamente. Customizacion En las grillas con Data Provider se podr modificar el Data Provider. Esto es posible hacerlo en el nodo grid mediante la propiedad Data Provider

Cuando la grilla tiene un Data Provider seteado, aparecer a nivel de variable una propiedad de nombre LoadFromDataProvider.

Si est en true se intentar cargar esa variable desde el Data Provider, en caso de que este en false no se cargar y el desarrollador podr asignarle un valor en las subrutinas de usuario.

Errores corregidos:
Importacin: o No se poda importar el relase de un web panel hacia otra KB. Al importarse si el objeto en la KB destino tena ese mismo web panel con el diseador aplicado segua con el diseador aplicado. No era posible importar un web panel que en la parte K2BDesigner tuviera solamente el nodo raz.

Se corrige el uso de scroll en la Evolution2. Subrutina U_Search no permita ser editada por el usuario.

17

Licenciamiento K2BWebPanelDesigner.
Para usar tanto K2BTools como K2BWebPanelDesigner sin restricciones, es necesario tener licencias de K2BTools 7.0 instaladas. En caso contrario es posible solicitar una licencia de K2BTools Free Edition que permite: Nota: La versin Free Edition no permite desasociar K2BWebPanelDesigner de un Web Panel desarrollado con este (No se permite hacer Release del objeto). En caso de querer realizar esta accin, habr que eliminar el objeto o abrir la KB sin K2BWebPanelDesigner instalado y exportar el objeto a otra KB. Mantener hasta 20 web panels con K2BWebPanelDesigner. Mantener 20 instancias de cada uno de los patrones de K2BTools.

18

Instalacin
Importante: Si usted viene utilizando versiones anteriores de K2BTools con licencia full, deber actualizar las mismas a la versin 7.0. Para hacer esto deber tener el mantenimiento al da. Una vez instalada la versin, no podr usarla de forma inmediata, tendr que actualizar las licencias. Las licencias Free Edition no requieren actualizacin.

1. Si ya tena la versin anterior de k2btools recomendamos siempre respaldar la KB usada antes de pasar de versin (crear un xpz o hacer un branch en la KB) 2. Ejecutar el setup de la instalacin. 3. Poner como ruta el directorio de instalacin de GeneXus. 4. Actualizar licencias de K2BTools segn lo indicado en el siguiente documento(http://www.k2btools.com/files/como-actualizar-las-licencias?es) 5. Abrir GeneXus. 6. Si crea una KB desde cero, ya est listo para usar la versin. 7. En caso de estar usando una versin anterior seguir los siguientes pasos: a. Si usted ya tena traducidos todos los literales de K2BTools y no desea pasarlos al nuevo esquema en Entity Services Settings nodo Labels, pueden setear la propiedad UseDeprecatedTranslationScheme en true.

b. A partir de esta versin el WebPanelBuilder (pattern K2BWebForm) no ser instalado por defecto, ya que ser sustituido por K2BWebPanelDesigner. Al abrir la KB si usted tiene objetos realizados con el WebPanelBuilder se desplegar el siguiente mensaje

En caso de tener objetos realizados con este patrn, es posible instalarlo. Para hacerlo en el directorio K2BTools\Deprecated hay una carpeta de nombre K2BWebForm. La misma hay que descomprimirla dentro del directorio Packages\Patterns de GeneXus. Hay que cerrar GeneXus y volver a abrirlo para que tome este cambio. 19

Para instalar K2BTools en GeneXusServer ejecutar el setup y poner como ruta GeneXusServer\VDir\BinGenexus, tomando como referencia el directorio donde est instalado GeneXusServer.

20

Anexos
Cambios en el theme usado por K2BTools
En las descripciones que deban crearse con Layout Top (sin importar si esto fue especificado en la instancia o en las configuraciones), cuando el pattern escribe el html, a las clases del tema por defecto les concatena el texto _Block. Por esto hay que tener las siguientes clases definidas en el tema:
TextBlock_BoxTitle_Block TextBlock_AttDesc_Block TextBlock_TrnAttDesc_Block TextBlock_FixedDataBottonDesc_Block TextBlock_FilterDesc_Block

Todas estas clases deben ser hijas de las clases con el mismo nombre salvo el sufijo _Block y deben tener seteadas las propiedades: display:block; font-weigth : bold En caso de que este no sea el aspecto visual busacdo, puede ser modificado. El theme por defecto de K2BTools ya posee estas clases configuradas.

21