Chart oder Diagramm Makro
Das Chart oder Diagramm Makro zeigt ein auf tabellarischen Daten basiertes Diagramm an. Um das Makro einer Seite hinzuzufügen, muss das Folgende passieren:
- die Information, die in einem Diagramm dargestellt werden soll, wird als Tabelle im Platzhalter des Makros eingesetzt.
- die Parameter des Makros werden im Makro-Browser editiert, um das Format des Diagramms zu bestimmen.
Anwendung des Chart Makros
So fügen Sie das Chart Makro auf einer Seite ein:
- Im Bearbeitungsmodus der Seite klicken Sie oben im Editor Menü auf das
- Tippen Sie den Makro-Namen oder einen Teil davon ein und suchen Sie das gewünschte Makro aus. Klicken Sie auf das Makro.
- Geben Sie den Inhalt des Diagramms im Makro Platzhalter ein.
- Klicken Sie auf den Makro-Platzhalter und dann auf Bearbeiten.
- Wählen Sie den Typen für das Diagramm aus (siehe weiter unten).
- Wählen Sie die anderen Parameter-Einstellungen in dem Makro-Browser aus, so wie es weiter unten beschrieben wird.
- Klicken Sie auf das Aktualisieren Symbol in der Vorschau, um zu sehen, wie das Diagramm aussehen wird.
- Klicken Sie auf Speichern, um das Diagramm auf Ihrer Seite anzeigen zu lassen.
- Wenn Sie mit den Änderungen auf der Seite fertig sind, klicken Sie auf Aktualisieren.
Editieren eines existierenden Makros
Um ein existierendes Makro zu bearbeiten:
Klicken Sie auf den Makro Platzhalter und dann auf Bearbeiten. Dieses öffnet den Dialog der Makro Details und Sie können die Makro Parameter (wenn vorhanden) bearbeiten.
Parameter des Chart Makros
Parameter sind Optionen, die Sie einstellen können, um den Inhalt oder das Format des Makro-Outputs zu bestimmen. Hier wird in Klammern angegeben (Beispiel), wenn der im Confluence Storage-Format oder im Wiki-Markup angegebene Parameter-Name anders ist, als der Name, der im Makro-Browser benutzt wird.
Diese Parameter bestimmen, welcher Diagramm-Typ ausgewählt wird und wie das Diagramm am Ende aussieht.
Parameter | Standard-Einstellung | Beschreibung |
---|---|---|
Typ (Type) | pie | Der Diagramm-Typ, der angezeigt werden soll. XY-Diagramme haben numerischen X- und Y-Achsen. Die X-Werte können optional zeitbasiert sein. Standard — pie, bar, line, area XY Plots — xyArea, xyBar, xyLine, xyStep, xyStepArea, scatter, timeSeries Andere — gantt |
Anzeigeausrichtung | horizontal | Für Flächen-, Balken- und Liniendiagramme. Wenn es auf horizontal eingestellt ist, verläuft die X-Achse von oben nach unten. Gültig für area, bar and line Charts.
|
3D | angeklickt | Für Balken-, Linien- und Kreisdiagramme. Wenn diese Option markiert ist, werden die Diagrammdaten angewinkelt angezeigt. |
Gestapelt | nicht angeklickt | Zeigt gestapelte Werte für Balken- und Flächendiagramme an. |
Formen anzeigen | angeklickt | Wenn diese Option markiert ist, werden die Datenpunkte der Diagrammdaten durch Formen hervorgehoben. |
Deckkraft |
| Ein Wert von 0 (transparent) bis 100, der bestimmt, wie deckend die Datenreihen sind. Die Standardwerte sind, abhängig von den Diagrammarten, unterschiedlich. Für 3D-Diagaramme ist der Standardwert 75. Für gestapelte Flächendiagramme ist er 50 und für andere 100. |
Parameters zur Display Kontrolle
Parameter | Standard-Einstellung | Beschreibung |
---|---|---|
Breite (nur Pixel-Wert) | 300 | Die Breite des Charts in Pixeln. |
Höhe (nur Pixel-Wert) | 300 | Die Höhe des Charts in Pixeln. |
Gerenderte Daten anzeigen | nicht angegeben | Bei der Einstellung "vor" wird die Diagrammdaten-Tabelle an der Spitze des Diagramms gezeigt. Bei "nach" wird die Diagrammdaten-Tabelle unterhalb des Diagramms gezeigt. Die Diagrammdaten-Tabelle wird standardmäßig nicht gezeigt. Hier wird festgelegt, ob die gerenderten Daten des Makros (normalerweise die Daten-Tabellen), gezeigt werden. Standardmäßig wird die Diagrammdaten-Tabelle nicht angezeigt.
|
Bildformat | png | Das im Diagramm benutzte Bildformat:
|
Titel und Stichwort Parameter
Parameter | Standard-Einstellung | Beschreibung |
---|---|---|
Diagrammüberschrift | leer | Die Überschrift des Diagramms. |
Diagrammuntertitel | leer | Ein Untertitel des Diagramms, der in kleinerer Schrift als die Diagramm-Überschrift angezeigt wird. |
Stichwort horizontale Achse | leer | Die Bezeichnung für die horizontale Achse. |
Stichwort vertikale Achse | leer | Die Bezeichnung für die vertikale Achse. |
Legende anzeigen? | angeklickt | Anzeige einer Legende. |
Daten-spezifische Parameter
Die Diagrammdaten werden in Tabellen gefunden, wenn das Makro gerendert wird. Diese Optionen kontrollieren, wie diese Daten interpretiert werden. Standardmäßig werden numerische und Daten-Werte nach den globalen Confluence-Default Sprachen-Formaten (lokal) interpretiert. Wenn die Umwandlung nicht funktioniert, werden andere Confluence-Sprachen versucht. Zusätzliche Umwandlungs-Optionen werden in den folgenden Parametern aufgeführt:
Parameter | Standard-Einstellung | Beschreibung |
---|---|---|
Tabellen | alle Tabellen des ersten Levels | Durch Kommas getrennte Liste von ID's, bzw. Zahlen (beginnend mit 1) im Makro-Hauptteil, welches als Diagramm-Daten verwendet werden. Wenn sich Diagramm-Daten in anderen Tabellen befinden, wird eine Tabellen-Auswahl benötigt. Das ist der Fall, wenn eine komplexere Formatierung vorgenommen wird. |
Spalten | alle Spalten | Durch Kommas getrennte Listen von Spaltennamen oder Zahlen (beginnend mit 1) im Makro-Hauptteil, die für die Diagramm-Daten verwendet werden. Gültig für alle verarbeiteten Tabellen. Spalten werden beginnende mit 1 nummeriert. Spalten-Stichwort ist der Text für die Spalte in der Überschriftszeile. Spalten-Titel ist das (HTML) Titel-Attribut in der Überschriftszeile. |
Inhaltsausrichtung | horizontal |
|
Zeitreihen? | leer |
|
Datumsformat | leer | Kommt nur zum Tragen, wenn das Diagramm eine Zeitreihe ist. Hier wird das Format definiert, das zum Lesen der Datums-/Zeit-Werte in den Diagramm-Daten verwendet wird. Wenn ein Datumsformat eingegeben ist, wird es das erste Format sein, um die Werte zu interpretieren. Es muss ein Format eingegeben werden, welches den ausgewählten Zeit-Formate entspricht. Siehe hierzu Einfaches Zeit-Format. |
Zeitspanne | Day (Tag) | Kommt nur zum Tragen, wenn das Diagramm eine Zeitreihe ist. Es definiert die Granularität der Interpretation der Diagramm-Daten. Die Werte sind: Millisecond (Millisekunde), Second (Sekunde), Minute, Hour (Stunde), Day (Tag), Week (Woche), Month (Monat), Quarter (Vierteljahr), Year (Jahr). |
Sprache | leer | Ein ISO 639-1 Sprachcode aus zwei Buchstaben, der zusammen mit 'Land' verwendet wird, um ein Gebietsschema zu bilden. Mit diesem Parameter versucht das Diagramm-Makro, die Diagramm-Daten in diesem Gebietsschema zu interpretieren. |
Land | leer | Ein ISO 3166-1 Alpha-2 Landescode, der mit 'Sprache' verwendet wird, um ein Gebietsschema zu bilden. Mit diesem Parameter versucht das Diagramm-Makro, die Diagramm-Daten in diesem Gebietsschema zu interpretieren. |
Nachsichtig | angeklickt |
|
Farben Parameter
Farben werden in der Hexadezimal-Schreibweise oder in HTML-Farbnamen bestimmt
Parameter | Standard-Einstellung | Beschreibung |
---|---|---|
Hintergrundfarbe | Weiß | Hintergrundfarbe des Diagramms |
Rahmenfarbe | ohne Rahmen | Rahmenfarbe des Diagramms |
Farben | leer | Eine durch Kommas getrennte Liste mit Farben zur Anpassung der Kategorie, Bereiche und Reihenfarben. |
Achsen Parameter
Je nach Diagramm-Typ kann der Bereich und die Domain der Achsen individualisiert werden. Diese Werte werden automatisch, auf den Daten basiert, generiert, können jedoch überschrieben werden, indem ein oder mehr dieser Parameter bestimmt werden.
Parameter | Standard-Einstellung | Beschreibung |
---|---|---|
Mindestwert Bereich | leer | Untere Grenze der Querachse. |
Höchstwert Bereich | leer | Obere Grenze der Querachse. |
Teilstricheinheit der Bereichsachse | leer | Teilstricheinheit der Bereichsachse. |
Beschriftungswinkel der Bereichsachse | leer | Beschriftungswinkel der Bereichsachse in Grad. |
Untere Begrenzung der Domänenachse | leer | Nur für XY-Plots zutreffend. Untere Begrenzung der Domänenachse. Für eine Datums-Achse muss dieser Wert im Datums-Format eingegeben werden, der im Datumsformat Parameter spezifiziert ist. |
Obere Begrenzung der Domänenachse | leer | Nur für XY-Plots zutreffend. Obere Begrenzung der Domänenachse. Für eine Datums-Achse muss dieser Wert im Datums-Format eingegeben werden, der im Datumsformat Parameter spezifiziert ist. |
Teilstricheinheit der Domänenachse | leer | Nur für XY-Plots zutreffend. Teilstricheinheit der Domänenachse. Für eine Datums-Achse, stellt dieser Wert eine Auszählung der Einheiten dar, der im Zeitreihen Parameter angegeben ist. Der Zeitreihen Parameter kann von einem nachgestellten Zeichen überschrieben werden: y (years; Jahre), M (months, Monate), d (days, Tage), h (hours, Stunden), m (minutes, Minuten), s (seconds, Sekunden), u (milliseconds, Millisekunden). |
Beschriftungswinkel der Domänenachse | leer | Nur für XY-Plots zutreffend. Der Beschriftungswinkel der Domänenachse. |
Kategoriestichwortposition | leer | Position für die Kategorie-Stichworte
|
Datumsteilstrichposition | leer | Position des Datums-Teilstrichs
|
Kreis-Diagramm Parameter
Parameter | Standard-Einstellung | Beschreibung |
---|---|---|
Kreissegment-Kennzeichnung | Zeigt nur den Schlüsselwert des Kreis-Segments | Bestimmt, wie die Stichworte der Kreis-Diagramm-Segmente angezeigt werden. Dieses Format benutzt eine Reihe von besonderen Ersatz-Variablen:
|
Kreissegment ausrücken | Keine aufgeklappten Segmente | Durch Komma getrennte Liste von Kreis-Schlüsseln die aufgeklappt gezeigt werden. Bitte beachten: benötigt jFreeChart, Version 1.0.3 oder neuer. |
Anhänge Parameter
Dieses sind erweiterte Optionen, die zum Versionieren der Diagramme benutzt werden, um die Automatisierung zu ermöglichen und um die Performance zu verbessern. Bitte benutzen Sie diese Optionen mit Vorsicht! Normalerweise wird das Diagramm jedes Mal, wenn die Seite angezeigt wird, abgebildet. Diese Optionen lassen Sie das generierte Bild als Anhang speichern und erlauben nochmalige nachfolgende Zugriffe auf die Anhänge. Dieses kann hilfreich sein, besonders wenn sie mit dem Cache Pluginto kombiniert werden, um die Performance zu verbessern. Je nachdem, welche Optionen ausgewählt werden, können die Images der Diagramme für Dokumentationszwecke versioniert werden.
Parameter | Standard-Einstellung | Beschreibung |
---|---|---|
Anhang | leer | Der Name und der Ort, an dem das Bild des Diagramms als Anhang gespeichert wird. Der Nutzer benötigt die "Anhänge hinzufügen" Berechtigung für die jeweilige Seite.
|
Anhangsversion | new | Definiert den Mechanismus der Versionierung der Anhänge von gespeicherten Diagrammen.
|
Anhangskommentar | leer | Kommentar für einen gespeicherten Anhang eines Diagramms. |
Miniaturansicht? | leer |
Kommt nur zum Tragen, wenn ein Anhang angegeben ist. |
Beispiele
Kreis-Diagramm (Pie-Chart)
Parameter im Makro-Browser | Makrobrowser-Einstellung | Datentabelle im Makro-Platzhalter | Gerendertes Diagramm | |
---|---|---|---|---|
Typ | pie | Bitte darauf achten: Sie kann natürlich auch aus inhaltlichen | ||
Diagrammüberschrift | Verkaufte Torten | |||
Legende anzeigen | angklickt | |||
Inhaltsausrichtung (nicht die Anzeigenausrichtung, sondern weiter unten in der Liste!) | vertical | |||
Bemerkung: das Kreis-Diagramm addiert keine Werte aus mehreren Spalten, sondern funktioniert nur mit einem Datensatz. |
Balken-Diagramm (Bar-Chart)
Parameter im Makro-Browser | Datentabelle im Makro-Platzhalter | Gerendertes Diagramm | |
---|---|---|---|
Typ | bar | Bitte darauf achten: Sie kann natürlich auch aus inhaltlichen | |
Diagrammüberschrift | Verkaufter Fisch | ||
Legende anzeigen | angeklickt |
3D-Balken-Diagramm (3D Bar-Chart)
Parameter im Makro-Browser | Datentabelle im Makro-Platzhalter | Gerendertes Diagramm | |
---|---|---|---|
Typ | bar | Bitte darauf achten: Sie kann natürlich auch aus inhaltlichen | |
3D | angeklickt | ||
Deckkraft | 50 | ||
Legende anzeigen | angeklickt |
Zeit-Diagramm (Time Series Chart)
Parameter im Makro-Browser | Datentabelle im Makro-Platzhalter | Gerendertes Diagramm | ||
---|---|---|---|---|
Typ | TimeSeries | Bitte darauf achten: Sie kann natürlich auch aus inhaltlichen | ||
Inhaltsausrichtung | vertical | |||
Datumsformat | MM/yyyy | |||
Zeitspanne | Month | |||
Untere Begrenzung der Domänenachse | leer | |||
Legende anzeigen | angeklickt |
XY-Linien-Diagramm (XY Line Chart)
Parameter im Makro-Browser | Datentabelle im Makro-Platzhalter | Gerendertes Diagramm | |
---|---|---|---|
Typ | xyLine | Bitte darauf achten: Sie kann natürlich auch aus inhaltlichen | |
Legende anzeigen | angeklickt |
XY-Flächen-Diagramm (XY Area Chart)
Parameter im Makro-Browser | Datentabelle im Makro-Platzhalter | Gerendertes Diagramm | |
---|---|---|---|
Typ | xyArea | Bitte darauf achten: Sie kann natürlich auch aus inhaltlichen | |
Legende anzeigen | angeklickt |
Flächen-Diagramme (Area Charts)
Beispiel 1
Parameter im Makro-Browser | Datentabelle im Makro-Platzhalter | Gerendertes Diagramm | |
---|---|---|---|
Typ | area | Bitte darauf achten: Sie kann natürlich auch aus inhaltlichen | |
Legende anzeigen | angeklickt | ||
Breite | 300 | ||
Höhe | 300 | ||
Deckkraft | 50 |
Beispiel 2
Parameter im Makro-Browser | Datentabelle im Makro-Platzhalter | Gerendertes Diagramm | |
---|---|---|---|
Typ | area | Bitte darauf achten: Sie kann natürlich auch aus inhaltlichen |
|
Legende anzeigen | angeklickt | ||
Breite | 300 | ||
Höhe | 300 | ||
Gestapelt | angeklickt |
Gannt-Diagramm (Gantt Chart)
Parameter im Makro-Browser | Datentabelle im Makro-Platzhalter | Gerendertes Diagramm | |
---|---|---|---|
Typ | gantt | Bitte darauf achten: Sie kann natürlich auch aus inhaltlichen | |
Breite | 300 | ||
Höhe | 200 | ||
Spalten | ,,1,2,3,4 | ||
Datumsformat | MM/dd/yyyy |
Sie müssen die zwei anführenden Kommas im Spalten-Parameter mit einfügen (z.B. ..1,2,3,4), damit das Diagramm korrekt erstellt wird.
Code-Beispiele
Dieses Beispiel ist hilfreich, wenn Sie ein Makro außerhalb des Editors, z.B. als benutzerdefinierten Inhalt in der Randleiste, der Kopf- oder Fußzeile, hinzufügen möchten.
Macro name: chart
Macro body: Akzeptiert Rich-Text, der aus Tabellen mit den Daten des Diagramms besteht.
Dieses Makro erkennt ein Vielzahl an Parametern, die hier nach Typ aufgelistet sind.
Beispiel eines Wiki Markups
Dieses Beispiel ist hilfreich, wenn Sie ein Makro ausserhalb des Editors, z.B. als benutzerdefinierten Inhalt in der Randleiste, der Kopf- oder Fußzeile, hinzufügen möchten.
Macro name: blog-posts
Macro body: None.
Macro name:
change-history
Macro body: None.
{chart:type=pie|title=Verkaufte Torten} || Torten Typ || 2004 || 2005 || || Schokolade | 9,500 | 8,300 | || Zitronen | 2,900 | 4,200 | || Apfel | 1,500 | 1,500 | {chart}
Übersicht aller Confluence Makros
Auf dieser Seite finden Sie eine Übersicht aller im Standard von Confluence enthaltenden Makros und allgemeine Informationen über die Anwendung von Makros.