Funciones de extensión para gráficos

www.altova.com Imprimir este apartado Página anterior Subir un nivel Página siguiente

Inicio >  Anexos > Funciones XSTL y XPath/XQuery > Funciones de extensión de Altova >

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.

 

Las funciones para gráficos son funciones XPath (no XSLT) y las hay de dos tipos:

 

Funciones para generar y guardar gráficos
Funciones para crear gráficos

 

Nota:las funciones para gráficos solamente son compatibles con los productos servidor de Altova y con las ediciones Enterprise Edition de las herramientas de escritorio 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.

 

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 binarytobase64 o binarytobase16

 

La función devuelve la imagen del gráfico en la codificación elegida.

 

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 base64Binary o hexBinary
$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.

 

save-chart-image ($chart, $filename, $width, $height) as empty() (solo 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.

 

save-chart-image ($chart, $filename, $width, $height, $imagetype) as empty() (solo 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.

 

 

Funciones para crear gráficos

Puede usar estas funciones para crear gráficos.

 

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.

 

create-chart-config($type-name, $title) como componente de extensión de gráficos chart-config

 

donde

 

$type-name especifica el tipo de gráfico que se debe 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.

 

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.

 

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.

 

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.

 

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.

 

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.

 

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.

 

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

 

La función devuelve un componente de extensión de gráficos multicapa.

 


© 2019 Altova GmbH