Seitenformulare (Page Forms)

Für Cloud-Kunden, deren Instanz auf BlueSpice Version 5 läuft: Bitte wechseln Sie zum BlueSpice 5 Helpdesk.

Page Forms erlaubt es, Parameterwerte für Vorlagen über ein Formular einzugeben.

Die Verwendung der Erweiterung ist ausführlich auf MediaWiki dokumentiert.

Hauptmerkmale

Definitionsseiten im Namensraum Formular
Formulare können über die Spezialseite Spezial:CreateForm erstellt werden. Hier wird die entsprechende Vorlage ausgewählt, deren Parameter-Werte über das Formular eingegeben werden sollen. Das heißt, bevor ein Formular erstellt wird, wird immer zuerst die hierzu nötige Vorlage erstellt. Alle erstellten Formular-Definitionsseiten werden im Namensraum Formular gespeichert. Die Bearbeitung von bereits erstellten Formular-Definitionsseiten erfolgt über den Quelltext der Seite.

Anwendungsbeispiel: Infoboxen
Die Erweiterung wird oft zum Hinzufügen und Bearbeiten von Infobox-Vorlagen verwendet. Wenn Semantic MediaWiki verwendet wird, können die über das Formular gesammelten Daten in den Vorlagen gespeichert und im Wiki abgefragt werden.

Vorhandene Daten über Menüpunkt bearbeiten
Bereits bestehende Daten können unter anderem über den Menüpunkt "Mit Formular bearbeiten" der Bearbeiten-Schaltfläche geändert werden.

Automatische Vervollständigung von Feldern
Benutzern werden je nach Typ des Eingabefeldes bei der Eingabe bereits existierende Werte vorgeschlagen. Dies reduziert Probleme bei der Dateneingabe.

Starthilfe

Um das Erstellen Ihres ersten Formulars zu erleichtern können Sie in der Dokumentation auf folgenden Seiten einsteigen:

Formular anlegen: Nachdem Sie eine Vorlage erstellt haben, können Sie über die Seite Spezial:Formular erstellen das zugehörige Formular erstellen. Diese Spezialseite unterstützt Sie beim Erstellen des Formulars. Spätere Bearbeitungen erfolgen jedoch direkt im Quelltext des Formulars.
Formularfelder: Arten von Formularfeldern
Formular mit der Vorlage verknüpfen: Da die Vorlage vor dem Formular existiert, muss diese nachträglich noch manuell mit dem neuen Formular verknüpft werden.
- Innerhalb der Vorlage
- Als weiterer Bearbeitungs-Link direkt im Bearbeitungsmenü der Seiten

BlueSpice Input types

Zusätzlich zu den standardmäßig verfügbaren Eingabetypen stehen in BlueSpice noch folgende Inputtypen zur Verfügung:

Eingabetyp	Resultat	Funktion
bs-grid -v4.5	Eingabetabelle	Tabelle zur kombinierten Eingabe von Parameter-Werten. Tabellenreihen werden über eine "+" Schaltfläche hinzugefügt. Folgende Vorlagen müssen zusätzlich erstellt werden: Vorlage für die Tabellenreihe sowie zugehörige columns.json-Seite Vorlage für die Ausgabe der Tabellenwerte
bs-usercombo	Benutzername (verlinkt zur Profilseite)	Menü zur Auswahl von Benutzernamen des Wikis (Einfachauswahl).
bs-usertags	Kommaseparierte Benutzernamen (nicht verlinkt)	Menü zur Auswahl von Benutzernamen des Wikis (Mehrfachauswahl). Hinweis: Um die Benutzernamen zu verlinken, muss der Parameter in der zugehörigen Vorlage entsprechend als Link formatiert werden: `{{#arraymap:{{{meinParameter\|}}}\|,\|@@@\|[[User:@@@\|@@@]]}}`
bs-mwvisualeditor	Formatierter Text	Textbox mit vereinfachtem VisualEditor.
bsvisualeditor	-	Veraltet - ersetzt durch bs-mwvisualeditor

bs-grid

Bs-grid ermöglicht es, eine Tabelle als Eingabemethode für ein Formularfeld zu erstellen.

Beispiel des Eingabetyps "bs-grid"

So verwenden Sie das Grid-Eingabefeld:

Erstellen Sie die Vorlage Vorlage:Produkte/Reihe.
1. Definieren Sie die Parameter, für die Werte gesammelt werden sollen. Hier wird eine Tabellenreihe erstellt, um später die Produktdaten als filterbare Tabelle anzuzeigen:
```
<noinclude>Tabellenreihe für die Ausgabe der Produktdaten</noinclude><includeonly>
|-
|{{{product|}}}
|{{{department|}}}
|{{{availDate|}}}
|{{{sale|}}}
</includeonly>
```

Definieren Sie das Grid in der Vorlage:Produkte/Reihe/Spalten.json:

[
{"header":"Produktname","dataIndex":"product", "flex":1, "editor":{"allowBlank":false}},
{"header":"Abteilung","dataIndex":"department","editor":{"xtype":"combo","typeAhead":true,"triggerAction":"all","store":[["Baby und Kleinkind","Baby und Kleinkind"],["Jungen","Jungen"],["Mädchen","Mädchen"],["Männer","Männer"],["Frauen","Frauen"]]}},
{"xtype":"datecolumn","header":"Verfügbar ab","dataIndex":"availDate","format":"d.m.Y","editor":{"xtype":"datefield","format":"d/m/y","minValue":"01/01/21"}},
{"xtype":"checkcolumn","header":"Angebot?","dataIndex":"sale","headerCheckbox":true,"stopSelection":false}
]

Hinweis: Die Syntax der json-Datei kommt aus dem Framework Ext JS. Links zur Dokumentation der Grid-Syntax finden Sie unter Verwandte Themen am Ende der Seite (JS-Kenntnisse werden vorausgesetzt).

Erstellen Sie die Seite Vorlage:Produkte. Diese Vorlage wird als Ausgabeformat für die Produktdaten verwendet. Sie enthält den benötigten Parameter produktdaten:

<noinclude>Ausgabetabelle für die Produktdaten. 
Der Parameter "produktdaten" wird im Formular "Produkte" verarbeitet.
</noinclude><includeonly>{{#default_form: Produkte}}
{| class="wikitable filterable"
|+Produktübersicht der aktuellen Kollektion
!Produktbezeichnung
!Abteilung
!Verfügbar ab
!Im Angebot?
{{{produktdaten}}}
|}
</includeonly>

Erstellen Sie das Eingabeformular Formular:Produkte. Durch das Formularfeld produktdaten wird die Dateneingabe als Tabellengrid (bs-grid) definiert:

<noinclude>Das ist das Formular "Produkte". Es wird mit der gleichnamigen Vorlage benutzt.</noinclude><includeonly>
<div id="wikiPreview" style="display: none; padding-bottom: 25px; margin-bottom: 25px; border-bottom: 1px solid #AAAAAA;"></div>
{{{for template|Produkte}}}
Produkte: 

{{{field|produktdaten|input type=bs-grid|colDef=Vorlage:Produkte/Reihe/Spalten.json|template=Produkte/Reihe}}}

{{{end template}}}

{{{standard input|save}}} {{{standard input|preview}}} {{{standard input|cancel}}}
</includeonly>

Binden Sie die Vorlage "Produkte" nun auf einer Wikiseite ein.
1. Klicken Sie in der Editorleiste Einfügen > Vorlage.
2. Geben Sie den Text "Produkte" ein.
3. Klicken Sie Vorlage hinzufügen.
  
  Vorlage einfügen
4. Speichern Sie die Seite.
5. Öffnen Sie nun die Seite im Formularbearbeitungsmodus. Hier können Sie ihre Produktdaten eingeben.
6. Speichern Sie die Seite erneut. Die filterbare Produktdatentabelle wird nun angezeigt.
  
  Ausgabe der Griddaten

Im Quelltext sieht der produktdaten-Parameter dann so aus:

{{Produkte
|produktdaten={{Produkte/Reihe|product=Wanderhose|department=Männer|availDate=30.07.2021|sale=true}}
{{Produkte/Reihe|product=Pullover|department=Jungen|availDate=04.07.2021}}
{{Produkte/Reihe|product=Socken|department=Frauen|availDate=03.08.2021}}
}}

Spezialseiten

Page Forms definiert einige Spezialseiten, die zur Dateneingabe und Datenpflege gebraucht werden.

Zum Sammeln von Daten sind unter anderem folgende Spezialseiten wichtig:

Weiterführende Links

Technische Referenz: Page Forms

Feedback zur Dokumentation ist im Community-Forum möglich.