CSV Export der Daten

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 eine CSV Export Option einzublenden. Mit dieser Export Option können die aktuell angezeigten Daten in eine CSV-Datei exportiert werden. Den CSV Export gibt es für die Ansicht der Daten-Liste. Den CSV Export gibt es nicht für die Ansicht des Daten-Details.

Alle Export-Optionen in der Export-Listbox

PDF Export und CSV Export sind Optionen in der Export-Listbox Zum Herunterladen den gewünschten Export auswählen

Optionen in der Listbox 'Zum Herunterladen den gewünschten Export auswählen'

PDF Export und CSV Export starten unmittelbar, nachdem die gewünschte Export-Option in der Export-Listbox ausgewählt wird.

PDF Export und CSV Export starten unmittelbar, nachdem die gewünschte Export-Option in der Export-Listbox ausgewählt wird.

Konfiguration

Die Konfiguration für den CSV Export der gespeicherten Übertragungen im Frontend 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 in der Export-Listbox Zum Herunterladen den gewünschten Export auswählen die Option Nach CSV exportieren angezeigt wird, muss das Feature in der Formular-Konfiguration aktiviert werden.

  • Formular-Konfiguration » Reiter: Datenanzeige im Frontend

    Gruppe: Downloads » Parameter: CSV Export Option anzeigen = “Ja”.

Formular-Konfiguration >> Reiter 'Datenanzeige im Frontend'

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 nur veröffentlichte Daten exportiert werden?
  • Welche Overhead-Felder werden exportiert?
  • Welche Formular-Felder werden exportiert (siehe Feld-Konfiguration)?

Die einzelnen Parameter dazu befinden sich hier:

  • Formular-Konfiguration » Reiter: Erweitert

    Gruppe: CSV Export

Formular-Konfiguration >> Reiter 'Erweitert'

Sie können über den Parameter Kopfzeile exportieren steuern, ob der CSV-Datei als erste Zeile eine sogenannte Kopfzeile vorangestellt wird. Die Kopfzeile enthält die Namen der exportierten Formular-Felder. Dadurch stehen die Namen der Formular-Felder als Spaltenköpfe im Tabellenkalkulationsprogramm zur Verfügung.

Sie können den Parameter Nur veröffentlichte Datensätze steuern, ob nur veröffentlichte Felder exportiert werden sollen. Auch für die zusätzlichen Overhead-Felder, die in jeder Datentabelle automatisch enthalten sind, können Sie einzeln festlegen, ob diese mit exportiert werden sollen oder nicht. Das betrifft etwa die Feld-ID, User-ID, IP, Veröffentlicht, Übertragungsdatum, Modifiziert und Änderungsdatum.

Benutzer-Rechte für den Export festlegen

Damit in der Daten-Ansicht der Eintrag Nach CSV exportieren in der Listbox Zum Herunterladen den gewünschten Export auswählen 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 eine Benutzergruppe können an zwei Stellen hierarchisch konfiguriert werden:

  • Die Einstellungen der Visforms-Optionen stehen in der Hierarchie über den Einstellungen aus der Formular-Konfiguration.
  • Die Einstellungen der Visforms-Optionen vererben ihre Einstellungen an die Formular-Konfiguration.
  • Die Einstellungen der Formular-Konfiguration erben die Einstellungen aus den Visforms-Optionen.

Die Parameter für die betroffenen Zugriffsrechte für eine Benutzergruppe 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’

Formular-Konfiguration >> Reiter 'Formularberechtigungen'

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? (Visforms Subscription)

Die einzelnen Parameter dazu 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”. (Visforms Subscription)

Feld-Konfiguration >> Reiter 'Datennutzung im Frontend'

Die Feld-Konfiguration legt fest, welche Felder exportiert werden. In der Feld-Konfiguration im Reiter Erweitert können Sie mithilfe der Option Feld bei Datenexport exportieren das Feld individuell für den Export ausschließen und einschließen. Standardmäßig ist diese Option für alle Felder auf “Ja” gestellt. Alle Felder sind per Default im Export enthalten.

Hinweis: Sie müssen nur die Felder bearbeiten, die nicht im Export enthalten sein sollen.

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 Zum Herunterladen den gewünschten Export auswählen angezeigt wird, müssen folgende Einstellungen gelten (beide Einstellungen sind notwendig):

  • Formular-Konfiguration » Reiter: Datenanzeige im Frontend

    Gruppe: Downloads » Parameter: CSV Export Option anzeigen = “Ja”.

  • Im Plugin String muss der Parameter displaycsvexportbutton mit dem Wert true eingefügt werden.
    {vfdataview}{... ,"displaycsvexportbutton":"true", ...}{/vfdataview}
    

Zusammenfassung

Wann ist die CSV Export Option sichtbar?

Drei Faktoren entscheiden, ob einem Benutzer in einer Datenansicht im Frontend eine CSV Export Option angezeigt wird.
Nur wenn alle drei folgenden Bedingungen erfüllt sind, wird die CSV Export Option angezeigt:

  • Wurde der CSV Export für das Frontend aktiviert?
    • Formular-Konfiguration » Reiter: Datenanzeige im Frontend

      Gruppe: Downloads » Parameter: CSV Export Option anzeigen = “Ja”.

  • 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’

  • 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”.

  • 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

  • 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”.

  • Auf Feld-Ebene befinden sich alle Einstellungen dazu in
    • Feld-Konfiguration » Reiter: Datennutzung im Frontend

      Gruppe: CSV Export Einstellungen