Child pages
  • Scaffolding Plugin (Rezept)
Skip to end of banner
Go to start of banner
Skip to end of metadata
Go to start of metadata

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-31Rotbeeren


Artikelbezeichnung:

Bittere, wenig leckere, trockene rote Beeren für eigentlich gar nichts


Artikelnummer:

2012


Einstellungsdatum:

2012-00-15

Verwandte Dokumente

 Für weitere Details, bitte hier klicken ...
Unknown macro: {dynamiccontentbylabel}
Bitte bewerten Sie den Inhalt!
Unknown macro: {kbsurvey}