{"id":13098,"date":"2015-10-13T17:07:57","date_gmt":"2015-10-14T00:07:57","guid":{"rendered":"http:\/\/clartechsolutions.com\/?p=13098"},"modified":"2023-03-01T01:43:18","modified_gmt":"2023-03-01T01:43:18","slug":"creando-un-informe-en-apex-5-0-a-partir-de-una-region-de-contenido-dinamico-pl-sql","status":"publish","type":"post","link":"https:\/\/kiusi.com\/en\/creando-un-informe-en-apex-5-0-a-partir-de-una-region-de-contenido-dinamico-pl-sql\/","title":{"rendered":"Creando un Informe en Apex 5.0 a partir de una Regi\u00f3n de contenido din\u00e1mico PL\/SQL"},"content":{"rendered":"

Si bien Oracle Application Express nos ofrece muchos tipos de Informes para ser usados cuando estamos creando nuestras aplicaciones web, pero a veces no se ajusta a lo que necesitamos, por ejemplo puede darse el caso de que tengamos una aplicaci\u00f3n construida con un m\u00f3dulo PL\/SQL y queremos reutilizar ese m\u00f3dulo, entonces para ello necesitamos crear un informe de tipo PL\/SQL din\u00e1mico.<\/p>\n

En mi opini\u00f3n, nunca est\u00e1 de m\u00e1s saber c\u00f3mo podemos crear en Oracle Apex Informes para mostrar datos de una tabla en forma din\u00e1mica, usando c\u00f3digo PL\/SQL, pero, hay que ser conscientes, de que se requiere de mucho detalle y hay que plantearse si es conveniente o no utilizar este tipo de Informes, ya que con los asistentes de Apex podemos crear Informes de forma muy r\u00e1pida y sencilla, sin tanto esfuerzo.<\/p>\n

Vamos a trabajar con la tabla DEMO_CUSTOMERS,  que pertenece a la aplicaci\u00f3n demo \u201cSample Database Application\u201d de Apex cuando se instala.<\/p>\n

Para mostrar los datos de la tabla en un informe creado din\u00e1micamente vamos a hacer uso del paquete APEX_ITEM que nos permite crear elementos din\u00e1micamente basados en una consulta SQL.<\/p>\n

En nuestra consulta SQL vamos a hacer uso de dos tipos de funciones:<\/p>\n

    \n
  1. HIDDEN: Usamos esta funci\u00f3n para generar din\u00e1micamente elementos ocultos.<\/li>\n<\/ol>\n
    APEX_ITEM.HIDDEN(\n    p_idx         IN    NUMBER,\n    p_value       IN    VARCHAR2 DEFAULT\n    p_attributes  IN    VARCHAR2 DEFAULT NULL,\n    p_item_id     IN    VARCHAR2 DEFAULT NULL,\n    p_item_label  IN    VARCHAR2 DEFAULT NULL\n) RETURN VARCHAR2;<\/pre>\n
    2. DISPLAY_AND_SAVE: Usamos esta funci\u00f3n para mostrar un elemento como texto, pero guardamos su valor en el estado de sesi\u00f3n.<\/p>\n
    APEX_ITEM.DISPLAY_AND_SAVE(    \np_idx         IN    NUMBER,    \np_value       IN    VARCHAR2 DEFAULT NULL,    \np_item_id     IN    VARCHAR2 DEFAULT NULL,    \np_item_label  IN    VARCHAR2 DEFAULT NULL)    \nRETURN VARCHAR2;\n\np_idx:<\/strong> Indica el n\u00famero de identificador de la variable htmldb_application_global. El rango de valores es de 1 a 50. Por ejemplo 1 crea F01 y 2 crea F02.<\/pre>\n
    Adem\u00e1s, para que se dibuje la informaci\u00f3n en la regi\u00f3n vamos a hacer uso de dos paquetes: HTP o HTF<\/p>\n
    Paquete htp<\/u>: (Procedimientos de hipertexto) – Son procedimientos que generan etiquetas HTML. Por ejemplo, el procedimiento htp.htmlopen<\/em> genera la etiqueta de apertura <HTML>.<\/p>\n
    Paquete htf<\/u>: Para cada procedimiento htp que genera una etiqueta HTML hay una funci\u00f3n htf con id\u00e9nticos par\u00e1metros. Las funciones no generan directamente la salida en una p\u00e1gina web. En lugar de eso, pasan su salida como valores de retorno a los estados que le han sido invocados.<\/p>\n
    Crear Regi\u00f3n de Contenido Din\u00e1mico PL\/SQL<\/strong><\/h3>\n
    Creamos una aplicaci\u00f3n de escritorio, luego creamos una p\u00e1gina en blanco y en ella creamos una regi\u00f3n de contenido din\u00e1mico PL\/SQL que la llamaremos \u201cClientes\u201d.<\/p>\n
    Lo m\u00e1s importante aqu\u00ed es el c\u00f3digo PL\/SQL en esta regi\u00f3n ya que es la que se encargar\u00e1 de armar el Informe en forma din\u00e1mica.<\/p>\n
    Ingresamos el c\u00f3digo PL\/SQL y hacemos clic en el bot\u00f3n Guardar.<\/p>\n
    declare\ncursor c_cus\nis\nselect apex_item.hidden (1,cus.customer_id) id\n, apex_item.display_and_save (2, cus.cust_first_name) firstname\n, apex_item.display_and_save (3, cus.cust_last_name) lastname\n, apex_item.display_and_save (4, cus.cust_street_address1) address\n, apex_item.display_and_save (5, cus.cust_city) city\n, apex_item.display_and_save (6, cus.cust_state) state\n, apex_item.display_and_save (7, cus.cust_postal_code) postalcode\n, apex_item.display_and_save (8, cus.cust_email) email\n, apex_item.display_and_save (9, phone_number1) phonenumber\n, apex_item.display_and_save (10, credit_limit) creditlimit\nfrom demo_customers cus\n, demo_states sta\nwhere cus.cust_state = sta.st\norder by cus.customer_id;\nbegin\nfor r_cus in c_cus\nloop\nhtp.p(r_cus.id);\nhtp.p(r_cus.firstname);\nhtp.p(r_cus.lastname);\nhtp.p(r_cus.address);\nhtp.p(r_cus.city);\nhtp.p(r_cus.state);\nhtp.p(r_cus.postalcode);\nhtp.p(r_cus.email);\nhtp.p(r_cus.phonenumber);\nhtp.p(r_cus.creditlimit);\nend loop;\nend;<\/pre>\n
    Si ejecutamos la p\u00e1gina podremos ver el reporte sin ning\u00fan formato, adem\u00e1s todos los registros se muestran uno a continuaci\u00f3n del otro.<\/p>\n
    \"\"<\/p>\n
    Crear tabla HTML desde el c\u00f3digo PL\/SQL<\/strong><\/h3>\n
    Para crear la tabla haremos uso del paquete HTP.<\/p>\n
    htp.tableopen     -- genera la etiqueta <TABLE>\nhtp.tablerowopen -- genera la etiqueta <TR>\nhtp.tablerowclose -- genera la etiqueta <\/TR>\nhtp.tableclose    -- genera la etiqueta <\/TABLE>\n\n<\/pre>\n
    Para ello vamos a cambiar la parte del c\u00f3digo que est\u00e1 dentro del bloque begin-end, agregando la tabla y una fila para cada registro, por el hecho que est\u00e1 dentro del loop.<\/p>\n
    declare\ncursor c_cus\nis\nselect apex_item.display_and_save(1, cus.customer_id) id\n, apex_item.display_and_save (2, cus.cust_first_name) firstname\n, apex_item.display_and_save (3, cus.cust_last_name) lastname\n, apex_item.display_and_save (4, cus.cust_street_address1) address\n, apex_item.display_and_save (5, cus.cust_city) city\n, apex_item.display_and_save (6, cus.cust_state) state\n, apex_item.display_and_save (7, cus.cust_postal_code) postalcode\n, apex_item.display_and_save (8, cus.cust_email) email\n, apex_item.display_and_save (9, phone_number1) phonenumber\n, apex_item.display_and_save (10, credit_limit) creditlimit\nfrom demo_customers cus\n, demo_states sta\nwhere cus.cust_state = sta.st\norder by cus.customer_id;\nbegin\nhtp.tableopen; -- genera la etiqueta <TABLE>\nfor r_cus in c_cus\nloop\nhtp.tablerowopen; -- genera la etiqueta <TR>\nhtp.tabledata (r_cus.id); -- genera las etiquetas <TD> y <\/TD>\nhtp.tabledata(r_cus.id);\nhtp.tabledata(r_cus.firstname);\nhtp.tabledata(r_cus.lastname);\nhtp.tabledata(r_cus.address);\nhtp.tabledata(r_cus.city);\nhtp.tabledata(r_cus.state);\nhtp.tabledata(r_cus.postalcode);\nhtp.tabledata(r_cus.email);\nhtp.tabledata(r_cus.phonenumber);\nhtp.tabledata(r_cus.creditlimit);\nhtp.tablerowclose; -- genera la etiqueta <\/TR>\nend loop;\nhtp.tableclose; -- genera la etiqueta <\/TABLE>\nend;<\/pre>\n
    Al ejecutar la p\u00e1gina podemos ver que hemos armado la tabla HTML desde dentro del c\u00f3digo PL\/SQL y cada registro se muestra en una fila diferente.<\/p>\n
    \"\"<\/p>\n
    Asignamos estilos CSS dentro del c\u00f3digo PL\/SQL<\/strong><\/h3>\n
    Para darle una mejor visualizaci\u00f3n a nuestro informe en nuestra aplicaci\u00f3n Apex, vamos a asignar algunos estilos en la tabla, fila y celdas.<\/p>\n
    Sintaxis Procedimiento TABLEOPEN<\/p>\n
    HTP.TABLEOPEN(   \ncborder        IN       VARCHAR2   DEFAULT NULL   \ncalign         IN       VARCHAR2   DEFAULT NULL,   \ncnowrap        IN       VARCHAR2   DEFAULT NULL,   \ncclear         IN       VARCHAR2   DEFAULT NULL   \ncattributes    IN       VARCHAR2   DEFAULT NULL);<\/pre>\n
    Por ejemplo, este procedimiento genera:<\/p>\n
    <TABLE \"cborder\" NOWRAP ALIGN=\"calign\" CLEAR=\"cclear\" cattributes><\/pre>\n
    En nuestro c\u00f3digo PL\/SQL asignamos a la tabla los siguientes atributos:<\/p>\n