Diagrammfunktionen

www.altova.com Dieses Kapitel drucken Vorherige Seite Eine Ebene nach oben Nächste Seite

Startseite >  Informationen zu den Prozessoren > XSLT- und XPath/XQuery-Funktionen > Altova-Erweiterungsfunktionen >

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.

 

Die Diagrammfunktionen sind XPath-Funktionen (nicht XSLT-Funktionen) und werden in zwei Gruppen unterteilt:

 

Funktionen zum Generieren und Speichern von Diagrammen
Funktionen zur Erstellung von Diagrammen

 

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 ist das Diagrammerweiterungsobjekt, das Sie mit der Funktion altova:create-chart erhalten
$width und $height muss mit einer Längeneinheit definiert werden
$encoding kann base64Binary oder 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 den Wert base64Binary oder hexBinary haben kann
$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.

 

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.

 

 

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 ist das chart-data-series Erweiterungsobjekt, das mit der Funktion altova:create-chart-data-series oder mit der Funktion altova:create-chart-config-from-rows erzeugt wurde

 

Die Funktion gibt ein Diagrammerweiterungsobjekt zurück, das anhand der über die Argumente gelieferten Daten erzeugt wird.

 

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 als 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 chart-config-Erweiterungsobjekt ist, das mit der Funktion altova:create-chart-config oder über die Funktion altova:create-chart-config-from-xml abgerufen wird
$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 chart-config Erweiterungsobjekt ist, das mit der Funktion altova:create-chart-config oder über die Funktion altova:create-chart-config-from-xml abgerufen wird
$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 chart-config Erweiterungsobjekt ist, das mit der Funktion altova:create-chart-config oder über die Funktion altova:create-chart-config-from-xml abgerufen wird
$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.

 

 


© 2019 Altova GmbH