URL di utility
===============


Grafico di un timegraph in formato immagine
-------------------------------------------------

E' possibile utilizzare la seguente URL per scaricare automaticamente l'immagine di un timegraph in formato PNG:

::
	
	https://<base url>/web/objects/timegraph/<id timegraph>/image[?<options>]
	
Dove *<id timegraph>* e' l'UUID del timegraph scelto.

Opzioni
~~~~~~~~~~~~~~~~~~~~~~~~~

La url accetta le seguenti opzioni in GET:

Tipo di grafico
+++++++++++++++++++++++

	+-----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
	| Parametro | Descrizione                                                                                                                                                                         |
	+===========+=====================================================================================================================================================================================+
	| gtype     | Tipo di grafico: *png* renderizza il timegraph usando la librearia reportlab. *rrdtool* utilizza RRDTools per creare l'immagine.                                                    |
	+-----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

.. important:: Se si utilizza la libreria *RRDTOOL* le serie dei timegraph *computed* complesse potrebbero non essere renderizzate a causa di limiti di rendering dei RRDTOOL.

.. attention:: Se si usa il tipo *png*, le serie di tipo "tick" non vengono visualizzate.


Dimensioni
+++++++++++++++++++++++

	+-----------+------------------------------------------------------------------------------------+
	| Parametro | Descrizione                                                                        |
	+===========+====================================================================================+
	| w         | Larghezza massima immagine PNG.                                                    |
	+-----------+------------------------------------------------------------------------------------+
	| h         | Altezza massima immagine PNG.                                                      |
	+-----------+------------------------------------------------------------------------------------+

Intervalli temporali 
+++++++++++++++++++++++

	+-----------+------------------------------------------------------------------------------------------------------------------------+
	| Parametro | Descrizione                                                                                                            |
	+===========+========================================================================================================================+
	| interval  | Numero di secondi nel passato (a partire dall'oraraio della richiesta) con cui calcolare la data di inizio del grafico |
	+-----------+------------------------------------------------------------------------------------------------------------------------+
	| start     | Timestamp orario di inizio.                                                                                            |
	+-----------+------------------------------------------------------------------------------------------------------------------------+
	| end       | Timestamp orario di fine.                                                                                              |
	+-----------+------------------------------------------------------------------------------------------------------------------------+

.. note:: Se viene specifica *interval* i parametri *start* ed *end* vengono ignorati.


Esempi
~~~~~~~~~~~~~~~~~~~~~~~~~

::
	
	https://demo.labs.it/sanet3/web/objects/timegraph/8f7272850286494d90733e2da72f8a6c/image
	
	https://demo.labs.it/sanet3/web/objects/timegraph/8f7272850286494d90733e2da72f8a6c/image?interval=28000&gtype=rrdgraph