Diagrammfunktionen
Mit Hilfe der unten aufgelisteten Diagrammfunktionen können Sie Diagramme als Bilder erstellen, generieren und speichern. Sie werden in der aktuellen Version Ihres Altova-Produkts auf die unten beschriebene Art unterstützt. Beachten Sie jedoch, dass eine oder mehrere dieser Funktionen in zukünftigen Produktversionen eventuell nicht mehr unterstützt werden, bzw. dass sich das Verhalten einzelner Funktionen ändern kann. Um Informationen über die Unterstützung für Altova Erweiterungsfunktionen in der jeweiligen Release zu erhalten, schlagen Sie bitte in der Dokumentation der jeweils aktuellen Release nach.
| Anmerkung: | Diagrammfunktionen werden nur in Altova Server-Produkten und den Enterprise-Editionen von Altova-Produkten unterstützt. |
| Anmerkung: | Unterstützte Bildformate für Diagramme in Server-Editionen sind jpg, png und bmp. Die beste Option ist png, da dabei keine Daten verloren gehen und es sich um ein komprimiertes Format handelt. In Enterprise-Editionen werden die folgenden Formate unterstützt: jpg. png, bmp und gif. |
Funktionen zum Generieren und Speichern von Diagrammen
Diese Funktionen generieren anhand des (mit Hilfe der Diagrammerstellungsfunktionen) erzeugten Diagrammobjekts entweder ein Bild oder speichern ein Bild in einer Datei
altova:generate-chart-image ($chart, $width, $height, $encoding) als atomic
wobei
•$chart das Diagramm-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart erzeugt wurde
•$width und $height mit einer Längeneinheit definiert werden müssen
•$encoding kann x-binarytobase64 oder x-binarytobase16 sein
Die Funktion gibt das Diagrammbild in der definierten Kodierung zurück.
altova:generate-chart-image ($chart, $width, $height, $encoding, $imagetype) als atomic
wobei
•$chart das Diagramm-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart erzeugt wurde
•$width und $height mit einer Längeneinheit definiert werden müssen
•$encoding kann x-binarytobase64 oder x-binarytobase16 sein
•$imagetype eines der folgenden Bildformate sein kann: png, gif, bmp, jpg, jpeg. Beachten Sie, dass gif in Server-Produkten nicht unterstützt wird. Siehe oben auf dieser Seite.
Die Funktion gibt das Diagrammbild in der definierten Kodierung und im definierten Bildformat zurück.
altova:save-chart-image ($chart, $filename, $width, $height) als empty()(nur Windows)
wobei
•$chart das Diagramm-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart erzeugt wurde
•$filename der Pfad und Name der Datei ist, unter dem das Diagrammbild gespeichert werden soll
•$width und $height mit einer Längeneinheit definiert werden müssen
Die Funktion speichert das Diagrammbild unter dem in $filename definierten Dateinamen. Alternativ zu dieser Funktion könnten Sie auch die Funktion xsl:result-document mit encoding="x-base64tobinary" verwenden, wobei der image-data-Inhalt entweder über die Funktion generate-chart-image() oder die Funktion chart() erhalten wird.
altova:save-chart-image ($chart, $filename, $width, $height, $imagetype) als empty()(nur Windows)
wobei
•$chart das Diagramm-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart erzeugt wurde
•$filename der Pfad und Name der Datei ist, unter dem das Diagrammbild gespeichert werden soll
•$width und $height mit einer Längeneinheit definiert werden müssen
•$imagetype eines der folgenden Bildformate sein kann: png, gif, bmp, jpg, jpeg. Beachten Sie, dass gif in Server-Produkten nicht unterstützt wird. Siehe oben auf dieser Seite.
Die Funktion speichert das Diagrammbild im definierten Bildformat unter dem in $filename definierten Dateinamen. Alternativ zu dieser Funktion könnten Sie auch die Funktion xsl:result-document mit encoding="x-base64tobinary" verwenden, wobei der image-data-Inhalt entweder über die Funktion generate-chart-image() oder die Funktion chart() erhalten wird.
Funktionen zur Erstellung von Diagrammen
Die folgenden Funktionen dienen zur Erstellung von Diagrammen.
altova:create-chart($chart-config, $chart-data-series*) als chart extension item
wobei
•$chart-config das Diagrammkonfigurations-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart-config oder über die Funktion altova:create-chart-config-from-xml erzeugt wurde
•$chart-data-series das chart-data-series-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart-data-series oder der Funktion altova:create-chart-data-series-from-rows abgerufen wird
Die Funktion gibt ein Diagrammerweiterungsobjekt zurück, das anhand der über die Argumente gelieferten Daten erzeugt wird.
altova:chart($chart-config, $chart-data-series*) als chart extension item
wobei
•$chart-config das Diagrammkonfigurations-Erweiterungsobjekt ist. Es handelt sich hierbei um eine nicht geordnete Reihe von vier Schlüssel:Wert-Paaren, wobei die vier Schlüssel "width", "height", "title" und "kind" sind. Die Werte von width und height sind Ganzzahlen und definieren die Höhe und Breite des Diagramms in Pixel. Der Wert von kind ist einer der folgenden: Pie, Pie3d, BarChart, BarChart3d, BarChart3dGrouped, LineChart, ValueLineChart, RoundGauge, BarGauge.
•$chart-data-series ist jeweils ein Array der Größe 3, wobei jedes Array eine Diagrammdatenreihe definiert. Jedes Array besteht aus: (i) dem Namen der Datenreihe, (ii) den Werten der x-Achse, (iii) den Werten der y-Achse. Es können mehrere Datenreihen angegeben werden. Im Beispiel unten enthalten die zwei Arrays Daten für die Temperatur-Monatsminima bzw. -maxima.
Die Funktion gibt ein Element vom Typ xs:base64Binary zurück, welches das Diagrammbild enthält. Dieses Bild wird anhand der über die Argumente der Funktion bereitgestellten Daten erstellt. Beachten Sie, dass diese Funktion, da sie Arrays und Zuordnungen verwendet, nur in XPath 3.1, XQuery 3.1 oder XSLT 3.0 verwendet werden kann.
Beispiel: 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) als chart-config Erweiterungsobjekt
wobei
•$type-name den Typ des zu erstellenden Diagramms definiert: Pie, Pie3d, BarChart, BarChart3d, BarChart3dGrouped, LineChart, ValueLineChart, RoundGauge, BarGauge
•$title der Name des Diagramms ist
Die Funktion gibt ein Diagrammkonfigurations-Erweiterungsobjekt zurück, das die Konfigurationsinformationen zum Diagramm enthält.
altova:create-chart-config-from-xml($xml-struct) als chart-config Erweiterungsobjekt
wobei
•$xml-struct die XML-Struktur ist, die die Konfigurationsinformationen des Diagramms enthält
Die Funktion gibt ein Diagrammkonfigurations-Erweiterungsobjekt zurück, das die Konfigurationsinformationen zum Diagramm enthält. Diese Informationen werden in einem XML-Datenfragment geliefert.
altova:create-chart-data-series($series-name?, $x-values*, $y-values*) als chart-data-series Erweiterungsobjekt
wobei
•$series-name der Name der Datenreihe ist
•$x-values die Liste der Werte für die X-Achse liefert
•$y-values die Liste der Werte für die Y-Achse liefert
Die Funktion gibt ein Diagrammdatenreihen-Erweiterungsobjekt zurück, das die Daten zur Erstellung des Diagramms, also die Namen der Datenreihen, und die Achsendaten enthält.
altova:create-chart-data-row(x, y1, y2, y3, ...) als chart-data-x-Ny-row Erweiterungsobjekt
wobei
•x der Wert der X-Achsen-Spalte der Diagrammdatenzeile ist
•yN die Werte der Spalten für die Y-Achse sind
Die Funktion gibt ein chart-data-x-Ny-row Erweiterungsobjekt zurück, das die Daten für die X-Achsen-Spalte und die Y-Achsen-Spalten einer einzigen Datenreihe enthält.
altova:create-chart-data-series-from-rows($series-names as xs:string*, $row*) als chart-data-series-Erweiterungsobjekt
wobei
•$series-name der Name der zu erstellenden Datenreihen ist
•$row das chart-data-x-Ny-row Erweiterungsobjekt ist, das als Datenreihe erstellt werden soll
Die Funktion gibt ein chart-data-series Erweiterungsobjekt zurück, das die Daten für die X- und die Y-Achse der Datenreihe enthält.
altova:create-chart-layer($chart-config, $chart-data-series*) als chart-layer Erweiterungsobjekt
wobei
•$chart-config das Diagrammkonfigurations-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart-config oder über die Funktion altova:create-chart-config-from-xml erzeugt wurde
•$chart-data-series das chart-data-series-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart-data-series oder der Funktion altova:create-chart-data-series-from-rows abgerufen wird
Die Funktion gibt ein chart-layer Erweiterungsobjekt zurück, das chart-layer-Daten enthält.
altova:create-multi-layer-chart($chart-config, $chart-data-series*, $chart-layer*)
wobei
•$chart-config das Diagrammkonfigurations-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart-config oder über die Funktion altova:create-chart-config-from-xml erzeugt wurde
•$chart-data-series das chart-data-series-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart-data-series oder der Funktion altova:create-chart-data-series-from-rows abgerufen wird
•$chart-layer das chart-layer-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart-layer abgerufen wird
Die Funktion gibt ein multi-layer-chart-Objekt zurück.
altova:create-multi-layer-chart($chart-config, $chart-data-series*, $chart-layer*, xs:boolean $mergecategoryvalues)
wobei
•$chart-config das Diagrammkonfigurations-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart-config oder über die Funktion altova:create-chart-config-from-xml erzeugt wurde
•$chart-data-series das chart-data-series-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart-data-series oder der Funktion altova:create-chart-data-series-from-rows abgerufen wird
•$chart-layer das chart-layer-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart-layer abgerufen wird
•$mergecategoryvalues bei true die Werte mehrerer Datenreihen zusammenführt und dies bei false nicht tut.
Die Funktion gibt ein multi-layer-chart-Objekt zurück.