Add-On: Dynamische Formulare
Dynamische Formulare
Ein dynamisches Formular sammelt Angaben, die zu einem Auftrag gehören, aber in kein festes Feld passen – ein Briefing, eine Anfrage, Rückfragen zur Bestellung. Hängt es an einem Artikel, liegen die Angaben der Bestellung bei und lassen sich für eine Nachbestellung wiederverwenden.
Formulare werden im Sitemanager unter Add-ons » Dynamische Formulare gepflegt.
1. Die Übersicht
Die Liste zeigt zu jedem Formular seine Bezeichnung, den Aufbau (Schritte, Abschnitte, Felder) und wann es zuletzt geändert wurde. Die Formulare können innerhalb der Übersicht direkt als Vorschau geöffnet, bearbeitet, kopiert oder gelöscht werden.
Ein neues Formular kann über Neues Formular oben rechts angelegt werden.
Ein angelegtes Formular wird nicht automatisch im Shop angezeigt. Es muss anschließend in den Einstellungen eines Artikels (Artikeltyp Dynamische Anfrage / Briefing) oder einer Inhaltsseite ausgewählt werden.
2. Der Baukasten
Der Baukasten besteht aus drei Spalten und einer Kopfzeile.
Bereich | Inhalt |
|---|---|
Kopfzeile | Bezeichnung des Formulars, Speicherzustand, Rückgängig/Wiederherstellen, Änderungsverlauf, Umschalter Bearbeiten / Vorschau, Schließen |
Links | Die Bausteine: Feldarten und Aufbau-Elemente |
Mitte | Das Formular in der Ansicht des Kunden |
Rechts | Die Einstellungen des ausgewählten Elements |
Über der mittleren Spalte liegt die Schritt-Navigation. Sie bleibt beim Scrollen stehen und markiert den Schritt, in dem gerade gearbeitet wird. Der Pfeil an einem Schritt springt direkt zu einem bestimmten Abschnitt darin.
Ein Element auswählen
Ein Klick auf ein Feld, einen Abschnitt oder einen Schritt in der Mitte wählt es aus; rechts erscheinen seine Einstellungen. Esc hebt die Auswahl wieder auf. Ein Klick auf die Kopfzeile des Formulars öffnet die Einstellungen des Formulars selbst (Bezeichnung und Beschreibung).
3. Ein Formular aufbauen
Ein Formular besteht aus drei Ebenen:
Schritt – eine Seite des Formulars. Mehrere Schritte ergeben einen Ablauf mit Weiter-Schaltflächen.
Abschnitt – eine Gruppe zusammengehörender Felder innerhalb eines Schritts.
Feld – die einzelne Frage an den Kunden.
Elemente lassen sich auf zwei Wegen einfügen:
Per Klick auf einen Baustein links – er wird an das Ende des aktuellen Abschnitts gehängt.
Per Ziehen aus der linken Spalte an die gewünschte Stelle. Während des Ziehens zeigen sich die möglichen Ablageflächen; ein leerer Abschnitt hebt sich dabei besonders hervor.
Vorhandene Elemente werden am Griff (die sechs Punkte in der kleinen Werkzeugleiste) verschoben. Dieselbe Leiste bietet Duplizieren und Entfernen.
4. Die Feldarten
Feldart | Beschreibung |
|---|---|
Textfeld | Freier Text – Name, Nachricht, Anmerkung. Auf Wunsch mehrzeilig. |
Auswahlliste | Eine Antwort, aufklappbar |
Einzelauswahl | Eine Antwort, alle sichtbar |
Mehrfachauswahl | Mehrere Antworten, alle sichtbar |
Datei-Upload | Der Kunde lädt eine Datei hoch |
Freie Antworten | Der Kunde legt die Antworten selbst an – er trägt einen Text ein und fügt ihn über + hinzu, beliebig oft |
5. Einstellungen eines Feldes
Die rechte Spalte zeigt nur, was zur gewählten Feldart passt. Erklärungen stehen hinter den kleinen Fragezeichen neben den Beschriftungen.
Einstellung | Wirkung |
|---|---|
Bezeichnung | Die Frage / Bezeichnung, die dem Benutzer angezeigt wird |
Pflichtfeld | Ohne Angabe kann der Benutzer nicht fortfahren |
Breite | Wie viel Platz das Feld in seiner Zeile einnimmt – ganze Zeile, Hälfte, Drittel, Viertel oder ein eigener Wert |
Platzhalter | Beispieltext im leeren Feld |
Hinweis | Erklärung unter dem Feld |
Vorausgefüllt | Steht von Beginn an im Feld und lässt sich überschreiben (siehe Abschnitt 6) |
Prüfung der Eingabe | Vorlagen für E-Mail, Telefonnummer, Postleitzahl, nur Ziffern – oder ein eigener Ausdruck |
Mindestens / Höchstens auswählbar | Nur bei Mehrfachauswahl |
6. Vorausgefüllte Werte aus dem Kundenkonto
Ein vorausgefülltes Feld kann mehr als festen Text enthalten: Angaben aus dem Konto des angemeldeten Kunden werden beim Öffnen des Formulars eingesetzt.
Hier können vordefinierte Variablen genutzt werden: Rechts im Feld Vorausgefüllt auf das Adresskarten-Symbol klicken. Es öffnet sich eine durchsuchbare Liste – Kunde, Anschrift, Rechnungsanschrift – mit einem Beispiel zu jedem Eintrag („Vorname / Max"). Ein Klick setzt die Angabe an der Cursorposition ein. Es lassen sich auch mehrere verbinden, etwa Guten Tag {$shopUser->firstName}.
Unter dem Feld steht, was am Ende dasteht: Beispiel: Guten Tag Max.
Eine Angabe, die es im Kundenkonto nicht gibt, lässt das Formular im Shop nicht mehr öffnen. Der Baukasten warnt in diesem Fall unter dem Feld und in der Prüfliste – über die Liste ausgewählte Angaben sind immer korrekt.
Ist eine Angabe im Konto des Kunden nicht hinterlegt, bleibt die Stelle einfach leer. Bei einem nicht angemeldeten Besucher bleiben alle Angaben leer.
7. Antworten pflegen
Bei Auswahllisten, Einzel- und Mehrfachauswahl werden die Antworten in der rechten Spalte gepflegt.
Reihenfolge – am Griff verschieben.
Vorausgewählt – die Antwort ist beim Öffnen bereits angehakt.
Bild – jede Antwort kann ein Bild tragen; es erscheint im Shop über der Beschriftung.
Mehrere auf einmal – über Mehrere einfügen eine Liste einfügen, eine Antwort je Zeile.
Eigene Werte – normalerweise wird die Antwort über ihre Kennung übergeben. Nur wenn ein angebundenes System bestimmte Werte erwartet, werden hier eigene Werte gepflegt. Sind welche vorhanden, ist die Pflege automatisch aufgeklappt.
8. Bedingungen: Felder ein- und ausblenden
Ein Feld oder ein ganzer Abschnitt kann davon abhängen, was der Kunde vorher geantwortet hat.
Element auswählen.
Rechts auf Bedingungen klicken – es öffnet sich ein eigener Dialog.
Zwischen immer sichtbar und nur unter Bedingungen wählen.
Regel zusammenstellen: Feld – Vergleich – Wert. Mehrere Regeln lassen sich mit und oder oder verbinden.
Im Formular tragen Elemente mit Bedingungen eine kleine Markierung, damit sichtbar bleibt, dass sie nicht immer erscheinen.
Ein Vergleich ohne Vergleichswert funktioniert im Shop nicht wie erwartet. Der Baukasten weist darauf hin.
9. Die Zusammenfassung
Ein Abschnitt kann statt Feldern eine Zusammenfassung enthalten. Sie wiederholt am Ende des Formulars die Angaben des Kunden zur Kontrolle. Ohne weitere Einstellung erscheinen alle Felder; über die Feldauswahl (mit Suchfeld) lässt sich die Zusammenfassung auf einzelne Felder begrenzen.
10. Vorschau
Der Umschalter Bearbeiten / Vorschau in der Kopfzeile zeigt das Formular so, wie der Kunde es sieht: ohne Bearbeitungswerkzeuge, mit funktionierender Schritt-Navigation und wirksamen Bedingungen. Eingaben in der Vorschau dienen nur dem Ausprobieren und werden nirgends gespeichert.
11. Hinweise vor dem Speichern
Der Baukasten prüft das Formular laufend und sammelt Auffälligkeiten in der linken Spalte, zum Beispiel:
ein Schritt ohne Abschnitt, ein Abschnitt ohne Feld
ein Feld ohne Bezeichnung
eine Auswahl ohne Antworten
eine Bedingung, die auf ein gelöschtes Feld verweist
eine vorausgefüllte Angabe, die es im Kundenkonto nicht gibt
Ein Klick auf einen Hinweis springt zum betroffenen Element. Hinweise verhindern das Speichern nicht – sie sind Empfehlungen, mit Ausnahme der vorausgefüllten Angabe, die im Shop tatsächlich zu einem Fehler führt.
12. Änderungsverlauf
Das Uhr-Symbol in der Kopfzeile öffnet den Verlauf. Er hat zwei Reiter.
Diese Bearbeitung
Jeder Schritt seit dem Öffnen des Baukastens, neueste zuerst, mit Angabe des betroffenen Elements und – wo möglich – dem Wert davor und danach.
Klick auf einen Eintrag setzt das Formular auf diesen Stand zurück.
Fadenkreuz zeigt das betroffene Element im Formular.
Pfeil nimmt genau diese eine Änderung zurück, ohne die späteren anzutasten. Ist das nicht mehr möglich, weil eine spätere Änderung dieselbe Einstellung erneut gesetzt hat, wird der Eintrag als nicht mehr in Kraft markiert.
Änderungen anzeigen unten öffnet eine Tabelle mit allem, was sich seit dem letzten Speichern geändert hat – die Antwort auf die Frage vor dem Speichern.
Gespeichert wird durch nichts davon.
Gespeicherte Stände
Jedes Speichern legt einen Stand ab. Die Liste zeigt Zeitpunkt, Benutzer und Umfang; der Stand, der gerade im Shop aktiv ist, ist markiert.
Klick auf einen Stand lädt ihn in den Baukasten. Auf dem Server ändert sich dabei nichts – der Stand wird erst mit Formular speichern übernommen und lässt sich bis dahin wie jede andere Änderung zurücknehmen. Oben in der Kopfzeile erscheint, auf welchem Stand die Bearbeitung aufbaut.
Kästchen links wählt Stände zum Vergleich aus – zwei bis vier.
Vergleichen
Der Vergleich öffnet eine Tabelle mit einer Spalte je Stand. Jede Zeile ist ein Element und eine Sache daran: ob es vorhanden ist, wo es sitzt, oder was eine seiner Einstellungen sagt – und nur dann, wenn die Stände sich unterscheiden. Umbenannte oder verschobene Elemente werden als dasselbe Element erkannt, nicht als „entfernt und neu angelegt".
13. Übersetzungen
Texte, die der Benutzer sehen kann, tragen rechts im Eingabefeld ein Sprachsymbol. Darüber werden die Übersetzungen für die Sprachen des Shops gepflegt – für Bezeichnungen, Platzhalter, Hinweise und Beschreibungen.
14. Was im Hintergrund geschieht
Aufbewahrung der Stände: Die letzten 30 bleiben vollständig erhalten. Ältere werden auf einen je Tag und ab 30 Tagen auf einen je Monat zusammengefasst; nach zwölf Monaten entfallen sie. Ein Speichern, das nichts geändert hat, legt keinen neuen Stand an.
Bilder von Antworten: Ein Bild bleibt so lange erhalten, wie ein gespeicherter Stand es braucht – auch wenn es im aktuellen Formular längst entfernt wurde. Erst wenn kein Stand es mehr nennt, wird die Datei gelöscht. Ein wiederhergestellter Stand hat seine Bilder also noch.
Löschen eines Formulars entfernt auch seine gespeicherten Stände.
15. Tastenkürzel
Kürzel | Wirkung |
|---|---|
| Formular speichern |
| Letzte Änderung zurücknehmen |
| Zurückgenommene Änderung wiederherstellen |
| Auswahl aufheben, geöffnete Liste schließen |
Innerhalb eines Eingabefeldes gilt die Rückgängig-Funktion des Browsers für den Text selbst.
16. Häufige Fragen
Das Formular erscheint im Shop nicht. Es muss in den Einstellungen eines Artikels oder einer Inhaltsseite ausgewählt sein. Ein angelegtes, aber nirgends zugeordnetes Formular wird nirgends angezeigt.
Ein vorausgefülltes Feld bleibt leer. Die Angabe ist im Konto des Kunden nicht hinterlegt, oder der Besucher ist nicht angemeldet. Beides ist unkritisch – die Stelle bleibt einfach leer.
Ein Feld erscheint beim Kunden nicht. Vermutlich hängt es an einer Bedingung. In der Vorschau lässt sich das nachstellen.
Versehentlich das Falsche gespeichert. Im Änderungsverlauf unter Gespeicherte Stände den vorherigen Stand laden, prüfen und speichern. Der falsche Stand bleibt dabei erhalten.
Die Informationen aus einem Dynamischen Formular werden innerhalb der Informationen zu einer Bestellposition über den Key “dynamicFormData” also JSON-String bereitgestellt.