Untergeordnete Seiten
  • Scaffolding Plugin (Rezept)
Zum Ende des Banners springen
Zum Anfang des Banners springen
Zum Ende der Metadaten springen
Zum Anfang der Metadaten

Mit Hilfe des Scaffolding Plugins (wörtlich: Baugerüst oder Grundgerüst) lässt sich eine strukturierte Dateneingabe bewerkstelligen. Anstelle einer regulären Freitexteingabe kann der Ersteller einer Seite bereits im Vorfeld die Eingabefelder und somit die Struktur der Seite bestimmen.

Dies eignet sich hervorragend für Seiten, bei denen es klare strukturelle Vorgaben für die einzugebenden Daten gibt. Das Plugin schließt somit (zumindest teilweise) eine Lücke in der Funktionalität von Confluence, um - ähnlich einer formularbasierten Eingabe - Daten zu erfassen.

Überblick:

Zutaten

Plugins

Makros

  • repeating-data
  • text-data
  • number-data
  • date-data

Sonstiges

Zubereitung

Das Plugin stellt zahlreiche Eingabefelder zur Datenerfassung bereit. Wir verwenden im folgenden die am häufigsten verwendeten Felder für Text, numerische Werte sowie das Datumsformat.

Für eine fiktive Produktdatenbank möchten wir für jeden Artikel identische Informationen sammeln. Diese lautet:

  • Artikelname
  • Artikelbezeichnung
  • Produktnummer
  • Erstellungsdatum

Entsprechend den Datentypen nutzen wir verschiedene Makros zur Datenerfassung. Dies hat den Vorteil, dass bspw. bei numerischen Feldern tatsächlich auch nur Zahlen eingegeben werden können.

Erstellung

Wie beginnen mit der Erstellung des Grundgerüsts auf einer neuen Seite. Es empfiehlt sich, mit einer Beispielseite im gewünschten Layout zu starten. Für dieses Rezept verzichten wir auf komplexe Layout und konzentrieren uns auf die eigentlichen Inhalte.

Hier die Grundstruktur mit lediglich den Bezeichnungen der Eingabefelder:

*Artikelname*
Artikelbezeichnung: 
_Artikelnummer_: 
_Einstellungsdatum_: 

Nun binden wir die entsprechenden Makros an den gewünschten Stellen ein. Hier werden die Anwender später ihre eigenen Werte eingeben:

*{text-data:Artikelname}Artikelname{text-data}*
Artikelbezeichnung: {text-data:Artikelbez|width=500px}Vorgegebener Text{text-data}
_Artikelnummer_: {number-data:Nummer}
_Einstellungsdatum_: {date-data:Datum|format=yyyy-mm-dd}

Tip: Bei dem Datentyp "Datum" können Sie das Eingabeformat vorgeben. In diesem Fall wählen wir das ISO-Format yyy-mm-dd.

Abschließend fügen wir noch ein Makro hinzu, die ähnlich einem "Endlosformular" die Eingabe von multiplen Produkten erlaubt. Hierzu nutzen wir das repeating-data-Makro:

{repeating-data:Produktkatalog}
(...)
{repeating-data} 

Anwendung

Dieses Plugin bietet eine große Bandbreite von Anwendungsmöglichkeiten. Sinnvoll sind alle Bereiche, bei denen strukturiert und nach dem gleichen Schema Daten erfasst werden sollen. Denkbar sind beispielsweise:

  • Produktinformationen
  • Persönliche Daten (bspw. bei Bewerbungsunterlagen oder Lebensläufen)
  • Kundenübersichten
  • Projektdetails

Diese Liste ließe sich sicherlich um viele weitere Anwendungsfälle erweitern.

Tipps und Tricks

Die Scaffolding Funktionalität lässt sich sehr gut mit dem ebenfalls in diesem Plugin enthaltenen live-template-Makro kombinieren.

Resultat

Hier das fertige Ergebnis unserer oben beschriebenen Einzelschritte:

{repeating-data:Produktkatalog}
*{text-data:Artikelname}Artikelname{text-data}*
Artikelbezeichnung: {text-data:Artikelbez|width=500px}Vorgegebener Text{text-data}
_Artikelnummer_: {number-data:Nummer}
_Einstellungsdatum_: {date-data:Datum|format=yyyy-mm-dd}
{repeating-data} 

Und so sieht letztlich eine Seite aus, bei der bereits zwei Produkte hinzugefügt wurden:

Blueberries
Artikelbezeichnung:Zuckersüße, leckere, saftige Blaubeeren für Muffins und dergleichen!
Artikelnummer:2011
Einstellungsdatum:2011-00-31

Rotbeeren
Artikelbezeichnung:Bittere, wenig leckere, trockene rote Beeren für eigentlich gar nichts
Artikelnummer:2012
Einstellungsdatum:2012-00-15