Skip to content

4 - Desenvolupament d'aplicacions amb informes

Desenvolupament d'aplicacions amb informes

Quan tenim els nostres informes dissenyats, hem d'integrar-los amb les nostres aplicacions. Com hem vist, la llibreria DataPane genera els informes en format HTML, cosa que facilitarà la tasca dintegració, a més de permetre el desplegament dels informes en un servidor remot.

Integració d'informes a una aplicació Qt

Per integrar un informe fet amb la llibreria DataPane en una aplicació Qt tenim dues alternatives:

  1. Obrir l'informe al navegador predeterminat del sistema
  2. Utilitzar el component QWebEngineView per incrustar l'informe a la finestra de l'aplicació

Obrir l'informe al navegador predeterminat

Podem fer que un informe s'obri al navegador predeterminat del sistema com a resposta a una acció de l'usuari (per exemple, la pulsació d'un botó o una opció d'un menú). Per fer-ho, s'utilitza la classe QDesktopServices inclosa al mòdul QtGui. Aquesta classe disposa del mètode estàtic openUrl, que obrirà al navegador predeterminat la URL rebuda com a paràmetre (utilitzant el tipus QUrl).

El codi següent permet obrir un dels informes desenvolupats a l'apartat anterior al navegador predeterminat.

Python
1
2
3
ruta_base = os.path.dirname(__file__)
ruta_absoluta = os.path.join(ruta_base, "informe1.html")
QDesktopServices.openUrl(QUrl.fromLocalFile(ruta_absoluta))

A la primera línia es construeix la ruta absoluta del fitxer a partir de la seva ruta relativa. A continuació, s'utilitza el mètode openUrl de QDesktopServices per obrir l'informe, passant-li com a paràmetre un objecte QUrl construït a partir de la ruta absoluta.

Utilitzar el componentQWebEngineView

Si en lloc d'obrir l'informe al navegador predeterminat volem incrustar-lo a la finestra de la nostra aplicació, haurem d'utilitzar el component de QtQWebEngineView. Aquest component s'utilitza per mostrar qualsevol contingut web, tant local com remot, i es basa en el motor de navegació Chromium.

El codi que s'inclou a continuació mostra com utilitzar aquest component, partint de la ruta absoluta obtinguda al codi anterior.

Python
1
2
view = QWebEngineView()
view.load(QUrl.fromLocalFile(ruta_absoluta))
El primer que fem és crear el component. A continuació, s'invoca el mètode load(), que iniciarà la càrrega del document especificat en forma d'objecte QUrl (de la mateixa manera que a l'exemple anterior). És important destacar que la càrrega es realitzarà de forma asíncrona, oferint el component senyals i ranures per controlar el procés de càrrega. Als enllaços de la unitat hi ha la referència a la documentació d'aquest component.

Exemple

Als recursos de la unitat hi ha el fitxer de codi Python, una aplicació Qt que combina les dues maneres d'integrar un informe. A la part superior de la finestra s'inclou un botó que en ser premut obri l'informe al navegador predeterminat. La resta de la finestra l'ocupa un QWebEngineView que mostra el mateix informe directament a l'aplicació.

App amb informes

Aplicació amb informes integrats
Origens creuats

Recursos d'orige creuat (Cross-origin resources!)

Els llocs web defineixen l’origen de seguretat per accedir de manera segura als recursos dels altres per a l’scripting del client o les bases de dades. Un origen consisteix en un nom d’amfitrió, un esquema i un número de port. Per exemple, els llocs http://www.example.com/my/page.html i http://www.example.com/my/overview.html tenen permís per compartir la mateixa base de dades o accedir als documents dels altres quan s’utilitzen en conjunts de marcs HTML i JavaScript. Al mateix temps, http://www.malicious.com/evil.html es veu impedida d’accedir als recursos de http://www.example.com/, perquè són d’un origen de seguretat diferent. Per defecte, els esquemes locals com file:// i qrc:// es consideren del mateix origen de seguretat i poden accedir als recursos dels altres. Els recursos locals estan per defecte restringits per accedir al contingut remot, la qual cosa significa que file:// no podrà accedir a http://domain.com/foo.html.

Açò es tradueix en que les nostres pàgines web locals no es carregaran al WebView a no ser que habilitem els origens remots a les nostres pàgines locals. Ho farem de la següent forma:

Python
1
2
3
4
5
6
from PySide6.QtWebEngineCore import QWebEngineSettings

...
view = QWebEngineView()
view.settings().setAttribute(QWebEngineSettings.LocalContentCanAccessRemoteUrls, True)
view.load(QUrl.fromLocalFile(html_path))

Desplegament d'informes a un servidor

Com ja hem comentat, el fet que els informes dissenyats ambDataPane siguin fitxers HTML permet el seu desplegament en un servidor web. Aquesta opció facilita que un mateix informe puga ser consultat de diferents maneres (des de diferents aplicacions o des d'una intranet, per exemple).

Informes a la web

L'opció de desplegar els informes en un servidor web té sentit quan els informes no s'han de generar en el moment de la consulta, sinó que es poden generar de forma programada amb antelació (per exemple, informes mensuals que s'elaboren una vegada al mes).

Els dos mecanismes comentats anteriorment per integrar un informe a una aplicació Qt són perfectament vàlids per a informes desplegats en un servidor. Simplement haurem de canviar la URL subministrada, que en aquest cas referenciarà al servidor on estan allotjats els informes.

Núvol

Els proveïdors de serveis al núvol ofereixen la possibilitat de desplegar de forma senzilla contingut web estàtic, com és el cas dels informes generats amb DataPane. AAzure trobem el servei Static Web Apps, mentre que a AWS podem fer-ho amb el servei Amplify. També ho podem publicar a github.

Finalment, comentar que els desenvolupadors de la llibreriaDataPane ofereixen un servei d'emmagatzematge d'informes a internet (datapane.com), que permet pujar els informes directament des del codi Python que els genera. Per això s'utilitza el mètode upload() del component Report. Consulteu la documentació si voleu servir aquest mètode.