Breezingforms importieren

Neues Feature im Visforms Basispaket 4.2.1

Der Import vorhandener Breezingforms-Formulare nach Visforms steht ihnen im Visforms Basispakt für Joomla 4 zur Verfügung. Das Feature ‘Breezingforms-Import’ ist ab der Version 4.2.1 im Basispaket enthalten.

Der Import überführt die wichtigsten Formularoptionen und die eigentlichen Formularfelder mit ihren wichtigsten Optionen nach Visforms. Mit den ‘eigentlichen Formularfeldern’ sind die Felder gemeint, in denen der Benutzer seine Eingabe macht.

Dies kann Ihnen bereits eine Menge Arbeit ersparen. Den größten Nutzen des Imports sehen wir aber darin, dass die gespeicherten Formularübertragungen soweit möglich ebenfalls nach Visforms übernommen werden. Alle gespeicherten Formularübertragungen werden aus Gründen der Datensicherheit automatisch auf “nicht veröffentlicht” gesetzt.

Visforms Dashboard: Breezingforms Import

Breezingforms Formulare werden anhand der Breezingforms Datenbank-Tabellen importiert

Es werden die folgenden Tabellen in der Joomla-Datenbank gesucht und für den Import der Formulare verwendet:

  • #__facileforms_forms,
  • #__facileforms_elements,
  • #__facileforms_records,
  • #__facileforms_subrecords,
  • #__facileforms_config.

Findet Visforms alle diese Tabellen in Ihrer Datenbank, so wird Ihnen im Visforms Dashboard der folgende Bereich ‘Breezingforms Import’ mit den Buttons zur Steuerung des Imports angezeigt.

Breezingforms Formulare nach Visforms importieren

Hinweis: Findet Visforms in Ihrer Datenbank mindestens eine dieser Tabellen nicht, so wird Ihnen Bereich 'Breezingforms Import' nicht angezeigt. Für einen erfolgreichen Import sind alle genannten Tabellen zwingend notwendig.

Sie können den Import beliebig oft durchführen, solange Sie den Bereich ‘Breezingforms Import’ nicht ausgeblendet haben.
Klicken Sie für einen Import auf den Button “Import starten”.

Sie können den Bereich ‘Breezingforms Import’ dauerhaft ausblenden.
Klicken Sie zum Ausblenden auf den Button “Diese Funktion dauerhaft ausblenden”.

Hinweis: Es ist nicht möglich, den ausgeblendeten Bereich 'Breezingforms Import' auf direktem Weg erneut anzuzeigen. Dies ist allein durch einen manuellen Zugriff auf Konfigurations-Daten in einer der Visforms-Tabellen möglich.

Wir empfehlen Bereich ‘Breezingforms Import’ in den folgenden Situationen dauerhaft zu deaktivieren:

  • Sie haben die Formulare erfolgreich importiert.
  • Sie wollen keine Breezingforms Formulare importieren.

Es werden alle Formulare importiert

Bei einem Import-Vorgang werden immer alle Breezingforms Formulare inklusive aller gespeicherten Daten importiert. Werden hierbei ungewünschte Formulare, Felder oder Daten importiert, so können Sie diese nach dem Import jederzeit und sehr einfach in Visforms löschen.

Können einzelne Formulare, Felder oder Datensätze nicht importiert werden, dann werden diese beim Import übersprungen. Dies ist etwa der Fall, wenn die in den Breezingforms-Tabellen gespeicherten Definitionen nicht mit Visforms kompatibel sind. Weiter unten finden Sie eine ausführliche Auflistung, welche Definitionen beim Import übernommen werden.

Bereits in Visforms vorhandene Formulare werden beim Import niemals überschrieben

Stattdessen werden die importierten Formulare am Ende angefügt. Infolge dessen haben Formulare, Felder und Datensätze in Visforms andere IDs als in Breezingforms.

Die Breezingforms “Modi” und deren Auswirkung auf den Import

Breezingforms bietet 3 verschiedene Modi an, mit denen Formulare erstellt werden können:

  • QuickMode
  • EasyMode
  • ClassicMode

Die Informationen, die das Breezingforms-Formular und seine Felder definieren sind in sehr unterschiedlicher Art und Weise in der Datenbank gespeichert. Die Art und Weise der Speicherung hängt davon ab, mit welchem Modus das Formular mit Breezingforms erstellt wurde.

Insbesondere für Formulare, die mit EasyMode erstellt wurden, ist dies wichtig. Denn EasyMode-Formulare sind in einer Art und Weise in der Datenbank gespeichert, dass diese leider nur rudimentär importiert werden können. Abhängig vom Modus können die Informationen mehr oder weniger gut extrahiert und für den Import genutzt werden.

Informationen aus ‘Scripts’ und ‘Pieces’ gehen beim Import verloren

Weiterhin arbeitet Breezingforms intensiv mit sogenannten Scripts (Javascript Code Schnipsel) und Pieces (PHP Code Schnipsel). Alle Definitionen, die über Scripts und Pieces erfolgen, gehen beim Import verloren.

Import der Formulardefinition

Folgende Formularoptionen werden unabhängig vom Erstellungsmodus nach Visforms übernommen:

  • Name
  • Titel
  • Veröffentlicht
  • Beschreibung
  • Ergebnismail senden
  • Ergebnismail Konfiguration: Betreff, MailTo, MailFrom, Mailfrom Name, Daten senden, Leere Daten ausschließen, Text der Ergebnismail
  • Kunden E-Mail senden
  • Kunden E-Mail Konfiguration: Betreff, MailFrom, Mailfrom Name, Daten senden, Leere Daten ausschließen, Text der Kunden E-Mail
  • Captcha/ReCaptcha verwenden

Import der Felddefinition

Im Folgenden finden Sie eine Übersicht, welche Felder und Feld-Informationen importiert werden. Was importiert werden kann ist abhängig davon, mit welchem Modus das Formular erstellt wurde.

Hinweis: Bitte beachten Sie, dass alle Felder beim Import automatisch auf veröffentlicht gesetzt werden.

QuickMode

Bei allen importierten Feldern wird Name, Titel und Type importiert. Weiterhin werden die Breezingforms-Parameter Required, Hint, Hidelabel und HideinMailback übernommen.

Felder mit folgenden Feldtypen werden importiert:

  • Text
  • Textarea
  • Radio (inklusive Optionen und gewähltem Defaultwert)
  • Checkbox Gruppe (inklusive Optionen und gewähltem Defaultwert)
  • Select from List (inklusive Optionen, der Einstellung “Multiselect” und gewähltem Defaultwert)
  • Checkbox (inklusive übermitteltem Wert und der Einstellung “Default Checked”)
  • File (inklusive der Einstellung über erlaubten Dateiendungen)
  • Submit
  • Hidden
  • Calendar (inklusive des gewählten Datumsformats)
  • Number

ClassicMode

Bei allen importierten Feldern wird Name, Titel und Type importiert. Weiterhin wird der Parameter Mailback übernommen. Beim Typ Checkbox wird korrekt ermittelt, ob es sich um eine einzelne Checkbox oder eine Checkbox-Gruppe handelt.

Felder mit folgenden Feldtypen werden importiert:

  • Text
  • Textarea
  • Radio Button (inklusive Optionen und gewähltem Defaultwert)
  • Checkbox Gruppe (inklusive Optionen und gewähltem Defaultwert)
  • Select List (inklusive Optionen und gewähltem Defaultwert)
  • Checkbox (inklusive übermitteltem Wert und der Einstellung “Default Checked”)
  • File Upload (inklusive der Einstellung über erlaubten Dateiendungen)
  • Regular Button (wird als Submit Button importiert)
  • Hidden Input

EasyMode

Bei allen importierten Feldern wird Name, Titel und Type importiert. Weiterhin wird der Parameter Mailback übernommen. Beim Typ Checkbox wird korrekt ermittelt, ob es sich um eine einzelne Checkbox oder eine Checkbox-Gruppe handelt.

Felder mit folgenden Feldtypen werden importiert:

  • Text
  • Textarea
  • Checkbox Gruppe (inklusive Optionen und gewähltem Defaultwert)
  • Select List (inklusive Optionen und gewähltem Defaultwert)
  • Checkbox (inklusive übermitteltem Wert und der Einstellung “Default Checked”)
  • File Upload (inklusive der Einstellung über erlaubten Dateiendungen)
  • Submit
  • Hidden

Import übermittelter Formulardaten

Gespeicherte Übertragungen der importierten Felder werden ebenfalls importiert.

Nach Abschluss des Imports

Viele Features, die in Breezingforms über Scripts und Pieces implementiert werden, stehen in Visforms direkt als Parameter in der Formular-Konfiguration und der Feld-Konfiguration zur Verfügung.

Insbesondere hat Visforms getrennte Feldtypen für:

  • Text
  • E-Mail
  • Zahl
  • Url
  • Datum

Der Feldtyp impliziert immer eine Validierung. Es wird automatisch geprüft, dass Eingaben, die der Benutzer macht, dem gewählten Feldtyp entsprechen. Bitte verwenden Sie die entsprechenden Visforms Feldtypen (insbesondere E-Mail) statt dem Feldtyp Text, wenn Sie ein entsprechendes Format erzwingen wollen. Eine Benutzer-Mail wird nur verschickt, wenn das Formular ein Feld vom Typ E-Mail enthält.

Importierte Formulare und Felder überbearbeiten

  • Löschen oder deaktivieren Sie alle Felder und Formulare, die Sie nicht benötigen.
  • Stellen Sie sicher, dass alle Formular-Konfigurationen Ihren Anforderungen entsprechen.
  • Stellen Sie sicher, dass alle Feld-Konfigurationen Ihren Anforderungen entsprechen.
  • Legen Sie Felder in Visforms neu an, die gegebenenfalls nicht importiert werden konnten.

Importierte Daten

Wurden in Breezingforms mit Feldern vom Typ ‘File Upload’ Dateien hochgeladen, dann sind diese Dateien nun in Visforms verlinkt.

Hinweis: Stellen Sie sicher, das Sie entsprechende Verzeichnisse und Dateien auf dem Server nicht löschen.

Noch auf Joomla 3, was nun?

Sollten Sie aktuell noch auf Joomla 3 arbeiten, dann müssen Sie Ihre Webseite zuerst auf Joomla 4 updaten. Da Visforms für den Datenimport die Breezingforms-Tabellen in der Datenbank verwendet, müssen diese Tabellen in der Joomla 4 Datenbank vorhanden sein.

Hinweis: Nach unserer Erfahrung werden Breezingforms-Tabellen in der Datenbank nicht gelöscht, wenn Sie die Komponente Breezingforms vor dem Joomla Update deinstallieren.

Ein paar Worte zur Entwicklung des Imports

Als Entwickler von Visforms haben wir selbst verständlicherweise in der Vergangenheit noch nicht mit Breezingforms gearbeitet. Für die Entwicklung des Formularimports haben wir die freie Version von Breezingforms auf Joomla 3 und die Breezingforms Beispielformulare installiert. Wir haben eigene Breezingforms-Formulare erstellt und alle Parameter, die wir beim Import berücksichtigen intensiv untersucht. Wir haben viele Formularübertragungen erzeugt, um auch gute Beispieldaten für den Datenimport zu haben.

Die Datenbasis, auf der wir den Import entwickelt haben sowie unsere praktischen Erfahrungen mit Breezingforms, sind nicht perfekt. Unser Ziel war es, einen Import zu entwickeln, der Ihnen einen großen Teil der Arbeit abnimmt, die nötig ist, wenn man von einer Komponente auf eine andere umsteigt. Wir sind der Meinung, dass uns das weitgehend gelungen ist.

Sollte der Import bei Ihren speziellen Breezingforms Formularen nicht oder nicht ausreichend gut funktionieren, können Sie uns gerne kontaktieren. Eine Weiterentwicklung unseres Breezingforms Import-Features ist durchaus zeitnah möglich.