Una de las funcionalidades más versátiles que nos ofrece APEX, son las cuadrículas interactivas.
Las cuadrículas interactivas o IG por sus siglas en inglés son un tipo específico de reporte que nos ofrece una serie de características que no ofrecen otro tipo de reportes y quizá la más importante de ellas es que podemos convertirlo en una cuadrícula editable, que nos permite modificar los datos mostrados en ella.
La idea de esta serie que inicia con esta publicación, no es dar una explicación completa y profunda de lo que lo IG pueden hacer y todas sus funcionalidades, sino, más bien, proporcionar algunos trucos o técnicas avanzadas para realizar algunas tareas específicas de personalización de los mismos y que se van a centrar en la barra de herramientas de estos.
Como se puede observar en la imagen anterior, en donde he rotulado una barra de herramientas de una cuadrícula interactiva, dicha barra se divide en siete secciones diferentes, las cuales he rotulado en azul. Estas secciones son:
- search
- reports
- views
- actions1
- actions2
- actions3
- actions4
Estos rótulos no son antojadizos, cada uno de ellos se corresponde con el nombre que tienen asignadas estas secciones y que vamos a utilizar en los tips que en posteriores entradas voy a publicar.
Pero no quiero que solo me crean porque lo estoy diciendo, si desean comprobarlo por ustedes mismos, lo único que tienen que hacer es abrir la consola de su navegador en una página que contenga un IG y pegar el siguiente código y ejecutarlo:
1 |
$.apex.interactiveGrid.copyDefaultToolbar() |
La salida en la consola de su navegador será algo similar a lo que se muestra a continuación.
Como se puede observar en la imagen anterior, la salida de la sentencia nos muestra una estructura compuesta por siete objetos, cuyo nombres se corresponden con las etiquetas con las que se rotuló la imagen más arriba, de la barra de herramientas del IG.
La sección “search” está compuestas por tres elementos diferentes, de izquierda a derecha, un menú desplegable, una caja de texto y un botón.
La sección “reports” está compuesta por un menú desplegable con todos y cada uno de los reportes definidos para la cuadrícula interactiva.
La sección “views” muestras las diferentes vistas que componen un reporte, específicamente puede contener botones según sea el caso para: la cuadrícula y un gráfico.
Las secciones “actions1” a “actions4” pueden contener diferentes botones que más adelante iremos conociendo.
Toda la información contenida en esta entrega es importante de conocer para poder realizar las diferentes tareas que se realizarán en futuras entregas, como por ejemplo:
- Cómo remover una o varias de estas secciones de la barra de herramientas.
- Cómo agregar botones personalizados.
- Cómo cambiar la etiqueta de los botones desplegados
- Cómo agregar nuevas opciones al menú de acciones.
- Cómo agrear un menú personalizado de acciones por línea.