Add-On: Dynamische Formulare

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

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:

  1. Per Klick auf einen Baustein links – er wird an das Ende des aktuellen Abschnitts gehängt.

  2. 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

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

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.

  1. Element auswählen.

  2. Rechts auf Bedingungen klicken – es öffnet sich ein eigener Dialog.

  3. Zwischen immer sichtbar und nur unter Bedingungen wählen.

  4. 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

Kürzel

Wirkung

Strg + S

Formular speichern

Strg + Z

Letzte Änderung zurücknehmen

Strg + Umschalt + Z

Zurückgenommene Änderung wiederherstellen

Esc

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.