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: