Fonctions de graphique
Les fonctions de graphique recensées ci-dessous vous permettent de créer, générer et enregistrer des graphiques comme images. Elles sont prises en charge dans la version actuelle de votre produit Altova comme suit. Veuillez noter que, en ce qui concerne les versions futures de votre produit, la prise en charge d'une fonction peut être interrompue et le comportement de certaines fonctions peut changer. Veuillez consulter la documentation lors des publications à venir pour plus d'informations concernant la prise en charge des fonctions d'extension Altova de cette version.
Note :Les fonctions de graphique sont supportées uniquement dans les produits de serveur d'Altova et les produits d'édition Enterprise de Altova.
Note :Les formats d'image pris en charge pour les graphiques dans les éditions de serveur sont jpg, png et bmp. La meilleure option est png car elle est sans perte et compressée. Dans les éditions Enterprise, les formats pris en charge sont jpg. png, bmp et gif.
Fonctions de génération et d'enregistrement des graphiques
Ces fonctions prennent l'objet de graphique (obtenu avec les fonctions de création de graphique) et soit génèrent une image soit enregistrent une image dans le fichier
altova:generate-chart-image ($chart, $width, $height, $encoding) en tant que atomic
alors que
•$chart est l'item d'extension de graphique obtenu avec la fonction altova:create-chart
•$width et $height doivent être spécifiés avec une unité de longueur
•$encoding peut être binarytobase64 ou binarytobase16
La fonction retourne l'image de graphique dans le codage spécifié.
altova:generate-chart-image ($chart, $width, $height, $encoding, $imagetype) as atomic
alors que
•$chart est l'item d'extension de graphique obtenu avec la fonction altova:create-chart
•$width et $height doivent être spécifiés avec une unité de longueur
•$encoding peut être binarytobase64 ou binarytobase16
•$imagetype peut être un des formats d'image suivants : png, gif, bmp, jpg, jpeg. Veuillez noter que gif n'est pas pris en charge pour les produits de serveur. Voir également la note en haut de la page.
La fonction retourne l'image de graphique dans le format d'encodage et d'image spécifié.
altova:save-chart-image ($chart, $filename, $width, $height) en tant que empty() (Windows uniquement)
alors que
•$chart est l'item d'extension de graphique obtenu avec la fonction altova:create-chart
•$filename est le nom du fichier et le chemin sous lequel l'image de graphique doit être enregistré
•$width et $height doivent être spécifiés avec une unité de longueur
La fonction enregistre l’image du graphique au fichier spécifique dans $filename. En alternative à cette fonction, vous pourriez aussi utiliser la fonction xsl:result-document avec encoding="x-base64tobinary", où le contenu image-data est obtenu soit via la fonction generate-chart-image() ou la fonction chart().
altova:save-chart-image ($chart, $filename, $width, $height, $imagetype) as empty() (Windows only)
alors que
•$chart est l'item d'extension de graphique obtenu avec la fonction altova:create-chart
•$filename est le nom du fichier et le chemin sous lequel l'image de graphique doit être enregistré
•$width et $height doivent être spécifiés avec une unité de longueur
•$imagetype peut être un des formats d'image suivants : png, gif, bmp, jpg, jpeg. Veuillez noter que gif n'est pas pris en charge pour les produits de serveur. Voir également la note en haut de la page.
La fonction enregistre l'image de graphique sous le fichier spécifié dans $filename dans le format d'image spécifié. En alternative à cette fonction, vous pourriez aussi utiliser la fonction xsl:result-document avec encoding="x-base64tobinary", où le contenu image-data est obtenu soit via la fonction generate-chart-image() ou la fonction chart().
Fonctions de création de graphiques
Les fonctions suivantes sont utilisées pour créer des graphiques.
altova:create-chart($chart-config, $chart-data-series*) en tant que chart extension item
alors que
•$chart-config est l'item d'extension chart-config obtenu avec la fonction altova:create-chart-config ou via la fonction altova:create-chart-config-from-xml
•$chart-data-series est l'item d'extension chart-data-series obtenu avec la fonction altova:create-chart-data-series ou la fonction altova:create-chart-data-series-from-rows
La fonction retourne un item d'extension chart, qui est créé depuis les données fournies par le biais des arguments.
altova:chart($chart-config, $chart-data-series*) en tant que chart extension item
where
•$chart-config est l'item d'extension chart-config. Il s'agit d'une série non ordonnée de quatre clés : paires de valeur, où les quatre clés sont "width", "height", "title", et "kind". Les valeurs de width et height sont des entiers et spécifient la largeur et la hauteur du graphique en pixels. La valeur de kind est une de : Pie, Pie3d, BarChart, BarChart3d, BarChart3dGrouped, LineChart, ValueLineChart, RoundGauge, BarGauge.
•$chart-data-series forme un array de taille 3, où chaque array définit une série de données de graphique. Chaque array est composé du : (i) nom de la série de données, (ii) des valeurs de l'axe X, (iii) des valeurs de l'axe Y. Plusieurs séries de données peuvent être soumises ; dans l'exemple ci-dessous les deux arrays donnent respectivement des données pour les températures mensuelles minimum et maximum.
La fonction retourne un item type xs:base64Binary qui contient une image graphique. L’image est créée depuis des données fournies par le biais des arguments de la fonction. Puisque la fonction utilise les arrays et cartes, veuillez noter que qu’elle peut être utilisée uniquement dans XPath 3.1, XQuery 3.1 ou XSLT 3.0.
Exemple : 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) en tant qu'item d'extension chart-config
alors que
•$type-name spécifie le type de graphique à créer : Pie, Pie3d, BarChart, BarChart3d, BarChart3dGrouped, LineChart, ValueLineChart, RoundGauge, BarGauge
•$title est le nom du graphique
La fonction retourne un item d'extension chart-config contenant les informations de configuration du graphique.
altova:create-chart-config-from-xml($xml-struct) en tant qu'item d'extension chart-config
alors que
•$xml-struct est la structure XML contenant l’information de la configuration du graphique
La fonction retourne un item d'extension chart-config contenant les informations de configuration du graphique. Cette information est forunie dans un fragment de données XML.
altova:create-chart-data-series($series-name?, $x-values*, $y-values*) en tant qu'item d'extension chart-data-series
alors que
•$series-name spécifie le nom de la série
•$x-values donne la liste des valeurs de l'axe X
•$y-values donne la liste des valeurs de l'axe Y
La fonction retourne un item d'extension chart-data-series contenant les données pour la construction du graphique : c'est à dire, les noms de la série et les données des Axes.
altova:create-chart-data-row(x, y1, y2, y3, ...) en tant qu'item d'extension chart-data-x-Ny-row
alors que
•x est la valeur de la colonne de l'axe X de la rangée des données de graphique
•yN sont les valeurs des colonnes de l'axe Y
La fonction retourne un item d'extension chart-data-x-Ny-row qui contient les données pour la colonne de l'axe X et les colonnes de l'axe Y d'une seule série.
altova:create-chart-data-series-from-rows($series-names as xs:string*, $row*) en tant qu'item d'extension chart-data-series
alors que
•$series-name est le nom de la série à créer
•$row est l'item d'extension chart-data-x-Ny-row qui doit être créé en tant qu'une série
La fonction retourne un item d'extension chart-data-series qui contient les données pour l'axe X et l'axe Y de la série.
altova:create-chart-layer($chart-config, $chart-data-series*) en tant qu'item d'extension chart-layer
alors que
•$chart-config est l'item d'extension chart-config obtenu avec la fonction altova:create-chart-config ou via la fonction altova:create-chart-config-from-xml
•$chart-data-series est l'item d'extension chart-data-series obtenu avec la fonction altova:create-chart-data-series ou la fonction altova:create-chart-data-series-from-rows
La fonction retourne un item d'extension chart-layer qui contient des données chart-layer.
altova:create-multi-layer-chart($chart-config, $chart-data-series*, $chart-layer*)
alors que
•$chart-config est l'item d'extension chart-config obtenu avec la fonction altova:create-chart-config or ou via la fonction altova:create-chart-config-from-xml
•$chart-data-series est l'item d'extension chart-data-series obtenu avec la fonction altova:create-chart-data-series ou la fonction altova:create-chart-data-series-from-rows
•$chart-layer est l'item d'extension chart-layer obtenu avec la fonction altova:create-chart-layer
La fonction retourne un item multi-layer-chart.
altova:create-multi-layer-chart($chart-config, $chart-data-series*, $chart-layer*, xs:boolean $mergecategoryvalues)
alors que
•$chart-config est l'item d'extension chart-config obtenu avec la fonction altova:create-chart-config ou via la fonction altova:create-chart-config-from-xml
•$chart-data-series est l'item d'extension chart-data-series obtenu avec la fonction altova:create-chart-data-series ou la fonction altova:create-chart-data-series-from-rows
•$chart-layer est l'item d'extension chart-layer obtenu avec la fonction altova:create-chart-layer
•$mergecategoryvalues fusionne les valeurs de plusieurs séries de données si true, ne fusionne pas si false
La fonction retourne un item multi-layer-chart.