Gespeicherte Übertragungen im Frontend nach CSV exportieren
Hinweis: Diese Features sind Teil der Visforms Subscription und in der freien Visforms Version nicht enthalten.
Dieses Feature ermöglicht es Ihnen, in den Frontend-Datenansichten eines Formulars den berechtigten Benutzern einen CSV-Export-Button einzublenden. Mit diesem Export-Button können die aktuell angezeigten Daten in eine CSV-Datei exportiert werden.
Konfiguration
Die Konfiguration um gespeicherte Übertragungen im Frontend nach CSV exportieren erfolgt in 4 Stufen (Anzeige über ein Menü) oder 5 Stufen (Anzeige über das Plugin):
- Formular-Konfiguration: Den CSV-Export für das Formular aktivieren.
- Formular-Konfiguration: Details des CSV-Exports festlegen.
- Formular-Konfiguration: Benutzer-Rechte für den CSV-Export festlegen.
- Feld-Konfiguration: Den CSV-Export für das Feld aktivieren.
- Plugin-Konfiguration: Den CSV-Export für die Anzeige über das Plugin aktivieren.
Formular-Konfiguration
Den Export für das Formular aktivieren
Damit in der Daten-Ansicht der Eintrag Nach CSV exportieren in der Listbox Dokument herunter laden angezeigt wird, muss das Feature in der Formular-Konfiguration aktiviert werden.
- Formular-Konfiguration » Reiter: Datenanzeige im Frontend
Gruppe: Downloads » Parameter: CSV Export Button anzeigen = “Ja”.
Details des Exports festlegen
Für den CSV-Export stehen zahlreiche Parameter zur Verfügung, um den Export hinsichtlich Format und Inhalt im Detail zu steuern.
Dazu gehören unter anderem:
- Besitzt die erzeugte CSV-Datei eine Kopfzeile?
- Welches Trennzeichen soll zwischen den Feld-Werten stehen?
- Welcher Zeichensatz soll für dei Datei verwendet werden?
- Welchen Namen erhält die Export-Datei?
- Sollen allein veröffentlichte Daten exportiert werden?
- Welche Overhead-Felder werden exportiert?
- Welche Formular-Felder werden exportiert (siehe Feld-Konfiguration)?
Diese Parameter befinden sich hier:
- Formular-Konfiguration » Reiter: Erweitert
Gruppe: CSV-Export
Benutzer-Rechte für den Export festlegen
Damit in der Daten-Ansicht der Eintrag Nach CSV exportieren in der Listbox Dokument herunter laden angezeigt wird, muss der Benutzer die Berechtigung dazu erhalten.
Die Berechtigung dazu wird über die Zugriffsrechte für seine Benutzergruppe geregelt.
Die Zugriffsrechte für seine Benutzergruppe können an zwei Stellen hierarchisch konfiguriert werden.:
- Die Einstellung der Visforms-Optionen stehen in der Hierarchie über den Einstellungen aus der Formular-Konfiguration.
- Die Einstellung aus der Visforms-Optionen vererben die Einstellungen an die Formular-Konfiguration.
- Die Einstellung aus der Formular-Konfiguration erben die Einstellungen aus den Visforms-Optionen.
Diese Parameter befinden sich hier:
- Formular-Konfiguration » Reiter: Formularberechtigungen
Benutzer-Rolle » Aktion Formulardaten aus Frontend exportieren (CSV) = ‘Erlaubt’
- Visforms » Dashboard » Button Optionen » Reiter Berechtigungen
Benutzer-Rolle » Aktion Formulardaten aus Frontend exportieren (CSV) = ‘Erlaubt’
Feld-Konfiguration
Die Feld-Konfiguration legt die beiden folgenden Einstellungen fest:
- Wird das Formular-Feld exportiert?
- Welchen Namen erhält das Formular-Feld für den Export?
Diese Parameter befinden sich hier:
- Feld-Konfiguration » Reiter: Datennutzung im Frontend
Gruppe: CSV-Export-Einstellungen » Parameter: Feld bei Datenexport exportieren = “Ja”. Gruppe: CSV-Export-Einstellungen » Parameter: Abweichendes Label für CSV = “Mein Name für das Feld”.
Plugin-Konfiguration
Wird das Content Plugin - Visforms Daten zur Anzeige der Daten im Frontend verwendet, verläuft die Konfiguration über einen zusätzlichen Plugin-Parameter im Plugin-String. Der Plugin-String wird in den Artikel oder das Modul als zusätzlicher Text eingefügt, um die Formular-Daten an dieser Stelle im Austausch gegen den Plugin-String im Frontend anzuzeigen.
Damit in der Daten-Ansicht über das Plugin der Eintrag Nach CSV exportieren in der Listbox Dokument herunter laden angezeigt wird, müssen folgende Einstellungen gelten (beide Einstellungen sind notwendig):
- Formular-Konfiguration » Reiter: Datenanzeige im Frontend
Gruppe: Downloads » Parameter: CSV Export Button anzeigen = “Ja”.
- Im Plugin String muss der Parameter displaycsvexportbutton mit dem Wert true eingefügt werden.
{vfdataview}{... ,"displaycsvexportbutton":"true", ...}{/vfdataview}
Zusammenfassung
Wann ist der CSV-Export-Button sichtbar?
Drei Faktoren entscheiden, ob einem Benutzer in einer Datenansicht im Frontend ein CSV-Export-Button angezeigt wird.
Nur wenn alle drei folgenden Bedingungen erfüllt sind, wird der CSV-Export-Button angezeigt:
- Wurde der CSV-Export für das Frontend aktiviert?
- Formular-Konfiguration » Reiter: Datenanzeige im Frontend
Gruppe: Downloads » Parameter: CSV Export Button anzeigen = “Ja”.
- Formular-Konfiguration » Reiter: Datenanzeige im Frontend
- Hat der Benutzer das Recht, Daten im Frontend nach CSV zu exportieren?
- Formular-Konfiguration » Reiter: Formularberechtigungen
Benutzer-Rolle » Aktion Formulardaten aus Frontend exportieren (CSV) = ‘Erlaubt’
- Visforms » Dashboard » Button Optionen » Reiter Berechtigungen
Benutzer-Rolle » Aktion Formulardaten aus Frontend exportieren (CSV) = ‘Erlaubt’
- Formular-Konfiguration » Reiter: Formularberechtigungen
- Wird in der Datenanzeige im Frontend mindestens 1 Datensatz angezeigt?
Welche Datensätze werden exportiert?
Die Auswahl der exportierten Datensätze erfolgt über die Ansicht der Daten im Frontend.
Hinweis: Es werden immer alle aktuell angezeigten Datensätze ohne Berücksichtigung einer eventuellen Pagination exportiert.
Die aktuell angezeigten Datensätze hängen ab von
- den Benutzerberechtigungen,
- der Einstellung für den erlaubten Status der Datensätze:
- Formular-Konfiguration » Reiter: Erweitert
Gruppe: CSV-Export » Parameter: Nur veröffentlichte Datensätze = “Ja”.
- Formular-Konfiguration » Reiter: Erweitert
- den aktuellen Einstellungen der Suchfilter.
Wird das Content Plugin - Visforms Daten zur Anzeige verwendet, hängen die angezeigten Daten auch von den Plugin-Parametern zur Auswahl von Datensätzen ab.
Welche Informationen werden exportiert?
Die folgenden Einstellungen legen fest, welche Informationen der Eintrag in einer Zeile in der CSV-Export-Datei enthält:
- Auf Formular-Ebene befinden sich alle Einstellungen dazu in
- Formular-Konfiguration » Reiter: Erweitert
Gruppe: CSV-Export
- Formular-Konfiguration » Reiter: Erweitert
- Auch nicht veröffentlichte Felder können auf Formular-Ebene für den CSV-Export freigegeben werden
- Feld-Konfiguration » Reiter: Erweitert
Gruppe: CSV-Export » Parameter: Nur veröffentlichte Felder = “Ja”.
- Feld-Konfiguration » Reiter: Erweitert
- Auf Feld-Ebene befinden sich alle Einstellungen dazu in
- Feld-Konfiguration » Reiter: Datennutzung im Frontend
Gruppe: CSV-Export-Einstellungen
- Feld-Konfiguration » Reiter: Datennutzung im Frontend