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:

  1. Im Bearbeitungsmodus der Seite klicken Sie oben im Editor Menü auf das  Symbol (Weiteren Inhalt einfügen) und dann auf Andere Makros.



  2. Tippen Sie den Makro-Namen oder einen Teil davon ein und suchen Sie das gewünschte Makro aus. Klicken Sie auf das Makro.
  3. Geben Sie den Inhalt des Diagramms im Makro Platzhalter ein.
  4. Klicken Sie auf den Makro-Platzhalter und dann auf Bearbeiten.
  5. Wählen Sie den Typen für das Diagramm aus (siehe weiter unten).
  6. Wählen Sie die anderen Parameter-Einstellungen in dem Makro-Browser aus, so wie es weiter unten beschrieben wird.
  7. Klicken Sie auf das Aktualisieren Symbol in der Vorschau, um zu sehen, wie das Diagramm aussehen wird.
  8. Klicken Sie auf Speichern, um das Diagramm auf Ihrer Seite anzeigen zu lassen.
  9. 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.


ParameterStandard-EinstellungBeschreibung

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

Anzeigeausrichtunghorizontal

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.

    • vertical — Y-Achse ist vertical
    • horizontal — X-Achse ist vertical
3Dangeklickt

Für Balken-, Linien- und Kreisdiagramme. Wenn diese Option markiert ist, werden die Diagrammdaten angewinkelt angezeigt.

Gestapeltnicht angeklicktZeigt gestapelte Werte für Balken- und Flächendiagramme an.
Formen anzeigenangeklicktWenn diese Option markiert ist, werden die Datenpunkte der Diagrammdaten durch Formen hervorgehoben.
Deckkraft
  • 75 % für 3D Charts
  • 50 % für nicht gestapelte area Charts
  • 100 % für alle anderen Charts
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

ParameterStandard-EinstellungBeschreibung
Breite (nur Pixel-Wert)300Die Breite des Charts in Pixeln.
Höhe (nur Pixel-Wert)300Die Höhe des Charts in Pixeln.
Gerenderte Daten anzeigennicht 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.

    • before (vor) — Die Diagrammdaten-Tabelle wird oberhalb des Diagramms angezeigt.
    • after (nach) — Die Diagrammdaten-Tabelle wird unterhalb des Diagramms angezeigt.


Bildformatpng

Das im Diagramm benutzte Bildformat:

    • png
    • jpg

Titel und Stichwort Parameter

ParameterStandard-EinstellungBeschreibung
DiagrammüberschriftleerDie Überschrift des Diagramms.
DiagrammuntertitelleerEin Untertitel des Diagramms, der in kleinerer Schrift als die Diagramm-Überschrift angezeigt wird.
Stichwort horizontale AchseleerDie Bezeichnung für die horizontale Achse.
Stichwort vertikale AchseleerDie Bezeichnung für die vertikale Achse.
Legende anzeigen?angeklicktAnzeige 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:

ParameterStandard-EinstellungBeschreibung
Tabellenalle 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.

Spaltenalle 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.

Inhaltsausrichtunghorizontal
    • vertical (vertikal) — ganze Spalten werden in der Diagrammdaten-Tabelle als Reihen verwendet.
    • horizontal — es werden ganze Zeilen verwendet.


Zeitreihen?leer
    • leer — die X-Werte in einem XY-Plot werden als Zeitreihen Daten behandelt und somit in bestimmte Daten-Formate umgewandelt.
Datumsformatleer

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.

ZeitspanneDay (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)MinuteHour (Stunde), Day (Tag)Week (Woche)Month (Monat)Quarter (Vierteljahr)Year (Jahr).

Spracheleer

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.

LandleerEin 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.
Nachsichtigangeklickt
    • angeklickt — mit diesem Parameter versucht das Diagramm-Makro, Werte die etwas außerhalb des Formats liegen, nachsichtiger zu interpretieren.
    • leer — die Daten werden in einem strikten Format übertragen. Bei Datenformat-Fehlern wir das Diagramm nicht gerendert.



Farben Parameter

Farben werden in der Hexadezimal-Schreibweise oder in HTML-Farbnamen bestimmt

ParameterStandard-EinstellungBeschreibung
HintergrundfarbeWeißHintergrundfarbe des Diagramms
Rahmenfarbeohne RahmenRahmenfarbe 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.

ParameterStandard-EinstellungBeschreibung
Mindestwert BereichleerUntere Grenze der Querachse.
Höchstwert BereichleerObere Grenze der Querachse.

Teilstricheinheit der Bereichsachse

leerTeilstricheinheit der Bereichsachse.
Beschriftungswinkel der BereichsachseleerBeschriftungswinkel 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

    • up45 — 45 Grad nach oben
    • up90 — 90 Grad nach unten
    • down45 — 45 Grad nach unten
    • down90 — 90 Grad nach oben
Datumsteilstrichposition
 leer

Position des Datums-Teilstrichs

    • start — Datums-Teilstrich befindet sich am Beginn des Datums der Periode
    • middle — Datums-Teilstrich befindet sich in der Mitte des Datums der Periode
    • end — Datums-Teilstrich befindet sich am Ende des Datums der Periode

Kreis-Diagramm Parameter

ParameterStandard-EinstellungBeschreibung
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:

    • %0% wird durch den Schlüsselwerte des Kreis-Segments ersetzt
    • %1% wird durch den numerischen Wert des Kreis-Segments ersetzt
    • %2% wird durch den Prozent-Wert des Kreis-Segments ersetzt
  1. Beispiel: "%0% = %1%" würde etwas wie "Unabhängig = 20" anzeigen
  2. Beispiel: "%0% (%2%)" würde etwas wie "Unabhängig (20%)" anzeigen
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.

ParameterStandard-EinstellungBeschreibung
Anhang
leerDer 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.
    • ^attachmentName.png — das Diagramm wird als Anhang an die aktuelle Seite gespeichert.
    • page^attachmentName.png — das Diagramm wird als Anhang an die Seite, dessen Namen angegeben wird, gespeichert.
    • space:page^attachmentName.png — das Diagramm wir als Anhang an die Seite, dessen Name und Position in einem Bereich angegeben wird, gespeichert.


Anhangsversionnew

Definiert den Mechanismus der Versionierung der Anhänge von gespeicherten Diagrammen.

    • new (neu) — erstellt eine neue Version des Anhangs.
    • replace (ersetzen) — ersetzt alle vorherigen Versionen des Diagramms. Um einen existierenden Anhang ersetzen zu können, muss der Nutzer die Berechtigung dafür besitzen, Anhänge für die angegebene Seite zu löschen.
    • keep (beibehalten) — speichert den neuen Anhang nur, wenn es keinen Export mit dem gleichen Namen gibt. Ein existierender Anhang wird nicht geändert oder aktualisiert.
Anhangskommentar
leer

Kommentar für einen gespeicherten Anhang eines Diagramms.

Miniaturansicht?
leer
    •  angeklickt — rendert Diagramme als Miniaturansichten.

Kommt nur zum Tragen, wenn ein Anhang angegeben ist.



Beispiele

Kreis-Diagramm (Pie-Chart)

Parameter im Makro-Browser

Makrobrowser-EinstellungDatentabelle im Makro-Platzhalter

Gerendertes Diagramm

Typpie

Bitte darauf achten:
Diese Tabelle wird direkt im Platzhalter
erstellt, nicht außerhalb.

Sie kann natürlich auch aus inhaltlichen
Gründen zusätzlich außerhalb als
normaler Inhalt hinzugefügt werden.


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-BrowserDatentabelle im Makro-PlatzhalterGerendertes Diagramm
Typbar

Bitte darauf achten:
Diese Tabelle wird direkt im Platzhalter
erstellt, nicht außerhalb.

Sie kann natürlich auch aus inhaltlichen
Gründen zusätzlich außerhalb als
normaler Inhalt hinzugefügt werden.

Diagrammüberschrift
Verkaufter Fisch
Legende anzeigen
angeklickt

 


3D-Balken-Diagramm (3D Bar-Chart)

Parameter im Makro-BrowserDatentabelle im Makro-PlatzhalterGerendertes Diagramm
Typbar

Bitte darauf achten:
Diese Tabelle wird direkt im Platzhalter
erstellt, nicht außerhalb.

Sie kann natürlich auch aus inhaltlichen
Gründen zusätzlich außerhalb als
normaler Inhalt hinzugefügt werden.

3Dangeklickt
Deckkraft50
Legende anzeigenangeklickt

Zeit-Diagramm (Time Series Chart)

Parameter im Makro-BrowserDatentabelle im Makro-PlatzhalterGerendertes Diagramm
TypTimeSeries


Bitte darauf achten:
Diese Tabelle wird direkt im Platzhalter
erstellt, nicht außerhalb.

Sie kann natürlich auch aus inhaltlichen
Gründen zusätzlich außerhalb als
normaler Inhalt hinzugefügt werden.

Inhaltsausrichtungvertical
DatumsformatMM/yyyy
ZeitspanneMonth

Untere Begrenzung der Domänenachse


leer
Legende anzeigenangeklickt



XY-Linien-Diagramm (XY Line Chart)

Parameter im Makro-BrowserDatentabelle im Makro-PlatzhalterGerendertes Diagramm
TypxyLine

Bitte darauf achten:
Diese Tabelle wird direkt im Platzhalter
erstellt, nicht außerhalb.

Sie kann natürlich auch aus inhaltlichen
Gründen zusätzlich außerhalb als
normaler Inhalt hinzugefügt werden.

Legende anzeigenangeklickt



XY-Flächen-Diagramm (XY Area Chart)

Parameter im Makro-BrowserDatentabelle im Makro-PlatzhalterGerendertes Diagramm
TypxyArea

Bitte darauf achten:
Diese Tabelle wird direkt im Platzhalter
erstellt, nicht außerhalb.

Sie kann natürlich auch aus inhaltlichen
Gründen zusätzlich außerhalb als
normaler Inhalt hinzugefügt werden.

Legende anzeigenangeklickt


 


Flächen-Diagramme (Area Charts)

Beispiel 1
Parameter im Makro-BrowserDatentabelle im Makro-PlatzhalterGerendertes Diagramm
Typarea

Bitte darauf achten:
Diese Tabelle wird direkt im Platzhalter
erstellt, nicht außerhalb.

Sie kann natürlich auch aus inhaltlichen
Gründen zusätzlich außerhalb als
normaler Inhalt hinzugefügt werden.

Legende anzeigenangeklickt
Breite300
Höhe300
Deckkraft50



Beispiel 2

Parameter im Makro-Browser Datentabelle im Makro-PlatzhalterGerendertes Diagramm
Typarea

Bitte darauf achten:
Diese Tabelle wird direkt im Platzhalter
erstellt, nicht außerhalb.

Sie kann natürlich auch aus inhaltlichen
Gründen zusätzlich außerhalb als
normaler Inhalt hinzugefügt werden.


 

 

Legende anzeigenangeklickt
Breite300
Höhe300
Gestapeltangeklickt

Gannt-Diagramm (Gantt Chart)

Parameter im Makro-BrowserDatentabelle im Makro-PlatzhalterGerendertes Diagramm
Typgantt

Bitte darauf achten:
Diese Tabelle wird direkt im Platzhalter
erstellt, nicht außerhalb.

Sie kann natürlich auch aus inhaltlichen
Gründen zusätzlich außerhalb als
normaler Inhalt hinzugefügt werden.

Breite300
Höhe200
Spalten,,1,2,3,4
DatumsformatMM/dd/yyyy

(Info) 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.

Diese Seite wurde zuletzt am 19.04.2024 geändert.