Funciones de extensión para gráficos
Las funciones para gráficos que aparecen a continuación sirven para crear, generar y guardar gráficos como imágenes. Esta funciones son compatibles con la versión actual de su producto de Altova. No obstante, tenga en cuenta que en futuras versiones del producto algunas funciones pueden dejar de ser compatibles o su comportamiento puede cambiar. Por tanto, consulte siempre la documentación del producto para conocer el funcionamiento de estas funciones en cada versión del producto.
| Nota: | Las funciones para gráficos solamente son compatibles con los productos servidor de Altova y con las ediciones Enterprise Edition de los productos de Altova. |
| Nota: | En los productos servidor de Altova los formatos de imagen compatibles para gráficos son jpg, png y bmp. La opción más recomendable es png porque no pierde información y es un formato comprimido. En las ediciones Enterprise Edition de las herramientas de escritorio de Altova, los formatos compatibles son jpg, png, bmp y gif. |
Funciones para generar y guardar gráficos
Estas funciones toman el objeto del gráfico (obtenido con las funciones de creación de gráficos) y generan una imagen o guardan una imagen en un archivo.
altova:generate-chart-image ($chart, $width, $height, $encoding) as atomic
donde
•$chart es el componente de extensión de gráficos obtenido con la función create-chart
•$width y $height deben especificarse con una unidad de longitud
•$encoding puede ser x-binarytobase64 o x-binarytobase16
La función devuelve la imagen del gráfico en la codificación elegida.
altova:generate-chart-image ($chart, $width, $height, $encoding, $imagetype) as atomic
donde
•$chart es el componente de extensión de gráficos obtenido con la función create-chart
•$width y $height deben especificarse con una unidad de longitud
•$encoding puede ser x-binarytobase64 o x-binarytobase16
•$imagetype puede ser uno de estos formatos de imagen: png, gif, bmp, jpg, jpeg. Recuerde que el formato gif no es compatible con los productos servidor de Altova (ver nota al principio de este apartado)
La función devuelve la imagen del gráfico en la codificación y formato de imagen elegidos.
altova:save-chart-image ($chart, $filename, $width, $height) as empty() (sólo en Windows)
donde
•$chart es el componente de extensión de gráficos obtenido con la función create-chart
•$filename es la ruta de acceso del archivo y el nombre de archivo donde se debe guardar la imagen del gráfico
•$width y $height deben especificarse con una unidad de longitud
La función guarda la imagen del gráfico en el archivo especificado en $filename. También puede usar la función xsl:result-document con encoding="x-base64tobinary", donde el contenido de imagen-datos se obtiene con las funciones generate-chart-image() o chart().
altova:save-chart-image ($chart, $filename, $width, $height, $imagetype) as empty() (sólo en Windows)
donde
•$chart es el componente de extensión de gráficos obtenido con la función create-chart
•$filename es la ruta de acceso del archivo y el nombre de archivo donde se debe guardar la imagen del gráfico
•$width y $height deben especificarse con una unidad de longitud
•$imagetype puede ser uno de estos formatos de imagen: png, gif, bmp, jpg, jpeg. Recuerde que el formato gif no es compatible con los productos servidor de Altova (ver nota al principio de este apartado)
La función guarda la imagen del gráfico en el archivo especificado en $filename en el formato de imagen elegido. También puede usar la función xsl:result-document con encoding="x-base64tobinary", donde el contenido de imagen-datos se obtiene con las funciones generate-chart-image() o chart().
Funciones para crear gráficos
Puede usar estas funciones para crear gráficos.
altova:create-chart($chart-config, $chart-data-series*) como componente de extensión de gráficos
donde
•$chart-config es el componente de extensión chart-config obtenido con la función create-chart-config o con la función create-chart-config-from-xml
•$chart-data-series es el componente de extensión chart-data-series obtenido con la función create-chart-data-series o con la función create-chart-data-series-from-rows
La función devuelve un componente de extensión de gráficos, que se crea a partir de los datos suministrados con los argumentos.
altova:chart($chart-config, $chart-data-series*) como componente de extensión de gráficos
donde
•$chart-config es el componente de extensión de gráficos. Se trata de una serie no ordenada de cuatro pares clave:valor en las que las claves son: "width", "height", "title", and "kind". Los valores de width y height son números enteros. El valor de kind es uno de estos: Pie, Pie3d, BarChart, BarChart3d, BarChart3dGrouped, LineChart, ValueLineChart, RoundGauge, BarGauge.
•Cada $chart-data-series es una matriz de tamaño 3 donde cada matriz define una serie chart-data. Cada matriz se compone de: (i) el nombre de la serie de datos, (ii) los valores del eje X y (iii) los valores del eje Y. Se pueden enviar varias series de datos; en el ejemplo siguiente, por ejemplo, las dos matrices dan datos, respectivamente, de las temperaturas mensuales máxima y mínima.
La función devuelve un elemento de tipo xs:base64Binary que contiene la imagen del gráfico. Esta imagen se crea a partir de los datos suministrados con los argumentos de la función. Recuerde que, al usar esta función matrices y asignaciones, solo se puede usar en XPath 3.1, XQuery 3.1 o XSLT 3.0.
Ejemplo: altova:chart( map{'width':800, 'height':600, "kind":"LineChart", "title":"Monthly Temperatures"}, (['Min', $temps/Month, $temps/Month/@min], ['Max', $temps/Month, $temps/Month/@max]) )
altova:create-chart-config($type-name, $title) como componente de extensión de gráficos
donde
•$type-name indica el gráfico que se va a crear: Pie, Pie3d, BarChart, BarChart3d, BarChart3dGrouped, LineChart, ValueLineChart, RoundGauge, BarGauge
•$title es el nombre del gráfico
La función devuelve un componente de extensión chart-config que contiene los datos de configuración del gráfico.
altova:create-chart-config-from-xml($xml-struct) como componente de extensión de gráficos chart-config
donde
•$xml-struct es la estructura XML que contiene los datos de configuración del gráfico
La función devuelve un componente de extensión chart-config que contiene los datos de configuración del gráfico. Estos datos se suministran en un fragmento de código XML.
altova:create-chart-data-series($series-name?, $x-values*, $y-values*) como componente de extensión de gráficos chart-data-series
donde
•$series-name especifica el nombre de la serie
•$x-values presenta la lista de valores del eje X
•$y-values presenta la lista de valores del eje Y
La función devuelve un componente de extensión chart-data-series que contiene los datos necesarios para generar el gráfico: es decir, el nombre de las series y los datos de los ejes.
altova:create-chart-data-row(x, y1, y2, y3, ...) como componente de extensión de gráficos chart-data-x-Ny-row
donde
•x es el valor de la columna del eje X de la fila de datos del gráfico
•yN son los valores de las columnas del eje Y
La función devuelve un componente de extensión chart-data-x-Ny-row, que contiene los datos para la columna del eje X y las columnas del eje Y de una sola serie.
altova:create-chart-data-series-from-rows($series-names as xs:string*, $row*) como componente de extensión de gráficos chart-data-series
donde
•$series-name es el nombre de la series que se debe crear
•$row es el componente de extensión chart-data-x-Ny-row que se debe crear como serie
La función devuelve un componente de extensión chart-data-series, que contiene los datos para el eje X y el eje Y de la serie.
altova:create-chart-layer($chart-config, $chart-data-series*) como componente de extensión de gráficos chart-layer
donde
•$chart-config es el componente de extensión chart-config obtenido con la función create-chart-config o con la función create-chart-config-from-xml
•$chart-data-series es el componente de extensión chart-data-series que se obtiene con la función create-chart-data-series o con la función create-chart-data-series-from-rows
La función devuelve un componente de extensión chart-layer, que contiene los datos de la capa de gráfico.
altova:create-multi-layer-chart($chart-config, $chart-data-series*, $chart-layer*)
donde
•$chart-config es el componente de extensión chart-config obtenido con la función create-chart-config o con la función create-chart-config-from-xml
•$chart-data-series es el componente de extensión chart-data-series obtenido con la función create-chart-data-series o con la función create-chart-data-series-from-rows
•$chart-layer es el componente de extensión de gráficos multicapas obtenido con la función create-chart-layer
La función devuelve un componente de extensión de gráficos multicapas.
altova:create-multi-layer-chart($chart-config, $chart-data-series*, $chart-layer*, xs:boolean $mergecategoryvalues)
donde
•$chart-config es el componente de extensión chart-config obtenido con la función create-chart-config o con la función create-chart-config-from-xml
•$chart-data-series es el componente de extensión chart-data-series obtenido con la función create-chart-data-series o con la función create-chart-data-series-from-rows
•$chart-layer es el componente de extensión de gráficos multicapa obtenido con la función create-chart-layer
•$mergecategoryvalues combina los valores de varias series de datos si true y no los combina si false
La función devuelve un componente de extensión de gráficos multicapa.