Formularvorlagen erstellen

[lindsey (Lindsey Fogle)]

Diese Anleitung erklärt, wie man Formularvorlagen zur Strukturierung von Inhalten in Discourse verwendet.

Erforderliche Benutzerebene: Administrator

Formularvorlagen ermöglichen es Ihnen, strukturierte Formulare mit Validierungsregeln zu erstellen, die Benutzer beim Erstellen von Themen ausfüllen können, sodass Sie sicherstellen können, dass Benutzer alle Informationen bereitstellen, die Sie zur Unterstützung benötigen, z. B. für Fehlerberichte, Funktionsanfragen usw.

Hinweis: Für Vorlagen, die eher Richtlinien als ein strukturiertes Formular darstellen, sollten Sie Themenvorlagen in Betracht ziehen.

Formularvorlagen aktivieren

Sie können Formularvorlagen in Anstehende Änderungen aktivieren, indem Sie Formularvorlagen aktivieren auf „Jeder“ setzen.

Formularvorlagen erstellen

Sie können Formularvorlagen erstellen und verwalten, indem Sie zu Admin > Erscheinungsbild > Formularvorlagen (/admin/customize/form-templates) navigieren.

Um eine Formularvorlage zu erstellen:

1. Klicken Sie auf Neue Vorlage.

2. Aktualisieren Sie das Feld Vorlagenname mit einem internen Namen für Ihre Vorlage.

3. Verwenden Sie die Schaltflächen oben auf der Seite, um die verschiedenen Felder Ihres Formulars hinzuzufügen und die Feldattribute zu aktualisieren (unten detailliert). Viele der Optionen sind Standard-Formularfeldtypen (z. B. Kontrollkästchen, Kurzantwort, Dropdown usw.), aber es gibt einige spezifische Felder:

   • Tag-Gruppen-Auswahl: Benutzer können ein oder mehrere Tags aus einer bestimmten Gruppe auswählen.

   • Markdown-Antwort: Benutzer können Inhalte direkt in einer Mini-Version des Komponisten eingeben. Dies ist ideal, wenn Mitglieder Markdown direkt eingeben müssen, z. B. Code, oder andere Formatierungen benötigen, die vom Rich-Editor unterstützt werden.

4. Fügen Sie die gewünschten Validierungen zu Ihren Eingaben hinzu. Klicken Sie auf die Schaltfläche Validierung für einen Schlüssel (auch unten angezeigt).

5. Klicken Sie auf die Schaltfläche Vorschau, um sicherzustellen, dass alles korrekt aussieht.

6. Klicken Sie auf Speichern.

Feldattribute

Allgemeine Attribute für alle Feldtypen:

• label: Der sichtbare Feldname
• placeholder: Hilfetext, der in leeren Feldern (Eingabe, Textbereich, Dropdown, Mehrfachauswahl) angezeigt wird
• description: Zusätzlicher Kontext oder Anweisungen, die unter dem Feld angezeigt werden.

Upload-spezifische Attribute:

• file_types: Durch Kommas getrennte Liste der zulässigen Dateierweiterungen (z. B. .jpg, .png, .pdf)
• allow_multiple: Boolescher Wert, der angibt, ob Benutzer mehrere Dateien hochladen können

Dropdown- und Mehrfachauswahl-Attribute:

• none_label: Text, der angezeigt wird, wenn keine Option ausgewählt ist
• choices: Array der verfügbaren Optionen

Tag-Gruppen-Auswahl-Attribute:

• tag_group: (Eigenschaft der obersten Ebene) Der Name der Tag-Gruppe, aus der die Auswahlmöglichkeiten abgerufen werden sollen
• none_label: Text, der angezeigt wird, wenn keine Option ausgewählt ist
• multiple: Boolescher Wert, der angibt, ob Benutzer mehrere Tags auswählen können (Standard-Scaffold setzt dies auf true)

Validierungsoptionen

Schlüssel	Typ	Beschreibung
required	boolean	Erfordert, dass das Feld ausgefüllt wird, um das Formular abzuschicken.
minimum	integer	Bei Textfeldern gibt dies die minimal zulässige Anzahl von Zeichen an.
maximum	integer	Bei Textfeldern gibt dies die maximal zulässige Anzahl von Zeichen an.
pattern	regex; string	Für Textfelder ein regulärer Ausdruck, der die zulässige Eingabe festlegt.
type	string	Bei Eingabefeldern können Sie den erwarteten Eingabetyp angeben (text, email, date, number, url, tel, color, password)

Formularvorlagen zu einer Kategorie hinzufügen

Nachdem Sie eine Vorlage erstellt haben:

1. Navigieren Sie zu der Kategorie, in der Sie die Vorlage verwenden möchten.
2. Klicken Sie auf die Schaltfläche , um die Kategorie zu bearbeiten.

3. Schalten Sie die Schaltfläche Erweiterte Einstellungen um (falls Sie das neue vereinfachte Kategorie-Design verwenden).
4. Gehen Sie zur Registerkarte Vorlage.
5. Schalten Sie den Schalter Formularvorlage ein.
6. Wählen Sie die Formularvorlage im Dropdown-Menü aus.
7. Klicken Sie auf Kategorie speichern.

Wenn mehreren Kategorien Vorlagen zugewiesen sind, sehen Benutzer beim Erstellen von Themen eine Vorlagenauswahl.

Mitglieder-Erfahrung

Themen mit Formularvorlagen erstellen

Wenn ein Mitglied ein Thema in einer Kategorie mit Formularvorlagen erstellt, wird das Formular automatisch im Komponisten angezeigt. Wenn mehrere Vorlagen auf dieselbe Kategorie angewendet werden, können Mitglieder die richtige Vorlage aus einem Dropdown-Menü auswählen. Wenn Benutzer versuchen, ein Thema zu erstellen, ohne jedes Feld korrekt auszufüllen, wird eine Validierungsfehlermeldung angezeigt.

Formularwerte vorab ausfüllen

Formularfelder können mithilfe von URL-Parametern, die mit Feld-IDs übereinstimmen, vorab ausgefüllt werden. Zum Beispiel: /new-topic?software-version=2.4.1&severity=Critical

Dies ist nützlich, um auf die Themen-Erstellung mit bereits ausgefüllten Feldern zu verlinken.

[Eingang]

Wie sehen die Regex-Muster aus und welche Regex-Variante wird erwartet? Ich habe Folgendes versucht und alle sind erfolgreich durchgelaufen, was ich nicht erwartet hatte:

• 2[6-9][0-1][0-9][0-3][0-9] mit einem Eintrag von 180918;
• /2[6-9][0-1][0-9][0-3][0-9]/ mit einem Eintrag von 180918;
• /2[6-9][0-1][0-9][0-3][0-9]/ mit einem Eintrag von 12;